New Texinfo @-Commands

The second edition of the Texinfo manual describes more than 50 commands that were not described in the first edition. A third or so of these commands existed in Texinfo but were not documented in the manual; the others are new. Here is a listing, with brief descriptions of them:

Indexing

Create your own index, and merge indices.

See section Creating Indices.

@defindex index-name

Define a new index and its indexing command. See also the @defcodeindex command.

@synindex from-index into-index

Merge the from-index index into the into-index index. See also the @syncodeindex command.

Definitions

Describe functions, variables, macros, commands, user options, special forms, and other such artifacts in a uniform format.

See section Definition Commands.

@deffn category name arguments...

Format a description for functions, interactive commands, and similar entities.

@defvr, @defop, ...

15 other related commands.

Glyphs

Indicate the results of evaluation, expansion, printed output, an error message, equivalence of expressions, and the location of point.

See section Glyphs for Examples.

@equiv{}

==

Equivalence:

@error{}

error-->

Error message

@expansion{}

==>

Macro expansion

@point{}

-!-

Position of point

@print{}

-|

Printed output

@result{}

=>

Result of an expression

Page Headings

Customize page headings.

See section Page Headings.

@headings on-off-single-double

Headings on or off, single, or double-sided.

@evenfooting [left] @| [center] @| [right]

Footings for even-numbered (left-hand) pages.

@evenheading, @everyheading, @oddheading, ...

Five other related commands.

@thischapter

Insert name of chapter and chapter number.

@thischaptername, @thisfile, @thistitle, @thispage

Related commands.

Formatting

Format blocks of text.

See section Quotations and Examples, and
section Making Lists and Tables.

@cartouche

Draw rounded box surrounding text (not in Info).

@enumerate optional-arg

Enumerate a list with letters or numbers.

@exdent line-of-text

Remove indentation.

@flushleft

Left justify.

@flushright

Right justify.

@format

Do not narrow nor change font.

@ftable formatting-command

@vtable formatting-command

Two-column table with indexing.

@lisp

For an example of Lisp code.

@smallexample

@smalllisp

Like @table and @lisp but for @smallbook.

Conditionals

Conditionally format text.

See section @set, @clear, and @value.

@set flag [string]

Set a flag. Optionally, set value of flag to string.

@clear flag

Clear a flag.

@value{flag}

Replace with value to which flag is set.

@ifset flag

Format, if flag is set.

@ifclear flag

Ignore, if flag is set.

@heading series for Titles

Produce unnumbered headings that do not appear in a table of contents.

See section Chapter Structuring.

@heading title

Unnumbered section-like heading not listed in the table of contents of a printed manual.

@chapheading, @majorheading, @subheading, @subsubheading

Related commands.

Font commands

See section @sc{text}: The Small Caps Font, and
section Fonts for Printing, Not Info.

@r{text}

Print in roman font.

@sc{text}

Print in SMALL CAPS font.

Miscellaneous

See section @title, @subtitle, and @author,
see section Customized Highlighting,
see section Overfull "hboxes",
see section Footnotes,
see section @dmn{dimension}: Format a Dimension,
see section @raisesections and @lowersections,
see section @math: Inserting Mathematical Expressions.
see section @minus{}: Inserting a Minus Sign,
see section Paragraph Indenting,
see section Different Cross Reference Commands,
see section @title, @subtitle, and @author, and
see section How to Make Your Own Headings.

@author author

Typeset author's name.

@definfoenclose new-command, before, after,

Define a highlighting command for Info. (Info only.)

@finalout

Produce cleaner printed output.

@footnotestyle end-or-separate

Specify footnote style.

@dmn{dimension}

Format a dimension.

@global@letnew-cmd=existing-cmd

Define a highlighting command for TeX. (TeX only.)

@lowersections

Reduce hierarchical level of sectioning commands.

@math{mathematical-expression}

Format a mathematical expression.

@minus{}

Generate a minus sign.

@paragraphindent asis-or-number

Specify paragraph indentation.

@raisesections

Raise hierarchical level of sectioning commands.

@ref{node-name, [entry], [topic-or-title], [info-file], [manual]}

Make a reference. In the printed manual, the reference does not start with the word `see'.

@title title

Typeset title in the alternative title page format.

@subtitle subtitle

Typeset subtitle in the alternative title page format.

@today{}

Insert the current date.