aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2014-12-23 20:42:30 +0200
committerEli Zaretskii2014-12-23 20:42:30 +0200
commit20cfd2480d75679da33958ea258143a313911712 (patch)
treec9bb1c63a4328f7e12105267001d54a7717cf588
parent14c3739040a60bfe6ed0a3ce0aa90a4758155e28 (diff)
downloademacs-20cfd2480d75679da33958ea258143a313911712.tar.gz
emacs-20cfd2480d75679da33958ea258143a313911712.zip
Improve indexing on the chapter/section/subsection levels.
doc/lispref/windows.texi (Recombining Windows): Index subject of sections. doc/lispref/variables.texi (Variables with Restricted Values) (Generalized Variables): Index subject of sections. doc/lispref/text.texi (Buffer Contents, Examining Properties) (Changing Properties, Property Search, Substitution): Index subject of sections. doc/lispref/syntax.texi (Motion and Syntax, Parsing Expressions) (Motion via Parsing, Position Parse, Control Parsing): Index subject of sections. doc/lispref/strings.texi (Predicates for Strings, Creating Strings) (Modifying Strings, Text Comparison): Index subject of sections. doc/lispref/searching.texi (Syntax of Regexps, Regexp Special) (Regexp Functions, Regexp Functions): Index subject of sections. doc/lispref/processes.texi (Subprocess Creation, Process Information): Index subject of sections. doc/lispref/positions.texi (Screen Lines): Index subject of sections. doc/lispref/nonascii.texi (Scanning Charsets, Specifying Coding Systems): Index subject of sections. doc/lispref/minibuf.texi (Text from Minibuffer, Object from Minibuffer) (Multiple Queries, Minibuffer Contents): Index subject of sections. doc/lispref/markers.texi (Predicates on Markers, Creating Markers) (Information from Markers, Moving Markers): Index subject of sections. doc/lispref/macros.texi (Defining Macros, Problems with Macros): Index subject of sections. doc/lispref/loading.texi (Loading Non-ASCII, Where Defined): Index subject of sections. doc/lispref/lists.texi (List-related Predicates, List Variables, Setcar) (Setcdr, Plist Access): Index subject of sections. doc/lispref/keymaps.texi (Controlling Active Maps, Scanning Keymaps) (Modifying Menus): Index subject of sections. doc/lispref/help.texi (Accessing Documentation, Help Functions): Index subject of sections. doc/lispref/hash.texi (Hash Access): Index subject of sections. doc/lispref/functions.texi (Core Advising Primitives) (Advising Named Functions, Porting old advices): Index subject of sections. doc/lispref/frames.texi (Creating Frames, Initial Parameters) (Position Parameters, Buffer Parameters, Minibuffers and Frames) (Pop-Up Menus, Drag and Drop): Index subject of sections. doc/lispref/files.texi (Visiting Functions, Kinds of Files) (Unique File Names): Index subject of sections. doc/lispref/display.texi (Refresh Screen, Echo Area Customization) (Warning Variables, Warning Options, Delayed Warnings) (Temporary Displays, Managing Overlays, Overlay Properties) (Finding Overlays, Size of Displayed Text, Defining Faces) (Attribute Functions, Displaying Faces, Face Remapping) (Basic Faces, Font Lookup, Fontsets, Replacing Specs) (Defining Images, Showing Images): Index subject of sections. doc/lispref/debugging.texi (Debugging, Explicit Debug) (Invoking the Debugger, Excess Open, Excess Close): Index subject of sections. doc/lispref/customize.texi (Defining New Types, Applying Customizations) (Custom Themes): Index subject of sections. doc/lispref/control.texi (Sequencing, Combining Conditions) (Processing of Errors, Cleanups): Index subject of sections. doc/lispref/compile.texi (Eval During Compile): Index subject of sections. doc/lispref/commands.texi (Using Interactive, Distinguish Interactive) (Command Loop Info, Classifying Events, Event Mod) (Invoking the Input Method): Index subject of sections. doc/lispref/buffers.texi (Buffer List, Buffer Gap): Index subject of sections. doc/lispref/backups.texi (Making Backups, Numbered Backups, Backup Names) (Reverting): Index subject of sections. doc/lispref/abbrevs.texi (Abbrev Tables, Defining Abbrevs, Abbrev Files) (Abbrev Expansion, Standard Abbrev Tables, Abbrev Properties) (Abbrev Table Properties): Index subject of sections. doc/lispref/os.texi (Time of Day, Time Conversion, Time Parsing) (Time Calculations, Idle Timers): Index subject of sections.
-rw-r--r--doc/lispref/ChangeLog101
-rw-r--r--doc/lispref/abbrevs.texi9
-rw-r--r--doc/lispref/backups.texi4
-rw-r--r--doc/lispref/buffers.texi2
-rw-r--r--doc/lispref/commands.texi9
-rw-r--r--doc/lispref/compile.texi1
-rw-r--r--doc/lispref/control.texi5
-rw-r--r--doc/lispref/customize.texi4
-rw-r--r--doc/lispref/debugging.texi6
-rw-r--r--doc/lispref/display.texi27
-rw-r--r--doc/lispref/files.texi6
-rw-r--r--doc/lispref/frames.texi8
-rw-r--r--doc/lispref/functions.texi3
-rw-r--r--doc/lispref/hash.texi2
-rw-r--r--doc/lispref/help.texi2
-rw-r--r--doc/lispref/keymaps.texi4
-rw-r--r--doc/lispref/lists.texi9
-rw-r--r--doc/lispref/loading.texi4
-rw-r--r--doc/lispref/macros.texi3
-rw-r--r--doc/lispref/markers.texi7
-rw-r--r--doc/lispref/minibuf.texi5
-rw-r--r--doc/lispref/nonascii.texi5
-rw-r--r--doc/lispref/os.texi9
-rw-r--r--doc/lispref/positions.texi1
-rw-r--r--doc/lispref/processes.texi3
-rw-r--r--doc/lispref/searching.texi5
-rw-r--r--doc/lispref/strings.texi7
-rw-r--r--doc/lispref/syntax.texi7
-rw-r--r--doc/lispref/text.texi9
-rw-r--r--doc/lispref/variables.texi3
-rw-r--r--doc/lispref/windows.texi2
31 files changed, 272 insertions, 0 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 12554dd2321..5bf23bc895d 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,104 @@
12014-12-23 Eli Zaretskii <eliz@gnu.org>
2
3 * windows.texi (Recombining Windows): Index subject of sections.
4
5 * variables.texi (Variables with Restricted Values)
6 (Generalized Variables): Index subject of sections.
7
8 * text.texi (Buffer Contents, Examining Properties)
9 (Changing Properties, Property Search, Substitution): Index
10 subject of sections.
11
12 * syntax.texi (Motion and Syntax, Parsing Expressions)
13 (Motion via Parsing, Position Parse, Control Parsing): Index
14 subject of sections.
15
16 * strings.texi (Predicates for Strings, Creating Strings)
17 (Modifying Strings, Text Comparison): Index subject of sections.
18
19 * searching.texi (Syntax of Regexps, Regexp Special)
20 (Regexp Functions, Regexp Functions): Index subject of sections.
21
22 * processes.texi (Subprocess Creation, Process Information): Index
23 subject of sections.
24
25 * positions.texi (Screen Lines): Index subject of sections.
26
27 * nonascii.texi (Scanning Charsets, Specifying Coding Systems):
28 Index subject of sections.
29
30 * minibuf.texi (Text from Minibuffer, Object from Minibuffer)
31 (Multiple Queries, Minibuffer Contents): Index subject of
32 sections.
33
34 * markers.texi (Predicates on Markers, Creating Markers)
35 (Information from Markers, Moving Markers): Index subject of
36 sections.
37
38 * macros.texi (Defining Macros, Problems with Macros): Index
39 subject of sections.
40
41 * loading.texi (Loading Non-ASCII, Where Defined): Index subject
42 of sections.
43
44 * lists.texi (List-related Predicates, List Variables, Setcar)
45 (Setcdr, Plist Access): Index subject of sections.
46
47 * keymaps.texi (Controlling Active Maps, Scanning Keymaps)
48 (Modifying Menus): Index subject of sections.
49
50 * help.texi (Accessing Documentation, Help Functions): Index
51 subject of sections.
52
53 * hash.texi (Hash Access): Index subject of sections.
54
55 * functions.texi (Core Advising Primitives)
56 (Advising Named Functions, Porting old advices): Index subject of
57 sections.
58
59 * frames.texi (Creating Frames, Initial Parameters)
60 (Position Parameters, Buffer Parameters, Minibuffers and Frames)
61 (Pop-Up Menus, Drag and Drop): Index subject of sections.
62
63 * files.texi (Visiting Functions, Kinds of Files)
64 (Unique File Names): Index subject of sections.
65
66 * display.texi (Refresh Screen, Echo Area Customization)
67 (Warning Variables, Warning Options, Delayed Warnings)
68 (Temporary Displays, Managing Overlays, Overlay Properties)
69 (Finding Overlays, Size of Displayed Text, Defining Faces)
70 (Attribute Functions, Displaying Faces, Face Remapping)
71 (Basic Faces, Font Lookup, Fontsets, Replacing Specs)
72 (Defining Images, Showing Images): Index subject of sections.
73
74 * debugging.texi (Debugging, Explicit Debug)
75 (Invoking the Debugger, Excess Open, Excess Close): Index subject
76 of sections.
77
78 * customize.texi (Defining New Types, Applying Customizations)
79 (Custom Themes): Index subject of sections.
80
81 * control.texi (Sequencing, Combining Conditions)
82 (Processing of Errors, Cleanups): Index subject of sections.
83
84 * compile.texi (Eval During Compile): Index subject of sections.
85
86 * commands.texi (Using Interactive, Distinguish Interactive)
87 (Command Loop Info, Classifying Events, Event Mod)
88 (Invoking the Input Method): Index subject of sections.
89
90 * buffers.texi (Buffer List, Buffer Gap): Index subject of sections.
91
92 * backups.texi (Making Backups, Numbered Backups, Backup Names)
93 (Reverting): Index subject of sections.
94
95 * abbrevs.texi (Abbrev Tables, Defining Abbrevs, Abbrev Files)
96 (Abbrev Expansion, Standard Abbrev Tables, Abbrev Properties)
97 (Abbrev Table Properties): Index subject of sections.
98
99 * os.texi (Time of Day, Time Conversion, Time Parsing)
100 (Time Calculations, Idle Timers): Index subject of sections.
101
12014-12-18 Stefan Monnier <monnier@iro.umontreal.ca> 1022014-12-18 Stefan Monnier <monnier@iro.umontreal.ca>
2 103
3 * display.texi (Forcing Redisplay): Remove references to 104 * display.texi (Forcing Redisplay): Remove references to
diff --git a/doc/lispref/abbrevs.texi b/doc/lispref/abbrevs.texi
index 73a3f5f1e05..c00af616240 100644
--- a/doc/lispref/abbrevs.texi
+++ b/doc/lispref/abbrevs.texi
@@ -59,6 +59,7 @@ expanded in the buffer. For the user-level commands for abbrevs, see
59 59
60@node Abbrev Tables 60@node Abbrev Tables
61@section Abbrev Tables 61@section Abbrev Tables
62@cindex abbrev tables
62 63
63 This section describes how to create and manipulate abbrev tables. 64 This section describes how to create and manipulate abbrev tables.
64 65
@@ -126,6 +127,7 @@ to add these to @var{name} separately.)
126 127
127@node Defining Abbrevs 128@node Defining Abbrevs
128@section Defining Abbrevs 129@section Defining Abbrevs
130@cindex defining abbrevs
129 131
130 @code{define-abbrev} is the low-level basic function for defining an 132 @code{define-abbrev} is the low-level basic function for defining an
131abbrev in an abbrev table. 133abbrev in an abbrev table.
@@ -181,6 +183,7 @@ callers.
181 183
182@node Abbrev Files 184@node Abbrev Files
183@section Saving Abbrevs in Files 185@section Saving Abbrevs in Files
186@cindex save abbrevs in files
184 187
185 A file of saved abbrev definitions is actually a file of Lisp code. 188 A file of saved abbrev definitions is actually a file of Lisp code.
186The abbrevs are saved in the form of a Lisp program to define the same 189The abbrevs are saved in the form of a Lisp program to define the same
@@ -232,6 +235,9 @@ define the same abbrevs. If @var{filename} is @code{nil} or omitted,
232 235
233@node Abbrev Expansion 236@node Abbrev Expansion
234@section Looking Up and Expanding Abbreviations 237@section Looking Up and Expanding Abbreviations
238@cindex looking up abbrevs
239@cindex expanding abbrevs
240@cindex abbrevs, looking up and expanding
235 241
236 Abbrevs are usually expanded by certain interactive commands, 242 Abbrevs are usually expanded by certain interactive commands,
237including @code{self-insert-command}. This section describes the 243including @code{self-insert-command}. This section describes the
@@ -367,6 +373,7 @@ definitions of @code{local-abbrev-table} and @code{text-mode-abbrev-table}.
367 373
368@node Standard Abbrev Tables 374@node Standard Abbrev Tables
369@section Standard Abbrev Tables 375@section Standard Abbrev Tables
376@cindex standard abbrev tables
370 377
371 Here we list the variables that hold the abbrev tables for the 378 Here we list the variables that hold the abbrev tables for the
372preloaded major modes of Emacs. 379preloaded major modes of Emacs.
@@ -409,6 +416,7 @@ Properties}.
409 416
410@node Abbrev Properties 417@node Abbrev Properties
411@section Abbrev Properties 418@section Abbrev Properties
419@cindex abbrev properties
412 420
413Abbrevs have properties, some of which influence the way they work. 421Abbrevs have properties, some of which influence the way they work.
414You can provide them as arguments to @code{define-abbrev}, and 422You can provide them as arguments to @code{define-abbrev}, and
@@ -449,6 +457,7 @@ modifies the capitalization of the expansion.
449 457
450@node Abbrev Table Properties 458@node Abbrev Table Properties
451@section Abbrev Table Properties 459@section Abbrev Table Properties
460@cindex abbrev table properties
452 461
453Like abbrevs, abbrev tables have properties, some of which influence 462Like abbrevs, abbrev tables have properties, some of which influence
454the way they work. You can provide them as arguments to 463the way they work. You can provide them as arguments to
diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi
index 63f8f227c84..ca30f3e17ca 100644
--- a/doc/lispref/backups.texi
+++ b/doc/lispref/backups.texi
@@ -50,6 +50,7 @@ don't want them any more, or Emacs can delete them automatically.
50 50
51@node Making Backups 51@node Making Backups
52@subsection Making Backup Files 52@subsection Making Backup Files
53@cindex making backup files
53 54
54@defun backup-buffer 55@defun backup-buffer
55 This function makes a backup of the file visited by the current 56 This function makes a backup of the file visited by the current
@@ -238,6 +239,7 @@ The default is 200.
238 239
239@node Numbered Backups 240@node Numbered Backups
240@subsection Making and Deleting Numbered Backup Files 241@subsection Making and Deleting Numbered Backup Files
242@cindex numbered backups
241 243
242 If a file's name is @file{foo}, the names of its numbered backup 244 If a file's name is @file{foo}, the names of its numbered backup
243versions are @file{foo.~@var{v}~}, for various integers @var{v}, like 245versions are @file{foo.~@var{v}~}, for various integers @var{v}, like
@@ -299,6 +301,7 @@ file. The default is@tie{}2.
299 301
300@node Backup Names 302@node Backup Names
301@subsection Naming Backup Files 303@subsection Naming Backup Files
304@cindex naming backup files
302 305
303 The functions in this section are documented mainly because you can 306 The functions in this section are documented mainly because you can
304customize the naming conventions for backup files by redefining them. 307customize the naming conventions for backup files by redefining them.
@@ -668,6 +671,7 @@ not initialize @code{auto-save-list-file-name}.
668 671
669@node Reverting 672@node Reverting
670@section Reverting 673@section Reverting
674@cindex reverting buffers
671 675
672 If you have made extensive changes to a file and then change your mind 676 If you have made extensive changes to a file and then change your mind
673about them, you can get rid of them by reading in the previous version 677about them, you can get rid of them by reading in the previous version
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 5ac2d6786e8..7c4fb876135 100644
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -762,6 +762,7 @@ signal an error if the current buffer is read-only.
762@node Buffer List 762@node Buffer List
763@section The Buffer List 763@section The Buffer List
764@cindex buffer list 764@cindex buffer list
765@cindex listing all buffers
765 766
766 The @dfn{buffer list} is a list of all live buffers. The order of the 767 The @dfn{buffer list} is a list of all live buffers. The order of the
767buffers in this list is based primarily on how recently each buffer has 768buffers in this list is based primarily on how recently each buffer has
@@ -1215,6 +1216,7 @@ in the text it is swapped with will not interfere with auto-saving.
1215 1216
1216@node Buffer Gap 1217@node Buffer Gap
1217@section The Buffer Gap 1218@section The Buffer Gap
1219@cindex buffer gap
1218 1220
1219 Emacs buffers are implemented using an invisible @dfn{gap} to make 1221 Emacs buffers are implemented using an invisible @dfn{gap} to make
1220insertion and deletion faster. Insertion works by filling in part of 1222insertion and deletion faster. Insertion works by filling in part of
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 5e22941c037..45654cf5e3f 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -144,6 +144,7 @@ Lisp code.
144@node Using Interactive 144@node Using Interactive
145@subsection Using @code{interactive} 145@subsection Using @code{interactive}
146@cindex arguments, interactive entry 146@cindex arguments, interactive entry
147@cindex interactive spec, using
147 148
148 This section describes how to write the @code{interactive} form that 149 This section describes how to write the @code{interactive} form that
149makes a Lisp function an interactively-callable command, and how to 150makes a Lisp function an interactively-callable command, and how to
@@ -744,6 +745,8 @@ part of the prompt.
744 745
745@node Distinguish Interactive 746@node Distinguish Interactive
746@section Distinguish Interactive Calls 747@section Distinguish Interactive Calls
748@cindex distinguish interactive calls
749@cindex is this call interactive
747 750
748 Sometimes a command should display additional visual feedback (such 751 Sometimes a command should display additional visual feedback (such
749as an informative message in the echo area) for interactive calls 752as an informative message in the echo area) for interactive calls
@@ -832,6 +835,7 @@ Here is another example that contrasts direct and indirect calls to
832 835
833@node Command Loop Info 836@node Command Loop Info
834@section Information from the Command Loop 837@section Information from the Command Loop
838@cindex command loop variables
835 839
836The editor command loop sets several Lisp variables to keep status 840The editor command loop sets several Lisp variables to keep status
837records for itself and for commands that are run. With the exception of 841records for itself and for commands that are run. With the exception of
@@ -1855,6 +1859,7 @@ bind it to the @code{signal usr1} event sequence:
1855@node Classifying Events 1859@node Classifying Events
1856@subsection Classifying Events 1860@subsection Classifying Events
1857@cindex event type 1861@cindex event type
1862@cindex classifying events
1858 1863
1859 Every event has an @dfn{event type}, which classifies the event for 1864 Every event has an @dfn{event type}, which classifies the event for
1860key binding purposes. For a keyboard event, the event type equals the 1865key binding purposes. For a keyboard event, the event type equals the
@@ -2580,6 +2585,9 @@ then continues to wait for a valid input character, or keyboard-quit.
2580 2585
2581@node Event Mod 2586@node Event Mod
2582@subsection Modifying and Translating Input Events 2587@subsection Modifying and Translating Input Events
2588@cindex modifiers of events
2589@cindex translating input events
2590@cindex event translation
2583 2591
2584 Emacs modifies every event it reads according to 2592 Emacs modifies every event it reads according to
2585@code{extra-keyboard-modifiers}, then translates it through 2593@code{extra-keyboard-modifiers}, then translates it through
@@ -2661,6 +2669,7 @@ at the level of @code{read-key-sequence}.
2661 2669
2662@node Invoking the Input Method 2670@node Invoking the Input Method
2663@subsection Invoking the Input Method 2671@subsection Invoking the Input Method
2672@cindex invoking input method
2664 2673
2665 The event-reading functions invoke the current input method, if any 2674 The event-reading functions invoke the current input method, if any
2666(@pxref{Input Methods}). If the value of @code{input-method-function} 2675(@pxref{Input Methods}). If the value of @code{input-method-function}
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi
index fe492df1d94..cb6cba99c11 100644
--- a/doc/lispref/compile.texi
+++ b/doc/lispref/compile.texi
@@ -347,6 +347,7 @@ it does nothing. It always returns @var{function}.
347 347
348@node Eval During Compile 348@node Eval During Compile
349@section Evaluation During Compilation 349@section Evaluation During Compilation
350@cindex eval during compilation
350 351
351 These features permit you to write code to be evaluated during 352 These features permit you to write code to be evaluated during
352compilation of a program. 353compilation of a program.
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 800e174d3fc..62c73dd583b 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -44,6 +44,8 @@ structure constructs (@pxref{Macros}).
44 44
45@node Sequencing 45@node Sequencing
46@section Sequencing 46@section Sequencing
47@cindex sequencing
48@cindex sequential execution
47 49
48 Evaluating forms in the order they appear is the most common way 50 Evaluating forms in the order they appear is the most common way
49control passes from one form to another. In some contexts, such as in a 51control passes from one form to another. In some contexts, such as in a
@@ -401,6 +403,7 @@ the variable @code{x}.
401 403
402@node Combining Conditions 404@node Combining Conditions
403@section Constructs for Combining Conditions 405@section Constructs for Combining Conditions
406@cindex combining conditions
404 407
405 This section describes three constructs that are often used together 408 This section describes three constructs that are often used together
406with @code{if} and @code{cond} to express complicated conditions. The 409with @code{if} and @code{cond} to express complicated conditions. The
@@ -958,6 +961,7 @@ concept of continuable errors.
958 961
959@node Processing of Errors 962@node Processing of Errors
960@subsubsection How Emacs Processes Errors 963@subsubsection How Emacs Processes Errors
964@cindex processing of errors
961 965
962When an error is signaled, @code{signal} searches for an active 966When an error is signaled, @code{signal} searches for an active
963@dfn{handler} for the error. A handler is a sequence of Lisp 967@dfn{handler} for the error. A handler is a sequence of Lisp
@@ -1363,6 +1367,7 @@ and their conditions.
1363 1367
1364@node Cleanups 1368@node Cleanups
1365@subsection Cleaning Up from Nonlocal Exits 1369@subsection Cleaning Up from Nonlocal Exits
1370@cindex nonlocal exits, cleaning up
1366 1371
1367 The @code{unwind-protect} construct is essential whenever you 1372 The @code{unwind-protect} construct is essential whenever you
1368temporarily put a data structure in an inconsistent state; it permits 1373temporarily put a data structure in an inconsistent state; it permits
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index 0c6497fb4ef..cdf599b8f16 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -1227,6 +1227,8 @@ arguments, which will be used when creating the @code{radio-button} or
1227 1227
1228@node Defining New Types 1228@node Defining New Types
1229@subsection Defining New Types 1229@subsection Defining New Types
1230@cindex customization types, define new
1231@cindex define new customization types
1230 1232
1231In the previous sections we have described how to construct elaborate 1233In the previous sections we have described how to construct elaborate
1232type specifications for @code{defcustom}. In some cases you may want 1234type specifications for @code{defcustom}. In some cases you may want
@@ -1296,6 +1298,7 @@ its @code{:type} argument only when needed.
1296 1298
1297@node Applying Customizations 1299@node Applying Customizations
1298@section Applying Customizations 1300@section Applying Customizations
1301@cindex applying customizations
1299 1302
1300The following functions are responsible for installing the user's 1303The following functions are responsible for installing the user's
1301customization settings for variables and faces, respectively. When 1304customization settings for variables and faces, respectively. When
@@ -1353,6 +1356,7 @@ evaluated. @var{comment} is a string describing the customization.
1353@node Custom Themes 1356@node Custom Themes
1354@section Custom Themes 1357@section Custom Themes
1355 1358
1359@cindex custom themes
1356 @dfn{Custom themes} are collections of settings that can be enabled 1360 @dfn{Custom themes} are collections of settings that can be enabled
1357or disabled as a unit. @xref{Custom Themes,,, emacs, The GNU Emacs 1361or disabled as a unit. @xref{Custom Themes,,, emacs, The GNU Emacs
1358Manual}. Each Custom theme is defined by an Emacs Lisp source file, 1362Manual}. Each Custom theme is defined by an Emacs Lisp source file,
diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index 66f12a022cb..0b3c47f4339 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -5,6 +5,7 @@
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Debugging 6@node Debugging
7@chapter Debugging Lisp Programs 7@chapter Debugging Lisp Programs
8@cindex debugging lisp programs
8 9
9 There are several ways to find and investigate problems in an Emacs 10 There are several ways to find and investigate problems in an Emacs
10Lisp program. 11Lisp program.
@@ -284,6 +285,8 @@ not currently set up to break on entry.
284 285
285@node Explicit Debug 286@node Explicit Debug
286@subsection Explicit Entry to the Debugger 287@subsection Explicit Entry to the Debugger
288@cindex debugger, explicit entry
289@cindex force entry to debugger
287 290
288 You can cause the debugger to be called at a certain point in your 291 You can cause the debugger to be called at a certain point in your
289program by writing the expression @code{(debug)} at that point. To do 292program by writing the expression @code{(debug)} at that point. To do
@@ -456,6 +459,7 @@ Toggle the display of local variables of the current stack frame.
456 459
457@node Invoking the Debugger 460@node Invoking the Debugger
458@subsection Invoking the Debugger 461@subsection Invoking the Debugger
462@cindex invoking lisp debugger
459 463
460 Here we describe in full detail the function @code{debug} that is used 464 Here we describe in full detail the function @code{debug} that is used
461to invoke the debugger. 465to invoke the debugger.
@@ -707,6 +711,7 @@ find the mismatch.)
707 711
708@node Excess Open 712@node Excess Open
709@subsection Excess Open Parentheses 713@subsection Excess Open Parentheses
714@cindex excess open parentheses
710 715
711 The first step is to find the defun that is unbalanced. If there is 716 The first step is to find the defun that is unbalanced. If there is
712an excess open parenthesis, the way to do this is to go to the end of 717an excess open parenthesis, the way to do this is to go to the end of
@@ -741,6 +746,7 @@ anything.
741 746
742@node Excess Close 747@node Excess Close
743@subsection Excess Close Parentheses 748@subsection Excess Close Parentheses
749@cindex excess close parentheses
744 750
745 To deal with an excess close parenthesis, first go to the beginning 751 To deal with an excess close parenthesis, first go to the beginning
746of the file, then type @kbd{C-u -1 C-M-u} to find the end of the first 752of the file, then type @kbd{C-u -1 C-M-u} to find the end of the first
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index c4753ecbb2a..5d3202e67ef 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -39,6 +39,8 @@ that Emacs presents to the user.
39 39
40@node Refresh Screen 40@node Refresh Screen
41@section Refreshing the Screen 41@section Refreshing the Screen
42@cindex refresh the screen
43@cindex screen refresh
42 44
43 The function @code{redraw-frame} clears and redisplays the entire 45 The function @code{redraw-frame} clears and redisplays the entire
44contents of a given frame (@pxref{Frames}). This is useful if the 46contents of a given frame (@pxref{Frames}). This is useful if the
@@ -509,6 +511,7 @@ are logged that share a common prefix ending in @samp{...}.
509 511
510@node Echo Area Customization 512@node Echo Area Customization
511@subsection Echo Area Customization 513@subsection Echo Area Customization
514@cindex echo area customization
512 515
513 These variables control details of how the echo area works. 516 These variables control details of how the echo area works.
514 517
@@ -636,6 +639,7 @@ specify a specific warning type.
636 639
637@node Warning Variables 640@node Warning Variables
638@subsection Warning Variables 641@subsection Warning Variables
642@cindex warning variables
639 643
640 Programs can customize how their warnings appear by binding 644 Programs can customize how their warnings appear by binding
641the variables described in this section. 645the variables described in this section.
@@ -713,6 +717,7 @@ all.
713 717
714@node Warning Options 718@node Warning Options
715@subsection Warning Options 719@subsection Warning Options
720@cindex warning options
716 721
717 These variables are used by users to control what happens 722 These variables are used by users to control what happens
718when a Lisp program reports a warning. 723when a Lisp program reports a warning.
@@ -746,6 +751,7 @@ that warning is not logged.
746 751
747@node Delayed Warnings 752@node Delayed Warnings
748@subsection Delayed Warnings 753@subsection Delayed Warnings
754@cindex delayed warnings
749 755
750Sometimes, you may wish to avoid showing a warning while a command is 756Sometimes, you may wish to avoid showing a warning while a command is
751running, and only show it only after the end of the command. You can 757running, and only show it only after the end of the command. You can
@@ -1069,6 +1075,8 @@ You can use a display table to substitute other text for the ellipsis
1069 1075
1070@node Temporary Displays 1076@node Temporary Displays
1071@section Temporary Displays 1077@section Temporary Displays
1078@cindex temporary display
1079@cindex temporary buffer display
1072 1080
1073 Temporary displays are used by Lisp programs to put output into a 1081 Temporary displays are used by Lisp programs to put output into a
1074buffer and then present it to the user for perusal rather than for 1082buffer and then present it to the user for perusal rather than for
@@ -1280,6 +1288,8 @@ inside the overlay or outside, and likewise for the end of the overlay.
1280 1288
1281@node Managing Overlays 1289@node Managing Overlays
1282@subsection Managing Overlays 1290@subsection Managing Overlays
1291@cindex managing overlays
1292@cindex overlays, managing
1283 1293
1284 This section describes the functions to create, delete and move 1294 This section describes the functions to create, delete and move
1285overlays, and to examine their contents. Overlay changes are not 1295overlays, and to examine their contents. Overlay changes are not
@@ -1440,6 +1450,7 @@ faster if you do @code{(overlay-recenter (point-max))} first.
1440 1450
1441@node Overlay Properties 1451@node Overlay Properties
1442@subsection Overlay Properties 1452@subsection Overlay Properties
1453@cindex overlay properties
1443 1454
1444 Overlay properties are like text properties in that the properties that 1455 Overlay properties are like text properties in that the properties that
1445alter how a character is displayed can come from either source. But in 1456alter how a character is displayed can come from either source. But in
@@ -1692,6 +1703,8 @@ Properties}.
1692 1703
1693@node Finding Overlays 1704@node Finding Overlays
1694@subsection Searching for Overlays 1705@subsection Searching for Overlays
1706@cindex searching for overlays
1707@cindex overlays, searching for
1695 1708
1696@defun overlays-at pos &optional sorted 1709@defun overlays-at pos &optional sorted
1697This function returns a list of all the overlays that cover the character at 1710This function returns a list of all the overlays that cover the character at
@@ -1759,6 +1772,8 @@ changes.
1759 1772
1760@node Size of Displayed Text 1773@node Size of Displayed Text
1761@section Size of Displayed Text 1774@section Size of Displayed Text
1775@cindex size of text on display
1776@cindex character width on display
1762 1777
1763Since not all characters have the same width, these functions let you 1778Since not all characters have the same width, these functions let you
1764check the width of a character. @xref{Primitive Indent}, and 1779check the width of a character. @xref{Primitive Indent}, and
@@ -2249,6 +2264,7 @@ suitable for use with @code{:stipple} (see above). It returns
2249 2264
2250@node Defining Faces 2265@node Defining Faces
2251@subsection Defining Faces 2266@subsection Defining Faces
2267@cindex defining faces
2252 2268
2253@cindex face spec 2269@cindex face spec
2254 The usual way to define a face is through the @code{defface} macro. 2270 The usual way to define a face is through the @code{defface} macro.
@@ -2423,6 +2439,7 @@ Any other value of @var{spec-type} is reserved for internal use.
2423 2439
2424@node Attribute Functions 2440@node Attribute Functions
2425@subsection Face Attribute Functions 2441@subsection Face Attribute Functions
2442@cindex face attributes, access and modification
2426 2443
2427 This section describes functions for directly accessing and 2444 This section describes functions for directly accessing and
2428modifying the attributes of a named face. 2445modifying the attributes of a named face.
@@ -2624,6 +2641,8 @@ a non-@code{nil} @code{:inverse-video} attribute.
2624 2641
2625@node Displaying Faces 2642@node Displaying Faces
2626@subsection Displaying Faces 2643@subsection Displaying Faces
2644@cindex displaying faces
2645@cindex face merging
2627 2646
2628 When Emacs displays a given piece of text, the visual appearance of 2647 When Emacs displays a given piece of text, the visual appearance of
2629the text may be determined by faces drawn from different sources. If 2648the text may be determined by faces drawn from different sources. If
@@ -2679,6 +2698,7 @@ at the next level of face merging.
2679 2698
2680@node Face Remapping 2699@node Face Remapping
2681@subsection Face Remapping 2700@subsection Face Remapping
2701@cindex face remapping
2682 2702
2683 The variable @code{face-remapping-alist} is used for buffer-local or 2703 The variable @code{face-remapping-alist} is used for buffer-local or
2684global changes in the appearance of a face. For instance, it is used 2704global changes in the appearance of a face. For instance, it is used
@@ -2876,6 +2896,7 @@ usually assign faces to around 400 to 600 characters at each call.
2876 2896
2877@node Basic Faces 2897@node Basic Faces
2878@subsection Basic Faces 2898@subsection Basic Faces
2899@cindex basic faces
2879 2900
2880If your Emacs Lisp program needs to assign some faces to text, it is 2901If your Emacs Lisp program needs to assign some faces to text, it is
2881often a good idea to use certain existing faces or inherit from them, 2902often a good idea to use certain existing faces or inherit from them,
@@ -3042,6 +3063,8 @@ nominal heights and widths would suggest.
3042 3063
3043@node Font Lookup 3064@node Font Lookup
3044@subsection Looking Up Fonts 3065@subsection Looking Up Fonts
3066@cindex font lookup
3067@cindex looking up fonts
3045 3068
3046@defun x-list-fonts name &optional reference-face frame maximum width 3069@defun x-list-fonts name &optional reference-face frame maximum width
3047This function returns a list of available font names that match 3070This function returns a list of available font names that match
@@ -3099,6 +3122,7 @@ encoding of the font.
3099 3122
3100@node Fontsets 3123@node Fontsets
3101@subsection Fontsets 3124@subsection Fontsets
3125@cindex fontset
3102 3126
3103 A @dfn{fontset} is a list of fonts, each assigned to a range of 3127 A @dfn{fontset} is a list of fonts, each assigned to a range of
3104character codes. An individual font cannot display the whole range of 3128character codes. An individual font cannot display the whole range of
@@ -4032,6 +4056,7 @@ display specifications and what they mean.
4032 4056
4033@node Replacing Specs 4057@node Replacing Specs
4034@subsection Display Specs That Replace The Text 4058@subsection Display Specs That Replace The Text
4059@cindex replacing display specs
4035 4060
4036 Some kinds of display specifications specify something to display 4061 Some kinds of display specifications specify something to display
4037instead of the text that has the property. These are called 4062instead of the text that has the property. These are called
@@ -4908,6 +4933,7 @@ Supports the @code{:index} property. @xref{Multi-Frame Images}.
4908 4933
4909@node Defining Images 4934@node Defining Images
4910@subsection Defining Images 4935@subsection Defining Images
4936@cindex define image
4911 4937
4912 The functions @code{create-image}, @code{defimage} and 4938 The functions @code{create-image}, @code{defimage} and
4913@code{find-image} provide convenient ways to create image descriptors. 4939@code{find-image} provide convenient ways to create image descriptors.
@@ -5035,6 +5061,7 @@ Here is an example of using @code{image-load-path-for-library}:
5035 5061
5036@node Showing Images 5062@node Showing Images
5037@subsection Showing Images 5063@subsection Showing Images
5064@cindex show image
5038 5065
5039 You can use an image descriptor by setting up the @code{display} 5066 You can use an image descriptor by setting up the @code{display}
5040property yourself, but it is easier to use the functions in this 5067property yourself, but it is easier to use the functions in this
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index b071c6a8f35..895ae426a5f 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -81,6 +81,8 @@ computer program, however, it is good to keep the distinction in mind.
81 81
82@node Visiting Functions 82@node Visiting Functions
83@subsection Functions for Visiting Files 83@subsection Functions for Visiting Files
84@cindex visiting files, functions for
85@cindex how to visit files
84 86
85 This section describes the functions normally used to visit files. 87 This section describes the functions normally used to visit files.
86For historical reasons, these functions have names starting with 88For historical reasons, these functions have names starting with
@@ -948,6 +950,8 @@ Unix. These conventions are also followed by @code{file-attributes}
948 950
949@node Kinds of Files 951@node Kinds of Files
950@subsection Distinguishing Kinds of Files 952@subsection Distinguishing Kinds of Files
953@cindex file classification
954@cindex classification of file types
951 955
952 This section describes how to distinguish various kinds of files, such 956 This section describes how to distinguish various kinds of files, such
953as directories, symbolic links, and ordinary files. 957as directories, symbolic links, and ordinary files.
@@ -2285,6 +2289,8 @@ through the immediately preceding @samp{/}).
2285 2289
2286@node Unique File Names 2290@node Unique File Names
2287@subsection Generating Unique File Names 2291@subsection Generating Unique File Names
2292@cindex unique file names
2293@cindex temporary files
2288 2294
2289 Some programs need to write temporary files. Here is the usual way to 2295 Some programs need to write temporary files. Here is the usual way to
2290construct a name for such a file: 2296construct a name for such a file:
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index d5617ed3cfd..df8efee6e0c 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -106,6 +106,7 @@ for @code{framep} above.
106 106
107@node Creating Frames 107@node Creating Frames
108@section Creating Frames 108@section Creating Frames
109@cindex frame creation
109 110
110To create a new frame, call the function @code{make-frame}. 111To create a new frame, call the function @code{make-frame}.
111 112
@@ -484,6 +485,7 @@ parameter values to frames that will be created henceforth.
484 485
485@node Initial Parameters 486@node Initial Parameters
486@subsection Initial Frame Parameters 487@subsection Initial Frame Parameters
488@cindex parameters of initial frame
487 489
488You can specify the parameters for the initial startup frame by 490You can specify the parameters for the initial startup frame by
489setting @code{initial-frame-alist} in your init file (@pxref{Init 491setting @code{initial-frame-alist} in your init file (@pxref{Init
@@ -623,6 +625,7 @@ named, this parameter will be @code{nil}.
623@node Position Parameters 625@node Position Parameters
624@subsubsection Position Parameters 626@subsubsection Position Parameters
625@cindex window position on display 627@cindex window position on display
628@cindex frame position
626 629
627 Position parameters' values are normally measured in pixels, but on 630 Position parameters' values are normally measured in pixels, but on
628text terminals they count characters or lines instead. 631text terminals they count characters or lines instead.
@@ -839,6 +842,8 @@ integer). @xref{Line Height}, for more information.
839 842
840@node Buffer Parameters 843@node Buffer Parameters
841@subsubsection Buffer Parameters 844@subsubsection Buffer Parameters
845@cindex frame, which buffers to display
846@cindex buffers to display on frame
842 847
843 These frame parameters, meaningful on all kinds of terminals, deal 848 These frame parameters, meaningful on all kinds of terminals, deal
844with which buffers have been, or should, be displayed in the frame. 849with which buffers have been, or should, be displayed in the frame.
@@ -1526,6 +1531,7 @@ is used whenever that frame is selected. If the frame has a minibuffer,
1526you can get it with @code{minibuffer-window} (@pxref{Definition of 1531you can get it with @code{minibuffer-window} (@pxref{Definition of
1527minibuffer-window}). 1532minibuffer-window}).
1528 1533
1534@cindex frame without a minibuffer
1529However, you can also create a frame with no minibuffer. Such a frame 1535However, you can also create a frame with no minibuffer. Such a frame
1530must use the minibuffer window of some other frame. When you create the 1536must use the minibuffer window of some other frame. When you create the
1531frame, you can explicitly specify the minibuffer window to use (in some 1537frame, you can explicitly specify the minibuffer window to use (in some
@@ -1933,6 +1939,7 @@ allows to know if the pointer has been hidden.
1933 1939
1934@node Pop-Up Menus 1940@node Pop-Up Menus
1935@section Pop-Up Menus 1941@section Pop-Up Menus
1942@cindex menus, popup
1936 1943
1937 A Lisp program can pop up a menu so that the user can choose an 1944 A Lisp program can pop up a menu so that the user can choose an
1938alternative with the mouse. On a text terminal, if the mouse is not 1945alternative with the mouse. On a text terminal, if the mouse is not
@@ -2197,6 +2204,7 @@ clipboard as empty.
2197 2204
2198@node Drag and Drop 2205@node Drag and Drop
2199@section Drag and Drop 2206@section Drag and Drop
2207@cindex drag and drop
2200 2208
2201@vindex x-dnd-test-function 2209@vindex x-dnd-test-function
2202@vindex x-dnd-known-types 2210@vindex x-dnd-known-types
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index f551a6c749d..d9477d2c0b1 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -1215,6 +1215,7 @@ ways to do it. The added function is also called an @emph{advice}.
1215 1215
1216@node Core Advising Primitives 1216@node Core Advising Primitives
1217@subsection Primitives to manipulate advices 1217@subsection Primitives to manipulate advices
1218@cindex advice, add and remove
1218 1219
1219@defmac add-function where place function &optional props 1220@defmac add-function where place function &optional props
1220This macro is the handy way to add the advice @var{function} to the function 1221This macro is the handy way to add the advice @var{function} to the function
@@ -1313,6 +1314,7 @@ the current prefix argument.
1313 1314
1314@node Advising Named Functions 1315@node Advising Named Functions
1315@subsection Advising Named Functions 1316@subsection Advising Named Functions
1317@cindex advising named functions
1316 1318
1317A common use of advice is for named functions and macros. 1319A common use of advice is for named functions and macros.
1318You could just use @code{add-function} as in: 1320You could just use @code{add-function} as in:
@@ -1498,6 +1500,7 @@ More specifically, the composition of the two functions behaves like:
1498 1500
1499@node Porting old advices 1501@node Porting old advices
1500@subsection Adapting code using the old defadvice 1502@subsection Adapting code using the old defadvice
1503@cindex old advices, porting
1501 1504
1502A lot of code uses the old @code{defadvice} mechanism, which is largely made 1505A lot of code uses the old @code{defadvice} mechanism, which is largely made
1503obsolete by the new @code{advice-add}, whose implementation and semantics is 1506obsolete by the new @code{advice-add}, whose implementation and semantics is
diff --git a/doc/lispref/hash.texi b/doc/lispref/hash.texi
index 536777add72..323a2edca12 100644
--- a/doc/lispref/hash.texi
+++ b/doc/lispref/hash.texi
@@ -188,6 +188,8 @@ Such objects may be added to the hash table after it is created.
188 188
189@node Hash Access 189@node Hash Access
190@section Hash Table Access 190@section Hash Table Access
191@cindex accessing hash tables
192@cindex hash table access
191 193
192 This section describes the functions for accessing and storing 194 This section describes the functions for accessing and storing
193associations in a hash table. In general, any Lisp object can be used 195associations in a hash table. In general, any Lisp object can be used
diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi
index 20fb0e651f9..2e3b51e28e2 100644
--- a/doc/lispref/help.texi
+++ b/doc/lispref/help.texi
@@ -90,6 +90,7 @@ hyperlinks in the @file{*Help*} buffer.)
90 90
91@node Accessing Documentation 91@node Accessing Documentation
92@section Access to Documentation Strings 92@section Access to Documentation Strings
93@cindex accessing documentation strings
93 94
94@defun documentation-property symbol property &optional verbatim 95@defun documentation-property symbol property &optional verbatim
95This function returns the documentation string recorded in 96This function returns the documentation string recorded in
@@ -507,6 +508,7 @@ non-@code{nil}, the return value is always a vector.
507 508
508@node Help Functions 509@node Help Functions
509@section Help Functions 510@section Help Functions
511@cindex help functions
510 512
511 Emacs provides a variety of built-in help functions, all accessible to 513 Emacs provides a variety of built-in help functions, all accessible to
512the user as subcommands of the prefix @kbd{C-h}. For more information 514the user as subcommands of the prefix @kbd{C-h}. For more information
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 7cc2b393456..d4299520510 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -782,6 +782,7 @@ Lookup}.
782 782
783@node Controlling Active Maps 783@node Controlling Active Maps
784@section Controlling the Active Keymaps 784@section Controlling the Active Keymaps
785@cindex active keymap, controlling
785 786
786@defvar global-map 787@defvar global-map
787This variable contains the default global keymap that maps Emacs 788This variable contains the default global keymap that maps Emacs
@@ -1825,6 +1826,8 @@ local map.
1825 1826
1826@node Scanning Keymaps 1827@node Scanning Keymaps
1827@section Scanning Keymaps 1828@section Scanning Keymaps
1829@cindex scanning keymaps
1830@cindex keymaps, scanning
1828 1831
1829 This section describes functions used to scan all the current keymaps 1832 This section describes functions used to scan all the current keymaps
1830for the sake of printing help information. 1833for the sake of printing help information.
@@ -2794,6 +2797,7 @@ function keys.
2794 2797
2795@node Modifying Menus 2798@node Modifying Menus
2796@subsection Modifying Menus 2799@subsection Modifying Menus
2800@cindex menu modification
2797 2801
2798 When you insert a new item in an existing menu, you probably want to 2802 When you insert a new item in an existing menu, you probably want to
2799put it in a particular place among the menu's existing items. If you 2803put it in a particular place among the menu's existing items. If you
diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi
index cde7d9ce44c..2e7b7384ae8 100644
--- a/doc/lispref/lists.texi
+++ b/doc/lispref/lists.texi
@@ -84,6 +84,8 @@ structure made out of cons cells as a @dfn{list structure}.
84 84
85@node List-related Predicates 85@node List-related Predicates
86@section Predicates on Lists 86@section Predicates on Lists
87@cindex predicates for lists
88@cindex list predicates
87 89
88 The following predicates test whether a Lisp object is an atom, 90 The following predicates test whether a Lisp object is an atom,
89whether it is a cons cell or is a list, or whether it is the 91whether it is a cons cell or is a list, or whether it is the
@@ -681,6 +683,8 @@ Some examples:
681 683
682@node List Variables 684@node List Variables
683@section Modifying List Variables 685@section Modifying List Variables
686@cindex modify a list
687@cindex list modification
684 688
685 These functions, and one macro, provide convenient ways 689 These functions, and one macro, provide convenient ways
686to modify a list which is stored in a variable. 690to modify a list which is stored in a variable.
@@ -837,6 +841,8 @@ new @sc{car} or @sc{cdr}.
837 841
838@node Setcar 842@node Setcar
839@subsection Altering List Elements with @code{setcar} 843@subsection Altering List Elements with @code{setcar}
844@cindex replace list element
845@cindex list, replace element
840 846
841 Changing the @sc{car} of a cons cell is done with @code{setcar}. When 847 Changing the @sc{car} of a cons cell is done with @code{setcar}. When
842used on a list, @code{setcar} replaces one element of a list with a 848used on a list, @code{setcar} replaces one element of a list with a
@@ -942,6 +948,7 @@ x2: |
942 948
943@node Setcdr 949@node Setcdr
944@subsection Altering the CDR of a List 950@subsection Altering the CDR of a List
951@cindex replace part of list
945 952
946 The lowest-level primitive for modifying a @sc{cdr} is @code{setcdr}: 953 The lowest-level primitive for modifying a @sc{cdr} is @code{setcdr}:
947 954
@@ -1898,6 +1905,8 @@ and later discarded; this is not possible with a property list.
1898 1905
1899@node Plist Access 1906@node Plist Access
1900@subsection Property Lists Outside Symbols 1907@subsection Property Lists Outside Symbols
1908@cindex plist access
1909@cindex accessing plist properties
1901 1910
1902 The following functions can be used to manipulate property lists. 1911 The following functions can be used to manipulate property lists.
1903They all compare property names using @code{eq}. 1912They all compare property names using @code{eq}.
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi
index a07c2e8a792..a0393c957d4 100644
--- a/doc/lispref/loading.texi
+++ b/doc/lispref/loading.texi
@@ -419,6 +419,8 @@ the shadowed files as a string.
419 419
420@node Loading Non-ASCII 420@node Loading Non-ASCII
421@section Loading Non-@acronym{ASCII} Characters 421@section Loading Non-@acronym{ASCII} Characters
422@cindex loading, and non-ASCII characters
423@cindex non-ASCII characters in loaded files
422 424
423 When Emacs Lisp programs contain string constants with non-@acronym{ASCII} 425 When Emacs Lisp programs contain string constants with non-@acronym{ASCII}
424characters, these can be represented within Emacs either as unibyte 426characters, these can be represented within Emacs either as unibyte
@@ -907,6 +909,8 @@ with a call to @code{provide}. The order of the elements in the
907 909
908@node Where Defined 910@node Where Defined
909@section Which File Defined a Certain Symbol 911@section Which File Defined a Certain Symbol
912@cindex symbol, where defined
913@cindex where was a symbol defined
910 914
911@defun symbol-file symbol &optional type 915@defun symbol-file symbol &optional type
912This function returns the name of the file that defined @var{symbol}. 916This function returns the name of the file that defined @var{symbol}.
diff --git a/doc/lispref/macros.texi b/doc/lispref/macros.texi
index 9be12fa431b..8a4741c2ff1 100644
--- a/doc/lispref/macros.texi
+++ b/doc/lispref/macros.texi
@@ -194,6 +194,8 @@ During Compile}).
194 194
195@node Defining Macros 195@node Defining Macros
196@section Defining Macros 196@section Defining Macros
197@cindex defining macros
198@cindex macro, how to define
197 199
198 A Lisp macro object is a list whose @sc{car} is @code{macro}, and 200 A Lisp macro object is a list whose @sc{car} is @code{macro}, and
199whose @sc{cdr} is a function. Expansion of the macro works 201whose @sc{cdr} is a function. Expansion of the macro works
@@ -253,6 +255,7 @@ Form}.
253 255
254@node Problems with Macros 256@node Problems with Macros
255@section Common Problems Using Macros 257@section Common Problems Using Macros
258@cindex macro caveats
256 259
257 Macro expansion can have counterintuitive consequences. This 260 Macro expansion can have counterintuitive consequences. This
258section describes some important consequences that can lead to 261section describes some important consequences that can lead to
diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi
index 51b87ab1e5b..5902a3a836f 100644
--- a/doc/lispref/markers.texi
+++ b/doc/lispref/markers.texi
@@ -118,6 +118,8 @@ m1
118 118
119@node Predicates on Markers 119@node Predicates on Markers
120@section Predicates on Markers 120@section Predicates on Markers
121@cindex predicates for markers
122@cindex markers, predicates for
121 123
122 You can test an object to see whether it is a marker, or whether it is 124 You can test an object to see whether it is a marker, or whether it is
123either an integer or a marker. The latter test is useful in connection 125either an integer or a marker. The latter test is useful in connection
@@ -141,6 +143,8 @@ integer or floating point) or a marker, @code{nil} otherwise.
141 143
142@node Creating Markers 144@node Creating Markers
143@section Functions that Create Markers 145@section Functions that Create Markers
146@cindex creating markers
147@cindex marker creation
144 148
145 When you create a new marker, you can make it point nowhere, or point 149 When you create a new marker, you can make it point nowhere, or point
146to the present position of point, or to the beginning or end of the 150to the present position of point, or to the beginning or end of the
@@ -269,6 +273,7 @@ if they both point nowhere.
269 273
270@node Information from Markers 274@node Information from Markers
271@section Information from Markers 275@section Information from Markers
276@cindex marker information
272 277
273 This section describes the functions for accessing the components of a 278 This section describes the functions for accessing the components of a
274marker object. 279marker object.
@@ -342,6 +347,8 @@ specify the insertion type, create them with insertion type
342 347
343@node Moving Markers 348@node Moving Markers
344@section Moving Marker Positions 349@section Moving Marker Positions
350@cindex moving markers
351@cindex marker, how to move position
345 352
346 This section describes how to change the position of an existing 353 This section describes how to change the position of an existing
347marker. When you do this, be sure you know whether the marker is used 354marker. When you do this, be sure you know whether the marker is used
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index 4a94f41d732..cf36953098f 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -107,6 +107,7 @@ password hiding, etc.) are available in batch mode.
107 107
108@node Text from Minibuffer 108@node Text from Minibuffer
109@section Reading Text Strings with the Minibuffer 109@section Reading Text Strings with the Minibuffer
110@cindex minibuffer input, reading text strings
110 111
111 The most basic primitive for minibuffer input is 112 The most basic primitive for minibuffer input is
112@code{read-from-minibuffer}, which can be used to read either a string 113@code{read-from-minibuffer}, which can be used to read either a string
@@ -390,6 +391,7 @@ following bindings, in addition to those of @code{minibuffer-local-map}:
390 391
391@node Object from Minibuffer 392@node Object from Minibuffer
392@section Reading Lisp Objects with the Minibuffer 393@section Reading Lisp Objects with the Minibuffer
394@cindex minibuffer input, reading lisp objects
393 395
394 This section describes functions for reading Lisp objects with the 396 This section describes functions for reading Lisp objects with the
395minibuffer. 397minibuffer.
@@ -2021,6 +2023,7 @@ Do you really want to remove everything? (yes or no)
2021 2023
2022@node Multiple Queries 2024@node Multiple Queries
2023@section Asking Multiple Y-or-N Questions 2025@section Asking Multiple Y-or-N Questions
2026@cindex multiple yes-or-no questions
2024 2027
2025 When you have a series of similar questions to ask, such as ``Do you 2028 When you have a series of similar questions to ask, such as ``Do you
2026want to save this buffer'' for each buffer in turn, you should use 2029want to save this buffer'' for each buffer in turn, you should use
@@ -2238,6 +2241,8 @@ active minibuffer window.
2238 2241
2239@node Minibuffer Contents 2242@node Minibuffer Contents
2240@section Minibuffer Contents 2243@section Minibuffer Contents
2244@cindex access minibuffer contents
2245@cindex minibuffer contents, accessing
2241 2246
2242 These functions access the minibuffer prompt and contents. 2247 These functions access the minibuffer prompt and contents.
2243 2248
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index d5bfacca976..d5fabe71b07 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -757,6 +757,8 @@ of them is @code{nil}, it defaults to the first or last codepoint of
757 757
758@node Scanning Charsets 758@node Scanning Charsets
759@section Scanning for Character Sets 759@section Scanning for Character Sets
760@cindex scanning for character sets
761@cindex character set, searching
760 762
761 Sometimes it is useful to find out which character set a particular 763 Sometimes it is useful to find out which character set a particular
762character belongs to. One use for this is in determining which coding 764character belongs to. One use for this is in determining which coding
@@ -1594,6 +1596,9 @@ contents (as it usually does), it should examine the contents of
1594 1596
1595@node Specifying Coding Systems 1597@node Specifying Coding Systems
1596@subsection Specifying a Coding System for One Operation 1598@subsection Specifying a Coding System for One Operation
1599@cindex specify coding system
1600@cindex force coding system for operation
1601@cindex coding system for operation
1597 1602
1598 You can specify the coding system for a specific operation by binding 1603 You can specify the coding system for a specific operation by binding
1599the variables @code{coding-system-for-read} and/or 1604the variables @code{coding-system-for-read} and/or
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 3b63e08676c..88aed7a8bf3 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1198,6 +1198,7 @@ return value is @code{nil}.
1198 1198
1199@node Time of Day 1199@node Time of Day
1200@section Time of Day 1200@section Time of Day
1201@cindex time of day
1201 1202
1202 This section explains how to determine the current time and time 1203 This section explains how to determine the current time and time
1203zone. 1204zone.
@@ -1305,6 +1306,7 @@ time zone.
1305@node Time Conversion 1306@node Time Conversion
1306@section Time Conversion 1307@section Time Conversion
1307@cindex calendrical information 1308@cindex calendrical information
1309@cindex time conversion
1308 1310
1309 These functions convert time values (lists of two to four integers, 1311 These functions convert time values (lists of two to four integers,
1310as explained in the previous section) into calendrical information and 1312as explained in the previous section) into calendrical information and
@@ -1399,6 +1401,9 @@ on others, years as early as 1901 do work.
1399 1401
1400@node Time Parsing 1402@node Time Parsing
1401@section Parsing and Formatting Times 1403@section Parsing and Formatting Times
1404@cindex time parsing
1405@cindex time formatting
1406@cindex formatting time values
1402 1407
1403 These functions convert time values to text in a string, and vice versa. 1408 These functions convert time values to text in a string, and vice versa.
1404Time values are lists of two to four integers (@pxref{Time of Day}). 1409Time values are lists of two to four integers (@pxref{Time of Day}).
@@ -1631,6 +1636,9 @@ interactively, it prints the duration in the echo area.
1631 1636
1632@node Time Calculations 1637@node Time Calculations
1633@section Time Calculations 1638@section Time Calculations
1639@cindex time calculations
1640@cindex comparing time values
1641@cindex calendrical computations
1634 1642
1635 These functions perform calendrical computations using time values 1643 These functions perform calendrical computations using time values
1636(the kind of list that @code{current-time} returns). 1644(the kind of list that @code{current-time} returns).
@@ -1811,6 +1819,7 @@ cause anything special to happen.
1811 1819
1812@node Idle Timers 1820@node Idle Timers
1813@section Idle Timers 1821@section Idle Timers
1822@cindex idle timers
1814 1823
1815 Here is how to set up a timer that runs when Emacs is idle for a 1824 Here is how to set up a timer that runs when Emacs is idle for a
1816certain length of time. Aside from how to set them up, idle timers 1825certain length of time. Aside from how to set them up, idle timers
diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index fee36fa833d..b8608cc1197 100644
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -465,6 +465,7 @@ beginning or end of a line.
465 465
466@node Screen Lines 466@node Screen Lines
467@subsection Motion by Screen Lines 467@subsection Motion by Screen Lines
468@cindex screen lines, moving by
468 469
469 The line functions in the previous section count text lines, delimited 470 The line functions in the previous section count text lines, delimited
470only by newline characters. By contrast, these functions count screen 471only by newline characters. By contrast, these functions count screen
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index c91afdffdeb..798f2116623 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -63,6 +63,8 @@ Processes}.
63 63
64@node Subprocess Creation 64@node Subprocess Creation
65@section Functions that Create Subprocesses 65@section Functions that Create Subprocesses
66@cindex create subprocess
67@cindex process creation
66 68
67 There are three primitives that create a new subprocess in which to run 69 There are three primitives that create a new subprocess in which to run
68a program. One of them, @code{start-process}, creates an asynchronous 70a program. One of them, @code{start-process}, creates an asynchronous
@@ -734,6 +736,7 @@ happen sooner or later).
734 736
735@node Process Information 737@node Process Information
736@section Process Information 738@section Process Information
739@cindex process information
737 740
738 Several functions return information about processes. 741 Several functions return information about processes.
739 742
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index 992ad001fe7..19c515f3ca2 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -257,6 +257,8 @@ it easier to verify even very complex regexps.
257 257
258@node Syntax of Regexps 258@node Syntax of Regexps
259@subsection Syntax of Regular Expressions 259@subsection Syntax of Regular Expressions
260@cindex regexp syntax
261@cindex syntax of regular expressions
260 262
261 Regular expressions have a syntax in which a few characters are 263 Regular expressions have a syntax in which a few characters are
262special constructs and the rest are @dfn{ordinary}. An ordinary 264special constructs and the rest are @dfn{ordinary}. An ordinary
@@ -294,6 +296,7 @@ need to use one of the special regular expression constructs.
294 296
295@node Regexp Special 297@node Regexp Special
296@subsubsection Special Characters in Regular Expressions 298@subsubsection Special Characters in Regular Expressions
299@cindex regexp, special characters in
297 300
298 Here is a list of the characters that are special in a regular 301 Here is a list of the characters that are special in a regular
299expression. 302expression.
@@ -894,6 +897,7 @@ beyond the minimum needed to end a sentence.
894 897
895 These functions operate on regular expressions. 898 These functions operate on regular expressions.
896 899
900@cindex quote special characters in regexp
897@defun regexp-quote string 901@defun regexp-quote string
898This function returns a regular expression whose only exact match is 902This function returns a regular expression whose only exact match is
899@var{string}. Using this regular expression in @code{looking-at} will 903@var{string}. Using this regular expression in @code{looking-at} will
@@ -924,6 +928,7 @@ whitespace:
924@end example 928@end example
925@end defun 929@end defun
926 930
931@cindex optimize regexp
927@defun regexp-opt strings &optional paren 932@defun regexp-opt strings &optional paren
928This function returns an efficient regular expression that will match 933This function returns an efficient regular expression that will match
929any of the strings in the list @var{strings}. This is useful when you 934any of the strings in the list @var{strings}. This is useful when you
diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index e6b00f06f79..0fd7fd1ef3f 100644
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -92,6 +92,8 @@ representations and to encode and decode character codes.
92 92
93@node Predicates for Strings 93@node Predicates for Strings
94@section Predicates for Strings 94@section Predicates for Strings
95@cindex predicates for strings
96@cindex string predicates
95 97
96For more information about general sequence and array predicates, 98For more information about general sequence and array predicates,
97see @ref{Sequences Arrays Vectors}, and @ref{Arrays}. 99see @ref{Sequences Arrays Vectors}, and @ref{Arrays}.
@@ -113,6 +115,8 @@ character (i.e., an integer), @code{nil} otherwise.
113 115
114@node Creating Strings 116@node Creating Strings
115@section Creating Strings 117@section Creating Strings
118@cindex creating strings
119@cindex string creation
116 120
117 The following functions create strings, either from scratch, or by 121 The following functions create strings, either from scratch, or by
118putting strings together, or by taking them apart. 122putting strings together, or by taking them apart.
@@ -367,6 +371,8 @@ usual value is @w{@code{"[ \f\t\n\r\v]+"}}.
367 371
368@node Modifying Strings 372@node Modifying Strings
369@section Modifying Strings 373@section Modifying Strings
374@cindex modifying strings
375@cindex string modification
370 376
371 The most basic way to alter the contents of an existing string is with 377 The most basic way to alter the contents of an existing string is with
372@code{aset} (@pxref{Array Functions}). @code{(aset @var{string} 378@code{aset} (@pxref{Array Functions}). @code{(aset @var{string}
@@ -400,6 +406,7 @@ zeros. It may also change @var{string}'s length.
400@node Text Comparison 406@node Text Comparison
401@section Comparison of Characters and Strings 407@section Comparison of Characters and Strings
402@cindex string equality 408@cindex string equality
409@cindex text comparison
403 410
404@defun char-equal character1 character2 411@defun char-equal character1 character2
405This function returns @code{t} if the arguments represent the same 412This function returns @code{t} if the arguments represent the same
diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi
index 25e6089491e..33577e74157 100644
--- a/doc/lispref/syntax.texi
+++ b/doc/lispref/syntax.texi
@@ -592,6 +592,8 @@ in turn, repeatedly, until they all return @code{nil}.
592 592
593@node Motion and Syntax 593@node Motion and Syntax
594@section Motion and Syntax 594@section Motion and Syntax
595@cindex moving across syntax classes
596@cindex skipping characters of certain syntax
595 597
596 This section describes functions for moving across characters that 598 This section describes functions for moving across characters that
597have certain syntax classes. 599have certain syntax classes.
@@ -631,6 +633,8 @@ expression prefix syntax class, and characters with the @samp{p} flag.
631 633
632@node Parsing Expressions 634@node Parsing Expressions
633@section Parsing Expressions 635@section Parsing Expressions
636@cindex parsing expressions
637@cindex scanning expressions
634 638
635 This section describes functions for parsing and scanning balanced 639 This section describes functions for parsing and scanning balanced
636expressions. We will refer to such expressions as @dfn{sexps}, 640expressions. We will refer to such expressions as @dfn{sexps},
@@ -673,6 +677,7 @@ result, Emacs treats them as four consecutive empty string constants.
673 677
674@node Motion via Parsing 678@node Motion via Parsing
675@subsection Motion Commands Based on Parsing 679@subsection Motion Commands Based on Parsing
680@cindex motion based on parsing
676 681
677 This section describes simple point-motion functions that operate 682 This section describes simple point-motion functions that operate
678based on parsing expressions. 683based on parsing expressions.
@@ -738,6 +743,7 @@ cannot exceed that many.
738 743
739@node Position Parse 744@node Position Parse
740@subsection Finding the Parse State for a Position 745@subsection Finding the Parse State for a Position
746@cindex parse state for a position
741 747
742 For syntactic analysis, such as in indentation, often the useful 748 For syntactic analysis, such as in indentation, often the useful
743thing is to compute the syntactic state corresponding to a given buffer 749thing is to compute the syntactic state corresponding to a given buffer
@@ -919,6 +925,7 @@ nicely.
919 925
920@node Control Parsing 926@node Control Parsing
921@subsection Parameters to Control Parsing 927@subsection Parameters to Control Parsing
928@cindex parsing, control parameters
922 929
923@defvar multibyte-syntax-as-symbol 930@defvar multibyte-syntax-as-symbol
924If this variable is non-@code{nil}, @code{scan-sexps} treats all 931If this variable is non-@code{nil}, @code{scan-sexps} treats all
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 09dec5671f9..27ea8bcbd91 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -162,6 +162,7 @@ the end of a line.
162 162
163@node Buffer Contents 163@node Buffer Contents
164@section Examining Buffer Contents 164@section Examining Buffer Contents
165@cindex buffer portion as string
165 166
166 This section describes functions that allow a Lisp program to 167 This section describes functions that allow a Lisp program to
167convert any portion of the text in the buffer into a string. 168convert any portion of the text in the buffer into a string.
@@ -2673,6 +2674,8 @@ along with the characters; this includes such diverse functions as
2673 2674
2674@node Examining Properties 2675@node Examining Properties
2675@subsection Examining Text Properties 2676@subsection Examining Text Properties
2677@cindex examining text properties
2678@cindex text properties, examining
2676 2679
2677 The simplest way to examine text properties is to ask for the value of 2680 The simplest way to examine text properties is to ask for the value of
2678a particular property of a particular character. For that, use 2681a particular property of a particular character. For that, use
@@ -2764,6 +2767,8 @@ used instead. Here is an example:
2764 2767
2765@node Changing Properties 2768@node Changing Properties
2766@subsection Changing Text Properties 2769@subsection Changing Text Properties
2770@cindex changing text properties
2771@cindex text properties, changing
2767 2772
2768 The primitives for changing properties apply to a specified range of 2773 The primitives for changing properties apply to a specified range of
2769text in a buffer or string. The function @code{set-text-properties} 2774text in a buffer or string. The function @code{set-text-properties}
@@ -2927,6 +2932,8 @@ buffer but does not copy its properties.
2927 2932
2928@node Property Search 2933@node Property Search
2929@subsection Text Property Search Functions 2934@subsection Text Property Search Functions
2935@cindex searching text properties
2936@cindex text properties, searching
2930 2937
2931 In typical use of text properties, most of the time several or many 2938 In typical use of text properties, most of the time several or many
2932consecutive characters have the same value for a property. Rather than 2939consecutive characters have the same value for a property. Rather than
@@ -3980,6 +3987,8 @@ coalesced whenever possible. @xref{Property Search}.
3980 3987
3981@node Substitution 3988@node Substitution
3982@section Substituting for a Character Code 3989@section Substituting for a Character Code
3990@cindex replace characters in region
3991@cindex substitute characters
3983 3992
3984 The following functions replace characters within a specified region 3993 The following functions replace characters within a specified region
3985based on their character codes. 3994based on their character codes.
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index e890dbce359..b3466e60c4e 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1951,6 +1951,7 @@ foo
1951 1951
1952@node Variables with Restricted Values 1952@node Variables with Restricted Values
1953@section Variables with Restricted Values 1953@section Variables with Restricted Values
1954@cindex lisp variables defined in C, restrictions
1954 1955
1955 Ordinary Lisp variables can be assigned any value that is a valid 1956 Ordinary Lisp variables can be assigned any value that is a valid
1956Lisp object. However, certain Lisp variables are not defined in Lisp, 1957Lisp object. However, certain Lisp variables are not defined in Lisp,
@@ -1987,6 +1988,8 @@ Attempting to assign them any other value will result in an error:
1987@node Generalized Variables 1988@node Generalized Variables
1988@section Generalized Variables 1989@section Generalized Variables
1989 1990
1991@cindex generalized variable
1992@cindex place form
1990A @dfn{generalized variable} or @dfn{place form} is one of the many places 1993A @dfn{generalized variable} or @dfn{place form} is one of the many places
1991in Lisp memory where values can be stored. The simplest place form is 1994in Lisp memory where values can be stored. The simplest place form is
1992a regular Lisp variable. But the @sc{car}s and @sc{cdr}s of lists, elements 1995a regular Lisp variable. But the @sc{car}s and @sc{cdr}s of lists, elements
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 1e27d744c7e..aa6ec2c9943 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -1167,6 +1167,8 @@ are the opposite of what they are in those other functions.
1167 1167
1168@node Recombining Windows 1168@node Recombining Windows
1169@section Recombining Windows 1169@section Recombining Windows
1170@cindex recombining windows
1171@cindex windows, recombining
1170 1172
1171When deleting the last sibling of a window @var{W}, its parent window 1173When deleting the last sibling of a window @var{W}, its parent window
1172is deleted too, with @var{W} replacing it in the window tree. This 1174is deleted too, with @var{W} replacing it in the window tree. This