JezK
Edit File: Command-Contexts.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for GNU Texinfo (version 6.8, 8 June 2021), a documentation system that can produce both online information and a printed manual from a single source using semantic markup. Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2021 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". --> <title>Command Contexts (GNU Texinfo 6.8)</title> <meta name="description" content="Command Contexts (GNU Texinfo 6.8)"> <meta name="keywords" content="Command Contexts (GNU Texinfo 6.8)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2any"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link href="index.html" rel="start" title="Top"> <link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="_0040_002dCommand-Details.html" rel="up" title="@-Command Details"> <link href="Obsolete-_0040_002dCommands.html" rel="next" title="Obsolete @-Commands"> <link href="Command-List.html" rel="prev" title="Command List"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="section" id="Command-Contexts"> <div class="header"> <p> Next: <a href="Obsolete-_0040_002dCommands.html" accesskey="n" rel="next">Obsolete @-Commands</a>, Previous: <a href="Command-List.html" accesskey="p" rel="prev">@-Command List</a>, Up: <a href="_0040_002dCommand-Details.html" accesskey="u" rel="up">@-Command Details</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p> </div> <hr> <span id="g_t_0040_002dCommand-Contexts"></span><h3 class="section">A.3 @-Command Contexts</h3> <span id="index-Contexts_002c-of-_0040_002dcommands"></span> <p>Here we describe approximately which @-commands can be used in which contexts. It is not exhaustive or meant to be a complete reference. Discrepancies between the information here and the <code>makeinfo</code> or TeX implementations are most likely to be resolved in favor of the implementation. </p> <p>By <em>general text</em> below, we mean anything except sectioning and other such outer-level document commands, such as <code>@section</code>, <code>@node</code>, and <code>@setfilename</code>. </p> <p><code>@c</code>, <code>@comment</code> and <code>@if ... @end if</code> conditional commands may appear anywhere (except the conditionals must still be on lines by themselves). <code>@caption</code> may only appear in <code>@float</code> but may contain general text. <code>@footnote</code> content likewise. </p> <p>@-commands with braces marking text (such as <code>@strong</code>, <code>@sc</code>, <code>@asis</code>) may contain raw formatter commands such as <code>@html</code> but no other block commands (other commands terminated by <code>@end</code>) and may not be split across paragraphs, but may otherwise contain general text. </p> <p>In addition to the block command restriction, on <code>@center</code>, <code>@exdent</code> and <code>@item</code> in <code>@table</code> lines, @-commands that makes only sense in a paragraph are not accepted, such as <code>@indent</code>. </p> <p>In addition to the above, sectioning commands cannot contain <code>@anchor</code>, <code>@footnote</code> or <code>@verb</code>. </p> <p>In addition to the above, remaining commands (<code>@node</code>, <code>@anchor</code>, <code>@printindex</code>, <code>@ref</code>, <code>@math</code>, <code>@cindex</code>, <code>@url</code>, <code>@image</code>, and so on) cannot contain cross-reference commands (<code>@ref</code>, <code>@xref</code>, <code>@pxref</code> and <code>@inforef</code>). In one last addition, <code>@shortcaption</code> may only appear inside <code>@float</code>. </p> <p>For precise and complete information, we suggest looking into the test suite in the sources, which exhaustively tries combinations. </p> </div> </body> </html>