/usr/share/doc/texinfo/html/HTML-Xref-Command-Expansion.html is in texinfo-doc-nonfree 4.13a-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 | <html lang="en">
<head>
<title>HTML Xref Command Expansion - GNU Texinfo 4.13</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Texinfo 4.13">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="HTML-Xref.html#HTML-Xref" title="HTML Xref">
<link rel="prev" href="HTML-Xref-Node-Name-Expansion.html#HTML-Xref-Node-Name-Expansion" title="HTML Xref Node Name Expansion">
<link rel="next" href="HTML-Xref-8_002dbit-Character-Expansion.html#HTML-Xref-8_002dbit-Character-Expansion" title="HTML Xref 8-bit Character Expansion">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual is for GNU Texinfo (version 4.13, 18 September 2008),
a documentation system that can produce both online information and a
printed manual from a single source.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
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.2 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 are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="HTML-Xref-Command-Expansion"></a>
<p>
Next: <a rel="next" accesskey="n" href="HTML-Xref-8_002dbit-Character-Expansion.html#HTML-Xref-8_002dbit-Character-Expansion">HTML Xref 8-bit Character Expansion</a>,
Previous: <a rel="previous" accesskey="p" href="HTML-Xref-Node-Name-Expansion.html#HTML-Xref-Node-Name-Expansion">HTML Xref Node Name Expansion</a>,
Up: <a rel="up" accesskey="u" href="HTML-Xref.html#HTML-Xref">HTML Xref</a>
<hr>
</div>
<h4 class="subsection">22.4.3 HTML Cross-reference Command Expansion</h4>
<p><a name="index-HTML-cross_002dreference-command-expansion-1379"></a>
In standard Texinfo, node names may not contain @-commands.
<samp><span class="command">makeinfo</span></samp> has an option <samp><span class="option">--commands-in-node-names</span></samp>
which partially supports it (see <a href="Invoking-makeinfo.html#Invoking-makeinfo">Invoking makeinfo</a>), but it is not
robust and not recommended.
<p>Thus, <samp><span class="command">makeinfo</span></samp> does not fully implement this part of the
HTML cross-reference algorithm, but it is documented here for the sake
of completeness.
<p>First, comments are removed.
<p>Next, any <code>@value</code> commands (see <a href="set-value.html#set-value">set value</a>) and macro invocations
(see <a href="Invoking-Macros.html#Invoking-Macros">Invoking Macros</a>) are fully expanded.
<p>Then, for the following commands, the command name and braces are removed,
the text of the argument is recursively transformed:
<pre class="example"> @asis @b @cite @code @command @dfn @dmn @dotless
@emph @env @file @indicateurl @kbd @key
@samp @sc @slanted @strong @t @var @w
</pre>
<p class="noindent">For <code>@sc</code>, any letters are capitalized.
<p>The following commands are replaced by constant text, as shown. If
any of these commands have non-empty arguments, as in
<code>@TeX{bad}</code>, it is an error, and the result is unspecified.
`(space)' means a space character, `(nothing)' means the empty string,
etc. The notation `U+<var>xxxx</var>' means Unicode code point <var>xxxx</var>
(in hex, as usual). There are further transformations of many of
these expansions for the final file or target name, such as space
characters to ‘<samp><span class="samp">-</span></samp>’, etc., according to the other rules.
<p><table summary=""><tr align="left"><td valign="top" width="30%"><code>@(newline)</code> </td><td valign="top" width="50%">(space)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@(space)</code> </td><td valign="top" width="50%">(space)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@(tab)</code> </td><td valign="top" width="50%">(space)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@!</code> </td><td valign="top" width="50%">‘<samp><span class="samp">!</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@*</code> </td><td valign="top" width="50%">(space)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@-</code> </td><td valign="top" width="50%">(nothing)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@.</code> </td><td valign="top" width="50%">‘<samp><span class="samp">.</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@:</code> </td><td valign="top" width="50%">(nothing)
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@?</code> </td><td valign="top" width="50%">‘<samp><span class="samp">?</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@@</code> </td><td valign="top" width="50%">‘<samp><span class="samp">@</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@{</code> </td><td valign="top" width="50%">‘<samp><span class="samp">{</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@}</code> </td><td valign="top" width="50%">‘<samp><span class="samp">}</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@LaTeX</code> </td><td valign="top" width="50%">‘<samp><span class="samp">LaTeX</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@TeX</code> </td><td valign="top" width="50%">‘<samp><span class="samp">TeX</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@arrow</code> </td><td valign="top" width="50%">U+2192
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@bullet</code> </td><td valign="top" width="50%">U+2022
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@comma</code> </td><td valign="top" width="50%">‘<samp><span class="samp">,</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@copyright</code> </td><td valign="top" width="50%">U+00A9
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@dots</code> </td><td valign="top" width="50%">U+2026
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@enddots</code> </td><td valign="top" width="50%">‘<samp><span class="samp">...</span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@equiv</code> </td><td valign="top" width="50%">U+2261
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@error</code> </td><td valign="top" width="50%">‘<samp><span class="samp">error--></span></samp>’
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@euro</code> </td><td valign="top" width="50%">U+20AC
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@exclamdown</code> </td><td valign="top" width="50%">U+00A1
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@expansion</code> </td><td valign="top" width="50%">U+2192
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@geq</code> </td><td valign="top" width="50%">U+2265
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@leq</code> </td><td valign="top" width="50%">U+2264
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@minus</code> </td><td valign="top" width="50%">U+2212
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@ordf</code> </td><td valign="top" width="50%">U+00AA
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@ordm</code> </td><td valign="top" width="50%">U+00BA
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@point</code> </td><td valign="top" width="50%">U+2605
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@pounds</code> </td><td valign="top" width="50%">U+00A3
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@print</code> </td><td valign="top" width="50%">U+22A3
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@questiondown</code> </td><td valign="top" width="50%">U+00BF
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@registeredsymbol</code> </td><td valign="top" width="50%">U+00AE
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@result</code> </td><td valign="top" width="50%">U+21D2
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@textdegree</code> </td><td valign="top" width="50%">U+00B0
<br></td></tr><tr align="left"><td valign="top" width="30%"><code>@tie</code> </td><td valign="top" width="50%">(space)
<br></td></tr></table>
<p>Quotation mark commands are likewise replaced by their Unicode values
(see <a href="Inserting-Quotation-Marks.html#Inserting-Quotation-Marks">Inserting Quotation Marks</a>).
<p>An <code>@acronym</code> or <code>@abbr</code> command is replaced by the first
argument, followed by the second argument in parentheses, if present.
See <a href="acronym.html#acronym">acronym</a>.
<p>An <code>@email</code> command is replaced by the <var>text</var> argument if
present, else the address. See <a href="email.html#email">email</a>.
<p>An <code>@image</code> command is replaced by the filename (first)
argument. See <a href="Images.html#Images">Images</a>.
<p>A <code>@verb</code> command is replaced by its transformed argument.
See <a href="verb.html#verb">verb</a>.
<p>Any other command is an error, and the result is unspecified.
</body></html>
|