[Bug-AUCTeX] 11.84; How values in TeX Commands are not documented

[Peter Dyballa]

Hello!

When adding a new command (XeTeX and XeLaTeX are of great personal  
concern) I am offered theoretical ``How:´´ options:

        TeX-run-command
        TeX-run-format
        TeX-run-TeX
        TeX-run-interactive
        TeX-run-BibTeX
        TeX-run-compile
        TeX-run-shell
        TeX-run-discard
        TeX-run-background
        TeX-run-silent
        TeX-run-discard-foreground
        TeX-run-function
        Other

None of them is documented. How can I make the right choice?  
Particularly then when the hints in the customisation window are  
identical for a few of them:

        Create a process for NAME using COMMAND to process FILE.
           Return the new process.
        Create a process for NAME using COMMAND to format FILE with TeX.
        Create a process for NAME using COMMAND to format FILE with TeX.
        Run TeX interactively.
	   Run command in a buffer (in comint-shell-mode) so that it accepts  
user
           interaction. If you return to the file buffer after the TeX run,
           Error parsing on C-x ` should work with a bit of luck.
        Create a process for NAME using COMMAND to format FILE with BibTeX.
        Ignore first and third argument, start compile with second argument.
	Ignore first and third argument, start shell-command with second  
argument.
        Start process with second argument, show output when and if it arrives.
        Start process with second argument.
	Call process with second argument in the foreground, discarding its  
output.
	   With support for MS-DOS, especially when dviout is used with  
PC-9801 series.
        Execute Lisp function or function call given as the string COMMAND.
        ignore



Emacs  : GNU Emacs 23.0.0.1 (powerpc-apple-darwin8.8.0, X toolkit,  
Xaw3d scroll bars)
of 2007-02-03 on Latsche.local
Package: 11.84

current state:
==============
(setq
AUCTeX-date "2007-01-12"
window-system 'x
LaTeX-version "2e"
TeX-style-path '("style" "auto" "/Users/pete/Library/texmf/tex/style"
                  "/Users/pete/Library/texmf/tex/auto"
                  "/Library/Application Support/Emacs/auctex/style" "/tmp")
TeX-auto-save t
TeX-parse-self t
TeX-master t
TeX-command-list '(("XeTeX" "%`xetex%(mode)%' %t" TeX-run-command nil
                     (plain-tex-mode context-mode texinfo-mode ams-tex-mode))
                    ("XeLaTeX" "%`xelatex%(mode)%' %t" TeX-run-command nil
                     (latex-mode doctex-mode ams-tex-mode))
                    ("TeX" "%(PDF)%(tex) %`%S%(PDFout)%(mode)%' %t" TeX-run-TeX 
nil
                     (plain-tex-mode texinfo-mode ams-tex-mode) :help "Run plain 
TeX")
		    ("LaTeX" "%`%l%(mode)%' %t" TeX-run-TeX nil (latex-mode doctex- 
mode) :help
                     "Run LaTeX")
                    ("Makeinfo" "makeinfo %t" TeX-run-compile nil 
(texinfo-mode) :help
                     "Run Makeinfo with Info output")
		    ("Makeinfo HTML" "makeinfo --html %t" TeX-run-compile nil  
(texinfo-mode) :help
                     "Run Makeinfo with HTML output")
                    ("AmSTeX" "%(PDF)amstex %`%S%(PDFout)%(mode)%' %t" 
TeX-run-TeX nil
                     (ams-tex-mode) :help "Run AMSTeX")
		    ("ConTeXt" "texexec --once --texutil %(execopts)%t" TeX-run-TeX  
nil
                     (context-mode) :help "Run ConTeXt once")
		    ("ConTeXt Full" "texexec %(execopts)%t" TeX-run-TeX nil  
(context-mode) :help
                     "Run ConTeXt until completion")
                    ("BibTeX" "bibtex %s" TeX-run-BibTeX nil t :help "Run 
BibTeX")
                    ("View" "%V" TeX-run-discard 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")
                    ("Check" "lacheck %s" TeX-run-compile nil (latex-mode) :help
                     "Check LaTeX file for correctness")
                    ("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"))
)


--
Mit friedvollen Grüßen

  Pete

Diese Nachricht wurde mit einer Taschenlampe ins offene Ende eines  
Glasfaserkabels gemorst.