/usr/share/doc/texinfo/html/New-Indices.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 | <html lang="en">
<head>
<title>New Indices - 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="Indices.html#Indices" title="Indices">
<link rel="prev" href="Combining-Indices.html#Combining-Indices" title="Combining Indices">
<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="New-Indices"></a>
<p>
Previous: <a rel="previous" accesskey="p" href="Combining-Indices.html#Combining-Indices">Combining Indices</a>,
Up: <a rel="up" accesskey="u" href="Indices.html#Indices">Indices</a>
<hr>
</div>
<h3 class="section">13.5 Defining New Indices</h3>
<p><a name="index-Defining-new-indices-642"></a><a name="index-Indices_002c-defining-new-643"></a><a name="index-New-index-defining-644"></a><a name="index-defindex-645"></a><a name="index-defcodeindex-646"></a>
In addition to the predefined indices, you may use the
<code>@defindex</code> and <code>@defcodeindex</code> commands to define new
indices. These commands create new indexing @-commands with which
you mark index entries. The <code>@defindex</code> command is used like
this:
<pre class="example"> @defindex <var>name</var>
</pre>
<p>The name of an index should be a two letter word, such as ‘<samp><span class="samp">au</span></samp>’.
For example:
<pre class="example"> @defindex au
</pre>
<p>This defines a new index, called the ‘<samp><span class="samp">au</span></samp>’ index. At the same
time, it creates a new indexing command, <code>@auindex</code>, that you
can use to make index entries. Use this new indexing command just as
you would use a predefined indexing command.
<p>For example, here is a section heading followed by a concept index
entry and two ‘<samp><span class="samp">au</span></samp>’ index entries.
<pre class="example"> @section Cognitive Semantics
@cindex kinesthetic image schemas
@auindex Johnson, Mark
@auindex Lakoff, George
</pre>
<p class="noindent">(Evidently, ‘<samp><span class="samp">au</span></samp>’ serves here as an abbreviation for “author”.)
<p>In general, Texinfo constructs the new indexing command by
concatenating the name of the index with ‘<samp><span class="samp">index</span></samp>’; thus, defining
an ‘<samp><span class="samp">xy</span></samp>’ index leads to the automatic creation of an
<code>@xyindex</code> command.
<p>Use the <code>@printindex</code> command to print the index, as you do with
the predefined indices. For example:
<pre class="example"> @node Author Index
@unnumbered Author Index
@printindex au
</pre>
<p>The <code>@defcodeindex</code> is like the <code>@defindex</code> command,
except that, in the printed output, it prints entries in an
<code>@code</code> font by default instead of a roman font.
<p>You should define new indices before the end-of-header line of a
Texinfo file, and (of course) before any <code>@synindex</code> or
<code>@syncodeindex</code> commands (see <a href="Texinfo-File-Header.html#Texinfo-File-Header">Texinfo File Header</a>).
</body></html>
|