[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Here is an alphabetical list of the @-commands in Texinfo. Square brackets, [ ], indicate optional arguments; an ellipsis, ‘…’, indicates repeated text.
More specifics on the general syntax of different @-commands are given in the section below.
A.1 @-Command Syntax | General syntax for varieties of @-commands. |
@whitespace
An @
followed by a space, tab, or newline produces a normal,
stretchable, interword space. See section Multiple Spaces.
@!
Produce an exclamation point that ends a sentence (usually after an end-of-sentence capital letter). See section Ending a Sentence.
@"
@'
Generate an umlaut or acute accent, respectively, over the next character, as in ö and ó. See section Inserting Accents.
@*
Force a line break. See section @*
and @/
: Generate and Allow Line Breaks.
@,{c}
Generate a cedilla accent under c, as in ç. See section Inserting Accents.
@-
Insert a discretionary hyphenation point. See section @-
and @hyphenation
: Helping TeX Hyphenate.
@.
Produce a period that ends a sentence (usually after an end-of-sentence capital letter). See section Ending a Sentence.
@/
Produces no output, but allows a line break. See section @*
and @/
: Generate and Allow Line Breaks.
@:
Tell TeX to refrain from inserting extra whitespace after an immediately preceding period, question mark, exclamation mark, or colon, as TeX normally would. See section Not Ending a Sentence.
@=
Generate a macron (bar) accent over the next character, as in ō. See section Inserting Accents.
@?
Produce a question mark that ends a sentence (usually after an end-of-sentence capital letter). See section Ending a Sentence.
@@
Stands for an at sign, ‘@’. See section Inserting @ and {} and ,.
@\
Stands for a backslash (‘\’) inside @math
.
See section math
.
@^
@`
Generate a circumflex (hat) or grave accent, respectively, over the next character, as in ô and è. See section Inserting Accents.
@{
Stands for a left brace, ‘{’. See section Inserting @ and {} and ,.
@}
Stands for a right-hand brace, ‘}’.
See section Inserting @ and {} and ,.
@~
Generate a tilde accent over the next character, as in Ñ. See section Inserting Accents.
@AA{}
@aa{}
Generate the uppercase and lowercase Scandinavian A-ring letters, respectively: Å, å. See section Inserting Accents.
@abbr{abbreviation}
Indicate a general abbreviation, such as ‘Comput.’. See section abbr
.
@acronym{acronym}
Indicate an acronym in all capital letters, such as ‘NASA’.
See section acronym
.
@AE{}
@ae{}
Generate the uppercase and lowercase AE ligatures, respectively: Æ, æ. See section Inserting Accents.
@afivepaper
Change page dimensions for the A5 paper size. See section Printing on A4 Paper.
@afourlatex
@afourpaper
@afourwide
Change page dimensions for the A4 paper size. See section Printing on A4 Paper.
@alias new=existing
Make the command ‘@new’ a synonym for the existing command ‘@existing’. See section ‘@alias new=existing’.
@anchor{name}
Define name as the current location for use as a cross-reference
target. See section @anchor
.
@appendix title
Begin an appendix. The title appears in the table of contents. In
Info, the title is underlined with asterisks. See section The @unnumbered
and @appendix
Commands.
@appendixsec title
@appendixsection title
Begin an appendix section within an appendix. The section title
appears in the table of contents. In Info, the title is underlined
with equal signs. @appendixsection
is a longer spelling of
the @appendixsec
command. See section Section Commands.
@appendixsubsec title
Begin an appendix subsection. The title appears in the table of contents. In Info, the title is underlined with hyphens. See section Subsection Commands.
@appendixsubsubsec title
Begin an appendix subsubsection. The title appears in the table of contents. In Info, the title is underlined with periods. See section The ‘subsub’ Commands.
@arrow{}
Generate a right arrow glyph: ‘→’. Used by default
for @click
. See section Click Sequences.
@asis
Used following @table
, @ftable
, and @vtable
to
print the table’s first column without highlighting (“as is”).
See section Making a Two-column Table.
@author author
Typeset author flushleft and underline it. See section The @title
and @author
Commands.
@b{text}
Set text in a bold font. No effect in Info. See section Fonts for Printing, Not Info.
@bullet{}
Generate a large round dot, • (‘*’ in Info). Often used
with @table
. See section @bullet
.
@bye
Stop formatting a file. The formatters do not see anything in the
input file following @bye
. See section Ending a Texinfo File.
@c comment
Begin a comment in Texinfo. The rest of the line does not appear in
any output. A synonym for
@comment
. See section Comments.
@caption
Define the full caption for a @float
. See section @caption
& @shortcaption
.
@cartouche
Highlight an example or quotation by drawing a box with rounded
corners around it. Pair with @end cartouche
. No effect in
Info. See section Drawing Cartouches Around Examples.)
@center line-of-text
Center the line of text following the command.
See section @center
.
@centerchap line-of-text
Like @chapter
, but centers the chapter title. See section @chapter
.
@chapheading title
Print an unnumbered chapter-like heading, but omit from the table of
contents. In Info, the title is underlined with asterisks.
See section @majorheading
and @chapheading
.
@chapter title
Begin a numbered chapter. The chapter title appears in the table of
contents. In Info, the title is underlined with asterisks.
See section @chapter
.
@cindex entry
Add entry to the index of concepts. See section Defining the Entries of an Index.
@cite{reference}
Highlight the name of a book or other reference that has no companion
Info file. See section @cite
.
@click{}
Represent a single “click” in a GUI. Used within
@clicksequence
. See section Click Sequences.
@clicksequence{action @click{} action}
Represent a sequence of clicks in a GUI. See section Click Sequences.
@clickstyle @cmd
Execute @cmd for each @click
; the default is
@arrow
. The usual following empty braces on @cmd are
omitted. See section Click Sequences.
@clear flag
Unset flag, preventing the Texinfo formatting commands from
formatting text between subsequent pairs of @ifset flag
and @end ifset
commands, and preventing
@value{flag}
from expanding to the value to which
flag is set.
See section @set
@clear
@value
.
@code{sample-code}
Indicate an expression, a syntactically complete token of a program,
or a program name. Unquoted in Info output. See section @code
.
@comma{}
Insert a comma ‘,’ character; only needed when a literal comma would
be taken as an argument separator. See section Inserting ‘,’ with @comma{}
.
@command{command-name}
Indicate a command name, such as ls
.
See section @command
.
@comment comment
Begin a comment in Texinfo. The rest of the line does not appear in
any output. A synonym for @c
.
See section Comments.
@contents
Print a complete table of contents. Has no effect in Info, which uses menus instead. See section Generating a Table of Contents.
@copyright{}
Generate the copyright symbol ©. See section @copyright{}
.
@defcodeindex index-name
Define a new index and its indexing command. Print entries in an
@code
font. See section Defining New Indices.
@defcv category class name
@defcvx category class name
Format a description for a variable associated with a class in object-oriented programming. Takes three arguments: the category of thing being defined, the class to which it belongs, and its name. See section Definition Commands, and Def Cmds in Detail.
@deffn category name arguments…
@deffnx category name arguments…
Format a description for a function, interactive command, or similar
entity that may take arguments. @deffn
takes as arguments the
category of entity being described, the name of this particular
entity, and its arguments, if any. See section Definition Commands.
@defindex index-name
Define a new index and its indexing command. Print entries in a roman font. See section Defining New Indices.
@definfoenclose newcmd, before, after
Must be used within @ifinfo
; create a new command
@newcmd
for Info that marks text by enclosing it in
strings that precede and follow the text. See section ‘definfoenclose’: Customized Highlighting.
@defivar class instance-variable-name
@defivarx class instance-variable-name
Format a description for an instance variable in object-oriented programming. The command is equivalent to ‘@defcv {Instance Variable} …’. See section Definition Commands, and Def Cmds in Detail.
@defmac macroname arguments…
@defmacx macroname arguments…
Format a description for a macro; equivalent to ‘@deffn Macro …’. See section Definition Commands, and Def Cmds in Detail.
@defmethod class method-name arguments…
@defmethodx class method-name arguments…
Format a description for a method in object-oriented programming; equivalent to ‘@defop Method …’. See section Definition Commands, and Def Cmds in Detail.
@defop category class name arguments…
@defopx category class name arguments…
Format a description for an operation in object-oriented programming.
@defop
takes as arguments the name of the category of
operation, the name of the operation’s class, the name of the
operation, and its arguments, if any. See section Definition Commands, and
Object-Oriented Programming.
@defopt option-name
@defoptx option-name
Format a description for a user option; equivalent to ‘@defvr {User Option} …’. See section Definition Commands, and Def Cmds in Detail.
@defspec special-form-name arguments…
@defspecx special-form-name arguments…
Format a description for a special form; equivalent to ‘@deffn {Special Form} …’. See section Definition Commands, and Def Cmds in Detail.
@deftp category name-of-type attributes…
@deftpx category name-of-type attributes…
Format a description for a data type; its arguments are the category, the name of the type (e.g., ‘int’) , and then the names of attributes of objects of that type. See section Definition Commands, and Data Types.
@deftypecv category class data-type name
@deftypecvx category class data-type name
Format a description for a typed class variable in object-oriented programming. See section Definition Commands, and Object-Oriented Programming.
@deftypefn category data-type name arguments…
@deftypefnx category data-type name arguments…
Format a description for a function or similar entity that may take
arguments and that is typed. @deftypefn
takes as arguments the
category of entity being described, the type, the name of the
entity, and its arguments, if any. See section Definition Commands, and
Def Cmds in Detail.
@deftypefun data-type function-name arguments…
@deftypefunx data-type function-name arguments…
Format a description for a function in a typed language. The command is equivalent to ‘@deftypefn Function …’. See section Definition Commands, and Def Cmds in Detail.
@deftypeivar class data-type variable-name
@deftypeivarx class data-type variable-name
Format a description for a typed instance variable in object-oriented programming. See section Definition Commands, and Object-Oriented Programming.
@deftypemethod class data-type method-name arguments…
@deftypemethodx class data-type method-name arguments…
Format a description for a typed method in object-oriented programming. See section Definition Commands, and Def Cmds in Detail.
@deftypeop category class data-type name arguments…
@deftypeopx category class data-type name arguments…
Format a description for a typed operation in object-oriented programming. See section Definition Commands, and Object-Oriented Programming.
@deftypevar data-type variable-name
@deftypevarx data-type variable-name
Format a description for a variable in a typed language. The command is equivalent to ‘@deftypevr Variable …’. See section Definition Commands, and Def Cmds in Detail.
@deftypevr category data-type name
@deftypevrx category data-type name
Format a description for something like a variable in a typed language—an entity that records a value. Takes as arguments the category of entity being described, the type, and the name of the entity. See section Definition Commands, and Def Cmds in Detail.
@defun function-name arguments…
@defunx function-name arguments…
Format a description for a function; equivalent to ‘@deffn Function …’. See section Definition Commands, and Def Cmds in Detail.
@defvar variable-name
@defvarx variable-name
Format a description for a variable; equivalent to ‘@defvr Variable …’. See section Definition Commands, and Def Cmds in Detail.
@defvr category name
@defvrx category name
Format a description for any kind of variable. @defvr
takes
as arguments the category of the entity and the name of the entity.
See section Definition Commands,
and Def Cmds in Detail.
@detailmenu
Mark the (optional) detailed node listing in a master menu. See section Parts of a Master Menu.
@dfn{term}
Indicate the introductory or defining use of a term. See section @dfn
.
@dircategory dirpart
Specify a part of the Info directory menu where this file’s entry should go. See section Installing Info Directory Files.
@direntry
Begin the Info directory menu entry for this file. Pair with
@end direntry
. See section Installing Info Directory Files.
@display
Begin a kind of example. Like @example
(indent text, do not
fill), but do not select a new font. Pair with @end display
.
See section @display
.
@dmn{dimension}
Format a unit of measure, as in 12pt. Causes TeX to insert a
thin space before dimension. No effect in Info.
See section @dmn
.
@docbook
Enter Docbook completely. Pair with @end docbook
. See section Raw Formatter Commands.
@documentdescription
Set the document description text, included in the HTML output. Pair
with @end documentdescription
. See section @documentdescription
.
@documentencoding enc
Declare the input encoding to be enc.
See section @documentencoding
.
@documentlanguage CC
Declare the document language as the two-character ISO-639 abbreviation
CC. See section @documentlanguage
.
@dotaccent{c}
Generate a dot accent over the character c, as in ȯ. See section Inserting Accents.
@dots{}
Generate an ellipsis, ‘…’.
See section @dots
.
@email{address[, displayed-text]}
Indicate an electronic mail address.
See section @email
.
@emph{text}
Emphasize text, by using italics where possible, and enclosing in asterisks in Info. See section Emphasizing Text.
@end environment
Ends environment, as in ‘@end example’. See section @-commands.
@env{environment-variable}
Indicate an environment variable name, such as PATH
.
See section @env
.
@enddots{}
Generate an end-of-sentence ellipsis, like this: ...
See section @dots{}
.
@enumerate [number-or-letter]
Begin a numbered list, using @item
for each entry.
Optionally, start list with number-or-letter. Pair with
@end enumerate
. See section @enumerate
.
@equiv{}
Indicate to the reader the exact equivalence of two forms with a
glyph: ‘≡’. See section @equiv{}
(≡): Indicating Equivalence.
@euro{}
Generate the Euro currency sign.
See section @euro{}
.
@error{}
Indicate to the reader with a glyph that the following text is
an error message: ‘error-->’. See section @error{}
(error-->): Indicating an Error Message.
@evenfooting [left] @| [center] @| [right]
@evenheading [left] @| [center] @| [right]
Specify page footings resp. headings for even-numbered (left-hand) pages. See section How to Make Your Own Headings.
@everyfooting [left] @| [center] @| [right]
@everyheading [left] @| [center] @| [right]
Specify page footings resp. headings for every page. Not relevant to Info. See section How to Make Your Own Headings.
@example
Begin an example. Indent text, do not fill, and select fixed-width
font. Pair with @end example
. See section @example
.
@exampleindent indent
Indent example-like environments by indent number of spaces (perhaps 0). See section Paragraph Indenting.
@exclamdown{}
Generate an upside-down exclamation point. See section Inserting Accents.
@exdent line-of-text
Remove any indentation a line might have. See section Undoing the Indentation of a Line.
@expansion{}
Indicate the result of a macro expansion to the reader with a special glyph: ‘→’. See section → Indicating an Expansion.
@file{filename}
Highlight the name of a file, buffer, node, directory, etc. See section @file
.
@finalout
Prevent TeX from printing large black warning rectangles beside over-wide lines. See section Overfull “hboxes”.
@findex entry
Add entry to the index of functions. See section Defining the Entries of an Index.
@float
Environment to define floating material. Pair with @end float
.
See section Floats.
@flushleft
@flushright
Do not fill text; left (right) justify every line while leaving the
right (left) end ragged. Leave font as is. Pair with @end
flushleft
(@end flushright
). @flushright
analogous.
See section @flushleft
and @flushright
.
@footnote{text-of-footnote}
Enter a footnote. Footnote text is printed at the bottom of the page by TeX; Info may format in either ‘End’ node or ‘Separate’ node style. See section Footnotes.
@footnotestyle style
Specify an Info file’s footnote style, either ‘end’ for the end node style or ‘separate’ for the separate node style. See section Footnotes.
@format
Begin a kind of example. Like @display
, but do not indent.
Pair with @end format
. See section @example
.
@ftable formatting-command
Begin a two-column table, using @item
for each entry.
Automatically enter each of the items in the first column into the
index of functions. Pair with @end ftable
. The same as
@table
, except for indexing. See section @ftable
and @vtable
.
@geq{}
Generate a greater-than-or-equal sign, ‘≥’. See section @geq{}
(≥) and @leq{}
(≤): Inserting relations.
@group
Disallow page breaks within following text. Pair with @end
group
. Ignored in Info. See section @group
.
@H{c}
Generate the long Hungarian umlaut accent over c, as in ő.
@heading title
Print an unnumbered section-like heading, but omit from the table of contents. In Info, the title is underlined with equal signs. See section Section Commands.
@headings on-off-single-double
Turn page headings on or off, and/or specify single-sided or double-sided
page headings for printing. See section The @headings
Command.
@headitem
Begin a heading row in a multitable. See section Multitable Rows.
@html
Enter HTML completely. Pair with @end html
. See section Raw Formatter Commands.
@hyphenation{hy-phen-a-ted words}
Explicitly define hyphenation points. See section @-
and @hyphenation
.
@i{text}
Set text in an italic font. No effect in Info. See section Fonts for Printing, Not Info.
@ifclear txivar
If the Texinfo variable txivar is not set, format the following
text. Pair with @end ifclear
. See section @set
@clear
@value
.
@ifdocbook
@ifhtml
@ifinfo
Begin text that will appear only in the given output format.
@ifinfo
output appears in both Info and (for historical
compatibility) plain text output. Pair with @end ifdocbook
resp. @end ifhtml
resp. @end ifinfo
.
See section Conditionally Visible Text.
@ifnotdocbook
@ifnothtml
@ifnotplaintext
@ifnottex
@ifnotxml
Begin text to be ignored in one output format but not the others.
@ifnothtml
text is omitted from HTML output, etc. Pair with
the corresponding @end ifnotformat
.
See section Conditionally Visible Text.
@ifnotinfo
Begin text to appear in output other than Info and (for historical
compatibility) plain text. Pair with @end ifnotinfo
.
See section Conditionally Visible Text.
@ifplaintext
Begin text that will appear only in the plain text output.
Pair with @end ifplaintext
. See section Conditionally Visible Text.
@ifset txivar
If the Texinfo variable txivar is set, format the following
text. Pair with @end ifset
. See section @set
@clear
@value
.
@iftex
Begin text to appear only in the TeX output. Pair with @end
iftex
. See section Conditionally Visible Text.
@ifxml
Begin text that will appear only in the XML output. Pair with
@end ifxml
. See section Conditionally Visible Text.
@ignore
Begin text that will not appear in any output. Pair with @end
ignore
. See section Comments and Ignored Text.
@image{filename, [width], [height], [alt], [ext]}
Include graphics image in external filename scaled to the given width and/or height, using alt text and looking for ‘filename.ext’ in HTML. See section Inserting Images.
@include filename
Read the contents of Texinfo source file filename. See section Include Files.
@indicateurl{indicateurl}
Indicate text that is a uniform resource locator for the World Wide
Web. See section @indicateurl
.
@inforef{node-name, [entry-name], info-file-name}
Make a cross reference to an Info file for which there is no printed
manual. See section Cross references using @inforef
.
\input macro-definitions-file
Use the specified macro definitions file. This command is used only
in the first line of a Texinfo file to cause TeX to make use of the
‘texinfo’ macro definitions file. The backslash in \input
is used instead of an @
because TeX does not
recognize @
until after it has read the definitions file.
See section Texinfo File Header.
@item
Indicate the beginning of a marked paragraph for @itemize
and
@enumerate
; indicate the beginning of the text of a first column
entry for @table
, @ftable
, and @vtable
.
See section Lists and Tables.
@itemize mark-generating-character-or-command
Begin an unordered list: indented paragraphs with a mark, such as
@bullet
, inside the left margin at the beginning of each
item. Pair with @end itemize
. See section @itemize
.
@itemx
Like @item
but do not generate extra vertical space above the
item text. Thus, when several items have the same description, use
@item
for the first and @itemx
for the others.
See section @itemx
.
@kbd{keyboard-characters}
Indicate characters of input to be typed by users. See section @kbd
.
@kbdinputstyle style
Specify when @kbd
should use a font distinct from
@code
. See section @kbd
.
@key{key-name}
Indicate the name of a key on a keyboard. See section @key
.
@kindex entry
Add entry to the index of keys. See section Defining the Entries of an Index.
@L{}
@l{}
Generate the uppercase and lowercase Polish suppressed-L letters, respectively: Ł, ł.
@LaTeX{}
Generate the LaTeX logo. See section TeX and LaTeX.
@leq{}
Generate a less-than-or-equal sign, ‘≤’. See section @geq{}
(≥) and @leq{}
(≤): Inserting relations.
@lisp
Begin an example of Lisp code. Indent text, do not fill, and select
fixed-width font. Pair with @end lisp
. See section @lisp
.
@listoffloats
Produce a table-of-contents-like listing of @float
s.
See section @listoffloats
: Tables of Contents for Floats.
@lowersections
Change subsequent chapters to sections, sections to subsections, and so
on. See section @raisesections
and @lowersections
.
@macro macroname {params}
Define a new Texinfo command @macroname{params}
.
Pair with @end macro
. See section Defining Macros.
@majorheading title
Print an unnumbered chapter-like heading, but omit from
the table of contents. This generates more vertical whitespace before
the heading than the @chapheading
command. See section @majorheading
and @chapheading
.
@math{mathematical-expression}
Format a mathematical expression.
See section @math
- Inserting Mathematical Expressions.
@menu
Mark the beginning of a menu of nodes. No effect in a printed manual.
Pair with @end menu
. See section Menus.
@minus{}
Generate a minus sign, ‘-’. See section @minus
.
@multitable column-width-spec
Begin a multi-column table. Begin each row with @item
or
@headitem
, and separate columns with @tab
. Pair with
@end multitable
. See section Multitable Column Widths.
@need n
Start a new page in a printed manual if fewer than n mils
(thousandths of an inch) remain on the current page. See section @need
.
@node name, next, previous, up
Begin a new node. See section @node
.
@noindent
Prevent text from being indented as if it were a new paragraph.
See section @noindent
.
@novalidate
Suppress validation of node references and omit creation of auxiliary
files with TeX. Use before @setfilename
. See section Pointer Validation.
@O{}
@o{}
Generate the uppercase and lowercase O-with-slash letters, respectively: Ø, ø.
@oddfooting [left] @| [center] @| [right]
@oddheading [left] @| [center] @| [right]
Specify page footings resp. headings for odd-numbered (right-hand) pages. See section How to Make Your Own Headings.
@OE{}
@oe{}
Generate the uppercase and lowercase OE ligatures, respectively: Œ, œ. See section Inserting Accents.
@option{option-name}
Indicate a command-line option, such as ‘-l’ or ‘--help’.
See section @option
.
@page
Start a new page in a printed manual. No effect in Info.
See section @page
.
@pagesizes [width][, height]
Change page dimensions. See section @pagesizes
[width][, height]: Custom Page Sizes.
@paragraphindent indent
Indent paragraphs by indent number of spaces (perhaps 0); preserve
source file indentation if indent is asis
.
See section Paragraph Indenting.
@pindex entry
Add entry to the index of programs. See section Defining the Entries of an Index.
@point{}
Indicate the position of point in a buffer to the reader with a glyph: ‘∗’. See section Indicating Point in a Buffer.
@pounds{}
Generate the pounds sterling currency sign.
See section @pounds{}
.
@print{}
Indicate printed output to the reader with a glyph:
‘-|’. See section @print{}
(-|): Indicating Printed Output.
@printindex index-name
Generate the alphabetized index for index-name (using two columns in a printed manual). See section Printing Indices and Menus.
@pxref{node, [entry], [node-title], [info-file], [manual]}
Make a reference that starts with a lower case ‘see’ in a printed
manual. Use within parentheses only. Only the first argument is
mandatory. See section @pxref
.
@questiondown{}
Generate an upside-down question mark. See section Inserting Accents.
@quotation
Narrow the margins to indicate text that is quoted from another work.
Takes optional argument of prefix text. Pair with @end
quotation
. See section @quotation
.
@r{text}
Set text in the regular roman font. No effect in Info. See section Fonts for Printing, Not Info.
@raisesections
Change subsequent sections to chapters, subsections to sections, and so
on. See section @raisesections
and @lowersections
.
@ref{node, [entry], [node-title], [info-file], [manual]}
Make a plain reference that does not start with any special text.
Follow command with a punctuation mark. Only the first argument is
mandatory. See section @ref
.
@refill
This command used to refill and indent the paragraph after all the other processing has been done. It is no longer needed, since all formatters now automatically refill as needed, but you may still see it in the source to some manuals, as it does no harm.
@registeredsymbol{}
Generate the legal symbol ®. See section @registeredsymbol{}
.
@result{}
Indicate the result of an expression to the reader with a special
glyph: ‘⇒’. See section @result
.
@ringaccent{c}
Generate a ring accent over the next character, as in o*. See section Inserting Accents.
@samp{text}
Indicate a literal example of a sequence of characters, in general.
Quoted in Info output. See section @samp
.
@sansserif{text}
Set text in a sans serif font if possible. No effect in Info. See section Fonts for Printing, Not Info.
@sc{text}
Set text in a small caps font in printed output, and uppercase
in Info. See section @sc
{text}: The Small Caps Font.
@section title
Begin a section within a chapter. The section title appears in the
table of contents. In Info, the title is underlined with equal signs.
Within @chapter
and @appendix
, the section title is
numbered; within @unnumbered
, the section is unnumbered.
See section @section
.
@set txivar [string]
Define the Texinfo variable txivar, optionally to the value
string. See section @set
@clear
@value
.
@setchapternewpage on-off-odd
Specify whether chapters start on new pages, and if so, whether on
odd-numbered (right-hand) new pages. See section @setchapternewpage
.
@setcontentsaftertitlepage
Put the table of contents after the ‘@end titlepage’ even if the
@contents
command is at the end. See section Generating a Table of Contents.
@setfilename info-file-name
Provide a name to be used for the output files. This command is essential
for TeX formatting as well, even though it produces no output of
its own. See section @setfilename
.
@setshortcontentsaftertitlepage
Place the short table of contents after the ‘@end titlepage’
command even if the @shortcontents
command is at the end.
See section Generating a Table of Contents.
@settitle title
Specify the title for page headers in a printed manual, and the
default document description for HTML ‘<head>’. See section @settitle
.
@shortcaption
Define the short caption for a @float
. See section @caption
& @shortcaption
.
@shortcontents
Print a short table of contents, with chapter-level entries only. Not relevant to Info, which uses menus rather than tables of contents. See section Generating a Table of Contents.
@shorttitlepage title
Generate a minimal title page. See section @titlepage
.
@slanted{text}
Set text in a slanted font if possible. No effect in Info. See section Fonts for Printing, Not Info.
@smallbook
Cause TeX to produce a printed manual in a 7 by 9.25 inch format
rather than the regular 8.5 by 11 inch format. See section Printing Small Books. Also, see @small…
Block Commands.
@smalldisplay
Begin a kind of example. Like @smallexample
(narrow margins, no
filling), but do not select the fixed-width font. Pair with @end
smalldisplay
. See section @small…
Block Commands.
@smallexample
Begin an example. Do not fill, select fixed-width font, narrow the
margins. Where possible, print text in a smaller font than with
@example
. Pair with @end smallexample
. See section @small…
Block Commands.
@smallformat
Begin a kind of example. Like @smalldisplay
, but do not narrow
the margins. Pair with @end smallformat
. See section @small…
Block Commands.
@smalllisp
Begin an example of Lisp code. Same as @smallexample
. Pair
with @end smalllisp
. See section @small…
Block Commands.
@sp n
Skip n blank lines. See section @sp
.
@ss{}
Generate the German sharp-S es-zet letter, ß. See section Inserting Accents.
@strong {text}
Emphasize text more strongly than @emph
, by using
boldface where possible; enclosed in asterisks in Info.
See section Emphasizing Text.
@subheading title
Print an unnumbered subsection-like heading, but omit from the table
of contents of a printed manual. In Info, the title is underlined
with hyphens. See section @unnumberedsubsec
@appendixsubsec
@subheading
.
@subsection title
Begin a subsection within a section. The subsection title appears in
the table of contents. In Info, the title is underlined with hyphens.
Same context-dependent numbering as @section
. See section @subsection
.
@subsubheading title
Print an unnumbered subsubsection-like heading, but omit from the table of contents of a printed manual. In Info, the title is underlined with periods. See section The ‘subsub’ Commands.
@subsubsection title
Begin a subsubsection within a subsection. The subsubsection title
appears in the table of contents. In Info, the title is underlined
with periods. Same context-dependent numbering as @section
.
See section The ‘subsub’ Commands.
@subtitle title
In a printed manual, set a subtitle in a normal sized font flush to
the right-hand side of the page. Not relevant to Info, which does not
have title pages. See section @title
@subtitle
and @author
Commands.
@summarycontents
Print a short table of contents. Synonym for @shortcontents
.
See section Generating a Table of Contents.
@syncodeindex from-index to-index
Merge the index named in the first argument into the index named in
the second argument, formatting the entries from the first index with
@code
. See section Combining Indices.
@synindex from-index to-index
Merge the index named in the first argument into the index named in the second argument. Do not change the font of from-index entries. See section Combining Indices.
@t{text}
Set text in a fixed-width, typewriter-like font. No effect in Info. See section Fonts for Printing, Not Info.
@tab
Separate columns in a row of a multitable. See section Multitable Rows.
@table formatting-command
Begin a two-column table (description list), using @item
for
each entry. Write each first column entry on the same line as
@item
. First column entries are printed in the font resulting
from formatting-command. Pair with @end table
.
See section Making a Two-column Table. Also see
@ftable
and @vtable
, and
@itemx
.
@TeX{}
Generate the TeX logo. See section TeX and LaTeX.
@tex
Enter TeX completely. Pair with @end tex
. See section Raw Formatter Commands.
@thischapter
@thischaptername
@thischapternum
@thisfile
@thispage
@thistitle
Only allowed in a heading or footing. Stands for, respectively, the number and name of the current chapter (in the format ‘Chapter 1: Title’), the current chapter name only, the current chapter number only, the filename, the current page number, and the title of the document, respectively. See section How to Make Your Own Headings.
@tie{}
Generate a normal interword space at which a line break is not allowed.
See section @tie{}
.
@tieaccent{cc}
Generate a tie-after accent over the next two characters cc, as in ‘oo[’. See section Inserting Accents.
@tindex entry
Add entry to the index of data types. See section Defining the Entries of an Index.
@title title
In a printed manual, set a title flush to the left-hand side of the
page in a larger than normal font and underline it with a black rule.
Not relevant to Info, which does not have title pages. See section The @title
@subtitle
and @author
Commands.
@titlefont{text}
In a printed manual, print text in a larger than normal font.
See section The @titlefont
@center
and @sp
Commands.
@titlepage
Begin the title page. Write the command on a line of its own, paired
with @end titlepage
. Nothing between @titlepage
and
@end titlepage
appears in Info. See section @titlepage
.
@today{}
Insert the current date, in ‘1 Jan 1900’ style. See section How to Make Your Own Headings.
@top title
Mark the topmost @node
in the file, which must be defined on
the line immediately preceding the @top
command. The title is
formatted as a chapter-level heading. The entire top node, including
the @node
and @top
lines, are normally enclosed with
@ifnottex ... @end ifnottex
. In TeX and
texinfo-format-buffer
, the @top
command is merely a
synonym for @unnumbered
. See section Creating Pointers with makeinfo
.
@u{c}
@ubaraccent{c}
@udotaccent{c}
Generate a breve, underbar, or underdot accent, respectively, over or under the character c, as in ŏ, o_, ọ. See section Inserting Accents.
@unnumbered title
Begin a chapter that appears without chapter numbers of any kind. The
title appears in the table of contents. In Info, the title is
underlined with asterisks. See section @unnumbered
and @appendix
.
@unnumberedsec title
Begin a section that appears without section numbers of any kind. The title appears in the table of contents of a printed manual. In Info, the title is underlined with equal signs. See section Section Commands.
@unnumberedsubsec title
Begin an unnumbered subsection. The title appears in the table of
contents. In Info, the title is underlined with hyphens.
See section @unnumberedsubsec
@appendixsubsec
@subheading
.
@unnumberedsubsubsec title
Begin an unnumbered subsubsection. The title appears in the table of contents. In Info, the title is underlined with periods. See section The ‘subsub’ Commands.
@uref{url[, displayed-text][, replacement}
@url{url[, displayed-text][, replacement}
Define a cross reference to an external uniform resource locator,
e.g., for the World Wide Web. See section @uref
.
@v{c}
Generate check accent over the character c, as in o<. See section Inserting Accents.
@value{txivar}
Insert the value, if any, of the Texinfo variable txivar,
previously defined by @set
. See section @set
@clear
@value
.
@var{metasyntactic-variable}
Highlight a metasyntactic variable, which is something that stands for another piece of text. See section Indicating Metasyntactic Variables.
@verb{delim literal delim}
Output literal, delimited by the single character delim,
exactly as is (in the fixed-width font), including any whitespace or
Texinfo special characters. See section verb
.
@verbatim
Output the text of the environment exactly as is (in the fixed-width
font). Pair with @end verbatim
. See section verbatim
.
@verbatiminclude filename
Output the contents of filename exactly as is (in the fixed-width font).
See section verbatiminclude
.
@vindex entry
Add entry to the index of variables. See section Defining the Entries of an Index.
@vskip amount
In a printed manual, insert whitespace so as to push text on the
remainder of the page towards the bottom of the page. Used in
formatting the copyright page with the argument ‘0pt plus
1filll’. (Note spelling of ‘filll’.) @vskip
may be used
only in contexts ignored for Info. See section Copyright Page.
@vtable formatting-command
Begin a two-column table, using @item
for each entry.
Automatically enter each of the items in the first column into the
index of variables. Pair with @end vtable
. The same as
@table
, except for indexing. See section @ftable
and @vtable
.
@w{text}
Disallow line breaks within text. See section @w
.
@xml
Enter XML completely. Pair with @end xml
. See section Raw Formatter Commands.
@xref{node, [entry], [node-title], [info-file], [manual]}
Make a reference that starts with ‘See’ in a printed manual. Follow
command with a punctuation mark. Only the first argument is
mandatory. See section @xref
.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The character ‘@’ is used to start special Texinfo commands. (It has the same meaning that ‘\’ has in plain TeX.) Texinfo has four types of @-command:
These commands consist of an @ followed by a punctuation mark or
other character that is not part of the alphabet. Non-alphabetic
commands are almost always part of the text within a paragraph. The
non-alphabetic commands include @@
, @{
, @}
,
@.
, @SPACE
, most of the accent commands, and
many more.
These commands start with @ followed by a word followed by left- and
right-hand braces. These commands insert special symbols in the
document; they do not require arguments. For example,
@dots{}
⇒ ‘…’, @equiv{}
⇒ ‘≡’, @TeX{}
⇒ ‘TeX’,
and @bullet{}
⇒ ‘•’.
These commands start with @ followed by a letter or a word, followed by an
argument within braces. For example, the command @dfn
indicates
the introductory or defining use of a term; it is used as follows: ‘In
Texinfo, @@-commands are @dfn{mark-up} commands.’
These commands occupy an entire line. The line starts with @,
followed by the name of the command (a word); for example, @center
or @cindex
. If no argument is needed, the word is followed by
the end of the line. If there is an argument, it is separated from
the command name by a space. Braces are not used.
Thus, the alphabetic commands fall into classes that have different argument syntaxes. You cannot tell to which class a command belongs by the appearance of its name, but you can tell by the command’s meaning: if the command stands for a glyph, it is in class 2 and does not require an argument; if it makes sense to use the command together with other text as part of a paragraph, the command is in class 3 and must be followed by an argument in braces; otherwise, it is in class 4 and uses the rest of the line as its argument.
The purpose of having a different syntax for commands of classes 3 and
4 is to make Texinfo files easier to read, and also to help the GNU
XEmacs paragraph and filling commands work properly. There is only one
exception to this rule: the command @refill
, which is always
used at the end of a paragraph immediately following the final period
or other punctuation character. @refill
takes no argument and
does not require braces. @refill
never confuses the
XEmacs paragraph commands because it cannot appear at the beginning of
a line. It is also no longer needed, since all formatters now refill
paragraphs automatically.
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by Aidan Kehoe on December 27, 2016 using texi2html 1.82.