bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list

[James Cook]

I wanted to add mupdf TeX-view-program-list, but the documentation
(appearing in customize-variable for example) was missing one crucial
piece of information: how I should actually format the command. I
eventually figured out it needs to be "mupdf %o". Either %o should be
documented right there, or there should be a link to a place where
it and other substitutions are documented. (I'm sure they are somewhere;
I just have no idea where to start looking.)


Emacs  : GNU Emacs 27.1 (build 1, x86_64-unknown-openbsd, GTK+ Version 3.24.23)
 of 2020-10-31
Package: 12.2.4

current state:
==============
(setq
 AUCTeX-date "2020-06-29"
 window-system 'x
 LaTeX-version "2e"
 TeX-style-path '("~/.emacs.d/auctex" 
"/home/falsifian/.emacs.d/elpa/auctex-12.2.4/style" 
"/home/falsifian/.emacs.d/auctex/auto" "/home/falsifian/.emacs.d/auctex/style" 
"auto" "style")
 TeX-auto-save nil
 TeX-parse-self nil
 TeX-master 'shared
 TeX-command-list '(("TeX" "%(PDF)%(tex) %(file-line-error) %`%(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" "amstex %(PDFout) %`%(extraopts) %S%(mode)%' %t" 
TeX-run-TeX nil (ams-tex-mode) :help "Run AMSTeX") ("ConTeXt" "%(cntxcom) 
--once --texutil %(extraopts) %(execopts)%t" TeX-run-TeX nil (context-mode) 
:help "Run ConTeXt once")
                    ("ConTeXt Full" "%(cntxcom) %(extraopts) %(execopts)%t" 
TeX-run-TeX nil (context-mode) :help "Run ConTeXt until completion") ("BibTeX" 
"bibtex %s" TeX-run-BibTeX nil (plain-tex-mode latex-mode doctex-mode 
ams-tex-mode texinfo-mode context-mode) :help "Run BibTeX")
                    ("Biber" "biber %s" TeX-run-Biber nil (plain-tex-mode 
latex-mode doctex-mode ams-tex-mode texinfo-mode) :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-dvips t (plain-tex-mode latex-mode doctex-mode ams-tex-mode 
texinfo-mode) :help "Generate PostScript file")
                    ("Dvips" "%(o?)dvips %d -o %f " TeX-run-dvips nil 
(plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help 
"Convert DVI file to PostScript")
                    ("Dvipdfmx" "dvipdfmx %d" TeX-run-dvipdfmx nil 
(plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help 
"Convert DVI file to PDF with dvipdfmx")
                    ("Ps2pdf" "ps2pdf %f" TeX-run-ps2pdf nil (plain-tex-mode 
latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Convert PostScript 
file to PDF")
                    ("Glossaries" "makeglossaries %s" TeX-run-command nil 
(plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run 
makeglossaries to create glossary\n     file")
                    ("Index" "makeindex %s" TeX-run-index nil (plain-tex-mode 
latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run makeindex to 
create index file")
                    ("upMendex" "upmendex %s" TeX-run-index t (plain-tex-mode 
latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run upmendex to create 
index file")
                    ("Xindy" "texindy %s" TeX-run-command nil (plain-tex-mode 
latex-mode doctex-mode ams-tex-mode texinfo-mode) :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"))
 )