This is the  AucTeX manual addendum for mode specific information, version 0.0 Copyright © 2009 Vincent Belaïche.

     Permission is granted to ...

Top node.
*********

This is the manual of Emacs AucTeX mode specific information.

Features specific to one major mode of AucTeX
=============================================

AucTeX embeds a few major modes, namely TeX, LaTeX, ConTeXt, Texinfo, and docTeX. Some of them deserve specific documentation because AucTeX have specific commands for them, or works with some other specific package.

Features specific to AucTeX Texinfo major mode
----------------------------------------------

AucTeX comprises a Texinfo major mode to edit Texinfo file. This major mode is not the same mode as the native Texinfo mode (see (texinfo) Texinfo Mode) of Emacs, although they have the same name. However, AucTeX still relies on a number of functions from the native Texinfo mode.

This information is therefore usefull in two kind of symmetrical situations:

  * For AucTeX users not familiar with Texinfo editing, so that they can seek more easily in the native Texinfo manual what AucTeX reuses, without being confused by what AucTeX does not use

  * For native Texinfo users, not familiar with AucTeX, so that they know where AucTeX comes into the place, and what changes in accessing native Texinfo.

How AucTeX and native Texinfo work together
...........................................

In a nutshell the split between AucTeX Texinfo mode, and native Texinfo mode is as follows:

  * all pure edition (environment creation, commenting, font command insertions) and/or processing commands (compiling, printing, etc.) are handled in AucTeX in a very similar way as for LaTeX mode, while

  * Texinfo specific feature (all that is connected with info node linkage, menu auotmated creation) still relies on the native Texinfo commands. There, AucTeX just provides the keybindings to reach these functions, with keeping the same keys as in native Texinfo whenever possible, or similar ones otherwise.

Where AucTeX superseeds native Texinfo
......................................

This node is intended to native Texinfo users switching to AucTeX. It follows the native Texinfo mode summary (see (texinfo) Texinfo Mode Summary) and lists which native texinfo commands are no longer of use.

Font insertion commands
     Native Texinfo C-c C-c K font insertion commands, with K one of c (@code), d (@dfn), k (@kbd), s (@samp), or v (@var), are replaced by C-c C-f K or C-c C-f C-K in AucTeX calling the TeX-font command (@kbd, @samp and @var are the one needing the C- prefix).

     AucTeX has a number of other font insertion commands, C-c C-f ret to get a list.

     Note that the prefix argument is not handled the same way by AucTeX.

Brace insertion
     Native Texinfo C-c { brace insertion is replaced by AucTeX TeX-insert-braces with same keybinding.

Environment insertion
     Native Texinfo C-c C-c K environment insertion command, with K one of x (@example), t (@table) are replaced all together by the AucTeX C-c C-e environnement insertion command which tackles more environments.

Macro insertion
     Native Texinfo C-c C-c K macro insertion commands, with K one of o (@noindent), n (@node) are replaced all together by the AucTeX C-c C-m macro insertion command which tackles more macros.

     Note that the native Texinfo texinfo-insert-@node node insertion can still accessed by the Texinfo menu.

Formatting info files with Makeinfo/TeX
     Native Texinfo C-c C-m C-b command (makeinfo-buffer) and C-c C-t C-b command (texinfo-tex-buffer) are superseeded by the AucTeX C-c C-c (TeX-command-master) command. After typing C-c C-c, select respectively Makeinfo or TeX. Note that you can make, say Makeinfo, the default by adding this statement in your init file:

          (add-hook 'Texinfo-mode-hook
                    (lambda () (setq TeX-command-default "Makeinfo")))

     Note also that C-c C-c Makeinfo ret is not completely functionally equivalent to M-x makeinfo-buffer as M-x makeinfo-buffer will view the info file with Emacs in same node as pointed in texi source file just after a successful compilatation. This is why, while using AucTeX, typing M-x makeinfo-buffer may still be more convenient.

     Note also that in the case of a multifile document, the AucTeX C-c C-c will work on the whole document (provided that local variable TeX-master is set correctly), while native Texinfo M-x makeinfo-buffer will process only the current buffer, provided at the @setfilename statement is provided. TeX-command-buffer on Texinfo concerning AucTeX C-c C-b (TeX-command-buffer) command.

Making indexes/Printing
     The native Texinfo commands C-c C-t C-i (texinfo-texindex), C-c C-t C-p (texinfo-tex-print), and C-c C-t C-q (tex-show-print-queue) are all superseeded by the AucTeX C-c C-c (TeX-command-master) command. Select respectively Index, Print, or Queue.

Killing jobs
     The native Texinfo command C-c C-t C-k (tex-kill-job) is superseeded by AucTeX C-c C-k (TeX-kill-job).

Where AucTeX maps keybinding to native Texinfo commands
.......................................................

This node follows the native Texinfo mode summary (see (texinfo) Texinfo Mode Summary) and lists only those commands to which AucTeX provide a keybinding.

Basically all native Texinfo commands connected with menu making and node inter-linking are mapped to same or similar keys by AucTeX, while a few insertion commands are mapped to AucTeX-like keys.

@item insertion
     Native Texinfo C-c C-c i for @item insertion is mapped by AucTeX to M-ret or C-c C-j, similar to other AucteX modes.

@end insertion
     Native Texinfo C-c C-c e for closing some @FOO by a corresponding @end FOO is now mapped to C-c C-], similar to other AucteX modes.

go out of-brace
     The C-} (up-list) command is available the same way in native Texinfo and in AucTeX texinfo (this command is actually not provided by either native or AucTeX texinfo). However, in AucTeX Texinfo, you cannot use C-] for this, as it is used for @end insertion.

Node linking update
     Native Texinfo C-c C-u C-n (texinfo-update-node), and C-c C-u C-e (texinfo-every-node-update) commands can be accessed with same key bindings in AucTeX Texinfo.

Menu updating/creation
     Native Texinfo C-c C-u m (texinfo-master-menu), C-c C-u C-m (texinfo-make-menu), C-c C-u C-a (texinfo-all-menus-update) commands can be accessed with same key bindings in AucTeX Texinfo.

     Native Texinfo texinfo-start-menu-description is bound to C-c C-u C-d in AucTeX (instead of C-c C-c C-d with native Texinfo)

Which native Texinfo commands are no longer bound to keys in AucTeX Texinfo
...........................................................................

Here we list only those native Texinfo commands that are still of some usefullness when working with AucTeX, and which you cannot access by a keybinding any longer.

@node insertion
     Native Texinfo C-c C-c n for node insertion is not mapped to any key in AucTeX, you can still have it by Texinfo menu. Another alternative is to use the AucTeX C-c C-m macro insertion.

texinfo-show-structure
     Is not on any key. C-c C-s key is used by AucTeX for sectionning. When this document is written, Reftex does not support Texinfo and therefore using Reftex C-c = (reftex-toc) is not an alternative.

Which AucTeX function do not work well with Texinfo
...................................................

In this node we list which functions/commands of AucTeX that do not work that well yet with Texinfo because AucTeX Texinfo mode is not yet mature. This status may therefore change in the future.

C-c C-c View ret
C-c C-v
     This command will only work if you compile with TeX and launch a DVI viewer. If you compile with Makeinfo, it will not view the info file under Emacs. What you can do instead is view the file into an *info* buffer for instance with Dired mode I command, and after each Makeinfo compilation switch to that buffer with C-h i and refresh it with M-x revert-buffer. Please remember that if you need to browse other info documentation at the same time, you can view it in a another buffer by renaming this buffer (e.g. with M-x rename-uniquely).

M-q
     This justification command calls the general fill-paragraph and will play havoc if you call it from within a menu.  Neither does it work properly with keeping commented and uncommented text separate.

C-c C-r
C-c C-b
     Commands to compile the active region or the content of buffer will not work properly with makeinfo (header will not be properly formatted, and the compilation will fail). C-c C-r will neither work with TeX. Note that Makeinfo compilation is so fast compared to TeX that compiling a part of document is less useful, when you select Makeinfo for document development.

     Use native Texinfo M-x makeinfo-region, M-x makeinfo-buffer, M-x texinfo-tex-region, and M-x texinfo-tex-buffer commands instead. Note that kill job has to be done consistently with native Texinfo command M-x kill-compilation (for makeinfo) or M-x tex-kill-job for TeX.

C-c C-c
     Works fine, except that if you select Makeinfo for the compiling command, and the TeX-command-default variable is set to TeX, then Makeinfo does not become the default for subsequent compiltations.

C-c *
     Marking sections is not available.

C-c .
     Marking environments is not available.