[AUCTeX-devel] Re: Cross-references in changes.texi

[Ralf Angeli]

* Reiner Steib (2006-06-02) writes:

> On Wed, May 31 2006, Reiner Steib wrote:
>
>> BTW, I tried to find the new `TeX-doc' and `TeX-clean' using `i clean'
>> and `i doc' unsuccessfully.  Maybe we should add something to
>> `auctex.texi'?
>
> AFAICS, these don't fit in any of the current nodes:
>
> ,----[ (info "(auctex)Running TeX and friends") ]
> | * Commands::                    Invoking external commands.
> | * Viewing::                     Invoking external viewers.
> | * Debugging::                   Debugging TeX and LaTeX output.
> | * Checking::                    Checking the document.
> | * Control::                     Controlling the processes.
> `----
>
> I'd suggest to add a new node "Miscellaneous Commands" or "Other
> Commands" (or similar; suggestions?).  We could (later) add the other
> entries from the Command menu too, if appropriate.  WDYT?

Hm, I'm not sure `TeX-doc' fits into the "Running TeX and friends"
category.  It's not really part of the typesetting cycle.
Unfortunately we don't have a section where it really fits.  The other
big ones are about text manipulation and source display.  How about
giving it its own section below "Running TeX and friends" in order to
spell it out more explicitely?

> @@ -1958,6 +1958,7 @@
>  * Debugging::                   Debugging @TeX{} and @LaTeX{} output.
>  * Checking::                    Checking the document.
>  * Control::                     Controlling the processes.
> +* Miscellaneous Commands::      Miscellaneous Commands.
>  @end menu

This requires the detailed node listing to be regenerated.

> address@hidden Miscellaneous Commands
> address@hidden Miscellaneous Commands
> +
> address@hidden Command TeX-doc
> address@hidden C-c ?

How about adding a "(@kbd{C-c ?})" in front of the following
description and removing the reference to the key binding from the
text?

> +The function @code{TeX-doc} provides easy access to documentation about
> +commands and packages or information related to @TeX{} and friends in
> +general.  It is accessible with the key binding @kbd{C-c ?} or the
> address@hidden Documentation...} entry in the mode menus.
> address@hidden deffn
> +
> address@hidden Command TeX-clean
> +You can get rid of generated intermediate and output files by means of
> +the new @samp{Clean} and @samp{Clean All} entries in
       ^^^
The time will come when those won't be new anymore. (c:

> address@hidden accessible with @kbd{C-c C-c} or the Command
> +menu.

I guess we should explain the prefix argument as well if we present
`TeX-clean' as a function (in contrast to a part of
`TeX-command-list'.)

-- 
Ralf