branch: externals/auctex
commit ba70baec6ca95c609e794624ca589c1de9ea02d8
Author: Ikumi Keita <ik...@ikumi.que.jp>
Commit: Ikumi Keita <ik...@ikumi.que.jp>
Fix doc strings regarding to section commands
* context.el (ConTeXt-numbered-section-hook):
(ConTeXt-unnumbered-section-hook):
Add mention about `ConTeXt-reference'.
Fix explanation of `ConTeXt-section-ref'.
Fix order of Lisp code example.
Add quote for Lisp symbols.
* latex.el (LaTeX-section-hook): Reindent.
Add quote for Lisp symbols.
---
context.el | 28 ++++++++++++++++------------
latex.el | 25 +++++++++++++++----------
2 files changed, 31 insertions(+), 22 deletions(-)
diff --git a/context.el b/context.el
index 1eeda6a9ea..d14b3646c7 100644
--- a/context.el
+++ b/context.el
@@ -395,32 +395,34 @@ The following variables are set before the hooks are run
`ConTeXt-level'.
`ConTeXt-title' - The title of the section, default to an empty
string.
+`ConTeXt-reference' - Comma separated list of reference.
`ConTeXt-done-mark' - Position of point afterwards, default nil
(meaning end).
The following standard hooks exist -
-ConTeXt-numbered-section-heading: Query the user about the name
+`ConTeXt-numbered-section-heading': Query the user about the name
of the sectioning command. Modifies `ConTeXt-level' and
`ConTeXt-name'.
-ConTeXt-section-title: Query the user about the title of the
+`ConTeXt-section-title': Query the user about the title of the
section. Modifies `ConTeXt-title'.
-ConTeXt-section-section: Insert ConTeXt section command according
+`ConTeXt-section-section': Insert ConTeXt section command according
to `ConTeXt-name', `ConTeXt-title', and `ConTeXt-reference'. If
`ConTeXt-title' is an empty string, `ConTeXt-done-mark' will be
placed at the point they should be inserted.
-ConTeXt-section-ref: Insert a reference for this section command.
+`ConTeXt-section-ref': Query the user about a reference for this
+section command. Modifies `ConTeXt-reference'.
To get a full featured `ConTeXt-section' command, insert
(setq ConTeXt-numbered-section-hook
\\='(ConTeXt-numbered-section-heading
ConTeXt-section-title
- ConTeXt-section-section
- ConTeXt-section-ref))
+ ConTeXt-section-ref
+ ConTeXt-section-section))
in your init file such as .emacs.d/init.el or .emacs."
:group 'ConTeXt-macro
@@ -447,32 +449,34 @@ The following variables are set before the hooks are run
`ConTeXt-level'.
`ConTeXt-title' - The title of the section, default to an empty
string.
+`ConTeXt-reference' - Comma separated list of reference.
`ConTeXt-done-mark' - Position of point afterwards, default nil
(meaning end).
The following standard hooks exist -
-ConTeXt-unnumbered-section-heading: Query the user about the name
+`ConTeXt-unnumbered-section-heading': Query the user about the name
of the sectioning command. Modifies `ConTeXt-level' and
`ConTeXt-name'.
-ConTeXt-section-title: Query the user about the title of the
+`ConTeXt-section-title': Query the user about the title of the
section. Modifies `ConTeXt-title'.
-ConTeXt-section-section: Insert ConTeXt section command according
+`ConTeXt-section-section': Insert ConTeXt section command according
to `ConTeXt-name', `ConTeXt-title', and `ConTeXt-reference'. If
`ConTeXt-title' is an empty string, `ConTeXt-done-mark' will be
placed at the point they should be inserted.
-ConTeXt-section-ref: Insert a reference for this section command.
+`ConTeXt-section-ref': Query the user about a reference for this
+section command. Modifies `ConTeXt-reference'.
To get a full featured `ConTeXt-section' command, insert
(setq ConTeXt-unnumbered-section-hook
\\='(ConTeXt-unnumbered-section-heading
ConTeXt-section-title
- ConTeXt-section-section
- ConTeXt-section-ref))
+ ConTeXt-section-ref
+ ConTeXt-section-section))
in your init file such as .emacs.d/init.el or .emacs."
:group 'ConTeXt-macro
diff --git a/latex.el b/latex.el
index ac900673dd..6303c3371f 100644
--- a/latex.el
+++ b/latex.el
@@ -386,30 +386,35 @@ If so, return the second element, otherwise return nil."
The following variables are set before the hooks are run
-LaTeX-level - numeric section level, see the documentation of `LaTeX-section'.
-LaTeX-name - name of the sectioning command, derived from `LaTeX-level'.
-LaTeX-title - The title of the section, default to an empty string.
-LaTeX-toc - Entry for the table of contents list, default nil.
-LaTeX-done-mark - Position of point afterwards, default nil (meaning end).
+`LaTeX-level' - numeric section level, see the documentation of
+ `LaTeX-section'.
+`LaTeX-name' - name of the sectioning command, derived from
+ `LaTeX-level'.
+`LaTeX-title' - The title of the section, default to an empty
+ string.
+`LaTeX-toc' - Entry for the table of contents list, default
+ nil.
+`LaTeX-done-mark' - Position of point afterwards, default nil
+ (meaning end).
The following standard hooks exist -
-LaTeX-section-heading: Query the user about the name of the
+`LaTeX-section-heading': Query the user about the name of the
sectioning command. Modifies `LaTeX-level' and `LaTeX-name'.
-LaTeX-section-title: Query the user about the title of the
+`LaTeX-section-title': Query the user about the title of the
section. Modifies `LaTeX-title'.
-LaTeX-section-toc: Query the user for the toc entry. Modifies
+`LaTeX-section-toc': Query the user for the toc entry. Modifies
`LaTeX-toc'.
-LaTeX-section-section: Insert LaTeX section command according to
+`LaTeX-section-section': Insert LaTeX section command according to
`LaTeX-name', `LaTeX-title', and `LaTeX-toc'. If `LaTeX-toc' is
nil, no toc entry is inserted. If `LaTeX-toc' or `LaTeX-title'
are empty strings, `LaTeX-done-mark' will be placed at the point
they should be inserted.
-LaTeX-section-label: Insert a label after the section command.
+`LaTeX-section-label': Insert a label after the section command.
Controled by the variable `LaTeX-section-label'.
To get a full featured `LaTeX-section' command, insert
