diff options
Diffstat (limited to 'doc/misc')
33 files changed, 1260 insertions, 1027 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index a71745f6258..d756f4fd0f0 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -39,7 +39,12 @@ * htmlfontify.texi: New file. -2012-12-22 Glenn Morris <rgm@gnu.org> +2013-01-02 Jay Belanger <jay.p.belanger@gmail.com> + + * calc.texi (Free-Form Dates): Expand on the date reading + algorithm. + +2012-12-27 Glenn Morris <rgm@gnu.org> * viper.texi (Rudimentary Changes, Key Bindings, Key Bindings): Avoid some overfull lines. @@ -64,14 +69,42 @@ * Makefile.in (gfdl): New variable. Use throughout where appropriate so that targets depend on doclicense.texi. +2012-12-25 Lars Ingebrigtsen <larsi@gnus.org> + + * gnus.texi (Customizing the IMAP Connection): Mention the other + authenticators. + +2012-12-24 Lars Ingebrigtsen <larsi@gnus.org> + + * gnus.texi (Browse Foreign Server): Document + `gnus-browse-delete-group'. + +2012-12-22 Glenn Morris <rgm@gnu.org> + + * ada-mode.texi, ebrowse.texi, ediff.texi, ert.texi, eshell.texi: + * eudc.texi, idlwave.texi, pcl-cvs.texi, rcirc.texi, reftex.texi: + * remember.texi, ses.texi, speedbar.texi, vip.texi, viper.texi: + * widget.texi, wisent.texi: Nuke hand-written node pointers. + + * Makefile.in (gfdl): New variable. Use throughout where + appropriate so that targets depend on doclicense.texi. + 2012-12-22 Eli Zaretskii <eliz@gnu.org> * makefile.w32-in ($(INFO_TARGETS), $(DVI_TARGETS)): Depend on doclicense.texi. Remove doclicense.texi from all targets that mentioned it explicitly. + ($(infodir)/woman$(INFO_EXT), woman.dvi): Depend on + $(emacsdir)/emacsver.texi. + ($(infodir)/erc$(INFO_EXT), erc.dvi): Don't depend on gpl.texi. 2012-12-21 Glenn Morris <rgm@gnu.org> + * woman.texi (UPDATED, VERSION): Remove in favor of EMACSVER. + Include emacsver.texi. Nuke hand-written node pointers. + * Makefile.in ($(buildinfodir)/woman$(INFO_EXT), woman.dvi, woman.pdf): + Depend on emacsver.texi. + * auth.texi, emacs-gnutls.texi, epa.texi, ert.texi: * gnus-coding.texi, info.texi, nxml-mode.texi, sasl.texi: May as well just include doclicense.texi in everything. @@ -94,17 +127,32 @@ * erc.texi: No need to include gpl in this small manual. -2012-12-14 Glenn Morris <rgm@gnu.org> - * org.texi (copying): Include a copy of the GFDL. (GNU Free Documentation License): New section. -2012-12-13 Bastien Guerry <bzg@gnu.org> +2012-12-21 Bastien Guerry <bzg@gnu.org> * org.texi: Fix typos. +2012-12-16 Paul Eggert <eggert@cs.ucla.edu> + + * calc.texi (ISO 8601): Rename from ISO-8601, + as it's typically spelled without a hyphen. + +2012-12-16 Jay Belanger <jay.p.belanger@gmail.com> + + * calc.texi (ISO-8601): New section. + (Date Formatting Codes): Mention new codes. + (Standard Date Formats): Mention new formats. + +2012-12-14 Michael Albinus <michael.albinus@gmx.de> + + * tramp.texi (External methods): Move `adb' method here. + 2012-12-13 Glenn Morris <rgm@gnu.org> + * cl.texi (Modify Macros, Obsolete Macros): Now letf == cl-letf. + * wisent.texi: Small edits. Set copyright to FSF, update license to GFDL 1.3+. * Makefile.in (INFO_TARGETS, DVI_TARGETS, PDF_TARGETS): Add wisent. @@ -127,7 +175,7 @@ * bovine.texi, wisent.texi: New files, imported from CEDET trunk. -2012-12-12 Glenn Morris <rgm@gnu.org> +2012-12-13 Glenn Morris <rgm@gnu.org> * flymake.texi (Customizable variables, Locating the buildfile): Remove refs to flymake-buildfile-dirs, removed 2007-07-20. (Bug#13148) @@ -140,62 +188,122 @@ * makefile.w32-in (INFO_TARGETS, DVI_TARGETS, clean): Add srecode. ($(infodir)/srecode$(INFO_EXT), srecode.dvi): New targets. -2012-12-12 Eric Ludlam <zappo@gnu.org> +2012-12-13 Eric Ludlam <zappo@gnu.org> * srecode.texi: New file, imported from CEDET trunk. -2012-12-12 Bastien Guerry <bzg@gnu.org> +2012-12-13 Bastien Guerry <bzg@gnu.org> * org.texi (Summary, Code block specific header arguments) (Code block specific header arguments) (Header arguments in function calls, var, noweb) - (Results of evaluation, Code evaluation security): Small - reformatting: add a blank line before some example. + (Results of evaluation, Code evaluation security): + Small reformatting: add a blank line before some example. * org.texi (System-wide header arguments) (Header arguments in Org mode properties, Conflicts) - (Dynamic blocks, Using the mapping API): Fix indendation of - Elisp code examples. + (Dynamic blocks, Using the mapping API): + Fix indentation of Elisp code examples. * org.texi (Comment lines): Fix description of the comment syntax. - * org.texi (Installation): Mention "make test" in the correct - section. + * org.texi (Installation): Mention "make test" in the correct section. + +2012-12-06 Paul Eggert <eggert@cs.ucla.edu> + + * doclicense.texi, gpl.texi: Update to latest version from FSF. + These are just minor editorial changes. -2012-12-02 Michael Albinus <michael.albinus@gmx.de> +2012-12-04 Michael Albinus <michael.albinus@gmx.de> + + * tramp.texi (History): Mention ADB. + (Inline methods): Add `adb' method. + +2012-12-03 Michael Albinus <michael.albinus@gmx.de> * tramp.texi (Top, Obtaining Tramp): Replace CVS by Git. (External methods): Fix typo. -2012-11-30 Glenn Morris <rgm@gnu.org> +2012-12-03 Glenn Morris <rgm@gnu.org> * rcirc.texi (Notices): Fix typo. -2012-11-20 Michael Albinus <michael.albinus@gmx.de> +2012-11-25 Bill Wohler <wohler@newt.com> + + Release MH-E manual version 8.4. + + * mh-e.texi: (VERSION, EDITION, UPDATED, UPDATE-MONTH, Preface): + Update for release 8.4. + + * mh-e.texi (Sequences): Add mh-whitelist-preserves-sequences-flag. + (Junk): Add mh-whitelist-preserves-sequences-flag, + mh-blacklist-msg-hook, mh-whitelist-msg-hook, + mh-folder-blacklisted, mh-folder-whitelisted (closes SF #2945712). + +2012-11-25 Paul Eggert <eggert@cs.ucla.edu> + + * mh-e.texi (Procmail): Fix two @ typos. + +2012-11-24 Paul Eggert <eggert@cs.ucla.edu> + + * doclicense.texi, gpl.texi: Update to latest version from FSF. + These are just minor editorial changes. + +2012-11-23 Jay Belanger <jay.p.belanger@gmail.com> + + * calc.texi (Date Formatting Codes): Mention the new beginning of + the date numbering system. + +2012-11-22 Paul Eggert <eggert@cs.ucla.edu> + + * calc.texi: Fix TeX issues with capitals followed by ".", "?", "!". + (Date Forms): Correct off-by-one error in explanation of + Julian day numbers. Give Gregorian equivalent of its origin. + +2012-11-22 Jay Belanger <jay.p.belanger@gmail.com> + + * doc/misc/calc.texi (Date Forms): Mention the customizable + Gregorian-Julian switch. + (Customizing Calc): Mention the variable `calc-gregorian-switch'. - * trampver.texi: Downgrade version to 2.2.6-24.3, in order to - distinguish from trunk. +2012-11-17 Paul Eggert <eggert@cs.ucla.edu> + + Calc now uses the Gregorian calendar for all dates (Bug#12633). + It also uses January 1, 1 AD as its day number 1. + * calc.texi (Date Forms): Document this. 2012-11-16 Glenn Morris <rgm@gnu.org> * cl.texi (Function Bindings): Clarify that cl-flet is lexical. (Obsolete Macros): Move example here from Function Bindings. -2012-11-13 Glenn Morris <rgm@gnu.org> - * erc.texi: Use @code{nil} rather than just "nil". (Modules): Undocument obsolete "hecomplete". Add "notifications". (Connecting): Add brief section on passwords. (Options): Make a start by adding erc-hide-list, erc-lurker-hide-list. -2012-11-12 Glenn Morris <rgm@gnu.org> +2012-11-13 Glenn Morris <rgm@gnu.org> * flymake.texi (Customizable variables) (Highlighting erroneous lines): Mention flymake-error-bitmap, flymake-warning-bitmap, and flymake-fringe-indicator-position. -2012-11-09 Chong Yidong <cyd@gnu.org> +2012-11-12 Vincent Belaïche <vincentb1@users.sourceforge.net> + + * ses.texi: Doc for ses-rename-cell, ses-repair-cell-reference-all & ses-range. + In all file place SES into @acronym{...}. + (Advanced Features): Add key index and function index for + ses-set-header-row. Add description for function + ses-rename-cell. Add description for function + ses-repair-cell-reference-all. + (Ranges in formulas): Add description for ses-range flags. + +2012-11-12 Paul Eggert <eggert@cs.ucla.edu> + + * texinfo.tex: Merge from gnulib. + +2012-11-10 Chong Yidong <cyd@gnu.org> * url.texi (Introduction): Move url-configuration-directory to Customization node. @@ -206,21 +314,17 @@ Improve docs for url-queue-*. (Supported URL Types): Copyedits. Delete empty subnodes. -2012-11-08 Chong Yidong <cyd@gnu.org> - * url.texi (Introduction): Rename from Getting Started. Rewrite the introduction. (URI Parsing): Rewrite. Omit the obsolete attributes slot. -2012-11-07 Glenn Morris <rgm@gnu.org> +2012-11-10 Glenn Morris <rgm@gnu.org> * cl.texi (Obsolete Setf Customization): Revert defsetf example to the more correct let rather than prog1. Give define-modify-macro, defsetf, and define-setf-method gv.el replacements. -2012-11-06 Glenn Morris <rgm@gnu.org> - * cl.texi (Overview): Mention EIEIO here, as well as the appendix. (Setf Extensions): Remove obsolete reference. (Obsolete Setf Customization): @@ -236,11 +340,13 @@ (Compiler Optimizations): Rename from "Optimizing Compiler"; reword. (Creating Symbols, Random Numbers): De-emphasize internal variables cl--gensym-counter and cl--random-state. (Bug#12788) + (Naming Conventions, Type Predicates, Macros) + (Predicates on Numbers): No longer mention cl-floatp-safe. -2012-11-02 Glenn Morris <rgm@gnu.org> +2012-11-02 Katsumi Yamaoka <yamaoka@jpl.org> - * cl.texi (Naming Conventions, Type Predicates, Macros) - (Predicates on Numbers): No longer mention cl-floatp-safe. + * gnus.texi (Mail Source Specifiers): + Document :leave keyword used for pop mail source. 2012-11-01 Glenn Morris <rgm@gnu.org> diff --git a/doc/misc/Makefile.in b/doc/misc/Makefile.in index dfe633ca68f..3dac35aafee 100644 --- a/doc/misc/Makefile.in +++ b/doc/misc/Makefile.in @@ -27,7 +27,6 @@ srcdir=@srcdir@ ## Where the output files go. buildinfodir = $(srcdir)/../../info ## Directory with emacsver.texi. -## Currently only used by efaq and calc. emacsdir = $(srcdir)/../emacs MKDIR_P = @MKDIR_P@ @@ -699,12 +698,12 @@ wisent.pdf: ${srcdir}/wisent.texi ${gfdl} $(ENVADD) $(TEXI2PDF) ${srcdir}/wisent.texi woman : $(buildinfodir)/woman$(INFO_EXT) -$(buildinfodir)/woman$(INFO_EXT): ${srcdir}/woman.texi ${gfdl} +$(buildinfodir)/woman$(INFO_EXT): ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl} $(mkinfodir) $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/woman.texi -woman.dvi: ${srcdir}/woman.texi ${gfdl} +woman.dvi: ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl} $(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi -woman.pdf: ${srcdir}/woman.texi ${gfdl} +woman.pdf: ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl} $(ENVADD) $(TEXI2PDF) ${srcdir}/woman.texi diff --git a/doc/misc/ada-mode.texi b/doc/misc/ada-mode.texi index c687ce16877..926d6a5749c 100644 --- a/doc/misc/ada-mode.texi +++ b/doc/misc/ada-mode.texi @@ -37,7 +37,7 @@ modify this GNU manual.'' @contents -@node Top, Overview, (dir), (dir) +@node Top @top Ada Mode @ifnottex @@ -64,7 +64,7 @@ modify this GNU manual.'' @end menu -@node Overview, Installation, Top, Top +@node Overview @chapter Overview The Emacs mode for programming in Ada helps the user in understanding @@ -96,7 +96,7 @@ and other GNAT commands. See the Emacs info manual, section 'Running Debuggers Under Emacs', for general information on debugging. -@node Installation, Customization, Overview, Top +@node Installation @chapter Installation Ada mode is part of the standard Emacs distribution; if you use that, @@ -136,7 +136,7 @@ GNAT-specific). @end itemize -@node Customization, Compiling Executing, Installation, Top +@node Customization @chapter Customizing Ada mode Here we assume you are familiar with setting variables in Emacs, @@ -175,7 +175,7 @@ See the Emacs help for each of these variables for more information. * Other customization:: @end menu -@node Non-standard file names, Other compiler, Customization, Customization +@node Non-standard file names @section Non-standard file names By default, Ada mode is configured to use the GNAT file naming @@ -217,7 +217,7 @@ rewrite the function @code{ada-make-filename-from-adaname}. Doing that is beyond the scope of this manual; see the current definitions in @file{ada-mode.el} and @file{ada-xref.el} for examples. -@node Other compiler, Other customization, Non-standard file names, Customization +@node Other compiler @section Other compiler By default, Ada mode is configured to use the Gnu Ada compiler GNAT. @@ -227,7 +227,7 @@ used to run that compiler, either in lisp variables or in Emacs Ada mode project files. See @ref{Project file variables} for the list of project variables, and the corresponding lisp variables. -@node Other customization, , Other compiler, Customization +@node Other customization @section Other customization All user-settable Ada mode variables can be set via the menu @@ -245,7 +245,7 @@ and the syntax to set a variable is the following: (setq variable-name value) @end example -@node Compiling Executing, Project files, Customization, Top +@node Compiling Executing @chapter Compiling Executing Ada projects can be compiled, linked, and executed using commands on @@ -263,7 +263,7 @@ file variables referenced here. * Compiler errors:: @end menu -@node Compile commands, Compiler errors, Compiling Executing, Compiling Executing +@node Compile commands @section Compile commands Here are the commands for building and using an Ada project, as @@ -346,7 +346,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code @end enumerate -@node Compiler errors, , Compile commands, Compiling Executing +@node Compiler errors @section Compiler errors The @code{Check file}, @code{Compile file}, and @code{Build} commands @@ -366,7 +366,7 @@ Some error messages might also include references to other files. These references are also clickable in the same way, or put point after the line number and press @key{RET}. -@node Project files, Compiling Examples, Compiling Executing, Top +@node Project files @chapter Project files An Emacs Ada mode project file specifies what directories hold sources @@ -385,7 +385,7 @@ an Emacs Ada mode project file. * Project file variables:: @end menu -@node Project File Overview, GUI Editor, Project files, Project files +@node Project File Overview @section Project File Overview Project files have a simple syntax; they may be edited directly. Each @@ -450,7 +450,7 @@ file extension; if it is @code{.gpr}, the file is treated as a GNAT project file. Any other extension is treated as an Emacs Ada mode project file. -@node GUI Editor, Project file variables, Project File Overview, Project files +@node GUI Editor @section GUI Editor The project file editor is invoked with the menu @samp{Ada | Projects @@ -461,7 +461,7 @@ modification using the @samp{[save]} button at the bottom of the buffer, or the @kbd{C-x C-s} binding. To cancel your modifications, kill the buffer or click on the @samp{[cancel]} button. -@node Project file variables, , GUI Editor, Project files +@node Project file variables @section Project file variables The following variables can be defined in a project file; some can @@ -648,7 +648,7 @@ commands and source navigation. @end table -@node Compiling Examples, Moving Through Ada Code, Project files, Top +@node Compiling Examples @chapter Compiling Examples We present several small projects, and walk thru the process of @@ -670,7 +670,7 @@ website mentioned in @xref{Installation}. * Use multiple GNAT project files:: @end menu -@node No project files, Set compiler options, Compiling Examples, Compiling Examples +@node No project files @section No project files This example uses no project files. @@ -836,7 +836,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code @end enumerate -@node Set compiler options, Set source search path, No project files, Compiling Examples +@node Set compiler options @section Set compiler options This example illustrates using an Emacs Ada mode project file to set a @@ -898,7 +898,7 @@ used to set the compiler options. Fixing the error, linking and running the code proceed as in @ref{No project files}. -@node Set source search path, Use GNAT project file, Set compiler options, Compiling Examples +@node Set source search path @section Set source search path In this example, we show how to deal with files in more than one @@ -982,7 +982,7 @@ compiler error message. Fixing the error, linking and running the code proceed as in @ref{No project files}. -@node Use GNAT project file, Use multiple GNAT project files, Set source search path, Compiling Examples +@node Use GNAT project file @section Use GNAT project file In this example, we show how to use a GNAT project file, with no Ada @@ -1061,7 +1061,7 @@ set the compiler options. Fixing the error, linking and running the code proceed as in @ref{No project files}. -@node Use multiple GNAT project files, , Use GNAT project file, Compiling Examples +@node Use multiple GNAT project files @section Use multiple GNAT project files In this example, we show how to use multiple GNAT project files, @@ -1125,7 +1125,7 @@ Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown, demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being used to set the compilation search path. -@node Moving Through Ada Code, Identifier completion, Compiling Examples, Top +@node Moving Through Ada Code @chapter Moving Through Ada Code There are several easy to use commands to navigate through Ada code. All @@ -1179,7 +1179,7 @@ If the @code{ada-xref-create-ali} variable is non-@code{nil}, Emacs will try to run GNAT for you whenever cross-reference information is needed, and is older than the current source file. -@node Identifier completion, Automatic Smart Indentation, Moving Through Ada Code, Top +@node Identifier completion @chapter Identifier completion Emacs and Ada mode provide two general ways for the completion of @@ -1224,7 +1224,7 @@ Complete current identifier using cross-reference information. Complete identifier using buffer information (not Ada-specific). @end table -@node Automatic Smart Indentation, Formatting Parameter Lists, Identifier completion, Top +@node Automatic Smart Indentation @chapter Automatic Smart Indentation Ada mode comes with a full set of rules for automatic indentation. You @@ -1301,7 +1301,7 @@ Indent the current line and display the name of the variable used for indentation. @end table -@node Formatting Parameter Lists, Automatic Casing, Automatic Smart Indentation, Top +@node Formatting Parameter Lists @chapter Formatting Parameter Lists @table @kbd @@ -1314,7 +1314,7 @@ This aligns the declarations on the colon (@samp{:}) separating argument names and argument types, and aligns the @code{in}, @code{out} and @code{in out} keywords. -@node Automatic Casing, Statement Templates, Formatting Parameter Lists, Top +@node Automatic Casing @chapter Automatic Casing Casing of identifiers, attributes and keywords is automatically @@ -1403,7 +1403,7 @@ Rereads the exception dictionary from the file @code{ada-case-exception-file} (@code{ada-case-read-exceptions}). @end table -@node Statement Templates, Comment Handling, Automatic Casing, Top +@node Statement Templates @chapter Statement Templates Templates are defined for most Ada statements, using the Emacs @@ -1494,7 +1494,7 @@ exception (@code{ada-exception}). type (@code{ada-type}). @end table -@node Comment Handling, GNU Free Documentation License, Statement Templates, Top +@node Comment Handling @chapter Comment Handling By default, comment lines get indented like Ada code. There are a few @@ -1513,11 +1513,11 @@ Uncomment the selected region autofill the current comment. @end table -@node GNU Free Documentation License, Index, Comment Handling, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top +@node Index @unnumbered Index @printindex fn diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 6d036910877..5dabf5cd314 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi @@ -4460,7 +4460,7 @@ date by one or several months. @xref{Date Arithmetic}, for more. Friday the 13th? @xref{Types Answer 5, 5}. (@bullet{}) (@bullet{}) @strong{Exercise 6.} How many leap years will there be -between now and the year 10001 A.D.? @xref{Types Answer 6, 6}. (@bullet{}) +between now and the year 10001 AD@? @xref{Types Answer 6, 6}. (@bullet{}) @cindex Slope and angle of a line @cindex Angle and slope of a line @@ -8896,7 +8896,7 @@ Note that this rule does not mention @samp{O} at all, so it will apply to any product-of-sum it encounters---this rule may surprise you if you put it into @code{EvalRules}! -In the second rule, the sum of two O's is changed to the smaller O. +In the second rule, the sum of two O's is changed to the smaller O@. The optional constant coefficients are there mostly so that @samp{O(x^2) - O(x^3)} and @samp{O(x^3) - O(x^2)} are handled as well as @samp{O(x^2) + O(x^3)}. @@ -10986,10 +10986,10 @@ Input is flexible; date forms can be entered in any of the usual notations for dates and times. @xref{Date Formats}. Date forms are stored internally as numbers, specifically the number -of days since midnight on the morning of January 1 of the year 1 AD. +of days since midnight on the morning of December 31 of the year 1 BC@. If the internal number is an integer, the form represents a date only; if the internal number is a fraction or float, the form represents -a date and time. For example, @samp{<6:00am Wed Jan 9, 1991>} +a date and time. For example, @samp{<6:00am Thu Jan 10, 1991>} is represented by the number 726842.25. The standard precision of 12 decimal digits is enough to ensure that a (reasonable) date and time can be stored without roundoff error. @@ -11009,58 +11009,70 @@ You can use the @kbd{v p} (@code{calc-pack}) and @kbd{v u} of a date form. @xref{Packing and Unpacking}. Date forms can go arbitrarily far into the future or past. Negative -year numbers represent years BC@. Calc uses a combination of the -Gregorian and Julian calendars, following the history of Great -Britain and the British colonies. This is the same calendar that -is used by the @code{cal} program in most Unix implementations. +year numbers represent years BC@. There is no ``year 0''; the day +before @samp{<Mon Jan 1, +1>} is @samp{<Sun Dec 31, -1>}. These are +days 1 and 0 respectively in Calc's internal numbering scheme. The +Gregorian calendar is used for all dates, including dates before the +Gregorian calendar was invented (although that can be configured; see +below). Thus Calc's use of the day number @mathit{-10000} to +represent August 15, 28 BC should be taken with a grain of salt. @cindex Julian calendar @cindex Gregorian calendar Some historical background: The Julian calendar was created by -Julius Caesar in the year 46 BC as an attempt to fix the gradual -drift caused by the lack of leap years in the calendar used -until that time. The Julian calendar introduced an extra day in -all years divisible by four. After some initial confusion, the -calendar was adopted around the year we call 8 AD@. Some centuries -later it became apparent that the Julian year of 365.25 days was -itself not quite right. In 1582 Pope Gregory XIII introduced the -Gregorian calendar, which added the new rule that years divisible -by 100, but not by 400, were not to be considered leap years -despite being divisible by four. Many countries delayed adoption -of the Gregorian calendar because of religious differences; -in Britain it was put off until the year 1752, by which time -the Julian calendar had fallen eleven days behind the true -seasons. So the switch to the Gregorian calendar in early -September 1752 introduced a discontinuity: The day after -Sep 2, 1752 is Sep 14, 1752. Calc follows this convention. -To take another example, Russia waited until 1918 before -adopting the new calendar, and thus needed to remove thirteen -days (between Feb 1, 1918 and Feb 14, 1918). This means that -Calc's reckoning will be inconsistent with Russian history between -1752 and 1918, and similarly for various other countries. - -Today's timekeepers introduce an occasional ``leap second'' as -well, but Calc does not take these minor effects into account. -(If it did, it would have to report a non-integer number of days -between, say, @samp{<12:00am Mon Jan 1, 1900>} and +Julius Caesar in the year 46 BC as an attempt to fix the confusion +caused by the irregular Roman calendar that was used before that time. +The Julian calendar introduced an extra day in all years divisible by +four. After some initial confusion, the calendar was adopted around +the year we call 8 AD@. Some centuries later it became +apparent that the Julian year of 365.25 days was itself not quite +right. In 1582 Pope Gregory XIII introduced the Gregorian calendar, +which added the new rule that years divisible by 100, but not by 400, +were not to be considered leap years despite being divisible by four. +Many countries delayed adoption of the Gregorian calendar +because of religious differences. For example, Great Britain and the +British colonies switched to the Gregorian calendar in September +1752, when the Julian calendar was eleven days behind the +Gregorian calendar. That year in Britain, the day after September 2 +was September 14. To take another example, Russia did not adopt the +Gregorian calendar until 1918, and that year in Russia the day after +January 31 was February 14. Calc's reckoning therefore matches English +practice starting in 1752 and Russian practice starting in 1918, but +disagrees with earlier dates in both countries. + +When the Julian calendar was introduced, it had January 1 as the first +day of the year. By the Middle Ages, many European countries +had changed the beginning of a new year to a different date, often to +a religious festival. Almost all countries reverted to using January 1 +as the beginning of the year by the time they adopted the Gregorian +calendar. + +Some calendars attempt to mimic the historical situation by using the +Gregorian calendar for recent dates and the Julian calendar for older +dates. The @code{cal} program in most Unix implementations does this, +for example. While January 1 wasn't always the beginning of a calendar +year, these hybrid calendars still use January 1 as the beginning of +the year even for older dates. The customizable variable +@code{calc-gregorian-switch} (@pxref{Customizing Calc}) can be set to +have Calc's date forms switch from the Julian to Gregorian calendar at +any specified date. + +Today's timekeepers introduce an occasional ``leap second''. +These do not occur regularly and Calc does not take these minor +effects into account. (If it did, it would have to report a +non-integer number of days between, say, +@samp{<12:00am Mon Jan 1, 1900>} and @samp{<12:00am Sat Jan 1, 2000>}.) -Calc uses the Julian calendar for all dates before the year 1752, -including dates BC when the Julian calendar technically had not -yet been invented. Thus the claim that day number @mathit{-10000} is -called ``August 16, 28 BC'' should be taken with a grain of salt. - -Please note that there is no ``year 0''; the day before -@samp{<Sat Jan 1, +1>} is @samp{<Fri Dec 31, -1>}. These are -days 0 and @mathit{-1} respectively in Calc's internal numbering scheme. - @cindex Julian day counting Another day counting system in common use is, confusingly, also called -``Julian.'' The Julian day number is the numbers of days since -12:00 noon (GMT) on Jan 1, 4713 BC, which in Calc's scheme (in GMT) -is @mathit{-1721423.5} (recall that Calc starts at midnight instead -of noon). Thus to convert a Calc date code obtained by unpacking a -date form into a Julian day number, simply add 1721423.5 after +``Julian.'' Julian days go from noon to noon. The Julian day number +is the numbers of days since 12:00 noon (GMT) on November 24, 4714 BC +in the Gregorian calendar (i.e., January 1, 4713 BC in the Julian +calendar). In Calc's scheme (in GMT) the Julian day origin is +@mathit{-1721422.5}, because Calc starts at midnight instead of noon. +Thus to convert a Calc date code obtained by unpacking a +date form into a Julian day number, simply add 1721422.5 after compensating for the time zone difference. The built-in @kbd{t J} command performs this conversion for you. @@ -11092,7 +11104,7 @@ the Julian cycle as an astronomical dating system; this idea was taken up by other astronomers. (At the time, noon was the start of the astronomical day. Herschel originally suggested counting the days since Jan 1, 4713 BC at noon Alexandria time; this was later amended to -noon GMT.) Julian day numbering is largely used in astronomy. +noon GMT@.) Julian day numbering is largely used in astronomy. @cindex Unix time format The Unix operating system measures time as an integer number of @@ -13404,12 +13416,91 @@ dates. @xref{Specifying Operators}. To avoid confusion with nameless functions, your date formats should avoid using the @samp{#} character. @menu +* ISO 8601:: * Date Formatting Codes:: * Free-Form Dates:: * Standard Date Formats:: @end menu -@node Date Formatting Codes, Free-Form Dates, Date Formats, Date Formats +@node ISO 8601, Date Formatting Codes, Date Formats, Date Formats +@subsubsection ISO 8601 + +@noindent +@cindex ISO 8601 +The same date can be written down in different formats and Calc tries +to allow you to choose your preferred format. Some common formats are +ambiguous, however; for example, 10/11/2012 means October 11, +2012 in the United States but it means November 10, 2012 in +Europe. To help avoid such ambiguities, the International Organization +for Standardization (ISO) provides the ISO 8601 standard, which +provides three different but easily distinguishable and unambiguous +ways to represent a date. + +The ISO 8601 calendar date representation is + +@example + @var{YYYY}-@var{MM}-@var{DD} +@end example + +@noindent +where @var{YYYY} is the four digit year, @var{MM} is the two-digit month +number (01 for January to 12 for December), and @var{DD} is the +two-digit day of the month (01 to 31). (Note that @var{YYYY} does not +correspond to Calc's date formatting code, which will be introduced +later.) The year, which should be padded with zeros to ensure it has at +least four digits, is the Gregorian year, except that the year before +0001 (1 AD) is the year 0000 (1 BC). The date October 11, 2012 is +written 2012-10-11 in this representation and November 10, 2012 is +written 2012-11-10. + +The ISO 8601 ordinal date representation is + +@example + @var{YYYY}-@var{DDD} +@end example + +@noindent +where @var{YYYY} is the year, as above, and @var{DDD} is the day of the year. +The date December 31, 2011 is written 2011-365 in this representation +and January 1, 2012 is written 2012-001. + +The ISO 8601 week date representation is + +@example + @var{YYYY}-W@var{ww}-@var{D} +@end example + +@noindent +where @var{YYYY} is the ISO week-numbering year, @var{ww} is the two +digit week number (preceded by a literal ``W''), and @var{D} is the day +of the week (1 for Monday through 7 for Sunday). The ISO week-numbering +year is based on the Gregorian year but can differ slightly. The first +week of an ISO week-numbering year is the week with the Gregorian year's +first Thursday in it (equivalently, the week containing January 4); +any day of that week (Monday through Sunday) is part of the same ISO +week-numbering year, any day from the previous week is part of the +previous year. For example, January 4, 2013 is on a Friday, and so +the first week for the ISO week-numbering year 2013 starts on +Monday, December 31, 2012. The day December 31, 2012 is then part of the +Gregorian year 2012 but ISO week-numbering year 2013. In the week +date representation, this week goes from 2013-W01-1 (December 31, +2012) to 2013-W01-7 (January 6, 2013). + +All three ISO 8601 representations arrange the numbers from most +significant to least significant; as well as being unambiguous +representations, they are easy to sort since chronological order in +this formats corresponds to lexicographical order. The hyphens are +sometimes omitted. + +The ISO 8601 standard uses a 24 hour clock; a particular time is +represented by @var{hh}:@var{mm}:@var{ss} where @var{hh} is the +two-digit hour (from 00 to 24), @var{mm} is the two-digit minute (from +00 to 59) and @var{ss} is the two-digit second. The seconds or minutes +and seconds can be omitted, and decimals can be added. If a date with a +time is represented, they should be separated by a literal ``T'', so noon +on December 13, 2012 can be represented as 2012-12-13T12:00. + +@node Date Formatting Codes, Free-Form Dates, ISO 8601, Date Formats @subsubsection Date Formatting Codes @noindent @@ -13426,7 +13517,7 @@ the time part. The punctuation characters (including spaces) must match exactly; letter fields must correspond to suitable text in the input. If this doesn't work, Calc checks if the input is a simple number; if so, the number is interpreted as a number of days -since Jan 1, 1 AD@. Otherwise, Calc tries a much more relaxed and +since Dec 31, 1 BC@. Otherwise, Calc tries a much more relaxed and flexible algorithm which is described in the next section. Weekday names are ignored during reading. @@ -13450,6 +13541,10 @@ Year: ``91'' for 1991, `` 7'' for 2007, ``+23'' for 23 AD. Year: ``1991'' for 1991, ``23'' for 23 AD. @item YYYY Year: ``1991'' for 1991, ``+23'' for 23 AD. +@item ZYYY +Year: ``1991'' for 1991, ``0023'' for 23 AD, ``0000'' for 1 BC. +@item IYYY +Year: ISO 8601 week-numbering year. @item aa Year: ``ad'' or blank. @item AA @@ -13498,6 +13593,8 @@ Day: ``07'' for 7th day of month. Day: `` 7'' for 7th day of month. @item W Weekday: ``0'' for Sunday, ``6'' for Saturday. +@item w +Weekday: ``1'' for Monday, ``7'' for Sunday. @item WWW Weekday: ``SUN'' for Sunday. @item Www @@ -13508,12 +13605,16 @@ Weekday: ``sun'' for Sunday. Weekday: ``SUNDAY'' for Sunday. @item Wwww Weekday: ``Sunday'' for Sunday. +@item Iww +Week number: ISO 8601 week number, ``W01'' for week 1. @item d Day of year: ``34'' for Feb. 3. @item ddd Day of year: ``034'' for Feb. 3. @item bdd Day of year: `` 34'' for Feb. 3. +@item T +Letter: Literal ``T''. @item h Hour: ``5'' for 5 AM; ``17'' for 5 PM. @item hh @@ -13616,15 +13717,21 @@ abbreviated to one letter, and the alternate forms @samp{a.m.}, @samp{p.m.}, and @samp{mid} are also understood. Obviously @samp{noon} and @samp{midnight} are allowed only on 12:00:00. The words @samp{noon}, @samp{mid}, and @samp{midnight} are also -recognized with no number attached. +recognized with no number attached. Midnight will represent the +beginning of a day. If there is no AM/PM indicator, the time is interpreted in 24-hour format. -To read the date portion, all words and numbers are isolated -from the string; other characters are ignored. All words must -be either month names or day-of-week names (the latter of which -are ignored). Names can be written in full or as three-letter +When reading the date portion, Calc first checks to see if it is an +ISO 8601 week-numbering date; if the string contains an integer +representing the year, a ``W'' followed by two digits for the week +number, and an integer from 1 to 7 representing the weekday (in that +order), then all other characters are ignored and this information +determines the date. Otherwise, all words and numbers are isolated +from the string; other characters are ignored. All words must be +either month names or day-of-week names (the latter of which are +ignored). Names can be written in full or as three-letter abbreviations. Large numbers, or numbers with @samp{+} or @samp{-} signs, @@ -13687,6 +13794,10 @@ command (@pxref{Mode Settings}). @samp{j<, h:mm:ss>} (Julian day plus time) @item 9 @samp{YYddd< hh:mm:ss>} (Year-day format) +@item 10 +@samp{ZYYY-MM-DD Www< hh:mm>} (Org mode format) +@item 11 +@samp{IYYY-Iww-w<Thh:mm:ss>} (ISO 8601 week numbering format) @end table @node Truncating the Stack, Justification, Date Formats, Display Modes @@ -35592,6 +35703,20 @@ number of undo steps that will be preserved; if be preserved. The default value of @code{calc-undo-length} is @expr{100}. @end defvar +@defvar calc-gregorian-switch +See @ref{Date Forms}.@* +The variable @code{calc-gregorian-switch} is either a list of integers +@code{(@var{YEAR} @var{MONTH} @var{DAY})} or @code{nil}. +If it is @code{nil}, then Calc's date forms always represent Gregorian dates. +Otherwise, @code{calc-gregorian-switch} represents the date that the +calendar switches from Julian dates to Gregorian dates; +@code{(@var{YEAR} @var{MONTH} @var{DAY})} will be the first Gregorian +date. The customization buffer will offer several standard dates to +choose from, or the user can enter their own date. + +The default value of @code{calc-gregorian-switch} is @code{nil}. +@end defvar + @node Reporting Bugs, Summary, Customizing Calc, Top @appendix Reporting Bugs diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index ae96f2c5cb8..c3657415078 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi @@ -1199,9 +1199,6 @@ The only exceptions are plain variables and calls to bound on entry, it is simply made unbound by @code{makunbound} or @code{fmakunbound} on exit. @end ignore - -Note that the @file{cl.el} version of this macro behaves slightly -differently. @xref{Obsolete Macros}. @end defmac @defmac cl-letf* (bindings@dots{}) forms@dots{} @@ -4887,13 +4884,6 @@ form (@pxref{Obsolete Lexical Binding}), rather than the true lexical binding that @code{cl-labels} uses. @end defmac -@defmac letf (bindings@dots{}) forms@dots{} -This macro is almost exactly the same as @code{cl-letf}, which -replaces it (@pxref{Modify Macros}). The only difference is in -details that relate to some deprecated usage of @code{symbol-function} -in place forms. -@end defmac - @node Obsolete Setf Customization @appendixsec Obsolete Ways to Customize Setf diff --git a/doc/misc/doclicense.texi b/doc/misc/doclicense.texi index a511ffcd5a8..9c3bbe56e91 100644 --- a/doc/misc/doclicense.texi +++ b/doc/misc/doclicense.texi @@ -1,4 +1,3 @@ -@c -*-texinfo-*- @c The GNU Free Documentation License. @center Version 1.3, 3 November 2008 @@ -6,7 +5,7 @@ @c hence no sectioning command or @node. @display -Copyright @copyright{} 2000, 2001, 2002, 2007, 2008, 2009 Free Software Foundation, Inc. +Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. @uref{http://fsf.org/} Everyone is permitted to copy and distribute verbatim copies @@ -93,16 +92,16 @@ An image format is not Transparent if used for any substantial amount of text. A copy that is not ``Transparent'' is called ``Opaque''. Examples of suitable formats for Transparent copies include plain -@sc{ascii} without markup, Texinfo input format, La@TeX{} input -format, @acronym{SGML} or @acronym{XML} using a publicly available -@acronym{DTD}, and standard-conforming simple @acronym{HTML}, -PostScript or @acronym{PDF} designed for human modification. Examples -of transparent image formats include @acronym{PNG}, @acronym{XCF} and -@acronym{JPG}. Opaque formats include proprietary formats that can be -read and edited only by proprietary word processors, @acronym{SGML} or -@acronym{XML} for which the @acronym{DTD} and/or processing tools are -not generally available, and the machine-generated @acronym{HTML}, -PostScript or @acronym{PDF} produced by some word processors for +ASCII without markup, Texinfo input format, La@TeX{} input +format, SGML or XML using a publicly available +DTD, and standard-conforming simple HTML, +PostScript or PDF designed for human modification. Examples +of transparent image formats include PNG, XCF and +JPG@. Opaque formats include proprietary formats that can be +read and edited only by proprietary word processors, SGML or +XML for which the DTD and/or processing tools are +not generally available, and the machine-generated HTML, +PostScript or PDF produced by some word processors for output purposes only. The ``Title Page'' means, for a printed book, the title page itself, @@ -482,7 +481,7 @@ license notices just after the title page: @end smallexample If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, -replace the ``with@dots{}Texts.'' line with this: +replace the ``with@dots{}Texts.''@: line with this: @smallexample @group @@ -501,7 +500,6 @@ recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. - @c Local Variables: @c ispell-local-pdict: "ispell-dict" @c End: diff --git a/doc/misc/ebrowse.texi b/doc/misc/ebrowse.texi index 471ba822b8e..c7f3e3b1a61 100644 --- a/doc/misc/ebrowse.texi +++ b/doc/misc/ebrowse.texi @@ -44,7 +44,7 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Overview, (dir), (dir) +@node Top @top Ebrowse You can browse C++ class hierarchies from within Emacs by using @@ -67,7 +67,7 @@ Ebrowse. -@node Overview, Generating browser files, Top, Top +@node Overview @chapter Introduction When working in software projects using C++, I frequently missed @@ -177,8 +177,7 @@ them, if you like. -@node Generating browser files, Loading a Tree, Overview, Top -@comment node-name, next, previous, up +@node Generating browser files @chapter Processing Source Files @cindex @command{ebrowse}, the program @@ -225,7 +224,7 @@ available command line options.@refill @comment name, next, prev, up -@node Input files, Output file, Generating browser files, Generating browser files +@node Input files @section Specifying Input Files @table @samp @@ -266,7 +265,7 @@ properly identifying friend functions of a class. @comment name, next, prev, up -@node Output file, Structs and unions, Input files, Generating browser files +@node Output file @section Changing the Output File Name @table @samp @@ -301,7 +300,7 @@ with this command line option. @comment name, next, prev, up -@node Structs and unions, Matching, Output file, Generating browser files +@node Structs and unions @section Structs and Unions @cindex structs @cindex unions @@ -321,7 +320,7 @@ tree. @comment name, next, prev, up -@node Matching, Verbosity, Structs and unions, Generating browser files +@node Matching @section Regular Expressions @cindex regular expressions, recording @@ -374,8 +373,7 @@ the probability that it will no longer match after editing the file. -@node Verbosity, , Matching, Generating browser files -@comment node-name, next, previous, up +@node Verbosity @section Verbose Mode @cindex verbose operation @@ -395,8 +393,7 @@ the names of the classes seen. -@node Loading a Tree, Tree Buffers, Generating browser files, Top -@comment node-name, next, previous, up +@node Loading a Tree @chapter Starting to Browse @cindex loading @cindex browsing @@ -436,8 +433,7 @@ where no highlight is displayed. @comment *** @comment **************************************************************** -@node Tree Buffers, Member Buffers, Loading a Tree, Top -@comment node-name, next, previous, up +@node Tree Buffers @chapter Tree Buffers @cindex tree buffer mode @cindex class trees @@ -468,8 +464,7 @@ buffers. -@node Source Display, Member Display, Tree Buffers, Tree Buffers -@comment node-name, next, previous, up +@node Source Display @section Viewing and Finding Class Declarations @cindex viewing, class @cindex finding a class @@ -497,8 +492,7 @@ The same functionality is available from the menu opened with -@node Member Display, Go to Class, Source Display, Tree Buffers -@comment node-name, next, previous, up +@node Member Display @section Displaying Members @cindex @samp{*Members*} buffer @cindex @samp{*Globals*} @@ -561,8 +555,7 @@ These lists are also available from the class' context menu invoked with -@node Go to Class, Quitting, Member Display, Tree Buffers -@comment node-name, next, previous, up +@node Go to Class @section Finding a Class @cindex locate class @cindex expanding branches @@ -589,8 +582,7 @@ local copy of the regular expression last searched in it. -@node Quitting, File Name Display, Go to Class, Tree Buffers -@comment node-name, next, previous, up +@node Quitting @section Burying a Tree Buffer @cindex burying tree buffer @@ -602,8 +594,7 @@ Is a synonym for @kbd{M-x bury-buffer}. -@node File Name Display, Expanding and Collapsing, Quitting, Tree Buffers -@comment node-name, next, previous, up +@node File Name Display @section Displaying File Names @table @kbd @@ -633,8 +624,7 @@ Here is an example of a tree buffer with file names displayed. @end example -@node Expanding and Collapsing, Tree Indentation, File Name Display, Tree Buffers -@comment node-name, next, previous, up +@node Expanding and Collapsing @section Expanding and Collapsing a Tree @cindex expand tree branch @cindex collapse tree branch @@ -673,8 +663,7 @@ This command expands all collapsed branches in the tree. -@node Tree Indentation, Killing Classes, Expanding and Collapsing, Tree Buffers -@comment node-name, next, previous, up +@node Tree Indentation @section Changing the Tree Indentation @cindex tree indentation @cindex indentation of the tree @@ -689,8 +678,7 @@ available from the tree buffer's context menu. -@node Killing Classes, Saving a Tree, Tree Indentation, Tree Buffers -@comment node-name, next, previous, up +@node Killing Classes @section Removing Classes from the Tree @cindex killing classes @cindex class, remove from tree @@ -705,9 +693,7 @@ deletion is actually performed. -@node Saving a Tree, Statistics, Killing Classes, Tree Buffers -@comment node-name, next, previous, up -@comment node-name, next, previous, up +@node Saving a Tree @section Saving a Tree @cindex save tree to a file @cindex tree, save to a file @@ -725,8 +711,8 @@ Writes the tree to a file whose name is read from the minibuffer. -@node Statistics, Marking Classes, Saving a Tree, Tree Buffers -@comment node-name, next, previous, up +@node Statistics +@section Statistics @cindex statistics for a tree @cindex tree statistics @cindex class statistics @@ -741,8 +727,8 @@ context menu. -@node Marking Classes, , Statistics, Tree Buffers -@comment node-name, next, previous, up +@node Marking Classes +@section Marking Classes @cindex marking classes @cindex operations on marked classes @@ -783,8 +769,7 @@ display, like in the following example @c *** @c **************************************************************** -@node Member Buffers, Tags-like Functions, Tree Buffers, Top -@comment node-name, next, previous, up +@node Member Buffers @chapter Member Buffers @cindex members @cindex member buffer mode @@ -834,8 +819,7 @@ buffer: members, classes, and the buffer itself. -@node Switching Member Lists, Finding/Viewing, Member Buffers, Member Buffers -@comment node-name, next, previous, up +@node Switching Member Lists @section Switching Member Lists @cindex member lists, in member buffers @cindex static members @@ -881,8 +865,7 @@ context menu. -@node Finding/Viewing, Inherited Members, Switching Member Lists, Member Buffers -@comment node-name, next, previous, up +@node Finding/Viewing @section Finding and Viewing Member Source @cindex finding members, in member buffers @cindex viewing members, in member buffers @@ -919,8 +902,7 @@ displayed when clicking @kbd{Mouse-2} on a member name. -@node Inherited Members, Searching Members, Finding/Viewing, Member Buffers -@comment node-name, next, previous, up +@node Inherited Members @section Display of Inherited Members @cindex superclasses, members @cindex base classes, members @@ -935,8 +917,7 @@ buffer. This is also in the buffer's context menu. -@node Searching Members, Switching to Tree, Inherited Members, Member Buffers -@comment node-name, next, previous, up +@node Searching Members @section Searching Members @cindex searching members @@ -965,8 +946,7 @@ a mouse. -@node Switching to Tree, Filters, Searching Members, Member Buffers -@comment node-name, next, previous, up +@node Switching to Tree @section Switching to Tree Buffer @cindex tree buffer, switch to @cindex buffer switching @@ -984,8 +964,7 @@ displayed in the member buffer. -@node Filters, Attributes, Switching to Tree, Member Buffers -@comment node-name, next, previous, up +@node Filters @section Filters @cindex filters @@ -1029,8 +1008,7 @@ These commands are also found in the buffer's context menu. -@node Attributes, Long and Short Display, Filters, Member Buffers -@comment node-name, next, previous, up +@node Attributes @section Displaying Member Attributes @cindex attributes @cindex member attribute display @@ -1086,8 +1064,7 @@ This command is also in the buffer's context menu. -@node Long and Short Display, Regexp Display, Attributes, Member Buffers -@comment node-name, next, previous, up +@node Long and Short Display @section Long and Short Member Display @cindex display form @cindex long display @@ -1121,8 +1098,7 @@ not been produced with the @command{ebrowse} option @samp{--no-regexps}. -@node Regexp Display, Switching Classes, Long and Short Display, Member Buffers -@comment node-name, next, previous, up +@node Regexp Display @section Display of Regular Expressions @cindex regular expression display @@ -1140,8 +1116,7 @@ see @ref{Matching, --no-regexps, Regular Expressions}. -@node Switching Classes, Killing/Burying, Regexp Display, Member Buffers -@comment node-name, next, previous, up +@node Switching Classes @section Displaying Another Class @cindex base class, display @cindex derived class, display @@ -1173,8 +1148,7 @@ Switch to the next sibling of the class in the class tree. -@node Killing/Burying, Column Width, Switching Classes, Member Buffers -@comment node-name, next, previous, up +@node Killing/Burying @section Burying a Member Buffer @cindex burying member buffers @@ -1186,8 +1160,7 @@ This command is a synonym for @kbd{M-x bury-buffer}. -@node Column Width, Redisplay, Killing/Burying, Member Buffers -@comment node-name, next, previous, up +@node Column Width @section Setting the Column Width @cindex column width @cindex member indentation @@ -1202,8 +1175,7 @@ This command sets the column width depending on the display form used -@node Redisplay, Getting Help, Column Width, Member Buffers -@comment node-name, next, previous, up +@node Redisplay @section Forced Redisplay @cindex redisplay of member buffers @@ -1218,8 +1190,8 @@ columns. -@node Getting Help, , Redisplay, Member Buffers -@comment node-name, next, previous, up +@node Getting Help +@section Getting Help @cindex help @table @kbd @@ -1234,8 +1206,7 @@ This key is bound to @code{describe-mode}. @comment *** TAGS LIKE FUNCTIONS @comment ************************************************************** -@node Tags-like Functions, GNU Free Documentation License, Member Buffers, Top -@comment node-name, next, previous, up +@node Tags-like Functions @chapter Tags-like Functions Ebrowse provides tags functions similar to those of the standard @@ -1254,8 +1225,7 @@ Emacs Tags facility, but better suited to the needs of C++ programmers. -@node Finding and Viewing, Position Stack, Tags-like Functions, Tags-like Functions -@comment node-name, next, previous, up +@node Finding and Viewing @section Finding and Viewing Members @cindex finding class member, in C++ source @cindex viewing class member, in C++ source @@ -1314,8 +1284,7 @@ View a member's declaration in another frame. -@node Position Stack, Search & Replace, Finding and Viewing, Tags-like Functions -@comment node-name, next, previous, up +@node Position Stack @section The Position Stack @cindex position stack @@ -1351,8 +1320,7 @@ view a position with @kbd{v}. -@node Search & Replace, Members in Files, Position Stack, Tags-like Functions -@comment node-name, next, previous, up +@node Search & Replace @section Searching and Replacing @cindex searching multiple C++ files @cindex replacing in multiple C++ files @@ -1389,8 +1357,7 @@ This restarts the last tags operation with the next file in the list. -@node Members in Files, Apropos, Search & Replace, Tags-like Functions -@comment node-name, next, previous, up +@node Members in Files @section Members in Files @cindex files @cindex members in file, listing @@ -1403,8 +1370,7 @@ name is read from the minibuffer with completion. -@node Apropos, Symbol Completion, Members in Files, Tags-like Functions -@comment node-name, next, previous, up +@node Apropos @section Member Apropos @cindex apropos on class members @cindex members, matching regexp @@ -1421,8 +1387,7 @@ command @kbd{C-c C-m f}, for example, to jump to a specific member. -@node Symbol Completion, Member Buffer Display, Apropos, Tags-like Functions -@comment node-name, next, previous, up +@node Symbol Completion @section Symbol Completion @cindex completion @cindex symbol completion @@ -1432,7 +1397,7 @@ The command @kbd{C-c C-m @key{TAB}} completes the symbol in front of point. -@node Member Buffer Display, , Symbol Completion, Tags-like Functions +@node Member Buffer Display @section Quick Member Display @cindex member buffer, for member at point @@ -1440,12 +1405,12 @@ You can quickly display a member buffer containing the member the cursor in on with the command @kbd{C-c C-m m}. -@node GNU Free Documentation License, Concept Index, Tags-like Functions, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Concept Index, , GNU Free Documentation License, Top +@node Concept Index @unnumbered Concept Index @printindex cp diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi index cf4438c8bad..1e4c888a9e7 100644 --- a/doc/misc/ediff.texi +++ b/doc/misc/ediff.texi @@ -61,7 +61,7 @@ modify this GNU manual.'' @contents -@node Top, Introduction, (dir), (dir) +@node Top @top Ediff @insertcopying @@ -79,7 +79,7 @@ modify this GNU manual.'' * Index:: @end menu -@node Introduction, Major Entry Points, Top, Top +@node Introduction @chapter Introduction @cindex Comparing files and buffers @@ -127,7 +127,7 @@ functions are adaptations from Emerge. Although Ediff subsumes and greatly extends Emerge, much of the functionality in Ediff is influenced by Emerge. The architecture and the interface are, of course, drastically different. -@node Major Entry Points, Session Commands, Introduction, Top +@node Major Entry Points @chapter Major Entry Points When Ediff starts up, it displays a small control window, which accepts the @@ -397,7 +397,7 @@ Moreover, the functions @code{ediff-directory-revisions}, related Ediff sessions by taking a directory and comparing (or merging) versions of files in that directory. -@node Session Commands, Registry of Ediff Sessions, Major Entry Points, Top +@node Session Commands @chapter Session Commands All Ediff commands are displayed in a Quick Help window, unless you type @@ -430,7 +430,7 @@ command (see @kbd{ga}, @kbd{gb}, and @kbd{gc}). * Other Session Commands:: Commands that are not bound to keys. @end menu -@node Quick Help Commands,Other Session Commands,,Session Commands +@node Quick Help Commands @section Quick Help Commands @cindex command help @cindex important commands @@ -911,7 +911,7 @@ merge buffer and then select regions in those buffers. @end table -@node Other Session Commands,,Quick Help Commands,Session Commands +@node Other Session Commands @section Other Session Commands The following commands can be invoked from within any Ediff session, @@ -977,7 +977,7 @@ making it run faster. The function @code{ediff-profile} toggles profiling of ediff commands. @end table -@node Registry of Ediff Sessions, Session Groups, Session Commands, Top +@node Registry of Ediff Sessions @chapter Registry of Ediff Sessions Ediff maintains a registry of all its invocations that are @@ -1008,7 +1008,7 @@ and @kbd{DEL} (previous registry record). There are other commands as well, but you don't need to memorize them, since they are listed at the top of the registry buffer. -@node Session Groups, Remote and Compressed Files, Registry of Ediff Sessions, Top +@node Session Groups @chapter Session Groups Several major entries of Ediff perform comparison and merging on @@ -1127,7 +1127,7 @@ user whether or not to do a recursive descent. -@node Remote and Compressed Files, Customization, Session Groups, Top +@node Remote and Compressed Files @chapter Remote and Compressed Files Ediff works with remote, compressed, and encrypted files. Ediff @@ -1150,7 +1150,7 @@ i.e., the original is renamed into @file{source-name.orig} and the result of the patch is placed into the file source-name (@file{_orig} is used on systems like DOS, etc.) -@node Customization, Credits, Remote and Compressed Files, Top +@node Customization @chapter Customization Ediff has a rather self-explanatory interface, and in most cases you @@ -1186,7 +1186,7 @@ refer to Emacs manual for the information on how to set Emacs X resources. * Notes on Heavy-duty Customization:: Customization for the gurus. @end menu -@node Hooks, Quick Help Customization, Customization, Customization +@node Hooks @section Hooks The bulk of customization can be done via the following hooks: @@ -1332,7 +1332,7 @@ map that controls key bindings in the meta buffer. Since bindings for different kinds of meta buffers. @end table -@node Quick Help Customization, Window and Frame Configuration, Hooks, Customization +@node Quick Help Customization @section Quick Help Customization @vindex ediff-use-long-help-message @vindex ediff-control-buffer @@ -1356,7 +1356,7 @@ basis, you must use @code{ediff-startup-hook} to change the value of the variable @code{ediff-help-message}, which is local to @code{ediff-control-buffer}. -@node Window and Frame Configuration, Selective Browsing, Quick Help Customization, Customization +@node Window and Frame Configuration @section Window and Frame Configuration On a non-windowing display, Ediff sets things up in one frame, splitting @@ -1493,7 +1493,7 @@ can switch between sessions by suspending one session and then switching to another control panel. (Different control panel buffers are distinguished by a numerical suffix, e.g., @samp{Ediff Control Panel<3>}.) -@node Selective Browsing, Highlighting Difference Regions, Window and Frame Configuration, Customization +@node Selective Browsing @section Selective Browsing Sometimes it is convenient to be able to step through only some difference @@ -1608,7 +1608,7 @@ ignoring letter case or not. It can be set in @file{.emacs} using When case sensitivity is toggled, all difference regions are recomputed. -@node Highlighting Difference Regions, Narrowing, Selective Browsing, Customization +@node Highlighting Difference Regions @section Highlighting Difference Regions The following variables control the way Ediff highlights difference @@ -1735,7 +1735,7 @@ faces, you can modify them when Ediff is being loaded using or @code{set/make-face-@dots{}} as shown above. Emacs's low-level face-manipulation functions should be avoided. -@node Narrowing, Refinement of Difference Regions, Highlighting Difference Regions, Customization +@node Narrowing @section Narrowing If buffers being compared are narrowed at the time of invocation of @@ -1767,7 +1767,7 @@ Controls whether on quitting Ediff should restore the accessible range that existed before the current invocation. @end table -@node Refinement of Difference Regions, Patch and Diff Programs, Narrowing, Customization +@node Refinement of Difference Regions @section Refinement of Difference Regions Ediff has variables to control the way fine differences are @@ -1839,7 +1839,7 @@ command @kbd{@@}. Repeated typing of this key cycles through three different states: auto-refining, no-auto-refining, and no-highlighting of fine differences. -@node Patch and Diff Programs, Merging and diff3, Refinement of Difference Regions, Customization +@node Patch and Diff Programs @section Patch and Diff Programs This section describes variables that specify the programs to be used for @@ -1948,7 +1948,7 @@ Specifies the default directory to look for patches. @code{diff}. Instead, make sure you are using some implementation of POSIX @code{diff}, such as @code{gnudiff}. -@node Merging and diff3, Support for Version Control, Patch and Diff Programs, Customization +@node Merging and diff3 @section Merging and diff3 Ediff supports three-way comparison via the functions @code{ediff-files3} and @@ -2152,7 +2152,7 @@ When merge buffers are saved automatically as directed by specified by the variable @code{ediff-merge-filename-prefix}. The default is @code{merge_}, but this can be changed by the user. -@node Support for Version Control, Customizing the Mode Line, Merging and diff3, Customization +@node Support for Version Control @section Support for Version Control @@ -2197,7 +2197,7 @@ In case of @file{pcl-cvs.el}, Ediff can also be invoked via the function @code{run-ediff-from-cvs-buffer}---see the documentation string for this function. -@node Customizing the Mode Line, Miscellaneous, Support for Version Control, Customization +@node Customizing the Mode Line @section Customizing the Mode Line When Ediff is running, the mode line of @samp{Ediff Control Panel} @@ -2216,7 +2216,7 @@ don't like the way Ediff changes the mode line, you can use @pindex @file{uniquify.el} @pindex @file{mode-line.el} -@node Miscellaneous, Notes on Heavy-duty Customization, Customizing the Mode Line, Customization +@node Miscellaneous @section Miscellaneous Here are a few other variables for customizing Ediff: @@ -2333,7 +2333,7 @@ Try different settings and see which one is for you. @end table -@node Notes on Heavy-duty Customization, , Miscellaneous, Customization +@node Notes on Heavy-duty Customization @section Notes on Heavy-duty Customization Some users need to customize Ediff in rather sophisticated ways, which @@ -2402,7 +2402,7 @@ non-@code{nil} only if Ediff uses the multiframe display, i.e., when the control buffer is in its own frame. @end table -@node Credits, GNU Free Documentation License, Customization, Top +@node Credits @chapter Credits Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired @@ -2520,12 +2520,12 @@ Ilya Zakharevich (ilya at math.ohio-state.edu), Eli Zaretskii (eliz at is.elta.co.il) @end example -@node GNU Free Documentation License, Index, Credits, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top +@node Index @unnumbered Index @printindex cp diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi index beb8d545586..cc61cd1ab5b 100644 --- a/doc/misc/erc.texi +++ b/doc/misc/erc.texi @@ -747,7 +747,7 @@ If non, @code{nil}, this is a list of IRC message types to hide, e.g.: @defopt erc-lurker-hide-list Like @code{erc-hide-list}, but only applies to messages sent by lurkers. The function @code{erc-lurker-p} determines whether a given -nickname is considerd a lurker. +nickname is considered a lurker. @end defopt diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi index 1d3a8b0818f..8728d53ea27 100644 --- a/doc/misc/ert.texi +++ b/doc/misc/ert.texi @@ -25,7 +25,7 @@ modify this GNU manual.'' @end quotation @end copying -@node Top, Introduction, (dir), (dir) +@node Top @top ERT: Emacs Lisp Regression Testing ERT is a tool for automated testing in Emacs Lisp. Its main features @@ -86,7 +86,7 @@ Appendix @end detailmenu @end menu -@node Introduction, How to Run Tests, Top, Top +@node Introduction @chapter Introduction ERT allows you to define @emph{tests} in addition to functions, @@ -154,7 +154,7 @@ test. Tests should clean up even if they fail. @xref{Tests and Their Environment}. -@node How to Run Tests, How to Write Tests, Introduction, Top +@node How to Run Tests @chapter How to Run Tests You can run tests either in the Emacs you are working in, or on the @@ -172,7 +172,7 @@ different Emacs versions. @end menu -@node Running Tests Interactively, Running Tests in Batch Mode, How to Run Tests, How to Run Tests +@node Running Tests Interactively @section Running Tests Interactively You can run the tests that are currently defined in your Emacs with @@ -251,7 +251,7 @@ while point is on a test failure will increase the limits to show more of the expression. -@node Running Tests in Batch Mode, Test Selectors, Running Tests Interactively, How to Run Tests +@node Running Tests in Batch Mode @section Running Tests in Batch Mode ERT supports automated invocations from the command line or from @@ -275,7 +275,7 @@ additional @code{-L} flags to ensure that @code{my-tests.el} and all the files that it requires are on your @code{load-path}. -@node Test Selectors, , Running Tests in Batch Mode, How to Run Tests +@node Test Selectors @section Test Selectors Functions like @code{ert} accept a @emph{test selector}, a Lisp @@ -314,7 +314,7 @@ result in the last run, and tag-based selectors such as @code{(not @code{:causes-redisplay}. -@node How to Write Tests, How to Debug Tests, How to Run Tests, Top +@node How to Write Tests @chapter How to Write Tests ERT lets you define tests in the same way you define functions. You @@ -334,7 +334,7 @@ to find where a test was defined if the test was loaded from a file. * Useful Techniques:: Some examples. @end menu -@node The @code{should} Macro, Expected Failures, How to Write Tests, How to Write Tests +@node The @code{should} Macro @section The @code{should} Macro Test bodies can include arbitrary code; but to be useful, they need to @@ -398,7 +398,7 @@ default. @code{should} reports. -@node Expected Failures, Tests and Their Environment, The @code{should} Macro, How to Write Tests +@node Expected Failures @section Expected Failures Some bugs are complicated to fix, or not very important, and are left as @@ -451,7 +451,7 @@ versions, specific architectures, etc.: @end lisp -@node Tests and Their Environment, Useful Techniques, Expected Failures, How to Write Tests +@node Tests and Their Environment @section Tests and Their Environment The outcome of running a test should not depend on the current state @@ -506,7 +506,7 @@ by calling the corresponding function directly, after binding the hook variables to nil. This avoids the above problems. -@node Useful Techniques, , Tests and Their Environment, How to Write Tests +@node Useful Techniques @section Useful Techniques when Writing Tests Testing simple functions that have no side effects and no dependencies @@ -587,7 +587,7 @@ for testing. Usually, this makes the interfaces easier to use as well. -@node How to Debug Tests, Extending ERT, How to Write Tests, Top +@node How to Debug Tests @chapter How to Debug Tests This section describes how to use ERT's features to understand why @@ -600,7 +600,7 @@ a test failed. @end menu -@node Understanding Explanations, Interactive Debugging, How to Debug Tests, How to Debug Tests +@node Understanding Explanations @section Understanding Explanations Failed @code{should} forms are reported like this: @@ -667,7 +667,7 @@ ERT only provides explanations for predicates that have an explanation function registered. @xref{Defining Explanation Functions}. -@node Interactive Debugging, , Understanding Explanations, How to Debug Tests +@node Interactive Debugging @section Interactive Debugging Debugging failed tests essentially works the same way as debugging any @@ -712,7 +712,7 @@ forget about the obsolete test. @end itemize -@node Extending ERT, Other Testing Concepts, How to Debug Tests, Top +@node Extending ERT @chapter Extending ERT There are several ways to add functionality to ERT. @@ -723,7 +723,7 @@ There are several ways to add functionality to ERT. @end menu -@node Defining Explanation Functions, Low-Level Functions for Working with Tests, Extending ERT, Extending ERT +@node Defining Explanation Functions @section Defining Explanation Functions The explanation function for a predicate is a function that takes the @@ -741,7 +741,7 @@ The value of the property should be the symbol that names the explanation function. -@node Low-Level Functions for Working with Tests, , Defining Explanation Functions, Extending ERT +@node Low-Level Functions for Working with Tests @section Low-Level Functions for Working with Tests Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} @@ -757,7 +757,7 @@ meant to be usable by other code. But there is no mature API yet. Contributions to ERT are welcome. -@node Other Testing Concepts, GNU Free Documentation License , Extending ERT, Top +@node Other Testing Concepts @chapter Other Testing Concepts For information on mocks, stubs, fixtures, or test suites, see below. @@ -768,7 +768,7 @@ For information on mocks, stubs, fixtures, or test suites, see below. * Fixtures and Test Suites:: How ERT differs from tools for other languages. @end menu -@node Mocks and Stubs, Fixtures and Test Suites, Other Testing Concepts, Other Testing Concepts +@node Mocks and Stubs @section Other Tools for Emacs Lisp Stubbing out functions or using so-called @emph{mocks} can make it @@ -781,7 +781,7 @@ ERT does not have built-in support for mocks or stubs. The package offers mocks for Emacs Lisp and can be used in conjunction with ERT. -@node Fixtures and Test Suites, , Mocks and Stubs, Other Testing Concepts +@node Fixtures and Test Suites @section Fixtures and Test Suites In many ways, ERT is similar to frameworks for other languages like @@ -840,7 +840,7 @@ e.g., to run quick tests during interactive development and slow tests less often. This can be achieved with the @code{:tag} argument to @code{ert-deftest} and @code{tag} test selectors. -@node GNU Free Documentation License, , Other Testing Concepts, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index af457d7a9af..504940c5c6b 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -57,7 +57,7 @@ modify this GNU manual.'' @c ================================================================ @ifnottex -@node Top, What is Eshell?, (dir), (dir) +@node Top @top Eshell Eshell is a shell-like command interpreter diff --git a/doc/misc/eudc.texi b/doc/misc/eudc.texi index 03438eab58d..5b06cc7f11a 100644 --- a/doc/misc/eudc.texi +++ b/doc/misc/eudc.texi @@ -48,9 +48,8 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Overview, (dir), (dir) +@node Top @top Emacs Unified Directory Client -@comment node-name, next, previous, up @insertcopying @end ifnottex @@ -69,8 +68,7 @@ modify this GNU manual.'' -@node Overview, Installation, Top, Top -@comment node-name, next, previous, up +@node Overview @chapter Overview EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user @@ -115,8 +113,7 @@ Interface to BBDB to let you insert server records into your own BBDB database -@node LDAP, CCSO PH/QI, Overview, Overview -@comment node-name, next, previous, up +@node LDAP @section LDAP LDAP, @dfn{the Lightweight Directory Access Protocol}, is a communication @@ -142,8 +139,7 @@ EUDC requires external support to access LDAP directory servers (@pxref{LDAP Requirements}) -@node CCSO PH/QI, BBDB, LDAP, Overview -@comment node-name, next, previous, up +@node CCSO PH/QI @section CCSO PH/QI The Central Computing Services Office (CCSO) of the University of @@ -164,8 +160,7 @@ possible to change records in the database. This is not implemented in EUDC. -@node BBDB, , CCSO PH/QI, Overview -@comment node-name, next, previous, up +@node BBDB @section BBDB BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs @@ -187,8 +182,7 @@ performing queries on multiple servers. EUDC also offers a means to insert results from directory queries into your own local BBDB (@pxref{Creating BBDB Records}) -@node Installation, Usage, Overview, Top -@comment node-name, next, previous, up +@node Installation @chapter Installation Add the following to your @file{.emacs} init file: @@ -218,8 +212,7 @@ email composition buffers (@pxref{Inline Query Expansion}) * LDAP Requirements:: EUDC needs external support for LDAP @end menu -@node LDAP Requirements, , Installation, Installation -@comment node-name, next, previous, up +@node LDAP Requirements @section LDAP Requirements LDAP support is added by means of @file{ldap.el}, which is part of Emacs. @@ -228,8 +221,7 @@ LDAP support is added by means of @file{ldap.el}, which is part of Emacs. (@url{http://www.openldap.org/}). -@node Usage, Credits, Installation, Top -@comment node-name, next, previous, up +@node Usage @chapter Usage This chapter describes the usage of EUDC@. Most functions and @@ -248,8 +240,7 @@ submenu of the @samp{Tools} submenu. @end menu -@node Querying Servers, Query Form, Usage, Usage -@comment node-name, next, previous, up +@node Querying Servers @section Querying Servers EUDC's basic functionality is to let you query a directory server and @@ -263,7 +254,7 @@ to customize in this process. * Duplicate Attributes:: What to do when records have duplicate attributes @end menu -@node Selecting a Server, Return Attributes, Querying Servers, Querying Servers +@node Selecting a Server @subsection Selecting a Server Before doing any query you will need to set the directory server. You @@ -302,7 +293,7 @@ This command accessible from @samp{New Server} submenu lets you specify a new directory server and protocol. @end deffn -@node Return Attributes, Duplicate Attributes, Selecting a Server, Querying Servers +@node Return Attributes @subsection Return Attributes Directory servers may be configured to return a default set of @@ -326,7 +317,7 @@ If non-@code{nil}, entries that do not contain all the requested return attributes are ignored. Default is @code{t}. @end defopt -@node Duplicate Attributes, , Return Attributes, Querying Servers +@node Duplicate Attributes @subsection Duplicate Attributes Directory standards may authorize different instances of the same @@ -381,8 +372,7 @@ to all attribute names. Available methods are: @code{list}, -@node Query Form, Display of Query Results, Querying Servers, Usage -@comment node-name, next, previous, up +@node Query Form @section Query Form The simplest way to query your directory server is to use the query @@ -436,8 +426,7 @@ Otherwise, directory query/response forms display the user attribute names defined in @code{eudc-user-attribute-names-alist}. @end defvar -@node Display of Query Results, Inline Query Expansion, Query Form, Usage -@comment node-name, next, previous, up +@node Display of Query Results @section Display of Query Results Upon successful completion of a form query, EUDC will display a buffer @@ -514,8 +503,7 @@ be passed to the program. @end defvar -@node Inline Query Expansion, The Server Hotlist, Display of Query Results, Usage -@comment node-name, next, previous, up +@node Inline Query Expansion @section Inline Query Expansion Inline query expansion is a powerful method to get completion from your @@ -615,8 +603,7 @@ Default is @code{select} -@node The Server Hotlist, Multi-server Queries, Inline Query Expansion, Usage -@comment node-name, next, previous, up +@node The Server Hotlist @section The Server Hotlist EUDC lets you maintain a list of frequently used servers so that you @@ -654,8 +641,7 @@ loaded. * The Hotlist Edit Buffer:: An interactive hotlist editing facility @end menu -@node The Hotlist Edit Buffer, , The Server Hotlist, The Server Hotlist -@comment node-name, next, previous, up +@node The Hotlist Edit Buffer @subsection The Hotlist Edit Buffer The hotlist edit buffer offers a means to manage a list of frequently @@ -691,8 +677,7 @@ Save the changes and quit the hotlist edit buffer. Use @kbd{x} or @end deffn -@node Multi-server Queries, Creating BBDB Records, The Server Hotlist, Usage -@comment node-name, next, previous, up +@node Multi-server Queries @section Multi-server Queries When using inline query expansion (@pxref{Inline Query Expansion}), EUDC @@ -723,8 +708,7 @@ that all available servers should be tried. -@node Creating BBDB Records, Server/Protocol Locals, Multi-server Queries, Usage -@comment node-name, next, previous, up +@node Creating BBDB Records @section Creating BBDB Records @findex eudc-insert-record-at-point-into-bbdb @@ -839,8 +823,7 @@ Note that only a subset of the attributes you selected with actually be inserted as part of the newly created BBDB record. -@node Server/Protocol Locals, , Creating BBDB Records, Usage -@comment node-name, next, previous, up +@node Server/Protocol Locals @section Server/Protocol Locals EUDC can be customized independently for each server or directory @@ -852,8 +835,7 @@ like buffer-local bindings but on a per server or per protocol basis. * Manipulating local bindings:: Functions to set and query local bindings @end menu -@node Manipulating local bindings, , Server/Protocol Locals, Server/Protocol Locals -@comment node-name, next, previous, up +@node Manipulating local bindings @subsection Manipulating local bindings EUDC offers functions that let you set and query variables on a per @@ -930,8 +912,7 @@ Update all EUDC variables according to their local settings. -@node Credits, GNU Free Documentation License, Usage, Top -@comment node-name, next, previous, up +@node Credits @chapter Credits EUDC was written by Oscar Figueiredo based on @file{ph.el} by the @@ -940,18 +921,16 @@ same author. Thanks to Soren Dayton for his suggestions, his enthusiasm and his help in testing and proofreading the code and docs of @file{ph.el}. -@node GNU Free Documentation License, Command and Function Index, Credits, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Command and Function Index, Variables Index, GNU Free Documentation License, Top -@comment node-name, next, previous, up +@node Command and Function Index @unnumbered Command and Function Index @printindex fn -@node Variables Index, , Command and Function Index, Top -@comment node-name, next, previous, up +@node Variables Index @unnumbered Variables Index @printindex vr diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 35121e84dde..b5029e5d6a8 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -1579,6 +1579,10 @@ times you start Gnus. @vindex gnus-before-startup-hook A hook called as the first thing when Gnus is started. +@item gnus-before-resume-hook +@vindex gnus-before-resume-hook +A hook called as the first thing when Gnus is resumed after a suspend. + @item gnus-startup-hook @vindex gnus-startup-hook A hook run as the very last thing after starting up Gnus @@ -3641,6 +3645,15 @@ Describe the current group (@code{gnus-browse-describe-group}). @findex gnus-browse-describe-briefly Describe browse mode briefly (well, there's not much to describe, is there) (@code{gnus-browse-describe-briefly}). + +@item DEL +@kindex DEL (Browse) +@findex gnus-browse-delete-group +This function will delete the current group +(@code{gnus-browse-delete-group}). If given a prefix, this function +will actually delete all the articles in the group, and forcibly +remove the group itself from the face of the Earth. Use a prefix only +if you are absolutely sure of what you are doing. @end table @@ -14195,7 +14208,11 @@ what you need. @item nnimap-authenticator Some @acronym{IMAP} servers allow anonymous logins. In that case, -this should be set to @code{anonymous}. +this should be set to @code{anonymous}. If this variable isn't set, +the normal login methods will be used. If you wish to specify a +specific login method to be used, you can set this variable to either +@code{login} (the traditional @acronym{IMAP} login method), +@code{plain} or @code{cram-md5}. @item nnimap-expunge If non-@code{nil}, expunge articles after deleting them. This is always done @@ -14758,20 +14775,37 @@ This can be either the symbol @code{password} or the symbol @code{apop} and says what authentication scheme to use. The default is @code{password}. +@item :leave +Non-@code{nil} if the mail is to be left on the @acronym{POP} server +after fetching. Mails once fetched will never be fetched again by the +@acronym{UIDL} control. Only the built-in @code{pop3-movemail} program +(the default) supports this keyword. + +If this is neither @code{nil} nor a number, all mails will be left on +the server. If this is a number, leave mails on the server for this +many days since you first checked new mails. If this is @code{nil} +(the default), mails will be deleted on the server right after fetching. + +@vindex pop3-uidl-file +The @code{pop3-uidl-file} variable specifies the file to which the +@acronym{UIDL} data are locally stored. The default value is +@file{~/.pop3-uidl}. + +Note that @acronym{POP} servers maintain no state information between +sessions, so what the client believes is there and what is actually +there may not match up. If they do not, then you may get duplicate +mails or the whole thing can fall apart and leave you with a corrupt +mailbox. + @end table -@vindex pop3-movemail +@findex pop3-movemail @vindex pop3-leave-mail-on-server If the @code{:program} and @code{:function} keywords aren't specified, -@code{pop3-movemail} will be used. If @code{pop3-leave-mail-on-server} -is non-@code{nil} the mail is to be left on the @acronym{POP} server -after fetching when using @code{pop3-movemail}. Note that POP servers -maintain no state information between sessions, so what the client -believes is there and what is actually there may not match up. If they -do not, then you may get duplicate mails or the whole thing can fall -apart and leave you with a corrupt mailbox. +@code{pop3-movemail} will be used. Here are some examples for getting mail from a @acronym{POP} server. + Fetch from the default @acronym{POP} server, using the default user name, and default fetcher: @@ -14786,6 +14820,14 @@ Fetch from a named server with a named user and password: :user "user-name" :password "secret") @end lisp +Leave mails on the server for 14 days: + +@lisp +(pop :server "my.pop.server" + :user "user-name" :password "secret" + :leave 14) +@end lisp + Use @samp{movemail} to move the mail: @lisp diff --git a/doc/misc/gpl.texi b/doc/misc/gpl.texi index 1908d1f8f98..0e2e212acb1 100644 --- a/doc/misc/gpl.texi +++ b/doc/misc/gpl.texi @@ -2,7 +2,7 @@ @center Version 3, 29 June 2007 @c This file is intended to be included within another document, -@c hence no sectioning command or @node. +@c hence no sectioning command or @node. @display Copyright @copyright{} 2007 Free Software Foundation, Inc. @url{http://fsf.org/} @@ -222,7 +222,7 @@ terms of section 4, provided that you also meet all of these conditions: @enumerate a -@item +@item The work must carry prominent notices stating that you modified it, and giving a relevant date. @@ -623,12 +623,12 @@ later version. @item Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +APPLICABLE LAW@. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND -PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE +A PARTICULAR PURPOSE@. THE ENTIRE RISK AS TO THE QUALITY AND +PERFORMANCE OF THE PROGRAM IS WITH YOU@. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. @@ -670,7 +670,7 @@ state the exclusion of warranty; and each file should have at least the ``copyright'' line and a pointer to where the full notice is found. @smallexample -@var{one line to give the program's name and a brief idea of what it does.} +@var{one line to give the program's name and a brief idea of what it does.} Copyright (C) @var{year} @var{name of author} This program is free software: you can redistribute it and/or modify @@ -680,7 +680,7 @@ your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License @@ -693,7 +693,7 @@ If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: @smallexample -@var{program} Copyright (C) @var{year} @var{name of author} +@var{program} Copyright (C) @var{year} @var{name of author} This program comes with ABSOLUTELY NO WARRANTY; for details type @samp{show w}. This is free software, and you are welcome to redistribute it under certain conditions; type @samp{show c} for details. diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 499e169e93b..a756cc6b6c6 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi @@ -55,7 +55,7 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Introduction, (dir), (dir) +@node Top @top IDLWAVE IDLWAVE is a package which supports editing source code written in the @@ -165,7 +165,7 @@ Catalogs @end detailmenu @end menu -@node Introduction, IDLWAVE in a Nutshell, Top, Top +@node Introduction @chapter Introduction @cindex Introduction @cindex CORBA (Common Object Request Broker Architecture) @@ -271,7 +271,7 @@ configure it, see the documentation string of that variable (available with @kbd{C-h v}). Some configuration examples are also given in the appendix. -@node IDLWAVE in a Nutshell, Getting Started, Introduction, Top +@node IDLWAVE in a Nutshell @chapter IDLWAVE in a Nutshell @cindex Summary of important commands @cindex IDLWAVE in a Nutshell @@ -365,7 +365,7 @@ at point. <A NAME="TUTORIAL"></A> @end html -@node Getting Started, The IDLWAVE Major Mode, IDLWAVE in a Nutshell, Top +@node Getting Started @chapter Getting Started (Tutorial) @cindex Quick-Start @cindex Tutorial @@ -377,7 +377,7 @@ at point. * Lesson III---User Catalog:: @end menu -@node Lesson I---Development Cycle, Lesson II---Customization, Getting Started, Getting Started +@node Lesson I---Development Cycle @section Lesson I: Development Cycle The purpose of this tutorial is to guide you through a very basic @@ -551,7 +551,7 @@ 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 @section Lesson II: Customization Emacs is probably the most customizable piece of software ever written, @@ -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 @section Lesson III: User and Library Catalogs We have already used the routine info display in the first part of this @@ -721,7 +721,7 @@ the manual, look at the documentation strings of interesting variables (with @kbd{C-h v idlwave<-variable-name> @key{RET}}) and ask the remaining questions on the newsgroup @code{comp.lang.idl-pvwave}. -@node The IDLWAVE Major Mode, The IDLWAVE Shell, Getting Started, Top +@node The IDLWAVE Major Mode @chapter The IDLWAVE Major Mode @cindex IDLWAVE major mode @cindex Major mode, @code{idlwave-mode} @@ -745,7 +745,7 @@ them. * Misc Options:: Things that fit nowhere else @end menu -@node Code Formatting, Routine Info, The IDLWAVE Major Mode, The IDLWAVE Major Mode +@node Code Formatting @section Code Formatting @cindex Code formatting @cindex Formatting, of code @@ -773,7 +773,7 @@ you. After configuring it to match your coding standards, you can rely on it to help keep your code neat and organized. -@node Code Indentation, Continued Statement Indentation, Code Formatting, Code Formatting +@node Code Indentation @subsection Code Indentation @cindex Code indentation @cindex Indentation @@ -813,7 +813,7 @@ Extra indentation applied to block END lines. A value equal to negative BEGIN lines. @end defopt -@node Continued Statement Indentation, Comment Indentation, Code Indentation, Code Formatting +@node Continued Statement Indentation @subsection Continued Statement Indentation @cindex Indentation, continued statement @cindex Continued statement indentation @@ -887,7 +887,7 @@ parenthesis, regardless of whether the @code{idlwave-max-extra-continuation-indent} limit is satisfied. @end defopt -@node Comment Indentation, Continuation Lines, Continued Statement Indentation, Code Formatting +@node Comment Indentation @subsection Comment Indentation @cindex Comment indentation @cindex Hanging paragraphs @@ -924,7 +924,7 @@ A comment that starts with this regexp is indented as if it is a part of IDL code. @end defopt -@node Continuation Lines, Syntax Highlighting, Comment Indentation, Code Formatting +@node Continuation Lines @subsection Continuation Lines and Filling @cindex Continuation lines @cindex Line splitting @@ -1000,7 +1000,7 @@ Non-@code{nil} means use last match on line for @code{idlwave-indent-regexp}. @end defopt -@node Syntax Highlighting, Octals and Highlighting, Continuation Lines, Code Formatting +@node Syntax Highlighting @subsection Syntax Highlighting @cindex Syntax highlighting @cindex Highlighting of syntax @@ -1028,7 +1028,7 @@ Items which should be fontified on the default fontification level 2. @end defopt -@node Octals and Highlighting, , Syntax Highlighting, Code Formatting +@node Octals and Highlighting @subsection Octals and Highlighting @cindex Syntax highlighting, Octals @cindex Highlighting of syntax, Octals @@ -1058,7 +1058,7 @@ altogether, and use the more sensible alternative IDL provides: @noindent This simultaneously solves the font-lock problem and is more consistent with the notation for hexadecimal numbers, e.g., @code{'C5'XB}. -@node Routine Info, Online Help, Code Formatting, The IDLWAVE Major Mode +@node Routine Info @section Routine Info @cindex Routine info @cindex Updating routine info @@ -1236,7 +1236,7 @@ Maximum number of source files displayed in the Routine Info window. @html <A NAME="ONLINE_HELP"></A> @end html -@node Online Help, Completion, Routine Info, The IDLWAVE Major Mode +@node Online Help @section Online Help @cindex Online Help @@ -1343,7 +1343,7 @@ directly in the originating source file. * Help with Source:: @end menu -@node Help with HTML Documentation, Help with Source, Online Help, Online Help +@node Help with HTML Documentation @subsection Help with HTML Documentation @cindex HTML Help @cindex Help using HTML manuals @@ -1422,7 +1422,7 @@ contains "-w3". The face for links to IDLWAVE online help. @end defopt -@node Help with Source, , Help with HTML Documentation, Online Help +@node Help with Source @subsection Help with Source @cindex Help using routine source @@ -1509,7 +1509,7 @@ The case-insensitive heading word in doclib headers to locate the @end defopt -@node Completion, Routine Source, Online Help, The IDLWAVE Major Mode +@node Completion @section Completion @cindex Completion @cindex Keyword completion @@ -1617,7 +1617,7 @@ available. * Structure Tag Completion:: Completing state.Tag @end menu -@node Case of Completed Words, Object Method Completion and Class Ambiguity, Completion, Completion +@node Case of Completed Words @subsection Case of Completed Words @cindex Case of completed words @cindex Mixed case completion @@ -1654,7 +1654,7 @@ Non-@code{nil} means the empty string is considered lower case for completion. @end defopt -@node Object Method Completion and Class Ambiguity, Object Method Completion in the Shell, Case of Completed Words, Completion +@node Object Method Completion and Class Ambiguity @subsection Object Method Completion and Class Ambiguity @cindex Object methods @cindex Class ambiguity @@ -1717,7 +1717,7 @@ Face to highlight object operator arrows @samp{->} which carry a saved class text property. @end defopt -@node Object Method Completion in the Shell, Class and Keyword Inheritance, Object Method Completion and Class Ambiguity, Completion +@node Object Method Completion in the Shell @subsection Object Method Completion in the Shell @cindex Method Completion in Shell In the IDLWAVE Shell (@pxref{The IDLWAVE Shell}), objects on which @@ -1730,7 +1730,7 @@ class found will be used to select appropriate completions, routine info, or help. If unsuccessful, information from all known classes will be used (as in the buffer). -@node Class and Keyword Inheritance, Structure Tag Completion, Object Method Completion in the Shell, Completion +@node Class and Keyword Inheritance @subsection Class and Keyword Inheritance @cindex Inheritance, class @cindex Keyword inheritance @@ -1776,7 +1776,7 @@ A list of regular expressions to match methods for which simple class-driven keyword inheritance will be used for Completion. @end defopt -@node Structure Tag Completion, , Class and Keyword Inheritance, Completion +@node Structure Tag Completion @subsection Structure Tag Completion @cindex Completion, structure tag @cindex Structure tag completion @@ -1818,7 +1818,7 @@ IDL> st.[Tab] @noindent will complete with all structure fields of the structure @code{st}. -@node Routine Source, Resolving Routines, Completion, The IDLWAVE Major Mode +@node Routine Source @section Routine Source @cindex Routine source file @cindex Module source file @@ -1844,7 +1844,7 @@ sometimes created. The special command @kbd{C-c C-k} (@code{idlwave-kill-autoloaded-buffers}) can be used to easily remove these buffers. -@node Resolving Routines, Code Templates, Routine Source, The IDLWAVE Major Mode +@node Resolving Routines @section Resolving Routines @cindex @code{RESOLVE_ROUTINE} @cindex Compiling library modules @@ -1865,7 +1865,7 @@ compile the modules first, and even without a running shell. @xref{Sources of Routine Info}, for more information on the ways IDLWAVE collects data about routines, and how to update this information. -@node Code Templates, Abbreviations, Resolving Routines, The IDLWAVE Major Mode +@node Code Templates @section Code Templates @cindex Code templates @cindex Templates @@ -1887,7 +1887,7 @@ templates, this is done with direct key bindings: All code templates are also available as abbreviations (@pxref{Abbreviations}). -@node Abbreviations, Actions, Code Templates, The IDLWAVE Major Mode +@node Abbreviations @section Abbreviations @cindex Abbreviations @@ -2073,7 +2073,7 @@ Non-@code{nil} means the abbrev hook can move point, e.g., to end up between the parentheses of a function call. @end defopt -@node Actions, Doc Header, Abbreviations, The IDLWAVE Major Mode +@node Actions @section Actions @cindex Actions @cindex Coding standards, enforcing @@ -2121,7 +2121,7 @@ settings are described below and set separately. * Case Changes:: Enforcing upper case keywords @end menu -@node Block Boundary Check, Padding Operators, Actions, Actions +@node Block Boundary Check @subsection Block Boundary Check @cindex Block boundary check @cindex @code{END} type checking @@ -2154,7 +2154,7 @@ Non-@code{nil} means expand generic END to ENDIF/ENDELSE/ENDWHILE etc. Non-@code{nil} means re-indent line after END was typed. @end defopt -@node Padding Operators, Case Changes, Block Boundary Check, Actions +@node Padding Operators @subsection Padding Operators @cindex Padding operators with spaces @cindex Operators, padding with spaces @@ -2203,7 +2203,7 @@ surrounded with spaces by @code{idlwave-surround}. Non-@code{nil} means space-pad the @samp{=} in keyword assignments. @end defopt -@node Case Changes, , Padding Operators, Actions +@node Case Changes @subsection Case Changes @cindex Case changes @cindex Upcase, enforcing for reserved words @@ -2245,7 +2245,7 @@ expansion. @end defopt -@node Doc Header, Motion Commands, Actions, The IDLWAVE Major Mode +@node Doc Header @section Documentation Header @cindex Documentation header @cindex DocLib header @@ -2289,7 +2289,7 @@ Regexp matching the start of a document library header. Regexp matching the start of a document library header. @end defopt -@node Motion Commands, Misc Options, Doc Header, The IDLWAVE Major Mode +@node Motion Commands @section Motion Commands @cindex Motion commands @cindex Program structure, moving through @@ -2339,7 +2339,7 @@ IDL program: @end multitable -@node Misc Options, , Motion Commands, The IDLWAVE Major Mode +@node Misc Options @section Miscellaneous Options @cindex Hooks @@ -2360,7 +2360,7 @@ Normal hook. Executed when a buffer is put into @code{idlwave-mode}. Normal hook. Executed when @file{idlwave.el} is loaded. @end defopt -@node The IDLWAVE Shell, Acknowledgments, The IDLWAVE Major Mode, Top +@node The IDLWAVE Shell @chapter The IDLWAVE Shell @cindex IDLWAVE shell @cindex Major mode, @code{idlwave-shell-mode} @@ -2389,7 +2389,7 @@ currently only works under Unix and MacOSX. * Custom Expression Examination:: @end menu -@node Starting the Shell, Using the Shell, The IDLWAVE Shell, The IDLWAVE Shell +@node Starting the Shell @section Starting the Shell @cindex Starting the shell @cindex Shell, starting @@ -2499,7 +2499,7 @@ The prefix for temporary IDL files used when compiling regions. Hook for customizing @code{idlwave-shell-mode}. @end defopt -@node Using the Shell, Commands Sent to the Shell, Starting the Shell, The IDLWAVE Shell +@node Using the Shell @section Using the Shell @cindex Comint @cindex Shell, basic commands @@ -2626,7 +2626,7 @@ The three regular expressions which match the magic spells for input modes. @end defopt -@node Commands Sent to the Shell, Debugging IDL Programs, Using the Shell, The IDLWAVE Shell +@node Commands Sent to the Shell @section Commands Sent to the Shell @cindex Commands in shell, showing @cindex Showing commands in shell @@ -2667,7 +2667,7 @@ As a special case, any error message in the output will be displayed (e.g., stepping to an error). @end defopt -@node Debugging IDL Programs, Examining Variables, Commands Sent to the Shell, The IDLWAVE Shell +@node Debugging IDL Programs @section Debugging IDL Programs @cindex Debugging @cindex Keybindings for debugging @@ -2705,7 +2705,7 @@ buffers. @end menu -@node A Tale of Two Modes, Debug Key Bindings, Debugging IDL Programs, Debugging IDL Programs +@node A Tale of Two Modes @subsection A Tale of Two Modes @cindex Electric Debug Mode @cindex Debugging Interface @@ -2725,7 +2725,7 @@ Mode}, for more on that mode. Note that electric debug mode can be prevented from activating automatically by customizing the variable @code{idlwave-shell-automatic-electric-debug}. -@node Debug Key Bindings, Breakpoints and Stepping, A Tale of Two Modes, Debugging IDL Programs +@node Debug Key Bindings @subsection Debug Key Bindings @kindex C-c C-d @cindex Key bindings @@ -2771,7 +2771,7 @@ more of @code{control}, @code{meta}, @code{super}, @code{hyper}, @code{alt}, and @code{shift}. @end defopt -@node Breakpoints and Stepping, Compiling Programs, Debug Key Bindings, Debugging IDL Programs +@node Breakpoints and Stepping @subsection Breakpoints and Stepping @cindex Breakpoints @cindex Stepping @@ -2903,7 +2903,7 @@ configured in @code{idlwave-shell-mark-stop-line}. @end defopt -@node Compiling Programs, Walking the Calling Stack, Breakpoints and Stepping, Debugging IDL Programs +@node Compiling Programs @subsection Compiling Programs @cindex Compiling programs @cindex Programs, compiling @@ -2936,7 +2936,7 @@ level program @kbd{C-c C-d C-e} (@code{idlwave-shell-run-region}) is very useful. A temporary file is created holding the contents of the current region (with @code{END} appended), and run from the shell. -@node Walking the Calling Stack, Electric Debug Mode, Compiling Programs, Debugging IDL Programs +@node Walking the Calling Stack @subsection Walking the Calling Stack @cindex Calling stack, walking @@ -2958,7 +2958,7 @@ higher calling stack levels. @html <A NAME="EDEBUG"></A> @end html -@node Electric Debug Mode, , Walking the Calling Stack, Debugging IDL Programs +@node Electric Debug Mode @subsection Electric Debug Mode @cindex Electric Debug Mode @cindex @samp{*Debugging*} @@ -3095,7 +3095,7 @@ window, but is useful for immediate stepping, etc. @html <A NAME="EXAMINE"></A> @end html -@node Examining Variables, Custom Expression Examination, Debugging IDL Programs, The IDLWAVE Shell +@node Examining Variables @section Examining Variables @cindex @code{PRINT} expressions @cindex @code{HELP}, on expressions @@ -3202,7 +3202,7 @@ The maximum number of leading array entries to print, when examining array expressions. @end defopt -@node Custom Expression Examination, , Examining Variables, The IDLWAVE Shell +@node Custom Expression Examination @section Custom Expression Examination @cindex Expressions, custom examination @cindex Custom expression examination @@ -3272,7 +3272,7 @@ examine command strings to send, after all instances of @code{___} (three underscores) are replaced by the indicated expression. @end defopt -@node Acknowledgments, Sources of Routine Info, The IDLWAVE Shell, Top +@node Acknowledgments @chapter Acknowledgments @cindex Acknowledgments @cindex Maintainer, of IDLWAVE @@ -3351,7 +3351,7 @@ scripts and documentation to interface with the IDL Assistant. @noindent Thanks to everyone! -@node Sources of Routine Info, HTML Help Browser Tips, Acknowledgments, Top +@node Sources of Routine Info @appendix Sources of Routine Info @cindex Sources of routine information @@ -3368,7 +3368,7 @@ know about the accessible routines. * Documentation Scan:: Scanning the IDL Manuals @end menu -@node Routine Definitions, Routine Information Sources, Sources of Routine Info, Sources of Routine Info +@node Routine Definitions @appendixsec Routine Definitions @cindex Routine definitions @cindex IDL variable @code{!PATH} @@ -3404,7 +3404,7 @@ cannot provide routine info and completion for such external routines, except by querying the Shell for calling information (DLMs only). @end enumerate -@node Routine Information Sources, Catalogs, Routine Definitions, Sources of Routine Info +@node Routine Information Sources @appendixsec Routine Information Sources @cindex Routine info sources @cindex Builtin list of routines @@ -3491,7 +3491,7 @@ Controls under what circumstances routine info is updated automatically. @html <A NAME="CATALOGS"></A> @end html -@node Catalogs, Load-Path Shadows, Routine Information Sources, Sources of Routine Info +@node Catalogs @appendixsec Catalogs @cindex Catalogs @@ -3553,7 +3553,7 @@ later). @html <A NAME="LIBRARY_CATALOGS"></A> @end html -@node Library Catalogs, User Catalog, Catalogs, Catalogs +@node Library Catalogs @appendixsubsec Library Catalogs @cindex @file{.idlwave_catalog} @cindex Library catalogs @@ -3617,7 +3617,7 @@ Whether to search for and load library catalogs. Disable if load performance is a problem and/or the catalogs are not needed. @end defopt -@node User Catalog, , Library Catalogs, Catalogs +@node User Catalog @appendixsubsec User Catalog @cindex User catalog @cindex IDL library routine info @@ -3690,7 +3690,7 @@ Alist of regular expressions matching special library directories for labeling in routine-info display. @end defopt -@node Load-Path Shadows, Documentation Scan, Catalogs, Sources of Routine Info +@node Load-Path Shadows @appendixsec Load-Path Shadows @cindex Load-path shadows @cindex Shadows, load-path @@ -3750,7 +3750,7 @@ routines. Another way to find out if a specific routine has multiple definitions on the load path is routine info display (@pxref{Routine Info}). -@node Documentation Scan, , Load-Path Shadows, Sources of Routine Info +@node Documentation Scan @appendixsec Documentation Scan @cindex @file{get_html_rinfo} @cindex @file{idlw-rinfo.el} @@ -3783,7 +3783,7 @@ scanning the HTML documents produced from the IDL documentation. Instructions on how to use @file{get_html_rinfo} are in the program itself. -@node HTML Help Browser Tips, Configuration Examples, Sources of Routine Info, Top +@node HTML Help Browser Tips @appendix HTML Help Browser Tips @cindex Browser Tips @@ -3858,7 +3858,7 @@ Note that you can open the file in an external browser from within @code{w3m} using @kbd{M}. @end itemize -@node Configuration Examples, Windows and MacOS, HTML Help Browser Tips, Top +@node Configuration Examples @appendix Configuration Examples @cindex Configuration examples @cindex Example configuration @@ -4021,7 +4021,7 @@ user is King! @html <A NAME="WINDOWS_MAC"></A> @end html -@node Windows and MacOS, Troubleshooting, Configuration Examples, Top +@node Windows and MacOS @appendix Windows and MacOS @cindex Windows @cindex MacOS @@ -4079,7 +4079,7 @@ help can skip the browser and use the HTMLHelp functionality directly. @html <A NAME="TROUBLE"></A> @end html -@node Troubleshooting, GNU Free Documentation License, Windows and MacOS, Top +@node Troubleshooting @appendix Troubleshooting @cindex Troubleshooting @@ -4285,11 +4285,11 @@ IDLWAVE is @samp{fsf-compat, xemacs-base, mail-lib}. @end enumerate -@node GNU Free Documentation License, Index, Troubleshooting, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top +@node Index @unnumbered Index @printindex cp diff --git a/doc/misc/makefile.w32-in b/doc/misc/makefile.w32-in index b0ea0ed1518..11c76dcfcf7 100644 --- a/doc/misc/makefile.w32-in +++ b/doc/misc/makefile.w32-in @@ -259,9 +259,9 @@ $(infodir)/ebrowse$(INFO_EXT): ebrowse.texi ebrowse.dvi: ebrowse.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/ebrowse.texi -$(infodir)/woman$(INFO_EXT): woman.texi +$(infodir)/woman$(INFO_EXT): woman.texi $(emacsdir)/emacsver.texi $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ woman.texi -woman.dvi: woman.texi +woman.dvi: woman.texi $(emacsdir)/emacsver.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/woman.texi $(infodir)/speedbar$(INFO_EXT): speedbar.texi @@ -309,9 +309,9 @@ $(infodir)/rcirc$(INFO_EXT): rcirc.texi rcirc.dvi: rcirc.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/rcirc.texi -$(infodir)/erc$(INFO_EXT): erc.texi gpl.texi +$(infodir)/erc$(INFO_EXT): erc.texi $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ erc.texi -erc.dvi: erc.texi gpl.texi +erc.dvi: erc.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/erc.texi $(infodir)/ert$(INFO_EXT): ert.texi diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi index fa35aa45984..756d5d52996 100644 --- a/doc/misc/mh-e.texi +++ b/doc/misc/mh-e.texi @@ -8,12 +8,12 @@ @c %**end of header @c Version of the software and manual. -@set VERSION 8.3 +@set VERSION 8.4 @c Edition of the manual. It is either empty for the first edition or @c has the form ", nth Edition" (without the quotes). @set EDITION -@set UPDATED 2011-09-20 -@set UPDATE-MONTH September, 2011 +@set UPDATED 2012-11-25 +@set UPDATE-MONTH November, 2012 @c Other variables. @set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh @@ -212,7 +212,7 @@ more niceties about GNU Emacs and MH@. Now I'm fully hooked on both of them. 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 +@value{VERSION} of MH-E appeared in Emacs 24.4. 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 @@ -6966,23 +6966,22 @@ swish-e -c /home/user/Mail/.swish/config @cindex @command{mairix} @cindex Unix commands, @command{mairix} -In the examples below, replace @file{/home/user/Mail} with the path to -your MH directory. +In the examples below, replace @file{~/Mail} with the path to your MH +directory. -First create the directory @file{/home/user/Mail/.mairix}. Then create -the file @file{/home/user/Mail/.mairix/config} with the following -contents: +First create the directory @file{~/Mail/.mairix}. Then create the file +@file{~/Mail/.mairix/config} with the following contents: @smallexample @group -base=/home/user/Mail +base=~/Mail # List of folders that should be indexed. 3 dots at the end means there # are subfolders within the folder mh=archive...:inbox:drafts:news:sent:trash -vfolder_format=mh -database=/home/user/Mail/.mairix/database +mformat=mh +database=~/Mail/.mairix/database @end group @end smallexample @@ -6990,7 +6989,7 @@ Use the following command line to generate the mairix index. Run this daily from cron: @smallexample -mairix -f /home/user/Mail/.mairix/config +mairix -f ~/Mail/.mairix/config @end smallexample @subsection namazu @@ -7395,6 +7394,9 @@ The name of the MH sequence for ticked messages (default: @samp{'tick}). @item mh-update-sequences-after-mh-show-flag On means flush MH sequences to disk after message is shown (default: @samp{on}). +@item mh-whitelist-preserves-sequences-flag +On means that sequences are preserved when messages are whitelisted +(default: @samp{on}). @end vtable The following hook is available. @@ -7600,6 +7602,40 @@ Disposition of junk mail (default: @samp{Delete Spam}). Spam program that MH-E should use (default: @samp{Auto-detect}). @end vtable +@cindex @samp{mh-sequences} customization group +@cindex customization group, @samp{mh-sequences} + +The following option in the @samp{mh-sequences} customization group is +also available. + +@vtable @code +@item mh-whitelist-preserves-sequences-flag +On means that sequences are preserved when messages are whitelisted +(default: @samp{on}). +@end vtable + +The following hooks are available. + +@vtable @code +@item mh-blacklist-msg-hook +Hook run by @kbd{J b} (@code{mh-junk-blacklist}) after marking each +message for blacklisting (default: @code{nil}). +@c ------------------------- +@item mh-whitelist-msg-hook +Hook run by @kbd{J w} (@code{mh-junk-whitelist}) after marking each +message for whitelisting (default @samp{nil}). +@end vtable + +The following faces are available. + +@vtable @code +@item mh-folder-blacklisted +Blacklisted message face. +@c ------------------------- +@item mh-folder-whitelisted +Whitelisted message face +@end vtable + @cindex SpamProbe @cindex Spamassassin @cindex bogofilter @@ -7642,6 +7678,18 @@ reclassifies a range of messages (@pxref{Ranges}) as ham if it were incorrectly classified as spam. It then refiles the message into the @file{+inbox} folder. +@cindex MH profile component, @samp{Previous-Sequence:} +@cindex @samp{cur} sequence +@cindex @samp{Previous-Sequence:} MH profile component +@cindex sequence, @samp{cur} +@cindex sequence, @samp{Previous-Sequence} +@vindex mh-whitelist-preserves-sequences-flag + +If a message is in any sequence (except @samp{Previous-Sequence:} and +@samp{cur}) when it is whitelisted, then it will still be in those +sequences in the destination folder. If this behavior is not desired, +then turn off the option @code{mh-whitelist-preserves-sequences-flag}. + @cindex @samp{*MH-E Log*} @cindex buffers, @samp{*MH-E Log*} @findex call-process diff --git a/doc/misc/pcl-cvs.texi b/doc/misc/pcl-cvs.texi index df972d7991f..7c294591d0e 100644 --- a/doc/misc/pcl-cvs.texi +++ b/doc/misc/pcl-cvs.texi @@ -58,8 +58,8 @@ modify this GNU manual.'' @c The real text starts here @c ================================================================ -@node Top, About PCL-CVS, (dir), (dir) @ifnottex +@node Top @top PCL-CVS This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It @@ -127,7 +127,7 @@ Customization @end detailmenu @end menu -@node About PCL-CVS, Getting started, Top, Top +@node About PCL-CVS @chapter About PCL-CVS @cindex About PCL-CVS @@ -151,7 +151,7 @@ functionality and taking over the maintenance. * Contributors:: Contributors to PCL-CVS. @end menu -@node Contributors,, About PCL-CVS, About PCL-CVS +@node Contributors @section Contributors to PCL-CVS @cindex Contributors @cindex Authors @@ -228,7 +228,7 @@ requests, bug reports and encouragement. Thanks a lot! Without you there would be no new releases of PCL-CVS. -@node Getting started, Buffer contents, About PCL-CVS, Top +@node Getting started @chapter Getting started @cindex Introduction @cindex Example run @@ -296,7 +296,7 @@ press @kbd{l} to get the output from @samp{cvs log}. Many more such commands are available simply by pressing a key (@pxref{Getting info about files}). -@node Buffer contents, Selected files, Getting started, Top +@node Buffer contents @chapter Buffer contents @cindex Buffer contents @cindex @code{*cvs*} buffer contents @@ -425,7 +425,7 @@ The file has been unexpectedly removed from your working directory although it has not been @samp{cvs remove}d. @end table -@node Selected files, Commands, Buffer contents, Top +@node Selected files @chapter Selected files @cindex Selected files @cindex Marked files @@ -467,7 +467,7 @@ it, it is quite powerful. For commands to mark and unmark files, see @ref{Marking files}. -@node Commands, Log Edit Mode, Selected files, Top +@node Commands @chapter Commands @iftex @@ -501,7 +501,7 @@ you can use in PCL-CVS@. They are grouped together by type. @end menu -@node Entering PCL-CVS, Setting flags, Commands, Commands +@node Entering PCL-CVS @section Entering PCL-CVS @findex cvs-update @findex cvs-examine @@ -561,7 +561,7 @@ argument to the command (e.g., by typing @kbd{C-u M-x cvs-update @key{RET} -l @key{RET}}). -@node Setting flags, Updating the buffer, Entering PCL-CVS, Commands +@node Setting flags @section Setting flags for CVS commands @cindex Optional switches to CVS @cindex Command-line options to CVS @@ -617,7 +617,7 @@ Forces the next command to apply to every selected file rather than only to the ones PCL-CVS thinks are relevant. @end table -@node Updating the buffer, Movement commands, Setting flags, Commands +@node Updating the buffer @section Updating the @samp{*cvs*} buffer @findex cvs-update @findex cvs-examine @@ -662,7 +662,7 @@ put in @samp{cvs-status-mode}.@refill @end table -@node Movement commands, Marking files, Updating the buffer, Commands +@node Movement commands @section Movement Commands @cindex Movement Commands @findex cvs-mode-next-line @@ -688,7 +688,7 @@ This key moves one file backward, towards the beginning of the buffer @end table -@node Marking files, Committing changes, Movement commands, Commands +@node Marking files @section Marking files @cindex Selecting files (commands to mark files) @cindex Marking files @@ -746,7 +746,7 @@ Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}). @end table -@node Committing changes, Editing files, Marking files, Commands +@node Committing changes @section Committing changes @cindex Committing changes @findex cvs-mode-commit @@ -805,7 +805,7 @@ your buffer, or if @samp{cvs-auto-revert} is set to @samp{nil}. -@node Editing files, Getting info about files, Committing changes, Commands +@node Editing files @section Editing files @cindex Editing files @cindex Finding files @@ -842,7 +842,7 @@ directory (@code{cvs-mode-add-change-log-entry-other-window}).@refill @end table -@node Getting info about files, Adding and removing files, Editing files, Commands +@node Getting info about files @section Getting info about files @cindex Status (cvs command) @cindex Log (RCS/cvs command) @@ -867,7 +867,7 @@ all selected files, and show the result in a temporary buffer @end table -@node Adding and removing files, Undoing changes, Getting info about files, Commands +@node Adding and removing files @section Adding and removing files @cindex Adding files @cindex Removing files @@ -908,7 +908,7 @@ The command that is run is @code{cvs-mode-remove-file}. @end table -@node Undoing changes, Removing handled entries, Adding and removing files, Commands +@node Undoing changes @section Undoing changes @cindex Undo changes @cindex Flush changes @@ -924,7 +924,7 @@ version from the repository (@code{cvs-mode-undo-local-changes}). @end table -@node Removing handled entries, Ignoring files, Undoing changes, Commands +@node Removing handled entries @section Removing handled entries @cindex Expunging uninteresting entries @cindex Uninteresting entries, getting rid of them @@ -956,7 +956,7 @@ not delete, but that you want to delete (@code{cvs-mode-acknowledge}). @end table -@node Ignoring files, Viewing differences, Removing handled entries, Commands +@node Ignoring files @section Ignoring files @cindex Ignoring files @kindex i@r{--ignoring files} @@ -974,7 +974,7 @@ but you could ignore it as well, if you like it better that way. This runs @code{cvs-mode-ignore}. @end table -@node Viewing differences, Invoking Ediff, Ignoring files, Commands +@node Viewing differences @section Viewing differences @cindex Diff @cindex Invoking @code{diff} @@ -1037,7 +1037,7 @@ head revision in the repository By default, @samp{diff} commands ignore the marks. This can be changed with @code{cvs-invert-ignore-marks}. -@node Invoking Ediff, Updating files, Viewing differences, Commands +@node Invoking Ediff @section Running ediff @cindex Ediff @cindex Invoking ediff @@ -1069,7 +1069,7 @@ any way if you use this command. If you use the @kbd{q} command inside created will be overwritten.@refill @end table -@node Updating files, Tagging files, Invoking Ediff, Commands +@node Updating files @section Updating files @findex cvs-mode-update @cindex Updating files @@ -1082,7 +1082,7 @@ Update all selected files with status @samp{Need-update} by running @end table -@node Tagging files, Miscellaneous commands, Updating files, Commands +@node Tagging files @section Tagging files @findex cvs-mode-tag @findex cvs-mode-untag @@ -1109,7 +1109,7 @@ only be applied to directories, see @code{cvs-force-dir-tag} if you want to change this behavior. -@node Miscellaneous commands, , Tagging files, Commands +@node Miscellaneous commands @section Miscellaneous commands @findex cvs-mode-byte-compile-files @cindex Recompiling elisp files @@ -1154,7 +1154,7 @@ Bury the PCL-CVS buffer (@code{cvs-bury-buffer}). Quit PCL-CVS, killing the @samp{*cvs*} buffer. @end table -@node Log Edit Mode, Log View Mode, Commands, Top +@node Log Edit Mode @chapter Editing a Log Message @cindex Log Edit mode @@ -1187,7 +1187,7 @@ exit the buffer and commit the change. @c Fixme: customization variables -@node Log View Mode, Customization, Log Edit Mode, Top +@node Log View Mode @chapter Browsing a Log of Changes @cindex Log View mode @@ -1208,7 +1208,7 @@ argument, these commands move that many messages of files. @c @node CVS Status Mode @c @chapter Viewing CVS' Status output -@node Customization, Bugs, Log View Mode, Top +@node Customization @chapter Customization @vindex log-edit-changelog-full-paragraphs@r{ (variable)} @vindex cvs-auto-remove-handled@r{ (variable)} @@ -1319,7 +1319,7 @@ default. * Customizing Faces:: @end menu -@node Customizing Faces, , Customization, Customization +@node Customizing Faces @section Customizing Faces @vindex cvs-header (face) @vindex cvs-filename (face) @@ -1358,7 +1358,7 @@ Used to highlight CVS messages. @end table -@node Bugs, GNU Free Documentation License, Customization, Top +@node Bugs @chapter Bugs (known and unknown) @cindex Reporting bugs and ideas @cindex Bugs, how to report them @@ -1398,13 +1398,13 @@ output of the CVS process (which should be found in the @samp{ *cvs-tmp*} buffer), and the versions of Emacs, PCL-CVS and CVS you are using. @end table -@node GNU Free Documentation License, Function and Variable Index, Bugs, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Function and Variable Index, Concept Index, GNU Free Documentation License, Top +@node Function and Variable Index @unnumbered Function and Variable Index This is an index of all the functions and variables documented in this @@ -1412,14 +1412,14 @@ manual. @printindex fn -@node Concept Index, Key Index, Function and Variable Index, Top +@node Concept Index @unnumbered Concept Index This is an index of concepts discussed in this manual. @printindex cp -@node Key Index, , Concept Index, Top +@node Key Index @unnumbered Key Index This index includes an entry for each PCL-CVS key sequence documented in diff --git a/doc/misc/rcirc.texi b/doc/misc/rcirc.texi index 6af9358c7e6..3bce0c7c24b 100644 --- a/doc/misc/rcirc.texi +++ b/doc/misc/rcirc.texi @@ -35,7 +35,7 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Basics, (dir), (dir) +@node Top @top rcirc Manual @code{rcirc} is an Emacs IRC client. @@ -92,7 +92,7 @@ Hacking and Tweaking @end detailmenu @end menu -@node Basics, Reference, Top, Top +@node Basics @chapter Basics This chapter contains a brief introduction to IRC (Internet Relay Chat), @@ -103,7 +103,7 @@ and a quick tutorial on @code{rcirc}. * Getting started with rcirc:: @end menu -@node Internet Relay Chat, Getting started with rcirc, Basics, Basics +@node Internet Relay Chat @section Internet Relay Chat @cindex internet relay chat @cindex irc @@ -156,7 +156,7 @@ deego: fsbot rules! @kindex TAB Since this is so common, you can use @key{TAB} to do nick completion. -@node Getting started with rcirc, , Internet Relay Chat, Basics +@node Getting started with rcirc @section Getting started with rcirc @cindex getting started @cindex connecting to a server @@ -245,7 +245,7 @@ To make this permanent, add the following to your init file: Use @kbd{C-c C-@key{SPC}} to switch to these buffers. -@node Reference, Fighting Information Overload, Basics, Top +@node Reference @chapter Reference @cindex reference @@ -259,7 +259,7 @@ documentation. * Configuration:: @end menu -@node rcirc commands, Useful IRC commands, Reference, Reference +@node rcirc commands @section rcirc commands @cindex rcirc commands @cindex commands @@ -402,7 +402,7 @@ buffer, you automatically quit the server and part all channels. (Also @code{/quit ZZZzzz...}.) @end table -@node Useful IRC commands, Configuration, rcirc commands, Reference +@node Useful IRC commands @section Useful IRC commands @cindex irc commands @cindex commands @@ -430,7 +430,7 @@ about the fantastic world of IRC online at @uref{http://www.irchelp.org/, the Internet Relay Chat (IRC) help archive}. -@node Configuration, , Useful IRC commands, Reference +@node Configuration @section Configuration @cindex configuring rcirc @@ -594,7 +594,7 @@ confuse the Bitlbee account with all the other accounts. @end table -@node Fighting Information Overload, Hacking and Tweaking, Reference, Top +@node Fighting Information Overload @chapter Fighting Information Overload @cindex information overload @@ -610,7 +610,7 @@ daunting task. This chapters tells you how @code{rcirc} can help. * Notices:: @end menu -@node Channels, People, Fighting Information Overload, Fighting Information Overload +@node Channels @section Channels @cindex channels @cindex modeline @@ -668,7 +668,7 @@ If you prefer a channel to never show up in the modeline, then you have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current channel. -@node People, Keywords, Channels, Fighting Information Overload +@node People @section People @cindex people, how to ignore @cindex nicks, how to ignore @@ -726,7 +726,7 @@ messages by dimmed nicks will not register as activity. Example: @end table -@node Keywords, Notices, People, Fighting Information Overload +@node Keywords @section Keywords @cindex keywords @@ -742,7 +742,7 @@ one. If you don't provide a keyword, the current keywords are listed. Example: @code{/keyword manual}. @end table -@node Notices, , Keywords, Fighting Information Overload +@node Notices @section Notices @cindex part notices, how to omit @cindex join notices, how to omit @@ -774,7 +774,7 @@ active and only omits a message if the nick has not been active. The window @code{rcirc} considers is controlled by the @code{rcirc-omit-threshold} variable. -@node Hacking and Tweaking, GNU Free Documentation License, Fighting Information Overload, Top +@node Hacking and Tweaking @chapter Hacking and Tweaking @cindex hacking and tweaking @@ -789,7 +789,7 @@ Here are some examples of stuff you can do to configure @code{rcirc}. * Reconnecting after you have lost the connection:: @end menu -@node Skipping /away messages using handlers, Using fly spell mode, Hacking and Tweaking, Hacking and Tweaking +@node Skipping /away messages using handlers @section Skipping @code{/away} messages using handlers @cindex /away messages @@ -809,7 +809,7 @@ require @code{rcirc} before defining the handler: "/away message handler.") @end example -@node Using fly spell mode, Scrolling conservatively, Skipping /away messages using handlers, Hacking and Tweaking +@node Using fly spell mode @section Using fly spell mode @cindex fly spell @cindex spelling @@ -828,7 +828,7 @@ for @code{rcirc} buffers: @xref{Spelling, , Flyspell mode, emacs, The GNU Emacs Manual}, for details. -@node Scrolling conservatively, Changing the time stamp format, Using fly spell mode, Hacking and Tweaking +@node Scrolling conservatively @section Scrolling conservatively @cindex input line @cindex scrolling @@ -850,7 +850,7 @@ window when possible. The following snippet uses a local value for @xref{Scrolling, , Scrolling conservatively, emacs, The GNU Emacs Manual}, for details. -@node Changing the time stamp format, Defining a new command, Scrolling conservatively, Hacking and Tweaking +@node Changing the time stamp format @section Changing the time stamp format @cindex time stamp @cindex date time @@ -864,7 +864,7 @@ how to include the date in the time stamp: (setq rcirc-time-format "%Y-%m-%d %H:%M ") @end example -@node Defining a new command, Reconnecting after you have lost the connection, Changing the time stamp format, Hacking and Tweaking +@node Defining a new command @section Defining a new command @cindex defining commands @cindex commands, defining @@ -887,7 +887,7 @@ because @code{defun-rcirc-command} is not yet available, and without (concat "I use " rcirc-id-string)))) @end smallexample -@node Reconnecting after you have lost the connection, , Defining a new command, Hacking and Tweaking +@node Reconnecting after you have lost the connection @section Reconnecting after you have lost the connection @cindex reconnecting @cindex disconnecting servers, reconnecting @@ -928,20 +928,20 @@ The real answer, therefore, is a @code{/reconnect} command: channels)))) @end smallexample -@node GNU Free Documentation License, Key Index, Hacking and Tweaking, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Key Index, Variable Index, GNU Free Documentation License, Top +@node Key Index @unnumbered Key Index @printindex ky -@node Variable Index, Index, Key Index, Top +@node Variable Index @unnumbered Variable Index @printindex vr -@node Index, , Variable Index, Top +@node Index @unnumbered Index @printindex cp diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index efffc5078cc..0ee206b1a4d 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi @@ -95,7 +95,7 @@ modify this GNU manual.'' @contents @ifnottex -@node Top,,,(dir) +@node Top @top @RefTeX{} @RefTeX{} is a package for managing Labels, References, Citations and @@ -123,14 +123,13 @@ other parts of this document when needed. * Multifile Documents:: Document spread over many files. * Language Support:: How to support other languages. * Finding Files:: Included @TeX{} files and @BibTeX{} .bib files. -* AUCTeX:: Cooperation with @AUCTeX{}. * Optimizations:: When RefTeX is too slow. +* AUCTeX:: Cooperation with @AUCTeX{}. * Problems and Work-Arounds:: First Aid. * Imprint:: Author, Web-site, Thanks * Commands:: Which are the available commands. * Options:: How to extend and configure RefTeX. -* Keymaps and Hooks:: For customization. * Changes:: A List of recent changes to RefTeX. * GNU Free Documentation License:: The license for this documentation. @@ -214,7 +213,7 @@ Options, Keymaps, Hooks @end ifnottex -@node Introduction, Table of Contents, , Top +@node Introduction @chapter Introduction @cindex Introduction @@ -242,7 +241,7 @@ reports or suggestions. * RefTeX in a Nutshell:: A brief summary and quick guide. @end menu -@node Installation, RefTeX in a Nutshell, , Introduction +@node Installation @section Installation @cindex Installation @@ -360,7 +359,7 @@ systems these variables do not contain the full search path. If @xref{Finding Files}. @page -@node RefTeX in a Nutshell, , Installation, Introduction +@node RefTeX in a Nutshell @section @RefTeX{} in a Nutshell @cindex Quick-Start @cindex Getting Started @@ -516,7 +515,7 @@ a tutorial way how to use and customize @RefTeX{}. The second part is a command and variable reference. @end enumerate -@node Table of Contents, Labels and References, Introduction, Top +@node Table of Contents @chapter Table of Contents @cindex @file{*toc*} buffer @cindex Structure editing @@ -765,7 +764,7 @@ environments to the table of contents. This is probably only useful for theorem-like environments. @xref{Defining Label Environments}, for an example. -@node Labels and References, Citations, Table of Contents, Top +@node Labels and References @chapter Labels and References @cindex Labels in LaTeX @cindex References in LaTeX @@ -800,7 +799,7 @@ equation counter. * xr (LaTeX package):: References to external documents. @end menu -@node Creating Labels, Referencing Labels, , Labels and References +@node Creating Labels @section Creating Labels @cindex Creating labels @cindex Labels, creating @@ -867,7 +866,7 @@ If you are using @AUCTeX{} to write your @LaTeX{} documents, you can set it up to delegate the creation of labels to @RefTeX{}. @xref{AUCTeX}, for more information. -@node Referencing Labels, Builtin Label Environments, Creating Labels, Labels and References +@node Referencing Labels @section Referencing Labels @cindex Referencing labels @cindex Labels, referencing @@ -1092,7 +1091,7 @@ package),,xr}). In order to define additional commands for the selection process, the keymap @code{reftex-select-label-map} may be used. -@node Builtin Label Environments, Defining Label Environments, Referencing Labels, Labels and References +@node Builtin Label Environments @section Builtin Label Environments @cindex Builtin label environments @cindex Label environments, builtin @@ -1197,7 +1196,7 @@ If you want to use other labeled environments, defined with @code{\newtheorem}, @RefTeX{} needs to be configured to recognize them (@pxref{Defining Label Environments}). -@node Defining Label Environments, Reference Info, Builtin Label Environments, Labels and References +@node Defining Label Environments @section Defining Label Environments @cindex Label environments, defining @@ -1230,7 +1229,7 @@ Environments}). * Putting it Together:: How to combine many entries. @end menu -@node Theorem and Axiom, Quick Equation, , Defining Label Environments +@node Theorem and Axiom @subsection Theorem and Axiom Environments @cindex @code{theorem}, newtheorem @cindex @code{axiom}, newtheorem @@ -1362,7 +1361,7 @@ and @code{reftex-label-menu-flags} (@pxref{Options (Referencing Labels)}). -@node Quick Equation, Figure Wrapper, Theorem and Axiom , Defining Label Environments +@node Quick Equation @subsection Quick Equation Macro @cindex Quick equation macro @cindex Macros as environment wrappers @@ -1410,7 +1409,7 @@ Reftex Label Alist: [Hide] [ ] Make TOC entry : [Value Menu] No entry @end example -@node Figure Wrapper, Adding Magic Words, Quick Equation, Defining Label Environments +@node Figure Wrapper @subsection Figure Wrapping Macro @cindex Macros as environment wrappers @cindex Figure wrapping macro @@ -1470,7 +1469,7 @@ Again, here the configuration in the customization buffer: [ ] Make TOC entry : [Value Menu] No entry @end example -@node Adding Magic Words, Using \eqref, Figure Wrapper, Defining Label Environments +@node Adding Magic Words @subsection Adding Magic Words @cindex Magic words @cindex German magic words @@ -1494,7 +1493,7 @@ predefined label categories. (nil ?i nil nil nil ("Punkt")))) @end lisp -@node Using \eqref, Non-Standard Environments, Adding Magic Words, Defining Label Environments +@node Using \eqref @subsection Using @code{\eqref} @cindex @code{\eqref}, AMS-LaTeX macro @cindex AMS-LaTeX @@ -1521,7 +1520,7 @@ Note that this is automatically done by the @file{amsmath.el} style file 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 +@node Non-Standard Environments @subsection Non-standard Environments @cindex Non-standard environments @cindex Environments without @code{\begin} @@ -1622,7 +1621,7 @@ for @RefTeX{}. (incf cnt)))))))) @end lisp -@node Putting it Together, , Non-Standard Environments, Defining Label Environments +@node Putting it Together @subsection Putting it all together When you have to put several entries into @code{reftex-label-alist}, just @@ -1640,7 +1639,7 @@ the entries described above: (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex.")))) @end lisp -@node Reference Info, Reference Styles, Defining Label Environments, Labels and References +@node Reference Info @section Reference Info @findex reftex-view-crossref @findex reftex-mouse-view-crossref @@ -1662,7 +1661,7 @@ message. @code{\label} macro. @xref{Viewing Cross-References}, for more information. -@node Reference Styles, xr (LaTeX package), Reference Info, Labels and References +@node Reference Styles @section Reference Styles In case you defined your own macros for referencing or you are using @@ -1750,7 +1749,7 @@ and @code{reftex-fref-is-default} respectively. While still working, these variables are deprecated now. Instead of setting them, the variable @code{reftex-ref-style-default-list} should be adapted now. -@node xr (LaTeX package), , Reference Styles, Labels and References +@node xr (LaTeX package) @section @code{xr}: Cross-Document References @cindex @code{xr}, LaTeX package @cindex LaTeX packages, @code{xr} @@ -1785,7 +1784,7 @@ For this kind of inter-document cross-references, saving of parsing information and the use of multiple selection buffers can mean a large speed-up (@pxref{Optimizations}). -@node Citations, Index Support, Labels and References, Top +@node Citations @chapter Citations @cindex Citations @cindex @code{\cite} @@ -1805,7 +1804,7 @@ support for citations helps to select the correct key quickly. * BibTeX Database Subsets:: Extract parts of a big database. @end menu -@node Creating Citations, Citation Styles, , Citations +@node Creating Citations @section Creating Citations @cindex Creating citations @cindex Citations, creating @@ -1955,7 +1954,7 @@ buffers by adding the following expression to your init file: @end lisp -@node Citation Styles, Citation Info, Creating Citations, Citations +@node Citation Styles @section Citation Styles @cindex Citation styles @cindex Citation styles, @code{natbib} @@ -2020,7 +2019,7 @@ citation style based on the @code{usepackage} commands in a given document. @xref{Style Files}, for information on how to set up the style files correctly. -@node Citation Info, Chapterbib and Bibunits, Citation Styles, Citations +@node Citation Info @section Citation Info @cindex Displaying citations @cindex Citations, displaying @@ -2041,7 +2040,7 @@ entry corresponding to a @code{\cite} macro, or all citation locations corresponding to a @code{\bibitem} or @BibTeX{} database entry. @xref{Viewing Cross-References}. -@node Chapterbib and Bibunits, Citations Outside LaTeX, Citation Info, Citations +@node Chapterbib and Bibunits @section Chapterbib and Bibunits @cindex @code{chapterbib}, LaTeX package @cindex @code{bibunits}, LaTeX package @@ -2056,7 +2055,7 @@ separate file (as it is required for @code{chapterbib} anyway). Then you have multiple bibliographies within a @emph{single file}, this may or may not be the case. -@node Citations Outside LaTeX, BibTeX Database Subsets, Chapterbib and Bibunits, Citations +@node Citations Outside LaTeX @section Citations outside @LaTeX{} @cindex Citations outside LaTeX @vindex reftex-default-bibliography @@ -2081,7 +2080,7 @@ binding for @code{reftex-cite-format}. (reftex-citation)))))) @end lisp -@node BibTeX Database Subsets, , Citations Outside LaTeX, Citations +@node BibTeX Database Subsets @section Database Subsets @cindex BibTeX database subsets @findex reftex-create-bibtex-file @@ -2109,7 +2108,7 @@ entries in the selection buffer with the @kbd{m} key and then export either the @i{marked} entries (with the @kbd{e} key) or the @i{unmarked} entries (with the @kbd{E} key). -@node Index Support, Viewing Cross-References, Citations, Top +@node Index Support @chapter Index Support @cindex Index Support @cindex @code{\index} @@ -2176,7 +2175,7 @@ Style}), or globally for all your documents with * Defining Index Macros:: ... and macros it doesn't. @end menu -@node Creating Index Entries, The Index Phrases File, , Index Support +@node Creating Index Entries @section Creating Index Entries @cindex Creating index entries @cindex Index entries, creating @@ -2207,7 +2206,7 @@ index tag is a string identifying one of multiple indices. With the @file{multind} and @file{index} packages, this tag is the first argument to the redefined @code{\index} macro. -@node The Index Phrases File, Displaying and Editing the Index, Creating Index Entries, Index Support +@node The Index Phrases File @section The Index Phrases File @cindex Index phrase file @cindex Phrase file @@ -2255,7 +2254,7 @@ repeat @var{word} outside the macro. * Global Indexing:: The interactive indexing process. @end menu -@node Collecting Phrases, Consistency Checks, , The Index Phrases File +@node Collecting Phrases @subsection Collecting Phrases @cindex Collecting index phrases @cindex Index phrases, collection @@ -2321,7 +2320,7 @@ Finally, every occurrence of @samp{Pluto} will be indexed as @samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto} and will therefore create two different index entries. -@node Consistency Checks, Global Indexing, Collecting Phrases, The Index Phrases File +@node Consistency Checks @subsection Consistency Checks @cindex Index phrases, consistency checks @cindex Phrases, consistency checks @@ -2354,7 +2353,7 @@ the buffer which is either duplicate or a subphrase of another phrase. In order to check the whole buffer like this, start at the beginning and execute this command repeatedly. -@node Global Indexing, , Consistency Checks, The Index Phrases File +@node Global Indexing @subsection Global Indexing @cindex Global indexing @cindex Indexing, global @@ -2435,7 +2434,7 @@ to the changed regions. The command purpose. When called from a @LaTeX{} document with active region, it will apply @code{reftex-index-all-phrases} to the current region. -@node Displaying and Editing the Index, Builtin Index Macros, The Index Phrases File, Index Support +@node Displaying and Editing the Index @section Displaying and Editing the Index @cindex Displaying the Index @cindex Editing the Index @@ -2616,7 +2615,7 @@ indices). @end table -@node Builtin Index Macros, Defining Index Macros, Displaying and Editing the Index, Index Support +@node Builtin Index Macros @section Builtin Index Macros @cindex Builtin index macros @cindex Index macros, builtin @@ -2634,7 +2633,7 @@ the different definitions of the @code{\index} macro are incompatible, you will have to explicitly specify the index style used. @xref{Creating Index Entries}, for information on how to do that. -@node Defining Index Macros, , Builtin Index Macros, Index Support +@node Defining Index Macros @section Defining Index Macros @cindex Defining Index Macros @cindex Index macros, defining @@ -2731,7 +2730,7 @@ which specifies that the macro identified with the character @code{?x} (the in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}). The index tag is "idx". -@node Viewing Cross-References, RefTeXs Menu, Index Support, Top +@node Viewing Cross-References @chapter Viewing Cross-References @findex reftex-view-crossref @findex reftex-mouse-view-crossref @@ -2810,8 +2809,11 @@ in the variable @code{reftex-view-crossref-extra}. @iftex @chapter All the Rest @end iftex +@ifnottex +@raisesections +@end ifnottex -@node RefTeXs Menu, Key Bindings, Viewing Cross-References, Top +@node RefTeXs Menu @section @RefTeX{}'s Menu @cindex RefTeXs Menu @cindex Menu, in the menu bar @@ -2822,7 +2824,7 @@ which support this. From this menu you can access all of @code{Customize} submenu which can be used to access @RefTeX{}'s entire set of options. -@node Key Bindings, Faces, RefTeXs Menu, Top +@node Key Bindings @section Default Key Bindings @cindex Key Bindings, summary @@ -2896,7 +2898,7 @@ Changing and adding to @RefTeX{}'s key bindings is best done in the hook @code{reftex-load-hook}. For information on the keymaps which should be used to add keys, see @ref{Keymaps and Hooks}. -@node Faces, AUCTeX, Key Bindings, Top +@node Faces @section Faces @cindex Faces @@ -2908,7 +2910,7 @@ reasonable because people who like faces will very likely have it loaded. If you wish to turn off fontification or change the involved faces, see @ref{Options (Fontification)}. -@node Multifile Documents, Language Support, AUCTeX, Top +@node Multifile Documents @section Multifile Documents @cindex Multifile documents @cindex Documents, spread over files @@ -2961,7 +2963,7 @@ outside the current file can still use that section title as context. @end itemize -@node Language Support, Finding Files, Multifile Documents, Top +@node Language Support @section Language Support @cindex Language support @@ -3003,7 +3005,7 @@ dependent. See the variables @code{reftex-multiref-punctuation} and @code{reftex-cite-punctuation}. @end itemize -@node Finding Files, Optimizations, Language Support, Top +@node Finding Files @section Finding Files @cindex Finding files @@ -3089,7 +3091,7 @@ the new extension must also be known to @AUCTeX{} via the variable '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo")) @end lisp -@node Optimizations, Problems and Work-Arounds, Finding Files, Top +@node Optimizations @section Optimizations @cindex Optimizations @@ -3242,7 +3244,7 @@ with the @kbd{g} key. To get this behavior, use instead @end group @end lisp -@node AUCTeX, Multifile Documents, Faces, Top +@node AUCTeX @section @AUCTeX{} @cindex @code{AUCTeX}, Emacs package @cindex Emacs packages, @code{AUCTeX} @@ -3259,7 +3261,7 @@ XEmacs package.} by FTP from the @value{AUCTEXSITE}. * Bib-Cite:: Hypertext reading of a document @end menu -@node AUCTeX-RefTeX Interface, Style Files, , AUCTeX +@node AUCTeX-RefTeX Interface @subsection The @AUCTeX{}-@RefTeX{} Interface @RefTeX{} contains code to interface with @AUCTeX{}. When this @@ -3343,7 +3345,7 @@ Labels}). @RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list. @end itemize -@node Style Files, Bib-Cite, AUCTeX-RefTeX Interface, AUCTeX +@node Style Files @subsection Style Files @cindex Style files, AUCTeX @findex TeX-add-style-hook, @r{AUCTeX} @@ -3463,7 +3465,7 @@ is a style file @file{foils.el} that will inform @RefTeX{} about these: ("rotatefoilhead" . 3)))))) @end lisp -@node Bib-Cite, , Style Files, AUCTeX +@node Bib-Cite @subsection Bib-Cite @cindex @code{bib-cite}, Emacs package @cindex Emacs packages, @code{bib-cite} @@ -3491,7 +3493,7 @@ make use of this feature, try @end lisp @page -@node Problems and Work-Arounds, Imprint, Optimizations, Top +@node Problems and Work-Arounds @section Problems and Work-arounds @cindex Problems and work-arounds @@ -3627,7 +3629,7 @@ With @i{Viper} mode prior to Vipers version 3.01, you need to protect @end itemize @page -@node Imprint, Commands, Problems and Work-Arounds, Top +@node Imprint @section Imprint @cindex Imprint @cindex Maintainer @@ -3674,7 +3676,12 @@ Finally thanks to @i{Uwe Bolick} who first got me interested in supporting @LaTeX{} labels and references with an editor (which was MicroEmacs at the time). -@node Commands, Options, Imprint, Top +@c Turn off the raising that we turned on in ``All the rest''. +@ifnottex +@lowersections +@end ifnottex + +@node Commands @chapter Commands @cindex Commands, list of @@ -3876,7 +3883,7 @@ Enforce rebuilding of several internal lists and variables. Also removes the parse file associated with the current document. @end deffn -@node Options, Keymaps and Hooks, Commands, Top +@node Options @chapter Options, Keymaps, Hooks @cindex Options, list of @@ -3898,9 +3905,10 @@ reftex-customize} will get you there. * Options (Optimizations):: * Options (Fontification):: * Options (Misc):: +* Keymaps and Hooks:: @end menu -@node Options (Table of Contents), Options (Defining Label Environments), , Options +@node Options (Table of Contents) @section Table of Contents @cindex Options, table of contents @cindex Table of contents, options @@ -4024,7 +4032,7 @@ The keymap which is active in the @file{*toc*} buffer. (@pxref{Table of Contents}). @end deffn -@node Options (Defining Label Environments), Options (Creating Labels), Options (Table of Contents), Options +@node Options (Defining Label Environments) @section Defining Label Environments @cindex Options, defining label environments @cindex Defining label environments, options @@ -4251,7 +4259,7 @@ labels fn:xxx, you may want to set this variable to the value "^fn:$" or non-footnote labels. @end defopt -@node Options (Creating Labels), Options (Referencing Labels), Options (Defining Label Environments), Options +@node Options (Creating Labels) @section Creating Labels @cindex Options, creating labels @cindex Creating labels, options @@ -4367,7 +4375,7 @@ Character class after abbrev point in word. @end table @end defopt -@node Options (Referencing Labels), Options (Creating Citations), Options (Creating Labels), Options +@node Options (Referencing Labels) @section Referencing Labels @cindex Options, referencing labels @cindex Referencing labels, options @@ -4489,7 +4497,7 @@ The keymap which is active in the labels selection process (@pxref{Referencing Labels}). @end deffn -@node Options (Creating Citations), Options (Index Support), Options (Referencing Labels), Options +@node Options (Creating Citations) @section Creating Citations @cindex Options, creating citations @cindex Creating citations, options @@ -4668,7 +4676,7 @@ Footer to insert in BibTeX files generated by @end defopt -@node Options (Index Support), Options (Viewing Cross-References), Options (Creating Citations), Options +@node Options (Index Support) @section Index Support @cindex Options, Index support @cindex Index support, options @@ -4888,7 +4896,7 @@ The keymap which is active in the @file{*Index*} buffer (@pxref{Index Support}). @end deffn -@node Options (Viewing Cross-References), Options (Finding Files), Options (Index Support), Options +@node Options (Viewing Cross-References) @section Viewing Cross-References @cindex Options, viewing cross-references @cindex Viewing cross-references, options @@ -4947,7 +4955,7 @@ saved along with the parsing information. The cache survives document scans. In order to clear it, use @kbd{M-x reftex-reset-mode}. @end defopt -@node Options (Finding Files), Options (Optimizations), Options (Viewing Cross-References), Options +@node Options (Finding Files) @section Finding Files @cindex Options, Finding Files @cindex Finding files, options @@ -5037,7 +5045,7 @@ non-@code{nil}. @end defopt @page -@node Options (Optimizations), Options (Fontification), Options (Finding Files), Options +@node Options (Optimizations) @section Optimizations @cindex Options, optimizations @cindex Optimizations, options @@ -5146,7 +5154,7 @@ effect when @code{reftex-use-multiple-selection-buffers} is non-@code{nil}. @end defopt -@node Options (Fontification), Options (Misc), Options (Optimizations), Options +@node Options (Fontification) @section Fontification @cindex Options, fontification @cindex Fontification, options @@ -5244,7 +5252,7 @@ Face name for index names (for multiple indices). Face name for index entries. @end defopt -@node Options (Misc), , Options (Fontification), Options +@node Options (Misc) @section Miscellaneous @cindex Options, misc @@ -5289,7 +5297,7 @@ this will be the case even if @code{\bb} is defined with zero or one argument. @end defopt -@node Keymaps and Hooks, Changes, Options, Top +@node Keymaps and Hooks @section Keymaps and Hooks @cindex Keymaps @@ -5313,7 +5321,7 @@ their own keymaps and mode hooks. See the respective sections. There are many more hooks which are described in the relevant sections about options for a specific part of @RefTeX{}. -@node Changes, GNU Free Documentation License, Keymaps and Hooks, Top +@node Changes @chapter Changes @cindex Changes @@ -6078,11 +6086,11 @@ new labels. released on 7 Jan 1997. @end itemize -@node GNU Free Documentation License, Index, Changes, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top +@node Index @unnumbered Index @printindex cp diff --git a/doc/misc/remember.texi b/doc/misc/remember.texi index 3a80862d0e7..c70b6212268 100644 --- a/doc/misc/remember.texi +++ b/doc/misc/remember.texi @@ -44,8 +44,7 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Preface, (dir), (dir) -@comment node-name, next, previous, up +@node Top @top Remember @insertcopying @@ -76,8 +75,7 @@ Backends @end detailmenu @end menu -@node Preface, Introduction, Top, Top -@comment node-name, next, previous, up +@node Preface @chapter Preface This document describes remember-el, which was written by John Wiegley, @@ -87,8 +85,7 @@ developers. This document is a work in progress, and your contribution will be greatly appreciated. -@node Introduction, Installation, Preface, Top -@comment node-name, next, previous, up +@node Introduction @chapter Introduction Todo lists, schedules, phone databases... everything we use databases @@ -130,8 +127,7 @@ in order to record them---it would map much more closely to how the mind manual-ness which computers from the very beginning have been championed as being able to reduce. -@node Installation, Implementation, Introduction, Top -@comment node-name, next, previous, up +@node Installation @chapter Installation Installing Remember Mode is as simple as adding the following lines to @@ -143,8 +139,7 @@ your Emacs configuration file (usually @file{~/.emacs.d/init.el} or (require 'remember) @end lisp -@node Implementation, Quick Start, Installation, Top -@comment node-name, next, previous, up +@node Implementation @chapter Implementation Hyperbole, as a data presentation tool, always struck me as being very @@ -185,8 +180,7 @@ rather than requiring a billion keystrokes to reorganize your hierarchy. Well, as the future arrives, hopefully experience and user feedback will help to make this as intuitive a tool as possible. -@node Quick Start, Function Reference, Implementation, Top -@comment node-name, next, previous, up +@node Quick Start @chapter Quick Start @itemize @@ -257,8 +251,7 @@ remember-annotation-functions. For example: (call-interactively 'remember))) @end lisp -@node Function Reference, Keystrokes, Quick Start, Top -@comment node-name, next, previous, up +@node Function Reference @chapter Function Reference @file{remember.el} defines the following interactive functions: @@ -291,8 +284,7 @@ buffer is used to collect data that you want remember. Just hit the data for latter retrieval, and possible indexing. @end defun -@node Keystrokes, Backends, Function Reference, Top -@comment node-name, next, previous, up +@node Keystrokes @chapter Keystroke Reference @file{remember.el} defines the following keybindings by default: @@ -310,8 +302,7 @@ Remember the contents of the current buffer. @end table -@node Backends, GNU Free Documentation License, Keystrokes, Top -@comment node-name, next, previous, up +@node Backends @chapter Backends You can save remembered notes to a variety of backends. @@ -323,8 +314,7 @@ You can save remembered notes to a variety of backends. * Org:: Saving to an Org Mode file. @end menu -@node Text File, Diary, Backends, Backends -@comment node-name, next, previous, up +@node Text File @section Saving to a Text File @cindex text file, saving to @@ -344,8 +334,7 @@ The file in which to store unprocessed data. The text used to begin each remember item. @end defopt -@node Diary, Mailbox, Text File, Backends -@comment node-name, next, previous, up +@node Diary @section Saving to a Diary file @cindex diary, integration @@ -362,8 +351,7 @@ File for extracted diary entries. If this is nil, then @code{diary-file} will be used instead." @end defopt -@node Mailbox, Org, Diary, Backends -@comment node-name, next, previous, up +@node Mailbox @section Saving to a Mailbox @cindex mailbox, saving to @@ -383,8 +371,7 @@ The file in which to store remember data as mail. The default priority for remembered mail messages. @end defopt -@node Org, , Mailbox, Backends -@comment node-name, next, previous, up +@node Org @section Saving to an Org Mode file @cindex org mode, integration @@ -398,12 +385,11 @@ for org-remember at @url{http://orgmode.org/org-remember.pdf}. For instructions on how to integrate Remember with Org Mode, consult @ref{Capture, , , org}. -@node GNU Free Documentation License, Concept Index, Backends, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Concept Index, , GNU Free Documentation License, Top -@comment node-name, next, previous, up +@node Concept Index @unnumbered Index @printindex cp diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi index f6c35d1de8e..ce75f2ef91e 100644 --- a/doc/misc/ses.texi +++ b/doc/misc/ses.texi @@ -1,7 +1,7 @@ \input texinfo @c -*-texinfo-*- @c %**start of header @setfilename ../../info/ses -@settitle SES: Simple Emacs Spreadsheet +@settitle @acronym{SES}: Simple Emacs Spreadsheet @setchapternewpage off @syncodeindex fn cp @syncodeindex vr cp @@ -9,7 +9,7 @@ @c %**end of header @copying -This file documents SES: the Simple Emacs Spreadsheet. +This file documents @acronym{SES}: the Simple Emacs Spreadsheet. Copyright @copyright{} 2002--2013 Free Software Foundation, Inc. @@ -28,13 +28,13 @@ modify this GNU manual.'' @dircategory Emacs misc features @direntry -* SES: (ses). Simple Emacs Spreadsheet. +* @acronym{SES}: (ses). Simple Emacs Spreadsheet. @end direntry @finalout @titlepage -@title SES +@title @acronym{SES} @subtitle Simple Emacs Spreadsheet @author Jonathan A. Yavner @author @email{jyavner@@member.fsf.org} @@ -49,12 +49,12 @@ modify this GNU manual.'' @c =================================================================== @ifnottex -@node Top, Sales Pitch, (dir), (dir) +@node Top @comment node-name, next, previous, up -@top SES: Simple Emacs Spreadsheet +@top @acronym{SES}: Simple Emacs Spreadsheet @display -SES is a major mode for GNU Emacs to edit spreadsheet files, which +@acronym{SES} is a major mode for GNU Emacs to edit spreadsheet files, which contain a rectangular grid of cells. The cells' values are specified by formulas that can refer to the values of other cells. @end display @@ -65,7 +65,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}. @insertcopying @menu -* Sales Pitch:: Why use SES? +* Sales Pitch:: Why use @acronym{SES}? * The Basics:: Basic spreadsheet commands * Advanced Features:: Want to know more? * For Gurus:: Want to know @emph{even more}? @@ -76,7 +76,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}. @c =================================================================== -@node Sales Pitch, The Basics, Top, Top +@node Sales Pitch @comment node-name, next, previous, up @chapter Sales Pitch @cindex features @@ -98,7 +98,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}. @c =================================================================== -@node The Basics, Advanced Features, Sales Pitch, Top +@node The Basics @comment node-name, next, previous, up @chapter The Basics @cindex basic commands @@ -125,9 +125,9 @@ Moves point to cell, specified by identifier (@code{ses-jump}). Point is always at the left edge of a cell, or at the empty endline. When mark is inactive, the current cell is underlined. When mark is -active, the range is the highlighted rectangle of cells (SES always +active, the range is the highlighted rectangle of cells (@acronym{SES} always uses transient mark mode). Drag the mouse from A1 to A3 to create the -range A1-A2. Many SES commands operate only on single cells, not +range A1-A2. Many @acronym{SES} commands operate only on single cells, not ranges. @table @kbd @@ -154,10 +154,10 @@ Highlight all cells (@code{mark-whole-buffer}). * Printer functions:: * Clearing cells:: * Copy/cut/paste:: -* Customizing SES:: +* Customizing @acronym{SES}:: @end menu -@node Formulas, Resizing, The Basics, The Basics +@node Formulas @section Cell formulas @cindex formulas @cindex formulas, entering @@ -191,7 +191,7 @@ this cell's formula will be reevaluated. While typing in the expression, you can use @kbd{M-@key{TAB}} to complete symbol names. @item ' @r{(apostrophe)} -Enter a symbol (ses-read-symbol). SES remembers all symbols that have +Enter a symbol (ses-read-symbol). @acronym{SES} remembers all symbols that have been used as formulas, so you can type just the beginning of a symbol and use @kbd{@key{SPC}}, @kbd{@key{TAB}}, and @kbd{?} to complete it. @end table @@ -210,7 +210,7 @@ Force recalculation of the current cell or range (@code{ses-recalculate-cell}). Recalculate the entire spreadsheet (@code{ses-recalculate-all}). @end table -@node Resizing, Printer functions, Formulas, The Basics +@node Resizing @section Resizing the spreadsheet @cindex resizing spreadsheets @findex ses-insert-row @@ -266,7 +266,7 @@ Undo previous action (@code{(undo)}). @end table -@node Printer functions, Clearing cells, Resizing, The Basics +@node Printer functions @section Printer functions @cindex printer functions @findex ses-read-cell-printer @@ -331,7 +331,7 @@ Centering with tildes (~) and spill-over. @end table -@node Clearing cells, Copy/cut/paste, Printer functions, The Basics +@node Clearing cells @section Clearing cells @cindex clearing commands @findex ses-clear-cell-backward @@ -348,7 +348,7 @@ Clear cell and move right (@code{ses-clear-cell-forward}). @end table -@node Copy/cut/paste, Customizing SES, Clearing cells, The Basics +@node Copy/cut/paste @section Copy, cut, and paste @cindex copy @cindex cut @@ -364,7 +364,7 @@ Clear cell and move right (@code{ses-clear-cell-forward}). @findex ses-yank-pop The copy functions work on rectangular regions of cells. You can paste the -copies into non-SES buffers to export the print text. +copies into non-@acronym{SES} buffers to export the print text. @table @kbd @item M-w @@ -393,7 +393,7 @@ Paste from kill ring (@code{yank}). The paste functions behave differently depending on the format of the text being inserted: @itemize @bullet @item -When pasting cells that were cut from a SES buffer, the print text is +When pasting cells that were cut from a @acronym{SES} buffer, the print text is ignored and only the attached formula and printer are inserted; cell references in the formula are relocated unless you use @kbd{C-u}. @item @@ -401,7 +401,7 @@ The pasted text overwrites a rectangle of cells whose top left corner is the current cell. If part of the rectangle is beyond the edges of the spreadsheet, you must confirm the increase in spreadsheet size. @item -Non-SES text is usually inserted as a replacement formula for the +Non-@acronym{SES} text is usually inserted as a replacement formula for the current cell. If the formula would be a symbol, it's treated as a string unless you use @kbd{C-u}. Pasted formulas with syntax errors are always treated as strings. @@ -419,12 +419,12 @@ Set point and paste from secondary clipboard (@code{mouse-yank-secondary}). @item M-y Immediately after a paste, you can replace the text with a preceding element from the kill ring (@code{ses-yank-pop}). Unlike the standard -Emacs yank-pop, the SES version uses @code{undo} to delete the old +Emacs yank-pop, the @acronym{SES} version uses @code{undo} to delete the old yank. This doesn't make any difference? @end table -@node Customizing SES, , Copy/cut/paste, The Basics -@section Customizing SES +@node Customizing @acronym{SES} +@section Customizing @acronym{SES} @cindex customizing @vindex enable-local-eval @vindex ses-mode-hook @@ -442,7 +442,7 @@ up or down. For diagonal movement, select two functions from the list. @code{ses-mode-hook} is a normal mode hook (list of functions to -execute when starting SES mode for a buffer). +execute when starting @acronym{SES} mode for a buffer). The variable @code{safe-functions} is a list of possibly-unsafe functions to be treated as safe when analyzing formulas and printers. @@ -460,7 +460,7 @@ safety belts! @c =================================================================== -@node Advanced Features, For Gurus, The Basics, Top +@node Advanced Features @chapter Advanced Features @cindex advanced features @findex ses-read-header-row @@ -468,7 +468,10 @@ safety belts! @table @kbd @item C-c M-C-h -(@code{ses-set-header-row}). The header line at the top of the SES +(@code{ses-set-header-row}). +@findex ses-set-header-row +@kindex C-c M-C-h +The header line at the top of the @acronym{SES} window normally shows the column letter for each column. You can set it to show a copy of some row, such as a row of column titles, so that row will always be visible. Default is to set the current row as the @@ -477,6 +480,16 @@ show column letters again. @item [header-line mouse-3] Pops up a menu to set the current row as the header, or revert to column letters. +@item M-x ses-rename-cell +@findex ses-rename-cell +Rename a cell from a standard A1-like name to any +string. +@item M-x ses-repair-cell-reference-all +@findex ses-repair-cell-reference-all +When you interrupt a cell formula update by clicking @kbd{C-g}, then +the cell reference link may be broken, which will jeopardize automatic +cell update when any other cell on which it depends is changed. To +repair that use function @code{ses-repair-cell-reference-all} @end table @menu @@ -490,16 +503,16 @@ column letters. * Spreadsheets with details and summary:: @end menu -@node The print area, Ranges in formulas, Advanced Features, Advanced Features +@node The print area @section The print area @cindex print area @findex widen @findex ses-renarrow-buffer @findex ses-reprint-all -A SES file consists of a print area and a data area. Normally the +A @acronym{SES} file consists of a print area and a data area. Normally the buffer is narrowed to show only the print area. The print area is -read-only except for special SES commands; it contains cell values +read-only except for special @acronym{SES} commands; it contains cell values formatted by printer functions. The data area records the formula and printer functions, etc. @@ -516,7 +529,7 @@ Recreate print area by reevaluating printer functions for all cells (@code{ses-reprint-all}). @end table -@node Ranges in formulas, Sorting by column, The print area, Advanced Features +@node Ranges in formulas @section Ranges in formulas @cindex ranges @findex ses-insert-range-click @@ -575,8 +588,54 @@ If you insert a new row just beyond the end of a one-column range, or a new column just beyond a one-row range, the new cell is included in the range. New cells inserted just before a range are not included. +Flags can be added to @code{ses-range} immediately after the @var{to} +cell. +@table @code +@item ! +Empty cells in range can be removed by adding the @code{!} flag. An +empty cell is a cell the value of which is one of symbols @code{nil} +or @code{*skip*}. For instance @code{(ses-range A1 A4 !)} will do the +same as @code{(list A1 A3)} when cells @code{A2} and @code{A4} are +empty. +@item _ +Empty cell values are replaced by the argument following flag +@code{_}, or @code{0} when flag @code{_} is last in argument list. For +instance @code{(ses-range A1 A4 _ "empty")} will do the same as +@code{(list A1 "empty" A3 "empty")} when cells @code{A2} and @code{A4} +are empty. Similarly, @code{(ses-range A1 A4 _ )} will do the same as +@code{(list A1 0 A3 0)}. +@item >v +When order matters, list cells by reading cells row-wise from top left +to bottom right. This flag is provided for completeness only as it is +the default reading order. +@item <v +List cells by reading cells row-wise from top right to bottom left. +@item v> +List cells by reading cells column-wise from top left to bottom right. +@item v< +List cells by reading cells column-wise from top right to bottom left. +@item v +A short hand for @code{v>}. +@item ^ +A short hand for @code{^>}. +@item > +A short hand for @code{>v}. +@item < +A short hand for @code{>^}. +@item * +Instead of listing cells, it makes a Calc vector or matrix of it +(@pxref{Top,,,calc,GNU Emacs Calc Manual}). If the range contains only +one row or one column a vector is made, otherwise a matrix is made. +@item *2 +Same as @code{*} except that a matrix is always made even when there +is only one row or column in the range. +@item *1 +Same as @code{*} except that a vector is always made even when there +is only one row or column in the range, that is to say the +corresponding matrix is flattened. +@end table -@node Sorting by column, Standard formula functions, Ranges in formulas, Advanced Features +@node Sorting by column @section Sorting by column @cindex sorting @findex ses-sort-column @@ -605,7 +664,7 @@ formulas that refer to other rows in the range or to cells outside the range. -@node Standard formula functions, More on cell printing, Sorting by column, Advanced Features +@node Standard formula functions @section Standard formula functions @cindex standard formula functions @cindex *skip* @@ -630,7 +689,7 @@ Average of non-blank elements in @var{list}. Here the list is passed as a single argument, since you'll probably use it with @code{ses-range}. @end table -@node More on cell printing, Import and export, Standard formula functions, Advanced Features +@node More on cell printing @section More on cell printing @cindex cell printing, more @findex ses-truncate-cell @@ -652,7 +711,7 @@ the result is too wide for the available space (up to the end of the row or the next non-@code{nil} cell), the result is truncated if the cell's value is a string, or replaced with hash marks otherwise. -SES could get confused by printer results that contain newlines or +@acronym{SES} could get confused by printer results that contain newlines or tabs, so these are replaced with question marks. @table @kbd @@ -678,7 +737,7 @@ that are empty of contain strings will use the fallback printer. argument type''. -@node Import and export, Virus protection, More on cell printing, Advanced Features +@node Import and export @section Import and export @cindex import and export @cindex export, and import @@ -698,7 +757,7 @@ another buffer. Columns are separated by tabs, rows by newlines. To import text, use any of the yank commands where the text to paste contains tabs and/or newlines. Imported formulas are not relocated. -@node Virus protection, Spreadsheets with details and summary, Import and export, Advanced Features +@node Virus protection @section Virus protection @cindex virus protection @@ -725,7 +784,7 @@ parts of the Emacs Lisp environment can be excluded without cramping your style as a formula-writer. See the documentation in @file{unsafep.el} for more info on how Lisp forms are classified as safe or unsafe. -@node Spreadsheets with details and summary, , Virus protection, Advanced Features +@node Spreadsheets with details and summary @section Spreadsheets with details and summary @cindex details and summary @cindex summary, and details @@ -733,7 +792,7 @@ for more info on how Lisp forms are classified as safe or unsafe. A common organization for spreadsheets is to have a bunch of ``detail'' rows, each perhaps describing a transaction, and then a set of ``summary'' rows that each show reduced data for some subset of the -details. SES supports this organization via the @code{ses-select} +details. @acronym{SES} supports this organization via the @code{ses-select} function. @table @code @@ -761,7 +820,7 @@ details-and-summary spreadsheet. @c =================================================================== -@node For Gurus, Index, Advanced Features, Top +@node For Gurus @chapter For Gurus @cindex advanced features @@ -770,10 +829,10 @@ details-and-summary spreadsheet. * Nonrelocatable references:: * The data area:: * Buffer-local variables in spreadsheets:: -* Uses of defadvice in SES:: +* Uses of defadvice in @acronym{SES}:: @end menu -@node Deferred updates, Nonrelocatable references, For Gurus, For Gurus +@node Deferred updates @section Deferred updates @cindex deferred updates @cindex updates, deferred @@ -798,14 +857,14 @@ progress message of the form ``Writing... (@var{nnn} cells left)''. These deferred cell-writes cannot be interrupted by @kbd{C-g}, so you'll just have to wait. -SES uses @code{run-with-idle-timer} to move the cell underline when +@acronym{SES} uses @code{run-with-idle-timer} to move the cell underline when Emacs will be scrolling the buffer after the end of a command, and also to narrow and underline after @kbd{C-x C-v}. This is visible as a momentary glitch after C-x C-v and certain scrolling commands. You can type ahead without worrying about the glitch. -@node Nonrelocatable references, The data area, Deferred updates, For Gurus +@node Nonrelocatable references @section Nonrelocatable references @cindex nonrelocatable references @cindex references, nonrelocatable @@ -833,7 +892,7 @@ to get the value from the leftmost column in the current row. This kind of dependency is also not recorded. -@node The data area, Buffer-local variables in spreadsheets, Nonrelocatable references, For Gurus +@node The data area @section The data area @cindex data area @findex ses-reconstruct-all @@ -842,14 +901,14 @@ Begins with an 014 character, followed by sets of cell-definition macros for each row, followed by column-widths, column-printers, default-printer, and header-row. Then there's the global parameters (file-format ID, numrows, numcols) and the local variables (specifying -SES mode for the buffer, etc.) +@acronym{SES} mode for the buffer, etc.) -When a SES file is loaded, first the numrows and numcols values are +When a @acronym{SES} file is loaded, first the numrows and numcols values are loaded, then the entire data area is @code{eval}ed, and finally the local variables are processed. You can edit the data area, but don't insert or delete any newlines -except in the local-variables part, since SES locates things by +except in the local-variables part, since @acronym{SES} locates things by counting newlines. Use @kbd{C-x C-e} at the end of a line to install your edits into the spreadsheet data structures (this does not update the print area, use, e.g., @kbd{C-c C-l} for that). @@ -865,7 +924,7 @@ data structures: @end table -@node Buffer-local variables in spreadsheets, Uses of defadvice in SES, The data area, For Gurus +@node Buffer-local variables in spreadsheets @section Buffer-local variables in spreadsheets @cindex buffer-local variables @cindex variables, buffer-local @@ -899,8 +958,8 @@ avoid virus warnings, each function used in a formula needs (put 'your-function-name 'safe-function t) @end lisp -@node Uses of defadvice in SES, , Buffer-local variables in spreadsheets, For Gurus -@section Uses of defadvice in SES +@node Uses of defadvice in @acronym{SES} +@section Uses of defadvice in @acronym{SES} @cindex defadvice @cindex undo-more @cindex copy-region-as-kill @@ -926,15 +985,15 @@ cell. @end table @c =================================================================== -@node Index, Acknowledgments, For Gurus, Top +@node Index @unnumbered Index @printindex cp @c =================================================================== -@node Acknowledgments, GNU Free Documentation License, Index, Top -@chapter Acknowledgments +@node Acknowledgments +@unnumbered Acknowledgments Coding by: @quotation @@ -975,7 +1034,7 @@ Jean-Philippe Theberge @email{jphil@@acs.pagesjaunes.fr} @c =================================================================== -@node GNU Free Documentation License, , Acknowledgments, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi diff --git a/doc/misc/speedbar.texi b/doc/misc/speedbar.texi index 62cfcb95af4..c017490d4aa 100644 --- a/doc/misc/speedbar.texi +++ b/doc/misc/speedbar.texi @@ -37,8 +37,7 @@ modify this GNU manual.'' @contents -@node Top, , , (dir)Top -@comment node-name, next, previous, up +@node Top @top Speedbar Speedbar is a program for Emacs which can be used to summarize @@ -83,8 +82,7 @@ on. @xref{Basic Navigation}. * Index:: @end menu -@node Introduction, Basic Navigation, , Top -@comment node-name, next, previous, up +@node Introduction @chapter Introduction @cindex introduction @@ -115,8 +113,7 @@ The function to use when switching between frames using the keyboard is @code{speedbar-get-focus}. This function will toggle between frames, and it's useful to bind it to a key in terminal mode. @xref{Customizing}. -@node Basic Navigation, File Mode, Introduction, Top -@comment node-name, next, previous, up +@node Basic Navigation @chapter Basic Navigation Speedbar can display different types of data, and has several display @@ -131,8 +128,7 @@ to use. * Displays Submenu:: @end menu -@node Basic Key Bindings, Basic Visuals, Basic Navigation, Basic Navigation -@comment node-name, next, previous, up +@node Basic Key Bindings @section Basic Key Bindings @cindex key bindings @@ -205,8 +201,7 @@ flushed. This is similar to a power click. @xref{Mouse Bindings}. Contract the current group, hiding sub items. @end table -@node Basic Visuals, Mouse Bindings, Basic Key Bindings, Basic Navigation -@comment node-name, next, previous, up +@node Basic Visuals @section Basic Visuals @cindex visuals @@ -307,8 +302,7 @@ The face naming convention mirrors the File display mode. Modes which do not use files will attempt to use the same colors on analogous entries. -@node Mouse Bindings, Displays Submenu, Basic Visuals, Basic Navigation -@comment node-name, next, previous, up +@node Mouse Bindings @section Mouse Bindings @cindex mouse bindings @@ -352,8 +346,7 @@ should be displayed in the minibuffer of the attached frame. Sometimes this can contain extra information such as file permissions, or tag location. -@node Displays Submenu, , Mouse Bindings, Basic Navigation -@comment node-name, next, previous, up +@node Displays Submenu @section Displays Submenu @cindex displays submenu @@ -369,8 +362,7 @@ The contents are modes currently loaded into emacs. By default, this would include Files, Quick Buffers, and Buffers. Other major display modes such as Info are loaded separately. -@node File Mode, Buffer Mode, Basic Navigation, Top -@comment node-name, next, previous, up +@node File Mode @chapter File Mode @cindex file mode @@ -387,8 +379,7 @@ Advanced behavior, like copying and renaming files, is also provided. * File Key Bindings:: Performing file operations. @end menu -@node Directory Display, Hidden Files, File Mode, File Mode -@comment node-name, next, previous, up +@node Directory Display @section Directory Display @cindex directory display @@ -471,8 +462,7 @@ Some group names may say something like @samp{speedbar-t to speedbar-v}, indicating that all symbols which alphabetically fall between those categories are included in that sub-group. @xref{Tag Hierarchy Methods}. -@node Hidden Files, File Key Bindings, Directory Display, File Mode -@comment node-name, next, previous, up +@node Hidden Files @section Hidden Files @cindex hidden files @@ -498,8 +488,7 @@ Object files fall into the category of level 2 hidden files. You can determine their presence by the @samp{#} and @samp{!} file indicators. @xref{Directory Display}. -@node File Key Bindings, , Hidden Files, File Mode -@comment node-name, next, previous, up +@node File Key Bindings @section File Key Bindings @cindex file key bindings @@ -537,8 +526,7 @@ list, are shown. By showing all files, additional files such as text files are also displayed, but they are prefixed with the @samp{[?]} symbol. This means that it is a file, but Emacs doesn't know how to expand it. -@node Buffer Mode, Minor Modes, File Mode, Top -@comment node-name, next, previous, up +@node Buffer Mode @chapter Buffer Mode @cindex buffer mode @@ -569,8 +557,7 @@ Thus, if you are in File mode, and you need quick access to a buffer, press @kbd{b}, click on the buffer you want, and speedbar will revert back to File mode. -@node Minor Modes, Customizing, Buffer Mode, Top -@comment node-name, next, previous, up +@node Minor Modes @chapter Minor Display Modes @cindex minor display modes @@ -592,8 +579,7 @@ key bindings and visuals, but will have specialized behaviors. stack trace. @end menu -@node RMAIL, Info, Minor Modes, Minor Modes -@comment node-name, next, previous, up +@node RMAIL @section RMAIL @cindex RMAIL @@ -614,8 +600,7 @@ the current RMAIL folder into a different folder by clicking the In this way you can manage your existing RMAIL folders fairly easily using the mouse. -@node Info, GDB, RMAIL, Minor Modes -@comment node-name, next, previous, up +@node Info @section Info @cindex Info @@ -629,8 +614,7 @@ are available. Since these sub-topics are not examined until you click the @samp{[+]} button, sometimes a @samp{[?]} will appear when you click on a @samp{[+]}, indicating that there are no sub-topics. -@node GDB, , Info, Minor Modes -@comment node-name, next, previous, up +@node GDB @section GDB @cindex gdb @cindex gud @@ -652,8 +636,7 @@ You can click on any stack element and gdb will move to that stack level. You can then check variables local to that level at the GDB prompt. -@node Customizing, Extending, Minor Modes, Top -@comment node-name, next, previous, up +@node Customizing @chapter Customizing @cindex customizing @@ -680,8 +663,7 @@ Customize speedbar's many colors and fonts. * Hooks:: The many hooks you can use. @end menu -@node Frames and Faces, Tag Hierarchy Methods, Customizing, Customizing -@comment node-name, next, previous, up +@node Frames and Faces @section Frames and Faces @cindex faces @cindex frame parameters @@ -725,8 +707,7 @@ it. In XEmacs, change the plist @code{speedbar-frame-plist}. This is the XEmacs way of doing the same thing. -@node Tag Hierarchy Methods, Version Control, Frames and Faces, Customizing -@comment node-name, next, previous, up +@node Tag Hierarchy Methods @section Tag Hierarchy Methods @cindex tag hierarchy @cindex tag groups @@ -805,8 +786,7 @@ are next to each other, then they are combined until this number of items is reached. @end table -@node Version Control, Hooks, Tag Hierarchy Methods, Customizing -@comment node-name, next, previous, up +@node Version Control @section Version Control @cindex version control @cindex vc extensions @@ -840,8 +820,7 @@ placed near this file. Lastly, you can change the VC indicator using the variable @code{speedbar-vc-indicator}, and specify a single character string. -@node Hooks, , Version Control, Customizing -@comment node-name, next, previous, up +@node Hooks @section Hooks @cindex hooks @@ -883,8 +862,7 @@ Set this to implement your own scanning or rescan safe functions with state data. @end table -@node Extending, GNU Free Documentation License, Customizing, Top -@comment node-name, next, previous, up +@node Extending @chapter Extending @cindex extending @@ -908,7 +886,7 @@ create specialized tagging functions. * Creating a display:: How to insert buttons and hierarchies. @end menu -@node Minor Display Modes, Major Display Modes, Extending, Extending +@node Minor Display Modes @section Minor Display Modes @cindex create minor display mode @@ -966,7 +944,7 @@ want to do is execute a check to see if you need to re-create your display. If it needs to be cleared, you need to erase the speedbar buffer yourself, and start drawing buttons. @xref{Creating a display}. -@node Major Display Modes, Tagging Extensions, Minor Display Modes, Extending +@node Major Display Modes @section Major Display Modes @cindex create major display mode @@ -1097,7 +1075,7 @@ Your custom function might look like this: Once you have done all this, speedbar will show an entry in the @samp{Displays} menu declaring that your extension is available. -@node Tagging Extensions, Creating a display, Major Display Modes, Extending +@node Tagging Extensions @section Tagging Extensions It is possible to create new methods for tagging files in speedbar. @@ -1137,7 +1115,7 @@ If your parser is only good for a few types of files, make sure that it is either a buffer local modification, or that the tag generator returns @code{t} for non valid buffers. -@node Creating a display, , Tagging Extensions, Extending +@node Creating a display @section Creating a display @cindex creating a display @@ -1239,13 +1217,12 @@ Two good values are @code{nil} and @code{statictag}. @end defun -@node GNU Free Documentation License, Index, Extending, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top -@comment node-name, next, previous, up +@node Index @unnumbered Concept Index @printindex cp diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi index dac24f7ca47..d76f9e09184 100644 --- a/doc/misc/srecode.texi +++ b/doc/misc/srecode.texi @@ -225,7 +225,7 @@ template files, and determining which templates are relevant to the current buffer. Template files are sorted by priority, with user templates being found first, and system level default templates last. Templates are also sorted by application. Each application has its -own templates, and are kept seperate from the generic templates. +own templates, and are kept separate from the generic templates. @section Dictionary Dictionaries contain values associated with variable. Variables are @@ -311,7 +311,7 @@ template to be inserted again. By default, when inserting a template, if the user needs to enter text to fill in a part of the template, then the minibuffer is used to -query for that information. SRecode also supports a field-edting mode +query for that information. SRecode also supports a field-editing mode that can be used instead. To enable it set: @defun srecode-insert-ask-variable-method @@ -343,7 +343,7 @@ Once the cursor moves out of the are inserted by the template, all the fields are cancelled. @b{NOTE}: Some conveniences in templates, such as completion, or -character restrictins are lost when using field editing mode. +character restrictions are lost when using field editing mode. @node Template Writing @chapter Template Writing @@ -400,7 +400,7 @@ set VARNAME "some value" @end example Note that a VARIABLE is a name in a dictionary that can be used in a -MACRO in a template. The macro referernces some variable by name. +MACRO in a template. The macro references some variable by name. @menu * String Values:: Basic Variable values @@ -419,7 +419,7 @@ other characters. Strings are interpreted by the Emacs Lisp reader so @code{\n}, @code{\t}, and @code{\"} work. When a string is inserted as part of a template, nothing within the -string is interperted, such as template escape characters. +string is interpreted, such as template escape characters. @node Multi-string Values @subsection Multi-string Values @@ -544,7 +544,7 @@ Any template file that has a project specified will get have a priority that is set between SRecode base templates, and user defined templates. -Templates can be compiled via a project system, such as EDE. EDE +Templates can be compiled via a project system, such as EDE@. EDE loaded templates will get a @var{project} set automatically. Example: @@ -598,7 +598,7 @@ variables from Lisp. A template represents a text pattern that can be inserted into a buffer. -A basic template is declaired like this: +A basic template is declared like this: @example template TEMPLATENAME :arg1 :arg2 @@ -620,7 +620,7 @@ contain the text "-----". @menu * Template Section Dictionaries:: Template Scoped Macro values -* Template Macros:: Macros occuring in template patterns +* Template Macros:: Macros occurring in template patterns @end menu @node Template Section Dictionaries @@ -643,7 +643,7 @@ An end line @end example In this example, the @var{NAME} variable gets the value ``foo'', but -only while it is inside section macro A. The outer scoped NAME will +only while it is inside section macro A@. The outer scoped NAME will be empty. This is particularly useful while using an include macro to pull in a @@ -846,7 +846,7 @@ template foo context C2 -temlate foo +template foo "Foo template in C2" ---- ---- @@ -857,13 +857,13 @@ C1. The second is available in context C2. This is useful if there are multiple ways to declare something like a function or variable that differ only by where it is in the syntax of -the lanugage. The name @code{foo} is not ambiguous because each is in +the language. The name @code{foo} is not ambiguous because each is in a different context. @node Prompts @section Prompt -Some templates use promtping macro insertion. A macro that needs a +Some templates use prompting macro insertion. A macro that needs a prompt looks like this: @example @@ -880,7 +880,7 @@ Specify NAME: For such macros, you can pre-define prompts for any dictionary entry. When that dictionary entry is first encountered, the user is prompted, -and subsequent occurances of that dictionary entry use the same value. +and subsequent occurrences of that dictionary entry use the same value. To get a different prompt, use a prompt command like this: @@ -925,7 +925,7 @@ need to use the @code{defaultmacro} keyword instead. prompt VARNAME "Varname: " defaultmacro "PREFIX" @end example -now, when it attempts to read in VARNAME, it will pre-populte the text +now, when it attempts to read in VARNAME, it will pre-populate the text editing section with whatever the value of PREFIX is. Some language arguments may supply possible prefixes for prompts. @@ -971,7 +971,7 @@ When building an @srecode{} based application, you will need to setup your dictionary values yourself. There are several utility functions for this. -In the simplest form, you can assocate a string with a variable. +In the simplest form, you can associate a string with a variable. @defun srecode-dictionary-set-value dict name value @anchor{srecode-dictionary-set-value} @@ -996,8 +996,9 @@ You can add several dictionaries to the same section entry. For each dictionary added to a variable, the block of codes in the template will be repeated. -If optional argument @var{SHOW-ONLY} is non-@code{nil}, then don't add a new dictionarly -if there is already one in place. Also, don't add @var{FIRST}/@var{LAST} entries. +If optional argument @var{SHOW-ONLY} is non-@code{nil}, then don't add +a new dictionary if there is already one in place. Also, don't add +@var{FIRST}/@var{LAST} entries. These entries are not needed when we are just showing a section. Each dictionary added will automatically get values for positional macros @@ -1125,7 +1126,7 @@ want, but adding dictionary values is the right thing. @node Querying a Dictionary @section Querying a Dictionary -When creating a new argument, it may be useful to ask the dicitonary +When creating a new argument, it may be useful to ask the dictionary what entries are already set there, and conditionally create new entries based on those. @@ -1233,7 +1234,7 @@ The current hour in 24 hour format. @item HOUR12 The current hour in 12 hour format. @item AMPM -Locale equivalent of AM or PM. Usefule with HOUR12. +Locale equivalent of AM or PM@. Useful with HOUR12. @item MINUTE The current minute. @item SECOND @@ -1330,7 +1331,7 @@ entries. @table @code @item ARGS -A Loop macro value. Each argument is inserted in ARGS. To create a +A Loop macro value. Each argument is inserted in ARGS@. To create a comma separated list of arguments, you might do this: @example @@ -1411,7 +1412,7 @@ name. Converts the filename into text that would be suitable as a class-name for the main class in the file. @item CURRENT_PACKAGE -Finds the occurance of ``package'' and gets its value. +Finds the occurrence of ``package'' and gets its value. @end table @subsubsection Argument :el @@ -1429,7 +1430,7 @@ to namespaces in other languages. The name of the Emacs Custom group that instances of @code{defcustom} ought to use. @item FACEGROUP -The name of the Emacs Custom group that faces delcared with +The name of the Emacs Custom group that faces declared with @code{defface} ought to use. @end table @@ -1550,7 +1551,7 @@ tables that do not belong to an application will be searched. @end defun For purposes of an @srecode{} application, it is important to decide -what to call yoru application, and use that with this method call. +what to call your application, and use that with this method call. @section Creating dictionaries @@ -1581,7 +1582,7 @@ If @var{stream} is nil, then use the current buffer. @node Template Naming Conventions @chapter Template Naming Conventions -For @srecode{} to work across langauges reliably, templates need to +For @srecode{} to work across languages reliably, templates need to follow a predictable pattern. For every language of similar nature (OO, functional, doc based) if they all provide the same base templates, then an application can be written against the base @@ -1612,7 +1613,7 @@ Functional languages should attempt to support the following: @item function A standalone function. Not a method, external method, or other. @item method -A method belonging to some class declaired outside the textual bounds +A method belonging to some class declared outside the textual bounds of that class' declaration. @item variable A global variable. @@ -1684,7 +1685,7 @@ also the following useful dictionary values. @table @var @item TAG -A special insertion value TAG. You can use semantic functions to turn +A special insertion value TAG@. You can use semantic functions to turn the tag into a string. @item HAVEDEFAULT @itemx DEFAULT diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex index f3093d0853f..d64f45bbee9 100644 --- a/doc/misc/texinfo.tex +++ b/doc/misc/texinfo.tex @@ -3,11 +3,11 @@ % Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi % -\def\texinfoversion{2012-09-12.16} +\def\texinfoversion{2013-01-01.15} % % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, -% 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. +% 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. % % This texinfo.tex file is free software: you can redistribute it and/or % modify it under the terms of the GNU General Public License as @@ -24,7 +24,8 @@ % % As a special exception, when this file is read by TeX when processing % a Texinfo source document, you may use the result without -% restriction. (This has been our intent since Texinfo was invented.) +% restriction. This Exception is an additional permission under section 7 +% of the GNU General Public License, version 3 ("GPLv3"). % % Please try the latest version of texinfo.tex before submitting bug % reports; you can get the latest version from: @@ -6559,16 +6560,9 @@ end \makedispenvdef{quotation}{\quotationstart} % \def\quotationstart{% - {\parskip=0pt \aboveenvbreak}% because \aboveenvbreak inserts \parskip - \parindent=0pt - % - % @cartouche defines \nonarrowing to inhibit narrowing at next level down. + \indentedblockstart % same as \indentedblock, but increase right margin too. \ifx\nonarrowing\relax - \advance\leftskip by \lispnarrowing \advance\rightskip by \lispnarrowing - \exdentamount = \lispnarrowing - \else - \let\nonarrowing = \relax \fi \parsearg\quotationlabel } @@ -6594,6 +6588,32 @@ end \fi } +% @indentedblock is like @quotation, but indents only on the left and +% has no optional argument. +% +\makedispenvdef{indentedblock}{\indentedblockstart} +% +\def\indentedblockstart{% + {\parskip=0pt \aboveenvbreak}% because \aboveenvbreak inserts \parskip + \parindent=0pt + % + % @cartouche defines \nonarrowing to inhibit narrowing at next level down. + \ifx\nonarrowing\relax + \advance\leftskip by \lispnarrowing + \exdentamount = \lispnarrowing + \else + \let\nonarrowing = \relax + \fi +} + +% Keep a nonzero parskip for the environment, since we're doing normal filling. +% +\def\Eindentedblock{% + \par + {\parskip=0pt \afterenvbreak}% +} +\def\Esmallindentedblock{\Eindentedblock} + % LaTeX-like @verbatim...@end verbatim and @verb{<char>...<char>} % If we want to allow any <char> as delimiter, diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 2609b331b7d..a683425868a 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -451,7 +451,8 @@ GVFS integration started in February 2009. Remote commands on Windows hosts are available since September 2011. @end ifset Ad-hoc multi-hop methods (with a changed syntax) have been reenabled -in November 2011. +in November 2011. In November 2012, Juergen Hoetzel's +@file{tramp-adb.el} has been added. In December 2001, @value{tramp} has been added to the XEmacs package repository. Being part of the Emacs repository happened in June 2002, @@ -1029,6 +1030,17 @@ Windows, this method isn't available. Instead, you can use UNC file names like @file{//melancholia/daniel$$/.emacs}. The only disadvantage is that there's no possibility to specify another user name. + + +@item @option{adb} +@cindex method adb +@cindex adb method + +This special method uses the Android Debug Bridge for connecting +Android devices. The Android Debug Bridge, part of the Android SDK, +must be installed locally. The variable @var{tramp-adb-sdk-dir} must +be set to its installation directory. + @end table @@ -1077,6 +1089,7 @@ phones. For the time being, @value{tramp} only supports OBEX over Bluetooth. The @option{synce} method allows communication with Windows Mobile devices. Beside GVFS for mounting remote files and directories via FUSE, it also needs the SYNCE-GVFS plugin. + @end table @defopt tramp-gvfs-methods @@ -1584,6 +1597,7 @@ can return user names only. Finally, a function which parses @file{~/.netrc} like files. This includes also @file{~/.authinfo}-style files. + @end table If you want to keep your own data in a file, with your own structure, diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi index 3c0c3a7e19f..6d5a8cb1c44 100644 --- a/doc/misc/trampver.texi +++ b/doc/misc/trampver.texi @@ -8,7 +8,7 @@ @c In the Tramp CVS, the version number is auto-frobbed from @c configure.ac, so you should edit that file and run @c "autoconf && ./configure" to change the version number. -@set trampver 2.2.6-24.3 +@set trampver 2.2.7-pre @c Other flags from configuration @set instprefix /usr/local diff --git a/doc/misc/url.texi b/doc/misc/url.texi index a26743ed1aa..9e9dbc0a77d 100644 --- a/doc/misc/url.texi +++ b/doc/misc/url.texi @@ -346,7 +346,7 @@ To use this function, you must @code{(require 'url-queue)}. The value of this option is an integer specifying the maximum number of concurrent @code{url-queue-retrieve} network processes. If the number of @code{url-queue-retrieve} calls is larger than this number, -later ones are queued until ealier ones are finished. +later ones are queued until earlier ones are finished. @end defopt @vindex url-queue-timeout diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi index 06fb5b9288b..01048d43dbf 100644 --- a/doc/misc/vip.texi +++ b/doc/misc/vip.texi @@ -40,7 +40,7 @@ modify this GNU manual.'' @end direntry @ifnottex -@node Top, Survey,, (DIR) +@node Top @top VIP VIP is a Vi emulating package written in Emacs Lisp. VIP implements most @@ -90,7 +90,7 @@ Comments and bug reports are welcome. Please send messages to @code{masahiko@@unsun.riec.tohoku.junet} if you are in Japan. @end iftex -@node Survey, Basic Concepts, Top, Top +@node Survey @chapter A Survey of VIP In this chapter we describe basics of VIP with emphasis on the features not @@ -104,7 +104,7 @@ found in Vi and on how to use VIP under GNU Emacs. * Differences from Vi:: Differences of VIP from Vi is explained. @end menu -@node Basic Concepts, Loading VIP, Survey, Survey +@node Basic Concepts @section Basic Concepts We begin by explaining some basic concepts of Emacs. These concepts are @@ -151,7 +151,7 @@ be executed when you type the key. If no function is bound to a key in the local map, however, the function bound to the key in the global map becomes in effect.@refill -@node Loading VIP, Modes in VIP, Basic Concepts, Survey +@node Loading VIP @section Loading VIP The recommended way to load VIP automatically is to include the line: @@ -177,7 +177,7 @@ M-x vip-mode @end example @noindent -@node Modes in VIP, Emacs Mode, Loading VIP, Survey +@node Modes in VIP @section Modes in VIP @kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) @@ -257,7 +257,7 @@ emacs mode vi mode insert mode know enough Emacs commands. @end menu -@node Emacs Mode, Vi Mode, Modes in VIP, Modes in VIP +@node Emacs Mode @subsection Emacs Mode @kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) @@ -267,14 +267,14 @@ normal Emacs editing in this mode. Note that the key @kbd{C-z} is globally bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode then you will be in vi mode.@refill -@node Vi Mode, Insert Mode, Emacs Mode, Modes in VIP +@node Vi Mode @subsection Vi Mode This mode corresponds to Vi's command mode. Most Vi commands work as they do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can enter insert mode, just as in Vi, by typing @kbd{i}, @kbd{a} etc. -@node Insert Mode, Differences from Vi, Vi Mode, Modes in VIP +@node Insert Mode @subsection Insert Mode The key bindings in this mode is the same as in the emacs mode except for @@ -298,7 +298,7 @@ Thus typing @kbd{C-z x} in insert mode will have the same effect as typing @kbd{ESC x} in emacs mode. @end table -@node Differences from Vi, Undoing, Insert Mode, Survey +@node Differences from Vi @section Differences from Vi The major differences from Vi are explained below. @@ -323,7 +323,7 @@ The major differences from Vi are explained below. * Misc Commands:: Other useful commands. @end menu -@node Undoing, Changing, Differences from Vi, Differences from Vi +@node Undoing @subsection Undoing @kindex 165 @kbd{u} (@code{vip-undo}) @@ -334,7 +334,7 @@ a single change, while @kbd{u .@: .@: .@:}, for instance, will undo 4 previous changes. Undo is undoable as in Vi. So the content of the buffer will be the same before and after @kbd{u u}.@refill -@node Changing, Searching, Undoing, Differences from Vi +@node Changing @subsection Changing Some commands which change a small number of characters are executed @@ -347,7 +347,7 @@ then VIP will prompt you for a new word in the minibuffer by the prompt @kindex 007 @kbd{C-g} (@code{vip-keyboard-quit}) you can abort a partially formed command by typing @kbd{C-g}.@refill -@node Searching, z Command, Changing, Differences from Vi +@node Searching @subsection Searching @kindex 057 @kbd{/} (@code{vip-search-forward}) @@ -363,7 +363,7 @@ search string. (It is a limitation.) By default, search will wrap around the buffer as in Vi. You can change this by rebinding the variable @code{vip-search-wrap-around}. @xref{Customization}, for how to do this.@refill -@node z Command, Counts, Searching, Differences from Vi +@node z Command @subsection z Command @kindex 1723 @kbd{z H} (@code{vip-line-to-top}) @@ -378,7 +378,7 @@ For those of you who cannot remember which of @kbd{z} followed by @key{RET}, @kbd{M} and @kbd{L} to place the current line in the Home (Middle, and Last) line of the window.@refill -@node Counts, Marking, z Command, Differences from Vi +@node Counts @subsection Counts Some Vi commands which do not accept a count now accept one @@ -404,7 +404,7 @@ line. Given a count @var{n}, @var{n}-th occurrence will be searched. @end table -@node Marking, Region Commands, Counts, Differences from Vi +@node Marking @subsection Marking Typing an @kbd{m} followed by a lower-case character @var{ch} marks the @@ -424,7 +424,7 @@ Set mark at point (and push old mark on mark ring). Jump to mark (and pop mark off the mark ring). @end table -@node Region Commands, New Commands, Marking, Differences from Vi +@node Region Commands @subsection Region Commands @cindex region @@ -438,7 +438,7 @@ of @kbd{r} the region will first be enlarged so that it will become the smallest region containing the original region and consisting of whole lines. Thus @kbd{m .@: d R} will have the same effect as @kbd{d d}.@refill -@node New Commands, New Bindings, Region Commands, Differences from Vi +@node New Commands @subsection Some New Commands Note that the keys below (except for @kbd{R}) are not used in Vi. @@ -530,7 +530,7 @@ Check spelling of words in the region (@code{spell-region}). Call last keyboard macro. @end table -@node New Bindings, Window Commands, New Commands, Differences from Vi +@node New Bindings @subsection New Key Bindings In VIP the meanings of some keys are entirely different from Vi. These key @@ -590,7 +590,7 @@ In addition to these, @code{ctl-x-map} is slightly modified: This is equivalent to @kbd{C-x 1 C-x 2} (1 + 2 = 3). @end table -@node Window Commands, Buffer Commands, New Bindings, Differences from Vi +@node Window Commands @subsection Window Commands In this and following subsections, we give a summary of key bindings for @@ -614,7 +614,7 @@ Split current window into two windows. Show current buffer in two windows. @end table -@node Buffer Commands, File Commands, Window Commands, Differences from Vi +@node Buffer Commands @subsection Buffer Commands @table @kbd @@ -635,7 +635,7 @@ Kill the current buffer if it is not modified. Save the current buffer in the file associated to the buffer. @end table -@node File Commands, Misc Commands, Buffer Commands, Differences from Vi +@node File Commands @subsection File Commands @table @kbd @@ -656,7 +656,7 @@ Write current buffer into the specified file. Insert specified file at point. @end table -@node Misc Commands, Vi Commands, File Commands, Differences from Vi +@node Misc Commands @subsection Miscellaneous Commands @table @kbd @@ -683,7 +683,7 @@ Query replace. Replace. @end table -@node Vi Commands, Numeric Arguments, Misc Commands, Top +@node Vi Commands @chapter Vi Commands This chapter describes Vi commands other than Ex commands implemented in @@ -704,7 +704,7 @@ commands described in this chapter are to be used in vi mode. * Commands in Insert Mode:: Commands for entering insert mode. @end menu -@node Numeric Arguments, Important Keys, Vi Commands, Vi Commands +@node Numeric Arguments @section Numeric Arguments @cindex numeric arguments @@ -725,7 +725,7 @@ In many cases, if a count is given, the command is executed that many times. For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a line. In this manual the metavariable @var{n} will denote a count.@refill -@node Important Keys, Buffers and Windows, Numeric Arguments, Vi Commands +@node Important Keys @section Important Keys The keys @kbd{C-g} and @kbd{C-l} are unique in that their associated @@ -775,7 +775,7 @@ typing @kbd{\}. Thus @kbd{5 \ +}, as well as @kbd{\ C-u 5 +}, will insert @samp{+++++} before point.@refill @end table -@node Buffers and Windows, Files, Important Keys, Vi Commands +@node Buffers and Windows @section Buffers and Windows @cindex buffer @@ -842,7 +842,7 @@ by @key{RET}. The default buffer name to switch to will also be prompted, and you can select it by giving a simple @key{RET}. See GNU Emacs Manual for details of completion. -@node Files, Viewing the Buffer, Buffers and Windows, Vi Commands +@node Files @section Files We have the following commands related to files. They are used to visit, @@ -923,7 +923,7 @@ case), you can just say @kbd{X S}. If you wish to save it in another file, you can type @kbd{X W}. You will then get a similar prompt as you get for @kbd{v}, to which you can enter the file name.@refill -@node Viewing the Buffer, Mark Commands, Files, Vi Commands +@node Viewing the Buffer @section Viewing the Buffer In this and next section we discuss commands for moving around in the @@ -991,7 +991,7 @@ point will be placed in the @var{n}-th line from bottom Center point in window and redisplay screen (@code{recenter}). @end table -@node Mark Commands, Motion Commands, Viewing the Buffer, Vi Commands +@node Mark Commands @section Mark Commands The following commands are used to mark positions in the buffer. @@ -1019,7 +1019,7 @@ latest element of the mark ring (replacing the oldest one). By repeating the command `@kbd{m ,}' you can visit older and older marked positions. You will eventually be in a loop as the mark ring is a ring. -@node Motion Commands, Searching and Replacing, Mark Commands, Vi Commands +@node Motion Commands @section Motion Commands Commands for moving around in the current buffer are collected here. These @@ -1213,7 +1213,7 @@ Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command, in the opposite direction (@code{vip-repeat-find-opposite}). @end table -@node Searching and Replacing, Modifying Commands, Motion Commands, Vi Commands +@node Searching and Replacing @section Searching and Replacing Following commands are available for searching and replacing. @@ -1277,7 +1277,7 @@ count, replace that many characters by @var{ch} (@code{vip-replace-char}). The commands @kbd{/} and @kbd{?} mark point before move, so that you can return to the original point by @w{@kbd{` `}}. -@node Modifying Commands, Delete Commands, Searching and Replacing, Vi Commands +@node Modifying Commands @section Modifying Commands In this section, commands for modifying the content of a buffer are @@ -1315,7 +1315,7 @@ command. * Change Commands:: Commands for changing text. * Repeating and Undoing Modifications:: @end menu -@node Delete Commands, Yank Commands, Modifying Commands, Modifying Commands +@node Delete Commands @subsection Delete Commands @table @kbd @@ -1367,7 +1367,7 @@ Delete a character before point. Given @var{n}, delete @var{n} characters (@code{vip-delete-backward-char}). @end table -@node Yank Commands, Put Back Commands, Delete Commands, Modifying Commands +@node Yank Commands @subsection Yank Commands @cindex yank @@ -1403,7 +1403,7 @@ Yank current region. Expand current region and yank it. @end table -@node Put Back Commands, Change Commands, Yank Commands, Modifying Commands +@node Put Back Commands @subsection Put Back Commands Deleted or yanked texts can be put back into the buffer by the command below. @@ -1434,7 +1434,7 @@ numeral between @kbd{1} and @kbd{9}. If the number register @var{n} is specified, @var{n}-th previously deleted/yanked text will be put back. It is an error to specify a number register for the delete/yank commands. -@node Change Commands, Repeating and Undoing Modifications, Put Back Commands, Modifying Commands +@node Change Commands @subsection Change Commands Most commonly used change command takes the following form. @@ -1467,7 +1467,7 @@ Change current region. Expand current region and change it. @end table -@node Repeating and Undoing Modifications, Other Vi Commands, Change Commands, Modifying Commands +@node Repeating and Undoing Modifications @subsection Repeating and Undoing Modifications VIP records the previous modifying command, so that it is easy to repeat @@ -1487,7 +1487,7 @@ count for the repeated command. Otherwise, the count for the last modifying command is used again (@code{vip-repeat}). @end table -@node Other Vi Commands, Commands in Insert Mode, Repeating and Undoing Modifications, Vi Commands +@node Other Vi Commands @section Other Vi Commands Miscellaneous Vi commands are collected here. @@ -1608,7 +1608,7 @@ command @kbd{P} or @kbd{p} can retrieve it from kill ring (@code{kill-region}). @end table -@node Commands in Insert Mode, Ex Commands, Other Vi Commands, Vi Commands +@node Commands in Insert Mode @section Insert Mode You can enter insert mode by one of the following commands. In addition to @@ -1676,7 +1676,7 @@ start point is saved for later use by repeat command etc. Therefore, repeat command will not really repeat insertion if you move point by emacs commands while in insert mode. -@node Ex Commands, Ex Command Reference, Commands in Insert Mode, Top +@node Ex Commands @chapter Ex Commands @kindex 072 @kbd{:} (@code{vip-ex}) @@ -1713,7 +1713,7 @@ character @samp{|}. @menu * Ex Command Reference:: Explain all the Ex commands available in VIP. @end menu -@node Ex Command Reference, Customization, Ex Commands, Ex Commands +@node Ex Command Reference @section Ex Command Reference In this section we briefly explain all the Ex commands supported by VIP@. Most Ex commands expect @var{address} as their argument, and they use @@ -1859,7 +1859,7 @@ The following Ex commands are available in Vi, but not implemented in VIP. @kbd{unabbreviate}, @kbd{xit}, @kbd{z} @end example -@node Customization, Customizing Constants, Ex Command Reference, Top +@node Customization @chapter Customization If you have a file called @file{.vip} in your home directory, then it @@ -1871,7 +1871,7 @@ customizing VIP. * Customizing Key Bindings:: How to change key bindings. @end menu -@node Customizing Constants, Customizing Key Bindings, Customization, Customization +@node Customizing Constants @section Customizing Constants An easy way to customize VIP is to change the values of constants used in VIP@. Here is the list of the constants used in VIP and their default @@ -1907,7 +1907,7 @@ can include a line like this in your @file{.vip} file: (setq vip-case-fold-search t) @end example -@node Customizing Key Bindings,, Customizing Constants, Customization +@node Customizing Key Bindings @section Customizing Key Bindings @cindex local keymap @@ -1931,7 +1931,7 @@ file. (define-key vip-command-mode-map "X" 'vip-delete-backward-char) @end example -@node GNU Free Documentation License,,, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi index 41f34957253..9bcecf8e3de 100644 --- a/doc/misc/viper.texi +++ b/doc/misc/viper.texi @@ -46,9 +46,8 @@ modify this GNU manual.'' @contents @ifnottex -@node Top, Overview,, (DIR) - -@unnumbered Viper +@node Top +@top Viper We believe that one or more of the following statements are adequate descriptions of Viper: @@ -99,16 +98,13 @@ Please use the Ex command @kbd{:submitReport} for this purpose.@refill * Improvements over Vi:: New features, Improvements * Customization:: How to customize Viper * Commands:: Vi and Ex Commands - +* GNU Free Documentation License:: The license for this documentation. +* Acknowledgments:: * Key Index:: Index of Vi and Ex Commands * Function Index:: Index of Viper Functions * Variable Index:: Index of Viper Variables * Package Index:: Index of Packages Mentioned in this Document * Concept Index:: Vi, Ex and Emacs concepts - -* Acknowledgments:: -* GNU Free Documentation License:: The license for this documentation. - @end menu @iftex @unnumbered Introduction @@ -155,7 +151,7 @@ Please use the Ex command @kbd{:submitReport} for this purpose.@refill @end iftex -@node Overview,Improvements over Vi,Top,Top +@node Overview @chapter Overview of Viper Viper is a Vi emulation on top of Emacs. At the same time, Viper provides a @@ -185,7 +181,7 @@ included in your @file{~/.viper} file and are found at the following URL: * Unimplemented Features:: That are unlikely to be implemented. @end menu -@node Emacs Preliminaries, Loading Viper, Overview, Overview +@node Emacs Preliminaries @section Emacs Preliminaries @cindex buffer @@ -313,7 +309,7 @@ Emacs is structured as a Lisp interpreter around a C core. Emacs keys cause Lisp functions to be called. It is possible to call these functions directly, by typing @kbd{M-x function-name}. -@node Loading Viper, States in Viper, Emacs Preliminaries, Overview +@node Loading Viper @section Loading Viper The most common way to load it automatically is to include the following @@ -368,7 +364,7 @@ copy of Emacs after Viper has been loaded, the command @kbd{M-x viper-go-away} will do it for you. The function @code{toggle-viper-mode} toggles Viperization of Emacs on and off. -@node States in Viper, The Minibuffer, Loading Viper,Overview +@node States in Viper @section States in Viper @kindex @kbd{C-z} @@ -474,7 +470,7 @@ to allow Emacs keys in Insert state. replacement commands, such as cw, C, R, etc. @end menu -@node Emacs State, Vi State, States in Viper, States in Viper +@node Emacs State @subsection Emacs State @kindex @kbd{C-z} @@ -506,7 +502,7 @@ from the Insert state: typing @kbd{C-z} will let you execute a single Vi command while staying in Viper's Insert state. -@node Vi State, Insert State, Emacs State, States in Viper +@node Vi State @subsection Vi State @cindex Vi state @@ -666,7 +662,7 @@ Having found the appropriate command, it can be then executed by typing `@kbd{.}'. @xref{Improvements over Vi}, for more information. -@node Insert State, Replace State, Vi State, States in Viper +@node Insert State @subsection Insert State @cindex Insert state @@ -726,7 +722,7 @@ the Insert state. When Viper is in Insert state, you will see <I> in the mode line. -@node Replace State,, Insert State, States in Viper +@node Replace State @subsection Replace State @cindex Replace state @@ -758,7 +754,7 @@ was still inside the replacement region. So, in the above situation, Viper would delete text between this position and the end of the replacement region. -@node The Minibuffer,Multiple Files in Viper, States in Viper, Overview +@node The Minibuffer @section The Minibuffer @cindex Minibuffer @@ -808,7 +804,7 @@ has no mode line to tell which Vi state it is in. The appearance of the text in the minibuffer can be changed. @xref{Viper Specials}, for more details. -@node Multiple Files in Viper,Unimplemented Features,The Minibuffer,Overview +@node Multiple Files in Viper @section Multiple Files in Viper @cindex multiple files @@ -883,7 +879,7 @@ Currently undisplayed files can be listed using the @kbd{:ar} command. The command @kbd{:n} can be given counts from the @kbd{:ar} list to switch to other files. For example, use `:n3' to move to the third file in that list. -@node Unimplemented Features,,Multiple Files in Viper,Overview +@node Unimplemented Features @section Unimplemented Features Unimplemented features include: @@ -904,8 +900,7 @@ be used directly inside Emacs, since Emacs will obdurately change @samp{^I} back to normal tabs.@refill @end itemize -@comment node-name, next, previous, up -@node Improvements over Vi, Customization, Overview, Top +@node Improvements over Vi @chapter Improvements over Vi Some common problems with Vi and Ex have been solved in Viper. This @@ -926,7 +921,7 @@ the facilities provided by Emacs. you should know about. @end menu -@node Basics, Undo and Backups, Improvements over Vi, Improvements over Vi +@node Basics @section Basics The Vi command set is based on the idea of combining motion commands @@ -997,7 +992,7 @@ buffers. These can be seen in the @kbd{:args} list and switched using specify @code{(setq ex-cycle-through-non-files t)} in your @file{.viper} file. @xref{Customization}, for details. -@node Undo and Backups, History, Basics, Improvements over Vi +@node Undo and Backups @section Undo and Backups @cindex undo @@ -1033,7 +1028,7 @@ will show the text around the textmarker. @samp{register} and @samp{textmarker} can be any letters from a through z. @comment ] balance parens -@node History, Macros and Registers, Undo and Backups,Improvements over Vi +@node History @section History @cindex history @@ -1072,7 +1067,7 @@ Similarly, commands that have to do with switching buffers have a buffer history, and commands that expect strings or regular expressions keep a history on those items. -@node Macros and Registers,Completion,History,Improvements over Vi +@node Macros and Registers @section Macros and Registers @cindex keyboard macros @@ -1119,7 +1114,7 @@ Keyboard Macro execution @kbd{@@@@} (the replace). Viper also provides Vi-style macros. @xref{Vi Macros}, for details. -@node Completion, Improved Search, Macros and Registers, Improvements over Vi +@node Completion @section Completion @cindex completion @@ -1130,7 +1125,7 @@ no longer work for that file name. Remember that Emacs interprets a file name of the form @kbd{/foo//bar} as @kbd{/bar} and @kbd{/foo/~/bar} as @kbd{~/bar}. -@node Improved Search, Abbreviation Facilities, Completion, Improvements over Vi +@node Improved Search @section Improved Search @cindex buffer search @@ -1198,7 +1193,7 @@ faces are grouped together under Viper's Try it: it is really simple! -@node Abbreviation Facilities,Movement and Markers,Improved Search,Improvements over Vi +@node Abbreviation Facilities @section Abbreviation Facilities @cindex abbrevs @@ -1222,7 +1217,7 @@ keystroke, which appears earlier in the text. Emacs binds this to @code{dabbrev-expand} to that key. Facilities like this make Vi's @kbd{:ab} command obsolete. -@node Movement and Markers, New Commands, Abbreviation Facilities, Improvements over Vi +@node Movement and Markers @section Movement and Markers @cindex Ex style motion @@ -1298,7 +1293,7 @@ switch files by simply doing @kbd{'a}. If you set up a regimen for using Textmarkers, this is very useful. Contents of textmarkers can be viewed by @kbd{[marker}. (Contents of registers can be viewed by @kbd{]register}). -@node New Commands, Useful Packages, Movement and Markers, Improvements over Vi +@node New Commands @section New Commands These commands have no Vi analogs. @@ -1487,7 +1482,7 @@ Apart from the new commands, many old commands have been enhanced. Most notably, Vi style macros are much more powerful in Viper than in Vi. @xref{Vi Macros}, for details. -@node Useful Packages, ,New Commands, Improvements over Vi +@node Useful Packages @section Useful Packages Some Emacs packages are mentioned here as an aid to the new Viper user, to @@ -1568,7 +1563,7 @@ Emacs Lisp archives exist on and @samp{wuarchive.wustl.edu}@refill -@node Customization,Commands,Improvements over Vi,Top +@node Customization @chapter Customization @cindex customization @@ -1614,7 +1609,7 @@ cases, examples are provided that you can use directly. * Vi Macros:: How to do Vi style macros. @end menu -@node Rudimentary Changes,Key Bindings,Customization,Customization +@node Rudimentary Changes @section Rudimentary Changes @cindex setting variables @@ -1955,7 +1950,7 @@ can include a line like this in your @file{.viper} file: @vindex @code{viper-replace-state-hook} @vindex @code{viper-emacs-state-hook} -@node Key Bindings, Packages that Change Keymaps, Rudimentary Changes,Customization +@node Key Bindings @section Key Bindings @cindex key bindings @@ -2193,8 +2188,8 @@ bindings in Emacs. @findex @code{viper-add-local-keys} @findex @code{viper-zap-local-keys} -@node Packages that Change Keymaps,Viper Specials,Key Bindings,Customization -@subsection Packages that Change Keymaps +@node Packages that Change Keymaps +@section Packages that Change Keymaps @cindex C-c and Viper @cindex Viper and C-c @@ -2322,7 +2317,7 @@ compatible with Viper is to have the file @file{my-mode.el} include the followin @findex @code{remove-hook} @findex @code{add-hook} -@node Viper Specials,Vi Macros,Packages that Change Keymaps,Customization +@node Viper Specials @section Viper Specials Viper extends Vi with a number of useful features. This includes various @@ -2707,7 +2702,7 @@ you will then have to write such a function and make it known to your Emacs. The function @code{viper-surrounding-word} in @file{viper.el} can be used as a guiding example. -@node Vi Macros, ,Viper Specials,Customization +@node Vi Macros @section Vi Macros @cindex Vi macros @@ -2994,7 +2989,7 @@ Finally, Viper provides a function that conveniently displays all macros currently defined. To see all macros along with their definitions, type @kbd{M-x viper-describe-kbd-macros}. -@node Commands,,Customization,Top +@node Commands @chapter Commands This section is a semi-automatically bowdlerized version of the Vi @@ -3013,8 +3008,7 @@ found on the Vi archives. This reference has been adapted for Viper.@refill * Mouse-bound Commands:: Search and insertion of text @end menu -@node Groundwork, Text Handling, Commands, Commands -@comment node-name, next, previous, up +@node Groundwork @section Groundwork The VI command set is based on the idea of combining motion commands @@ -3224,7 +3218,7 @@ ends at line 135. There is no need to type the line numbers, since Viper inserts them automatically in front of the Ex command. @cindex Ex commands -@node Text Handling, Display, Groundwork, Commands +@node Text Handling @section Text Handling @menu @@ -3239,7 +3233,7 @@ inserts them automatically in front of the Ex command. * Undoing:: Multiple Undo, Backups @end menu -@node Move Commands,Marking,,Text Handling +@node Move Commands @subsection Move Commands @cindex movement commands @@ -3435,7 +3429,7 @@ in your @file{~/.viper} file. @kindex @kbd{l} @vindex @code{viper-parse-sexp-ignore-comments} -@node Marking,Appending Text,Move Commands,Text Handling +@node Marking @subsection Marking Emacs mark is referred to in the region specifiers @kbd{r} and @kbd{R}. @@ -3487,7 +3481,7 @@ Go to specified Viper mark and go to the first CHAR on line. @kindex @kbd{`<a-z>} @kindex @kbd{'<a-z>} -@node Appending Text, Editing in Insert State, Marking,Text Handling +@node Appending Text @subsection Appending Text @xref{Options}, to see how to change tab and shiftwidth size. See the GNU @@ -3569,7 +3563,7 @@ functions doing the perusing can be bound to unused keyboard keys in the @kindex @kbd{A} @kindex @kbd{a} -@node Editing in Insert State, Deleting Text, Appending Text,Text Handling +@node Editing in Insert State @subsection Editing in Insert State Minibuffer can be edited similarly to Insert state, and you can switch @@ -3595,7 +3589,7 @@ current line. @kindex @kbd{C-w} @kindex @kbd{C-v} -@node Deleting Text, Changing Text, Editing in Insert State, Text Handling +@node Deleting Text @subsection Deleting Text @@ -3638,7 +3632,7 @@ Shift <count> lines one shiftwidth to the left. @kindex @kbd{X} @kindex @kbd{x} -@node Changing Text, Search and Replace, Deleting Text,Text Handling +@node Changing Text @subsection Changing Text @cindex joining lines @@ -3746,7 +3740,7 @@ destructive Vi commands. @kindex @kbd{R} @kindex @kbd{r<char>} -@node Search and Replace, Yanking, Changing Text,Text Handling +@node Search and Replace @subsection Search and Replace @xref{Groundwork}, for Ex address syntax. @xref{Options}, to see how to @@ -3829,7 +3823,7 @@ Execute <ex-command> on all lines that do not match <pattern>. @kindex @kbd{?<string>} @kindex @kbd{/<string>} -@node Yanking,Undoing,Search and Replace,Text Handling +@node Yanking @subsection Yanking @cindex cut and paste @@ -3876,7 +3870,7 @@ Put the contents of the (default undo) buffer @kindex @kbd{yank} @findex @kbd{:yank} -@node Undoing,, Yanking,Text Handling +@node Undoing @subsection Undoing @cindex undo @@ -3902,7 +3896,7 @@ that have a @samp{~} appended to them. @kindex @kbd{U} @kindex @kbd{u} -@node Display, File and Buffer Handling, Text Handling, Commands +@node Display @section Display @cindex scrolling @@ -3961,7 +3955,7 @@ Put line <count> in the center of the window @kindex @kbd{C-g} -@node File and Buffer Handling, Mapping, Display,Commands +@node File and Buffer Handling @section File and Buffer Handling @cindex multiple files @@ -4113,7 +4107,7 @@ is typed in minibuffer. File completion and history are supported. @findex @kbd{:cd [<dir>]} @findex @kbd{:pwd} -@node Mapping, Shell Commands, File and Buffer Handling, Commands +@node Mapping @section Mapping @cindex key bindings @@ -4180,7 +4174,7 @@ Show contents of register. @findex @kbd{:unmap!@: <char>} @findex @kbd{:map!@: <char> <seq>} -@node Shell Commands, Options, Mapping, Commands +@node Shell Commands @section Shell Commands @cindex % (Current file) @@ -4246,7 +4240,7 @@ Run the make command in the current directory. @findex @kbd{:sh} @findex @kbd{:make} -@node Options,Emacs Related Commands,Shell Commands,Commands +@node Options @section Options @cindex Vi options @@ -4367,7 +4361,7 @@ Set <option> to <value>. @findex @kbd{:set ai} @findex @kbd{:set autoindent} -@node Emacs Related Commands,,Options,Commands +@node Emacs Related Commands @section Emacs Related Commands @table @kbd @@ -4417,7 +4411,7 @@ you need. @kindex @kbd{C-\} @kindex @kbd{C-c\} -@node Mouse-bound Commands,,,Commands +@node Mouse-bound Commands @section Mouse-bound Commands The following two mouse actions are normally bound to special search and @@ -4446,8 +4440,11 @@ already bound to something else. @kindex @kbd{meta button1up} @kindex @kbd{meta button2up} -@node Acknowledgments,,,Top -@comment node-name, next, previous, up +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Acknowledgments @unnumbered Acknowledgments Viper, formerly known as VIP-19, was written by Michael Kifer. Viper is @@ -4521,36 +4518,27 @@ whicken@@dragon.parasoft.com (Wendell Hicken), zapman@@cc.gatech.edu (Jason Zapman II), @end example -@node GNU Free Documentation License,,, Top -@appendix GNU Free Documentation License -@include doclicense.texi - -@node Key Index,Function Index,,Top -@comment node-name, next, previous, up +@node Key Index @unnumbered Key Index @printindex ky -@node Function Index,Variable Index,Key Index,Top -@comment node-name, next, previous, up +@node Function Index @unnumbered Function Index @printindex fn -@node Variable Index,Package Index,Function Index,Top -@comment node-name, next, previous, up +@node Variable Index @unnumbered Variable Index @printindex vr -@node Package Index,Concept Index,Variable Index,Top -@comment node-name, next, previous, up +@node Package Index @unnumbered Package Index @printindex pg -@node Concept Index,,Package Index,Top -@comment node-name, next, previous, up +@node Concept Index @unnumbered Concept Index @printindex cp diff --git a/doc/misc/widget.texi b/doc/misc/widget.texi index 816ee6abf8b..f2c403a2c14 100644 --- a/doc/misc/widget.texi +++ b/doc/misc/widget.texi @@ -31,8 +31,7 @@ modify this GNU manual.'' @contents -@node Top, Introduction, (dir), (dir) -@comment node-name, next, previous, up +@node Top @top The Emacs Widget Library @insertcopying @@ -54,9 +53,8 @@ modify this GNU manual.'' * Index:: @end menu -@node Introduction, User Interface, Top, Top -@comment node-name, next, previous, up -@section Introduction +@node Introduction +@chapter Introduction Most graphical user interface toolkits provide a number of standard user interface controls (sometimes known as `widgets' or `gadgets'). @@ -135,9 +133,8 @@ extended to use the GUI features. This means that your code using the widget library will also use the new graphic features automatically. @end enumerate -@node User Interface, Programming Example, Introduction, Top -@comment node-name, next, previous, up -@section User Interface +@node User Interface +@chapter User Interface A form consists of read only text for documentation and some fields, where each field contains two parts, a tag and a value. The tags are @@ -183,7 +180,7 @@ The top level widgets in this example are tagged @samp{Name}, within a form, namely editing the editable text fields and activating the buttons. -@subsection Editable Text Fields +@section Editable Text Fields In the example, the value for the @samp{Name} is most likely displayed in an editable text field, and so are values for each of the members of @@ -220,7 +217,7 @@ The editing text fields are highlighted with the Face used for other editing fields. @end deffn -@subsection Buttons +@section Buttons @cindex widget buttons @cindex button widgets @@ -291,7 +288,7 @@ Face used for highlighting a button when the mouse pointer moves across it. @end defopt -@subsection Navigation +@section Navigation You can use all the normal Emacs commands to move around in a form buffer, plus you will have these additional commands: @@ -308,9 +305,8 @@ Move point @var{count} buttons or editing fields backward. @end deffn @end table -@node Programming Example, Setting Up the Buffer, User Interface, Top -@comment node-name, next, previous, up -@section Programming Example +@node Programming Example +@chapter Programming Example @cindex widgets, programming example @cindex example of using widgets @@ -409,9 +405,8 @@ Interface}). (widget-setup)) @end lisp -@node Setting Up the Buffer, Basic Types, Programming Example, Top -@comment node-name, next, previous, up -@section Setting Up the Buffer +@node Setting Up the Buffer +@chapter Setting Up the Buffer Widgets are created with @code{widget-create}, which returns a @dfn{widget} object. This object can be queried and manipulated by @@ -463,9 +458,8 @@ Keymap used by @code{widget-button-press} and @code{widget-button-click} when not on a button. By default this is @code{global-map}. @end defvar -@node Basic Types, Sexp Types, Setting Up the Buffer, Top -@comment node-name, next, previous, up -@section Basic Types +@node Basic Types +@chapter Basic Types This is the general syntax of a type specification: @@ -706,9 +700,8 @@ If non-@code{nil}, allow glyphs to appear on displays where they are supported. * group:: @end menu -@node link, url-link, Basic Types, Basic Types -@comment node-name, next, previous, up -@subsection The @code{link} Widget +@node link +@section The @code{link} Widget @findex link@r{ widget} Syntax: @@ -731,9 +724,8 @@ String to prefix links. String to suffix links. @end defopt -@node url-link, info-link, link, Basic Types -@comment node-name, next, previous, up -@subsection The @code{url-link} Widget +@node url-link +@section The @code{url-link} Widget @findex url-link@r{ widget} Syntax: @@ -746,9 +738,8 @@ Syntax: When this link is invoked, the @acronym{WWW} browser specified by @code{browse-url-browser-function} will be called with @var{url}. -@node info-link, push-button, url-link, Basic Types -@comment node-name, next, previous, up -@subsection The @code{info-link} Widget +@node info-link +@section The @code{info-link} Widget @findex info-link@r{ widget} Syntax: @@ -760,9 +751,8 @@ Syntax: When this link is invoked, the built-in Info reader is started on @var{address}. -@node push-button, editable-field, info-link, Basic Types -@comment node-name, next, previous, up -@subsection The @code{push-button} Widget +@node push-button +@section The @code{push-button} Widget @findex push-button@r{ widget} Syntax: @@ -785,9 +775,8 @@ String to prefix push buttons. String to suffix push buttons. @end defopt -@node editable-field, text, push-button, Basic Types -@comment node-name, next, previous, up -@subsection The @code{editable-field} Widget +@node editable-field +@section The @code{editable-field} Widget @findex editable-field@r{ widget} Syntax: @@ -835,9 +824,8 @@ them. Pressing @key{RET} invokes the function specified by @code{:action}. @end table -@node text, menu-choice, editable-field, Basic Types -@comment node-name, next, previous, up -@subsection The @code{text} Widget +@node text +@section The @code{text} Widget @findex text@r{ widget} @vindex widget-text-keymap @@ -845,9 +833,8 @@ This is just like @code{editable-field}, but intended for multiline text fields. The default @code{:keymap} is @code{widget-text-keymap}, which does not rebind the @key{RET} key. -@node menu-choice, radio-button-choice, text, Basic Types -@comment node-name, next, previous, up -@subsection The @code{menu-choice} Widget +@node menu-choice +@section The @code{menu-choice} Widget @findex menu-choice@r{ widget} Syntax: @@ -886,9 +873,8 @@ The current chosen type. The list of types. @end table -@node radio-button-choice, item, menu-choice, Basic Types -@comment node-name, next, previous, up -@subsection The @code{radio-button-choice} Widget +@node radio-button-choice +@section The @code{radio-button-choice} Widget @findex radio-button-choice@r{ widget} Syntax: @@ -953,9 +939,8 @@ Please note that such items added after the @code{radio-button-choice} widget has been created will @strong{not} be properly destructed when you call @code{widget-delete}. -@node item, choice-item, radio-button-choice, Basic Types -@comment node-name, next, previous, up -@subsection The @code{item} Widget +@node item +@section The @code{item} Widget @findex item@r{ widget} Syntax: @@ -968,9 +953,8 @@ The @var{value}, if present, is used to initialize the @code{:value} property. The value should be a string, which will be inserted in the buffer. This widget will only match the specified value. -@node choice-item, toggle, item, Basic Types -@comment node-name, next, previous, up -@subsection The @code{choice-item} Widget +@node choice-item +@section The @code{choice-item} Widget @findex choice-item@r{ widget} Syntax: @@ -985,9 +969,8 @@ buffer as a button. Activating the button of a @code{choice-item} is equivalent to activating the parent widget. This widget will only match the specified value. -@node toggle, checkbox, choice-item, Basic Types -@comment node-name, next, previous, up -@subsection The @code{toggle} Widget +@node toggle +@section The @code{toggle} Widget @findex toggle@r{ widget} Syntax: @@ -1018,9 +1001,8 @@ Name of a glyph to be used instead of the @samp{:off} text string, on emacsen that supports this. @end table -@node checkbox, checklist, toggle, Basic Types -@comment node-name, next, previous, up -@subsection The @code{checkbox} Widget +@node checkbox +@section The @code{checkbox} Widget @findex checkbox@r{ widget} This widget has two possible states, @samp{selected} and @@ -1032,9 +1014,8 @@ Syntax: @var{type} ::= (checkbox [@var{keyword} @var{argument}]...) @end example -@node checklist, editable-list, checkbox, Basic Types -@comment node-name, next, previous, up -@subsection The @code{checklist} Widget +@node checklist +@section The @code{checklist} Widget @findex checklist@r{ widget} Syntax: @@ -1090,9 +1071,8 @@ The widgets representing each type. The list of types. @end table -@node editable-list, group, checklist, Basic Types -@comment node-name, next, previous, up -@subsection The @code{editable-list} Widget +@node editable-list +@section The @code{editable-list} Widget @findex editable-list@r{ widget} Syntax: @@ -1148,9 +1128,8 @@ The widgets representing the elements of the list. List whose @sc{car} is the type of the list elements. @end table -@node group, , editable-list, Basic Types -@comment node-name, next, previous, up -@subsection The @code{group} Widget +@node group +@section The @code{group} Widget @findex group@r{ widget} This widget simply group other widgets together. @@ -1163,9 +1142,8 @@ Syntax: The value is a list, with one member for each @var{type}. -@node Sexp Types, Widget Properties, Basic Types, Top -@comment -@section Sexp Types +@node Sexp Types +@chapter Sexp Types @cindex sexp types A number of widgets for editing @dfn{s-expressions} (Lisp types), sexp @@ -1179,9 +1157,8 @@ categories described in this section. * composite:: @end menu -@node constants, generic, Sexp Types, Sexp Types -@comment node-name, next, previous, up -@subsection The Constant Widgets +@node constants +@section The Constant Widgets @cindex constant widgets The @code{const} widget can contain any Lisp expression, but the user is @@ -1216,9 +1193,8 @@ An immutable symbol that is bound as a variable. An immutable symbol that is bound as a function. @end deffn -@node generic, atoms, constants, Sexp Types -@comment node-name, next, previous, up -@subsection Generic Sexp Widget +@node generic +@section Generic Sexp Widget @cindex generic sexp widget The @code{sexp} widget can contain any Lisp expression, and allows the @@ -1238,9 +1214,8 @@ The @code{sexp} widget takes the same keyword arguments as the @code{editable-field} widget. @xref{editable-field}. @end deffn -@node atoms, composite, generic, Sexp Types -@comment node-name, next, previous, up -@subsection Atomic Sexp Widgets +@node atoms +@section Atomic Sexp Widgets @cindex atomic sexp widget The atoms are s-expressions that do not consist of other s-expressions. @@ -1316,9 +1291,8 @@ either @code{nil} meaning false, or non-@code{nil} meaning true. @end deffn -@node composite, , atoms, Sexp Types -@comment node-name, next, previous, up -@subsection Composite Sexp Widgets +@node composite +@section Composite Sexp Widgets @cindex composite sexp widgets The syntax for the composite widget construct is: @@ -1418,9 +1392,8 @@ Specifies a list of any number of elements that fit a certain type. @end example @end deffn -@node Widget Properties, Defining New Widgets, Sexp Types, Top -@comment node-name, next, previous, up -@section Properties +@node Widget Properties +@chapter Properties @cindex properties of widgets @cindex widget properties @@ -1513,9 +1486,8 @@ its ancestors have been deactivated. Do not attempt to set the @code{:deactivate} keywords instead. -@node Defining New Widgets, Widget Browser, Widget Properties, Top -@comment node-name, next, previous, up -@section Defining New Widgets +@node Defining New Widgets +@chapter Defining New Widgets @cindex new widgets @cindex defining new widgets @@ -1698,9 +1670,8 @@ It provides most of the functionality that is referred to as ``by default'' in this text. @end deffn -@node Widget Browser, Widget Minor Mode, Defining New Widgets, Top -@comment node-name, next, previous, up -@section Widget Browser +@node Widget Browser +@chapter Widget Browser @cindex widget browser There is a separate package to browse widgets. This is intended to help @@ -1723,9 +1694,8 @@ Create a widget browser for the widget at @var{pos}. When called interactively, use the position of point. @end deffn -@node Widget Minor Mode, Utilities, Widget Browser, Top -@comment node-name, next, previous, up -@section Widget Minor Mode +@node Widget Minor Mode +@chapter Widget Minor Mode @cindex widget minor mode There is a minor mode for manipulating widgets in major modes that @@ -1741,9 +1711,8 @@ With arg, turn widget mode on if and only if arg is positive. Keymap used in @code{widget-minor-mode}. @end defvar -@node Utilities, Widget Wishlist, Widget Minor Mode, Top -@comment node-name, next, previous, up -@section Utilities. +@node Utilities +@chapter Utilities @cindex utility functions for widgets @defun widget-prompt-value widget prompt [ value unbound ] @@ -1757,9 +1726,8 @@ Get the item which @var{widget} is assumed to toggle. This is only meaningful for radio buttons or checkboxes in a list. @end defun -@node Widget Wishlist, GNU Free Documentation License, Utilities, Top -@comment node-name, next, previous, up -@section Wishlist +@node Widget Wishlist +@chapter Wishlist @cindex todo @itemize @bullet @@ -1816,12 +1784,11 @@ See @code{TeX-printer-list} for an explanation. Add a @code{mailto} widget. @end itemize -@node GNU Free Documentation License, Index, Widget Wishlist, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Index, , GNU Free Documentation License, Top -@comment node-name, next, previous, up +@node Index @unnumbered Index This is an alphabetical listing of all concepts, functions, commands, diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index 958e4a72b86..d8557b84a4f 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi @@ -133,10 +133,11 @@ June 1985, Report No. UCB/CSD 85/251. @item For generating the lookahead sets, Wisent uses the well-known -technique of F. DeRemer and A. Pennello they described in: +technique of F. DeRemer and A. Pennello described in: @quotation -@cite{Efficient Construction of LALR(1) Lookahead Sets}@* -October 1982, ACM TOPLS Vol 4 No 4. +@cite{Efficient Computation of LALR(1) Look-Ahead Sets}@* +October 1982, ACM TOPLAS Vol 4 No 4, 615--49, +@uref{http://dx.doi.org/10.1145/69622.357187}. @end quotation @item @@ -224,8 +225,7 @@ in between, can be combined into a larger grouping of type @samp{exp}. * Conflicts:: @end menu -@node Grammar format, Example, Wisent Grammar, Wisent Grammar -@comment node-name, next, previous, up +@node Grammar format @section Grammar format @cindex grammar format @@ -283,7 +283,7 @@ For example, Says that two groupings of type @samp{exp}, with a @samp{+} token in between, can be combined into a larger grouping of type @samp{exp}. - + @cindex grammar coding conventions By convention, a nonterminal symbol should be in lower case, such as @samp{exp}, @samp{stmt} or @samp{declaration}. Terminal symbols @@ -443,8 +443,7 @@ matching the empty string, for which the default action is to return @end table @end table -@node Example, Compiling a grammar, Grammar format, Wisent Grammar -@comment node-name, next, previous, up +@node Example @section Example @cindex grammar example @@ -559,8 +558,7 @@ exp: @end group @end example -@node Compiling a grammar, Conflicts, Example, Wisent Grammar -@comment node-name, next, previous, up +@node Compiling a grammar @section Compiling a grammar @cindex automaton @@ -618,8 +616,7 @@ an Emacs Lisp function (lambda expression). @end table @end defun -@node Conflicts, , Compiling a grammar, Wisent Grammar -@comment node-name, next, previous, up +@node Conflicts @section Conflicts Normally, a grammar should produce an automaton where at each state @@ -1214,7 +1211,7 @@ data type. @item start @itemx end -Are the optionals beginning and end positions of @var{value} in the +Are the optional beginning and ending positions of @var{value} in the input stream. @end table @@ -1337,8 +1334,8 @@ of the current statement if an error is detected: @example @group -(stmnt (( error ?; )) ;; on error, skip until ';' is read - ) +(statement (( error ?; )) ;; on error, skip until ';' is read + ) @end group @end example @@ -1606,7 +1603,7 @@ it can be worth a mix of the two styles! * Useful functions:: @end menu -@node Iterative style, Bison style, Grammar styles, Grammar styles +@node Iterative style @subsection Iterative style @cindex grammar iterative style diff --git a/doc/misc/woman.texi b/doc/misc/woman.texi index 8f8fd5f2287..3e4448ed1e0 100644 --- a/doc/misc/woman.texi +++ b/doc/misc/woman.texi @@ -2,11 +2,7 @@ @c %**start of header @setfilename ../../info/woman @settitle WoMan: Browse Unix Manual Pages ``W.O. (without) Man'' -@c FIXME -@c Manual last updated: -@set UPDATED Time-stamp: <2012-12-31 21:44:20 eggert> -@c Software version: -@set VERSION 0.54 (beta) +@include emacsver.texi @afourpaper @c With different size paper the printed page breaks will need attention! @c Look for @page and @need commands. @@ -43,7 +39,7 @@ modify this GNU manual.'' @titlepage @title WoMan @subtitle Browse Unix Manual Pages ``W.O. (without) Man'' -@subtitle Software Version @value{VERSION} +@subtitle as distributed with Emacs @value{EMACSVER} @author Francis J. Wright @sp 2 @author School of Mathematical Sciences @@ -53,8 +49,6 @@ modify this GNU manual.'' @author @email{F.J.Wright@@qmul.ac.uk} @author @uref{http://centaur.maths.qmw.ac.uk/} @c He no longer maintains this manual. -@sp 2 -@author Manual Last Updated @value{UPDATED} @comment The following two commands start the copyright page. @page @@ -67,13 +61,11 @@ modify this GNU manual.'' @c =================================================================== @ifnottex -@node Top, Introduction, (dir), (dir) -@comment node-name, next, previous, up +@node Top @top WoMan: Browse Unix Manual Pages ``W.O. (without) Man'' @display -Software Version @value{VERSION} -Manual Last Updated @value{UPDATED} +As distributed with Emacs @value{EMACSVER}. @email{F.J.Wright@@qmw.ac.uk, Francis J. Wright} @uref{http://centaur.maths.qmw.ac.uk/, School of Mathematical Sciences} @@ -103,8 +95,7 @@ Mile End Road, London E1 4NS, UK @c =================================================================== -@node Introduction, Background, Top, Top -@comment node-name, next, previous, up +@node Introduction @chapter Introduction @cindex introduction @@ -165,8 +156,7 @@ Reporting Bugs}. @c =================================================================== -@node Background, Finding, Introduction, Top -@comment node-name, next, previous, up +@node Background @chapter Background @cindex background @@ -295,8 +285,7 @@ be possible to move WoMan from an emulation of @code{nroff} to an emulation of @code{troff} as GNU Emacs moves to providing bit-mapped display facilities. -@node Finding, Browsing, Background, Top -@comment node-name, next, previous, up +@node Finding @chapter Finding and Formatting Man Pages @cindex using, finding man pages @cindex using, formatting man pages @@ -352,8 +341,7 @@ setting WoMan file paths. * Automatic:: Automatic Interface @end menu -@node Topic, Filename, Finding, Finding -@comment node-name, next, previous, up +@node Topic @section Topic Interface @cindex topic interface @@ -434,8 +422,7 @@ slow. @xref{Cache, , The WoMan Topic Cache}, for further details. * Word at point:: Using the "Word at Point" as a Topic Suggestion @end menu -@node Cache, Word at point, Topic, Topic -@comment node-name, next, previous, up +@node Cache @subsection The WoMan Topic Cache @cindex topic cache @cindex cache, topic @@ -469,8 +456,7 @@ automatically update its cache file on disc (if one is in use) the next time it is run in a new Emacs session. -@node Word at point, , Cache, Topic -@comment node-name, next, previous, up +@node Word at point @subsection Using the "Word at Point" as a Topic Suggestion @cindex word at point @cindex point, word at @@ -496,8 +482,7 @@ point without seeking confirmation: @end lisp -@node Filename, Automatic, Topic, Finding -@comment node-name, next, previous, up +@node Filename @section Filename Interface @cindex filename interface @@ -546,8 +531,7 @@ the current buffer if it is visiting a man file, although it is primarily used internally by WoMan. -@node Automatic, , Filename, Finding -@comment node-name, next, previous, up +@node Automatic @section Automatic Interface @cindex automatic interface @@ -584,8 +568,7 @@ by automatic major mode selection.] @c =================================================================== -@node Browsing, Customization, Finding, Top -@comment node-name, next, previous, up +@node Browsing @chapter Browsing Man Pages @cindex using, browsing man pages @cindex browsing man pages @@ -615,8 +598,7 @@ blank lines squeezed to a single blank line. * Imenu:: Imenu Support; Contents Menu @end menu -@node Fonts, Navigation, Browsing, Browsing -@comment node-name, next, previous, up +@node Fonts @section Fonts and Faces @cindex fonts @cindex faces @@ -631,8 +613,7 @@ currently means the characters ^ and _ used to indicate super- and sub-scripts, which are not displayed well by WoMan. -@node Navigation, References, Fonts, Browsing -@comment node-name, next, previous, up +@node Navigation @section Navigation @cindex navigation @@ -677,8 +658,7 @@ described by @code{Man-see-also-regexp}. @end table -@node References, Changing, Navigation, Browsing -@comment node-name, next, previous, up +@node References @section Following References @cindex following references @cindex references @@ -721,8 +701,7 @@ default is based on word at point. @end table -@node Changing, Convenience, References, Browsing -@comment node-name, next, previous, up +@node Changing @section Changing the Current Man Page @cindex changing current man page @cindex current man page, changing @@ -789,8 +768,7 @@ Call WoMan to reformat the last man page formatted by WoMan @end table -@node Convenience, Imenu, Changing, Browsing -@comment node-name, next, previous, up +@node Convenience @section Convenience Key Bindings @cindex convenience key bindings @cindex key bindings, convenience @@ -831,8 +809,7 @@ followed by the minor modes, each on a separate page. @end table -@node Imenu, , Convenience, Browsing -@comment node-name, next, previous, up +@node Imenu @section Imenu Support; Contents Menu @cindex imenu support @cindex contents menu @@ -852,8 +829,7 @@ is distributed with GNU Emacs. @c =================================================================== -@node Customization, Log, Browsing, Top -@comment node-name, next, previous, up +@node Customization @chapter Customization @cindex customization @@ -910,8 +886,7 @@ man page. * Special symbols:: @end menu -@node Interface Options, Formatting Options, Customization, Customization -@comment node-name, next, previous, up +@node Interface Options @section Interface Options @cindex interface options @@ -1137,8 +1112,7 @@ default value is non-@code{nil}. @end vtable -@node Formatting Options, Faces, Interface Options, Customization -@comment node-name, next, previous, up +@node Formatting Options @section Formatting Options @cindex formatting options @@ -1181,8 +1155,7 @@ untested. @end vtable -@node Faces, Special symbols, Formatting Options, Customization -@comment node-name, next, previous, up +@node Faces @section Faces @cindex faces @@ -1217,8 +1190,7 @@ Default: foreground orange. @end vtable -@node Special symbols, , Faces, Customization -@comment node-name, next, previous, up +@node Special symbols @section Special symbols @cindex special symbols @@ -1255,8 +1227,7 @@ Under MS-Windows, the default is @c =================================================================== -@node Log, Technical, Customization, Top -@comment node-name, next, previous, up +@node Log @chapter The *WoMan-Log* Buffer @cindex log buffer @cindex buffer, log @@ -1280,8 +1251,7 @@ left in the formatted buffer to indicate precisely where they occurred. @c =================================================================== -@node Technical, Bugs, Log, Top -@comment node-name, next, previous, up +@node Technical @chapter Technical Details @cindex technical details @cindex horizontal spacing @@ -1305,8 +1275,7 @@ is output. @c =================================================================== -@node Bugs, Acknowledgments, Technical, Top -@comment node-name, next, previous, up +@node Bugs @chapter Reporting Bugs @cindex reporting bugs @cindex bugs, reporting @@ -1330,8 +1299,7 @@ man source file from, but do not send it unless asked to send it. @c =================================================================== -@node Acknowledgments, GNU Free Documentation License, Bugs, Top -@comment node-name, next, previous, up +@node Acknowledgments @chapter Acknowledgments @cindex acknowledgments @@ -1387,18 +1355,16 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il} @page -@node GNU Free Documentation License, Command Index, Acknowledgments, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -@node Command Index, Variable Index, GNU Free Documentation License, Top -@comment node-name, next, previous, up +@node Command Index @unnumbered Command Index @printindex fn -@node Variable Index, Keystroke Index, Command Index, Top -@comment node-name, next, previous, up +@node Variable Index @unnumbered Variable Index @printindex vr @@ -1409,8 +1375,7 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il} @page -@node Keystroke Index, Concept Index, Variable Index, Top -@comment node-name, next, previous, up +@node Keystroke Index @unnumbered Keystroke Index @printindex ky @@ -1421,8 +1386,7 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il} @page -@node Concept Index, , Keystroke Index, Top -@comment node-name, next, previous, up +@node Concept Index @unnumbered Concept Index @printindex cp |