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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
|
+-----------------------------------------------------------------------------+
| index |
+-----------------------------------------------------------------------------+
Abbreviation: ã|\ixã%
Parameters: ã|title textã%
Submarkup: ã|\subentry, \blindentry, \uspn, \bdpn, \itpnã%
ã|Description:ã%
The \index markup builds index entries which can be sorted and printed at
the end of a document. The \index markup has the format
\indexn{entry}
where "n" is the index number (1, 2, or 3), and "entry" is the index
entry. The page number you are on when the \index markup is inserted will
be printed with the "entry". You must use the \printindex markup to sort
and print the index. It comes at the end of the document. Refer to the
documentation of \printindex for details on this markup.
ã|Example:ã%
Consider this index example:
The files you create and change have a filemode of A.
This means that they are all kept in a collection of
files called your A-disk. The FILELIST command
displays a list of all
\index1{A-disk}
the files on your A-disk.
In the document, the following would print where the index markup occurred,
+-----------------------------------------------------------------------------+
| |
| The files you create and change have a filemode of A. This means |
| that they are all kept in a collection of files called your A-disk. The |
| FILELIST command displays a list of all the files on your A-disk. |
+-----------------------------------------------------------------------------+
If this occurred on page 32, the entry in the index printed with
\printindex1 would print as illustrated on the next page.
+-----------------------------------------------------------------------------+
| A-disk, 32 |
+-----------------------------------------------------------------------------+
ã|Notes:ã%
You cannot use \index within a \settabs or \halign.
ã|Lower Level or Sub entriesã%
If you want to record a subentry to a main index entry you use the
\subentry markup within the \index markup.
ã|Notes:ã%
The \subentry markup is only valid when used within \index.
ã|Example:ã%
If you had a main entry called "reader list" and you wanted sub entries for
"receiving a file" and "replacing a file" you could enter the \index markup
as illustrated here:
\sha{Receiving a File}
To receive a file, move the cursor to the line that
describes the file you want to receive.
\index1{reader list \subentry1{receiving a file}}
Then press PF9. A notice will appear on that line
telling you that the file has been received, . . .
\sha{Replacing or Renaming a File}
What happens if the file in your reader has the same file
label as one you already have on your disk?
There are two ways to handle this.
\lib\lil1
If you want the file in your reader to replace the file
\index1{reader list \subentry1{replacing a file}}
on your disk, type the command "receive / (replace".
\lil1
If you want to keep the file on your disk, then rename
the file in your reader with the command "receive / newname
\index1{reader list\subentry1{renaming a file}}
newtype" where "newname" is the new file name and
"newtype" is the new filetype.
\lie
This would produce the following paragraph in a document:
+-----------------------------------------------------------------------------+
| |
| Receiving a File |
| To receive a file, move the cursor to the line that describes the file |
| you want to receive. Then press PF9. A notice will appear on that line |
| telling you that the file has been received, ... |
| |
| Replacing or Renaming a File |
| What happens if the file in your reader has the same file label as one |
| you already have on your disk? There are two ways to handle this. |
| 1. If you want the file in your reader to replace the file on your disk, |
| type the command "receive / (replace". |
| 2. If you want to keep the file on your disk, then rename the file |
| in your reader with the command "receive / newname newtype" where |
| "newname" is the new file name and "newtype" is the new filetype. |
| |
+-----------------------------------------------------------------------------+
If list level #2 printed at the top of page 33, the index entries would look
like:
+-----------------------------------------------------------------------------+
| |
| reader list |
| receiving a file, 32 |
| renaming a file, 33 |
| replacing a file, 32 |
| |
+-----------------------------------------------------------------------------+
ã|Excluding Text from the Sortã%
There are occasions when you will want text to print in an indexed item,
but you do not want that text to be a part of the sorting process. For
example, you may want to index the title "Consumer Guides" including the
quotes, but you want it sorted with the C's and not sorted with the double
quote marks. Also, you probably would want to sort \par with the p's, and
not with the backslashes. Both can be accomplished using the \sortasmarkup
which can only be used within the \index markup.
ã|Example:ã%
Using the input,
Please get a copy of the article "Consumer Guides" and
\index1{"Consumer Guides"\sortas{Consumer Guides}}
refer to the illustration on page 5.
\par
Be sure to index the paragraph command "\\par"
\index1{\\par\sortas{par}}
somewhere in the document.
you would get the following two paragraphs in your document.
+-----------------------------------------------------------------------------+
| |
| Please get a copy of the article "Consumer Guide References" and refer |
| to the illustration on page 5. |
| |
| Be sure to index the paragraph command "\par" somewhere in the |
| document. |
| |
+-----------------------------------------------------------------------------+
The index entries would print like:
+-----------------------------------------------------------------------------+
| |
| "Consumer Guides", 45 |
| contour Maps, 23 |
| |
| \par, 45 |
| Paragraphs, long, 16 |
| |
+-----------------------------------------------------------------------------+
ã|Example:ã%
Prepositions in a subentry may not be part of the sort, but are to be
printed in the index. For example, to get the index to look like,
+-----------------------------------------------------------------------------+
| |
| vacations |
| on boats, 32 |
| at the Olympian, 21 |
| |
+-----------------------------------------------------------------------------+
you would use the \index, \subentry, and \sortas commands illustrated on the
next page.
Some people spend their vacations at older
hotels like the Olympian.
\index1{vacations \subentry1{at the
Olympian\sortas{Olympian}}}
Another popular vacation is travelling the
Pacific in a boat.
\ix1{vacations\subentry1{on
boats\sortas{boats}}}
ã|Example:ã%
As another example, "10 Downing Street" is typically sorted with the T's
and not prior to the 2's. This can also be accomplished using the \sortas
markup. For example, the Prime Minister's address mentioned earlier would
be entered as:
Taxi, please take me to 10 Downing Street.
\index1{10 Downing Street\sortas{ten Downing Street}}
ã|Highlighted Page Numbersã%
For those applications which require some of the page numbers to be
printed in bold, some in italics, and others underscored, there are three
markup available to do this. They are \boldpagenumber, \italicpagenumber,
and \underscorepagenumber. They are all used within the \index markup, and
indicate to TEXT1 that a page number other than the standard page number is
to be used.
We recommend that important references be noted in bold (\boldpage-
number). Fleeting references be printed with italics (\italicpagenumber).
And primary references be indicated by being underscored (\underscorepage-
number). Of course, you are free to use these three markup as you see
fit.
The bold page number will always come prior to a standard face reference
to the same page.
ã|Example:ã%
If you had an \boldpagenumber on page 43 and \index's on pages 42--44 for
"peace."
\index1{peace} % Located on page 42
\index1{peace} % Located on page 43
\index1{peace\bdpn} % Located on page 43
\index1{peace} % Located on page 44
the index printed with \printindex would look like:
+-----------------------------------------------------------------------------+
| peace 43, 42--44 |
+-----------------------------------------------------------------------------+
ã|Example:ã%
If you have an underscored page number and it falls in the same range as a
standard face entry, the underscored entry would follow the standard face
entry. For example, if you had a \underscorepagenumber on page 66 and
\index's on pages 66--72 for "nationalism",
\index1{nationalism\uspn} % On page 66
\index1{nationalism} % On page 66
\index1{nationalism} % On page 67
\index1{nationalism} % On page 72
the index sequence would print like:
+-----------------------------------------------------------------------------+
| Quick Programming Language 66--72, 66 |
+-----------------------------------------------------------------------------+
ã|Example:ã%
If you have an index reference in italics and it falls in the same range as
a standard face entry, the italics entry will not be printed. For example,
if you had an italics entry using \italicpagenumber on pages 45 and 56, and
you had standard face entries on pages 54--60 for "In Search of Excellence",
the printed index would look like:
+-----------------------------------------------------------------------------+
| |
| In Search of Excellence 45, 54--60 |
| |
+-----------------------------------------------------------------------------+
ã|Cross Referencesã%
Often it is desirable to have a cross reference to another index entry.
You can do this using the \blindentry markup within the \index markup. You
cannot use both \blindentry and \subentry within the same \index markup.
The \blindentry markup has the format,
\blindentry{blind entry}
where "blind entry" is the text you want associated with that index entry.
ã|Example:ã%
For example, to get an index entry to print like
+-----------------------------------------------------------------------------+
| |
| |
| Flow of control, see Control Structures |
+-----------------------------------------------------------------------------+
you would enter
\index1{Flow of control\blindentry{see Control
Structures}}
ã|Example:ã%
It is also possible to have a blind entry printed with an index entry, and
still have it indexed with page numbers. For example, if you were to enter
\index1{Label\uspn}
\index1{Label\blindentry{({\it see also} Case Label)}}
on page 78 you would get an index entry printed as:
+-----------------------------------------------------------------------------+
| Label, 78, (see also Case Label) |
+-----------------------------------------------------------------------------+
ã|Notes:ã%
If you have page numbers and a blind entry, then the blind entry will follow
the last page number as illustrated here.
ã|Multiple Indexesã%
You can have multiple indexes by changing the "1" in \index1 to "2" or
"3". For example,
\index1{entry in first index}
\index2{entry in second index}
\index3{entry in third index}
will generate one entry in each of three indexes. See \printindex for
instructions on how to print out each of the three indexes.
|
