/usr/share/doc/texinfo/html/Command-Contexts.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 5.2, 26 September 2013),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013 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 the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled "GNU Free Documentation
License".

(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual.  Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 5.2: Command Contexts</title>

<meta name="description" content="GNU Texinfo 5.2: Command Contexts">
<meta name="keywords" content="GNU Texinfo 5.2: Command Contexts">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Command-List.html#Command-List" rel="up" title="Command List">
<link href="Tips.html#Tips" rel="next" title="Tips">
<link href="Command-Syntax.html#Command-Syntax" rel="previous" title="Command Syntax">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Command-Contexts"></a>
<div class="header">
<p>
Previous: <a href="Command-Syntax.html#Command-Syntax" accesskey="p" rel="previous">Command Syntax</a>, Up: <a href="Command-List.html#Command-List" accesskey="u" rel="up">Command List</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="g_t_0040_002dCommand-Contexts"></a>
<h3 class="section">A.2 @-Command Contexts</h3>

<a name="index-Contexts_002c-of-_0040_002dcommands"></a>

<p>Here we describe approximately which @-commands can be used in which
contexts.  It merely gives the general idea and 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
extensive test suite in the sources, which exhaustively try
combinations.
</p>




</body>
</html>
texinfo-doc-nonfree 5.2.0-1 / usr / share / doc / texinfo / html / Command-Contexts.html
