diff options
Diffstat (limited to 'doc/misc')
54 files changed, 313 insertions, 309 deletions
diff --git a/doc/misc/ada-mode.texi b/doc/misc/ada-mode.texi index 8bd05382b44..f4c29bb6e16 100644 --- a/doc/misc/ada-mode.texi +++ b/doc/misc/ada-mode.texi @@ -3,7 +3,7 @@ @settitle Ada Mode @copying -Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -1506,7 +1506,7 @@ Start a comment in default column. @item M-j Continue comment on next line. @item C-c ; -Comment the selected region (add -- at the beginning of lines). +Comment the selected region (add @samp{--} at the beginning of lines). @item C-c : Uncomment the selected region @item M-q diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi index bf8b180f71a..6f3a5fe0a38 100644 --- a/doc/misc/auth.texi +++ b/doc/misc/auth.texi @@ -10,7 +10,7 @@ @copying This file describes the Emacs auth-source library. -Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2008--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/autotype.texi b/doc/misc/autotype.texi index b2a128774ed..9af47adfbe3 100644 --- a/doc/misc/autotype.texi +++ b/doc/misc/autotype.texi @@ -10,7 +10,7 @@ @c @cindex autotypist @copying -Copyright @copyright{} 1994-1995, 1999, 2001-2012 +Copyright @copyright{} 1994--1995, 1999, 2001--2012 Free Software Foundation, Inc. @quotation diff --git a/doc/misc/bovine.texi b/doc/misc/bovine.texi index 79a1b177716..f1a72f4cc3e 100644 --- a/doc/misc/bovine.texi +++ b/doc/misc/bovine.texi @@ -23,7 +23,7 @@ @c %**end of header @copying -Copyright @copyright{} 1999-2004, 2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2004, 2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 97ab89d572b..29332c9b023 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi @@ -94,7 +94,7 @@ This file documents Calc, the GNU Emacs calculator, included with GNU Emacs @value{EMACSVER}. @end ifnotinfo -Copyright @copyright{} 1990-1991, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1990--1991, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -17330,7 +17330,7 @@ daylight saving computations. This is an internal version of the user-level @code{pwday} function described in the previous section. It takes four arguments: The floating-point date value, the corresponding six-element date list, the day-of-month number, -and the weekday number (0-6). +and the weekday number (0--6). The default daylight saving hook ignores the time zone name, but a more sophisticated hook could use different algorithms for different @@ -36629,7 +36629,7 @@ time zone number or name from the top of the stack. @xref{Time Zones}. @c 17 @item -A prefix argument specifies a day number (0-6, 0-31, or 0-366). +A prefix argument specifies a day number (0--6, 0--31, or 0--366). @c 18 @item diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 031abba1f04..daa9c6f7ab8 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi @@ -156,7 +156,7 @@ CC Mode @copying This manual is for CC Mode in Emacs. -Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1995--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -219,7 +219,7 @@ Objective-C, Java, CORBA IDL (and the variants PSDL and CIDL), Pike and AWK code. It provides syntax-based indentation, font locking, and has several handy commands and some minor modes to make the editing easier. It does not provide tools to look up and navigate between -functions, classes etc - there are other packages for that. +functions, classes, etc.; there are other packages for that. @insertcopying @end ifnottex @@ -369,7 +369,7 @@ Late in 1997, Martin Stjernholm joined Barry on the @ccmode{} Maintainers Team, and implemented the Pike support. In 2000 Martin took over as the sole maintainer. In 2001 Alan Mackenzie joined the team, implementing AWK support in version 5.30. @ccmode{} did not -originally contain the font lock support for its languages --- that +originally contain the font lock support for its languages; that was added in version 5.30. This manual describes @ccmode{} @@ -441,7 +441,7 @@ increasing detail. @itemize @bullet @item The chapter ``Configuration Basics'' tells you @emph{how} to write -customizations - whether in hooks, in styles, in both, or in neither, +customizations: whether in hooks, in styles, in both, or in neither, depending on your needs. It describes the @ccmode{} style system and lists the standard styles that @ccmode{} supplies. @@ -468,7 +468,7 @@ The FAQ contains a list of common problems and questions. @item The next two chapters tell you how to get in touch with the @ccmode{} -project - whether for updating @ccmode{} or submitting bug reports. +project: whether for updating @ccmode{} or submitting bug reports. @end itemize @noindent @@ -715,7 +715,7 @@ current line. When it is @code{nil}, @key{TAB} (re)indents the line only if point is to the left of the first non-whitespace character on the line. Otherwise it inserts some whitespace (a tab or an equivalent number of -spaces - see below) at point. +spaces; see below) at point. @item With some other value, the line is reindented. Additionally, if point is within a string or comment, some whitespace is inserted. @@ -820,10 +820,10 @@ often (in seconds) progress messages are to be displayed. @kindex C-c C-c @findex comment-region This command comments out the lines that start in the region. With a -negative argument, it does the opposite - it deletes the comment +negative argument, it does the opposite: it deletes the comment delimiters from these lines. @xref{Multi-Line Comments,,, emacs, GNU Emacs Manual}, for fuller details. @code{comment-region} isn't -actually part of @ccmode{} - it is given a @ccmode{} binding for +actually part of @ccmode{}; it is given a @ccmode{} binding for convenience. @item @kbd{M-;} (@code{comment-dwim} or @code{indent-for-comment} @footnote{The name of this command varies between (X)Emacs versions.}) @@ -1147,7 +1147,7 @@ them yourself, e.g., after typing @samp{@}}s. Its action is suppressed when electric mode is disabled. @item hungry-delete mode This lets you delete a contiguous block of whitespace with a single -key - for example, the newline and indentation just inserted by +key: for example, the newline and indentation just inserted by auto-newline when you want to back up and write a comment after the last statement. @item subword mode @@ -1176,7 +1176,7 @@ are enabled but the other two modes are disabled. @ccmode{} displays the current state of the first four of these minor modes on the modeline by appending letters to the major mode's name, -one letter for each enabled minor mode - @samp{l} for electric mode, +one letter for each enabled minor mode: @samp{l} for electric mode, @samp{a} for auto-newline mode, @samp{h} for hungry delete mode, and @samp{w} for subword mode. If all these modes were enabled, you'd see @samp{C/lahw}@footnote{The @samp{C} would be replaced with the name of @@ -1234,7 +1234,7 @@ turn it (or them) off. @cindex electric characters @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -Most punctuation keys provide @dfn{electric} behavior - as well as +Most punctuation keys provide @dfn{electric} behavior: as well as inserting themselves they perform some other action, such as reindenting the line. This reindentation saves you from having to reindent a line manually after typing, say, a @samp{@}}. A few @@ -2101,7 +2101,7 @@ initialization and the result is prepended. For an example, see @code{javadoc-font-lock-keywords} in @file{cc-fonts.el}. If you add support for another doc comment style, please consider -contributing it - send a note to @email{bug-cc-mode@@gnu.org}. +contributing it: send a note to @email{bug-cc-mode@@gnu.org}. @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @@ -2249,7 +2249,7 @@ more sophisticated facilities, hooks and styles. An Emacs @dfn{hook} is a place to put Lisp functions that you want Emacs to execute later in specific circumstances. @xref{Hooks,,,@lispref{}, @lispreftitle{}}. @ccmode{} supplies a main -hook and a language-specific hook for each language it supports - any +hook and a language-specific hook for each language it supports; any functions you put onto these hooks get executed as the last part of a buffer's initialization. Typically you put most of your customization within the main hook, and use the language-specific hooks to vary the @@ -2683,7 +2683,7 @@ string. If none of the built-in styles is appropriate, you'll probably want to create a new @dfn{style definition}, possibly based on an existing style. To do this, put the new style's settings into a list with the -following format - the list can then be passed as an argument to the +following format; the list can then be passed as an argument to the function @code{c-add-style}. You can see an example of a style definition in @ref{Sample .emacs File}. @@ -3166,7 +3166,7 @@ different ways, depending on the character just typed: @item Braces and Colons @ccmode{} first determines the syntactic context of the brace or colon (@pxref{Syntactic Symbols}), then looks for a corresponding element in -an alist. This element specifies where to put newlines - this is any +an alist. This element specifies where to put newlines: this is any combination of before and after the brace or colon. If no alist element is found, newlines are inserted both before and after a brace, but none are inserted around a colon. See @ref{Hanging Braces} and @@ -3267,7 +3267,7 @@ syntactic symbol, the associated value is either @code{nil}, a list, or a function. @table @asis -@item The Key - the syntactic symbol +@item The Key: the syntactic symbol The syntactic symbols that are useful as keys in this list are @code{brace-list-intro}, @code{statement-cont}, @code{inexpr-class-open}, @code{inexpr-class-close}, and all the @@ -3290,7 +3290,7 @@ lists in this regard, even though they do for normal indentation purposes. It's currently not possible to set automatic newlines on these constructs. -@item The associated value - the ``ACTION'' list or function +@item The associated value: the ``ACTION'' list or function The value associated with each syntactic symbol in this association list is called an @var{action}, which can be either a list or a function which returns a list. @xref{Custom Braces}, for how to use @@ -3460,7 +3460,7 @@ that the brace appears on a line by itself. Using a mechanism similar to brace hanging (@pxref{Hanging Braces}), colons can also be made to hang using the style variable -@code{c-hanging-colons-alist} - When a colon is typed, @ccmode +@code{c-hanging-colons-alist}: when a colon is typed, @ccmode determines its syntactic context, looks this up in the alist @code{c-changing-colons-alist} and inserts up to two newlines accordingly. Here, however, If @ccmode fails to find an entry for a @@ -3471,17 +3471,17 @@ newly typed colon. @vindex hanging-colons-alist (c-) @table @asis -@item The Key - the syntactic symbol +@item The Key: the syntactic symbol The syntactic symbols appropriate as keys in this association list are: @code{case-label}, @code{label}, @code{access-label}, @code{member-init-intro}, and @code{inher-intro}. @xref{Syntactic Symbols}. Elements with any other value as a key get ignored. -@item The associate value - the ``ACTION'' list +@item The associated value: the ``ACTION'' list The @var{action} here is simply a list containing a combination of the symbols @code{before} and @code{after}. Unlike in @code{c-hanging-braces-alist}, functions as @var{actions} are not -supported - there doesn't seem to be any need for them. +supported; there doesn't seem to be any need for them. @end table @end defopt @@ -3913,7 +3913,7 @@ recognized, e.g., @code{statement}, @code{substatement}, @code{class-open}, @code{class-close}, etc. @xref{Syntactic Symbols}, for a complete list of currently recognized syntactic symbols and their semantics. The remaining entries are various data associated -with the recognized construct - there might be zero or more. +with the recognized construct; there might be zero or more. @cindex anchor position Conceptually, a line of code is always indented relative to some @@ -4570,7 +4570,7 @@ example: Here, lines 4, 7, and 10 are all assigned @code{case-label} syntax, while lines 5 and 8 are assigned @code{statement-case-intro}. Line 11 is treated slightly differently since it contains a brace that opens a -block --- it is given @code{statement-case-open} syntax. +block; it is given @code{statement-case-open} syntax. @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @node Brace List Symbols, External Scope Symbols, Switch Statement Symbols, Syntactic Symbols @@ -4798,7 +4798,7 @@ Line 2 is assigned the @code{func-decl-cont} syntax. @ssindex comment-intro Line 4 is assigned both @code{defun-block-intro} @emph{and} @code{comment-intro} syntax. A syntactic element with -@code{comment-intro} has no anchor point --- It is always accompanied +@code{comment-intro} has no anchor point. It is always accompanied by another syntactic element which does have one. @item @@ -5282,15 +5282,15 @@ values that the special symbols correspond to: @item + @code{c-basic-offset} times 1 @item - -@code{c-basic-offset} times -1 +@code{c-basic-offset} times @minus{}1 @item ++ @code{c-basic-offset} times 2 @item -- -@code{c-basic-offset} times -2 +@code{c-basic-offset} times @minus{}2 @item * @code{c-basic-offset} times 0.5 @item / -@code{c-basic-offset} times -0.5 +@code{c-basic-offset} times @minus{}0.5 @end table @item A vector @@ -5332,10 +5332,10 @@ Use the first offset that doesn't evaluate to @code{nil}. Subsequent elements of the list don't get evaluated. @item min Use the minimum of all the offsets. All must be either relative or -absolute - they can't be mixed. +absolute; they can't be mixed. @item max Use the maximum of all the offsets. All must be either relative or -absolute - they can't be mixed. +absolute; they can't be mixed. @item add Add all the evaluated offsets together. Exactly one of them may be absolute, in which case the result is absolute. Any relative offsets @@ -5493,7 +5493,7 @@ any problems writing custom line-up functions for AWK mode. The calling convention for line-up functions is described fully in @ref{Custom Line-Up}. Roughly speaking, the return value is either an offset itself (such as @code{+} or @code{[0]}) or it's @code{nil}, -meaning ``this function is inappropriate in this case - try a +meaning ``this function is inappropriate in this case; try a different one''. @xref{c-offsets-alist}. The subsections below describe all the standard line-up functions, @@ -6514,12 +6514,12 @@ your setup for this by using the access functions @vindex c-syntactic-context @vindex syntactic-context (c-) Some syntactic symbols, e.g., @code{arglist-cont-nonempty}, have more -info in the syntactic element - typically other positions that can be +info in the syntactic element: typically other positions that can be interesting besides the anchor position. That info can't be accessed through the passed argument, which is a cons cell. Instead, you can get this information from the variable @code{c-syntactic-element}, which is dynamically bound to the complete syntactic element. The -variable @code{c-syntactic-context} might also be useful - it gets +variable @code{c-syntactic-context} might also be useful: it gets dynamically bound to the complete syntactic context. @xref{Custom Braces}. diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 485bda81b5b..6c53c7643bc 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi @@ -6,7 +6,7 @@ @copying This file documents the GNU Emacs Common Lisp emulation package. -Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1993, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi index 610321f18c2..0356f66c166 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi @@ -9,7 +9,7 @@ @syncodeindex fn cp @copying -Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2007--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/dired-x.texi b/doc/misc/dired-x.texi index ed10a2232f6..439a05f3412 100644 --- a/doc/misc/dired-x.texi +++ b/doc/misc/dired-x.texi @@ -19,7 +19,7 @@ @comment %**end of header (This is for running Texinfo on a region.) @copying -Copyright @copyright{} 1994-1995, 1999, 2001-2012 +Copyright @copyright{} 1994--1995, 1999, 2001--2012 Free Software Foundation, Inc. @quotation diff --git a/doc/misc/ebrowse.texi b/doc/misc/ebrowse.texi index 71f58b7d714..3294d10db2b 100644 --- a/doc/misc/ebrowse.texi +++ b/doc/misc/ebrowse.texi @@ -10,7 +10,7 @@ @copying This file documents Ebrowse, a C++ class browser for GNU Emacs. -Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2000--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi index 704d5b1141c..78fcefb9e76 100644 --- a/doc/misc/ede.texi +++ b/doc/misc/ede.texi @@ -5,7 +5,7 @@ @copying This file describes EDE, the Emacs Development Environment. -Copyright @copyright{} 1998-2001, 2004-2005, 2008-2012 +Copyright @copyright{} 1998--2001, 2004--2005, 2008--2012 Free Software Foundation, Inc. @quotation diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi index 002a726d232..1aba0a446f1 100644 --- a/doc/misc/ediff.texi +++ b/doc/misc/ediff.texi @@ -25,7 +25,7 @@ This file documents Ediff, a comprehensive visual interface to Unix diff and patch utilities. -Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1995--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -556,8 +556,8 @@ Makes the next difference region current. Makes the very first difference region current. @kbd{-j} makes the last region current. Typing a number, N, and then `j' -makes the difference region N current. Typing -N (a negative number) then -`j' makes current the region Last - N. +makes the difference region N current. Typing @minus{}N (a negative number) then +`j' makes current the region Last @minus{} N. @item ga @kindex ga @@ -954,7 +954,7 @@ difference. @vindex ediff-use-toolbar-p The use of the toolbar can also be specified via the variable @code{ediff-use-toolbar-p} (default is @code{t}). This variable can be set -only in @file{.emacs} --- do @strong{not} change it interactively. Use the +only in @file{.emacs}: do @strong{not} change it interactively. Use the function @code{ediff-toggle-use-toolbar} instead. @item ediff-revert-buffers-then-recompute-diffs @@ -1326,7 +1326,7 @@ Hooks run just before exiting a session group. @item ediff-meta-buffer-keymap-setup-hook @vindex ediff-meta-buffer-keymap-setup-hook @vindex ediff-meta-buffer-map -Hooks run just after setting up the @code{ediff-meta-buffer-map} --- the +Hooks run just after setting up the @code{ediff-meta-buffer-map}, the map that controls key bindings in the meta buffer. Since @code{ediff-meta-buffer-map} is a local variable, you can set different bindings for different kinds of meta buffers. diff --git a/doc/misc/edt.texi b/doc/misc/edt.texi index 0ecaca79594..0707e34e356 100644 --- a/doc/misc/edt.texi +++ b/doc/misc/edt.texi @@ -5,7 +5,7 @@ @copying This file documents the EDT emulation package for Emacs. -Copyright @copyright{} 1986, 1992, 1994-1995, 1999-2012 +Copyright @copyright{} 1986, 1992, 1994--1995, 1999--2012 Free Software Foundation, Inc. @quotation @@ -102,25 +102,25 @@ how to customize it to your liking. @itemize @item -@file{edt.texi} - This manual. +@file{edt.texi}---This manual. @item -@file{edt-user.el} - An example customization file. +@file{edt-user.el}---An example customization file. @item -@file{edt.el} - EDT emulation functions and default configuration. +@file{edt.el}---EDT emulation functions and default configuration. @item -@file{edt-lk201.el} - Built-in support for DEC LK-201 keyboards. +@file{edt-lk201.el}---Built-in support for DEC LK-201 keyboards. @item -@file{edt-vt100.el} - Built-in support for DEC VT-100 (and above) terminals. +@file{edt-vt100.el}---Built-in support for DEC VT-100 (and above) terminals. @item -@file{edt-pc.el} - Built-in support for PC 101 Keyboards under MS-DOS. +@file{edt-pc.el}---Built-in support for PC 101 Keyboards under MS-DOS. @item -@file{edt-mapper.el} - Create an EDT LK-201 map file for keyboards +@file{edt-mapper.el}---Create an EDT LK-201 map file for keyboards without built-in support. @end itemize diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi index 8b2a73b5f7c..f898a2b3319 100644 --- a/doc/misc/eieio.texi +++ b/doc/misc/eieio.texi @@ -11,7 +11,7 @@ @copying This manual documents EIEIO, an object framework for Emacs Lisp. -Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2007--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi index f26d80b598b..d530837c6b3 100644 --- a/doc/misc/emacs-mime.texi +++ b/doc/misc/emacs-mime.texi @@ -11,7 +11,7 @@ @copying This file documents the Emacs MIME interface functionality. -Copyright @copyright{} 1998-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1998--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -1855,7 +1855,7 @@ Conformance Criteria and Examples Languages, and Continuations @item RFC1843 -HZ - A Data Format for Exchanging Files of Arbitrarily Mixed Chinese and +HZ---A Data Format for Exchanging Files of Arbitrarily Mixed Chinese and @acronym{ASCII} characters @item draft-ietf-drums-msg-fmt-05.txt diff --git a/doc/misc/epa.texi b/doc/misc/epa.texi index c265f92bed7..20824e0fc91 100644 --- a/doc/misc/epa.texi +++ b/doc/misc/epa.texi @@ -9,7 +9,7 @@ @copying This file describes EasyPG Assistant @value{VERSION}. -Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2007--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi index d8b3843fd6c..569750bd1e5 100644 --- a/doc/misc/erc.texi +++ b/doc/misc/erc.texi @@ -9,7 +9,7 @@ @copying This manual is for ERC as distributed with Emacs @value{EMACSVER}. -Copyright @copyright{} 2005-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2005--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi index 2cd51d5aec9..4dd19613509 100644 --- a/doc/misc/ert.texi +++ b/doc/misc/ert.texi @@ -10,7 +10,7 @@ @end direntry @copying -Copyright @copyright{} 2008, 2010-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2008, 2010--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -91,7 +91,7 @@ Appendix ERT allows you to define @emph{tests} in addition to functions, macros, variables, and the other usual Lisp constructs. Tests are -simply Lisp code --- code that invokes other code and checks whether +simply Lisp code: code that invokes other code and checks whether it behaves as expected. ERT keeps track of the tests that are defined and provides convenient @@ -132,8 +132,8 @@ will pass if the three calls to @code{equal} all return true better error reporting. @xref{The @code{should} Macro}. Each test should have a name that describes what functionality it tests. -Test names can be chosen arbitrarily --- they are in a -namespace separate from functions and variables --- but should follow +Test names can be chosen arbitrarily---they are in a +namespace separate from functions and variables---but should follow the usual Emacs Lisp convention of having a prefix that indicates which package they belong to. Test names are displayed by ERT when reporting failures and can be used when selecting which tests to run. @@ -502,7 +502,7 @@ buffer if one is already visiting the requested file; and it runs Instead, it is better to use lower-level mechanisms with simple and predictable semantics like @code{with-temp-buffer}, @code{insert} or @code{insert-file-contents-literally}, and to activate any desired mode -by calling the corresponding function directly --- after binding the +by calling the corresponding function directly, after binding the hook variables to nil. This avoids the above problems. @@ -559,9 +559,9 @@ could be used instead. The reason why this test only checks the first line of the backtrace is that the remainder of the backtrace is dependent on ERT's internals as well as whether the code is running interpreted or compiled. By -looking only at the first line, the test checks a useful property ---- that the backtrace correctly captures the call to @code{signal} that -results from the call to @code{ert-fail} --- without being brittle. +looking only at the first line, the test checks a useful property---that +the backtrace correctly captures the call to @code{signal} that +results from the call to @code{ert-fail}---without being brittle. This example also shows that writing tests is much easier if the code under test was structured with testing in mind. @@ -699,12 +699,12 @@ strips them out, so it is more convenient. failed. This can be useful to figure out how far it got. @item You can instrument tests for debugging the same way you instrument -@code{defun}s for debugging --- go to the source code of the test and +@code{defun}s for debugging: go to the source code of the test and type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and re-run the test with @kbd{r} or @kbd{d}. @item If you have been editing and rearranging tests, it is possible that -ERT remembers an old test that you have since renamed or removed --- +ERT remembers an old test that you have since renamed or removed: renamings or removals of definitions in the source code leave around a stray definition under the old name in the running process (this is a common problem in Lisp). In such a situation, hit @kbd{D} to let ERT diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 926e09c5912..5011910033d 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -8,7 +8,7 @@ @copying This manual is for Eshell, the Emacs shell. -Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/eudc.texi b/doc/misc/eudc.texi index 02c5de05098..d5127cd3e09 100644 --- a/doc/misc/eudc.texi +++ b/doc/misc/eudc.texi @@ -12,7 +12,7 @@ EUDC is the Emacs Unified Directory Client, a common interface to directory servers using various protocols such as LDAP or the CCSO white pages directory system (PH/QI) -Copyright @copyright{} 1998, 2000-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1998, 2000--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi index ec0d6bfe4cc..681f54956a5 100644 --- a/doc/misc/faq.texi +++ b/doc/misc/faq.texi @@ -11,7 +11,7 @@ @c appreciate a notice if you do). @copying -Copyright @copyright{} 2001-2012 Free Software Foundation, Inc.@* +Copyright @copyright{} 2001--2012 Free Software Foundation, Inc.@* Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000 Reuven M. Lerner@* Copyright @copyright{} 1992, 1993 Steven Byrnes@* @@ -2738,7 +2738,7 @@ type @kbd{C-h C-p} to read it. Old versions (i.e., anything before 19.29) of Emacs had problems editing files larger than 8 megabytes. In versions 19.29 and later, the maximum -buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. +buffer size is at least 2^27@minus{}1, or 134,217,727 bytes, or 132 MBytes. The maximum buffer size on 32-bit machines increased to 256 MBytes in Emacs 22, and again to 512 MBytes in Emacs 23.2. diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi index d27f078555e..8eb9a5bc339 100644 --- a/doc/misc/flymake.texi +++ b/doc/misc/flymake.texi @@ -11,7 +11,7 @@ This manual is for GNU Flymake (version @value{VERSION}, @value{UPDATED}), which is a universal on-the-fly syntax checker for GNU 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 @@ -355,8 +355,8 @@ Which fringe (if any) should show the warning/error bitmaps. @cindex Adding support for a new syntax check tool @menu -* Example -- Configuring a tool called directly:: -* Example -- Configuring a tool called via make:: +* Example---Configuring a tool called directly:: +* Example---Configuring a tool called via make:: @end menu Syntax check tools are configured using the @@ -406,8 +406,8 @@ the @code{flymake-err-line-patterns} list. The following sections contain some examples of configuring Flymake support for various syntax check tools. -@node Example -- Configuring a tool called directly -@subsection Example -- Configuring a tool called directly +@node Example---Configuring a tool called directly +@subsection Example---Configuring a tool called directly @cindex Adding support for perl In this example, we will add support for @code{perl} as a syntax check @@ -455,8 +455,8 @@ Finally, we add an entry to @code{flymake-err-line-patterns}: flymake-err-line-patterns)) @end lisp -@node Example -- Configuring a tool called via make -@subsection Example -- Configuring a tool called via make +@node Example---Configuring a tool called via make +@subsection Example---Configuring a tool called via make @cindex Adding support for C (gcc+make) In this example we will add support for C files syntax checked by @@ -528,7 +528,7 @@ check-syntax: Syntax check is started by calling @code{flymake-start-syntax-check-for-current-buffer}. Flymake first determines whether it is able to do syntax check. It then saves a copy of the buffer in a temporary file in the -buffer's directory (or in the system temp directory -- for java +buffer's directory (or in the system temp directory, for java files), creates a syntax check command and launches a process with this command. The output is parsed using a list of error message patterns, and error information (file name, line number, type and text) is diff --git a/doc/misc/forms.texi b/doc/misc/forms.texi index b38718826cb..cc621591f02 100644 --- a/doc/misc/forms.texi +++ b/doc/misc/forms.texi @@ -18,7 +18,7 @@ @copying This file documents Forms mode, a form-editing major mode for GNU Emacs. -Copyright @copyright{} 1989, 1997, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1989, 1997, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/gnus-coding.texi b/doc/misc/gnus-coding.texi index 35ec2120955..a06fb45bb29 100644 --- a/doc/misc/gnus-coding.texi +++ b/doc/misc/gnus-coding.texi @@ -7,7 +7,7 @@ @syncodeindex pg cp @copying -Copyright @copyright{} 2004-2005, 2007-2012 Free Software +Copyright @copyright{} 2004--2005, 2007--2012 Free Software Foundation, Inc. @quotation @@ -300,7 +300,7 @@ reason. @c (typically so far the only exception has been that the changes @c already exist in the trunk in modified form). Because of this, when the next major version of Gnus will be included in -Emacs, it should be very easy -- just plonk in the files from the Gnus +Emacs, it should be very easy---just plonk in the files from the Gnus trunk without worrying about lost changes from the Emacs tree. The effect of this is that as hacker, you should generally only have to @@ -314,7 +314,7 @@ tree, and it will show up in the Gnus tree a few days later. If you don't have Emacs bzr access (or it's inconvenient), you can change such a file in the v5-10 branch, and it should propagate to Emacs -bzr -- however, it will get some extra scrutiny (by Miles) to see if the +bzr---however, it will get some extra scrutiny (by Miles) to see if the changes are possibly controversial and need discussion on the mailing list. Many changes are obvious bug-fixes however, so often there won't be any problem. @@ -329,7 +329,7 @@ including improvements on the documentation. If you know that there will be conflicts (perhaps because the affected source code is different in v5-10 and the Gnus git trunk), then you can install your change in both places, and when I try to sync them, there -will be a conflict -- however, since in most such cases there would be a +will be a conflict---however, since in most such cases there would be a conflict @emph{anyway}, it's often easier for me to resolve it simply if I see two @samp{identical} changes, and can just choose the proper one, rather than having to actually fix the code. diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index 038b78cced3..adc84f8e7d9 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi @@ -80,7 +80,7 @@ want. This FAQ was maintained by Justin Sheehy until March 2002. He would like to thank Steve Baur and Per Abrahamsen for doing a wonderful -job with this FAQ before him. We would like to do the same - thanks, +job with this FAQ before him. We would like to do the same: thanks, Justin! This version is much nicer than the unofficial hypertext @@ -1038,7 +1038,7 @@ mail groups. Is this a bug? No, that's a matter of design of Gnus, fixing this would mean reimplementation of major parts of Gnus' -back ends. Gnus thinks "highest-article-number - +back ends. Gnus thinks "highest-article-number @minus{} lowest-article-number = total-number-of-articles". This works OK for Usenet groups, but if you delete and move many messages in mail groups, this fails. To cure the diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 142d1194672..2e6e4c040d6 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -11,7 +11,7 @@ @documentencoding UTF-8 @copying -Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1995--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -1296,7 +1296,7 @@ subscribing these groups. variable defaults to @code{gnus-subscribe-alphabetically}. The ``options -n'' format is very simplistic. The syntax above is all -that is supports -- you can force-subscribe hierarchies, or you can +that is supports: you can force-subscribe hierarchies, or you can deny hierarchies, and that's it. @vindex gnus-options-not-subscribe @@ -2139,14 +2139,14 @@ In groups in some news servers, there might be a big gap between a few very old articles that will never be expired and the recent ones. In such a case, the server will return the data like @code{(1 . 30000000)} for the @code{LIST ACTIVE group} command, for example. Even if there -are actually only the articles 1-10 and 29999900-30000000, Gnus doesn't +are actually only the articles 1--10 and 29999900--30000000, Gnus doesn't know it at first and prepares for getting 30000000 articles. However, it will consume hundreds megabytes of memories and might make Emacs get stuck as the case may be. If you use such news servers, set the variable @code{gnus-newsgroup-maximum-articles} to a positive number. The value means that Gnus ignores articles other than this number of the latest ones in every group. For instance, the value 10000 makes Gnus -get only the articles 29990001-30000000 (if the latest article number is +get only the articles 29990001--30000000 (if the latest article number is 30000000 in a group). Note that setting this variable to a number might prevent you from reading very old articles. The default value of the variable @code{gnus-newsgroup-maximum-articles} is @code{nil}, which @@ -3819,7 +3819,7 @@ So, to move a topic to the beginning of the list of topics, just hit @kbd{C-k} on it. This is like the ``cut'' part of cut and paste. Then, move the cursor to the beginning of the buffer (just below the ``Gnus'' topic) and hit @kbd{C-y}. This is like the ``paste'' part of cut and -paste. Like I said -- E-Z. +paste. Like I said---E-Z. You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics. So you can move topics around as well as groups. @@ -13661,7 +13661,7 @@ server. The default value of this variable is @code{("XOVER" @vindex nntp-nov-gap @code{nntp} normally sends just one big request for @acronym{NOV} lines to the server. The server responds with one huge list of lines. However, -if you have read articles 2-5000 in the group, and only want to read +if you have read articles 2--5000 in the group, and only want to read article 1 and 5001, that means that @code{nntp} will fetch 4999 @acronym{NOV} lines that you will not need. This variable says how big a gap between two consecutive articles is allowed to be before the @@ -15932,7 +15932,7 @@ Decode Quoted Readable encoding. If you are a member of a couple of mailing lists, you will sometimes receive two copies of the same mail. This can be quite annoying, so @code{nnmail} checks for and treats any duplicates it might find. To do -this, it keeps a cache of old @code{Message-ID}s--- +this, it keeps a cache of old @code{Message-ID}s: @code{nnmail-message-id-cache-file}, which is @file{~/.nnmail-cache} by default. The approximate maximum number of @code{Message-ID}s stored there is controlled by the @code{nnmail-message-id-cache-length} @@ -16596,8 +16596,8 @@ future. Here are some high and low points on each: @table @code @item nnmbox -UNIX systems have historically had a single, very common, and well- -defined format. All messages arrive in a single @dfn{spool file}, and +UNIX systems have historically had a single, very common, and well-defined +format. All messages arrive in a single @dfn{spool file}, and they are delineated by a line whose regular expression matches @samp{^From_}. (My notational use of @samp{_} is to indicate a space, to make it clear in this instance that this is not the RFC-specified @@ -21144,7 +21144,7 @@ features (inspired by the Google search input language): AND, OR, and NOT are supported, and parentheses can be used to control operator precedence, e.g., (emacs OR xemacs) AND linux. Note that operators must be written with all capital letters to be -recognized. Also preceding a term with a - sign is equivalent to NOT +recognized. Also preceding a term with a @minus{} sign is equivalent to NOT term. @item Automatic AND queries @@ -21192,7 +21192,8 @@ Note that operators must be written with all capital letters to be recognized. @item Required and excluded terms -+ and - can be used to require or exclude terms, e.g., football -american ++ and @minus{} can be used to require or exclude terms, e.g., football +@minus{}american @item Unicode handling The search engine converts all text to utf-8, so searching should work @@ -21329,7 +21330,7 @@ This engine is obsolete. @table @code @item nnir-method-default-engines -Alist of server backend - search engine pairs. The default associations +Alist of pairs of server backends and search engines. The default associations are @example (nnimap . imap) @@ -22544,7 +22545,7 @@ configuration function will use @code{group} as the key. A full list of possible names is listed below. The @dfn{value} (i.e., the @dfn{split}) says how much space each buffer -should occupy. To take the @code{article} split as an example - +should occupy. To take the @code{article} split as an example: @lisp (article (vertical 1.0 (summary 0.25 point) @@ -26321,9 +26322,9 @@ with the information when possible). On the January 31th 2012, Ma Gnus was begun. -If you happen upon a version of Gnus that has a prefixed name -- -``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'', -``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'', ``Ma Gnus'' -- don't +If you happen upon a version of Gnus that has a prefixed name---``(ding) +Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'', +``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'', ``Ma Gnus''---don't panic. Don't let it know that you're frightened. Back away. Slowly. Whatever you do, don't run. Walk away, calmly, until you're out of its reach. Find a proper released version of Gnus and snuggle up to @@ -26470,14 +26471,14 @@ on Son-of-RFC 1036. They have produced a number of drafts proposing various changes to the format of news articles. The Gnus towers will look into implementing the changes when the draft is accepted as an RFC. -@item MIME - RFC 2045-2049 etc +@item MIME---RFC 2045--2049 etc @cindex @acronym{MIME} All the various @acronym{MIME} RFCs are supported. -@item Disposition Notifications - RFC 2298 +@item Disposition Notifications---RFC 2298 Message Mode is able to request notifications from the receiver. -@item PGP - RFC 1991 and RFC 2440 +@item PGP---RFC 1991 and RFC 2440 @cindex RFC 1991 @cindex RFC 2440 RFC 1991 is the original @acronym{PGP} message specification, @@ -26487,15 +26488,15 @@ non-@acronym{MIME} aware @acronym{PGP} format. Gnus supports both encoding (signing and encryption) and decoding (verification and decryption). -@item PGP/MIME - RFC 2015/3156 +@item PGP/MIME---RFC 2015/3156 RFC 2015 (superseded by 3156 which references RFC 2440 instead of RFC 1991) describes the @acronym{MIME}-wrapping around the RFC 1991/2440 format. Gnus supports both encoding and decoding. -@item S/MIME - RFC 2633 +@item S/MIME---RFC 2633 RFC 2633 describes the @acronym{S/MIME} format. -@item IMAP - RFC 1730/2060, RFC 2195, RFC 2086, RFC 2359, RFC 2595, RFC 1731 +@item IMAP---RFC 1730/2060, RFC 2195, RFC 2086, RFC 2359, RFC 2595, RFC 1731 RFC 1730 is @acronym{IMAP} version 4, updated somewhat by RFC 2060 (@acronym{IMAP} 4 revision 1). RFC 2195 describes CRAM-MD5 authentication for @acronym{IMAP}. RFC 2086 describes access control @@ -26550,7 +26551,7 @@ circles) @dfn{snapshots}. During this phase, Gnus is assumed to be unstable and should not be used by casual users. Gnus alpha releases have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}. -After futzing around for 10-100 alpha releases, Gnus is declared +After futzing around for 10--100 alpha releases, Gnus is declared @dfn{frozen}, and only bug fixes are applied. Gnus loses the prefix, and is called things like ``Gnus 5.10.1'' instead. Normal people are supposed to be able to use these, and these are mostly discussed on the @@ -28137,7 +28138,7 @@ The behavior can be changed by customizing @code{message-insert-canlock}. @item Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC -2015/3156) and @acronym{S/MIME} (RFC 2630-2633). +2015/3156) and @acronym{S/MIME} (RFC 2630--2633). It needs an external @acronym{S/MIME} and OpenPGP implementation, but no additional Lisp libraries. This add several menu items to the @@ -28556,10 +28557,10 @@ know that the server makes wrong @acronym{NOV} data. @item level @cindex levels -Each group is subscribed at some @dfn{level} or other (1-9). The ones +Each group is subscribed at some @dfn{level} or other (1--9). The ones that have a lower level are ``more'' subscribed than the groups with a -higher level. In fact, groups on levels 1-5 are considered -@dfn{subscribed}; 6-7 are @dfn{unsubscribed}; 8 are @dfn{zombies}; and 9 +higher level. In fact, groups on levels 1--5 are considered +@dfn{subscribed}; 6--7 are @dfn{unsubscribed}; 8 are @dfn{zombies}; and 9 are @dfn{killed}. Commands for listing groups and scanning for new articles will all use the numeric prefix as @dfn{working level}. @@ -29135,8 +29136,8 @@ return value. Some back ends could be said to be @dfn{server-forming} back ends, and some might be said not to be. The latter are back ends that generally -only operate on one group at a time, and have no concept of ``server'' ----they have a group, and they deliver info on that group and nothing +only operate on one group at a time, and have no concept of ``server''; +they have a group, and they deliver info on that group and nothing more. Gnus identifies each message by way of group name and article number. A diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 22b444c1a96..c9ada95cd00 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi @@ -22,7 +22,7 @@ Emacs, and interacting with an IDL shell run as a subprocess. This is edition @value{EDITION} of the IDLWAVE User Manual for IDLWAVE @value{VERSION}. -Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -84,9 +84,9 @@ Interactive Data Language (IDL), and running IDL as an inferior shell. Getting Started (Tutorial) -* Lesson I -- Development Cycle:: -* Lesson II -- Customization:: -* Lesson III -- User Catalog:: +* Lesson I---Development Cycle:: +* Lesson II---Customization:: +* Lesson III---User Catalog:: The IDLWAVE Major Mode @@ -263,7 +263,7 @@ had to be renamed because of a name space conflict with CORBA's @code{idl-mode}, defined in Emacs in the file @file{cc-mode.el}. In this manual, each section ends with a list of related user options. -Don't be confused by the sheer number of options available --- in most +Don't be confused by the sheer number of options available: in most cases the default settings are just fine. The variables are listed here to make sure you know where to look if you want to change anything. For a full description of what a particular variable does and how to @@ -372,12 +372,12 @@ at point. @cindex Getting Started @menu -* Lesson I -- Development Cycle:: -* Lesson II -- Customization:: -* Lesson III -- User Catalog:: +* Lesson I---Development Cycle:: +* Lesson II---Customization:: +* Lesson III---User Catalog:: @end menu -@node Lesson I -- Development Cycle, Lesson II -- Customization, Getting Started, Getting Started +@node Lesson I---Development Cycle, Lesson II---Customization, Getting Started, Getting Started @section Lesson I: Development Cycle The purpose of this tutorial is to guide you through a very basic @@ -448,7 +448,7 @@ cursor after the @code{end} statement of the @code{for} loop and press @key{SPC}. IDLWAVE blinks back to the beginning of the block and changes the generic @code{end} to the specific @code{endfor} automatically (as long as the variable @code{idlwave-expand-generic-end} -is turned on --- @pxref{Lesson II -- Customization}). Now place the +is turned on; @pxref{Lesson II---Customization}). Now place the cursor in any line you would like to split and press @kbd{M-@key{RET}}. The line is split at the cursor position, with the continuation @samp{$} and indentation all taken care of. Use @kbd{C-/} to undo the last @@ -504,7 +504,7 @@ Recompile with @kbd{C-c C-d C-c}. Jump back into the shell with @kbd{C-c C-s}, press the @key{UP} arrow to recall the previous command and execute again. -This time we get a plot, but it is pretty ugly --- the points are all +This time we get a plot, but it is pretty ugly: the points are all connected with a line. Hmm, isn't there a way for @code{plot} to use symbols instead? What was that keyword? Position the cursor on the plot line after a comma (where you'd normally type a keyword), and hit @@ -520,7 +520,7 @@ by now: @kbd{C-c C-d C-c}), go back to the shell (if it's vanished, you know what to do: @kbd{C-c C-s}) and execute again. Now things look pretty good. -Let's try a different day --- how about April fool's day? +Let's try a different day. How about April fool's day? @example plot_wday,1,4 @@ -551,14 +551,14 @@ command. Everything should now work fine. How about those leap years? Change the code to plot 100 years and see that every 28 years, the sequence of weekdays repeats. -@node Lesson II -- Customization, Lesson III -- User Catalog, Lesson I -- Development Cycle, Getting Started +@node Lesson II---Customization, Lesson III---User Catalog, Lesson I---Development Cycle, Getting Started @section Lesson II: Customization Emacs is probably the most customizable piece of software ever written, and it would be a shame if you did not make use of this to adapt IDLWAVE to your own preferences. Customizing Emacs or IDLWAVE is accomplished by setting Lisp variables in the @file{.emacs} file in your home -directory --- but do not be dismayed; for the most part, you can just +directory---but do not be dismayed; for the most part, you can just copy and work from the examples given here. Let's first use a boolean variable. These are variables which you turn @@ -635,7 +635,7 @@ breakpoints (try it, it's easier). You can enable this with: @noindent to get compilation on @kbd{S-c}. Often, a modifier key like @key{SUPER} or @key{HYPER} is bound or can be bound to an otherwise -unused key on your keyboard --- consult your system documentation. +unused key on your keyboard; consult your system documentation. You can also assign specific commands to keys. This you must do in the @emph{mode-hook}, a special function which is run when a new IDLWAVE @@ -661,7 +661,7 @@ endless. Here we set function keys f4-f8 to common debugging commands. (local-set-key [f8] 'idlwave-shell-clear-all-bp))) @end lisp -@node Lesson III -- User Catalog, , Lesson II -- Customization, Getting Started +@node Lesson III---User Catalog, , Lesson II---Customization, Getting Started @section Lesson III: User and Library Catalogs We have already used the routine info display in the first part of this @@ -684,7 +684,7 @@ Directories} from the IDLWAVE entry in the menu bar. If necessary, start the shell first with @kbd{C-c C-s} (@pxref{Starting the Shell}). IDLWAVE will find out about the IDL @code{!PATH} variable and offer a list of directories on the path. Simply select them all (or whichever -you want --- directories with existing library catalogs will not be +you want; directories with existing library catalogs will not be selected by default) and click on the @samp{Scan&Save} button. Then go for a cup of coffee while IDLWAVE collects information for each and every IDL routine on your search path. All this information is @@ -1251,8 +1251,8 @@ For IDL system routines, extensive documentation is supplied with IDL@. IDLWAVE can access the HTML version of this documentation very quickly and accurately, based on the local context. This can be @emph{much} faster than using the IDL online help application, because IDLWAVE -usually gets you to the right place in the documentation directly --- -e.g., a specific keyword of a routine --- without any additional browsing +usually gets you to the right place in the documentation directly---e.g., +a specific keyword of a routine---without any additional browsing and scrolling. For this online help to work, an HTML version of the IDL documentation @@ -1525,7 +1525,7 @@ IDLWAVE offers completion for class names, routine names, keywords, system variables, system variable tags, class structure tags, regular structure tags and file names. As in many programming modes, completion is bound to @kbd{M-@key{TAB}} (or simply @kbd{@key{TAB}} in the IDLWAVE -Shell --- @pxref{Using the Shell}). Completion uses exactly the same +Shell; @pxref{Using the Shell}). Completion uses exactly the same internal information as routine info, so when necessary (rarely) it can be updated with @kbd{C-c C-i} (@code{idlwave-update-routine-info}). @@ -1581,7 +1581,7 @@ text. @cindex Completion, canceling @cindex Canceling completion -Completion is not a blocking operation --- you are free to continue +Completion is not a blocking operation; you are free to continue editing, enter commands, or simply ignore the @file{*Completions*} buffer during a completion operation. If, however, the most recent command was a completion, @kbd{C-g} will remove the buffer and restore @@ -1898,7 +1898,7 @@ used to insert code templates all start with a @samp{\} (the backslash), or, optionally, any other character set in @code{idlwave-abbrev-start-char}. IDLWAVE ensures that abbreviations are only expanded where they should be (i.e., not in a string or comment), -and permits the point to be moved after an abbreviation expansion --- +and permits the point to be moved after an abbreviation expansion: very useful for positioning the mark inside of parentheses, etc. Special abbreviations are pre-defined for code templates and other @@ -2377,7 +2377,7 @@ interactively, to compile and run IDL programs in Emacs buffers and to debug these programs. The IDLWAVE shell is built on @file{comint}, an Emacs packages which handles the communication with the IDL program. Unfortunately, IDL for Windows does not have command-prompt versions and -thus do not allow the interaction with Emacs --- so the IDLWAVE shell +thus do not allow the interaction with Emacs, so the IDLWAVE shell currently only works under Unix and MacOSX. @menu @@ -2735,8 +2735,8 @@ the prefix key @kbd{C-c C-d}, so, for example, setting a breakpoint is done with @kbd{C-c C-d C-b}, and compiling a source file with @kbd{C-c C-d C-c}. You can also easily configure IDLWAVE to use one or more modifier keys not in use by other commands, in lieu of the prefix -@kbd{C-c C-d} (though these bindings will typically also be available ---- see @code{idlwave-shell-activate-prefix-keybindings}). For +@kbd{C-c C-d} (though these bindings will typically also be available; +see @code{idlwave-shell-activate-prefix-keybindings}). For example, if you include in @file{.emacs}: @lisp @@ -2749,9 +2749,9 @@ source file will be on @kbd{C-S-c}, deleting a breakpoint @kbd{C-S-d}, etc. In the remainder of this chapter we will assume that the @kbd{C-c C-d} bindings are active, but each of these bindings will have an equivalent shortcut if modifiers are given in the -@code{idlwave-shell-debug-modifiers} variable (@pxref{Lesson II -- -Customization}). A much simpler and faster form of debugging for -running code is also available by default --- see @ref{Electric Debug +@code{idlwave-shell-debug-modifiers} variable (@pxref{Lesson +II---Customization}). A much simpler and faster form of debugging for +running code is also available by default; see @ref{Electric Debug Mode}. @defopt idlwave-shell-prefix-key (@kbd{C-c C-d}) @@ -2787,7 +2787,7 @@ prefix arg of 1 (i.e., @kbd{C-1 C-c C-d C-b}), the breakpoint gets a With a numeric prefix greater than one (e.g., @kbd{C-4 C-c C-d C-b}), the breakpoint will only be active the @code{nth} time it is hit. With a single non-numeric prefix (i.e., @kbd{C-u C-c C-d C-b}), prompt -for a condition --- an IDL expression to be evaluated and trigger the +for a condition: an IDL expression to be evaluated and trigger the breakpoint only if true. To clear the breakpoint in the current line, use @kbd{C-c C-d C-d} (@code{idlwave-clear-current-bp}). When executed from the shell window, the breakpoint where IDL is currently @@ -3118,10 +3118,10 @@ time (as long as the shell is running), and are very useful when execution is stopped in a buffer due to a triggered breakpoint or error, or while composing a long command in the IDLWAVE shell. In the latter case, the command is sent to the shell and its output is visible, but -point remains unmoved in the command being composed --- you can inspect +point remains unmoved in the command being composed: you can inspect the constituents of a command you're building without interrupting the process of building it! You can even print arbitrary expressions from -older input or output further up in the shell window --- any expression, +older input or output further up in the shell window; any expression, variable, number, or function you see can be examined. If the variable @code{idlwave-shell-separate-examine-output} is @@ -3505,7 +3505,7 @@ Starting with version 5.0, there are two types of catalogs available with IDLWAVE@. The traditional @emph{user catalog} and the newer @emph{library catalogs}. Although they can be used interchangeably, the library catalogs are more flexible, and preferred. There are few -occasions when a user catalog might be preferred --- read below. Both +occasions when a user catalog might be preferred---read below. Both types of catalogs can coexist without causing problems. To facilitate the catalog systems, IDLWAVE stores information it gathers @@ -3563,7 +3563,7 @@ Library catalogs consist of files named @file{.idlwave_catalog} stored in directories containing @code{.pro} routine files. They are discovered on the IDL search path and loaded automatically when routine information is read. Each catalog file documents the routines found in -that directory --- one catalog per directory. Every catalog has a +that directory---one catalog per directory. Every catalog has a library name associated with it (e.g., @emph{AstroLib}). This name will be shown briefly when the catalog is found, and in the routine info of routines it documents. @@ -4061,7 +4061,7 @@ system. I am assuming that IDLWAVE has been installed in @end lisp -@noindent Furthermore, Windows sometimes tries to outsmart you --- make +@noindent Furthermore, Windows sometimes tries to outsmart you; make sure you check the following things: @itemize @bullet diff --git a/doc/misc/info.texi b/doc/misc/info.texi index aec80522772..9914aa37d19 100644 --- a/doc/misc/info.texi +++ b/doc/misc/info.texi @@ -14,7 +14,7 @@ This file describes how to use Info, the on-line, menu-driven GNU documentation system. -Copyright @copyright{} 1989, 1992, 1996-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1989, 1992, 1996--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/mairix-el.texi b/doc/misc/mairix-el.texi index 990bb87ae5c..b4515cf64f5 100644 --- a/doc/misc/mairix-el.texi +++ b/doc/misc/mairix-el.texi @@ -6,7 +6,7 @@ @documentencoding ISO-8859-1 @copying -Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2008--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -27,7 +27,7 @@ modify this GNU manual.'' @end direntry @titlepage -@title mairix.el - Mairix interface for Emacs +@title mairix.el---Mairix interface for Emacs @author David Engster @page @@ -38,7 +38,7 @@ modify this GNU manual.'' @contents @node Top -@top mairix.el - Mairix interface for Emacs +@top mairix.el---Mairix interface for Emacs Mairix is a tool for indexing and searching words in locally stored mail. It was written by Richard Curnow and is licensed under the diff --git a/doc/misc/message.texi b/doc/misc/message.texi index cbeac404000..0f8a383377e 100644 --- a/doc/misc/message.texi +++ b/doc/misc/message.texi @@ -10,7 +10,7 @@ @copying This file documents Message, the Emacs message composition mode. -Copyright @copyright{} 1996-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1996--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -476,7 +476,7 @@ You can use one or more of the above variables. All their values are Now you are all set. Just start composing a message as you normally do. And just send it; as always. Just before the message is sent out, Gnus' MFT generation thingy kicks in and checks if the message already has a -MFT field. If there is one, it is left alone. (Except if it's empty - +MFT field. If there is one, it is left alone. (Except if it's empty; in that case, the field is removed and is not replaced with an automatically generated one. This lets you disable MFT generation on a per-message basis.) If there is none, then the list of recipient @@ -2206,12 +2206,12 @@ This function won't add the header if the header is already present. @item message-send-mail-hook @vindex message-send-mail-hook -Hook run before sending mail messages. This hook is run very late -- +Hook run before sending mail messages. This hook is run very late: just before the message is actually sent as mail. @item message-send-news-hook @vindex message-send-news-hook -Hook run before sending news messages. This hook is run very late -- +Hook run before sending news messages. This hook is run very late: just before the message is actually sent as news. @item message-sent-hook diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi index 353f45d7411..7e4cc2fa6f6 100644 --- a/doc/misc/mh-e.texi +++ b/doc/misc/mh-e.texi @@ -24,7 +24,8 @@ This is version @value{VERSION}@value{EDITION} of @cite{The MH-E Manual}, last updated @value{UPDATED}. -Copyright @copyright{} 1995, 2001-2003, 2005-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1995, 2001--2003, 2005--2012 Free Software +Foundation, Inc. @c This dual license has been agreed upon by the FSF. @@ -214,7 +215,7 @@ The MH-E package is distributed with Emacs@footnote{Version @value{VERSION} of MH-E appeared in Emacs 24.1. It is supported in GNU Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is known not to work with GNU Emacs versions 20 and below, and XEmacs -version 21.5.9 - 21.5.16. It is compatible with MH versions 6.8.4 and +version 21.5.9--21.5.16. It is compatible with MH versions 6.8.4 and higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you shouldn't have to do anything special to use it. Gnus is also required; version 5.10 or higher is recommended. This manual covers @@ -5644,7 +5645,7 @@ The command @kbd{C-c C-w} (@code{mh-check-whom}) expands aliases so you can check the actual address(es) in the alias. A new buffer named @samp{*MH-E Recipients*} is created with the output of @command{whom} (@pxref{Miscellaneous})@footnote{See the section -@uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now? -- and the +@uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now?---and the whatnow Program} in the MH book.}. @node Sending Message, Killing Draft, Checking Recipients, Editing Drafts @@ -7714,7 +7715,7 @@ all of your interesting messages and add a couple of points to be conservative. Add that many dots to the @samp{X-Spam-Level:} header field above to send messages with that score down the drain. -In the example above, messages with a score of 5-9 are set aside in +In the example above, messages with a score of 5--9 are set aside in the @samp{+spam} folder for later review. The major weakness of rules-based filters is a plethora of false positives so it is worthwhile to check. @@ -8616,7 +8617,7 @@ In order to send mail within Gnus using MH-E, set this option to Since Gnus keeps track of which messages you have read, it would be bad if Gnus expired the last message, for example, message 100, and @command{rcvstore} gave the next new message number 1. Gnus would then -ignore it since it thinks that you've read messages 1-100. Turning on +ignore it since it thinks that you've read messages 1--100. Turning on this option ensures that the last message is never removed thereby eliminating this problem. @end vtable @@ -8833,7 +8834,7 @@ same structure as MH-E (i.e., invoked MH programs), though it was simpler and the commands were slightly different. Unfortunately, I no longer have a copy so the differences are lost in the mists of time. -In '82-83, I was working at BBN and wrote a lot of mlisp code in +In '82--83, I was working at BBN and wrote a lot of mlisp code in Gosling Emacs to make it look more like Tennex Emacs. One of the packages that I picked up and improved was Reid's mail system. In '83, I went back to Berkeley. About that time, Stallman's first version of diff --git a/doc/misc/newsticker.texi b/doc/misc/newsticker.texi index 480fb648957..56702502f92 100644 --- a/doc/misc/newsticker.texi +++ b/doc/misc/newsticker.texi @@ -13,7 +13,7 @@ This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}). @noindent -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,7 +34,7 @@ modify this GNU manual.'' @end direntry @titlepage -@title Newsticker -- a Newsticker for Emacs +@title Newsticker---a Newsticker for Emacs @subtitle for version @value{VERSION}, @value{UPDATED} @author Ulf Jasper @author @email{ulf.jasper@@web.de} @@ -131,8 +131,8 @@ which contains @file{xml.el} for XEmacs. Newsticker retrieves headlines either via Emacs's built-in retrieval functions, by an arbitrary external program that retrieves files via http and prints them to stdout (like -@uref{http://www.gnu.org/software/wget/wget.html, wget}, or -- on a -per feed basis -- via an arbitrary Lisp command. +@uref{http://www.gnu.org/software/wget/wget.html, wget}, or---on a +per feed basis---via an arbitrary Lisp command. @node Installation diff --git a/doc/misc/nxml-mode.texi b/doc/misc/nxml-mode.texi index 0bac8d3ad31..74971ae9e3d 100644 --- a/doc/misc/nxml-mode.texi +++ b/doc/misc/nxml-mode.texi @@ -8,7 +8,7 @@ This manual documents nXML mode, an Emacs major mode for editing XML with RELAX NG support. -Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2007--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 3dc98f66d2b..b5e93d74fdb 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi @@ -262,7 +262,7 @@ @copying This manual is for Org version @value{VERSION}. -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 @@ -984,7 +984,7 @@ default. If you are using an earlier version of Emacs, add this line to your (add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode)) @end lisp -Org mode buffers need font-lock to be turned on - this is the default in +Org mode buffers need font-lock to be turned on: this is the default in Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer with @code{(add-hook 'org-mode-hook 'turn-on-font-lock)}}. @@ -2685,7 +2685,7 @@ computations in Lisp: '(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2)) @r{Add columns 1 and 2, equivalent to Calc's @code{$1+$2}} '(+ $1 $2);N -@r{Compute the sum of columns 1-4, like Calc's @code{vsum($1..$4)}} +@r{Compute the sum of columns 1--4, like Calc's @code{vsum($1..$4)}} '(apply '+ '($1..$4));N @end example @@ -3374,7 +3374,7 @@ buffer: For Org files, if there is a @samp{<<target>>} at the cursor, the link points to the target. Otherwise it points to the current headline, which will also be the description@footnote{If the headline contains a timestamp, it will be -removed from the link and result in a wrong link -- you should avoid putting +removed from the link and result in a wrong link---you should avoid putting timestamp in the headline.}. @vindex org-link-to-org-use-id @@ -5236,8 +5236,8 @@ same summary information. The @code{est+} summary type requires further explanation. It is used for combining estimates, expressed as low-high ranges. For example, instead of estimating a particular task will take 5 days, you might estimate it as -5-6 days if you're fairly confident you know how much work is required, or -1-10 days if you don't really know what needs to be done. Both ranges +5--6 days if you're fairly confident you know how much work is required, or +1--10 days if you don't really know what needs to be done. Both ranges average at 5.5 days, but the first represents a more predictable delivery. When combining a set of such estimates, simply adding the lows and highs @@ -5247,7 +5247,7 @@ from the sum. For example, suppose you had ten tasks, each of which was estimated at 0.5 to 2 days of work. Straight addition produces an estimate of 5 to 20 days, representing what to expect if everything goes either extremely well or extremely poorly. In contrast, @code{est+} estimates the -full job more realistically, at 10-15 days. +full job more realistically, at 10--15 days. Here is an example for a complete columns definition, along with allowed values. @@ -6539,7 +6539,7 @@ suggestion.} for capturing new material. @table @kbd @orgcmd{C-c c,org-capture} Call the command @code{org-capture}. Note that this keybinding is global and -not active by default - you need to install it. If you have templates +not active by default; you need to install it. If you have templates @cindex date tree defined @pxref{Capture templates}, it will offer these templates for selection or use a new Org outline node as the default template. It will @@ -8117,7 +8117,7 @@ February 1st, @kbd{9 w} to ISO week number 9. When setting day, week, or month view, a year may be encoded in the prefix argument as well. For example, @kbd{200712 w} will jump to week 12 in 2007. If such a year specification has only one or two digits, it will be mapped to the interval -1938-2037. @kbd{v @key{SPC}} will reset to what is set in +1938--2037. @kbd{v @key{SPC}} will reset to what is set in @code{org-agenda-span}. @c @orgcmd{f,org-agenda-later} @@ -8276,7 +8276,7 @@ You can then filter for an effort by first typing an operator, one of @kbd{<}, @kbd{>}, and @kbd{=}, and then the one-digit index of an effort estimate in your array of allowed values, where @kbd{0} means the 10th value. The filter will then restrict to entries with effort smaller-or-equal, equal, -or larger-or-equal than the selected value. If the digits 0-9 are not used +or larger-or-equal than the selected value. If the digits 0--9 are not used as fast access keys to tags, you can also simply press the index digit directly without an operator. In this case, @kbd{<} will be assumed. For application of the operator, entries without a defined effort will be treated @@ -8334,7 +8334,7 @@ selected. @tsubheading{Remote editing} @cindex remote editing, from agenda -@item 0-9 +@item 0--9 Digit argument. @c @cindex undoing remote-editing events @@ -11148,7 +11148,7 @@ files directly, or generate the required styles using an application like LibreOffice. The latter method is suitable for expert and non-expert users alike, and is described here. -@subsubsection Applying custom styles - the easy way +@subsubsection Applying custom styles: the easy way @enumerate @item @@ -11161,8 +11161,8 @@ to ODT format. @item Open the above @file{example.odt} using LibreOffice. Use the @file{Stylist} -to locate the target styles - these typically have the @samp{Org} prefix - -and modify those to your taste. Save the modified file either as an +to locate the target styles---these typically have the @samp{Org} prefix---and +modify those to your taste. Save the modified file either as an OpenDocument Text (@file{.odt}) or OpenDocument Template (@file{.ott}) file. @item @@ -11215,8 +11215,8 @@ with a cross-reference and sequence number of the labeled entity. @cindex tables, in DocBook export Export of native Org mode tables (@pxref{Tables}) and simple @file{table.el} -tables is supported. However, export of complex @file{table.el} tables - -tables that have column or row spans - is not supported. Such tables are +tables is supported. However, export of complex @file{table.el} tables---tables +that have column or row spans---is not supported. Such tables are stripped from the exported document. By default, a table is exported with top and bottom frames and with rules @@ -11348,7 +11348,7 @@ height:width ratio, do the following @cindex #+ATTR_ODT You can control the manner in which an image is anchored by setting the @code{:anchor} property of it's @code{#+ATTR_ODT} line. You can specify one -of the the following three values for the @code{:anchor} property - +of the the following three values for the @code{:anchor} property: @samp{"as-char"}, @samp{"paragraph"} and @samp{"page"}. To create an image that is anchored to a page, do the following: @@ -11454,8 +11454,8 @@ or @node Labels and captions in ODT export, Literal examples in ODT export, Math formatting in ODT export, OpenDocument Text export @subsection Labels and captions in ODT export -You can label and caption various category of objects - an inline image, a -table, a @LaTeX{} fragment or a Math formula - using @code{#+LABEL} and +You can label and caption various category of objects---an inline image, a +table, a @LaTeX{} fragment or a Math formula---using @code{#+LABEL} and @code{#+CAPTION} lines. @xref{Images and tables}. ODT exporter enumerates each labeled or captioned object of a given category separately. As a result, each such object is assigned a sequence number based on order of it's @@ -11619,8 +11619,8 @@ the exporter. @item It contains @samp{<text:sequence-decl>}@dots{}@samp{</text:sequence-decl>} -elements that control how various entities - tables, images, equations etc - -are numbered. +elements that control how various entities---tables, images, equations, +etc.---are numbered. @end enumerate @end itemize @@ -11754,7 +11754,7 @@ OpenDocument-v1.2 Specification}} -@subsubheading Custom table styles - an illustration +@subsubheading Custom table styles: an illustration To have a quick preview of this feature, install the below setting and export the table that follows. @@ -11786,7 +11786,7 @@ Template} in @file{OrgOdtContentTemplate.xml} (@pxref{x-orgodtcontenttemplate-xml,,Factory styles}). If you need additional templates you have to define these styles yourselves. -@subsubheading Custom table styles - the nitty-gritty +@subsubheading Custom table styles: the nitty-gritty To use this feature proceed as follows: @enumerate @@ -14800,7 +14800,7 @@ These lines (several are allowed) specify link abbreviations. @vindex org-lowest-priority @vindex org-default-priority This line sets the limits and the default for the priorities. All three -must be either letters A-Z or numbers 0-9. The highest priority must +must be either letters A--Z or numbers 0--9. The highest priority must have a lower ASCII number than the lowest priority. @item #+PROPERTY: Property_Name Value This line sets a default inheritance value for entries in the current @@ -15104,7 +15104,7 @@ indentation shifts by two@footnote{See the variable stars but the last one are made invisible using the @code{org-hide} face@footnote{Turning on @code{org-indent-mode} sets @code{org-hide-leading-stars} to @code{t} and @code{org-adapt-indentation} to -@code{nil}.} - see below under @samp{2.} for more information on how this +@code{nil}.}; see below under @samp{2.} for more information on how this works. You can turn on @code{org-indent-mode} for all files by customizing the variable @code{org-startup-indented}, or you can turn it on for individual files using @@ -16713,7 +16713,7 @@ a great help, and the list would not be so active without him. @end table I received support from so many users that it is clearly impossible to be -fair when shortlisting a few of them -- but Org's history would not be +fair when shortlisting a few of them, but Org's history would not be complete if the ones above were not mentioned in this manual. @section List of contributions diff --git a/doc/misc/pcl-cvs.texi b/doc/misc/pcl-cvs.texi index 6ce746c9be0..f55fb2cb3bc 100644 --- a/doc/misc/pcl-cvs.texi +++ b/doc/misc/pcl-cvs.texi @@ -1,12 +1,12 @@ \input texinfo @c -*-texinfo-*- @c %**start of header @setfilename ../../info/pcl-cvs -@settitle PCL-CVS --- Emacs Front-End to CVS +@settitle PCL-CVS---Emacs Front-End to CVS @syncodeindex vr fn @c %**end of header @copying -Copyright @copyright{} 1991-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1991--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -34,7 +34,7 @@ modify this GNU manual.'' @sp @center @titlefont{to} @sp -@center @titlefont{PCL-CVS --- The Emacs Front-End to CVS} +@center @titlefont{PCL-CVS---The Emacs Front-End to CVS} @ignore @sp 2 @center release 2.9 diff --git a/doc/misc/pgg.texi b/doc/misc/pgg.texi index 70d1d371088..d8da8276817 100644 --- a/doc/misc/pgg.texi +++ b/doc/misc/pgg.texi @@ -11,7 +11,7 @@ This file describes PGG @value{VERSION}, an Emacs interface to various PGP implementations. -Copyright @copyright{} 2001, 2003-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2001, 2003--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/rcirc.texi b/doc/misc/rcirc.texi index ffdb0268f7d..c2ed68a0be0 100644 --- a/doc/misc/rcirc.texi +++ b/doc/misc/rcirc.texi @@ -5,7 +5,7 @@ @c %**end of header @copying -Copyright @copyright{} 2006-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2006--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -898,7 +898,7 @@ client doesn't realize that it has been disconnected. It takes several minutes until the client decides that the connection has in fact been lost. The simple solution is to use @kbd{M-x rcirc}. The problem is that this opens an @emph{additional} connection, so you'll have two -copies of every channel buffer --- one dead and one live. +copies of every channel buffer, one dead and one live. The real answer, therefore, is a @code{/reconnect} command: diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index 40cce472eed..f9f0fab9e4a 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi @@ -45,7 +45,7 @@ This manual documents @RefTeX{} (version @value{VERSION}), a package to do labels, references, citations and indices for LaTeX documents with Emacs. -Copyright @copyright{} 1997-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1997--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -609,7 +609,7 @@ Promote the current section. This will convert @code{\section} to @code{\chapter}, @code{\subsection} to @code{\section} etc. If there is an active region, all sections in the region will be promoted, including the one at point. To avoid mistakes, @RefTeX{} requires a fresh -document scan before executing this command -- if necessary, it will +document scan before executing this command; if necessary, it will automatically do this scan and ask the user to repeat the promotion command. @@ -625,7 +625,7 @@ useful when a package like @file{fancyref} is used where the label prefix determines the wording of a reference. After a promotion/demotion it may be necessary to change a few labels from @samp{sec:xyz} to @samp{cha:xyz} or vice versa. This command can be -used to do this - it launches a query replace to rename the definition +used to do this; it launches a query replace to rename the definition and all references of a label. @tablesubheading{Exiting} @@ -787,7 +787,7 @@ records the figure counter, not the section counter. Several different environments can share a common counter and therefore a common label category. For example labels in both @code{equation} and -@code{eqnarray} environments record the value of the same counter -- the +@code{eqnarray} environments record the value of the same counter: the equation counter. @menu @@ -1448,8 +1448,8 @@ The empty pairs of brackets indicate the different arguments of the indicates that this is a figure label which will be listed together with labels from normal figure environments. The @code{nil} entries for prefix and reference format mean to use the defaults for figure labels. -The @samp{3} for the context method means to grab the third macro argument --- the caption. +The @samp{3} for the context method means to grab the third macro argument: +the caption. As a side effect of this configuration, @code{reftex-label} will now insert the required naked label (without the @code{\label} macro) when @@ -1518,7 +1518,7 @@ following is equivalent to the line above. @end lisp Note that this is automatically done by the @file{amsmath.el} style file -of @AUCTeX{} (@pxref{Style Files}) -- so if you use @AUCTeX{}, +of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{}, this configuration will not be necessary. @node Non-Standard Environments, Putting it Together, Using \eqref, Defining Label Environments @@ -1743,7 +1743,7 @@ package where a macro call like @code{\fref@{@var{fig:map-of-germany}@}} creates not only the number of the referenced counter but also the complete text around it, like @samp{Figure 3 on the preceding page}. In order to make it work you need to use label prefixes like @samp{fig:} -consistently -- something @RefTeX{} does automatically. For each of +consistently---something @RefTeX{} does automatically. For each of these packages a variable could be configured to make its macros to take precedence over @code{\ref}. Those were @code{reftex-vref-is-default} and @code{reftex-fref-is-default} respectively. While still working, @@ -2284,7 +2284,7 @@ format. A phrase line looks like this: @code{<TABs>} stands for white space containing at least one @key{TAB}. @var{key} must be at the start of the line and is the character identifying one of the macros defined in the file header. It is -optional - when omitted, the first macro definition line in the file +optional; when omitted, the first macro definition line in the file will be used for this phrase. The @var{phrase} is the phrase to be searched for when indexing. It may contain several words separated by spaces. By default the search phrase is also the text entered as @@ -2330,7 +2330,7 @@ and will therefore create two different index entries. @kindex C-c C-s Before indexing the phrases in the phrases buffer, they should be checked carefully for consistency. A first step is to sort the phrases -alphabetically - this is done with the command @kbd{C-c C-s} +alphabetically; this is done with the command @kbd{C-c C-s} (@code{reftex-index-sort-phrases}). It will sort all phrases in the buffer alphabetically by search phrase. If you want to group certain phrases and only sort within the groups, insert empty lines between the @@ -2678,7 +2678,7 @@ unique. @code{?i}, @code{?I}, and @code{?g} are reserved for the respectively. The following string is empty unless your macro adds a superordinate -entry to the index key - this is the case for the @code{\astobj} macro. +entry to the index key; this is the case for the @code{\astobj} macro. The next entry can be a hook function to exclude certain matches, it almost always can be @code{nil}. @@ -3740,8 +3740,8 @@ library which is part of @AUCTeX{}, the string is first processed with the @deffn Command reftex-index-phrase-selection-or-word Add current selection or the word at point to the phrases buffer. When you are in transient-mark-mode and the region is active, the -selection will be used - otherwise the word at point. -You get a chance to edit the entry in the phrases buffer - to save the +selection will be used; otherwise the word at point. +You get a chance to edit the entry in the phrases buffer; to save the buffer and return to the @LaTeX{} document, finish with @kbd{C-c C-c}. @end deffn @@ -3881,7 +3881,7 @@ removes the parse file associated with the current document. @cindex Options, list of Here is a complete list of @RefTeX{}'s configuration variables. All -variables have customize support - so if you are not familiar with Emacs +variables have customize support, so if you are not familiar with Emacs Lisp (and even if you are) you might find it more comfortable to use @code{customize} to look at and change these variables. @kbd{M-x reftex-customize} will get you there. @@ -4061,7 +4061,7 @@ Name of the environment (like @samp{table}) or macro (like @samp{\myfig}). For macros, indicate the arguments, as in @samp{\myfig[]@{@}@{@}@{*@}@{@}}. Use square brackets for optional arguments, a star to mark the label argument, if any. The macro does -not have to have a label argument - you could also use +not have to have a label argument; you could also use @samp{\label@{...@}} inside one of its arguments. Special names: @code{section} for section labels, @code{any} to define a @@ -4215,7 +4215,7 @@ names like @samp{chapter}, integer section levels (as given in @defopt reftex-default-context-regexps Alist with default regular expressions for finding context. The emacs lisp form @w{@code{(format regexp (regexp-quote environment))}} is used -to calculate the final regular expression - so @samp{%s} will be +to calculate the final regular expression, so @samp{%s} will be replaced with the environment or macro. @end defopt @@ -4404,7 +4404,7 @@ The available label types are: @code{s} (section), @code{f} (figure), @code{t} (table), @code{i} (item), @code{e} (equation), @code{n} (footnote), plus any definitions in @code{reftex-label-alist}. -Most options can also be switched from the label menu itself - so if you +Most options can also be switched from the label menu itself, so if you decide here to not have a table of contents in the label menu, you can still get one interactively during selection from the label menu. @end defopt @@ -4462,7 +4462,7 @@ Non-@code{nil} means, @code{reftex-reference} will try to guess the label type. To do that, @RefTeX{} will look at the word before the cursor and compare it with the magic words given in @code{reftex-label-alist}. When it finds a match, @RefTeX{} will -immediately offer the correct label menu - otherwise it will prompt you +immediately offer the correct label menu; otherwise it will prompt you for a label type. If you set this variable to @code{nil}, @RefTeX{} will always prompt for a label type. @end defopt @@ -4726,11 +4726,11 @@ The final entry may also be a symbol. It must have an association in the variable @code{reftex-index-macros-builtin} to specify the main indexing package you are using. Valid values are currently @example -default @r{The @LaTeX{} default - unnecessary to specify this one} +default @r{The @LaTeX{} default; unnecessary to specify this one} multind @r{The multind.sty package} index @r{The index.sty package} index-shortcut @r{The index.sty packages with the ^ and _ shortcuts.} - @r{Should not be used - only for old documents} + @r{Should not be used; only for old documents} @end example Note that @AUCTeX{} sets these things internally for @RefTeX{} as well, so with a sufficiently new version of @AUCTeX{}, you should not set the @@ -4741,7 +4741,7 @@ package here. The default index macro for @code{reftex-index-selection-or-word}. This is a list with @code{(@var{macro-key} @var{default-tag})}. -@var{macro-key} is a character identifying an index macro - see +@var{macro-key} is a character identifying an index macro; see @code{reftex-index-macros}. @var{default-tag} is the tag to be used if the macro requires a @@ -4829,7 +4829,7 @@ case, that match will be ignored. @defopt reftex-index-phrases-wrap-long-lines Non-@code{nil} means, when indexing from the phrases buffer, wrap lines. -Inserting indexing commands in a line makes the line longer - often +Inserting indexing commands in a line makes the line longer, often so long that it does not fit onto the screen. When this variable is non-@code{nil}, newlines will be added as necessary before and/or after the indexing command to keep lines short. However, the matched text @@ -5007,7 +5007,7 @@ Non-@code{nil} means, search all specified directories before trying recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./}, then @samp{/tex/}, and then all subdirectories of @samp{./}. If this option is @code{nil}, the subdirectories of @samp{./} are searched -before @samp{/tex/}. This is mainly for speed - most of the time the +before @samp{/tex/}. This is mainly for speed; most of the time the recursive path is for the system files and not for the user files. Set this to @code{nil} if the default makes @RefTeX{} finding files with equal names in wrong sequence. @@ -5128,7 +5128,7 @@ cannot be placed with certainty into the internal label list. @defopt reftex-use-multiple-selection-buffers Non-@code{nil} means use a separate selection buffer for each label type. These buffers are kept from one selection to the next and need -not to be created for each use - so the menu generally comes up faster. +not be created for each use, so the menu generally comes up faster. The selection buffers will be erased (and therefore updated) automatically when new labels in its category are added. See the variable @code{reftex-auto-update-selection-buffers}. diff --git a/doc/misc/remember.texi b/doc/misc/remember.texi index 2faa57b3dc7..af1121a0d10 100644 --- a/doc/misc/remember.texi +++ b/doc/misc/remember.texi @@ -8,7 +8,7 @@ @copying This manual is for Remember Mode, version 1.9 -Copyright @copyright{} 2001, 2004-2005, 2007-2012 +Copyright @copyright{} 2001, 2004--2005, 2007--2012 Free Software Foundation, Inc. @quotation diff --git a/doc/misc/sasl.texi b/doc/misc/sasl.texi index 1d65186c9a5..86ef0e29b77 100644 --- a/doc/misc/sasl.texi +++ b/doc/misc/sasl.texi @@ -10,7 +10,7 @@ @copying This file describes the Emacs SASL library, version @value{VERSION}. -Copyright @copyright{} 2000, 2004-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2000, 2004--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -54,18 +54,18 @@ SASL is a common interface to share several authentication mechanisms between applications using different protocols. @ifnottex -@insertcopying +@insertcopying @end ifnottex @menu * Overview:: What Emacs SASL library is. * How to use:: Adding authentication support to your applications. -* Data types:: +* Data types:: * Back end drivers:: Writing your own drivers. * GNU Free Documentation License:: The license for this documentation. -* Index:: -* Function Index:: -* Variable Index:: +* Index:: +* Function Index:: +* Variable Index:: @end menu @node Overview @@ -106,9 +106,9 @@ security layer---a mechanism, a client parameter and an authentication step. @menu -* Mechanisms:: -* Clients:: -* Steps:: +* Mechanisms:: +* Clients:: +* Steps:: @end menu @node Mechanisms diff --git a/doc/misc/sc.texi b/doc/misc/sc.texi index b1fd5475bd8..95b011cbd7e 100644 --- a/doc/misc/sc.texi +++ b/doc/misc/sc.texi @@ -14,7 +14,7 @@ This document describes Supercite, an Emacs package for citing and attributing replies to mail and news messages. -Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1993, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -1479,7 +1479,7 @@ recognizing specific alternative forms. @vindex sc-cite-frame-alist @vindex sc-uncite-frame-alist @vindex sc-recite-frame-alist -For each of the actions -- citing, unciting, and reciting -- an alist is +For each of the actions---citing, unciting, and reciting---an alist is consulted to find the frame to use (@code{sc-cite-frame-alist}, @code{sc-uncite-frame-alist}, and @code{sc-recite-frame-alist} respectively). These frames can contain alists of the form: diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi index 7d966f29705..d4e3bcaa0b5 100644 --- a/doc/misc/semantic.texi +++ b/doc/misc/semantic.texi @@ -24,7 +24,8 @@ @copying This manual documents the Semantic library and utilities. -Copyright @copyright{} 1999-2005, 2007, 2009-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2005, 2007, 2009--2012 Free Software +Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi index 7b39603f1a5..1d020c876eb 100644 --- a/doc/misc/ses.texi +++ b/doc/misc/ses.texi @@ -11,7 +11,7 @@ @copying This file documents SES: the Simple Emacs Spreadsheet. -Copyright @copyright{} 2002-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2002--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -692,7 +692,7 @@ Export a range of cells as tab-separated values (@code{ses-export-tsv}). Export a range of cells as tab-separated formulas (@code{ses-export-tsf}). @end table -The exported text goes to the kill ring --- you can paste it into +The exported text goes to the kill ring; you can paste it into another buffer. Columns are separated by tabs, rows by newlines. To import text, use any of the yank commands where the text to paste @@ -888,7 +888,7 @@ order to avoid a virus warning. You can define functions by making them values for the fake local variable @code{eval}. Such functions can then be used in your formulas and printers, but usually each @code{eval} is presented to -the user during file loading as a potential virus --- this can get +the user during file loading as a potential virus. This can get annoying. You can define functions in your @file{.emacs} file. Other people can diff --git a/doc/misc/sieve.texi b/doc/misc/sieve.texi index 6d1897cee8f..55e07f75085 100644 --- a/doc/misc/sieve.texi +++ b/doc/misc/sieve.texi @@ -11,7 +11,7 @@ @copying This file documents the Emacs Sieve package, for server-side mail filtering. -Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -212,7 +212,7 @@ Bury the Manage Sieve buffer without closing the connection. @kindex ? @kindex h @findex sieve-help -Displays help in the minibuffer. +Displays help in the minibuffer. @end table diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi index 7b1c7641203..6a2dc505196 100644 --- a/doc/misc/smtpmail.texi +++ b/doc/misc/smtpmail.texi @@ -3,7 +3,7 @@ @settitle Emacs SMTP Library @syncodeindex vr fn @copying -Copyright @copyright{} 2003-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2003--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -70,8 +70,8 @@ not necessarily involve SMTP, however. Here is short overview of what is involved. @cindex MUA - The mail program --- also called a mail user agent (MUA) --- -usually sends outgoing mail to a mail host. When your computer is + The mail program---also called a mail user agent (MUA)---usually +sends outgoing mail to a mail host. When your computer is permanently connected to the internet, it might even be a mail host itself. In this case, the MUA will pipe mail to the @file{/usr/lib/sendmail} application. It will take care of your mail @@ -283,8 +283,8 @@ The variable @code{smtpmail-stream-type} controls what form of connection the SMTP library uses. The default value is @code{nil}, which means to use a plain connection, but try to switch to a STARTTLS encrypted connection if the server supports it. Other possible values -are: @code{starttls} - insist on STARTTLS; @code{ssl} - use TLS/SSL; -and @code{plain} - no encryption. +are: @code{starttls} to insist on STARTTLS; @code{ssl} to use TLS/SSL; +and @code{plain} for encryption. Use of any form of TLS/SSL requires support in Emacs. You can either use the built-in support (in Emacs 24.1 and later), or the diff --git a/doc/misc/speedbar.texi b/doc/misc/speedbar.texi index 70b5e2ad367..ac12d4a65a6 100644 --- a/doc/misc/speedbar.texi +++ b/doc/misc/speedbar.texi @@ -4,7 +4,7 @@ @syncodeindex fn cp @copying -Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -68,7 +68,7 @@ an expanded summary of the entry the expansion button is on. @xref{Basic Navigation}. @ifnottex -@insertcopying +@insertcopying @end ifnottex @menu diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi index 0d1c02cf90f..3000cd0caf8 100644 --- a/doc/misc/srecode.texi +++ b/doc/misc/srecode.texi @@ -15,7 +15,7 @@ @c %**end of header @copying -Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2007--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -463,7 +463,7 @@ show NAME This will enable that section. -NOTE: May 11, 2008 - I haven't used this yet, so I don't know if it works. +NOTE: May 11, 2008: I haven't used this yet, so I don't know if it works. @node Special Variables @@ -575,10 +575,10 @@ macros which will enable different @var{sections}. The automatic section variables are. @itemize @bullet -@item @var{first} - The first entry in the table. -@item @var{notfirst} - Not the first entry in the table. -@item @var{last} - The last entry in the table -@item @var{notlast} - Not the last entry in the table. +@item @var{first}---The first entry in the table. +@item @var{notfirst}---Not the first entry in the table. +@item @var{last}---The last entry in the table +@item @var{notlast}---Not the last entry in the table. @end itemize @node Compound Variable Values @@ -1654,7 +1654,7 @@ This would be a field of the class being inserted into. Inside a body of code, such as a function or method body. - - no conventions yet. + ---no conventions yet. @section Standard Dictionary Values @@ -1778,7 +1778,7 @@ all template files for that application will be loaded. @end defun - todo - Add examples. Most core stuff is already described above. + todo: Add examples. Most core stuff is already described above. @node GNU Free Documentation License diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 0ca5df873fa..670fc03b218 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -37,7 +37,7 @@ @end macro @copying -Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -761,7 +761,7 @@ transferred with the corresponding inline method. It should provide a fair trade-off between both approaches. @table @asis -@item @option{rcp} --- @command{rsh} and @command{rcp} +@item @option{rcp}---@command{rsh} and @command{rcp} @cindex method rcp @cindex rcp method @cindex rcp (with rcp method) @@ -776,7 +776,7 @@ The alternative method @option{remcp} uses the @command{remsh} and @command{remsh} is used instead of @command{rsh}. -@item @option{scp} --- @command{ssh} and @command{scp} +@item @option{scp}---@command{ssh} and @command{scp} @cindex method scp @cindex scp method @cindex scp (with scp method) @@ -806,7 +806,7 @@ specify @samp{-p 42} in the argument list for @command{ssh}, and to specify @samp{-P 42} in the argument list for @command{scp}. -@item @option{sftp} --- @command{ssh} and @command{sftp} +@item @option{sftp}---@command{ssh} and @command{sftp} @cindex method sftp @cindex sftp method @cindex sftp (with sftp method) @@ -822,7 +822,7 @@ within this session. Instead of, @command{ssh} is used for login. This method supports the @samp{-p} argument. -@item @option{rsync} --- @command{ssh} and @command{rsync} +@item @option{rsync}---@command{ssh} and @command{rsync} @cindex method rsync @cindex rsync method @cindex rsync (with rsync method) @@ -843,7 +843,7 @@ the corresponding buffer, visiting this file, is alive. This method supports the @samp{-p} argument. -@item @option{scpx} --- @command{ssh} and @command{scp} +@item @option{scpx}---@command{ssh} and @command{scp} @cindex method scpx @cindex scpx method @cindex scp (with scpx method) @@ -866,7 +866,7 @@ to not print any shell prompt, which confuses @value{tramp} mightily. This method supports the @samp{-p} argument. -@item @option{scpc} --- @command{ssh} and @command{scp} +@item @option{scpc}---@command{ssh} and @command{scp} @cindex method scpc @cindex scpc method @cindex scp (with scpc method) @@ -897,7 +897,7 @@ version, must be set to @option{no}. This method supports the @samp{-p} argument. -@item @option{rsyncc} --- @command{ssh} and @command{rsync} +@item @option{rsyncc}---@command{ssh} and @command{rsync} @cindex method rsyncc @cindex rsyncc method @cindex rsync (with rsyncc method) @@ -911,7 +911,7 @@ which increases performance. This method supports the @samp{-p} argument. -@item @option{pscp} --- @command{plink} and @command{pscp} +@item @option{pscp}---@command{plink} and @command{pscp} @cindex method pscp @cindex pscp method @cindex pscp (with pscp method) @@ -926,7 +926,7 @@ of PuTTY, an SSH implementation for Windows. This method supports the @samp{-P} argument. -@item @option{psftp} --- @command{plink} and @command{psftp} +@item @option{psftp}---@command{plink} and @command{psftp} @cindex method psftp @cindex psftp method @cindex psftp (with psftp method) @@ -941,7 +941,7 @@ part of PuTTY, an SSH implementation for Windows. This method supports the @samp{-P} argument. -@item @option{fcp} --- @command{fsh} and @command{fcp} +@item @option{fcp}---@command{fsh} and @command{fcp} @cindex method fcp @cindex fcp method @cindex fsh (with fcp method) @@ -980,7 +980,7 @@ This works only for unified filenames, see @ref{Issues}. @end ifset -@item @option{smb} --- @command{smbclient} +@item @option{smb}---@command{smbclient} @cindex method smb @cindex smb method @@ -1851,7 +1851,7 @@ but it is not at the end of the buffer. This regular expression is used by @value{tramp} in the same way as @code{shell-prompt-pattern}, to match prompts from the remote shell. This second variable exists because the prompt from the remote shell -might be different from the prompt from a local shell --- after all, +might be different from the prompt from a local shell---after all, the whole point of @value{tramp} is to log in to remote hosts as a different user. The default value of @code{tramp-shell-prompt-pattern} is the same as the default value of @@ -2277,7 +2277,7 @@ This edits the same file, using the fully qualified domain name of the machine. @item @trampfn{, , melancholia, ~/.emacs} -This also edits the same file --- the @file{~} is expanded to your +This also edits the same file; the @file{~} is expanded to your home directory on the remote machine, just like it is locally. @item @trampfn{, , melancholia, ~daniel/.emacs} @@ -2366,13 +2366,13 @@ For the time being, @code{tramp-syntax} can have the following values: @itemize @w{} @ifset emacs -@item @code{ftp} -- That is the default syntax -@item @code{url} -- URL-like syntax +@item @code{ftp}---That is the default syntax +@item @code{url}---URL-like syntax @end ifset @ifset xemacs -@item @code{sep} -- That is the default syntax -@item @code{url} -- URL-like syntax -@item @code{ftp} -- EFS-like syntax +@item @code{sep}---That is the default syntax +@item @code{url}---URL-like syntax +@item @code{ftp}---EFS-like syntax @end ifset @end itemize diff --git a/doc/misc/url.texi b/doc/misc/url.texi index cd8854d8562..b12cd8adddd 100644 --- a/doc/misc/url.texi +++ b/doc/misc/url.texi @@ -20,7 +20,8 @@ @copying This is the manual for the @code{url} Emacs Lisp library. -Copyright @copyright{} 1993-1999, 2002, 2004-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1993--1999, 2002, 2004--2012 Free Software +Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi index d81ae182a13..f977387c414 100644 --- a/doc/misc/vip.texi +++ b/doc/misc/vip.texi @@ -3,7 +3,7 @@ @settitle VIP @copying -Copyright @copyright{} 1987, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1987, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi index 2caad2090f6..1297fdb672b 100644 --- a/doc/misc/viper.texi +++ b/doc/misc/viper.texi @@ -7,7 +7,7 @@ @setfilename ../../info/viper @copying -Copyright @copyright{} 1995-1997, 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1995--1997, 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -75,7 +75,7 @@ Viper, formerly known as VIP-19, was written by Michael Kifer. It is based on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code still comes from those older packages. -Viper is intended to be usable without reading this manual --- the defaults +Viper is intended to be usable without reading this manual; the defaults are set to make Viper as close to Vi as possible. At startup, Viper will try to set the most appropriate default environment for you, based on your familiarity with Emacs. It will also tell you the basic GNU Emacs window @@ -133,8 +133,8 @@ Viper was written by Michael Kifer. It is based on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code still comes from those older packages. -Viper is intended to be usable out of the box, without reading this manual ---- the defaults are set to make Viper as close to Vi as possible. At +Viper is intended to be usable out of the box, without reading this manual; +the defaults are set to make Viper as close to Vi as possible. At startup, Viper will attempt to set the most appropriate default environment for you, based on your familiarity with Emacs. It will also tell you the basic GNU Emacs window management commands to help you start immediately. @@ -446,7 +446,7 @@ doing soon!), you should learn about the meaning of the various keys in those special modes (typing @kbd{C-h m} in a buffer provides help with key bindings for the major mode of that buffer). -If you switch to Vi in Dired or similar modes---no harm is done. It is just +If you switch to Vi in Dired or similar modes, no harm is done. It is just that the special key bindings provided by those modes will be temporarily overshadowed by Viper's bindings. Switching back to Viper's Emacs state will revive the environment provided by the current major mode. @@ -1714,7 +1714,7 @@ If not @code{nil}, search wraps around the end/beginning of buffer. @item viper-search-scroll-threshold 2 If search lands within this many lines of the window top or bottom, the window will be scrolled up or down by about 1/7-th of its size, to reveal -the context. If the value is negative---don't scroll. +the context. If the value is negative, don't scroll. @item viper-tags-file-name "TAGS" The name of the file used as the tag table. @item viper-re-query-replace nil @@ -2785,7 +2785,7 @@ type @kbd{C-x q} (for confirmation) or @kbd{C-u C-x q} (for prompt). For details, @pxref{Keyboard Macro Query,,Customization,emacs,The GNU Emacs Manual} @refill -When the user finishes defining a macro (which is done by typing @kbd{C-x)} --- +When the user finishes defining a macro (which is done by typing @kbd{C-x)}, a departure from Vi), you will be asked whether you want this macro to be global, mode-specific, or buffer-specific. You will also be given a chance to save the macro in your @file{~/.viper} file. @@ -3264,7 +3264,7 @@ inserts them automatically in front of the Ex command. @item <count> $ To the end of line <count> from the cursor. @item <count> ^ -To the first CHAR <count> - 1 lines lower. +To the first CHAR <count> @minus{} 1 lines lower. @item <count> - To the first CHAR <count> lines higher. @item <count> + <cr> @@ -3646,10 +3646,10 @@ Shift <count> lines one shiftwidth to the left. @table @kbd @item <count> r<char> -Replace <count> chars by <char> - no <esc>. +Replace <count> chars by <char>; no <esc>. @item <count> R Overwrite the rest of the line, -appending change @var{count - 1} times. +appending change @var{count} @minus{} 1 times. @item <count> s Substitute <count> chars. @item <count> S @@ -3659,7 +3659,7 @@ Change from begin to endpoint of <count><move>. @item <count> cc Change <count> lines. @item <count> C -The rest of the line and <count> - 1 next lines. +The rest of the line and <count> @minus{} 1 next lines. @item <count> =<move> Reindent the region described by move. @item <count> ~ @@ -3912,7 +3912,7 @@ give file name, status, current line number and relative position.@* At user levels 2 and higher, abort the current command. @item C-c g -Give file name, status, current line number and relative position -- all +Give file name, status, current line number and relative position---all user levels. @item C-l Refresh the screen. @@ -4021,7 +4021,7 @@ Save and kill buffer. @item :x!@: [<file>] @kbd{:w![<file>]} and @kbd{:q}. @item :pre -Preserve the file -- autosave buffers. +Preserve the file---autosave buffers. @item :rec Recover file from autosave. @item :f [<file>] @@ -4253,7 +4253,7 @@ Run the make command in the current directory. @item autoindent @itemx ai @cindex autoindent -autoindent -- In append mode after a <cr> the +autoindent: In append mode after a <cr> the cursor will move directly below the first character on the previous line. This setting affects the current buffer only. @@ -4269,7 +4269,7 @@ Cancel autoindent-global. @item ignorecase @itemx ic @cindex case and searching -ignorecase -- No distinction between upper and lower cases when searching. +ignorecase: No distinction between upper and lower cases when searching. @item noignorecase @itemx noic Cancel ignorecase. @@ -4283,7 +4283,7 @@ Cancel magic. @item readonly @itemx ro @cindex readonly files -readonly -- The file is not to be changed. +readonly: The file is not to be changed. If the user attempts to write to this file, confirmation will be requested. @item noreadonly @itemx noro @@ -4291,18 +4291,18 @@ Cancel readonly. @item shell=<string> @itemx sh=<string> @cindex shell -shell -- The program to be used for shell escapes +shell: The program to be used for shell escapes (default @samp{$SHELL} (default @file{/bin/sh})). @item shiftwidth=<count> @itemx sw=<count> @cindex layout @cindex shifting text -shiftwidth -- Gives the shiftwidth (default 8 positions). +shiftwidth: Gives the shiftwidth (default 8 positions). @item showmatch @itemx sm @cindex paren matching @cindex matching parens -showmatch -- Whenever you append a @kbd{)}, Vi shows +showmatch: Whenever you append a @kbd{)}, Vi shows its match if it's on the same page; also with @kbd{@{} and @kbd{@}}. If there's no match, Vi will beep. @item noshowmatch @@ -4312,7 +4312,7 @@ Cancel showmatch. @itemx ts=<count> @cindex changing tab width @cindex tabbing -tabstop -- The length of a <ht>; warning: this is +tabstop: The length of a <ht>; warning: this is only IN the editor, outside of it <ht>s have their normal length (default 8 positions). This setting affects the current buffer only. @@ -4323,13 +4323,13 @@ Same as `tabstop', but affects all buffers. @itemx wm=<count> @cindex auto fill @cindex word wrap -wrapmargin -- In append mode Vi automatically +wrapmargin: In append mode Vi automatically puts a <lf> whenever there is a <sp> or <ht> within <wm> columns from the right margin. @item wrapscan @itemx ws @cindex searching -wrapscan -- When searching, the end is +wrapscan: When searching, the end is considered @samp{stuck} to the begin of the file. @item nowrapscan @itemx nows diff --git a/doc/misc/widget.texi b/doc/misc/widget.texi index 78048d07c77..d5514fc936c 100644 --- a/doc/misc/widget.texi +++ b/doc/misc/widget.texi @@ -8,7 +8,7 @@ @c %**end of header @copying -Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2000--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index 97eb44e7d9e..c2c52837b97 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi @@ -23,7 +23,7 @@ @c %**end of header @copying -Copyright @copyright{} 1988-1993, 1995, 1998-2004, 2007, 2012 +Copyright @copyright{} 1988--1993, 1995, 1998--2004, 2007, 2012 Free Software Foundation, Inc. @c Since we are both GNU manuals, we do not need to ack each other here. diff --git a/doc/misc/woman.texi b/doc/misc/woman.texi index 574eeb9a16d..d805aa20061 100644 --- a/doc/misc/woman.texi +++ b/doc/misc/woman.texi @@ -18,7 +18,7 @@ This file documents WoMan: A program to browse Unix manual pages `W.O. (without) man'. -Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. +Copyright @copyright{} 2001--2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document |