[Bug-AUCTeX] 2014-07-13; docstring fix for texmathp-why and misc

[Ikumi Keita]

Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.

Be sure to consult the FAQ section in the manual before submitting
a bug report.  In addition check if the bug is reproducable with an
up-to-date version of AUCTeX.  So please upgrade to the version
available from http://www.gnu.org/software/auctex/ if your
installation is older than the one available from the web site.

If the bug is triggered by a specific (La)TeX file, you should try
to produce a minimal sample file showing the problem and include it
in your report.

Your bug report will be posted to the AUCTeX bug reporting list.
------------------------------------------------------------------------

M-x describe-variable RET texmathp-why RET produces the document quoted
below.  The part "M-x " after `"equation" or "\ensuremath" or' is
apparently garbled.

The attached patch fixes the problem, as well as the issue that the
equation* environment is wrongly listed under the standard LaTeX
environments.  In fact, the equation* environment belongs to AMS-LaTeX,
not to standard LaTeX.

-- Quote from the output of C-h v texmathp-why ---------------------------
Documentation:
After a call to `texmathp' this variable shows why math-mode is on or off.
The value is a cons cell (MATCH . POSITION).
MATCH is a string like a car of an entry in `texmathp-tex-commands', e.q.
"equation" or "\ensuremath" or "M-x " or "$".
POSITION is the buffer position of the match.  If there was no match,
it points to the limit used for searches, usually two paragraphs up.
--------------------------------------------------------------------------

Emacs  : GNU Emacs 24.3.1 (x86_64-unknown-freebsd10.0, GTK+ Version 3.8.8)
 of 2014-08-12 on freebsd.vmware
Package: 2014-07-13

current state:
==============
(setq
 AUCTeX-date "2014-07-13"
 window-system 'x
 LaTeX-version "2e"
 TeX-style-path '("/usr/local/var/auctex" "/home/keita/elisp/auctex/style"
                  "/home/keita/.emacs.d/auctex/auto"
                  "/home/keita/.emacs.d/auctex/style" "auto" "style")
 TeX-auto-save nil
 TeX-parse-self t
 TeX-master t
 TeX-command-list '(("PDF" "dvipdfmx -C 2 %d" TeX-run-command t t :help
                     "Generate PDF file")
                    ("jTeX" "%(PDF)jtex %`%S%(PDFout)%(mode)%' %t" TeX-run-TeX
                     nil (plain-tex-mode) :help "Run NTT jTeX")
                    ("jLaTeX" "%(PDF)jlatex %`%S%(PDFout)%(mode)%' %t"
                     TeX-run-TeX nil (latex-mode) :help "Run NTT jLaTeX")
                    ("pTeX" "%(PDF)ptex %(kanjiopt)%`%S%(PDFout)%(mode)%' %t"
                     TeX-run-TeX nil (plain-tex-mode) :help "Run ASCII pTeX")
                    ("pLaTeX"
                     "%(PDF)platex %(kanjiopt)%`%S%(PDFout)%(mode)%' %t"
                     TeX-run-TeX nil (latex-mode) :help "Run ASCII pLaTeX")
                    ("Mendex" "mendex %(mendexkopt)%s" TeX-run-command nil t
                     :help "Create index file with mendex")
                    ("jBibTeX" "jbibtex %s" TeX-run-BibTeX nil t :help
                     "Run jBibTeX")
                    ("pBibTeX" "pbibtex %(kanjiopt)%s" TeX-run-BibTeX nil t
                     :help "Run pBibTeX")
                    ("-" "" ignore nil t)
                    ("TeX"
                     "%(PDF)%(tex) %(extraopts) %`%S%(PDFout)%(mode)%' %t"
                     TeX-run-TeX nil
                     (plain-tex-mode ams-tex-mode texinfo-mode) :help
                     "Run plain TeX")
                    ("LaTeX" "%`%l%(mode)%' %t" TeX-run-TeX nil
                     (latex-mode doctex-mode) :help "Run LaTeX")
                    ("Makeinfo" "makeinfo %(extraopts) %t" TeX-run-compile nil
                     (texinfo-mode) :help "Run Makeinfo with Info output")
                    ("Makeinfo HTML" "makeinfo %(extraopts) --html %t"
                     TeX-run-compile nil (texinfo-mode) :help
                     "Run Makeinfo with HTML output")
                    ("AmSTeX"
                     "%(PDF)amstex %(extraopts) %`%S%(PDFout)%(mode)%' %t"
                     TeX-run-TeX nil (ams-tex-mode) :help "Run AMSTeX")
                    ("ConTeXt"
                     "texexec --once --texutil %(extraopts) %(execopts)%t"
                     TeX-run-TeX nil (context-mode) :help "Run ConTeXt once")
                    ("ConTeXt Full" "texexec %(extraopts) %(execopts)%t"
                     TeX-run-TeX nil (context-mode) :help
                     "Run ConTeXt until completion")
                    ("BibTeX" "%(bibtex) %s" TeX-run-BibTeX nil t :help
                     "Run BibTeX")
                    ("Biber" "biber %s" TeX-run-Biber nil t :help "Run Biber")
                    ("View" "%V" TeX-run-discard-or-function t t :help
                     "Run Viewer")
                    ("Print" "%p" TeX-run-command t t :help "Print the file")
                    ("Queue" "%q" TeX-run-background nil t :help
                     "View the printer queue" :visible TeX-queue-command)
                    ("File" "%(o?)dvips %d -o %f " TeX-run-command t t :help
                     "Generate PostScript file")
                    ("Index" "%(makeindex) %s" TeX-run-command nil t :help
                     "Create index file")
                    ("Xindy" "texindy %s" TeX-run-command nil t :help
                     "Run xindy to create index file")
                    ("Check" "lacheck %s" TeX-run-compile nil (latex-mode)
                     :help "Check LaTeX file for correctness")
                    ("ChkTeX" "chktex -v6 %s" TeX-run-compile nil (latex-mode)
                     :help "Check LaTeX file for common mistakes")
                    ("Spell" "(TeX-ispell-document \"\")" TeX-run-function nil
                     t :help "Spell-check the document")
                    ("Clean" "TeX-clean" TeX-run-function nil t :help
                     "Delete generated intermediate files")
                    ("Clean All" "(TeX-clean t)" TeX-run-function nil t :help
                     "Delete generated intermediate and output files")
                    ("Other" "" TeX-run-command t t :help
                     "Run an arbitrary command")
                    )
 )

diff
Description: fix for texmathp.el