book.org

   1
   2 * Goals and non-Goals
   3
   4 This book will teach you
   5
   6 1. To use Emacs.
   7 2. To customize Emacs to your specific needs.
   8
   9 This book will *not*
  10
  11 1. Teach you to program in Emacs lisp
  12 2. Document third-party libraries which don't ship with Emacs or GNU
  13    ELPA.
  14
  15 * Audience
  16
  17 New Emacs users who are also non-programmers.
  18
  19 * Installing Emacs
  20
  21 The latest stable release of Emacs as on the day of writing is Emacs
  22 24.3.
  23
  24 You can download the pre-build binaries from [[http://ftp.gnu.org/gnu/emacs/][GNU FTP Archives]].  If you
  25 are on Windows, you can download the binaries from [[http://ftp.gnu.org/gnu/emacs/windows/][Windows
  26 subdirectory]].
  27
  28 * Text editing
  29
  30 * Reporting bugs
  31
  32 You can submit a bug report with
  33
  34 #+BEGIN_EXAMPLE
  35   M-x report-emacs-bug RET
  36 #+END_EXAMPLE
  37
  38 * Emacs Community
  39
  40 The Emacs project has many [[https://savannah.gnu.org/mail/?group%3Demacs][mailing lists]].  You may wish to subscribe
  41 to one or more of these mailing lists.
  42
  43 1. [[http://lists.gnu.org/mailman/listinfo/info-gnu-emacs][Emacs news]]
  44 2. [[http://lists.gnu.org/mailman/listinfo/help-gnu-emacs][Emacs users]]
  45 3. [[http://lists.gnu.org/mailman/listinfo/emacs-devel][Emacs developers]]
  46 4. [[http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs][Emacs bugs]]
  47 5. [[http://lists.gnu.org/mailman/listinfo/gnu-emacs-sources][Emacs sources]]
  48
  49 See [[http://www.gnu.org/software/emacs/][Emacs project page]] for more information.
  50
  51 [[http://www.emacswiki.org/][Emacswiki]]
  52
  53 IRC: #emacs @ irc.freenode.net
  54
  55 * Contributing to Emacs
  56
  57 Emacs sources are maintained using Bazaar version control system.  You
  58 can obtain the version controlled source tree with
  59
  60 #+BEGIN_EXAMPLE
  61   bzr branch bzr://bzr.savannah.gnu.org/emacs/trunk
  62 #+END_EXAMPLE
  63
  64 You can also browse the source repository for one-off purposes using
  65 the following URLs: [[http://bzr.savannah.gnu.org/lh/emacs/trunk/files][Bzr Loggerhead]] or [[http://git.savannah.gnu.org/cgit/emacs.git/log/][Cgit web interface]].
  66
  67 If you are a Git user, you can checkout the source tree using git as
  68 follows
  69
  70 #+BEGIN_EXAMPLE
  71   git clone git://git.savannah.gnu.org/emacs.git
  72 #+END_EXAMPLE
  73
  74 See [[http://savannah.gnu.org/maintenance/UsingGit][for more information on using git]].
  75
  76 * Building Emacs from sources
  77
  78 If you are a developer or a user who is interested in testing out
  79 Emacs trunk see [[http://www.emacswiki.org/emacs/BzrForEmacsDevs][instructions at Emacswiki]].