diff options
Diffstat (limited to 'doc/emacs')
| -rw-r--r-- | doc/emacs/ChangeLog | 105 | ||||
| -rw-r--r-- | doc/emacs/ack.texi | 198 | ||||
| -rw-r--r-- | doc/emacs/buffers.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/building.texi | 3 | ||||
| -rw-r--r-- | doc/emacs/cal-xtra.texi | 114 | ||||
| -rw-r--r-- | doc/emacs/calendar.texi | 161 | ||||
| -rw-r--r-- | doc/emacs/dired-xtra.texi | 13 | ||||
| -rw-r--r-- | doc/emacs/display.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/emacs-xtra.texi | 11 | ||||
| -rw-r--r-- | doc/emacs/emacs.texi | 363 | ||||
| -rw-r--r-- | doc/emacs/emerge-xtra.texi | 24 | ||||
| -rw-r--r-- | doc/emacs/files.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/fortran-xtra.texi | 67 | ||||
| -rw-r--r-- | doc/emacs/frames.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/kmacro.texi | 6 | ||||
| -rw-r--r-- | doc/emacs/macos.texi | 63 | ||||
| -rw-r--r-- | doc/emacs/maintaining.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/mini.texi | 32 | ||||
| -rw-r--r-- | doc/emacs/msdog-xtra.texi | 33 | ||||
| -rw-r--r-- | doc/emacs/msdog.texi | 47 | ||||
| -rw-r--r-- | doc/emacs/picture-xtra.texi | 7 | ||||
| -rw-r--r-- | doc/emacs/programs.texi | 3 | ||||
| -rw-r--r-- | doc/emacs/rmail.texi | 108 | ||||
| -rw-r--r-- | doc/emacs/sending.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/text.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/vc1-xtra.texi | 10 |
26 files changed, 812 insertions, 578 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 004911faf57..3d3c8f003cb 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,108 @@ +2012-02-25 Dani Moncayo <dmoncayo@gmail.com> (tiny change) + + * buffers.texi (Select Buffer): Mention that saving in a new file + name can switch to a different major mode. + +2012-02-23 Glenn Morris <rgm@gnu.org> + + * mini.texi (Minibuffer File, Completion Options, Repetition): + Copyedits. + (Completion Example): Other M-x au* commands may be defined. + (Completion Styles): Mention emacs21 and completion-category-overrides. + + * msdog.texi (Text and Binary, ls in Lisp, Windows HOME) + (Windows Keyboard, Windows Mouse, Windows Processes) + (Windows Printing, Windows Misc): Copyedits. + (ls in Lisp): Update switches list. + + * msdog-xtra.texi (MS-DOS Display): Update list-colors-display xref. + Update dos-mode* function names. + (MS-DOS Printing, MS-DOS and MULE): Copyedits. + (MS-DOS Processes): Add xref to main ls-lisp section. + + * ack.texi (Acknowledgments): Mention smie. + +2012-02-22 Glenn Morris <rgm@gnu.org> + + * macos.texi: Copyedits. Fix @key/@kbd usage. + (Mac / GNUstep Basics): Don't mention the panels, since the next + section covers them. + (Mac / GNUstep Customization): Merge some panel info from previous. + +2012-02-21 Glenn Morris <rgm@gnu.org> + + * emerge-xtra.texi (Emerge, Submodes of Emerge, Combining in Emerge): + Small fixes. + + * emacs-xtra.texi: Picture mode is no longer a chapter. + + * picture-xtra.texi (Basic Picture): C-a does get remapped. + + * ack.texi (Acknowledgments): Small changes, including resorting, + and removal of things no longer distributed. + +2012-02-20 Glenn Morris <rgm@gnu.org> + + * emacs.texi (Top, Preface): Small rephrasings. + (menu, detailmenu): Update entries, and reformat some descriptions. + * building.texi, display.texi, emacs-xtra.texi, files.texi: + * frames.texi, kmacro.texi, msdog.texi, programs.texi, text.texi: + Reformat some menu descriptions. + + * ack.texi (Acknowledgments): More updates. + + * emacs.texi (Acknowledgments): Add several names from ack.texi, + and from Author: headers. + (Distrib): Small updates. + +2012-02-18 Glenn Morris <rgm@gnu.org> + + * ack.texi (Acknowledgments): Add xref to Org manual. + + * rmail.texi: Copyedits. Use 'mail composition buffer' in place + of '*mail*', since Message does not call it that. + (Rmail Reply): Rename rmail-dont-reply-to-names. + \\`info- no longer handled specially. + Update for rmail-enable-mime-composing. + Don't mention 'm' for replies. + Don't mention rmail-mail-new-frame and cancelling, since it does + not work for Message at the moment. + + * cal-xtra.texi: Copyedits. + + * emacs-xtra.texi: Set encoding to ISO-8859-1. + +2012-02-17 Glenn Morris <rgm@gnu.org> + + * maintaining.texi (Old Revisions): Fix cross-refs to Ediff manual. + + * ack.texi (Acknowledgments): Mention Gnulib. + + * ack.texi, calendar.texi, cal-xtra.texi: Use "Bahá'Ã". + + * calendar.texi: Misc small changes, including updating the dates + of examples. + +2012-02-16 Glenn Morris <rgm@gnu.org> + + * calendar.texi: Misc small changes. + + * vc1-xtra.texi (VC Delete/Rename, CVS Options): + * cal-xtra.texi (Diary Display): Fix TeX cross-refs to other manuals. + + * dired-xtra.texi (Subdir Switches): Small fixes. + + * fortran-xtra.texi: Tiny changes and some adjustments to line breaks. + +2012-02-15 Glenn Morris <rgm@gnu.org> + + * sending.texi (Mail Sending): smtpmail-auth-credentials was removed. + +2012-02-12 Glenn Morris <rgm@gnu.org> + + * ack.texi (Acknowledgments): + * emacs.texi (Acknowledgments): Updates for new files in 24.1. + 2012-02-10 Glenn Morris <rgm@gnu.org> * mini.texi (Minibuffer Edit): Mention minibuffer-inactive-mode. diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi index 13bc327fbab..0a14f5119d1 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi @@ -1,6 +1,6 @@ @c -*- coding: iso-latin-1 -*- @c This is part of the Emacs manual. -@c Copyright (C) 1994-1997, 1999-2012 Free Software Foundation, Inc. +@c Copyright (C) 1994-1997, 1999-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @node Acknowledgments, Screen, Concept Index, Top @@ -33,7 +33,7 @@ Per Abrahamsen wrote the customization facilities, as well as from the keyboard; @file{xt-mouse.el}, which allows mouse commands through Xterm; @file{gnus-cus.el}, which implements customization commands for Gnus; @file{gnus-cite.el}, a citation-parsing facility for -news articles); @file{gnus-score.el}, scoring for Gnus; @file{cpp.el}, +news articles; @file{gnus-score.el}, scoring for Gnus; @file{cpp.el}, which hides or highlights parts of C programs according to preprocessor conditionals; and the widget library files @file{wid-browse.el}, @file{wid-edit.el}, @file{widget.el}. He also co-wrote @@ -51,8 +51,9 @@ files. @item Michael Albinus wrote @file{dbus.el}, a package that implements the D-Bus message bus protocol; @file{zeroconf.el}, a mode for browsing -Avahi services; and @file{xesam.el}, a Xesam-based search engine -interface. He and Kai Großjohann wrote the Tramp package, which +Avahi services; @file{xesam.el}, a Xesam-based search engine +interface; and @file{secrets.el}, an interface to keyring daemons for +storing confidential data. He and Kai Großjohann wrote the Tramp package, which provides transparent remote file editing using rcp, ssh, ftp, and other network protocols. He and Daniel Pittman wrote @file{tramp-cache.el}. @@ -67,13 +68,18 @@ Joe Arceneaux wrote the original text property implementation, and implemented support for X11. @item +Emil Åström, Milan Zamaza, and Stefan Bruda wrote @file{prolog.el}, +a mode for editing Prolog (and Mercury) code. + +@item Miles Bader wrote @file{image-file.el}, support code for visiting image files; @file{minibuf-eldef.el}, a minor mode that hides the minibuffer default value when appropriate; @file{rfn-eshadow.el}, shadowing of @code{read-file-name} input; @file{mb-depth.el}, display of minibuffer depth; @file{button.el}, the library that implements clickable buttons; @file{face-remap.el}, a package for changing the default face in -individual buffers; and @file{macroexp.el} for macro-expansion. +individual buffers; and @file{macroexp.el} for macro-expansion. He +also worked on an early version of the lexical binding code. @item David Bakhash wrote @file{strokes.el}, a mode for controlling Emacs by @@ -184,7 +190,8 @@ for editing IDL and WAVE CL. @item Bob Chassell wrote @file{texnfo-upd.el}, @file{texinfo.el}, and @file{makeinfo.el}, modes and utilities for working with Texinfo files; -and @file{page-ext.el}, commands for extended page handling. +and @file{page-ext.el}, commands for extended page handling. He also +wrote the ``Introduction to programming in Emacs Lisp'' manual. @item Jihyun Cho wrote @file{hanja-util.el} and @file{hangul.el}, utilities @@ -195,8 +202,10 @@ Andrew Choi and Yamamoto Mitsuharu wrote the Carbon support, used prior to Emacs 23 for Mac OS. @item -Chong Yidong was the Emacs co-maintainer for Emacs 23. He made many -improvements to the Emacs display engine. +Chong Yidong was the Emacs co-maintainer from Emacs 23 onwards. He made many +improvements to the Emacs display engine. He also wrote +@file{tabulated-list.el}, a generic major mode for lists of data; +and improved support for themes and packages. @item James Clark wrote SGML mode, a mode for editing SGML documents; and @@ -215,6 +224,10 @@ Andrew Cohen wrote @file{spam-wash.el}, to decode and clean email before it is analyzed for spam. @item +Edward O'Connor wrote @file{json.el}, a file for parsing and +generating JSON files. + +@item Georges Brun-Cottan and Stefan Monnier wrote @file{easy-mmode.el}, a package for easy definition of major and minor modes. @@ -231,17 +244,14 @@ files as ``thumbnails.'' @item Julien Danjou wrote an implementation of ``Desktop Notifications'' -(@file{notifications.el}). +(@file{notifications.el}); and @file{color.el}, a library for general +color manipulation. He also made various contributions to Gnus. @item Vivek Dasmohapatra wrote @file{htmlfontify.el}, to convert a buffer or source tree to HTML. @item -Michael DeCorte wrote @file{emacs.csh}, a C-shell script that starts a -new Emacs job, or restarts a paused Emacs if one exists. - -@item Gary Delp wrote @file{mailpost.el}, an interface between RMAIL and the @file{/usr/uci/post} mailer. @@ -254,16 +264,19 @@ Eric Ding wrote @file{goto-addr.el}, @item Jan Djärv added support for the GTK+ toolkit and X drag-and-drop. +He also wrote @file{dynamic-setting.el}. @item Carsten Dominik wrote Ref@TeX{}, a package for setting up labels and cross-references in La@TeX{} documents; and co-wrote IDLWAVE mode -(q.v.@:). He was the main author of Org mode, for maintaining notes, -todo lists, and project planning. Thomas Baumann, Jan Böcker, Lennart -Borgman, Baoqiu Cui, Daniel German, Bastien Guerry, Tassilo Horn, Philip -Jackson, Tokuya Kameshima, Ross Patterson, Sebastian Rose, Eric Schulte, -Paul Sexton, Ulf Stegemann, Andy Stewart, David O'Toole, John Wiegley, -and Piotr Zielinski also wrote various Org mode components. +(q.v.@:). He was the original author of Org mode, for maintaining notes, +todo lists, and project planning. Bastien Guerry subsequently took +over maintainership. Benjamin Andresen, Thomas Baumann, Joel Boehland, Jan Böcker, Lennart +Borgman, Baoqiu Cui, Dan Davison, Christian Egli, Eric S.@: Fraga, Daniel German, Chris Gray, Konrad Hinsen, Tassilo Horn, Philip +Jackson, Martyn Jago, Thorsten Jolitz, Jambunathan K, Tokuya Kameshima, Sergey Litvinov, David Maus, Ross Patterson, Juan Pechiar, Sebastian Rose, Eric Schulte, +Paul Sexton, Ulf Stegemann, Andy Stewart, Christopher Suckling, David O'Toole, John Wiegley, Zhang Weize, +Piotr Zielinski, and others also wrote various Org mode components. +For more information, @pxref{History and Acknowledgments,,, org, The Org Manual}. @item Scott Draves wrote @file{tq.el}, help functions for maintaining @@ -280,7 +293,12 @@ Viktor Dukhovni wrote support for dumping under SunOS version 4. John Eaton and Kurt Hornik wrote Octave mode. @item -Rolf Ebert co-wrote Ada mode. +Rolf Ebert, Markus Heritsch, and Emmanuel Briot wrote Ada mode. + +@item +Paul Eggert integrated the Gnulib portability library, and made many +other portability fixes to the C code; as well as his contributions +to VC and the calendar. @item Stephen Eglen wrote @file{mspools.el}, which tells you which Procmail @@ -410,7 +428,7 @@ characters used by @TeX{} and net tradition. @item Bastien Guerry wrote @file{gnus-bookmark.el}, bookmark support for Gnus; -as well as contributing to Org mode (q.v.@:). +as well as helping to maintain Org mode (q.v.@:). @item Henry Guillaume wrote @file{find-file.el}, a package to visit files @@ -434,7 +452,10 @@ non-@acronym{ASCII} text from an @acronym{ASCII} keyboard. Jesper Harder wrote @file{yenc.el}, for decoding yenc encoded messages. @item -K. Shane Hartman wrote @file{chistory.el} and @file{echistory.el}, +Alexandru Harsanyi wrote a library for accessing SOAP web services. + +@item +K.@: Shane Hartman wrote @file{chistory.el} and @file{echistory.el}, packages for browsing command history lists; @file{electric.el} and @file{helper.el}, which provide an alternative command loop and appropriate help facilities; @file{emacsbug.el}, a package for @@ -451,9 +472,6 @@ Jon K Hellan wrote @file{utf7.el}, support for mail-safe transformation format of Unicode. @item -Markus Heritsch co-wrote Ada mode. - -@item Karl Heuer wrote the original blessmail script, implemented the @code{intangible} text property, and rearranged the structure of the @code{Lisp_Object} type to allow for more data bits. @@ -483,15 +501,20 @@ browser to display a URL. @item Lars Magne Ingebrigtsen did a major redesign of the Gnus news-reader and wrote many of its parts. Several of these are now general components of -Emacs: @file{dns.el} for Domain Name Service lookups; +Emacs, including: @file{dns.el} for Domain Name Service lookups; @file{format-spec.el} for formatting arbitrary format strings; @file{netrc.el} for parsing of @file{.netrc} files; and -@file{time-date.el} for general date and time handling. Components of -Gnus have also been written by: Nagy Andras, David Blacka, Scott Byer, -Kevin Greiner, Kai Großjohann, Joe Hildebrand, Paul Jarc, Sascha +@file{time-date.el} for general date and time handling. +He also wrote @file{network-stream.el}, for opening network processes; +@file{url-queue.el}, for controlling parallel downloads of URLs; +and implemented libxml2 support. +Components of Gnus have also been written by: Nagy Andras, David +Blacka, Scott Byer, Ludovic Courtès, Julien Danjou, Kevin Greiner, Kai +Großjohann, Joe Hildebrand, Paul Jarc, Simon Josefsson, Sascha Lüdecke, David Moore, Jim Radford, Benjamin Rutt, Raymond Scholz, -Thomas Steffen, Reiner Steib, Didier Verna, Ilja Weis, Katsumi Yamaoka, -Teodor Zlatanov, and others (@pxref{Contributors,,,gnus, the Gnus Manual}). +Thomas Steffen, Reiner Steib, Didier Verna, Ilja Weis, Katsumi +Yamaoka, Teodor Zlatanov, and others (@pxref{Contributors,,,gnus, the +Gnus Manual}). @item Andrew Innes contributed extensively to the MS-Windows support. @@ -566,7 +589,7 @@ buffers. @item Michael Kifer wrote @code{ediff}, an interactive interface to the @command{diff}, @command{patch}, and @command{merge} programs; and -Viper, the newest emulation for VI. +Viper, another emulator of the VI editor. @item Richard King wrote the first version of @file{userlock.el} and @@ -586,8 +609,7 @@ Security-Enhanced Linux context of files on backup and copy. @item Shuhei Kobayashi wrote @file{hex-util.el}, for operating on hexadecimal -strings; support for HMAC (Keyed-Hashing for Message Authentication); -and a Lisp implementation of the SHA1 Secure Hash Algorithm. +strings; and support for HMAC (Keyed-Hashing for Message Authentication). @item Pavel Kobyakov wrote @file{flymake.el}, a minor mode for performing @@ -608,17 +630,18 @@ menu support. @item Sebastian Kremer wrote @code{dired-mode}, with contributions by Lawrence R.@: Dodd. He also wrote @file{ls-lisp.el}, a Lisp emulation of the -@code{ls} command for platforms which don't have @code{ls} as a standard +@code{ls} command for platforms that don't have @code{ls} as a standard program. @item -Ken Stevens wrote @file{ispell.el}, a spell-checker interface. - -@item David K@ringaccent{a}gedal wrote @file{tempo.el}, providing support for easy insertion of boilerplate text and other common constructions. @item +Igor Kuzmin wrote @file{cconv.el}, providing closure conversion for +statically scoped Emacs lisp. + +@item Daniel LaLiberte wrote @file{edebug.el}, a source-level debugger for Emacs Lisp; @file{cl-specs.el}, specifications to help @code{edebug} debug code written using David Gillespie's Common Lisp support; @@ -638,8 +661,7 @@ a package for pretty-printing Emacs buffers to PostScript printers; @file{ebnf2ps.el}, a package that translates EBNF grammar to a syntactic chart that can be printed to a PostScript printer; and @file{whitespace.el}, a package that detects and cleans up excess -whitespace in a file. The previous version of @file{whitespace.el}, -used prior to Emacs 23, was written by Rajesh Vaidheeswarran. +whitespace in a file (building on an earlier version by Rajesh Vaidheeswarran). @item Frederic Lepied wrote @file{expand.el}, which uses the abbrev @@ -711,10 +733,25 @@ Development Environment Tools) package. Portions were also written by Jan Moringen, David Ponce, and Joakim Verona. @item +Roland McGrath wrote @file{compile.el} (since updated by Daniel +Pfeiffer), a package for running compilations in a buffer, and then +visiting the locations reported in error messages; @file{etags.el}, a +package for jumping to function definitions and searching or replacing +in all the files mentioned in a @file{TAGS} file; with Sebastian +Kremer @file{find-dired.el}, for using @code{dired} commands on output +from the @code{find} program; @file{grep.el} for running the +@code{grep} command; @file{map-ynp.el}, a general purpose boolean +question-asker; @file{autoload.el}, providing semi-automatic +maintenance of autoload files. + +@item Alan Mackenzie wrote the integrated AWK support in CC Mode, and maintained CC Mode from Emacs 22 onwards. @item +Michael McNamara and Wilson Snyder wrote Verilog mode. + +@item Christopher J.@: Madsen wrote @file{decipher.el}, a package for cracking simple substitution ciphers. @@ -758,21 +795,6 @@ Thomas May wrote @file{blackbox.el}, a version of the traditional blackbox game. @item -Roland McGrath wrote @file{compile.el} (since updated by Daniel -Pfeiffer), a package for running compilations in a buffer, and then -visiting the locations reported in error messages; @file{etags.el}, a -package for jumping to function definitions and searching or replacing -in all the files mentioned in a @file{TAGS} file; @file{find-dired.el}, -for using @code{dired} commands on output from the @code{find} program, -with Sebastian Kremer; @file{grep.el} for running the @code{grep} -command; @file{map-ynp.el}, a general purpose boolean question-asker; -@file{autoload.el}, providing semi-automatic maintenance of autoload -files. - -@item -Michael McNamara and Wilson Snyder wrote Verilog mode. - -@item David Megginson wrote @file{derived.el}, which allows one to define new major modes by inheriting key bindings and commands from existing major modes. @@ -801,7 +823,7 @@ facility. He also wrote @code{ebrowse}, the C@t{++} browser; and @file{rx.el}, a regular expression constructor. @item -Stefan Monnier was the Emacs co-maintainer for Emacs 23. He added +Stefan Monnier was the Emacs co-maintainer from Emacs 23 onwards. He added support for Arch and Subversion to VC, re-wrote much of the Emacs server to use the built-in networking primitives, and re-wrote the abbrev and minibuffer completion code for Emacs 23. He also wrote @code{PCL-CVS}, @@ -810,27 +832,29 @@ a directory-level front end to the CVS version control system; text; @file{smerge-mode.el}, a minor mode for resolving @code{diff3} conflicts; @file{diff-mode.el}, a mode for viewing and editing context diffs; @file{css-mode.el} for Cascading Style Sheets; -@file{bibtex-style.el} for BibTeX Style files; and @file{mpc.el}, a -client for the ``Music Player Daemon''. +@file{bibtex-style.el} for BibTeX Style files; @file{mpc.el}, a +client for the ``Music Player Daemon''; @file{smie.el}, a generic +indentation engine; and @file{pcase.el}, implementing ML-style pattern +matching. He integrated the lexical binding code in Emacs 24. @item Morioka Tomohiko wrote several packages for MIME support in Gnus and elsewhere. @item -Takahashi Naoto co-wrote @file{quail.el} (q.v.@:), and wrote -@file{robin.el}, another input method. - -@item Sen Nagata wrote @file{crm.el}, a package for reading multiple strings with completion, and @file{rfc2368.el}, support for @code{mailto:} URLs. @item Erik Naggum wrote the time-conversion functions. He also wrote -@file{disp-table.el}, a package for dealing with display tables; -@file{mailheader.el}, a package for parsing email headers; and -@file{parse-time.el}, a package for parsing time strings. +@file{disp-table.el}, for dealing with display tables; +@file{mailheader.el}, for parsing email headers; and +@file{parse-time.el}, for parsing time strings. + +@item +Takahashi Naoto co-wrote @file{quail.el} (q.v.@:), and wrote +@file{robin.el}, another input method. @item Thomas Neumann and Eric Raymond wrote @file{make-mode.el}, @@ -841,6 +865,9 @@ Thien-Thi Nguyen and Dan Nicolaescu wrote @file{hideshow.el}, a minor mode for selectively displaying blocks of text. @item +Jurgen Nickelsen wrote @file{ws-mode.el}, providing WordStar emulation. + +@item Dan Nicolaescu added support for running Emacs as a daemon. He also wrote @file{romanian.el}, support for editing Romanian text; @file{iris-ansi.el}, support for running Emacs on SGI's @code{xwsh} @@ -848,9 +875,6 @@ and @code{winterm} terminal emulators; and @file{vc-dir.el}, displaying the status of version-controlled directories. @item -Jurgen Nickelsen wrote @file{ws-mode.el}, providing WordStar emulation. - -@item Hrvoje Niksic wrote @file{savehist.el}, for saving the minibuffer history between Emacs sessions. @@ -863,10 +887,6 @@ Andrew Norman wrote @file{ange-ftp.el}, providing transparent FTP support. @item -Edward O'Connor wrote @file{json.el}, a file for parsing and -generating JSON files. - -@item Kentaro Ohkouchi created the Emacs icons used beginning with Emacs 23. @item @@ -979,7 +999,7 @@ used in Emacs Lisp library files; and code to set and make use of the which each lisp function loaded into Emacs came. @item -Edward M.@: Reingold wrote the extensive calendar and diary support, +Edward M.@: Reingold wrote the calendar and diary support, with contributions from Stewart Clamen (@file{cal-mayan.el}), Nachum Dershowitz (@file{cal-hebrew.el}), Paul Eggert (@file{cal-dst.el}), Steve Fisk (@file{cal-tex.el}), Michael Kifer (@file{cal-x.el}), Lara @@ -1021,6 +1041,9 @@ Guillermo J.@: Rozas wrote @file{scheme.el}, a mode for editing Scheme and DSSSL code. @item +Martin Rudalics implemented improved display-buffer handling in Emacs 24. + +@item Ivar Rummelhoff wrote @file{winner.el}, which records recent window configurations so you can move back to them. @@ -1172,8 +1195,7 @@ Peter Stephenson wrote @file{vcursor.el}, which implements a ``virtual cursor'' that you can move with the keyboard and use for copying text. @item -Ken Stevens wrote the initial version of @file{ispell.el} and maintains -that package since Ispell 3.1 release. +Ken Stevens wrote @file{ispell.el}, a spell-checker interface. @item Kim F.@: Storm made many improvements to the Emacs display engine, @@ -1224,11 +1246,9 @@ numbers in the left margin. @item Tom Tromey and Chris Lindblad wrote @file{tcl.el}, a mode for editing Tcl/Tk source files and running a Tcl interpreter as an Emacs -subprocess. - -@item -Tom Tromey wrote @file{bug-reference.el}, providing clickable links to -bug reports. +subprocess. Tom Tromey also wrote @file{bug-reference.el}, providing +clickable links to bug reports; and the first version of the Emacs +package system. @item Eli Tziperman wrote @file{rmail-spam-filter.el}, a spam filter for RMAIL. @@ -1237,7 +1257,8 @@ Eli Tziperman wrote @file{rmail-spam-filter.el}, a spam filter for RMAIL. Daiki Ueno wrote @file{starttls.el}, support for Transport Layer Security protocol; @file{sasl-cram.el} and @file{sasl-digest.el} (with Kenichi Okada), and @file{sasl.el}, support for Simple Authentication -and Security Layer (SASL); and the EasyPG (and its predecessor PGG) +and Security Layer (SASL); @file{plstore.el} for secure storage of +property lists; and the EasyPG (and its predecessor PGG) package, for GnuPG and PGP support. @item @@ -1259,6 +1280,9 @@ operations on rectangle regions of text. He also contributed to Gnus (q.v.@:). @item +Joakim Verona implemented ImageMagick support. + +@item Ulrik Vieth implemented @file{meta-mode.el}, for editing MetaFont code. @item @@ -1317,7 +1341,7 @@ mode for editing VHDL source code. John Wiegley wrote @file{align.el}, a set of commands for aligning text according to regular-expression based rules; @file{isearchb.el} for fast buffer switching; @file{timeclock.el}, a package for keeping track of -time spent on projects; the Baha'i calendar support; +time spent on projects; the Bahá'í calendar support; @file{pcomplete.el}, a programmable completion facility; @file{remember.el}, a mode for jotting down things to remember; @file{eudcb-mab.el}, an address book backend for the Emacs Unified @@ -1348,7 +1372,8 @@ manual pages without the @code{man} command. @item Masatake Yamato wrote @file{ld-script.el}, an editing mode for GNU -linker scripts, and contributed subword handling in CC mode. +linker scripts, and contributed subword handling and style +``guessing'' in CC mode. @item Jonathan Yavner wrote @file{testcover.el}, a package for keeping track @@ -1378,7 +1403,7 @@ zone out in front of Emacs. Eli Zaretskii made many standard Emacs features work on MS-DOS and Microsoft Windows. He also wrote @file{tty-colors.el}, which implements transparent mapping of X colors to tty colors; and -@file{rxvt.el}. +@file{rxvt.el}. He implemented support for bidirectional text. @item Jamie Zawinski wrote much of the support for faces and X selections. @@ -1410,6 +1435,11 @@ Neal Ziring and Felix S.@: T.@: Wu wrote @file{vi.el}, an emulation of the VI text editor. @item +Ted Zlatanov (as well as his contributions to the Gnus newsreader) +wrote an interface to the GnuTLS library, for secure network +connections; and a futures facility for the URL library. + +@item Detlev Zundel wrote @file{re-builder.el}, a package for building regexps with visual feedback. diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index c3a778dd202..d0ec1103580 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi @@ -106,7 +106,9 @@ editing. The default value of the variable @code{major-mode} determines the new buffer's major mode; the default value is Fundamental mode. @xref{Major Modes}. One reason to create a new buffer is to use it for making temporary notes. If you try to save -it, Emacs asks for the file name to use. +it, Emacs asks for the file name to use, and the buffer's major mode +is re-established taking that file name into account (@pxref{Choosing +Modes}). @kindex C-x @key{LEFT} @kindex C-x @key{RIGHT} diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index 7a94ba56052..2f977c7d923 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -471,8 +471,7 @@ Manual}. * Commands of GUD:: Key bindings for common commands. * GUD Customization:: Defining your own commands for GUD. * GDB Graphical Interface:: An enhanced mode that uses GDB features to - implement a graphical debugging environment through - Emacs. + implement a graphical debugging environment. @end menu @node Starting GUD diff --git a/doc/emacs/cal-xtra.texi b/doc/emacs/cal-xtra.texi index 4d37672b6ca..45760afd7a6 100644 --- a/doc/emacs/cal-xtra.texi +++ b/doc/emacs/cal-xtra.texi @@ -1,5 +1,5 @@ -@c This is part of the Emacs manual. -@c Copyright (C) 2004-2012 Free Software Foundation, Inc. +@c This is part of the Emacs manual. -*- coding: iso-latin-1 -*- +@c Copyright (C) 2004-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -9,8 +9,8 @@ @node Advanced Calendar/Diary Usage @section Customizing the Calendar and Diary - There are many customizations that you can use to make the calendar and -diary suit your personal tastes. + There are many ways in which you can customize the calendar and +diary to suit your personal tastes. @menu * Calendar Customizing:: Calendar layout and hooks. @@ -43,12 +43,12 @@ customize the variables @code{calendar-intermonth-header} and @vindex diary-entry-marker @vindex calendar-today-marker The variable @code{calendar-holiday-marker} specifies how to mark a -date as being a holiday. Its value may be a single-character string to +date that is a holiday. Its value may be a single-character string to insert next to the date, or a face name to use for displaying the date. Likewise, the variable @code{diary-entry-marker} specifies how to mark a -date that has diary entries, and @code{calendar-today-marker} is used by -the function @code{calendar-mark-today} to mark today's date. By -default, the calendar uses faces named @code{holiday}, @code{diary}, and +date that has diary entries. The function @code{calendar-mark-today} +uses @code{calendar-today-marker} to mark today's date. By default, +the calendar uses faces named @code{holiday}, @code{diary}, and @code{calendar-today} for these purposes. @vindex calendar-load-hook @@ -65,7 +65,7 @@ display does not run this hook. But if you leave the calendar with the @vindex calendar-today-visible-hook @findex calendar-star-date The variable @code{calendar-today-visible-hook} is a normal hook run -after the calendar buffer has been prepared with the calendar when the +after the calendar buffer has been prepared with the calendar, when the current date is visible in the window. One use of this hook is to mark today's date; to do that use either of the functions @code{calendar-mark-today} or @code{calendar-star-date}: @@ -90,28 +90,27 @@ the current date is @emph{not} visible in the window. @vindex calendar-holidays @vindex holiday-oriental-holidays @vindex holiday-solar-holidays - Emacs knows about holidays defined by entries on one of several lists. -The lists of holidays that Emacs uses are for -general holidays (@code{holiday-general-holidays}), -local holidays (@code{holiday-local-holidays}), -sun- and moon-related holidays (@code{holiday-solar-holidays}), -Baha'i holidays (@code{holiday-bahai-holidays}), -Christian holidays (@code{holiday-christian-holidays}), -Hebrew (Jewish) holidays (@code{holiday-hebrew-holidays}), -Islamic (Muslim) holidays (@code{holiday-islamic-holidays}), -Oriental holidays (@code{holiday-oriental-holidays}), -and other holidays (@code{holiday-other-holidays}). + There are several variables listing the default holidays that Emacs +knows about. These are: @code{holiday-general-holidays}, +@code{holiday-local-holidays}, @code{holiday-solar-holidays}, +@code{holiday-bahai-holidays}, @code{holiday-christian-holidays}, +@code{holiday-hebrew-holidays}, @code{holiday-islamic-holidays}, +@code{holiday-oriental-holidays}, and @code{holiday-other-holidays}. +The names should be self-explanatory; e.g.@: @code{holiday-solar-holidays} +lists sun- and moon-related holidays. You can customize these lists of holidays to your own needs, deleting or adding holidays as described below. Set any of them to @code{nil} to -eliminate the associated holidays. +not show the associated holidays. @vindex holiday-general-holidays - The general holidays are, by default, holidays common throughout the -United States. - @vindex holiday-local-holidays - There are no default local holidays, but your site may supply some. +@vindex holiday-other-holidays + The general holidays are, by default, holidays common throughout the +United States. In contrast, @code{holiday-local-holidays} and +@code{holiday-other-holidays} are both empty by default. These are +intended for system-wide settings and your individual use, +respectively. @vindex holiday-bahai-holidays @vindex holiday-christian-holidays @@ -129,18 +128,13 @@ all) of the variables @code{calendar-bahai-all-holidays-flag}, @code{calendar-hebrew-all-holidays-flag}, or @code{calendar-islamic-all-holidays-flag} to @code{t}. -@vindex holiday-other-holidays - You can set the variable @code{holiday-other-holidays} to any list of -holidays. This list, normally empty, is intended for individual use. - @cindex holiday forms Each of the holiday variables is a list of @dfn{holiday forms}, each -form describing a holiday (or sometimes a list of holidays). - - Here is a table of the possible kinds of holiday form. Day numbers -and month numbers count starting from 1, but ``dayname'' numbers -count Sunday as 0. The element @var{string} is always the -description of the holiday, as a string. +form describing a holiday (or sometimes a list of holidays). Here is +a table of the possible kinds of holiday form. Day numbers and month +numbers count starting from 1, but ``dayname'' numbers count Sunday as +0. The argument @var{string} is always the description of the +holiday, as a string. @table @code @item (holiday-fixed @var{month} @var{day} @var{string}) @@ -202,7 +196,7 @@ the month (1 specifies the first occurrence, 2 the second occurrence, @minus{}1 the last occurrence, @minus{}2 the second-to-last occurrence, and so on). - You can specify holidays that occur on fixed days of the Baha'i, + You can specify holidays that occur on fixed days of the Bahá'í, Chinese, Hebrew, Islamic, and Julian calendars too. For example, @smallexample @@ -256,15 +250,15 @@ and write an Emacs Lisp function @code{eclipses} that returns a visible in the calendar window, with descriptive strings, like this: @smallexample -(((6 27 1991) "Lunar Eclipse") ((7 11 1991) "Solar Eclipse") ... ) +(((6 4 2012) "Lunar Eclipse") ((11 13 2012) "Solar Eclipse") ... ) @end smallexample @node Date Display Format @subsection Date Display Format @vindex calendar-date-display-form - You can customize the manner of displaying dates in the diary, in mode -lines, and in messages by setting @code{calendar-date-display-form}. + You can customize the way dates are displayed in the diary, mode +lines, and messages by setting @code{calendar-date-display-form}. This variable holds a list of expressions that can involve the variables @code{month}, @code{day}, and @code{year}, which are all numbers in string form, and @code{monthname} and @code{dayname}, which are both @@ -291,7 +285,7 @@ The default ISO date representation is: @end smallexample @noindent -This specifies a typical American format: +Another typical American format is: @smallexample (month "/" day "/" (substring year -2)) @@ -358,7 +352,7 @@ be regular expressions (@pxref{Regular Expressions,,, elisp, the Emacs Lisp Reference Manual}) or the symbols @code{month}, @code{day}, @code{year}, @code{monthname}, and @code{dayname}. All these elements serve as patterns that match certain kinds of text in the diary file. -In order for the date pattern, as a whole, to match, all of its elements +In order for the date pattern as a whole to match, all of its elements must match consecutively. A regular expression in a date pattern matches in its usual fashion, @@ -387,8 +381,8 @@ provided by @code{diary-american-date-forms}: @end example @noindent -Other default styles are provided by @code{diary-european-date-forms} -and @code{diary-iso-date-forms}. +The variables @code{diary-european-date-forms} and +@code{diary-iso-date-forms} provide other default styles. The date patterns in the list must be @emph{mutually exclusive} and must not match any portion of the diary entry itself, just the date and @@ -419,7 +413,7 @@ the fourth pattern. @subsection Diary Entries Using non-Gregorian Calendars As well as entries based on the standard Gregorian calendar, your -diary can have entries based on Baha'i, Hebrew, or Islamic dates. +diary can have entries based on Bahá'í, Hebrew, or Islamic dates. Recognition of such entries can be time-consuming, however, and since most people don't use them, you must explicitly enable their use. If you want the diary to recognize Hebrew-date diary entries, for example, @@ -439,7 +433,7 @@ you must do this: @end smallexample @noindent -Similarly, for Islamic and Baha'i entries, add +Similarly, for Islamic and Bahá'í entries, add @code{diary-islamic-list-entries} and @code{diary-islamic-mark-entries}, or @code{diary-bahai-list-entries} and @code{diary-bahai-mark-entries}. @@ -448,7 +442,7 @@ Similarly, for Islamic and Baha'i entries, add @vindex diary-islamic-entry-symbol These diary entries have the same formats as Gregorian-date diary entries; except that @code{diary-bahai-entry-symbol} (default @samp{B}) -must precede a Baha'i date, @code{diary-hebrew-entry-symbol} (default +must precede a Bahá'í date, @code{diary-hebrew-entry-symbol} (default @samp{H}) a Hebrew date, and @code{diary-islamic-entry-symbol} (default @samp{I}) an Islamic date. Moreover, non-Gregorian month names may not be abbreviated (because the first three letters are often not unique). @@ -475,7 +469,7 @@ nonmarking if preceded by @code{diary-nonmarking-symbol} (default Here is a table of commands used in the calendar to create diary entries that match the selected date and other dates that are similar in -the Baha'i, Hebrew, or Islamic calendars: +the Bahá'í, Hebrew, or Islamic calendars: @table @kbd @item i h d @@ -538,7 +532,13 @@ are no diary entries, even if that day is a holiday. If you want such days to be shown in the fancy diary buffer, set the variable @code{diary-list-include-blanks} to @code{t}.@refill - The fancy diary buffer enables View mode (@pxref{View Mode}). + The fancy diary buffer enables View mode +@iftex +(@pxref{View Mode,,, emacs, the Emacs Manual}). +@end iftex +@ifnottex +(@pxref{View Mode}). +@end ifnottex The alternative display method @code{diary-simple-display} shows the actual diary buffer, and uses invisible text to hide entries that don't @@ -569,7 +569,13 @@ display, the other irrelevant entries are really absent, not just hidden. After preparing the buffer, it runs the hook @code{diary-print-entries-hook}. The default value of this hook sends the data directly to the printer with the command @code{lpr-buffer} -(@pxref{Printing}). If you want to use a different command to do the +@iftex +(@pxref{Printing,,, emacs, the Emacs Manual}). +@end iftex +@ifnottex +(@pxref{Printing}). +@end ifnottex +If you want to use a different command to do the printing, just change the value of this hook. Other uses might include, for example, rearranging the lines into order by day and time. @@ -615,7 +621,7 @@ of the diary entries, or add items. variables @code{diary-comment-start} and @code{diary-comment-end} to strings that delimit comments. The fancy display does not print comments. You might want to put meta-data for the use of other packages -(e.g. the appointment package, +(e.g.@: the appointment package, @iftex @pxref{Appointments,,,emacs, the Emacs Manual}) @end iftex @@ -699,7 +705,7 @@ that have occurred: @findex diary-cyclic @smallexample -%%(diary-cyclic 50 1 1 1990) Renew medication (%d%s time) +%%(diary-cyclic 50 1 1 2012) Renew medication (%d%s time) @end smallexample @noindent @@ -710,9 +716,9 @@ Renew medication (5th time) @end smallexample @noindent -in the fancy diary display on September 8, 1990. +in the fancy diary display on September 7, 2012. - There is an early reminder diary sexp that includes its entry in the + There is an ``early reminder'' diary sexp that includes its entry in the diary not only on the date of occurrence, but also on earlier dates. For example, if you want a reminder a week before your anniversary, you can use @@ -838,7 +844,7 @@ Make a diary entry with today's equivalent Julian calendar date. @item %%(diary-astro-day-number) Make a diary entry with today's equivalent astronomical (Julian) day number. @item %%(diary-bahai-date) -Make a diary entry with today's equivalent Baha'i calendar date. +Make a diary entry with today's equivalent Bahá'í calendar date. @item %%(diary-chinese-date) Make a diary entry with today's equivalent Chinese calendar date. @item %%(diary-coptic-date) diff --git a/doc/emacs/calendar.texi b/doc/emacs/calendar.texi index 495828d6d8a..c2851d4abd3 100644 --- a/doc/emacs/calendar.texi +++ b/doc/emacs/calendar.texi @@ -1,4 +1,4 @@ -@c This is part of the Emacs manual. +@c This is part of the Emacs manual. -*- coding: iso-latin-1 -*- @c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2012 @c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @@ -143,8 +143,7 @@ arguments in Calendar mode even without the Meta modifier. For example, A week (or month, or year) is not just a quantity of days; we think of weeks (months, years) as starting on particular dates. So Calendar mode -provides commands to move to the beginning or end of a week, month or -year: +provides commands to move to the start or end of a week, month or year: @table @kbd @kindex C-a @r{(Calendar mode)} @@ -246,12 +245,10 @@ Scroll calendar one month forward (@code{calendar-scroll-left}). Scroll calendar one month backward (@code{calendar-scroll-right}). @item C-v @itemx @key{next} -Scroll calendar three months forward -(@code{calendar-scroll-left-three-months}). +Scroll three months forward (@code{calendar-scroll-left-three-months}). @item M-v @itemx @key{prior} -Scroll calendar three months backward -(@code{calendar-scroll-right-three-months}). +Scroll three months backward (@code{calendar-scroll-right-three-months}). @end table @kindex > @r{(Calendar mode)} @@ -290,7 +287,8 @@ Display the number of days in the current region @kindex M-= @r{(Calendar mode)} @findex calendar-count-days-region - To determine the number of days in the region, type @kbd{M-=} + To determine the number of days in a range, set the mark on one +date using @kbd{C-SPC}, move point to another date, and type @kbd{M-=} (@code{calendar-count-days-region}). The numbers of days shown is @emph{inclusive}; that is, it includes the days specified by mark and point. @@ -342,6 +340,8 @@ buries all buffers related to the calendar, selecting other buffers. calendar deletes or iconifies that frame depending on the value of @code{calendar-remove-frame-by-deleting}.) +@c FIXME this mentions holidays and diary entries, albeit briefly, so +@c should it be moved after those sections? Or at least xref them. @node Writing Calendar Files @section Writing Calendar Files @@ -427,7 +427,7 @@ Generate a Filofax-style calendar for one year Some of these commands print the calendar sideways (in ``landscape mode''), so it can be wider than it is long. Some of them use Filofax paper size (3.75in x 6.75in). All of these commands accept a prefix -argument which specifies how many days, weeks, months or years to print +argument, which specifies how many days, weeks, months or years to print (starting always with the selected one). If the variable @code{cal-tex-holidays} is non-@code{nil} (the default), @@ -452,11 +452,10 @@ to. and can display them. You can add your own holidays to the default list. @table @kbd -@item h +@item Mouse-3 Holidays +@itemx h Display holidays for the selected date (@code{calendar-cursor-holidays}). -@item Mouse-3 Holidays -Display any holidays for the date you click on. @item x Mark holidays in the calendar window (@code{calendar-mark-holidays}). @item u @@ -519,7 +518,7 @@ holidays centered around a different month, use @kbd{C-u M-x holidays}, which prompts for the month and year. The holidays known to Emacs include United States holidays and the -major Baha'i, Chinese, Christian, Islamic, and Jewish holidays; also the +major Bahá'í, Chinese, Christian, Islamic, and Jewish holidays; also the solstices and equinoxes. @findex list-holidays @@ -541,11 +540,10 @@ practice}, not historical fact. For example Veteran's Day began in times of sunrise and sunset for any date. @table @kbd -@item S +@item Mouse-3 Sunrise/sunset +@itemx S Display times of sunrise and sunset for the selected date (@code{calendar-sunrise-sunset}). -@item Mouse-3 Sunrise/sunset -Display times of sunrise and sunset for the date you click on. @item M-x sunrise-sunset Display times of sunrise and sunset for today's date. @item C-u M-x sunrise-sunset @@ -615,9 +613,8 @@ for how daylight saving time is determined. As a user, you might find it convenient to set the calendar location variables for your usual physical location in your @file{.emacs} file. -And when you install Emacs on a machine, you can create a -@file{default.el} file which sets them properly for the typical location -of most users of that machine. @xref{Init File}. +If you are a system administrator, you may want to set these variables +for all users in a @file{default.el} file. @xref{Init File}. @node Lunar Phases @section Phases of the Moon @@ -666,8 +663,8 @@ sixteenth century and was not widely used before the eighteenth century; it did not fully displace the Julian calendar and gain universal acceptance until the early twentieth century. The Emacs calendar can display any month since January, year 1 of the current era, but the -calendar displayed is the Gregorian, even for a date at which the -Gregorian calendar did not exist. +calendar displayed is always the Gregorian, even for a date at which +the Gregorian calendar did not exist. While Emacs cannot display other calendars, it can convert dates to and from several other calendars. @@ -680,11 +677,13 @@ and from several other calendars. * Mayan Calendar:: Moving to a date specified in a Mayan calendar. @end menu +@c FIXME perhaps most of the details should be moved to cal-xtra. +@c Just list the major supported systems here? @node Calendar Systems @subsection Supported Calendar Systems @cindex ISO commercial calendar - The ISO commercial calendar is used largely in Europe. + The ISO commercial calendar is often used in business. @cindex Julian calendar The Julian calendar, named after Julius Caesar, was the one used in Europe @@ -745,7 +744,8 @@ championed by Birashk, based on a 2,820-year cycle. It differs from the astronomical Persian calendar, which is based on astronomical events. As of this writing the first future discrepancy is projected to occur on March 20, 2025. It is currently not clear what the -official calendar of Iran will be that far into the future. +official calendar of Iran will be at that time. +@c FIXME not so far in the future now. @cindex Chinese calendar The Chinese calendar is a complicated system of lunar months arranged @@ -756,8 +756,8 @@ days are named by combining one of ten ``celestial stems'' with one of twelve ``terrestrial branches'' for a total of sixty names that are repeated in a cycle of sixty. -@cindex Baha'i calendar - The Baha'i calendar system is based on a solar cycle of 19 months with +@cindex Bahá'í calendar + The Bahá'í calendar system is based on a solar cycle of 19 months with 19 days each. The four remaining ``intercalary'' days are placed between the 18th and 19th months. @@ -768,11 +768,10 @@ between the 18th and 19th months. in various other calendar systems: @table @kbd -@item Mouse-3 Other calendars -Display the date that you click on, expressed in various other calendars. @kindex p @r{(Calendar mode)} @findex calendar-print-other-dates -@item p o +@item Mouse-3 Other calendars +@itemx p o Display the selected date in various other calendars. (@code{calendar-print-other-dates}). @findex calendar-iso-print-date @@ -798,7 +797,7 @@ Display French Revolutionary date for selected day (@code{calendar-french-print-date}). @findex calendar-bahai-print-date @item p b -Display Baha'i date for selected day +Display Bahá'í date for selected day (@code{calendar-bahai-print-date}). @findex calendar-chinese-print-date @item p C @@ -821,18 +820,16 @@ Display Persian date for selected day Display Mayan date for selected day (@code{calendar-mayan-print-date}). @end table - If you are using a graphic display, the easiest way to translate a -date into other calendars is to click on it with @kbd{Mouse-3}, then -choose @kbd{Other calendars} from the menu that appears. This displays -the equivalent forms of the date in all the calendars Emacs understands, -in the form of a menu. (Choosing an alternative from this menu doesn't -actually do anything---the menu is used only for display.) - Otherwise, move point to the date you want to convert, then type the appropriate command starting with @kbd{p} from the table above. The prefix @kbd{p} is a mnemonic for ``print,'' since Emacs ``prints'' the equivalent date in the echo area. @kbd{p o} displays the -date in all forms known to Emacs. +date in all forms known to Emacs. You can also use @kbd{Mouse-3} and +then choose @kbd{Other calendars} from the menu that appears. This +displays the equivalent forms of the date in all the calendars Emacs +understands, in the form of a menu. (Choosing an alternative from +this menu doesn't actually do anything---the menu is used only for +display.) @node From Other Calendar @subsection Converting From Other Calendars @@ -868,7 +865,7 @@ Move to a date specified in the Julian calendar Move to a date specified with an astronomical (Julian) day number (@code{calendar-astro-goto-day-number}). @item g b -Move to a date specified in the Baha'i calendar +Move to a date specified in the Bahá'í calendar (@code{calendar-bahai-goto-date}). @item g h Move to a date specified in the Hebrew calendar @@ -903,7 +900,7 @@ Islamic, or French names. @c FIXME move? @findex calendar-hebrew-list-yahrzeits @cindex yahrzeits - One common question concerning the Hebrew calendar is the computation + One common issue concerning the Hebrew calendar is the computation of the anniversary of a date of death, called a ``yahrzeit.'' The Emacs calendar includes a facility for such calculations. If you are in the calendar, the command @kbd{M-x calendar-hebrew-list-yahrzeits} asks you for @@ -912,6 +909,7 @@ years for the date given by point. If you are not in the calendar, this command first asks you for the date of death and the range of years, and then displays the list of yahrzeit dates. +@c FIXME move to emacs-xtra. @node Mayan Calendar @subsection Converting from the Mayan Calendar @@ -974,7 +972,7 @@ to go to the next occurrence of a tzolkin date. @findex calendar-mayan-next-haab-date @cindex Mayan haab calendar The Mayan haab calendar is a cycle of 365 days arranged as 18 months -of 20 days each, followed a 5-day monthless period. Like the tzolkin +of 20 days each, followed by a 5-day monthless period. Like the tzolkin cycle, this cycle repeats endlessly, and there are commands to move backward and forward to the previous or next point in the cycle. Type @kbd{g m p h} to go to the previous haab date; Emacs asks you for a haab @@ -1014,7 +1012,7 @@ date. showing what that file looks like: @example -12/22/1988 Twentieth wedding anniversary!! +12/22/2012 Twentieth wedding anniversary!! &1/1. Happy New Year! 10/22 Ruth's birthday. * 21, *: Payday @@ -1023,15 +1021,15 @@ Tuesday--weekly meeting with grad students at 10am 1/13/89 Friday the thirteenth!! &thu 4pm squash game with Lloyd. mar 16 Dad's birthday -April 15, 1989 Income tax due. +April 15, 2013 Income tax due. &* 15 time cards due. @end example @noindent -This format is essentially the same as the one used by the system's -@command{calendar} utility. This example uses extra spaces to align -the event descriptions of most of the entries. Such formatting is -purely a matter of taste. +This format is essentially the same as the one used by the separate +@command{calendar} utility that is present on some Unix systems. This +example uses extra spaces to align the event descriptions of most of +the entries. Such formatting is purely a matter of taste. Although you probably will start by creating a diary manually, Emacs provides a number of commands to let you view, add, and change diary @@ -1053,11 +1051,10 @@ it. You can also view today's events outside of Calendar mode. In the following, key bindings refer to the Calendar buffer. @table @kbd -@item d +@item Mouse-3 Diary +@itemx d Display all diary entries for the selected date (@code{diary-view-entries}). -@item Mouse-3 Diary -Display all diary entries for the date you click on. @item s Display the entire diary file (@code{diary-show-all-entries}). @item m @@ -1111,8 +1108,8 @@ a different face. @xref{Calendar Customizing, diary-entry-marker}. @end ifnottex - The command applies both to the currently visible months and to -other months that subsequently become visible by scrolling. To turn + This command applies both to the months that are currently visible +and to those that subsequently become visible after scrolling. To turn marking off and erase the current marks, type @kbd{u}, which also turns off holiday marks (@pxref{Holidays}). If the variable @code{calendar-mark-diary-entries-flag} is non-@code{nil}, creating or @@ -1136,13 +1133,13 @@ how many days to include. @end ifnottex If you put @code{(diary)} in your @file{.emacs} file, this -automatically displays a window with the day's diary entries, when you -enter Emacs. +automatically displays a window with the day's diary entries when you +start Emacs. @findex diary-mail-entries @vindex diary-mail-days - Many users like to receive notice of events in their diary as email. -To send such mail to yourself, use the command @kbd{M-x + Some people like to receive email notifications of events in their +diary. To send such mail to yourself, use the command @kbd{M-x diary-mail-entries}. A prefix argument specifies how many days (starting with today) to check; otherwise, the variable @code{diary-mail-days} says how many days. @@ -1173,7 +1170,7 @@ consists only of the date or day name (with no following blanks or punctuation). For example: @example -02/11/1989 +02/11/2012 Bill B. visits Princeton today 2pm Cognitive Studies Committee meeting 2:30-5:30 Liz at Lawrenceville @@ -1198,10 +1195,11 @@ for more than one day's entries. @vindex diary-nonmarking-symbol You can inhibit the marking of certain diary entries in the calendar -window; to do this, insert an ampersand @code{diary-nonmarking-symbol} -(default @samp{&}) at the beginning of the entry, before the date. This -has no effect on display of the entry in the diary window; it affects -only marks on dates in the calendar window. Nonmarking entries are +window; to do this, insert the string that +@code{diary-nonmarking-symbol} specifies (default @samp{&}) at the +beginning of the entry, before the date. This +has no effect on display of the entry in the diary window; it only +affects marks on dates in the calendar window. Nonmarking entries are especially useful for generic entries that would otherwise mark many different dates. @@ -1214,14 +1212,14 @@ formatting a date. The examples all show dates in American order month, year) and ISO order (year, month, day) as options. @example -4/20/93 Switch-over to new tabulation system +4/20/12 Switch-over to new tabulation system apr. 25 Start tabulating annual results 4/30 Results for April are due */25 Monthly cycle finishes Friday Don't leave without backing up files @end example - The first entry appears only once, on April 20, 1993. The second and + The first entry appears only once, on April 20, 2012. The second and third appear every year on the specified dates, and the fourth uses a wildcard (asterisk) for the month, so it appears on the 25th of every month. The final entry appears every week on Friday. @@ -1231,7 +1229,7 @@ month. The final entry appears every week on Friday. This must be followed by a nondigit. In the date itself, @var{month} and @var{day} are numbers of one or two digits. The optional @var{year} is also a number, and may be abbreviated to the last two digits; that -is, you can use @samp{11/12/1989} or @samp{11/12/89}. +is, you can use @samp{11/12/2012} or @samp{11/12/12}. Dates can also have the form @samp{@var{monthname} @var{day}} or @samp{@var{monthname} @var{day}, @var{year}}, where the month's name can @@ -1245,7 +1243,7 @@ letters of a name as its abbreviation. Case is not significant. A date may be @dfn{generic}; that is, partially unspecified. Then the entry applies to all dates that match the specification. If the date does not contain a year, it is generic and applies to any year. -Alternatively, @var{month}, @var{day}, or @var{year} can be a @samp{*}; +Alternatively, @var{month}, @var{day}, or @var{year} can be @samp{*}; this matches any month, day, or year, respectively. Thus, a diary entry @samp{3/*/*} matches any day in March of any year; so does @samp{march *}. @@ -1311,7 +1309,7 @@ command, and type the rest of the entry. Similarly, you can insert a yearly diary entry with the @kbd{i y} command. All of the above commands make marking diary entries by default. To -make a nonmarking diary entry, give a numeric argument to the command. +make a nonmarking diary entry, give a prefix argument to the command. For example, @kbd{C-u i w} makes a nonmarking weekly diary entry. When you modify the diary file, be sure to save the file before @@ -1368,15 +1366,15 @@ diary functions can use it to calculate the number of elapsed years. A @dfn{block} diary entry applies to a specified range of consecutive dates. Here is a block diary entry that applies to all dates from June -24, 1990 through July 10, 1990: +24, 2012 through July 10, 2012: @findex diary-block @example -%%(diary-block 6 24 1990 7 10 1990) Vacation +%%(diary-block 6 24 2012 7 10 2012) Vacation @end example @noindent -The @samp{6 24 1990} indicates the starting date and the @samp{7 10 1990} +The @samp{6 24 2012} indicates the starting date and the @samp{7 10 2012} indicates the stopping date. (Again, if you are using the European or ISO calendar style, the input order of month, day and year is different.) @@ -1396,23 +1394,23 @@ which looks like this: @findex diary-cyclic @example -%%(diary-cyclic 50 3 1 1990) Renew medication +%%(diary-cyclic 50 3 1 2012) Renew medication @end example @noindent -This entry applies to March 1, 1990 and every 50th day following; -@samp{3 1 1990} specifies the starting date. (If you are using the +This entry applies to March 1, 2012 and every 50th day following; +@samp{3 1 2012} specifies the starting date. (If you are using the European or ISO calendar style, the input order of month, day and year is different.) All three of these commands make marking diary entries. To insert a -nonmarking entry, give a numeric argument to the command. For example, +nonmarking entry, give a prefix argument to the command. For example, @kbd{C-u i a} makes a nonmarking anniversary diary entry. - Marking sexp diary entries in the calendar is @emph{extremely} -time-consuming, since every date visible in the calendar window must be -individually checked. So it's a good idea to make sexp diary entries -nonmarking (with @samp{&}) when possible. + Marking sexp diary entries in the calendar can be time-consuming, +since every date visible in the calendar window must be individually +checked. So it's a good idea to make sexp diary entries nonmarking +(with @samp{&}) when possible. Another sophisticated kind of sexp entry, a @dfn{floating} diary entry, specifies a regularly occurring event by offsets specified in days, @@ -1454,8 +1452,8 @@ can perform arbitrary computations to determine when they apply. @vindex appt-audible @vindex appt-display-mode-line If you have a diary entry for an appointment, and that diary entry -begins with a recognizable time of day, Emacs can warn you several -minutes beforehand that that appointment is pending. Emacs alerts you +begins with a recognizable time of day, Emacs can warn you in advance +that an appointment is pending. Emacs alerts you to the appointment by displaying a message in your chosen format, as specified by the variable @code{appt-display-format}. If the value of @code{appt-audible} is non-@code{nil}, the warning includes an audible @@ -1542,6 +1540,7 @@ diary-from-outlook} to import the entry. You can make this command recognize additional appointment message formats by customizing the variable @code{diary-outlook-formats}. +@c FIXME the name of the RFC is hardly very relevant. @cindex iCalendar support The icalendar package allows you to transfer data between your Emacs diary file and iCalendar files, which are defined in ``RFC @@ -1556,7 +1555,7 @@ diary file and iCalendar files, which are defined in ``RFC @findex icalendar-import-buffer The command @code{icalendar-import-buffer} extracts -iCalendar data from the current buffer and adds it to your (default) +iCalendar data from the current buffer and adds it to your diary file. This function is also suitable for automatic extraction of iCalendar data; for example with the Rmail mail client one could use: @@ -1588,7 +1587,7 @@ to the main diary file, if these are different files. Use @code{icalendar-export-file} to interactively export an entire Emacs diary file to iCalendar format. To export only a part of a diary file, mark the relevant area, and call @code{icalendar-export-region}. -In both cases the result is appended to the target file. +In both cases, Emacs appends the result to the target file. @node Daylight Saving @section Daylight Saving Time @@ -1694,7 +1693,7 @@ workday in the mode line, either customize the @vindex timeclock-ask-before-exiting Terminating the current Emacs session might or might not mean that you have stopped working on the project and, by default, Emacs asks -you. You can, however, set customize the value of the variable +you. You can, however, customize the value of the variable @code{timeclock-ask-before-exiting} to @code{nil} to avoid the question; then, only an explicit @kbd{M-x timeclock-out} or @kbd{M-x timeclock-change} will tell Emacs that the current interval is over. diff --git a/doc/emacs/dired-xtra.texi b/doc/emacs/dired-xtra.texi index bc141650b4a..81de9a800f9 100644 --- a/doc/emacs/dired-xtra.texi +++ b/doc/emacs/dired-xtra.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2004-2012 Free Software Foundation, Inc. +@c Copyright (C) 2004-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -9,12 +9,19 @@ You can insert subdirectories with specified @command{ls} switches in Dired buffers using @kbd{C-u i}. You can change the @command{ls} -switches of an already inserted subdirectory using @kbd{C-u l}. +switches of an already inserted subdirectory at point using @kbd{C-u l}. Dired preserves the switches if you revert the buffer. Deleting a subdirectory forgets about its switches. -Using @code{dired-undo} (@pxref{Marks vs Flags}) to reinsert or delete +Using @code{dired-undo} +@iftex +(@pxref{Marks vs Flags,,, emacs, the Emacs Manual}) +@end iftex +@ifnottex +(@pxref{Marks vs Flags}) +@end ifnottex +to reinsert or delete subdirectories that were inserted with explicit switches can bypass Dired's machinery for remembering (or forgetting) switches. Deleting a subdirectory using @code{dired-undo} does not forget its switches. diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index 8159b8cc6aa..d86e0049fb5 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi @@ -28,7 +28,7 @@ the text is displayed. * Highlight Interactively:: Tell Emacs what text to highlight. * Fringes:: Enabling or disabling window fringes. * Displaying Boundaries:: Displaying top and bottom of the buffer. -* Useless Whitespace:: Showing possibly-spurious trailing whitespace. +* Useless Whitespace:: Showing possibly spurious trailing whitespace. * Selective Display:: Hiding lines with lots of indentation. * Optional Mode Line:: Optional mode line display features. * Text Display:: How text characters are normally displayed. diff --git a/doc/emacs/emacs-xtra.texi b/doc/emacs/emacs-xtra.texi index 596cc13abf5..78cac7d8a10 100644 --- a/doc/emacs/emacs-xtra.texi +++ b/doc/emacs/emacs-xtra.texi @@ -11,8 +11,7 @@ @copying This manual describes specialized features of Emacs. -Copyright @copyright{} 2004-2012 -Free Software Foundation, Inc. +Copyright @copyright{} 2004-2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -34,6 +33,8 @@ license to the document, as described in section 6 of the license. @end quotation @end copying +@documentencoding ISO-8859-1 + @dircategory Emacs @direntry * Emacs-Xtra: (emacs-xtra). Specialized Emacs features. @@ -68,7 +69,7 @@ license to the document, as described in section 6 of the license. * Emerge:: A convenient way of merging two versions of a program. * Advanced VC Usage:: Advanced VC (version control) features. * Fortran:: Fortran mode and its special features. -* MS-DOS:: Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}). +* MS-DOS:: Using Emacs on MS-DOS. @end iftex * Index:: @end menu @@ -109,10 +110,10 @@ style of the Elisp manual. Other sections should follow the style of the Emacs manual. @iftex -@c ``Picture Mode'' is a chapter, not a section, so it's outside @raisesections. -@include picture-xtra.texi @raisesections +@include picture-xtra.texi + @include arevert-xtra.texi @include dired-xtra.texi diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index 1f7fecb8b6a..ef438cd3067 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -11,7 +11,7 @@ This is the @value{EDITION} edition of the @cite{GNU Emacs Manual},@* updated for Emacs version @value{EMACSVER}. -Copyright @copyright{} 1985-1987, 1993-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1985-1987, 1993-2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -99,12 +99,12 @@ Cover art by Etienne Suvasa. Emacs is the extensible, customizable, self-documenting real-time display editor. This Info file describes how to edit with Emacs and -some of how to customize it; it corresponds to GNU Emacs version +some of the ways to customize it; it corresponds to GNU Emacs version @value{EMACSVER}. @ifinfo -To learn more about the Info documentation system, type @kbd{h}, -to visit a programmed instruction sequence for the Info commands. +If you are reading this in Emacs, type @kbd{h} to read a basic +introduction to the Info documentation system. @end ifinfo For information on extending Emacs, see @ref{Top, Emacs Lisp,, elisp, The @@ -113,6 +113,8 @@ Emacs Lisp Reference Manual}. @insertcopying @end ifnottex +@c Note that the TeX version generates its own TOC, so the ifnottex's +@c here are not really necessary. @menu * Distrib:: How to get the latest Emacs distribution. * Intro:: An introduction to Emacs concepts. @@ -146,12 +148,7 @@ Fundamental Editing Commands Important Text-Changing Commands * Mark:: The mark: how to delimit a "region" of text. -* Killing:: Killing (cutting) text. -* Yanking:: Recovering killed text. Moving text. (Pasting.) -* Cut and Paste:: Clipboard and selections on graphical displays. -* Accumulating Text:: Other ways of copying text. -* Rectangles:: Operating on text in rectangular areas. -* CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} to kill and yank. +* Killing:: Killing (cutting) and yanking (copying) text. * Registers:: Saving a text string or a location in the buffer. * Display:: Controlling what text is displayed. * Search:: Finding or replacing occurrences of a string. @@ -161,8 +158,8 @@ Important Text-Changing Commands Major Structures of Emacs * Files:: All about handling files. * Buffers:: Multiple buffers; editing several files at once. -* Windows:: Viewing two pieces of text at once. -* Frames:: Running the same Emacs session in multiple X windows. +* Windows:: Viewing multiple pieces of text in one frame. +* Frames:: Using multiple ``windows'' on your display. * International:: Using non-@acronym{ASCII} character sets. Advanced Features @@ -172,8 +169,7 @@ Advanced Features * Programs:: Commands and modes for editing programs. * Building:: Compiling, running and debugging programs. * Maintaining:: Features for maintaining large programs. -* Abbrevs:: Defining text abbreviations to reduce - the number of characters you must type. +* Abbrevs:: Defining text abbreviations to reduce typing. * Dired:: Directory and file manager. * Calendar/Diary:: Calendar and diary facilities. * Sending Mail:: Sending mail in Emacs. @@ -187,7 +183,7 @@ Advanced Features @ifnottex * Picture Mode:: Editing pictures made up of text characters. @end ifnottex -* Editing Binary Files:: Editing binary files with Hexl mode. +* Editing Binary Files:: Editing binary files with Hexl mode. * Saving Emacs Sessions:: Saving Emacs state from one session to the next. * Recursive Edit:: Performing edits while "within another command". * Emulation:: Emulating some other editors with Emacs. @@ -291,6 +287,15 @@ The Mark and the Region Killing and Moving Text +* Deletion and Killing:: Commands that remove text. +* Yanking:: Recovering killed text. Moving text. (Pasting.) +* Cut and Paste:: Clipboard and selections on graphical displays. +* Accumulating Text:: Other ways of copying text. +* Rectangles:: Operating on text in rectangular areas. +* CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} to kill and yank. + +Deletion and Killing + * Deletion:: Commands for deleting small amounts of text and blank areas. * Killing by Lines:: How to kill entire lines of text at one time. @@ -338,7 +343,7 @@ Controlling the Display * Highlight Interactively:: Tell Emacs what text to highlight. * Fringes:: Enabling or disabling window fringes. * Displaying Boundaries:: Displaying top and bottom of the buffer. -* Useless Whitespace:: Showing possibly-spurious trailing whitespace. +* Useless Whitespace:: Showing possibly spurious trailing whitespace. * Selective Display:: Hiding lines with lots of indentation. * Optional Mode Line:: Optional mode line display features. * Text Display:: How text characters are normally displayed. @@ -391,8 +396,10 @@ Keyboard Macros * Basic Keyboard Macro:: Defining and running keyboard macros. * Keyboard Macro Ring:: Where previous keyboard macros are saved. * Keyboard Macro Counter:: Inserting incrementing numbers in macros. -* Keyboard Macro Query:: Making keyboard macros do different things each time. -* Save Keyboard Macro:: Giving keyboard macros names; saving them in files. +* Keyboard Macro Query:: Making keyboard macros do different things each + time. +* Save Keyboard Macro:: Giving keyboard macros names; saving them in + files. * Edit Keyboard Macro:: Editing keyboard macros. * Keyboard Macro Step-Edit:: Interactively executing and editing a keyboard macro. @@ -403,7 +410,9 @@ File Handling * Visiting:: Visiting a file prepares Emacs to edit the file. * Saving:: Saving makes your changes permanent. * Reverting:: Reverting cancels all the changes not saved. +@ifnottex * Autorevert:: Auto Reverting non-file buffers. +@end ifnottex * Auto Save:: Auto Save periodically protects against loss of data. * File Aliases:: Handling multiple names for one file. * Directories:: Creating, deleting, and listing file directories. @@ -412,7 +421,7 @@ File Handling * Misc File Ops:: Other things you can do on files. * Compressed Files:: Accessing compressed files. * File Archives:: Operating on tar, zip, jar etc. archive files. -* Remote Files:: Accessing files on other sites. +* Remote Files:: Accessing files on other machines. * Quoted File Names:: Quoting special characters in file names. * File Name Cache:: Completion against a list of files you often use. * File Conveniences:: Convenience Features for Finding Files. @@ -434,11 +443,13 @@ Backup Files * Backup Deletion:: Emacs deletes excess numbered backups. * Backup Copying:: Backups can be made by copying or renaming. +@ifnottex Auto Reverting Non-File Buffers * Auto Reverting the Buffer Menu:: Auto Revert of the Buffer Menu. * Auto Reverting Dired:: Auto Revert of Dired buffers. * Supporting additional buffers:: How to add more Auto Revert support. +@end ifnottex Auto-Saving: Protection Against Disasters @@ -475,6 +486,10 @@ Multiple Windows * Displaying Buffers:: How Emacs picks a window for displaying a buffer. * Window Convenience:: Convenience functions for window handling. +Displaying Buffers + +* Window Choice:: How @code{display-buffer} works. + Frames and Graphical Displays * Mouse Commands:: Moving, cutting, and pasting, with the mouse. @@ -486,7 +501,7 @@ Frames and Graphical Displays * Frame Commands:: Iconifying, deleting, and switching frames. * Fonts:: Changing the frame font. * Speedbar:: How to make and use a speedbar frame. -* Multiple Displays:: How one Emacs job can talk to several displays. +* Multiple Displays:: How one Emacs instance can talk to several displays. * Frame Parameters:: Changing the colors and other modes of frames. * Scroll Bars:: How to enable and disable scroll bars; how to use them. * Drag and Drop:: Using drag and drop to open files and insert text. @@ -523,6 +538,7 @@ International Character Set Support * Unibyte Mode:: You can pick one European character set to use without multibyte characters. * Charsets:: How Emacs groups its internal character codes. +* Bidirectional Editing:: Support for right-to-left scripts. Modes @@ -549,9 +565,9 @@ Commands for Human Languages * Text Mode:: The major modes for editing text files. * Outline Mode:: Editing outlines. * Org Mode:: The Emacs organizer. -* TeX Mode:: Editing input to the formatter TeX. +* TeX Mode:: Editing TeX and LaTeX files. * HTML Mode:: Editing HTML and SGML files. -* Nroff Mode:: Editing input to the formatter nroff. +* Nroff Mode:: Editing input to the nroff formatter. * Enriched Text:: Editing text ``enriched'' with fonts, colors, etc. * Text Based Tables:: Commands for editing text-based tables. * Two-Column:: Splitting text columns into separate windows. @@ -567,12 +583,16 @@ Filling Text Outline Mode * Outline Format:: What the text of an outline looks like. -* Outline Motion:: Special commands for moving through - outlines. +* Outline Motion:: Special commands for moving through outlines. * Outline Visibility:: Commands to control what is visible. * Outline Views:: Outlines and multiple views. * Foldout:: Folding means zooming in on outlines. +Org Mode + +* Org Organizer:: Managing TODO lists and agendas. +* Org Authoring:: Exporting Org buffers to various formats. + @TeX{} Mode * TeX Editing:: Special commands for editing in TeX mode. @@ -622,9 +642,11 @@ Editing Programs * Semantic:: Suite of editing tools based on source code parsing. * Misc for Programs:: Other Emacs features useful for editing programs. * C Modes:: Special commands of C, C++, Objective-C, - Java, and Pike modes. + Java, IDL, Pike and AWK modes. * Asm Mode:: Asm mode and its special features. +@ifnottex * Fortran:: Fortran mode and its special features. +@end ifnottex Top-Level Definitions, or Defuns @@ -657,10 +679,9 @@ Manipulating Comments Documentation Lookup -* Info Lookup:: Looking up library functions and commands - in Info files. -* Man Page:: Looking up man pages of library functions and commands. -* Lisp Doc:: Looking up Emacs Lisp functions, etc. +* Info Lookup:: Looking up library functions and commands in Info files. +* Man Page:: Looking up man pages of library functions and commands. +* Lisp Doc:: Looking up Emacs Lisp functions, etc. C and Related Modes @@ -670,6 +691,7 @@ C and Related Modes * Other C Commands:: Filling comments, viewing expansion of macros, and other neat features. +@ifnottex Fortran Mode * Fortran Motion:: Moving point by statements or subprograms. @@ -686,6 +708,7 @@ Fortran Indentation * ForIndent Num:: How line numbers auto-indent. * ForIndent Conv:: Conventions you must obey to avoid trouble. * ForIndent Vars:: Variables controlling Fortran indent style. +@end ifnottex Compiling and Testing Programs @@ -712,8 +735,7 @@ Running Debuggers Under Emacs * Commands of GUD:: Key bindings for common commands. * GUD Customization:: Defining your own commands for GUD. * GDB Graphical Interface:: An enhanced mode that uses GDB features to - implement a graphical debugging environment through - Emacs. + implement a graphical debugging environment. GDB Graphical Interface @@ -734,7 +756,9 @@ Maintaining Large Programs * Tags:: Go directly to any function in your program in one command. Tags remembers which file it is in. * EDE:: An integrated development environment for Emacs. +@ifnottex * Emerge:: A convenient way of merging two versions of a program. +@end ifnottex Version Control @@ -748,9 +772,10 @@ Version Control * VC Undo:: Canceling changes before or after committing. * VC Directory Mode:: Listing files managed by version control. * Branches:: Multiple lines of development. -* Revision Tags:: Symbolic names for revisions. +@ifnottex * Miscellaneous VC:: Various other commands and features of VC. * Customizing VC:: Variables that change VC's behavior. +@end ifnottex Introduction to Version Control @@ -780,6 +805,7 @@ Multiple Branches of a File * Merging:: Transferring changes between branches. * Creating Branches:: How to start a new branch. +@ifnottex Miscellaneous Commands and Features of VC * Change Logs and VC:: Generating a change log file from log entries. @@ -792,6 +818,7 @@ Customizing VC * General VC Options:: Options that apply to multiple back ends. * RCS and SCCS:: Options for RCS and SCCS. * CVS Options:: Options for CVS. +@end ifnottex Change Logs @@ -808,6 +835,7 @@ Tags Tables * Tags Search:: Using a tags table for searching and replacing. * List Tags:: Listing and finding tags defined in a file. +@ifnottex Merging Files with Emerge * Overview of Emerge:: How to start Emerge. Basic concepts. @@ -820,6 +848,7 @@ Merging Files with Emerge * Exiting Emerge:: What to do when you've finished the merge. * Combining in Emerge:: How to keep both alternatives for a difference. * Fine Points of Emerge:: Miscellaneous issues. +@end ifnottex Abbrevs @@ -855,7 +884,9 @@ Dired, the Directory Editor * Transforming File Names:: Using patterns to rename multiple files. * Comparison in Dired:: Running `diff' by way of Dired. * Subdirectories in Dired:: Adding subdirectories to the Dired buffer. +@ifnottex * Subdir Switches:: Subdirectory switches in Dired. +@end ifnottex * Subdirectory Motion:: Moving across subdirectories, and up and down. * Hiding Subdirectories:: Making subdirectories visible or invisible. * Dired Updating:: Discarding lines for files of no interest. @@ -878,9 +909,11 @@ The Calendar and the Diary * Diary:: Displaying events from your diary. * Appointments:: Reminders when it's time to do something. * Importing Diary:: Converting diary events to/from other formats. -* Daylight Saving:: How to specify when daylight saving time is active. +* Daylight Saving:: How to specify when daylight saving time is active. * Time Intervals:: Keeping track of time intervals. +@ifnottex * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. +@end ifnottex Movement in the Calendar @@ -905,6 +938,7 @@ The Diary * Adding to Diary:: Commands to create diary entries. * Special Diary Entries:: Anniversaries, blocks of dates, cyclic entries, etc. +@ifnottex Customizing the Calendar and Diary * Calendar Customizing:: Calendar layout and hooks. @@ -916,6 +950,7 @@ Customizing the Calendar and Diary * Diary Display:: A choice of ways to display the diary. * Fancy Diary Display:: Sorting diary entries, using included diary files. * Sexp Diary Entries:: More flexible diary entries. +@end ifnottex Document Viewing @@ -967,8 +1002,8 @@ Reading Mail with Rmail Rmail Summaries -* Rmail Make Summary:: Making various sorts of summaries. -* Rmail Summary Edit:: Manipulating messages from the summary. +* Rmail Make Summary:: Making various sorts of summaries. +* Rmail Summary Edit:: Manipulating messages from the summary. Gnus @@ -1155,7 +1190,8 @@ Emacs and Microsoft Windows/MS-DOS * Windows Printing:: How to specify the printer on MS-Windows. * Windows Fonts:: Specifying fonts on MS-Windows. * Windows Misc:: Miscellaneous Windows features. -* MS-DOS:: Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}). +@ifnottex +* MS-DOS:: Using Emacs on MS-DOS. Emacs and MS-DOS @@ -1166,6 +1202,7 @@ Emacs and MS-DOS * MS-DOS Printing:: Printing specifics on MS-DOS. * MS-DOS and MULE:: Support for internationalization on MS-DOS. * MS-DOS Processes:: Running subprocesses on MS-DOS. +@end ifnottex @end detailmenu @end menu @@ -1183,7 +1220,7 @@ primer. If you are new to Emacs, we recommend you start with the integrated, learn-by-doing tutorial, before reading the manual. To run the tutorial, start Emacs and type @kbd{C-h t}. The tutorial describes commands, tells you when to try them, and explains the -results. +results. The tutorial is available in several languages. On first reading, just skim chapters 1 and 2, which describe the notational conventions of the manual and the general appearance of the @@ -1201,20 +1238,19 @@ need them. Read the Common Problems chapter if Emacs does not seem to be working properly. It explains how to cope with several common -problems (@pxref{Lossage}), as well as when and how to report Emacs -bugs (@pxref{Bugs}). +problems (@pxref{Lossage,, Dealing with Emacs Trouble}), as well as +when and how to report Emacs bugs (@pxref{Bugs}). To find the documentation of a particular command, look in the index. Keys (character commands) and command names have separate indexes. There is also a glossary, with a cross reference for each term. This manual is available as a printed book and also as an Info file. -The Info file is for use with the Info program, which is the principal -means of accessing on-line documentation in the GNU system. Both the -Emacs Info file and an Info reader are included with GNU Emacs. The -Info file and the printed book contain substantially the same text and -are generated from the same source files, which are also distributed -with GNU Emacs. +The Info file is for reading from Emacs itself, or with the Info program. +Info is the principal format for documentation in the GNU system. +The Info file and the printed book contain substantially the same text +and are generated from the same source files, which are also +distributed with GNU Emacs. GNU Emacs is a member of the Emacs editor family. There are many Emacs editors, all sharing common principles of organization. For @@ -1223,21 +1259,22 @@ learned from its development, see @cite{Emacs, the Extensible, Customizable Self-Documenting Display Editor}, available from @url{ftp://publications.ai.mit.edu/ai-publications/pdf/AIM-519A.pdf}. -This edition of the manual is intended for use with GNU Emacs +This version of the manual is mainly intended for use with GNU Emacs installed on GNU and Unix systems. GNU Emacs can also be used on -MS-DOS (also called MS-DOG), Microsoft Windows, and Macintosh systems. -Those systems use different file name syntax; in addition -MS-DOS does not support all GNU Emacs features. @xref{Microsoft -Windows}, for information about using Emacs on Windows. -@xref{Mac OS / GNUstep}, for information about using Emacs on -Macintosh (and GNUstep). +MS-DOS, Microsoft Windows, and Macintosh systems. The Info file +version of this manual contains some more information about using +Emacs on those systems. Those systems use different file name syntax; +in addition MS-DOS does not support all GNU Emacs features. +@xref{Microsoft Windows}, for information about using Emacs on +Windows. @xref{Mac OS / GNUstep}, for information about using Emacs +on Macintosh (and GNUstep). @end iftex @node Distrib, Intro, Top, Top @unnumbered Distribution GNU Emacs is @dfn{free software}; this means that everyone is free to -use it and free to redistribute it on certain conditions. GNU Emacs +use it and free to redistribute it under certain conditions. GNU Emacs is not in the public domain; it is copyrighted and there are restrictions on its distribution, but these restrictions are designed to permit everything that a good cooperating citizen would want to do. @@ -1245,11 +1282,10 @@ What is not allowed is to try to prevent others from further sharing any version of GNU Emacs that they might get from you. The precise conditions are found in the GNU General Public License that comes with Emacs and also appears in this manual@footnote{This manual is itself -covered by the GNU Free Documentation License (see the reverse title -page in the printed manual or view the full source for online formats -to see the precise conditions). This license is similar in spirit to -the General Public License, but is more suitable for documentation. -@xref{GNU Free Documentation License}.}. @xref{Copying}. +covered by the GNU Free Documentation License. This license is +similar in spirit to the General Public License, but is more suitable +for documentation. @xref{GNU Free Documentation License}.}. +@xref{Copying}. One way to get a copy of GNU Emacs is from someone else who has it. You need not ask for our permission to do so, or tell any one else; @@ -1266,14 +1302,22 @@ redistribute the GNU Emacs received from them under the usual terms of the General Public License. In other words, the program must be free for you when you get it, not just free for the manufacturer. -@c FIXME no longer true? -You can also order copies of GNU Emacs from the Free Software -Foundation. This is a convenient and reliable way to get a copy; it is -also a good way to help fund our work. We also sell hardcopy versions -of this manual and @cite{An Introduction to Programming in Emacs Lisp}, -by Robert J. Chassell. You can visit our online store at -@url{http://shop.fsf.org/}. For further information, -write to +If you find GNU Emacs useful, please @strong{send a donation} to the +Free Software Foundation to support our work. Donations to the Free +Software Foundation are tax deductible in the US. If you use GNU Emacs +at your workplace, please suggest that the company make a donation. +For more information on how you can help, see +@url{http://www.gnu.org/help/help.html}. + +We also sell hardcopy versions of this manual and @cite{An +Introduction to Programming in Emacs Lisp}, by Robert J.@: Chassell. +You can visit our online store at @url{http://shop.fsf.org/}. +The income from sales goes to support the foundation's purpose: the +development of new free software, and improvements to our existing +programs including GNU Emacs. + +If you need to contact the Free Software Foundation, see +@url{http://www.fsf.org/about/contact/}, or write to @display Free Software Foundation @@ -1282,103 +1326,110 @@ Boston, MA 02110-1301 USA @end display -The income from sales goes to support the foundation's purpose: the -development of new free software, and improvements to our existing -programs including GNU Emacs. - -@c FIXME you can't order a CD any more. -If you find GNU Emacs useful, please @strong{send a donation} to the -Free Software Foundation to support our work. Donations to the Free -Software Foundation are tax deductible in the US. If you use GNU Emacs -at your workplace, please suggest that the company make a donation. If -company policy is unsympathetic to the idea of donating to charity, you -might instead suggest ordering a CD-ROM from the Foundation -occasionally, or subscribing to periodic updates. - @iftex @node Acknowledgments, Intro, Distrib, Top @unnumberedsec Acknowledgments Contributors to GNU Emacs include Jari Aalto, Per Abrahamsen, Tomas -Abrahamsson, Jay K.@: Adams, Michael Albinus, Nagy Andras, Ralf Angeli, -Joe Arceneaux, Miles Bader, David Bakhash, Juanma Barranquero, Eli -Barzilay, Thomas Baumann, Steven L.@: Baur, Jay Belanger, Alexander L.@: -Belikoff, Boaz Ben-Zvi, Karl Berry, Anna M.@: Bigatti, Ray Blaak, Jim -Blandy, Johan Bockgård, Jan Böcker, Lennart Borgman, Per Bothner, +Abrahamsson, Jay K.@: Adams, Alon Albert, Michael Albinus, Nagy +Andras, Benjamin Andresen, Ralf Angeli, Joe Arceneaux, Emil Åström, +Miles Bader, David Bakhash, Juanma Barranquero, Eli Barzilay, Thomas +Baumann, Steven L.@: Baur, Jay Belanger, Alexander L.@: Belikoff, +Thomas Bellman, Scott Bender, Boaz Ben-Zvi, Sergey Berezin, Karl +Berry, Anna M.@: Bigatti, Ray Blaak, Martin Blais, Jim Blandy, Johan +Bockgård, Jan Böcker, Joel Boehland, Lennart Borgman, Per Bothner, Terrence Brannon, Frank Bresz, Peter Breton, Emmanuel Briot, Kevin -Broadey, Vincent Broman, David M.@: Brown, Georges Brun-Cottan, Joe -Buehler, W@l{}odek Bzyl, Bill Carpenter, Per Cederqvist, Hans Chalupsky, -Chong Yidong, Chris Chase, Bob Chassell, Andrew Choi, Sacha Chua, James -Clark, Mike Clarkson, Glynn Clements, Daniel Colascione, Andrew Csillag, -Baoqiu Cui, Doug Cutting, Mathias Dahl, Julien Danjou, Satyaki Das, -Vivek Dasmohapatra, Michael DeCorte, Gary Delp, Matthieu Devin, Eri -Ding, Jan Djärv, Carsten Dominik, Scott Draves, Benjamin Drieu, -Viktor Dukhovni, Dmitry Dzhus, John Eaton, Rolf Ebert, Paul Eggert, -Stephen Eglen, Torbjörn Einarsson, Tsugutomo Enami, Hans Henrik -Eriksen, Michael Ernst, Ata Etemadi, Frederick Farnbach, Oscar -Figueiredo, Fred Fish, Karl Fogel, Gary Foster, Romain Francoise, Noah -Friedman, Andreas Fuchs, Hallvard Furuseth, Keith Gabryelski, Peter S.@: -Galbraith, Kevin Gallagher, Kevin Gallo, Juan León Lahoz -García, Howard Gayle, Daniel German, Stephen Gildea, -Julien Gilles, David Gillespie, Bob Glickstein, Deepak Goel, Boris -Goldowsky, Michelangelo Grigni, Odd Gripenstam, Kai Großjohann, -Michael Gschwind, Bastien Guerry, Henry Guillaume, Doug Gwyn, Ken'ichi -Handa, Lars Hansen, Chris Hanson, K. Shane Hartman, John Heidemann, Jon -K.@: Hellan, Jesper Harder, Magnus Henoch, Markus Heritsch, Karl Heuer, -Manabu Higashida, Anders Holst, Jeffrey C.@: Honig, Tassilo Horn, Kurt -Hornik, Tom Houlder, Joakim Hove, Denis Howe, Lars Ingebrigtsen, Andrew -Innes, Seiichiro Inoue, Philip Jackson, Pavel Janik, Paul Jarc, Ulf -Jasper, Michael K. Johnson, Kyle Jones, Terry Jones, Simon Josefsson, -Arne Jørgensen, Tomoji Kagatani, Brewster Kahle, Tokuya Kameshima, -Lute Kamstra, David Kastrup, David Kaufman, Henry Kautz, Taichi -Kawabata, Howard Kaye, Michael Kifer, Richard King, Peter Kleiweg, Karel -Klí@v{c}, Shuhei Kobayashi, Pavel Kobiakov, Larry K.@: -Kolodney, David M.@: Koppelman, Koseki Yoshinori, Robert Krawitz, -Sebastian Kremer, Ryszard Kubiak, David Kågedal, Daniel LaLiberte, -Karl Landstrom, Mario Lang, Aaron Larson, James R.@: Larus, Vinicius -Jose Latorre, Werner Lemberg, Frederic Lepied, Peter Liljenberg, Lars -Lindberg, Chris Lindblad, Anders Lindgren, Thomas Link, Juri Linkov, -Francis Litterio, Emilio C. Lopes, Károly L@H{o}rentey, Dave Love, -Sascha Lüdecke, Eric Ludlam, Alan Mackenzie, Christopher J.@: -Madsen, Neil M.@: Mager, Ken Manheimer, Bill Mann, Brian Marick, Simon -Marshall, Bengt Martensson, Charlie Martin, Thomas May, Roland McGrath, -Will Mengarini, David Megginson, Ben A. Mesander, Wayne Mesard, Brad +Broadey, Vincent Broman, Michael Brouwer, David M.@: Brown, Stefan Bruda, +Georges Brun-Cottan, Joe Buehler, Scott Byer, W@l{}odek Bzyl, +Bill Carpenter, Per Cederqvist, Hans Chalupsky, Chris Chase, Bob +Chassell, Andrew Choi, Chong Yidong, Sacha Chua, Stewart Clamen, James +Clark, Mike Clarkson, Glynn Clements, Andrew Cohen, Daniel Colascione, +Edward O'Connor, Christoph Conrad, Ludovic Courtès, Andrew Csillag, +Toby Cubitt, Baoqiu Cui, Doug Cutting, Mathias Dahl, Julien Danjou, Satyaki +Das, Vivek Dasmohapatra, Dan Davison, Michael DeCorte, Gary Delp, Nachum +Dershowitz, Dave Detlefs, Matthieu Devin, Christophe de Dinechin, Eri +Ding, Jan Djärv, Lawrence R.@: Dodd, Carsten Dominik, Scott Draves, +Benjamin Drieu, Viktor Dukhovni, Jacques Duthen, Dmitry Dzhus, John +Eaton, Rolf Ebert, Carl Edman, David Edmondson, Paul Eggert, Stephen +Eglen, Christian Egli, Torbjörn Einarsson, Tsugutomo Enami, David +Engster, Hans Henrik Eriksen, Michael Ernst, Ata Etemadi, Frederick +Farnbach, Oscar Figueiredo, Fred Fish, Steve Fisk, Karl Fogel, Gary +Foster, Eric S.@: Fraga, Romain Francoise, Noah Friedman, Andreas +Fuchs, Shigeru Fukaya, Hallvard Furuseth, Keith Gabryelski, Peter S.@: +Galbraith, Kevin Gallagher, Kevin Gallo, Juan León Lahoz García, +Howard Gayle, Daniel German, Stephen Gildea, Julien Gilles, David +Gillespie, Bob Glickstein, Deepak Goel, David De La Harpe Golden, Boris +Goldowsky, David Goodger, Chris Gray, Kevin Greiner, Michelangelo Grigni, Odd +Gripenstam, Kai Großjohann, Michael Gschwind, Bastien Guerry, Henry +Guillaume, Doug Gwyn, Bruno Haible, Ken'ichi Handa, Lars Hansen, Chris +Hanson, Jesper Harder, Alexandru Harsanyi, K.@: Shane Hartman, John +Heidemann, Jon K.@: Hellan, Magnus Henoch, Markus Heritsch, Dirk +Herrmann, Karl Heuer, Manabu Higashida, Konrad Hinsen, Anders Holst, +Jeffrey C.@: Honig, Tassilo Horn, Kurt Hornik, Tom Houlder, Joakim +Hove, Denis Howe, Lars Ingebrigtsen, Andrew Innes, Seiichiro Inoue, +Philip Jackson, Martyn Jago, Pavel Janik, Paul Jarc, Ulf Jasper, +Thorsten Jolitz, Michael K.@: Johnson, Kyle Jones, Terry Jones, Simon +Josefsson, Alexandre Julliard, Arne Jørgensen, Tomoji Kagatani, +Brewster Kahle, Tokuya Kameshima, Lute Kamstra, Ivan Kanis, David +Kastrup, David Kaufman, Henry Kautz, Taichi Kawabata, Taro Kawagishi, +Howard Kaye, Michael Kifer, Richard King, Peter Kleiweg, Karel +Klí@v{c}, Shuhei Kobayashi, Pavel Kobyakov, Larry K.@: Kolodney, David +M.@: Koppelman, Koseki Yoshinori, Robert Krawitz, Sebastian Kremer, +Ryszard Kubiak, Igor Kuzmin, David Kågedal, Daniel LaLiberte, Karl +Landstrom, Mario Lang, Aaron Larson, James R.@: Larus, Vinicius Jose +Latorre, Werner Lemberg, Frederic Lepied, Peter Liljenberg, Christian +Limpach, Lars Lindberg, Chris Lindblad, Anders Lindgren, Thomas Link, +Juri Linkov, Francis Litterio, Sergey Litvinov, Emilio C.@: Lopes, +Martin Lorentzon, Dave Love, Eric Ludlam, Károly L@H{o}rentey, Sascha +Lüdecke, Greg McGary, Roland McGrath, Michael McNamara, Alan Mackenzie, +Christopher J.@: Madsen, Neil M.@: Mager, Ken Manheimer, Bill Mann, +Brian Marick, Simon Marshall, Bengt Martensson, Charlie Martin, +Yukihiro Matsumoto, David Maus, Thomas May, Will Mengarini, David +Megginson, Stefan Merten, Ben A.@: Mesander, Wayne Mesard, Brad Miller, Lawrence Mitchell, Richard Mlynarik, Gerd Moellmann, Stefan -Monnier, Morioka Tomohiko, Keith Moore, Jan Moringen, Glenn Morris, -Diane Murray, Sen Nagata, Erik Naggum, Thomas Neumann, Thien-Thi Nguyen, -Mike Newton, Jurgen Nickelsen, Dan Nicolaescu, Hrvoje Niksic, Jeff -Norden, Andrew Norman, Christian Ohler, Alexandre Oliva, Bob Olson, -Michael Olson, Takaaki Ota, Pieter E.@: J.@: Pareit, Ross Patterson, -David Pearson, Jeff Peck, Damon Anton Permezel, Tom Perrine, William -M.@: Perry, Per Persson, Jens Petersen, Daniel Pfeiffer, Richard L.@: -Pieri, Fred Pierresteguy, Christian Plaunt, David Ponce, Francesco A.@: -Potorti, Michael D. Prange, Mukesh Prasad, Ken Raeburn, Marko Rahamaa, -Ashwin Ram, Eric S. Raymond, Paul Reilly, Edward M. Reingold, Alex -Rezinsky, Rob Riepel, David Reitter, Adrian Robert, Nick Roberts, Roland -B.@: Roberts, John Robinson, Danny Roozendaal, Sebastian Rose, William -Rosenblatt, Guillermo J.@: Rozas, Martin Rudalics, Ivar Rummelhoff, -Jason Rumney, Wolfgang Rupprecht, Kevin Ryde, James B. Salem, Masahiko -Sato, Jorgen Schaefer, Holger Schauer, William Schelter, Ralph -Schleicher, Gregor Schmid, Michael Schmidt, Ronald S. Schnell, Philippe -Schnoebelen, Jan Schormann, Alex Schroeder, Stephen Schoef, Raymond -Scholz, Eric Schulte, Andreas Schwab, Randal Schwartz, Oliver Seidel, -Manuel Serrano, Paul Sexton, Hovav Shacham, Stanislav Shalunov, Marc -Shapiro, Richard Sharman, Olin Shivers, Espen Skoglund, Rick Sladkey, -Lynn Slater, Chris Smith, David Smith, Paul D.@: Smith, William -Sommerfeld, Andre Spiegel, Michael Staats, Ulf Stegemann, Reiner Steib, -Sam Steingold, Ake Stenhoff, Peter Stephenson, Ken Stevens, Andy Stewart, -Jonathan Stigelman, Martin Stjernholm, Kim F.@: Storm, Steve Strassmann, -Olaf Sylvester, Naoto Takahashi, Steven Tamm, Jean-Philippe Theberge, -Jens T.@: Berger Thielemann, Spencer Thomas, Jim Thompson, Luc -Teirlinck, David O'Toole, Tom Tromey, Enami Tsugutomo, Eli Tziperman, -Daiki Ueno, Masanobu Umeda, Rajesh Vaidheeswarran, Neil W.@: Van Dyke, -Didier Verna, Joakim Verona, Ulrik Vieth, Geoffrey Voelker, Johan -Vromans, Inge Wallin, John Paul Wallington, Colin Walters, Barry Warsaw, -Morten Welinder, Joseph Brian Wells, Rodney Whitby, John Wiegley, Ed -Wilkinson, Mike Williams, Bill Wohler, Steven A. Wood, Dale R.@: Worley, -Francis J.@: Wright, Felix S. T. Wu, Tom Wurgler, Katsumi Yamaoka, -Yamamoto Mitsuharu, Masatake Yamato, Jonathan Yavner, Ryan Yeske, Ilya -Zakharevich, Milan Zamazal, Victor Zandy, Eli Zaretskii, Jamie Zawinski, +Monnier, Keith Moore, Jan Moringen, Morioka Tomohiko, Glenn Morris, +Don Morrison, Diane Murray, Riccardo Murri, Sen Nagata, Erik Naggum, +Gergely Nagy, Nobuyoshi Nakada, Thomas Neumann, Mike Newton, Thien-Thi Nguyen, +Jurgen Nickelsen, Dan Nicolaescu, Hrvoje Niksic, Jeff Norden, +Andrew Norman, Kentaro Ohkouchi, Christian Ohler, +Kenichi Okada, Alexandre Oliva, Bob Olson, Michael Olson, Takaaki Ota, +Pieter E.@: J.@: Pareit, Ross Patterson, David Pearson, Juan Pechiar, +Jeff Peck, Damon Anton Permezel, Tom Perrine, William M.@: Perry, Per +Persson, Jens Petersen, Daniel Pfeiffer, Justus Piater, Richard L.@: +Pieri, Fred Pierresteguy, François Pinard, Daniel Pittman, Christian +Plaunt, Alexander Pohoyda, David Ponce, Francesco A.@: Potorti, +Michael D.@: Prange, Mukesh Prasad, Ken Raeburn, Marko Rahamaa, Ashwin +Ram, Eric S.@: Raymond, Paul Reilly, Edward M.@: Reingold, David +Reitter, Alex Rezinsky, Rob Riepel, Lara Rios, Adrian Robert, Nick +Roberts, Roland B.@: Roberts, John Robinson, Denis B.@: Roegel, Danny +Roozendaal, Sebastian Rose, William Rosenblatt, Markus Rost, Guillermo +J.@: Rozas, Martin Rudalics, Ivar Rummelhoff, Jason Rumney, Wolfgang +Rupprecht, Benjamin Rutt, Kevin Ryde, James B.@: Salem, Masahiko Sato, +Timo Savola, Jorgen Schaefer, Holger Schauer, William Schelter, Ralph +Schleicher, Gregor Schmid, Michael Schmidt, Ronald S.@: Schnell, +Philippe Schnoebelen, Jan Schormann, Alex Schroeder, Stefan Schoef, +Rainer Schoepf, Raymond Scholz, Eric Schulte, Andreas Schwab, Randal +Schwartz, Oliver Seidel, Manuel Serrano, Paul Sexton, Hovav Shacham, +Stanislav Shalunov, Marc Shapiro, Richard Sharman, Olin Shivers, Tibor +@v{S}imko, Espen Skoglund, Rick Sladkey, Lynn Slater, Chris Smith, +David Smith, Paul D.@: Smith, Wilson Snyder, William Sommerfeld, Simon +South, Andre Spiegel, Michael Staats, Thomas Steffen, Ulf Stegemann, +Reiner Steib, Sam Steingold, Ake Stenhoff, Peter Stephenson, Ken +Stevens, Andy Stewart, Jonathan Stigelman, Martin Stjernholm, Kim F.@: +Storm, Steve Strassmann, Christopher Suckling, Olaf Sylvester, Naoto +Takahashi, Steven Tamm, Luc Teirlinck, Jean-Philippe Theberge, Jens +T.@: Berger Thielemann, Spencer Thomas, Jim Thompson, Toru Tomabechi, +David O'Toole, Markus Triska, Tom Tromey, Enami Tsugutomo, Eli +Tziperman, Daiki Ueno, Masanobu Umeda, Rajesh Vaidheeswarran, Neil +W.@: Van Dyke, Didier Verna, Joakim Verona, Ulrik Vieth, Geoffrey +Voelker, Johan Vromans, Inge Wallin, John Paul Wallington, Colin +Walters, Barry Warsaw, Christoph Wedler, Ilja Weis, Zhang Weize, +Morten Welinder, Joseph Brian Wells, Rodney Whitby, John Wiegley, +Sascha Wilde, Ed Wilkinson, Mike Williams, Roland Winkler, Bill +Wohler, Steven A.@: Wood, Dale R.@: Worley, Francis J.@: Wright, Felix +S.@: T.@: Wu, Tom Wurgler, Yamamoto Mitsuharu, Katsumi Yamaoka, +Masatake Yamato, Jonathan Yavner, Ryan Yeske, Ilya Zakharevich, Milan +Zamazal, Victor Zandy, Eli Zaretskii, Jamie Zawinski, Andrew Zhilin, Shenghuo Zhu, Piotr Zielinski, Ian T.@: Zimmermann, Reto Zimmermann, Neal Ziring, Teodor Zlatanov, and Detlev Zundel. @end iftex diff --git a/doc/emacs/emerge-xtra.texi b/doc/emacs/emerge-xtra.texi index d9f0b4a2741..72e0b36b704 100644 --- a/doc/emacs/emerge-xtra.texi +++ b/doc/emacs/emerge-xtra.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2004-2012 Free Software Foundation, Inc. +@c Copyright (C) 2004-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -19,7 +19,7 @@ easier. For other ways to compare files, see @ifnottex @ref{Comparing Files}, @end ifnottex -and @ref{Top, Ediff,, ediff, The Ediff Manual}. +and @ref{Top,, Ediff, ediff, The Ediff Manual}. @menu * Overview of Emerge:: How to start Emerge. Basic concepts. @@ -155,13 +155,13 @@ which neither version is presumed ``correct.'' The mode line indicates Skip Prefers mode with @samp{S}. This mode is only relevant when there is an ancestor. -@findex emerge-auto-advance-mode -@findex emerge-skip-prefers-mode - Use the command @kbd{s a} (@code{emerge-auto-advance-mode}) to set or -clear Auto Advance mode. Use @kbd{s s} -(@code{emerge-skip-prefers-mode}) to set or clear Skip Prefers mode. -These commands turn on the mode with a positive argument, turn it off -with a negative or zero argument, and toggle the mode with no argument. +@findex emerge-auto-advance +@findex emerge-skip-prefers + Use the command @kbd{s a} (@code{emerge-auto-advance}) to set or clear +Auto Advance mode. Use @kbd{s s} (@code{emerge-skip-prefers}) to set or +clear Skip Prefers mode. These commands turn on the mode with a +positive argument, turn it off with a negative or zero argument, and +toggle the mode with no argument. @node State of Difference @subsection State of a Difference @@ -362,9 +362,9 @@ like this: @example @group #ifdef NEW -@var{version from A buffer} -#else /* not NEW */ @var{version from B buffer} +#else /* not NEW */ +@var{version from A buffer} #endif /* not NEW */ @end group @end example @@ -380,7 +380,7 @@ produces the results shown above, looks like this: @example @group -"#ifdef NEW\n%a#else /* not NEW */\n%b#endif /* not NEW */\n" +"#ifdef NEW\n%b#else /* not NEW */\n%a#endif /* not NEW */\n" @end group @end example diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index b34b96126ad..3adc735154b 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -36,7 +36,7 @@ on file directories. * Misc File Ops:: Other things you can do on files. * Compressed Files:: Accessing compressed files. * File Archives:: Operating on tar, zip, jar etc. archive files. -* Remote Files:: Accessing files on other sites. +* Remote Files:: Accessing files on other machines. * Quoted File Names:: Quoting special characters in file names. * File Name Cache:: Completion against a list of files you often use. * File Conveniences:: Convenience Features for Finding Files. diff --git a/doc/emacs/fortran-xtra.texi b/doc/emacs/fortran-xtra.texi index 5fc20fae8a3..0dc99034ae6 100644 --- a/doc/emacs/fortran-xtra.texi +++ b/doc/emacs/fortran-xtra.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2004-2012 Free Software Foundation, Inc. +@c Copyright (C) 2004-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -70,11 +70,10 @@ command runs the hook @code{fortran-mode-hook}. @subsection Motion Commands In addition to the normal commands for moving by and operating on -``defuns'' (Fortran subprograms---functions and subroutines, using the -commands @code{fortran-beginning-of-subprogram} and -@code{fortran-end-of-subprogram}; as well as modules for F90 mode), -Fortran mode provides special commands to move by statements and other -program units. +``defuns'' (Fortran subprograms---functions and subroutines, as well +as modules for F90 mode, using the commands @code{fortran-end-of-subprogram} +and @code{fortran-beginning-of-subprogram}), Fortran mode provides +special commands to move by statements and other program units. @table @kbd @kindex C-c C-n @r{(Fortran mode)} @@ -97,16 +96,15 @@ statement in the buffer), move to the start of the buffer. @findex f90-next-block @item C-c C-e Move point forward to the start of the next code block, or the end of -the current block, whichever is encountered first. -(@code{f90-next-block}). A code block is a subroutine, -@code{if}--@code{endif} statement, and so forth. This command exists -for F90 mode only, not Fortran mode. With a numeric argument, this -moves forward that many blocks. +the current one, whichever comes first (@code{f90-next-block}). +A code block is a subroutine, @code{if}--@code{endif} statement, and +so forth. This command exists for F90 mode only, not Fortran mode. +With a numeric argument, it moves forward that many blocks. @kindex C-c C-a @r{(F90 mode)} @findex f90-previous-block @item C-c C-a -Move point backward to the previous code block +Move point backward to the previous block (@code{f90-previous-block}). This is like @code{f90-next-block}, but moves backwards. @@ -163,7 +161,7 @@ Break the current line at point and set up a continuation line @item M-^ Join this line to the previous line (@code{fortran-join-line}). @item C-M-q -Indent all the lines of the subprogram point is in +Indent all the lines of the subprogram that point is in (@code{fortran-indent-subprogram}). @item M-q Fill a comment block or statement (using @code{fortran-fill-paragraph} @@ -239,17 +237,17 @@ to the continuation style. The setting of continuation style affects several other aspects of editing in Fortran mode. In fixed form mode, the minimum column number for the body of a statement is 6. Lines inside of Fortran -blocks that are indented to larger column numbers always use only the +blocks that are indented to larger column numbers must use only the space character for whitespace. In tab format mode, the minimum column number for the statement body is 8, and the whitespace before -column 8 must always consist of one tab character. +column 8 must consist of one tab character. @node ForIndent Num @subsubsection Line Numbers If a number is the first non-whitespace in the line, Fortran indentation assumes it is a line number and moves it to columns 0 -through 4. (Columns always count from 0 in GNU Emacs.) +through 4. (Columns always count from 0 in Emacs.) @vindex fortran-line-number-indent Line numbers of four digits or less are normally indented one space. @@ -329,7 +327,7 @@ non-@code{nil} value, indenting any numbered statement must check for a @samp{do} that ends there. If you always end @samp{do} statements with a @samp{continue} line (or if you use the more modern @samp{enddo}), then you can speed up indentation by setting this variable to -@code{nil}. The default is @code{nil}. +@code{nil} (the default). @item fortran-blink-matching-if If this is @code{t}, indenting an @samp{endif} (or @samp{enddo} @@ -338,17 +336,17 @@ statement moves the cursor momentarily to the matching @samp{if} (or @item fortran-minimum-statement-indent-fixed Minimum indentation for Fortran statements when using fixed form -continuation line style. Statement bodies are never indented less than -this much. The default is 6. +continuation line style. Statement bodies are never indented by less than +this. The default is 6. @item fortran-minimum-statement-indent-tab Minimum indentation for Fortran statements for tab format continuation line -style. Statement bodies are never indented less than this much. The +style. Statement bodies are never indented by less than this. The default is 8. @end table -The variables controlling the indentation of comments are described in -the following section. +The following section describes the variables controlling the +indentation of comments. @node Fortran Comments @subsection Fortran Comments @@ -364,7 +362,7 @@ comments start with @samp{!} and can follow other text. Because only some Fortran 77 compilers accept this syntax, Fortran mode will not insert such comments unless you have said in advance to do so. To do this, set the variable @code{fortran-comment-line-start} to @samp{"!"}. -If you use an unusual value, you may also need to adjust +If you use an unusual value, you may need to change @code{fortran-comment-line-start-skip}. @@ -373,7 +371,7 @@ If you use an unusual value, you may also need to adjust Align comment or insert new comment (@code{comment-dwim}). @item C-x ; -Applies to nonstandard @samp{!} comments only. +Applies to nonstandard @samp{!} comments only (@code{comment-set-column}). @item C-c ; Turn all lines of the region into comments, or (with argument) turn them back @@ -406,10 +404,10 @@ Align the text at a fixed column, which is the sum of @code{fortran-comment-line-extra-indent} and the minimum statement indentation. This is the default. -The minimum statement indentation is -@code{fortran-minimum-statement-indent-fixed} for fixed form -continuation line style and @code{fortran-minimum-statement-indent-tab} -for tab format style. +The minimum indentation is +@code{fortran-minimum-statement-indent-tab} for tab format +continuation line style and @code{fortran-minimum-statement-indent-fixed} +for fixed form style. @item relative Align the text as if it were a line of code, but with an additional @@ -434,17 +432,17 @@ never be indented at all, no matter what the value of lines are directives. Matching lines are never indented, and receive distinctive font-locking. - The normal Emacs comment command @kbd{C-x ;} has not been redefined. If -you use @samp{!} comments, this command can be used with them. Otherwise -it is useless in Fortran mode. + The normal Emacs comment command @kbd{C-x ;} (@code{comment-set-column}) +has not been redefined. If you use @samp{!} comments, this command +can be used with them. Otherwise it is useless in Fortran mode. @kindex C-c ; @r{(Fortran mode)} @findex fortran-comment-region @vindex fortran-comment-region The command @kbd{C-c ;} (@code{fortran-comment-region}) turns all the -lines of the region into comments by inserting the string @samp{C$$$} at +lines of the region into comments by inserting the string @samp{c$$$} at the front of each one. With a numeric argument, it turns the region -back into live code by deleting @samp{C$$$} from the front of each line +back into live code by deleting @samp{c$$$} from the front of each line in it. The string used for these comments can be controlled by setting the variable @code{fortran-comment-region}. Note that here we have an example of a command and a variable with the same name; these two uses @@ -507,8 +505,7 @@ Display a ``column ruler'' momentarily above the current line Split the current window horizontally temporarily so that it is @code{fortran-line-length} columns wide (@code{fortran-window-create-momentarily}). This may help you avoid -making lines longer than the character limit imposed by your Fortran -compiler. +making lines longer than the limit imposed by your Fortran compiler. @item C-u C-c C-w Split the current window horizontally so that it is @code{fortran-line-length} columns wide (@code{fortran-window-create}). diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 38ee620dbd5..4cfaffdadb8 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -52,7 +52,7 @@ for doing so on MS-DOS). * Frame Commands:: Iconifying, deleting, and switching frames. * Fonts:: Changing the frame font. * Speedbar:: How to make and use a speedbar frame. -* Multiple Displays:: How one Emacs job can talk to several displays. +* Multiple Displays:: How one Emacs instance can talk to several displays. * Frame Parameters:: Changing the colors and other modes of frames. * Scroll Bars:: How to enable and disable scroll bars; how to use them. * Drag and Drop:: Using drag and drop to open files and insert text. diff --git a/doc/emacs/kmacro.texi b/doc/emacs/kmacro.texi index a767a312ed3..766470e514b 100644 --- a/doc/emacs/kmacro.texi +++ b/doc/emacs/kmacro.texi @@ -35,8 +35,10 @@ intelligent or general. For such things, Lisp must be used. * Basic Keyboard Macro:: Defining and running keyboard macros. * Keyboard Macro Ring:: Where previous keyboard macros are saved. * Keyboard Macro Counter:: Inserting incrementing numbers in macros. -* Keyboard Macro Query:: Making keyboard macros do different things each time. -* Save Keyboard Macro:: Giving keyboard macros names; saving them in files. +* Keyboard Macro Query:: Making keyboard macros do different things each + time. +* Save Keyboard Macro:: Giving keyboard macros names; saving them in + files. * Edit Keyboard Macro:: Editing keyboard macros. * Keyboard Macro Step-Edit:: Interactively executing and editing a keyboard macro. diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi index e6d936e8e9f..fb70a462bd1 100644 --- a/doc/emacs/macos.texi +++ b/doc/emacs/macos.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2000-2012 Free Software Foundation, Inc. +@c Copyright (C) 2000-2012 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node Mac OS / GNUstep, Microsoft Windows, Antinews, Top @appendix Emacs and Mac OS / GNUstep @@ -11,8 +11,8 @@ the GNUstep libraries on GNU/Linux or other operating systems, or on Mac OS X with native window system support. On Mac OS X, Emacs can be built either without window system support, with X11, or with the -Cocoa interface; this section only applies to the Cocoa build. Emacs -does not support earlier versions of Mac OS. +Cocoa interface; this section only applies to the Cocoa build. This +does not support versions of Mac OS X earlier than 10.4. For various historical and technical reasons, Emacs uses the term @samp{Nextstep} internally, instead of ``Cocoa'' or ``Mac OS X''; for @@ -21,7 +21,7 @@ begin with @samp{ns-}, which is short for @samp{Nextstep}. NeXTstep was an application interface released by NeXT Inc during the 1980s, of which Cocoa is a direct descendant. Apart from Cocoa, there is another NeXTstep-style system: GNUstep, which is free software. As of -this writing, the GNUstep support is alpha status (@pxref{GNUstep +this writing, Emacs GNUstep support is alpha status (@pxref{GNUstep Support}), but we hope to improve it in the future. @menu @@ -40,6 +40,7 @@ Emacs provides a set of key bindings using this modifier key that mimic other Mac / GNUstep applications (@pxref{Mac / GNUstep Events}). You can change these bindings in the usual way (@pxref{Key Bindings}). +@c FIXME mention ns-alternate-modifier? The variable @code{ns-right-alternate-modifier} controls the behavior of the right @key{alt} and @key{option} keys. These keys behave like the left-hand keys if the value is @code{left} (the @@ -47,30 +48,22 @@ default). A value of @code{control}, @code{meta}, @code{alt}, @code{super}, or @code{hyper} makes them behave like the corresponding modifier keys; a value of @code{none} tells Emacs to ignore them. - The standard Mac / GNUstep font and color panels are accessible via -Lisp commands. To use the color panel, drag from it to an Emacs frame -to change the foreground color of the face at that position (if the -@key{shift} key is held down, it changes the background color -instead). To discard the settings, create a new frame and close the -altered one. - - @key{S-Mouse-1} (i.e., clicking the left mouse button while holding -down the @key{Shift} key) adjusts the region to the click position, -just like @key{Mouse-3} (@code{mouse-save-then-kill}); it does not pop -up a menu for changing the default face, as @key{S-Mouse-1} normally + @kbd{S-Mouse-1} adjusts the region to the click position, +just like @kbd{Mouse-3} (@code{mouse-save-then-kill}); it does not pop +up a menu for changing the default face, as @kbd{S-Mouse-1} normally does (@pxref{Text Scale}). This change makes Emacs behave more like other Mac / GNUstep applications. When you open or save files using the menus, or using the -@key{Cmd-o} and @key{Cmd-S} bindings, Emacs uses graphical file +@kbd{Cmd-o} and @kbd{Cmd-S} bindings, Emacs uses graphical file dialogs to read file names. However, if you use the regular Emacs key -sequences, such as @key{C-x C-f}, Emacs uses the minibuffer to read +sequences, such as @kbd{C-x C-f}, Emacs uses the minibuffer to read file names. - On GNUstep, in an X-windows environment you need to use @key{Cmd-c} -instead of one of the @key{C-w} or @key{M-w} commands to transfer text + On GNUstep, in an X-windows environment you need to use @kbd{Cmd-c} +instead of one of the @kbd{C-w} or @kbd{M-w} commands to transfer text to the X primary selection; otherwise, Emacs will use the -``clipboard'' selection. Likewise, @key{Cmd-y} (instead of @key{C-y}) +``clipboard'' selection. Likewise, @kbd{Cmd-y} (instead of @kbd{C-y}) yanks from the X primary selection instead of the kill-ring or clipboard. @@ -100,23 +93,25 @@ customization buffers and the Options menu. @subsection Font and Color Panels -The Font Panel may be accessed with M-x ns-popup-font-panel. It -will set the default font in the frame most recently used or clicked -on. +The standard Mac / GNUstep font and color panels are accessible via +Lisp commands. The Font Panel may be accessed with @kbd{M-x +ns-popup-font-panel}. It will set the default font in the frame most +recently used or clicked on. @c To make the setting permanent, use @samp{Save Options} in the @c Options menu, or run @code{menu-bar-options-save}. -You can bring up a color panel with M-x ns-popup-color-panel. and -drag the color you want over the emacs face you want to change. Normal +You can bring up a color panel with @kbd{M-x ns-popup-color-panel} and +drag the color you want over the Emacs face you want to change. Normal dragging will alter the foreground color. Shift dragging will alter the -background color. +background color. To discard the settings, create a new frame and +close the altered one. @c To make the changes permanent select the "Save Options" @c item in the "Options" menu, or run @code{menu-bar-options-save}. -Useful in this context is the listing of all faces obtained by @key{M-x} -@code{list-faces-display}. +Useful in this context is the listing of all faces obtained by +@kbd{M-x list-faces-display}. @subsection Open files by dragging to an Emacs window @@ -137,7 +132,7 @@ The following customization options are specific to the Nextstep port. @table @code @item ns-auto-hide-menu-bar Non-nil means the menu-bar is hidden by default, but appears if you -move the mouse pointer over it. (Requires OS X 10.6 or later.) +move the mouse pointer over it. (Requires Mac OS X 10.6 or later.) @end table @@ -162,9 +157,9 @@ that frame (@code{ns-find-file}). As an exception, if the selected buffer is the @samp{*scratch*} buffer, Emacs visits the file in the selected frame. -You can change how Emacs responds to @key{ns-open-file} by changing -the variable @code{ns-pop-up-frames}. Its default value, -@code{'fresh}, is what we have just described. A value of @code{t} +You can change how Emacs responds to a @code{ns-open-file} event by +changing the variable @code{ns-pop-up-frames}. Its default value, +@samp{fresh}, is what we have just described. A value of @code{t} means to always visit the file in a new frame. A value of @code{nil} means to always visit the file in an existing frame. @@ -211,7 +206,7 @@ The default behavior is to save all file-visiting buffers. Emacs also allows users to make use of Nextstep services, via a set of commands whose names begin with @samp{ns-service-} and end with the -name of the service. Type @kbd{M-x ns-service-@key{TAB}@key{TAB}} to +name of the service. Type @kbd{M-x ns-service-@key{TAB}} to see a list of these commands. These functions either operate on marked text (replacing it with the result) or take a string argument and return the result as a string. You can also use the Lisp function @@ -222,6 +217,6 @@ restart Emacs to access newly-available services. @node GNUstep Support, , Mac / GNUstep Events, Mac OS / GNUstep @section GNUstep Support -Emacs can be built and run under GNUstep, but there are still some +Emacs can be built and run under GNUstep, but there are still issues to be addressed. Interested developers should contact @email{emacs-devel@@gnu.org}. diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index d2f92bf0da5..e812c9112df 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi @@ -725,7 +725,7 @@ call this command from a Dired buffer (@pxref{Dired}). @ifnottex @item M-x vc-ediff -Like @kbd{C-x v =}, but using Ediff. @xref{Top, Ediff, ediff, The +Like @kbd{C-x v =}, but using Ediff. @xref{Top,, Ediff, ediff, The Ediff Manual}. @end ifnottex @@ -777,7 +777,7 @@ current VC fileset. @ifnottex @findex vc-ediff @kbd{M-x vc-ediff} works like @kbd{C-x v =}, except that it uses an -Ediff session. @xref{Top, Ediff, ediff, The Ediff Manual}. +Ediff session. @xref{Top,, Ediff, ediff, The Ediff Manual}. @end ifnottex @findex vc-root-diff diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index ca8e8f705b4..e20d5a347cd 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -58,11 +58,11 @@ some initial text ending in a slash. This is the @dfn{default directory}. For example, it may start out like this: @example -Find File: /u2/emacs/src/ +Find file: /u2/emacs/src/ @end example @noindent -Here, @samp{Find File:@: } is the prompt and @samp{/u2/emacs/src/} is +Here, @samp{Find file:@: } is the prompt and @samp{/u2/emacs/src/} is the default directory. If you now type @kbd{buffer.c} as input, that specifies the file @file{/u2/emacs/src/buffer.c}. @xref{File Names}, for information about the default directory. @@ -79,7 +79,7 @@ name starting with a slash or a tilde after the default directory. For example, you can specify @file{/etc/termcap} as follows: @example -Find File: /u2/emacs/src//etc/termcap +Find file: /u2/emacs/src//etc/termcap @end example @noindent @@ -247,7 +247,10 @@ completion. completion alternatives (in this case, command names) that start with @samp{au}. There are several, including @code{auto-fill-mode} and @code{autoconf-mode}, but they all begin with @code{auto}, so the -@samp{au} in the minibuffer completes to @samp{auto}. +@samp{au} in the minibuffer completes to @samp{auto}. (More commands +may be defined in your Emacs session. For example, if a command +called @code{authorize-me} was defined, Emacs could only complete +as far as @samp{aut}.) If you type @key{TAB} again immediately, it cannot determine the next character; it could be @samp{-}, @samp{a}, or @samp{c}. So it @@ -385,7 +388,7 @@ it just submits the argument as you have entered it. @item @dfn{Permissive completion with confirmation} is like permissive completion, with an exception: if you typed @key{TAB} and this -completed the text up to some intermediate state (i.e. one that is not +completed the text up to some intermediate state (i.e., one that is not yet an exact completion match), typing @key{RET} right afterward does not submit the argument. Instead, Emacs asks for confirmation by momentarily displaying @samp{[Confirm]} after the text; type @key{RET} @@ -450,8 +453,7 @@ position in the completion alternative. @item emacs22 This completion style is similar to @code{basic}, except that it ignores the text in the minibuffer after point. It is so-named -because it corresponds to the completion behavior in Emacs 22 and -earlier. +because it corresponds to the completion behavior in Emacs 22. @end table @noindent @@ -476,6 +478,18 @@ and initialisms. For example, when completing command names, it matches @samp{lch} to @samp{list-command-history}. @end table +@noindent +There is also a very simple completion style called @code{emacs21}. +In this style, if the text in the minibuffer is @samp{foobar}, +only matches starting with @samp{foobar} are considered. + +@vindex completion-category-overrides +You can use different completion styles in different situations, +by setting the variable @code{completion-category-overrides}. +For example, the default setting says to use only @code{basic} +and @code{substring} completion for buffer names. + + @node Completion Options @subsection Completion Options @@ -521,7 +535,7 @@ commands never display the completion list buffer; you must type @kbd{?} to display the list. If the value is @code{lazy}, Emacs only shows the completion list buffer on the second attempt to complete. In other words, if there is nothing to complete, the first @key{TAB} -echoes @samp{Next char not unique}; the second @key{TAB} does the +echoes @samp{Next char not unique}; the second @key{TAB} shows the completion list buffer. @vindex completion-cycle-threshold @@ -688,7 +702,7 @@ value. @xref{Incremental Search}. @vindex command-history The list of previous minibuffer-using commands is stored as a Lisp list in the variable @code{command-history}. Each element is a Lisp -expression which describes one command and its arguments. Lisp programs +expression that describes one command and its arguments. Lisp programs can re-execute a command by calling @code{eval} with the @code{command-history} element. diff --git a/doc/emacs/msdog-xtra.texi b/doc/emacs/msdog-xtra.texi index dc50b3d248f..509b9de754d 100644 --- a/doc/emacs/msdog-xtra.texi +++ b/doc/emacs/msdog-xtra.texi @@ -199,10 +199,10 @@ of Emacs packages that use fonts (such as @code{font-lock}, Enriched Text mode, and others) by defining the relevant faces to use different colors. Use the @code{list-colors-display} command @iftex -(@pxref{Frame Parameters,,,emacs, the Emacs Manual}) +(@pxref{Colors,,,emacs, the Emacs Manual}) @end iftex @ifnottex -(@pxref{Frame Parameters}) +(@pxref{Colors}) @end ifnottex and the @code{list-faces-display} command @iftex @@ -260,10 +260,10 @@ visible frame smaller than the full screen, but Emacs still cannot display more than a single frame at a time. @cindex frame size under MS-DOS -@findex mode4350 -@findex mode25 - The @code{mode4350} command switches the display to 43 or 50 -lines, depending on your hardware; the @code{mode25} command switches +@findex dos-mode4350 +@findex dos-mode25 + The @code{dos-mode4350} command switches the display to 43 or 50 +lines, depending on your hardware; the @code{dos-mode25} command switches to the default 80x25 screen size. By default, Emacs only knows how to set screen sizes of 80 columns by @@ -394,7 +394,7 @@ different default values on MS-DOS. for details about setting up printing to a networked printer. Some printers expect DOS codepage encoding of non-@acronym{ASCII} text, even -though they are connected to a Windows machine which uses a different +though they are connected to a Windows machine that uses a different encoding for the same locale. For example, in the Latin-1 locale, DOS uses codepage 850 whereas Windows uses codepage 1252. @xref{MS-DOS and MULE}. When you print to such printers from Windows, you can use the @@ -483,7 +483,7 @@ appropriate terminal coding system that is supported by the codepage. The special features described in the rest of this section mostly pertain to codepages that encode ISO 8859 character sets. - For the codepages which correspond to one of the ISO character sets, + For the codepages that correspond to one of the ISO character sets, Emacs knows the character set based on the codepage number. Emacs automatically creates a coding system to support reading and writing files that use the current codepage, and uses this coding system by @@ -607,9 +607,14 @@ MS-DOS with some network redirector. @cindex directory listing on MS-DOS @vindex dired-listing-switches @r{(MS-DOS)} - Dired on MS-DOS uses the @code{ls-lisp} package where other -platforms use the system @code{ls} command. Therefore, Dired on -MS-DOS supports only some of the possible options you can mention in -the @code{dired-listing-switches} variable. The options that work are -@samp{-A}, @samp{-a}, @samp{-c}, @samp{-i}, @samp{-r}, @samp{-S}, -@samp{-s}, @samp{-t}, and @samp{-u}. + Dired on MS-DOS uses the @code{ls-lisp} package +@iftex +(@pxref{ls in Lisp,,,emacs, the Emacs Manual}). +@end iftex +@ifnottex +(@pxref{ls in Lisp}). +@end ifnottex +Therefore, Dired on MS-DOS supports only some of the possible options +you can mention in the @code{dired-listing-switches} variable. The +options that work are @samp{-A}, @samp{-a}, @samp{-c}, @samp{-i}, +@samp{-r}, @samp{-S}, @samp{-s}, @samp{-t}, and @samp{-u}. diff --git a/doc/emacs/msdog.texi b/doc/emacs/msdog.texi index d31906d9b04..93bc5f0e4b1 100644 --- a/doc/emacs/msdog.texi +++ b/doc/emacs/msdog.texi @@ -40,7 +40,7 @@ here. * Windows Fonts:: Specifying fonts on MS-Windows. * Windows Misc:: Miscellaneous Windows features. @ifnottex -* MS-DOS:: Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}). +* MS-DOS:: Using Emacs on MS-DOS. @end ifnottex @end menu @@ -159,7 +159,8 @@ save a buffer in a specified EOL format with the @kbd{C-x @key{RET} f} command. For example, to save a buffer with Unix EOL format, type @kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you visit a file with DOS EOL conversion, then save it with Unix EOL format, that -effectively converts the file to Unix EOL style, like @code{dos2unix}. +effectively converts the file to Unix EOL style, like the +@code{dos2unix} program. @cindex untranslated file system @findex add-untranslated-filesystem @@ -221,7 +222,7 @@ for files which are known to be Windows-style text files with carriage-return linefeed EOL format, such as @file{CONFIG.SYS}; Emacs always writes those files with Windows-style EOLs. - If a file which belongs to an untranslated file system matches one of + If a file that belongs to an untranslated file system matches one of the file-name patterns in @code{file-name-buffer-file-type-alist}, the EOL conversion is determined by @code{file-name-buffer-file-type-alist}. @@ -263,8 +264,8 @@ FAT32, and XFAT volumes. @cindex Dired, and MS-Windows/MS-DOS @cindex @code{ls} emulation - Dired normally uses the external program @code{ls} (or its close -work-alike) to produce the directory listing displayed in Dired + Dired normally uses the external program @code{ls} +to produce the directory listing displayed in Dired buffers (@pxref{Dired}). However, MS-Windows and MS-DOS systems don't come with such a program, although several ports of @sc{gnu} @code{ls} are available. Therefore, Emacs on those systems @emph{emulates} @@ -281,8 +282,8 @@ they are described in this section. The @code{ls} emulation supports many of the @code{ls} switches, but it doesn't support all of them. Here's the list of the switches it does support: @option{-A}, @option{-a}, @option{-B}, @option{-C}, -@option{-c}, @option{-i}, @option{-G}, @option{-g}, @option{-R}, -@option{-r}, @option{-S}, @option{-s}, @option{-t}, @option{-U}, +@option{-c}, @option{-G}, @option{-g}, @option{-h}, @option{-i}, @option{-n}, +@option{-R}, @option{-r}, @option{-S}, @option{-s}, @option{-t}, @option{-U}, @option{-u}, and @option{-X}. The @option{-F} switch is partially supported (it appends the character that classifies the file, but does not prevent symlink following). @@ -413,9 +414,9 @@ value of @code{HOME}. You can override this default value of @code{HOME} by explicitly setting the environment variable @env{HOME} to point to any directory on your system. @env{HOME} can be set either from the command shell -prompt or from the @samp{My Computer}s @samp{Properties} dialog. -@code{HOME} can also be set in the system registry, for details see -@ref{MS-Windows Registry}. +prompt or from @samp{Properties} dialog of @samp{My Computer}. +@code{HOME} can also be set in the system registry, +@pxref{MS-Windows Registry}. For compatibility with older versions of Emacs@footnote{ Older versions of Emacs didn't check the application data directory. @@ -431,9 +432,9 @@ deprecated. Whatever the final place is, Emacs sets the internal value of the @env{HOME} environment variable to point to it, and it will use that location for other files and directories it normally looks for or -creates in the user's home directory. +creates in your home directory. - You can always find out where Emacs thinks is your home directory's + You can always find out what Emacs thinks is your home directory's location by typing @kbd{C-x d ~/ @key{RET}}. This should present the list of files in the home directory, and show its full name on the first line. Likewise, to visit your init file, type @kbd{C-x C-f @@ -510,7 +511,7 @@ otherwise it returns @code{nil}. @cindex @kbd{M-@key{TAB}} vs @kbd{Alt-@key{TAB}} (MS-Windows) @cindex @kbd{Alt-@key{TAB}} vs @kbd{M-@key{TAB}} (MS-Windows) For example, @code{(w32-register-hot-key [M-tab])} lets you use -@kbd{M-TAB} normally in Emacs, for instance, to complete the word or +@kbd{M-TAB} normally in Emacs; for instance, to complete the word or symbol at point at top level, or to complete the current search string against previously sought strings during incremental search. @@ -589,7 +590,7 @@ of these variables. Passing each of these keys to Windows produces its normal effect: for example, @kbd{@key{Lwindow}} opens the @code{Start} menu, etc.@footnote{ Some combinations of the ``Windows'' keys with other keys are caught -by Windows at low level in a way that Emacs currently cannot prevent. +by Windows at a low level in a way that Emacs currently cannot prevent. For example, @kbd{@key{Lwindow} r} always pops up the Windows @samp{Run} dialog. Customizing the value of @code{w32-phantom-key-code} might help in some cases, though.} @@ -612,7 +613,7 @@ modifiers. @cindex mouse, and MS-Windows This section describes the Windows-specific variables related to -mouse. +the mouse. @vindex w32-mouse-button-tolerance @cindex simulation of middle mouse button @@ -689,8 +690,8 @@ to do its job. @vindex w32-quote-process-args The variable @code{w32-quote-process-args} controls how Emacs quotes the process arguments. Non-@code{nil} means quote with the @code{"} -character. If the value is a character, use that character to escape -any quote characters that appear; otherwise chose a suitable escape +character. If the value is a character, Emacs uses that character to escape +any quote characters that appear; otherwise it chooses a suitable escape character based on the type of the program. @ifnottex @@ -723,7 +724,7 @@ tell Emacs which printer to use. If you want to use your local printer, then set the Lisp variable @code{lpr-command} to @code{""} (its default value on Windows) and @code{printer-name} to the name of the printer port---for example, -@code{"PRN"}, the usual local printer port or @code{"LPT2"}, or +@code{"PRN"}, the usual local printer port, or @code{"LPT2"}, or @code{"COM1"} for a serial printer. You can also set @code{printer-name} to a file name, in which case ``printed'' output is actually appended to that file. If you set @code{printer-name} to @@ -738,7 +739,7 @@ printers, run the command @samp{net view} from the command prompt to obtain a list of servers, and @samp{net view @var{server-name}} to see the names of printers (and directories) shared by that server. Alternatively, click the @samp{Network Neighborhood} icon on your -desktop, and look for machines which share their printers via the +desktop, and look for machines that share their printers via the network. @cindex @samp{net use}, and printing on MS-Windows @@ -797,8 +798,8 @@ specified by @code{printer-name}. Finally, if you do have an @code{lpr} work-alike, you can set the variable @code{lpr-command} to @code{"lpr"}. Then Emacs will use @code{lpr} for printing, as on other systems. (If the name of the -program isn't @code{lpr}, set @code{lpr-command} to specify where to -find it.) The variable @code{lpr-switches} has its standard meaning +program isn't @code{lpr}, set @code{lpr-command} to the appropriate value.) +The variable @code{lpr-switches} has its standard meaning when @code{lpr-command} is not @code{""}. If the variable @code{printer-name} has a string value, it is used as the value for the @code{-P} option to @code{lpr}, as on Unix. @@ -822,7 +823,7 @@ ports, and only one of them is a PostScript printer.) @cindex Ghostscript, use for PostScript printing The default value of the variable @code{ps-lpr-command} is @code{""}, which causes PostScript output to be sent to the printer port specified -by @code{ps-printer-name}, but @code{ps-lpr-command} can also be set to +by @code{ps-printer-name}; but @code{ps-lpr-command} can also be set to the name of a program which will accept PostScript files. Thus, if you have a non-PostScript printer, you can set this variable to the name of a PostScript interpreter program (such as Ghostscript). Any switches @@ -980,7 +981,7 @@ the system default antialiasing. determines whether to make the system caret visible. The default when no screen reader software is in use is @code{nil}, which means Emacs draws its own cursor to indicate the position of point. A -non-@code{nil} value means Emacs will indicate point location by the +non-@code{nil} value means Emacs will indicate point location with the system caret; this facilitates use of screen reader software, and is the default when such software is detected when running Emacs. When this variable is non-@code{nil}, other variables affecting the diff --git a/doc/emacs/picture-xtra.texi b/doc/emacs/picture-xtra.texi index 629baaf9c52..5a10bf2c31c 100644 --- a/doc/emacs/picture-xtra.texi +++ b/doc/emacs/picture-xtra.texi @@ -78,9 +78,10 @@ column, converting a tab to multiple spaces if necessary. @kbd{C-n} and @code{picture-move-up}, which can either insert spaces or convert tabs as necessary to make sure that point stays in exactly the same column. @kbd{C-e} runs @code{picture-end-of-line}, which moves to after the last -nonblank character on the line. There is no need to change @kbd{C-a}, -as the choice of screen model does not affect beginnings of -lines. +nonblank character on the line. @kbd{C-a} runs +@code{picture-beginning-of-line}. (The choice of screen model does not +affect beginnings of lines; the only extra thing this command does is +update the current picture column to 0.) @findex picture-newline Insertion of text is adapted to the quarter-plane screen model diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index 346e2fff5ff..8217400663f 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -1084,8 +1084,7 @@ documentation of functions, variables and commands that you plan to use in your program. @menu -* Info Lookup:: Looking up library functions and commands - in Info files. +* Info Lookup:: Looking up library functions and commands in Info files. * Man Page:: Looking up man pages of library functions and commands. * Lisp Doc:: Looking up Emacs Lisp functions, etc. @end menu diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 18556d4a5ef..3b3605f800c 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -87,8 +87,7 @@ other buffers, and never switch back, you have exited. Just make sure to save the Rmail file eventually (like any other file you have changed). @kbd{C-x s} is a suitable way to do this (@pxref{Save Commands}). The Rmail command @kbd{b}, @code{rmail-bury}, buries the -Rmail buffer and its summary buffer without expunging and saving the -Rmail file. +Rmail buffer and its summary without expunging and saving the Rmail file. @node Rmail Scrolling @section Scrolling Within a Message @@ -276,7 +275,7 @@ Expunge the Rmail file (@code{rmail-expunge}). @findex rmail-delete-forward @findex rmail-delete-backward There are two Rmail commands for deleting messages. Both delete the -current message and select another message. @kbd{d} +current message and select another. @kbd{d} (@code{rmail-delete-forward}) moves to the following message, skipping messages already deleted, while @kbd{C-d} (@code{rmail-delete-backward}) moves to the previous nondeleted message. If there is no nondeleted @@ -337,7 +336,7 @@ any time in Rmail by typing @kbd{g}. @vindex rmail-primary-inbox-list @cindex @env{MAIL} environment variable The variable @code{rmail-primary-inbox-list} contains a list of the -files which are inboxes for your primary Rmail file. If you don't set +files that are inboxes for your primary Rmail file. If you don't set this variable explicitly, Rmail uses the @env{MAIL} environment variable, or, as a last resort, a default inbox based on @code{rmail-spool-directory}. The default inbox file depends on your @@ -367,6 +366,7 @@ all into a separate Rmail file avoids the need for interlocking in all the rest of Rmail, since only Rmail operates on the Rmail file. @end enumerate +@c FIXME remove this in Emacs 25; won't be relevant any more. Rmail was originally written to use the Babyl format as its internal format. Since then, we have recognized that the usual inbox format (@samp{mbox}) on Unix and GNU systems is adequate for the job, and so @@ -454,6 +454,7 @@ second says which files in that directory to offer (all those that match the regular expression). If no files match, you cannot select this menu item. These variables also apply to choosing a file for output (@pxref{Rmail Output}). +@c FIXME matches only checked when Rmail file first visited? @ignore @findex set-rmail-inbox-list @@ -516,6 +517,7 @@ currently displayed and no more. @xref{Rmail Display}. In addition, @kbd{o} converts the message to Babyl format (used by Rmail in Emacs version 22 and before) if the file is in Babyl format; @kbd{C-o} cannot output to Babyl files at all. +@c FIXME remove BABYL mention in Emacs 25? If the output file is currently visited in an Emacs buffer, the output commands append the message to that buffer. It is up to you to @@ -727,7 +729,7 @@ Try sending a bounced message a second time (@code{rmail-retry-failure}). @cindex reply to a message The most common reason to send a message while in Rmail is to reply to the message you are reading. To do this, type @kbd{r} -(@code{rmail-reply}). This displays the @samp{*mail*} buffer in +(@code{rmail-reply}). This displays a mail composition buffer in another window, much like @kbd{C-x 4 m}, but preinitializes the @samp{Subject}, @samp{To}, @samp{CC}, @samp{In-reply-to} and @samp{References} header fields based on the message you are replying @@ -735,23 +737,20 @@ to. The @samp{To} field starts out as the address of the person who sent the message you received, and the @samp{CC} field starts out with all the other recipients of that message. -@vindex rmail-dont-reply-to-names +@vindex mail-dont-reply-to-names You can exclude certain recipients from being included automatically -in replies, using the variable @code{rmail-dont-reply-to-names}. Its +in replies, using the variable @code{mail-dont-reply-to-names}. Its value should be a regular expression; any recipients that match are excluded from the @samp{CC} field. They are also excluded from the @samp{To} field, unless this would leave the field empty. If this variable is nil, then the first time you compose a reply it is -initialized to a default value that matches your own address, and any -name starting with @samp{info-}. (Those names are excluded because -there is a convention of using them for large mailing lists to broadcast -announcements.) +initialized to a default value that matches your own address. To omit the @samp{CC} field completely for a particular reply, enter the reply command with a numeric argument: @kbd{C-u r} or @kbd{1 r}. This means to reply only to the sender of the original message. - Once the @samp{*mail*} buffer has been initialized, editing and + Once the mail composition buffer has been initialized, editing and sending the mail goes as usual (@pxref{Sending Mail}). You can edit the presupplied header fields if they are not what you want. You can also use commands such as @kbd{C-c C-y}, which yanks in the message @@ -767,7 +766,7 @@ and yank the new current message. send the failed message back to you, enclosed in a @dfn{failure message}. The Rmail command @kbd{M-m} (@code{rmail-retry-failure}) prepares to send the same message a second time: it sets up a -@samp{*mail*} buffer with the same text and header fields as before. If +mail composition buffer with the same text and header fields as before. If you type @kbd{C-c C-c} right away, you send the message again exactly the same as the first time. Alternatively, you can edit the text or headers and then send it. The variable @@ -780,23 +779,31 @@ headers are stripped from the failed message when retrying it. @cindex forwarding a message Another frequent reason to send mail in Rmail is to @dfn{forward} the current message to other users. @kbd{f} (@code{rmail-forward}) makes -this easy by preinitializing the @samp{*mail*} buffer with the current -message as the text, and a subject designating a forwarded message. All -you have to do is fill in the recipients and send. When you forward a -message, recipients get a message which is ``from'' you, and which has -the original message in its contents. - +this easy by preinitializing the mail composition buffer with the current +message as the text, and a subject of the form @code{[@var{from}: +@var{subject}]}, where @var{from} and @var{subject} are the sender and +subject of the original message. All you have to do is fill in the +recipients and send. When you forward a message, recipients get a +message which is ``from'' you, and which has the original message in +its contents. + +@vindex rmail-enable-mime-composing @findex unforward-rmail-message - Forwarding a message encloses it between two delimiter lines. It also -modifies every line that starts with a dash, by inserting @w{@samp{- }} -at the start of the line. When you receive a forwarded message, if it + Rmail offers two formats for forwarded messages. The default is to +use MIME (@pxref{Rmail Display}) format. This includes the original +message as a separate part. You can use a simpler format if you +prefer, by setting the variable @code{rmail-enable-mime-composing} to +@code{nil}. In this case, Rmail just includes the original message +enclosed between two delimiter lines. It also modifies every line +that starts with a dash, by inserting @w{@samp{- }} at the start of +the line. When you receive a forwarded message in this format, if it contains something besides ordinary text---for example, program source -code---you might find it useful to undo that transformation. You can do -this by selecting the forwarded message and typing @kbd{M-x -unforward-rmail-message}. This command extracts the original forwarded -message, deleting the inserted @w{@samp{- }} strings, and inserts it -into the Rmail file as a separate message immediately following the -current one. +code---you might find it useful to undo that transformation. You can +do this by selecting the forwarded message and typing @kbd{M-x +unforward-rmail-message}. This command extracts the original +forwarded message, deleting the inserted @w{@samp{- }} strings, and +inserts it into the Rmail file as a separate message immediately +following the current one. @findex rmail-resend @dfn{Resending} is an alternative similar to forwarding; the @@ -812,22 +819,28 @@ numeric argument.) Use the @kbd{m} (@code{rmail-mail}) command to start editing an outgoing message that is not a reply. It leaves the header fields empty. Its only difference from @kbd{C-x 4 m} is that it makes the Rmail buffer -accessible for @kbd{C-c C-y}, just as @kbd{r} does. Thus, @kbd{m} can be -used to reply to or forward a message; it can do anything @kbd{r} or @kbd{f} -can do. +accessible for @kbd{C-c C-y}, just as @kbd{r} does. +@ignore +@c Not a good idea, because it does not include Reply-To etc. +Thus, @kbd{m} can be used to reply to or forward a message; it can do +anything @kbd{r} or @kbd{f} can do. +@end ignore @kindex c @r{(Rmail)} @findex rmail-continue The @kbd{c} (@code{rmail-continue}) command resumes editing the -@samp{*mail*} buffer, to finish editing an outgoing message you were +mail composition buffer, to finish editing an outgoing message you were already composing, or to alter a message you have sent. @vindex rmail-mail-new-frame If you set the variable @code{rmail-mail-new-frame} to a non-@code{nil} value, then all the Rmail commands to start sending a message create a new frame to edit it in. This frame is deleted when -you send the message, or when you use the @samp{Cancel} item in the -@samp{Mail} menu. +you send the message. +@ignore +@c FIXME does not work with Message -> Kill Message +, or when you use the @samp{Cancel} item in the @samp{Mail} menu. +@end ignore All the Rmail commands to send a message use the mail-composition method that you have chosen (@pxref{Mail Methods}). @@ -905,8 +918,8 @@ commas. makes a partial summary mentioning only the messages that have one or more recipients matching the regular expression @var{rcpts}. You can use commas to separate multiple regular expressions. These are matched -against the @samp{To}, @samp{From}, and @samp{CC} headers (with a prefix -argument, this header is not included). +against the @samp{To}, @samp{From}, and @samp{CC} headers (supply a prefix +argument to exclude this header). @kindex C-M-t @r{(Rmail)} @findex rmail-summary-by-topic @@ -1178,7 +1191,7 @@ Move point to the next @acronym{MIME} tagline button. (@code{rmail-mime-next-item}). @findex rmail-mime-previous-item -@item @key{BackTab} +@item S-@key{TAB} Move point to the previous @acronym{MIME} part (@code{rmail-mime-previous-item}). @@ -1195,7 +1208,7 @@ immediately after its tagline, as part of the Rmail buffer, while taglines, with their actual contents hidden. In either case, you can toggle a @acronym{MIME} part between its ``displayed'' and ``hidden'' states by typing @key{RET} anywhere in the part---or anywhere in its -tagline, apart from a tagline button for some other action. Type +tagline (except for buttons for other actions, if there are any). Type @key{RET} (or click with the mouse) to activate a tagline button, and @key{TAB} to cycle point between tagline buttons. @@ -1213,7 +1226,7 @@ temporary buffer to display the current @acronym{MIME} message. @cindex encrypted mails (reading in Rmail) If the current message is an encrypted one, use the command @kbd{M-x rmail-epa-decrypt} to decrypt it, using the EasyPG library -(@pxref{Top,,, epa, EasyPG Assistant User's Manual}). +(@pxref{Top,, EasyPG, epa, EasyPG Assistant User's Manual}). You can highlight and activate URLs in the Rmail buffer using Goto Address mode: @@ -1300,13 +1313,13 @@ the message, if you have made any changes in it. @cindex undigestify A @dfn{digest message} is a message which exists to contain and carry -several other messages. Digests are used on some moderated mailing +several other messages. Digests are used on some mailing lists; all the messages that arrive for the list during a period of time such as one day are put inside a single digest which is then sent to the -subscribers. Transmitting the single digest uses much less computer +subscribers. Transmitting the single digest uses less computer time than transmitting the individual messages even though the total -size is the same, because the per-message overhead in network mail -transmission is considerable. +size is the same, because of the per-message overhead in network mail +transmission. @findex undigestify-rmail-message When you receive a digest message, the most convenient way to read it is @@ -1321,14 +1334,15 @@ message itself is flagged as deleted. @section Reading Rot13 Messages @cindex rot13 code - Mailing list messages that might offend some readers are sometimes + Mailing list messages that might offend or annoy some readers are sometimes encoded in a simple code called @dfn{rot13}---so named because it rotates the alphabet by 13 letters. This code is not for secrecy, as it -provides none; rather, it enables those who might be offended to avoid -seeing the real text of the message. +provides none; rather, it enables those who wish to to avoid +seeing the real text of the message. For example, a review of a film +might use rot13 to hide important plot points. @findex rot13-other-window - To view a buffer which uses the rot13 code, use the command @kbd{M-x + To view a buffer that uses the rot13 code, use the command @kbd{M-x rot13-other-window}. This displays the current buffer in another window which applies the code when displaying the text. diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi index 6f154ce2af6..a2cb5d9f8f2 100644 --- a/doc/emacs/sending.texi +++ b/doc/emacs/sending.texi @@ -377,8 +377,8 @@ sending mail via @code{smtpmail-send-it} (see below). Send mail using the through an external mail host, such as your Internet service provider's outgoing SMTP mail server. If you have not told Emacs how to contact the SMTP server, it prompts for this -information, which is saved in the variables -@code{smtpmail-smtp-server} and @code{smtpmail-auth-credentials}. +information, which is saved in the @code{smtpmail-smtp-server} variable +and the file @file{~/.authinfo}. @xref{Top,,Emacs SMTP Library, smtpmail, Sending mail via SMTP}. @item sendmail-send-it diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 027138811ca..5753c256c5d 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -74,9 +74,9 @@ for editing such pictures. * Text Mode:: The major modes for editing text files. * Outline Mode:: Editing outlines. * Org Mode:: The Emacs organizer. -* TeX Mode:: Editing input to the formatter TeX. +* TeX Mode:: Editing TeX and LaTeX files. * HTML Mode:: Editing HTML and SGML files. -* Nroff Mode:: Editing input to the formatter nroff. +* Nroff Mode:: Editing input to the nroff formatter. * Enriched Text:: Editing text ``enriched'' with fonts, colors, etc. * Text Based Tables:: Commands for editing text-based tables. * Two-Column:: Splitting text columns into separate windows. diff --git a/doc/emacs/vc1-xtra.texi b/doc/emacs/vc1-xtra.texi index 48b902f18c1..cd5ed206dd6 100644 --- a/doc/emacs/vc1-xtra.texi +++ b/doc/emacs/vc1-xtra.texi @@ -123,7 +123,7 @@ working tree, and schedule the renaming for committing. it via the version control system. The file is removed from the working tree, and in the VC Directory buffer @iftex -(@pxref{VC Directory Mode}), +(@pxref{VC Directory Mode,,, emacs, the Emacs Manual}), @end iftex @ifnottex (@pxref{VC Directory Mode}), @@ -438,4 +438,10 @@ difference is that the ``manual'' version backups made by @kbd{C-x v locking-like behavior using its @env{CVSREAD} or @dfn{watch} feature; see the CVS documentation for details. If that case, you can use @kbd{C-x v v} in Emacs to toggle locking, as you would for a -locking-based version control system (@pxref{VC With A Locking VCS}). +locking-based version control system +@iftex +(@pxref{VC With A Locking VCS,,,emacs, the Emacs Manual}). +@end iftex +@ifnottex +(@pxref{VC With A Locking VCS}). +@end ifnottex |