Variable: LaTeX-section-hook

LaTeX-section-hook is a customizable variable defined in latex.el.

Value

(LaTeX-section-heading
 LaTeX-section-title
 LaTeX-section-section
 LaTeX-section-label(var)/LaTeX-section-label(fun))

Documentation

List of hooks to run when a new section is inserted.

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).

The following standard hooks exist -

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 section. Modifies LaTeX-title.

LaTeX-section-toc: Query the user for the toc entry. Modifies LaTeX-toc.

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(var)/LaTeX-section-label(fun): Insert a label after the section command. Controled by the variable LaTeX-section-label(var)/LaTeX-section-label(fun).

To get a full featured LaTeX-section command, insert

 (setq LaTeX-section-hook
       '(LaTeX-section-heading
         LaTeX-section-title
         LaTeX-section-toc
         LaTeX-section-section
         LaTeX-section-label))

in your init file such as .emacs.d/init.el or .emacs.

Source Code

;; Defined in ~/.emacs.d/elpa/auctex-14.1.2/latex.el
(defcustom LaTeX-section-hook
  '(LaTeX-section-heading
    LaTeX-section-title
    ;; LaTeX-section-toc                ; Most people won't want this
    LaTeX-section-section
    LaTeX-section-label)
  "List of hooks to run when a new section is inserted.

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).

The following standard hooks exist -

`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
section.  Modifies `LaTeX-title'.

`LaTeX-section-toc': Query the user for the toc entry.  Modifies
`LaTeX-toc'.

`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.
Controled by the variable `LaTeX-section-label'.

To get a full featured `LaTeX-section' command, insert

 (setq LaTeX-section-hook
       \\='(LaTeX-section-heading
         LaTeX-section-title
         LaTeX-section-toc
         LaTeX-section-section
         LaTeX-section-label))

in your init file such as .emacs.d/init.el or .emacs."
  :group 'LaTeX-macro
  :type 'hook
  :options '(LaTeX-section-heading
             LaTeX-section-title
             LaTeX-section-toc
             LaTeX-section-section
             LaTeX-section-label))