@contents
-@node Top, EDE Project Concepts, (dir), (dir)
+@node Top
@top EDE
@comment node-name, next, previous, up
* 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
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
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
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
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
* 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
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}
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
(@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
(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}
* 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
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
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
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
* 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
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
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
* 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
@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
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
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
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
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
* 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{}.
@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}
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.
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
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
@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
@defindex sc
@defindex cm
-@node Project, Targets, Compiler and Linker objects, Extending EDE
+@node Project
@section Project
@menu
* 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
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
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
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
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
@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
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
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
Commit change to local variables in @var{PROJ}.
@end deffn
-@node Targets, Sourcecode, Project, Extending EDE
+@node Targets
@section Targets
@menu
@end menu
-@node ede-target, ede-proj-target, Targets, Targets
+@node ede-target
@subsection ede-target
@tgindex ede-target
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
@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
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
@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
@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
@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
@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
@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
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
@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
@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
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
@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
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
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
@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
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
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
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
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
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
@end menu
-@node ede-sourcecode, , Sourcecode, Sourcecode
+@node ede-sourcecode
@subsection ede-sourcecode
@scindex ede-sourcecode
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
@end menu
-@node ede-compilation-program, ede-compiler, Compilers, Compilers
+@node ede-compilation-program
@subsection ede-compilation-program
@cmindex ede-compilation-program
@end deffn
-@node ede-compiler, ede-object-compiler, ede-compilation-program, Compilers
+@node ede-compiler
@subsection ede-compiler
@cmindex ede-compiler
@end deffn
-@node ede-object-compiler, ede-linker, ede-compiler, Compilers
+@node ede-object-compiler
@subsection ede-object-compiler
@cmindex ede-object-compiler
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
@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
@html
<!--
@end html
-@node Top, Preface, (dir), (dir)
+@node Top
@top The MH-E Manual
@html
-->
-->
@end html
-@node Preface, Conventions, Top, Top
+@node Preface
@unnumbered Preface
@cindex Emacs
8 February 1995@*
24 February 2006
-@node Conventions, Getting Started, Preface, Top
+@node Conventions
@chapter GNU Emacs Terms and Conventions
@cindex Emacs
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
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
* 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
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}
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
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
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
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
* Folder Selection::
@end menu
-@node Options, Ranges, Using This Manual, Using This Manual
+@node Options
@section Options
@cindex Emacs, customizing
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.
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
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
@end group
@end smalllisp
-@node Reading Mail, Folders, Incorporating Mail, Top
+@node Reading Mail
@chapter Reading Your Mail
@cindex @samp{+inbox}
* Miscellaneous Commands and Options::
@end menu
-@node Viewing, Viewing Attachments, Reading Mail, Reading Mail
+@node Viewing
@section Viewing Your Mail
@findex mh-header-display
-----@{show-+inbox@} 4 (MH-Show)--Bot--------------------------------
@end smallexample
-@node Viewing Attachments, HTML, Viewing, Reading Mail
+@node Viewing Attachments
@section Viewing Attachments
@cindex attachments
in the @cite{The Gnus Manual}.
@end ifnotinfo
-@node HTML, Digests, Viewing Attachments, Reading Mail
+@node HTML
@section HTML
@cindex HTML
(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
@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
@cite{The PGG Manual}}.
@end ifhtml
-@node Printing, Files and Pipes, Reading PGP, Reading Mail
+@node Printing
@section Printing Your Mail
@cindex printing
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
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
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.
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
@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
* Editing Again::
@end menu
-@node Composing, Replying, Sending Mail, Sending Mail
+@node Composing
@section Composing
@cindex @file{.emacs}
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}
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}
Subject: Greg DesBrisay: Re: 49er football
@end smallexample
-@node Redistributing, Editing Again, Forwarding, Sending Mail
+@node Redistributing
@section Redistributing Your Mail
@cindex @command{dist}
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}
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
* 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
@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
@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
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
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}
@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}
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
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*}
@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*}
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
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
@cite{The GNU Emacs Manual}).
@end ifhtml
-@node Identities, Speedbar, Aliases, Top
+@node Identities
@chapter Identities
@cindex identities
@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
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
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
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
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
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
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
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
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
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
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}
@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
* Getting MH-E::
@end menu
-@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
+@node Bug Reports
@appendixsec Bug Reports
@cindex bugs
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
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
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
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
* 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
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
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
Stephen Gildea, June 1994
-@node From Bill Wohler, , From Stephen Gildea, History
+@node From Bill Wohler
@appendixsec From Bill Wohler
@cindex Wohler, Bill
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
@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
@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
* 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
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
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}.
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
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
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
* 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:
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
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
* 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
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},
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
* 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:
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:
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
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
* 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:
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
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
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
* 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
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
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
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,
* 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
@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
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
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.
* 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
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,
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
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
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
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
projects / emacs.git / commitdiff