master ba70baec: Fix doc strings regarding to section commands

[Ikumi Keita]

branch: master
commit ba70baec6ca95c609e794624ca589c1de9ea02d8
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@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 1eeda6a9..d14b3646 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 ac900673..6303c337 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