From a9645338e4109570ec64c902526d028c75e4369f Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Fri, 2 Apr 2021 09:40:22 -0400 Subject: * doc/misc/reftex.texi: Remove outdated instructions (Building and Installing, Installation with make) (Installation by Hand, Loading @RefTeX{}): Delete sections. (Entering @RefTeX{} Mode): Merge into its parent. (AUCTeX): Point to GNU ELPA for installation. (Problems and Work-Arounds): Remove XEmacs-specific item. --- doc/misc/reftex.texi | 85 ++-------------------------------------------------- 1 file changed, 3 insertions(+), 82 deletions(-) (limited to 'doc/misc/reftex.texi') diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index 599252fabf7..f1074d3d143 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi @@ -254,73 +254,6 @@ version 20.2. It has also been bundled and pre-installed with XEmacs plug-in package which is available from the @value{XEMACSFTP}. See the XEmacs 21.x documentation on package installation for details. -Users of earlier Emacs distributions (including Emacs 19) or people -craving for new features and bugs can get a copy of the @RefTeX{} -distribution from the maintainer's web page. @xref{Imprint}, for more -information. The following instructions will guide you through the -process of installing such a distribution. - -@subsection Building and Installing - -Note: Currently installation is supported for Emacs only. XEmacs users -might want to refer to the @RefTeX{} package available through the -package system of XEmacs. - -@subsubheading Installation with make - -In order to install RefTeX, unpack the distribution and edit the header -of the Makefile. Basically, you need to change the path specifications -for Emacs Lisp files and info files. Also, enter the name of your Emacs -executable (usually either @samp{emacs} or @samp{xemacs}). - -Then, type - -@example -make -make install -@end example - -to compile and install the code and documentation. - -Per default @RefTeX{} is installed in its own subdirectory which might -not be on your load path. In this case, add it to load path with a -command like the following, replacing the sample directory with the one -where @RefTeX{} is installed in your case. - -@example -(add-to-list 'load-path "/path/to/reftex") -@end example - -Put this command into your init file before other @RefTeX{}-related -settings. - -@subsubheading Installation by Hand - -If you want to get your hands dirty, there is also the possibility to -install by manually copying files. - -@enumerate a -@item -Copy the reftex*.el lisp files to a directory on your load path. Make -sure that no old copy of @RefTeX{} shadows these files. -@item -Byte compile the files. The sequence of compiling should be: -reftex-var.el, reftex.el, and then all the others. -@item -Copy the info file reftex.info to the info directory. -@end enumerate - -@subsection Loading @RefTeX{} - -In order to make the most important functions for entering @RefTeX{} -mode available add the following line to your init file. - -@example -(require 'reftex) -@end example - -@subsection Entering @RefTeX{} Mode - @findex turn-on-reftex @findex reftex-mode @vindex LaTeX-mode-hook @@ -3259,9 +3192,9 @@ with the @kbd{g} key. To get this behavior, use instead @AUCTeX{} is without doubt the best major mode for editing @TeX{} and @LaTeX{} files with Emacs (@pxref{Top,AUCTeX,,auctex, The AUCTeX User Manual}). -If @AUCTeX{} is not part of your Emacs distribution, you can get -it@footnote{XEmacs 21.x users may want to install the corresponding -XEmacs package.} by FTP from the @value{AUCTEXSITE}. +You can get it from its home page at @value{AUCTEXSITE}, but since +it is available from GNU ELPA, you can simply install it from @kbd{M-x +list-packages}. @menu * AUCTeX-RefTeX Interface:: How both packages work together @@ -3610,18 +3543,6 @@ as a label of type @code{?p}. Argument count for this macro starts only after the @samp{@{step+@}}, also when specifying how to get context. -@item -@b{Idle timers in XEmacs}@* -@cindex Idle timer restart -@vindex reftex-use-itimer-in-xemacs -In XEmacs, idle timer restart does not work reliably after fast -keystrokes. Therefore @RefTeX{} currently uses the post command -hook to start the timer used for automatic crossref information. When -this bug gets fixed, a real idle timer can be requested with -@lisp -(setq reftex-use-itimer-in-xemacs t) -@end lisp - @item @b{Viper mode}@* @cindex Viper mode -- cgit v1.2.3 From fa33870e9f6335d47006d1e998785b5c3e7c7fbe Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Thu, 13 May 2021 09:08:40 -0700 Subject: Remove more hand-written node pointers in doc/misc * doc/misc/ede.texi, doc/misc/mh-e.texi, doc/misc/reftex.texi: * doc/misc/todo-mode.texi: Remove hand-written node pointers. --- doc/misc/ede.texi | 138 +++++++++++++++++++++++----------------------- doc/misc/mh-e.texi | 144 ++++++++++++++++++++++++------------------------ doc/misc/reftex.texi | 2 +- doc/misc/todo-mode.texi | 70 +++++++++++------------ 4 files changed, 177 insertions(+), 177 deletions(-) (limited to 'doc/misc/reftex.texi') diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi index a53f879c961..a0f316f8480 100644 --- a/doc/misc/ede.texi +++ b/doc/misc/ede.texi @@ -67,7 +67,7 @@ modify this GNU manual.'' @contents -@node Top, EDE Project Concepts, (dir), (dir) +@node Top @top EDE @comment node-name, next, previous, up @@ -95,7 +95,7 @@ learn and adopt GNU ways of doing things. * GNU Free Documentation License:: The license for this documentation. @end menu -@node EDE Project Concepts, EDE Mode, Top, Top +@node EDE Project Concepts @chapter @ede{} Project Concepts @ede{} is a generic interface for managing projects. It specifies a @@ -130,7 +130,7 @@ of search to files in a single target, or to discover the location of documentation or interface files. @ede{} can provide this information. -@node EDE Mode, Quick Start, EDE Project Concepts, Top +@node EDE Mode @chapter @ede{} Mode @ede{} is implemented as a minor mode, which augments other modes such @@ -147,7 +147,7 @@ bar. This menu provides several menu items for high-level @ede{} commands. These menu items, and their corresponding keybindings, are independent of the type of project you are actually working on. -@node Quick Start, Creating a project, EDE Mode, Top +@node Quick Start @chapter Quick Start Once you have @ede{} enabled, you can create a project. This chapter @@ -443,7 +443,7 @@ C-c . R @key{RET} @key{RET} If your program takes command line arguments, you can type them in when it offers the command line you want to use to run your program. -@node Creating a project, Modifying your project, Quick Start, Top +@node Creating a project @chapter Creating a project To create a new project, first visit a file that you want to include @@ -488,7 +488,7 @@ the top-most project's makefile as a starting place for the build. How the toplevel project handles subprojects in the build process is dependent on that project's type. -@node Modifying your project, Building and Debugging, Creating a project, Top +@node Modifying your project @chapter Modifying your project In this chapter, we describe the generic features for manipulating @@ -504,7 +504,7 @@ detailed information about exactly what these features do. * EDE Project Features:: @end menu -@node Add/Remove target, Add/Remove files, Modifying your project, Modifying your project +@node Add/Remove target @section Add/Remove target To create a new target, type @kbd{C-c . t} (@code{ede-new-target}) or @@ -520,7 +520,7 @@ To remove a target from the project, type @kbd{M-x ede-delete-target}, or use the @samp{Remove Target} menu item in the @samp{Project Options} submenu. -@node Add/Remove files, Customize Features, Add/Remove target, Modifying your project +@node Add/Remove files @section Add/Remove files To add the current file to an existing target, type @kbd{C-c . a} @@ -541,7 +541,7 @@ not wish to add the file to any target, you can choose @samp{none}. You can customize this behavior with the variable @command{ede-auto-add-method}. -@node Customize Features, Project Local Variables, Add/Remove files, Modifying your project +@node Customize Features @section Customize Features A project, and its targets, are objects using the @samp{EIEIO} object @@ -561,7 +561,7 @@ object, you can edit the file by typing @kbd{C-c . e} (@code{ede-edit-file-target}). You should ``rescan'' the project afterwards (@pxref{Miscellaneous commands}). -@node Project Local Variables, EDE Project Features, Customize Features, Modifying your project +@node Project Local Variables @section Project Local Variables EDE projects can store and manager project local variables. The @@ -598,7 +598,7 @@ the format is an association list. For example: (compile-command . "make -f MyCustomMakefile all"))) @end example -@node EDE Project Features, , Project Local Variables, Modifying your project +@node EDE Project Features @section EDE Project Features This section details user facing features of an @ede{} @samp{Make} @@ -618,7 +618,7 @@ additional details. * Configurations:: @end menu -@node Changing Compilers and Flags, Configurations, EDE Project Features, EDE Project Features +@node Changing Compilers and Flags @subsection Changing Compilers and Flags Targets that build stuff need compilers. To change compilers, you @@ -638,7 +638,7 @@ see what commands are inserted. Once you have determined the variable you need to modify, you can add a configuration for it. @xref{Configurations}. -@node Configurations, , Changing Compilers and Flags, EDE Project Features +@node Configurations @subsection Configurations Configurations specify different ways to build a project. For @@ -658,7 +658,7 @@ block for ``configurations''. Add a new named configuration here. To switch between different active configurations, modify the ``configuration default'' slot. -@node Building and Debugging, Miscellaneous commands, Modifying your project, Top +@node Building and Debugging @chapter Building and Debugging @ede{} provides the following ``project-aware'' compilation and @@ -677,7 +677,7 @@ Build a distribution file for your project. These commands are also available from the @samp{Development} menu. -@node Miscellaneous commands, Extending EDE, Building and Debugging, Top +@node Miscellaneous commands @chapter Miscellaneous commands If you opt to go in and edit @ede{} project files directly---for @@ -716,7 +716,7 @@ To activate the speedbar in this mode, type @kbd{C-c . s} * Simple projects:: Projects @ede{} doesn't manage. @end menu -@node Make and Automake projects, Automake direct projects, Miscellaneous commands, Miscellaneous commands +@node Make and Automake projects @section Make and Automake projects A project of @samp{ede-project} type creates a file called @@ -728,7 +728,7 @@ in @samp{Makefile} mode, then this project will autogenerate a routines will also import and maintain a configure.am script and a host of other files required by Automake. -@node Automake direct projects, Simple projects, Make and Automake projects, Miscellaneous commands +@node Automake direct projects @section Automake direct projects The project type that reads @file{Makefile.am} directly is derived @@ -738,7 +738,7 @@ distributed independently. This mode eventually became @ede{}. The not generate them automatically, or create new ones. As such, it is useful as a browsing tool, or as maintenance in managing file lists. -@node Simple projects, , Automake direct projects, Miscellaneous commands +@node Simple projects @section Simple Projects There is a wide array of simple projects. In this case a simple @@ -756,7 +756,7 @@ belonging to a project, but doesn't provide many features of a typical * Custom Locate:: Customizing how to locate files in a simple project @end menu -@node ede-cpp-root, ede-emacs, Simple projects, Simple projects +@node ede-cpp-root @subsection ede-cpp-root The @code{ede-cpp-root} project type allows you to create a single @@ -897,7 +897,7 @@ of project. @xref{ede-cpp-root-project}, for details about the class that defines the @code{ede-cpp-root} project type. -@node ede-emacs, ede-linux, ede-cpp-root, Simple projects +@node ede-emacs @subsection ede-emacs The @code{ede-emacs} project automatically identifies an Emacs source @@ -906,7 +906,7 @@ tree, and enables EDE project mode for it. It pre-populates the C Preprocessor symbol map for correct parsing, and has an optimized include file identification function. -@node ede-linux, ede-generic-project, ede-emacs, Simple projects +@node ede-linux @subsection ede-linux The @code{ede-linux} project will automatically identify a Linux @@ -921,7 +921,7 @@ directory and its architecture, respectively. The default is to assume that the build happens in the source directory and to auto-detect the architecture; if the auto-detection fails, you will be asked. -@node ede-generic-project, Custom Locate, ede-linux, Simple projects +@node ede-generic-project @subsection ede-generic-project The @code{ede-generic-project} is a project system that makes it easy @@ -972,7 +972,7 @@ This example project will detect any directory with the file Customization of the project will allow you to make build and debug commands more precise. -@node Custom Locate, , ede-generic-project, Simple projects +@node Custom Locate @subsection Custom Locate The various simple project styles all have one major drawback, which @@ -1014,7 +1014,7 @@ simple example. More on idutils and cscope is in the CEDET manual, and they each have their own section. -@node Extending EDE, GNU Free Documentation License, Miscellaneous commands, Top +@node Extending EDE @chapter Extending @ede{} This chapter is intended for users who want to write new parts or fix @@ -1069,7 +1069,7 @@ examples. * Compilers:: Details of compiler classes. @end menu -@node Development Overview, Detecting a Project, Extending EDE, Extending EDE +@node Development Overview @section Development Overview @ede{} is made up of a series of classes implemented with @eieio{}. @@ -1161,7 +1161,7 @@ Here is a high-level UML diagram for the @ede{} system created with @cogre{}.. @end example -@node Detecting a Project, User interface methods, Development Overview, Extending EDE +@node Detecting a Project @section Detecting a Project Project detection happens with the list of @code{ede-project-autoload} @@ -1226,7 +1226,7 @@ to the global list of all projects. All subprojects are then created and assembled into the project data structures. -@node User interface methods, Base project methods, Detecting a Project, Extending EDE +@node User interface methods @section User interface methods These methods are core behaviors associated with user commands. @@ -1258,7 +1258,7 @@ Make a distribution (tar archive) of the project. Rescan a project file, changing the data in the existing objects. @end table -@node Base project methods, Sourcecode objects, User interface methods, Extending EDE +@node Base project methods @section Base project methods These methods are important for querying base information from project @@ -1296,7 +1296,7 @@ stored in. List all documentation a project or target is responsible for. @end table -@node Sourcecode objects, Compiler and Linker objects, Base project methods, Extending EDE +@node Sourcecode objects @section Sourcecode objects @ede{} projects track source file / target associates via source code @@ -1342,7 +1342,7 @@ In this case, the garbage pattern is the same. @xref{Sourcecode}. -@node Compiler and Linker objects, Project, Sourcecode objects, Extending EDE +@node Compiler and Linker objects @section Compiler and Linker objects In order for a target to create a @file{Makefile}, it must know how to @@ -1403,7 +1403,7 @@ See @file{ede-proj-obj.el} for examples of the combination. @defindex sc @defindex cm -@node Project, Targets, Compiler and Linker objects, Extending EDE +@node Project @section Project @menu @@ -1417,7 +1417,7 @@ See @file{ede-proj-obj.el} for examples of the combination. * ede-step-project:: @end menu -@node ede-project-placeholder, ede-project, Project, Project +@node ede-project-placeholder @subsection ede-project-placeholder @pjindex ede-project-placeholder @@ -1503,7 +1503,7 @@ Make sure placeholder @var{THIS} is replaced with the real thing, and pass throu Make sure placeholder @var{THIS} is replaced with the real thing, and pass through. @end deffn -@node ede-project, ede-cpp-root-project, ede-project-placeholder, Project +@node ede-project @subsection ede-project @pjindex ede-project @@ -1789,7 +1789,7 @@ Retrieves the slot @code{menu} from an object of class @code{ede-project} Commit change to local variables in @var{PROJ}. @end deffn -@node ede-cpp-root-project, ede-simple-project, ede-project, Project +@node ede-cpp-root-project @subsection ede-cpp-root-project @pjindex ede-cpp-root-project @@ -1911,7 +1911,7 @@ Within this project @var{PROJ}, find the file @var{NAME}. This knows details about or source tree. @end deffn -@node ede-simple-project, ede-simple-base-project, ede-cpp-root-project, Project +@node ede-simple-project @subsection ede-simple-project @pjindex ede-simple-project @@ -1941,7 +1941,7 @@ No children Commit any change to @var{PROJ} to its file. @end deffn -@node ede-simple-base-project, ede-proj-project, ede-simple-project, Project +@node ede-simple-base-project @subsection ede-simple-base-project @pjindex ede-simple-base-project @@ -1971,7 +1971,7 @@ This one project could control a tree of subdirectories. @table @asis @end table -@node ede-proj-project, project-am-makefile, ede-simple-base-project, Project +@node ede-proj-project @subsection ede-proj-project @pjindex ede-proj-project @@ -2161,7 +2161,7 @@ Return a list of files that constitutes a distribution of @var{THIS} project. Commit change to local variables in @var{PROJ}. @end deffn -@node project-am-makefile, ede-step-project, ede-proj-project, Project +@node project-am-makefile @subsection project-am-makefile @pjindex project-am-makefile @@ -2203,7 +2203,7 @@ Despite the fact that this is a method, it depends on the current buffer being in order to provide a smart default target type. @end deffn -@node ede-step-project, , project-am-makefile, Project +@node ede-step-project @subsection ede-step-project @pjindex ede-step-project @@ -2328,7 +2328,7 @@ Return a list of files that constitutes a distribution of @var{THIS} project. Commit change to local variables in @var{PROJ}. @end deffn -@node Targets, Sourcecode, Project, Extending EDE +@node Targets @section Targets @menu @@ -2356,7 +2356,7 @@ Commit change to local variables in @var{PROJ}. @end menu -@node ede-target, ede-proj-target, Targets, Targets +@node ede-target @subsection ede-target @tgindex ede-target @@ -2565,7 +2565,7 @@ Return the name of @var{THIS} target, suitable for make or debug style commands. Retrieves the slot @code{menu} from an object of class @code{ede-target} @end deffn -@node ede-proj-target, ede-proj-target-makefile, ede-target, Targets +@node ede-proj-target @subsection ede-proj-target @tgindex ede-proj-target @@ -2754,7 +2754,7 @@ sources variable. @end deffn -@node ede-proj-target-makefile, semantic-ede-proj-target-grammar, ede-proj-target, Targets +@node ede-proj-target-makefile @subsection ede-proj-target-makefile @tgindex ede-proj-target-makefile @@ -2852,7 +2852,7 @@ Return a list of configuration variables from @var{THIS}. Use @var{CONFIGURATION} as the current configuration to query. @end deffn -@node semantic-ede-proj-target-grammar, ede-proj-target-makefile-objectcode, ede-proj-target-makefile, Targets +@node semantic-ede-proj-target-grammar @subsection semantic-ede-proj-target-grammar @tgindex semantic-ede-proj-target-grammar @@ -2906,7 +2906,7 @@ Argument @var{THIS} is the target that should insert stuff. @end deffn -@node ede-proj-target-makefile-objectcode, ede-proj-target-makefile-archive, semantic-ede-proj-target-grammar, Targets +@node ede-proj-target-makefile-objectcode @subsection ede-proj-target-makefile-objectcode @tgindex ede-proj-target-makefile-objectcode @@ -2968,7 +2968,7 @@ Argument @var{THIS} is the target to get sources from. @end deffn -@node ede-proj-target-makefile-archive, ede-proj-target-makefile-program, ede-proj-target-makefile-objectcode, Targets +@node ede-proj-target-makefile-archive @subsection ede-proj-target-makefile-archive @tgindex ede-proj-target-makefile-archive @@ -3011,7 +3011,7 @@ Makefile.am generator, so use it to add this important bin program. @end deffn -@node ede-proj-target-makefile-program, ede-proj-target-makefile-shared-object, ede-proj-target-makefile-archive, Targets +@node ede-proj-target-makefile-program @subsection ede-proj-target-makefile-program @tgindex ede-proj-target-makefile-program @@ -3090,7 +3090,7 @@ Insert bin_PROGRAMS variables needed by target @var{THIS}. @end deffn -@node ede-proj-target-makefile-shared-object, ede-proj-target-elisp, ede-proj-target-makefile-program, Targets +@node ede-proj-target-makefile-shared-object @subsection ede-proj-target-makefile-shared-object @tgindex ede-proj-target-makefile-shared-object @@ -3150,7 +3150,7 @@ Makefile.am generator, so use it to add this important bin program. @end deffn -@node ede-proj-target-elisp, ede-proj-target-elisp-autoloads, ede-proj-target-makefile-shared-object, Targets +@node ede-proj-target-elisp @subsection ede-proj-target-elisp @tgindex ede-proj-target-elisp @@ -3226,7 +3226,7 @@ There are standards in Elisp files specifying how the version string is found, such as a @code{-version} variable, or the standard header. @end deffn -@node ede-proj-target-elisp-autoloads, ede-proj-target-makefile-miscelaneous, ede-proj-target-elisp, Targets +@node ede-proj-target-elisp-autoloads @subsection ede-proj-target-elisp-autoloads @tgindex ede-proj-target-elisp-autoloads @@ -3341,7 +3341,7 @@ sources variable. @end deffn -@node ede-proj-target-makefile-miscelaneous, ede-proj-target-makefile-info, ede-proj-target-elisp-autoloads, Targets +@node ede-proj-target-makefile-miscelaneous @subsection ede-proj-target-makefile-miscelaneous @tgindex ede-proj-target-makefile-miscelaneous @@ -3397,7 +3397,7 @@ Return a list of files which @var{THIS} target depends on. @end deffn -@node ede-proj-target-makefile-info, ede-proj-target-scheme, ede-proj-target-makefile-miscelaneous, Targets +@node ede-proj-target-makefile-info @subsection ede-proj-target-makefile-info @tgindex ede-proj-target-makefile-info @@ -3483,7 +3483,7 @@ Does the usual for Makefile mode, but splits source into two variables when working in Automake mode. @end deffn -@node ede-proj-target-scheme, project-am-target, ede-proj-target-makefile-info, Targets +@node ede-proj-target-scheme @subsection ede-proj-target-scheme @tgindex ede-proj-target-scheme @@ -3527,7 +3527,7 @@ Tweak the configure file (current buffer) to accommodate @var{THIS}. @end deffn -@node project-am-target, project-am-objectcode, ede-proj-target-scheme, Targets +@node project-am-target @subsection project-am-target @tgindex project-am-target @@ -3565,7 +3565,7 @@ Run the current project in the debugger. Edit the target associated w/ this file. @end deffn -@node project-am-objectcode, project-am-program, project-am-target, Targets +@node project-am-objectcode @subsection project-am-objectcode @tgindex project-am-objectcode @@ -3610,7 +3610,7 @@ Default target to use when compiling an object code target. There are no default header files. @end deffn -@node project-am-program, project-am-header-noinst, project-am-objectcode, Targets +@node project-am-program @subsection project-am-program @tgindex project-am-program @@ -3648,7 +3648,7 @@ Additional LD args. @end table @end table -@node project-am-header-noinst, project-am-header-inst, project-am-program, Targets +@node project-am-header-noinst @subsection project-am-header-noinst @tgindex project-am-header-noinst @@ -3681,7 +3681,7 @@ No children Return the default macro to 'edit' for this object. @end deffn -@node project-am-header-inst, project-am-lisp, project-am-header-noinst, Targets +@node project-am-header-inst @subsection project-am-header-inst @tgindex project-am-header-inst @@ -3714,7 +3714,7 @@ No children Return the default macro to 'edit' for this object. @end deffn -@node project-am-lisp, project-am-texinfo, project-am-header-inst, Targets +@node project-am-lisp @subsection project-am-lisp @tgindex project-am-lisp @@ -3744,7 +3744,7 @@ No children Return the default macro to 'edit' for this object. @end deffn -@node project-am-texinfo, project-am-man, project-am-lisp, Targets +@node project-am-texinfo @subsection project-am-texinfo @tgindex project-am-texinfo @@ -3795,7 +3795,7 @@ Documentation is not for object @var{THIS}, but is provided by @var{THIS} for ot files in the project. @end deffn -@node project-am-man, , project-am-texinfo, Targets +@node project-am-man @comment node-name, next, previous, up @subsection project-am-man @tgindex project-am-man @@ -3826,7 +3826,7 @@ No children Return the default macro to 'edit' for this object type. @end deffn -@node Sourcecode, Compilers, Targets, Extending EDE +@node Sourcecode @section Sourcecode The source code type is an object designed to associated files with @@ -3837,7 +3837,7 @@ targets. @end menu -@node ede-sourcecode, , Sourcecode, Sourcecode +@node ede-sourcecode @subsection ede-sourcecode @scindex ede-sourcecode @@ -3934,7 +3934,7 @@ Return non-@code{nil} if @var{THIS} will take @var{FILENAME} as an auxiliary . Return non-@code{nil} if @var{THIS} will take @var{FILENAME} as an auxiliary . @end deffn -@node Compilers, , Sourcecode, Extending EDE +@node Compilers @section Compilers The compiler object is designed to associate source code with @@ -3950,7 +3950,7 @@ compile commands. @end menu -@node ede-compilation-program, ede-compiler, Compilers, Compilers +@node ede-compilation-program @subsection ede-compilation-program @cmindex ede-compilation-program @@ -4061,7 +4061,7 @@ Tweak the configure file (current buffer) to accommodate @var{THIS}. @end deffn -@node ede-compiler, ede-object-compiler, ede-compilation-program, Compilers +@node ede-compiler @subsection ede-compiler @cmindex ede-compiler @@ -4169,7 +4169,7 @@ Return a string based on @var{THIS} representing a make object variable. @end deffn -@node ede-object-compiler, ede-linker, ede-compiler, Compilers +@node ede-object-compiler @subsection ede-object-compiler @cmindex ede-object-compiler @@ -4212,7 +4212,7 @@ A variable dedicated to dependency generation. Insert variables needed by the compiler @var{THIS}. @end deffn -@node ede-linker, , ede-object-compiler, Compilers +@node ede-linker @subsection ede-linker @cmindex ede-linker @@ -4274,7 +4274,7 @@ For example, C code uses .o on unix, and Emacs Lisp uses .elc. @end table @end table -@node GNU Free Documentation License, , Extending EDE, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi index 308ea3f34c9..62540284312 100644 --- a/doc/misc/mh-e.texi +++ b/doc/misc/mh-e.texi @@ -78,7 +78,7 @@ Public License.'' @html @@ -197,7 +197,7 @@ History of MH-E --> @end html -@node Preface, Conventions, Top, Top +@node Preface @unnumbered Preface @cindex Emacs @@ -272,7 +272,7 @@ Bill Wohler <@i{wohler at newt.com}>@* 8 February 1995@* 24 February 2006 -@node Conventions, Getting Started, Preface, Top +@node Conventions @chapter GNU Emacs Terms and Conventions @cindex Emacs @@ -513,7 +513,7 @@ you enter something in the minibuffer, but then you change your mind, type @kbd{C-g} and you'll be back where you started. If you want to exit Emacs entirely, use @kbd{C-x C-c}. -@node Getting Started, Tour Through MH-E, Conventions, Top +@node Getting Started @chapter Getting Started @cindex MH-E, versions @@ -658,7 +658,7 @@ after these variables have been set. This hook can be used the change the value of these variables if you need to run with different values between MH and MH-E. -@node Tour Through MH-E, Using This Manual, Getting Started, Top +@node Tour Through MH-E @chapter Tour Through MH-E @cindex introduction @@ -684,7 +684,7 @@ get the big picture, and then you can read the manual as you wish. * More About MH-E:: @end menu -@node Sending Mail Tour, Reading Mail Tour, Tour Through MH-E, Tour Through MH-E +@node Sending Mail Tour @section Sending Mail @cindex MH-Letter mode @@ -750,7 +750,7 @@ more complete help with the @kbd{C-h m} (@code{describe-mode}) command.}, but at this time we'll only use @kbd{C-c C-c} to send your message. Type @kbd{C-c C-c} now. That's all there is to it! -@node Reading Mail Tour, Processing Mail Tour, Sending Mail Tour, Tour Through MH-E +@node Reading Mail Tour @section Receiving Mail @cindex @command{inc} @@ -823,7 +823,7 @@ This is a test message to get the wheels churning... If you typed a long message, you can view subsequent pages with @key{SPC} and previous pages with @key{DEL}. -@node Processing Mail Tour, Leaving MH-E, Reading Mail Tour, Tour Through MH-E +@node Processing Mail Tour @section Processing Mail @cindex processing mail @@ -949,7 +949,7 @@ available via the prefix characters, type the prefix character followed by a @kbd{?}, for example, @kbd{F ?}. More complete help is available with the @kbd{C-h m} (@code{describe-mode}) command. -@node Leaving MH-E, More About MH-E, Processing Mail Tour, Tour Through MH-E +@node Leaving MH-E @section Leaving MH-E @cindex Emacs, quitting @@ -988,7 +988,7 @@ already exists, so you can use @samp{folders -recurse -fast} in a script to copy all of your messages into a single file, or using the @samp{-file} argument, a file for each folder. -@node More About MH-E, , Leaving MH-E, Tour Through MH-E +@node More About MH-E @section More About MH-E These are the basic commands to get you going, but there are plenty @@ -1054,7 +1054,7 @@ Place messages in a file (@pxref{Files and Pipes}). Remember that you can also use MH commands when you're not running MH-E (and when you are!). -@node Using This Manual, Incorporating Mail, Tour Through MH-E, Top +@node Using This Manual @chapter Using This Manual This chapter begins the meat of the manual which goes into more detail @@ -1150,7 +1150,7 @@ your initials. (Unless, of course, your initials happen to be @emph{mh}!) * Folder Selection:: @end menu -@node Options, Ranges, Using This Manual, Using This Manual +@node Options @section Options @cindex Emacs, customizing @@ -1210,7 +1210,7 @@ function. Try entering @kbd{M-x customize-group @key{RET} mh the MH-E customization groups. Another way to view the MH-E customization group is to use @kbd{M-x mh-customize @key{RET}}. -@node Ranges, Folder Selection, Options, Using This Manual +@node Ranges @section Ranges @c Sync with mh-folder-mode docstring. @@ -1279,7 +1279,7 @@ interpret input such as @samp{200} as @samp{last:200} if the default). If you need to scan just the message 200, then use the range @samp{200:1} or @samp{200-200}. -@node Folder Selection, , Ranges, Using This Manual +@node Folder Selection @section Folder Selection @cindex completion, folders @@ -1359,7 +1359,7 @@ folder name used is suggested. This is useful if you get mail from various people for whom you have an alias, but file them all in the same project folder. -@node Incorporating Mail, Reading Mail, Using This Manual, Top +@node Incorporating Mail @chapter Incorporating Your Mail @cindex @samp{Folder} menu @@ -1535,7 +1535,7 @@ the message numbers from outside of MH-E. @end group @end smalllisp -@node Reading Mail, Folders, Incorporating Mail, Top +@node Reading Mail @chapter Reading Your Mail @cindex @samp{+inbox} @@ -2003,7 +2003,7 @@ detail in the following sections. * Miscellaneous Commands and Options:: @end menu -@node Viewing, Viewing Attachments, Reading Mail, Reading Mail +@node Viewing @section Viewing Your Mail @findex mh-header-display @@ -2276,7 +2276,7 @@ of @code{"@{show-%s@} %d"} yields a mode line of -----@{show-+inbox@} 4 (MH-Show)--Bot-------------------------------- @end smallexample -@node Viewing Attachments, HTML, Viewing, Reading Mail +@node Viewing Attachments @section Viewing Attachments @cindex attachments @@ -2516,7 +2516,7 @@ Article Buttons} and in the @cite{The Gnus Manual}. @end ifnotinfo -@node HTML, Digests, Viewing Attachments, Reading Mail +@node HTML @section HTML @cindex HTML @@ -2670,7 +2670,7 @@ buffer, including HTML buffers. (global-set-key [S-mouse-2] 'browse-url-at-mouse) @end smalllisp -@node Digests, Reading PGP, HTML, Reading Mail +@node Digests @section Digests @cindex digests @@ -2714,7 +2714,7 @@ preceded with a @samp{>} so that your reply can't create the @samp{To:} field yourself. This is described later (@pxref{Editing Drafts}). -@node Reading PGP, Printing, Digests, Reading Mail +@node Reading PGP @section Signed and Encrypted Messages @cindex GPG @@ -2848,7 +2848,7 @@ See @cite{The PGG Manual}}. @end ifhtml -@node Printing, Files and Pipes, Reading PGP, Reading Mail +@node Printing @section Printing Your Mail @cindex printing @@ -2933,7 +2933,7 @@ If you do this, do not delete the message until it is printed or else the output may be truncated. These options are not used by the commands @kbd{P p} or @kbd{P f}. -@node Files and Pipes, Navigating, Printing, Reading Mail +@node Files and Pipes @section Files and Pipes @cindex files @@ -2993,7 +2993,7 @@ through @command{uuencode} or @command{shar}. For example, you can extract the contents of the current buffer in your home directory by typing @kbd{M-x mh-store-buffer @key{RET} ~ @key{RET}}. -@node Navigating, Miscellaneous Commands and Options, Files and Pipes, Reading Mail +@node Navigating @section Navigating @cindex moving between messages @@ -3094,7 +3094,7 @@ The hook @code{mh-delete-msg-hook} is called after you mark a message for deletion. For example, a past maintainer of MH-E used this once when he kept statistics on his mail usage. -@node Miscellaneous Commands and Options, , Navigating, Reading Mail +@node Miscellaneous Commands and Options @section Miscellaneous Commands and Options This section contains a few more miscellaneous commands and options. @@ -3207,7 +3207,7 @@ displayed or @code{mh-rmail} is run, and the MH-E window configuration is shown. Otherwise, the MH-E window configuration is saved and the original configuration is displayed. -@node Folders, Sending Mail, Reading Mail, Top +@node Folders @chapter Organizing Your Mail with Folders @cindex @samp{Folder} menu @@ -3842,7 +3842,7 @@ running dired on my mail directory (@kbd{M-x dired @key{RET} ~/Mail @key{RET}}), moving my cursor to @samp{out} and using the command @kbd{R} (@code{dired-do-rename}). -@node Sending Mail, Editing Drafts, Folders, Top +@node Sending Mail @chapter Sending Mail @cindex sending mail @@ -4002,7 +4002,7 @@ more detail in the following sections. * Editing Again:: @end menu -@node Composing, Replying, Sending Mail, Sending Mail +@node Composing @section Composing @cindex @file{.emacs} @@ -4125,7 +4125,7 @@ is that you can write a function to write and send the message for you. This function is passed three arguments: the contents of the @samp{To:}, @samp{Subject:}, and @samp{Cc:} header fields. -@node Replying, Forwarding, Composing, Sending Mail +@node Replying @section Replying to Mail @cindex @command{mhl} @@ -4221,7 +4221,7 @@ buffer by turning off the option @code{mh-reply-show-message-flag}. If you wish to customize the header or other parts of the reply draft, please see @command{repl}(1) and @code{mh-format}(5). -@node Forwarding, Redistributing, Replying, Sending Mail +@node Forwarding @section Forwarding Mail @cindex @command{forw} @@ -4283,7 +4283,7 @@ and creates a subject header field of: Subject: Greg DesBrisay: Re: 49er football @end smallexample -@node Redistributing, Editing Again, Forwarding, Sending Mail +@node Redistributing @section Redistributing Your Mail @cindex @command{dist} @@ -4323,7 +4323,7 @@ a message that has been redistributed before, turn off this option. The hook @code{mh-annotate-msg-hook} is run after annotating the message and scan line (@pxref{Sending Mail}). -@node Editing Again, , Redistributing, Sending Mail +@node Editing Again @section Editing Old Drafts and Bounced Messages @cindex @file{draft} @@ -4359,7 +4359,7 @@ the message for editing by removing the @i{Mailer-Daemon} envelope and unneeded header fields. Fix whatever addressing problem you had, and send the message again with @kbd{C-c C-c}. -@node Editing Drafts, Aliases, Sending Mail, Top +@node Editing Drafts @chapter Editing a Draft @cindex @samp{Letter} menu @@ -4754,7 +4754,7 @@ detail in the following sections. * Killing Draft:: @end menu -@node Editing Message, Inserting Letter, Editing Drafts, Editing Drafts +@node Editing Message @section Editing the Message @cindex @samp{Bcc} header field @@ -4929,7 +4929,7 @@ the first period in the paragraph above, the result would be this: @end group @end smallexample -@node Inserting Letter, Inserting Messages, Editing Message, Editing Drafts +@node Inserting Letter @section Inserting Letter to Which You're Replying @cindex inserting messages @@ -5055,7 +5055,7 @@ For example, if you use the hook function @code{trivial-cite}} (which is NOT part of Emacs), set @code{mh-yank-behavior} to @samp{Body and Header}. -@node Inserting Messages, Signature, Inserting Letter, Editing Drafts +@node Inserting Messages @section Inserting Messages @cindex inserting messages @@ -5081,7 +5081,7 @@ left intact, the message is not indented, and @samp{> } is not inserted before each line. This command leaves the mark before the letter and point after it. -@node Signature, Picture, Inserting Messages, Editing Drafts +@node Signature @section Inserting Your Signature @cindex signature @@ -5136,7 +5136,7 @@ function used to insert the signature with The signature can also be inserted using Identities. @xref{Identities}. -@node Picture, Adding Attachments, Signature, Editing Drafts +@node Picture @section Inserting Your Picture @cindex @file{.face} @@ -5186,7 +5186,7 @@ defined by this option doesn't exist. @xref{Viewing}, to see how these header fields are displayed in MH-E. -@node Adding Attachments, Sending PGP, Picture, Editing Drafts +@node Adding Attachments @section Adding Attachments @cindex @command{mhbuild} @@ -5530,7 +5530,7 @@ prefix argument (as in @kbd{C-u C-c C-e}). The hook @code{mh-mh-to-mime-hook} is called after the message has been formatted by @kbd{C-c C-e}. -@node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts +@node Sending PGP @section Signing and Encrypting Messages @cindex signing messages @@ -5621,7 +5621,7 @@ all messages I encrypt are encrypted with my public key as well. If you keep a copy of all of your outgoing mail with a @samp{Fcc:} header field, this setting is vital so that you can read the mail you write! -@node Checking Recipients, Sending Message, Sending PGP, Editing Drafts +@node Checking Recipients @section Checking Recipients @cindex @file{*MH-E Recipients*} @@ -5640,7 +5640,7 @@ you can check the actual address(es) in the alias. A new buffer named @uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now?---and the whatnow Program} in the MH book.}. -@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts +@node Sending Message @section Sending a Message @cindex buffers, @file{*MH-E Mail Delivery*} @@ -5678,7 +5678,7 @@ in the MH book.} is installed under a different name, use The hook @code{mh-annotate-msg-hook} is run after annotating the message and scan line (@pxref{Sending Mail}). -@node Killing Draft, , Sending Message, Editing Drafts +@node Killing Draft @section Killing the Draft @cindex killing draft @@ -5692,7 +5692,7 @@ command @kbd{C-c C-q} (@code{mh-fully-kill-draft}) to kill the draft buffer and delete the draft message. Use the command @kbd{C-x k} (@code{kill-buffer}) if you don't want to delete the draft message. -@node Aliases, Identities, Editing Drafts, Top +@node Aliases @chapter Aliases @cindex aliases @@ -6019,7 +6019,7 @@ Syntax of Regular Expressions} in @cite{The GNU Emacs Manual}). @end ifhtml -@node Identities, Speedbar, Aliases, Top +@node Identities @chapter Identities @cindex identities @@ -6256,7 +6256,7 @@ example, @samp{:signature}), and the action @samp{'remove} or @samp{'add}. If the action is @samp{'add}, an additional argument containing the value for the field is given. -@node Speedbar, Menu Bar, Identities, Top +@node Speedbar @chapter The Speedbar @cindex folder navigation @@ -6354,7 +6354,7 @@ Selected folder face. Selected folder face when folder contains unread messages. @end vtable -@node Menu Bar, Tool Bar, Speedbar, Top +@node Menu Bar @chapter The Menu Bar @cindex @samp{Folder} menu @@ -6414,7 +6414,7 @@ manual in two ways: all of the menu items are listed alphabetically, and you can also browse all of the items under the index entry @samp{menu item}. -@node Tool Bar, Searching, Menu Bar, Top +@node Tool Bar @chapter The Tool Bar @cindex tool bar @@ -6498,7 +6498,7 @@ variable is set to anything other than @samp{Same As Default Tool Bar} and the default tool bar is in a different location, then two tool bars will be displayed: the MH-E tool bar and the default tool bar. -@node Searching, Threading, Tool Bar, Top +@node Searching @chapter Searching Through Messages @cindex @samp{Search} menu @@ -7037,7 +7037,7 @@ MH-Search buffer. Instead, you simply enter a regular expression in the minibuffer. For help in constructing regular expressions, see your man page for @command{grep}. -@node Threading, Limits, Searching, Top +@node Threading @chapter Viewing Message Threads @cindex threading @@ -7166,7 +7166,7 @@ ensure that the byte-compiled version appears first in the installed MH-E yourself, please refer to the installation directions in the file @file{README} in the distribution.}. -@node Limits, Sequences, Threading, Top +@node Limits @chapter Limiting Display @cindex limits @@ -7274,7 +7274,7 @@ command to limit the display to messages in a range (@pxref{Ranges}). Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen}) command. Give this command a prefix argument to remove all limits. -@node Sequences, Junk, Limits, Top +@node Sequences @chapter Using Sequences @cindex @samp{Sequence} menu @@ -7528,7 +7528,7 @@ command dealing with sequences is @command{mark}@footnote{See the section @uref{@value{MH-BOOK-HOME}/mmbwm.html, Make Message Bookmarks with mark} in the MH book.}. -@node Junk, Miscellaneous, Sequences, Top +@node Junk @chapter Dealing With Junk Mail @cindex Marshall Rose @@ -7966,7 +7966,7 @@ spam/unreadable/. spam/unreadable/. @end smallexample -@node Miscellaneous, Scan Line Formats, Junk, Top +@node Miscellaneous @chapter Miscellaneous Commands, Variables, and Buffers This chapter covers the following command and the various MH-E @@ -8053,7 +8053,7 @@ it is hidden because the first character in the name is a space. You'll generally not have any need for this buffer. @end table -@node Scan Line Formats, Procmail, Miscellaneous, Top +@node Scan Line Formats @appendix Scan Line Formats @cindex scan line formats @@ -8521,7 +8521,7 @@ Finally, add the following to delete and refile messages. This is just a bare minimum; it's best to adjust all of the regular expressions to ensure that MH-E and highlighting perform well. -@node Procmail, Odds and Ends, Scan Line Formats, Top +@node Procmail @appendix Reading Mailing Lists Effectively @cindex @command{procmail} @@ -8680,7 +8680,7 @@ example above, you would tell Gnus about it the first time only with @kbd{G m gnucash @key{RET} nnml @key{RET}}. In MH-E, this folder is known as @samp{+gnucash}. -@node Odds and Ends, History, Procmail, Top +@node Odds and Ends @appendix Odds and Ends This appendix covers a few topics that don't fit elsewhere. Here I @@ -8694,7 +8694,7 @@ I also point out some additional sources of information. * Getting MH-E:: @end menu -@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends +@node Bug Reports @appendixsec Bug Reports @cindex bugs @@ -8708,7 +8708,7 @@ to do that it shouldn't be a restriction for you. Please include the output of @kbd{M-x mh-version} (@pxref{Miscellaneous}) in any bug report you send unless you're 110% positive we won't ask for it. -@node Mailing Lists, MH FAQ and Support, Bug Reports, Odds and Ends +@node Mailing Lists @appendixsec MH-E Mailing Lists @cindex SourceForge @@ -8721,7 +8721,7 @@ the archives at @uref{https://sourceforge.net/p/mh-e/mailman/, SourceForge}. Do not report bugs on these lists; please submit them via SourceForge (@pxref{Bug Reports}). -@node MH FAQ and Support, Getting MH-E, Mailing Lists, Odds and Ends +@node MH FAQ and Support @appendixsec MH FAQ and Support @cindex FAQ @@ -8740,7 +8740,7 @@ You can find FAQs on MH-E by searching for @i{labels:support} on the Tickets} page on SourceForge. If you don't find the answer to your question, file a ticket and your question will become a new FAQ! -@node Getting MH-E, , MH FAQ and Support, Odds and Ends +@node Getting MH-E @appendixsec Getting MH-E @cindex MH-E, obtaining @@ -8795,7 +8795,7 @@ also contains doc and contrib packages. The former is the latest release of this manual, and the latter contains a few contributed packages you might find useful. -@node History, GFDL, Odds and Ends, Top +@node History @appendix History of MH-E @cindex Bill Wohler @@ -8826,7 +8826,7 @@ lives today. * From Bill Wohler:: @end menu -@node From Brian Reid, From Jim Larus, History, History +@node From Brian Reid @appendixsec From Brian Reid @cindex Brian Reid @@ -8858,7 +8858,7 @@ the ideas as well. Perhaps one day, MH-E will again resemble MHE Brian Reid, June 1994 -@node From Jim Larus, From Stephen Gildea, From Brian Reid, History +@node From Jim Larus @appendixsec From Jim Larus @cindex Jim Larus @@ -8904,7 +8904,7 @@ since then. Jim Larus, June 1994 -@node From Stephen Gildea, From Bill Wohler, From Jim Larus, History +@node From Stephen Gildea @appendixsec From Stephen Gildea @cindex Gildea, Stephen @@ -8946,7 +8946,7 @@ version 5 was released. Stephen Gildea, June 1994 -@node From Bill Wohler, , From Stephen Gildea, History +@node From Bill Wohler @appendixsec From Bill Wohler @cindex Wohler, Bill @@ -8993,27 +8993,27 @@ new features and several bug fixes. Bill Wohler, August 2008 -@node GFDL, GPL, History, Top +@node GFDL @appendix GNU Free Documentation License @include doclicense.texi -@node GPL, Key Index, GFDL, Top +@node GPL @appendix GNU General Public License @include gpl.texi -@node Key Index, Command Index, GPL, Top +@node Key Index @unnumbered Key (Character) Index @printindex ky -@node Command Index, Option Index, Key Index, Top +@node Command Index @unnumbered Command Index @printindex fn -@node Option Index, Concept Index, Command Index, Top +@node Option Index @unnumbered Option (Variable) Index @printindex vr -@node Concept Index, , Option Index, Top +@node Concept Index @unnumbered Concept Index @printindex cp diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index f1074d3d143..88ca4450d59 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi @@ -4609,7 +4609,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 diff --git a/doc/misc/todo-mode.texi b/doc/misc/todo-mode.texi index dbd7f3d02f7..b3ea652a7ec 100644 --- a/doc/misc/todo-mode.texi +++ b/doc/misc/todo-mode.texi @@ -122,7 +122,7 @@ Todo Display Features @end detailmenu @end menu -@node Overview, Todo Mode Entry Points, Top, Top +@node Overview @chapter Overview The Todo mode package provides facilities for making and maintaining @@ -146,7 +146,7 @@ most important differences, @ref{Legacy Todo Mode Files}. * Todo Items as Diary Entries:: @end menu -@node Levels of Organization, Todo Items as Diary Entries, , Overview +@node Levels of Organization @section Levels of Organization In Todo mode each todo list is identified with a named category, so you @@ -184,7 +184,7 @@ associating various kinds of metadata with it, e.g., the category it belongs to, its priority, whether it is to be included in the Emacs diary, date and time stamps, whether it is done or still to do. -@node Todo Items as Diary Entries, , Levels of Organization, Overview +@node Todo Items as Diary Entries @section Todo Items as Diary Entries You can have todo items show up in the Emacs Fancy Diary display by @@ -213,7 +213,7 @@ from a Todo mode file, clicking or typing @key{RET} on this item will switch to the buffer visiting that file and properly display the item's category, with point on the item. -@node Todo Mode Entry Points, Key Binding Conventions, Overview, Top +@node Todo Mode Entry Points @chapter Todo Mode Entry Points To initialize your first todo file, invoke the command @code{todo-show}. @@ -275,7 +275,7 @@ that was displayed on quitting current for subsequent Todo mode commands category in Todo mode, in which case the latter become current for Todo mode commands). -@node Key Binding Conventions, Navigation, Todo Mode Entry Points, Top +@node Key Binding Conventions @chapter Key Binding Conventions For Todo mode commands to function properly, it is essential to maintain @@ -301,7 +301,7 @@ those beginning with @kbd{A} apply to archives (a special type of Todo file; @ref{Todo Archive Mode}). Todo commands applying to items, which constitute the majority, are bound to lower case key sequences. -@node Navigation, Editing, Key Binding Conventions, Top +@node Navigation @chapter Navigation The navigation commands are for making another todo file, category, or @@ -389,7 +389,7 @@ or higher than the current one. Navigation to other types of Todo files is discussed in the relevant sections below. -@node Editing, Todo Archives, Navigation, Top +@node Editing @chapter Editing Editing in Todo mode means making structural or textual changes at one @@ -412,7 +412,7 @@ Todo mode with @kbd{q}. * Item Editing:: @end menu -@node File Editing, Category Editing, , Editing +@node File Editing @section File Editing and Todo Edit Mode There are four file-level editing commands: @@ -470,7 +470,7 @@ containing inconsistent information (see the cautionary note in displays a warning to this effect. @end table -@node Category Editing, Item Editing, File Editing, Editing +@node Category Editing @section Category Editing The following commands are available for editing specifically at the @@ -520,7 +520,7 @@ i.e., typing @kbd{C-u C g}, prompts for a file and confines merging to a category in that file. @end table -@node Item Editing, , Category Editing, Editing +@node Item Editing @section Item Editing Todo mode provides commands for adding new items as well as textually @@ -534,7 +534,7 @@ you a lot of flexibility to fine-tune these operations to your needs. * Relocating and Removing Items:: @end menu -@node Inserting New Items, Editing Item Headers and Text, , Item Editing +@node Inserting New Items @subsection Inserting New Items To add a new todo item to a category, type @kbd{i}, which is bound to @@ -761,7 +761,7 @@ calendar after you have entered the item's text, and then you can choose a date from the calendar.) -@node Editing Item Headers and Text, Relocating and Removing Items, Inserting New Items, Item Editing +@node Editing Item Headers and Text @subsection Editing Item Headers and Text To make changes to an existing item's content or header, type @kbd{e}, @@ -945,7 +945,7 @@ really want to toggle the diary-inclusion and calendar-marking status of all items in the category, you can do this by marking all the items and then invoking @kbd{e y} or @kbd{e k}, @pxref{Marked Items}). -@node Relocating and Removing Items, , Editing Item Headers and Text, Item Editing +@node Relocating and Removing Items @subsection Relocating and Removing Items In addition to inserting a new todo item and changing the text or header @@ -960,7 +960,7 @@ removes it from the todo list but does not delete it. * Done Items:: @end menu -@node Reprioritizing Items, Moving and Deleting Items, , Relocating and Removing Items +@node Reprioritizing Items @subsubsection Reprioritizing Items There are three ways to change a todo item's priority: @@ -986,7 +986,7 @@ highest priority without prompting. (Prefix arguments have no effect with @kbd{r} or @kbd{l}.) @end table -@node Moving and Deleting Items, Done Items, Reprioritizing Items, Relocating and Removing Items +@node Moving and Deleting Items @subsubsection Moving and Deleting Items You can move an item to another category, thereby recategorizing it: @@ -1032,7 +1032,7 @@ Todo command to undo a deletion. If you want to be able to use @key{SPC} for confirmation, enable the option @code{todo-y-with-space}. @end quotation -@node Done Items, , Moving and Deleting Items, Relocating and Removing Items +@node Done Items @subsubsection Done Items When the activity or thing that a todo item is about has been done, it @@ -1118,7 +1118,7 @@ item has a comment, you are asked whether to delete it from the restored item. @end table -@node Todo Archives, Marked Items, Editing, Top +@node Todo Archives @chapter Todo Archives When the done items section of a category itself starts to become @@ -1134,7 +1134,7 @@ the extension @samp{.toda} instead of @samp{.todo}. * Todo Archive Mode:: @end menu -@node Creating and Visiting Archives, Todo Archive Mode, , Todo Archives +@node Creating and Visiting Archives @section Creating and Visiting Archives Todo mode provides the following command for archiving items: @@ -1207,7 +1207,7 @@ As with todo files, you can also visit a Todo archive by invoking a standard Emacs file-visiting command; this displays the first (on the initial invocation) or current category of the archive. -@node Todo Archive Mode, , Creating and Visiting Archives, Todo Archives +@node Todo Archive Mode @section Todo Archive Mode When you visit a Todo archive, the buffer is in Todo Archive mode. It @@ -1264,7 +1264,7 @@ The command @kbd{F k} (@pxref{File Editing}) is also available in Todo Archive mode. It deletes the current archive file and prompts you whether to delete the corresponding todo file. -@node Marked Items, Todo Categories Mode, Todo Archives, Top +@node Marked Items @chapter Marked Items For many item editing commands it can make sense and be convenient to @@ -1329,7 +1329,7 @@ todo or marked done items, so if both types of items are marked, invoking these commands has no effect and informs you of your erroneous attempt. -@node Todo Categories Mode, Searching for Items, Marked Items, Top +@node Todo Categories Mode @chapter Todo Categories Mode It can be helpful to have a compact overview of the categories in a @@ -1367,7 +1367,7 @@ to visit another todo file). To do this customize the option * Reordering Categories:: @end menu -@node Table of Item Counts, Reordering Categories, , Todo Categories Mode +@node Table of Item Counts @section Table of Item Counts Above each column of the table is a labeled button you can press by @@ -1428,7 +1428,7 @@ Typing @kbd{q} exits Todo Categories mode, killing the buffer and returning to the current category in the Todo mode or Todo Archive mode buffer from which you had invoked @kbd{F c}. -@node Reordering Categories, , Table of Item Counts, Todo Categories Mode +@node Reordering Categories @section Reordering Categories Todo Categories mode provide commands with which you can change the @@ -1479,7 +1479,7 @@ have to renumber them again. This is one reason why you should exercise caution when using @kbd{F e}. @end quotation -@node Searching for Items, Todo Filtered Items Mode, Todo Categories Mode, Top +@node Searching for Items @chapter Searching for Items It can be useful to be able to locate and examine all todo items that @@ -1506,7 +1506,7 @@ search and remove the highlighting later. These commands are also available in Todo Archive mode. -@node Todo Filtered Items Mode, Todo Display Features, Searching for Items, Top +@node Todo Filtered Items Mode @chapter Todo Filtered Items Mode A more powerful alternative to sequential searching is item filtering, @@ -1520,7 +1520,7 @@ category in a distinct mode, Todo Filtered Items mode. * Files of Filtered Items:: @end menu -@node Filtering Items, Todo Filtered Items Mode Commands, , Todo Filtered Items Mode +@node Filtering Items @section Filtering Items Todo mode provides three ways to filter items: a general filter for @@ -1593,7 +1593,7 @@ this invocation, overriding both @code{todo-top-priorities-overrides} and @code{todo-top-priorities}. @end itemize -@node Todo Filtered Items Mode Commands, Files of Filtered Items, Filtering Items, Todo Filtered Items Mode +@node Todo Filtered Items Mode Commands @section Todo Filtered Items Mode Commands The output of the item filtering commands looks similar to a regular @@ -1650,7 +1650,7 @@ change the relative priorities of items from the same real category, since that would make the filtered list inconsistent with the source todo list. -@node Files of Filtered Items, , Todo Filtered Items Mode Commands, Todo Filtered Items Mode +@node Files of Filtered Items @section Files of Filtered Items Typing @kbd{s} in Todo Filtered Items mode saves the buffer of filtered @@ -1701,7 +1701,7 @@ displaying its first category, as usual. The command @kbd{F k} (@pxref{File Editing}) is also available in Todo Filtered Items mode. It deletes the current filtered items file. -@node Todo Display Features, Printing Todo Buffers, Todo Filtered Items Mode, Top +@node Todo Display Features @chapter Todo Display Features You can change the appearance of Todo mode buffers in a variety of ways. @@ -1712,7 +1712,7 @@ You can change the appearance of Todo mode buffers in a variety of ways. * Other Display Commands and Options:: @end menu -@node Faces, Item Prefix, , Todo Display Features +@node Faces @section Faces Each of the Todo modes uses faces to distinguish various aspects of @@ -1737,7 +1737,7 @@ The @code{todo-faces} customization group contains a complete list of Todo mode faces and brief descriptions of their use. -@node Item Prefix, Other Display Commands and Options, Faces, Todo Display Features +@node Item Prefix @section Item Prefix In the default display of (real or virtual) categories in Todo mode, @@ -1776,7 +1776,7 @@ displayed in a face (@code{todo-top-priority}) different from the face of the prefix of non-top-priority items, so you see at a glance how many items in the category are top priorities. -@node Other Display Commands and Options, , Item Prefix, Todo Display Features +@node Other Display Commands and Options @section Other Display Commands and Options There are two additional toggle commands that affect display in the @@ -1842,7 +1842,7 @@ Categories mode and Todo Filtered Items mode, beyond those mentioned above in the sections on these modes; see the customization groups @code{todo-categories} and @code{todo-filtered} for details. -@node Printing Todo Buffers, Legacy Todo Mode Files, Todo Display Features, Top +@node Printing Todo Buffers @chapter Printing Todo Buffers If you print a Todo buffer using one of the standard Emacs printing @@ -1865,7 +1865,7 @@ By default, Todo uses @code{ps-print-buffer-with-faces} to make the printable version; you can change this by setting the option @code{todo-print-function}. -@node Legacy Todo Mode Files, GNU Free Documentation License, Printing Todo Buffers, Top +@node Legacy Todo Mode Files @chapter Legacy Todo Mode Files Users of the original version of Todo mode will recognize from the @@ -1912,7 +1912,7 @@ it often). (A delicate part of the conversion concerns the customizable format of item date/time headers in the old-style; see the documentation string of @code{todo-legacy-date-time-regexp} for details.) -@node GNU Free Documentation License, , Legacy Todo Mode Files, Top +@node GNU Free Documentation License @appendix GNU Free Documentation License @include doclicense.texi -- cgit v1.2.3