mirror of
https://github.com/masscollaborationlabs/emacs.git
synced 2025-07-08 05:09:37 +00:00
More improvements of the Emacs manual
* doc/emacs/rmail.texi (Rmail Reply, Rmail Sorting): Improve wording. Suggested by Daniel Chakraborty <danielmchakraborty@gmail.com>. * doc/emacs/glossary.texi (Glossary): Add cross-references. Improve and clarify wording. Suggested by Gijs Hillenius <gijs@hillenius.net> in emacs-manual-bugs@gnu.org. * doc/emacs/text.texi (Org Authoring): Add more supported formats to the list. (TeX Print): Improve wording. Slightly rearrange stuff. (TeX Misc): Mention doctex-mode-hook. (Two-Column): Minor rearrangement of text. Suggested by Michael Albinus <michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org. * doc/emacs/misc.texi (Saving Emacs Sessions): * doc/emacs/programs.texi (Program Modes): Remove redundant text and index entries.
This commit is contained in:
parent
6719f05ff7
commit
d691e30cb0
5 changed files with 42 additions and 43 deletions
|
@ -103,13 +103,14 @@ supports both of these forms, as well as any mixture of them---this
|
||||||
is ``bidirectional text''. @xref{Bidirectional Editing}.
|
is ``bidirectional text''. @xref{Bidirectional Editing}.
|
||||||
|
|
||||||
@item Bind
|
@item Bind
|
||||||
|
@anchor{Glossary---Bind}
|
||||||
To bind a key sequence means to give it a binding (q.v.).
|
To bind a key sequence means to give it a binding (q.v.).
|
||||||
@xref{Rebinding}.
|
@xref{Rebinding}.
|
||||||
|
|
||||||
@anchor{Glossary---Binding}
|
@anchor{Glossary---Binding}
|
||||||
@item Binding
|
@item Binding
|
||||||
A key sequence gets its meaning in Emacs by having a binding, which is a
|
A key sequence gets its meaning in Emacs by having a binding, which is a
|
||||||
command (q.v.), a Lisp function that is run when you type that
|
command (q.v.)---a Lisp function that is run when you type that
|
||||||
sequence. @xref{Commands,Binding}. Customization often involves
|
sequence. @xref{Commands,Binding}. Customization often involves
|
||||||
rebinding a character to a different command function. The bindings of
|
rebinding a character to a different command function. The bindings of
|
||||||
all key sequences are recorded in the keymaps (q.v.). @xref{Keymaps}.
|
all key sequences are recorded in the keymaps (q.v.). @xref{Keymaps}.
|
||||||
|
@ -141,8 +142,8 @@ are visiting (q.v.@:) some file. @xref{Buffers}.
|
||||||
|
|
||||||
@item Buffer Selection History
|
@item Buffer Selection History
|
||||||
Emacs keeps a buffer selection history that records how recently each
|
Emacs keeps a buffer selection history that records how recently each
|
||||||
Emacs buffer has been selected. This is used for choosing a buffer to
|
Emacs buffer has been selected. This is used for choosing which
|
||||||
select. @xref{Buffers}.
|
buffer to select. @xref{Buffers}.
|
||||||
|
|
||||||
@item Bug
|
@item Bug
|
||||||
A bug is an incorrect or unreasonable behavior of a program, or
|
A bug is an incorrect or unreasonable behavior of a program, or
|
||||||
|
@ -220,9 +221,9 @@ the clipboard is used @emph{instead} of the primary selection.
|
||||||
@xref{Clipboard}.
|
@xref{Clipboard}.
|
||||||
|
|
||||||
@item Coding System
|
@item Coding System
|
||||||
A coding system is an encoding for representing text characters in a
|
A coding system is a way to encode text characters in a file or in a
|
||||||
file or in a stream of information. Emacs has the ability to convert
|
stream of information. Emacs has the ability to convert text to or
|
||||||
text to or from a variety of coding systems when reading or writing it.
|
from a variety of coding systems when reading or writing it.
|
||||||
@xref{Coding Systems}.
|
@xref{Coding Systems}.
|
||||||
|
|
||||||
@item Command
|
@item Command
|
||||||
|
@ -263,12 +264,12 @@ executes faster.
|
||||||
|
|
||||||
@item Complete Key
|
@item Complete Key
|
||||||
A complete key is a key sequence that fully specifies one action to be
|
A complete key is a key sequence that fully specifies one action to be
|
||||||
performed by Emacs. For example, @kbd{X} and @kbd{C-f} and @kbd{C-x m}
|
performed by Emacs. For example, @kbd{X} and @kbd{C-f} and @kbd{C-x
|
||||||
are complete keys. Complete keys derive their meanings from being bound
|
m} are complete keys. Complete keys derive their meanings from being
|
||||||
(q.v.@:) to commands (q.v.). Thus, @kbd{X} is conventionally bound to
|
bound (@pxref{Glossary---Bind}) to commands (q.v.). Thus, @kbd{X} is
|
||||||
a command to insert @samp{X} in the buffer; @kbd{C-x m} is
|
conventionally bound to a command to insert @samp{X} in the buffer;
|
||||||
conventionally bound to a command to begin composing a mail message.
|
@kbd{C-x m} is conventionally bound to a command to begin composing a
|
||||||
@xref{Keys}.
|
mail message. @xref{Keys}.
|
||||||
|
|
||||||
@item Completion
|
@item Completion
|
||||||
Completion is what Emacs does when it automatically expands an
|
Completion is what Emacs does when it automatically expands an
|
||||||
|
@ -281,11 +282,11 @@ file names. Completion usually occurs when @key{TAB}, @key{SPC} or
|
||||||
@anchor{Glossary---Continuation Line}
|
@anchor{Glossary---Continuation Line}
|
||||||
@item Continuation Line
|
@item Continuation Line
|
||||||
When a line of text is longer than the width of the window, it
|
When a line of text is longer than the width of the window, it
|
||||||
normally (but see @ref{Glossary---Truncation}) takes up more than one
|
normally takes up more than one screen line when displayed (but see
|
||||||
screen line when displayed. We say that the text line is continued, and all
|
@ref{Glossary---Truncation}). We say that the text line is continued,
|
||||||
screen lines used for it after the first are called continuation
|
and all screen lines used for it after the first are called
|
||||||
lines. @xref{Continuation Lines}. A related Emacs feature is
|
continuation lines. @xref{Continuation Lines}. A related Emacs
|
||||||
filling (q.v.).
|
feature is filling (q.v.).
|
||||||
|
|
||||||
@item Control Character
|
@item Control Character
|
||||||
A control character is a character that you type by holding down the
|
A control character is a character that you type by holding down the
|
||||||
|
@ -418,7 +419,7 @@ Variables}.
|
||||||
On GNU and other Unix-like systems, directory names are strings that
|
On GNU and other Unix-like systems, directory names are strings that
|
||||||
end in @samp{/}. For example, @file{/no-such-dir/} is a directory
|
end in @samp{/}. For example, @file{/no-such-dir/} is a directory
|
||||||
name whereas @file{/tmp} is not, even though @file{/tmp} names a file
|
name whereas @file{/tmp} is not, even though @file{/tmp} names a file
|
||||||
that happens to be a directory. On MS-DOS the relationship is more
|
that happens to be a directory. On MS-Windows the relationship is more
|
||||||
complicated. @xref{Directory Names,,, elisp, the Emacs Lisp Reference
|
complicated. @xref{Directory Names,,, elisp, the Emacs Lisp Reference
|
||||||
Manual}.
|
Manual}.
|
||||||
|
|
||||||
|
|
|
@ -2463,12 +2463,6 @@ sessions, or add this line in your init file (@pxref{Init File}):
|
||||||
(desktop-save-mode 1)
|
(desktop-save-mode 1)
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@vindex desktop-auto-save-timeout
|
|
||||||
@noindent
|
|
||||||
When @code{desktop-save-mode} is active and the desktop file exists,
|
|
||||||
Emacs auto-saves it every @code{desktop-auto-save-timeout}
|
|
||||||
seconds, if that is non-@code{nil} and non-zero.
|
|
||||||
|
|
||||||
@findex desktop-change-dir
|
@findex desktop-change-dir
|
||||||
@findex desktop-revert
|
@findex desktop-revert
|
||||||
@vindex desktop-path
|
@vindex desktop-path
|
||||||
|
|
|
@ -77,7 +77,6 @@ mode for the C programming language is @code{c-mode}.
|
||||||
@cindex VHDL mode
|
@cindex VHDL mode
|
||||||
@cindex M4 mode
|
@cindex M4 mode
|
||||||
@cindex Shell-script mode
|
@cindex Shell-script mode
|
||||||
@cindex Scheme mode
|
|
||||||
@cindex OPascal mode
|
@cindex OPascal mode
|
||||||
@cindex PostScript mode
|
@cindex PostScript mode
|
||||||
@cindex Conf mode
|
@cindex Conf mode
|
||||||
|
|
|
@ -802,7 +802,7 @@ its contents.
|
||||||
@vindex rmail-enable-mime-composing
|
@vindex rmail-enable-mime-composing
|
||||||
@findex unforward-rmail-message
|
@findex unforward-rmail-message
|
||||||
Rmail offers two formats for forwarded messages. The default is to
|
Rmail offers two formats for forwarded messages. The default is to
|
||||||
use MIME (@pxref{Rmail Display}) format. This includes the original
|
use the MIME format (@pxref{Rmail Display}). This includes the original
|
||||||
message as a separate part. You can use a simpler format if you
|
message as a separate part. You can use a simpler format if you
|
||||||
prefer, by setting the variable @code{rmail-enable-mime-composing} to
|
prefer, by setting the variable @code{rmail-enable-mime-composing} to
|
||||||
@code{nil}. In this case, Rmail just includes the original message
|
@code{nil}. In this case, Rmail just includes the original message
|
||||||
|
@ -1092,7 +1092,7 @@ Sort messages of current Rmail buffer by author's name.
|
||||||
@findex rmail-sort-by-recipient
|
@findex rmail-sort-by-recipient
|
||||||
@item C-c C-s C-r
|
@item C-c C-s C-r
|
||||||
@itemx M-x rmail-sort-by-recipient
|
@itemx M-x rmail-sort-by-recipient
|
||||||
Sort messages of current Rmail buffer by recipient's names.
|
Sort messages of current Rmail buffer by recipient's name.
|
||||||
|
|
||||||
@findex rmail-sort-by-correspondent
|
@findex rmail-sort-by-correspondent
|
||||||
@item C-c C-s C-c
|
@item C-c C-s C-c
|
||||||
|
|
|
@ -1451,8 +1451,9 @@ etc.
|
||||||
export and publication. To export the current buffer, type @kbd{C-c
|
export and publication. To export the current buffer, type @kbd{C-c
|
||||||
C-e} (@code{org-export}) anywhere in an Org buffer. This command
|
C-e} (@code{org-export}) anywhere in an Org buffer. This command
|
||||||
prompts for an export format; currently supported formats include
|
prompts for an export format; currently supported formats include
|
||||||
HTML, @LaTeX{}, OpenDocument (@file{.odt}), and PDF@. Some formats,
|
HTML, @LaTeX{}, Texinfo, OpenDocument (@file{.odt}), iCalendar,
|
||||||
such as PDF, require certain system tools to be installed.
|
Markdown, man-page, and PDF@. Some formats, such as PDF, require
|
||||||
|
certain system tools to be installed.
|
||||||
|
|
||||||
@vindex org-publish-project-alist
|
@vindex org-publish-project-alist
|
||||||
To export several files at once to a specific directory, either
|
To export several files at once to a specific directory, either
|
||||||
|
@ -1511,14 +1512,14 @@ with @LaTeX{}.}.
|
||||||
Emacs provides a @TeX{} major mode for each of these variants: Plain
|
Emacs provides a @TeX{} major mode for each of these variants: Plain
|
||||||
@TeX{} mode, @LaTeX{} mode, Doc@TeX{} mode, and Sli@TeX{} mode. Emacs
|
@TeX{} mode, @LaTeX{} mode, Doc@TeX{} mode, and Sli@TeX{} mode. Emacs
|
||||||
selects the appropriate mode by looking at the contents of the buffer.
|
selects the appropriate mode by looking at the contents of the buffer.
|
||||||
(This is done by the @code{tex-mode} command, which is normally called
|
(This is done by invoking the @code{tex-mode} command, which is
|
||||||
automatically when you visit a @TeX{}-like file. @xref{Choosing
|
normally called automatically when you visit a @TeX{}-like file.
|
||||||
Modes}.) If the contents are insufficient to determine this, Emacs
|
@xref{Choosing Modes}.) If the contents are insufficient to determine
|
||||||
chooses the mode specified by the variable @code{tex-default-mode};
|
this, Emacs chooses the mode specified by the variable
|
||||||
its default value is @code{latex-mode}. If Emacs does not guess
|
@code{tex-default-mode}; its default value is @code{latex-mode}. If
|
||||||
right, you can select the correct variant of @TeX{} mode using the
|
Emacs does not guess right, you can select the correct variant of
|
||||||
command @kbd{M-x plain-tex-mode}, @kbd{M-x latex-mode}, @kbd{M-x
|
@TeX{} mode using the command @kbd{M-x plain-tex-mode}, @kbd{M-x
|
||||||
slitex-mode}, or @kbd{doctex-mode}.
|
latex-mode}, @kbd{M-x slitex-mode}, or @kbd{doctex-mode}.
|
||||||
|
|
||||||
The following sections document the features of @TeX{} mode and its
|
The following sections document the features of @TeX{} mode and its
|
||||||
variants. There are several other @TeX{}-related Emacs packages,
|
variants. There are several other @TeX{}-related Emacs packages,
|
||||||
|
@ -1691,14 +1692,16 @@ chapter of a larger document).
|
||||||
@table @kbd
|
@table @kbd
|
||||||
@item C-c C-b
|
@item C-c C-b
|
||||||
Invoke @TeX{} on the entire current buffer (@code{tex-buffer}).
|
Invoke @TeX{} on the entire current buffer (@code{tex-buffer}).
|
||||||
|
|
||||||
@item C-c C-r
|
@item C-c C-r
|
||||||
Invoke @TeX{} on the current region, together with the buffer's header
|
Invoke @TeX{} on the current region, together with the buffer's header
|
||||||
(@code{tex-region}).
|
(@code{tex-region}).
|
||||||
|
|
||||||
@item C-c C-f
|
@item C-c C-f
|
||||||
Invoke @TeX{} on the current file (@code{tex-file}).
|
Invoke @TeX{} on the current file (@code{tex-file}).
|
||||||
|
|
||||||
@item C-c C-v
|
@item C-c C-v
|
||||||
Preview the output from the last @kbd{C-c C-r}, @kbd{C-c C-b}, or @kbd{C-c
|
Preview the output from the last @kbd{C-c C-b}, @kbd{C-c C-r}, or @kbd{C-c
|
||||||
C-f} command (@code{tex-view}).
|
C-f} command (@code{tex-view}).
|
||||||
|
|
||||||
@item C-c C-p
|
@item C-c C-p
|
||||||
|
@ -1733,7 +1736,7 @@ C-p} (@code{tex-print}) to print a hardcopy of the output file.
|
||||||
@cindex @env{TEXINPUTS} environment variable
|
@cindex @env{TEXINPUTS} environment variable
|
||||||
@vindex tex-directory
|
@vindex tex-directory
|
||||||
By default, @kbd{C-c C-b} runs @TeX{} in the current directory. The
|
By default, @kbd{C-c C-b} runs @TeX{} in the current directory. The
|
||||||
output of @TeX{} also goes in this directory. To run @TeX{} in a
|
output of @TeX{} is also created in this directory. To run @TeX{} in a
|
||||||
different directory, change the variable @code{tex-directory} to
|
different directory, change the variable @code{tex-directory} to
|
||||||
the desired directory. If your environment variable @env{TEXINPUTS}
|
the desired directory. If your environment variable @env{TEXINPUTS}
|
||||||
contains relative names, or if your files contain
|
contains relative names, or if your files contain
|
||||||
|
@ -1879,14 +1882,16 @@ keys (@pxref{Completion}).
|
||||||
|
|
||||||
@vindex tex-shell-hook
|
@vindex tex-shell-hook
|
||||||
@vindex tex-mode-hook
|
@vindex tex-mode-hook
|
||||||
|
@vindex doctex-mode-hook
|
||||||
@vindex latex-mode-hook
|
@vindex latex-mode-hook
|
||||||
@vindex slitex-mode-hook
|
@vindex slitex-mode-hook
|
||||||
@vindex plain-tex-mode-hook
|
@vindex plain-tex-mode-hook
|
||||||
Entering any variant of @TeX{} mode runs the hooks
|
Entering any variant of @TeX{} mode runs the hooks
|
||||||
@code{text-mode-hook} and @code{tex-mode-hook}. Then it runs either
|
@code{text-mode-hook} and @code{tex-mode-hook}. Then it runs either
|
||||||
@code{plain-tex-mode-hook}, @code{latex-mode-hook}, or
|
@code{plain-tex-mode-hook}, @code{doctex-mode-hook},
|
||||||
@code{slitex-mode-hook}, whichever is appropriate. Starting the
|
@code{latex-mode-hook}, or @code{slitex-mode-hook}, whichever is
|
||||||
@TeX{} shell runs the hook @code{tex-shell-hook}. @xref{Hooks}.
|
appropriate. Starting the @TeX{} shell runs the hook
|
||||||
|
@code{tex-shell-hook}. @xref{Hooks}.
|
||||||
|
|
||||||
@findex iso-iso2tex
|
@findex iso-iso2tex
|
||||||
@findex iso-tex2iso
|
@findex iso-tex2iso
|
||||||
|
@ -2903,7 +2908,7 @@ right-hand buffer.)
|
||||||
@kindex F2 RET
|
@kindex F2 RET
|
||||||
@kindex C-x 6 RET
|
@kindex C-x 6 RET
|
||||||
@findex 2C-newline
|
@findex 2C-newline
|
||||||
The command @kbd{C-x 6 @key{RET}} or @kbd{@key{F2} @key{RET}}
|
The command @kbd{@key{F2} @key{RET}} or @kbd{C-x 6 @key{RET}}
|
||||||
(@code{2C-newline}) inserts a newline in each of the two buffers at
|
(@code{2C-newline}) inserts a newline in each of the two buffers at
|
||||||
corresponding positions. This is the easiest way to add a new line to
|
corresponding positions. This is the easiest way to add a new line to
|
||||||
the two-column text while editing it in split buffers.
|
the two-column text while editing it in split buffers.
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue