/usr/share/doc/texinfo/html/alias.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 | <html lang="en">
<head>
<title>alias - 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="Defining-New-Texinfo-Commands.html#Defining-New-Texinfo-Commands" title="Defining New Texinfo Commands">
<link rel="prev" href="Macro-Details.html#Macro-Details" title="Macro Details">
<link rel="next" href="definfoenclose.html#definfoenclose" title="definfoenclose">
<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="alias"></a>
<p>
Next: <a rel="next" accesskey="n" href="definfoenclose.html#definfoenclose">definfoenclose</a>,
Previous: <a rel="previous" accesskey="p" href="Macro-Details.html#Macro-Details">Macro Details</a>,
Up: <a rel="up" accesskey="u" href="Defining-New-Texinfo-Commands.html#Defining-New-Texinfo-Commands">Defining New Texinfo Commands</a>
<hr>
</div>
<h3 class="section">19.4 ‘<samp><span class="samp">@alias </span><var>new</var><span class="samp">=</span><var>existing</var></samp>’</h3>
<p><a name="index-Aliases_002c-command-1090"></a><a name="index-Command-aliases-1091"></a><a name="index-alias-1092"></a>
The ‘<samp><span class="samp">@alias</span></samp>’ command defines a new command to be just like an
existing one. This is useful for defining additional markup names, thus
preserving semantic information in the input even though the output
result may be the same.
<p>Write the ‘<samp><span class="samp">@alias</span></samp>’ command on a line by itself, followed by the
new command name, an equals sign, and the existing command name.
Whitespace around the equals sign is ignored. Thus:
<pre class="example"> @alias <var>new</var> = <var>existing</var>
</pre>
<p>For example, if your document contains citations for both books and
some other media (movies, for example), you might like to define a
macro <code>@moviecite{}</code> that does the same thing as an ordinary
<code>@cite{}</code> but conveys the extra semantic information as well.
You'd do this as follows:
<pre class="example"> @alias moviecite = cite
</pre>
<p>Macros do not always have the same effect as aliases, due to vagaries
of argument parsing. Also, aliases are much simpler to define than
macros. So the command is not redundant. (It was also heavily used
in the Jargon File!)
<p>Aliases must not be recursive, directly or indirectly.
<p>It is not advisable to redefine any TeX primitive, plain, or
Texinfo command name as an alias. Unfortunately this is a very large
set of names, and the possible resulting errors are completely random.
</body></html>
|