aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorGlenn Morris2012-05-26 19:30:29 -0700
committerGlenn Morris2012-05-26 19:30:29 -0700
commit1d5b82efa7e79bad40e6688b76e82500bd13848f (patch)
tree13e7ec79a8ca09220beec0c8233c2bfeb7bb5ea3 /doc/misc
parentbd39eb06b9784c74e1f75f531b8793d26ad01fa0 (diff)
downloademacs-1d5b82efa7e79bad40e6688b76e82500bd13848f.tar.gz
emacs-1d5b82efa7e79bad40e6688b76e82500bd13848f.zip
* doc/misc/cl.texi, doc/misc/dired-x.texi: Nuke hand-written node pointers.
Some associated fixes, including not messing with chapno in cl.texi.
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/ChangeLog5
-rw-r--r--doc/misc/cl.texi165
-rw-r--r--doc/misc/dired-x.texi54
3 files changed, 103 insertions, 121 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 82e6a2f70ae..1a22981d952 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
12012-05-27 Glenn Morris <rgm@gnu.org>
2
3 * cl.texi, dired-x.texi: Nuke hand-written node pointers.
4 Some associated fixes, including not messing with chapno in cl.texi.
5
12012-05-27 Bastien Guerry <bzg@gnu.org> 62012-05-27 Bastien Guerry <bzg@gnu.org>
2 7
3 * org.texi (Durations and time values): Fix typo. 8 * org.texi (Durations and time values): Fix typo.
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index d35c14acd1d..9195ca3f10c 100644
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -45,16 +45,10 @@ developing GNU and promoting software freedom.''
45 45
46@contents 46@contents
47 47
48@node Top, Overview, (dir), (dir)
49@chapter Introduction
50
51@noindent
52This document describes a set of Emacs Lisp facilities borrowed from
53Common Lisp. All the facilities are described here in detail. While
54this document does not assume any prior knowledge of Common Lisp, it
55does assume a basic familiarity with Emacs Lisp.
56
57@ifnottex 48@ifnottex
49@node Top
50@top GNU Emacs Common Lisp Emulation
51
58@insertcopying 52@insertcopying
59@end ifnottex 53@end ifnottex
60 54
@@ -82,12 +76,15 @@ does assume a basic familiarity with Emacs Lisp.
82* Variable Index:: 76* Variable Index::
83@end menu 77@end menu
84 78
85@node Overview, Program Structure, Top, Top 79@node Overview
86@ifnottex
87@chapter Overview 80@chapter Overview
88@end ifnottex
89 81
90@noindent 82@noindent
83This document describes a set of Emacs Lisp facilities borrowed from
84Common Lisp. All the facilities are described here in detail. While
85this document does not assume any prior knowledge of Common Lisp, it
86does assume a basic familiarity with Emacs Lisp.
87
91Common Lisp is a huge language, and Common Lisp systems tend to be 88Common Lisp is a huge language, and Common Lisp systems tend to be
92massive and extremely complex. Emacs Lisp, by contrast, is rather 89massive and extremely complex. Emacs Lisp, by contrast, is rather
93minimalist in the choice of Lisp features it offers the programmer. 90minimalist in the choice of Lisp features it offers the programmer.
@@ -150,7 +147,7 @@ environment.
150* Naming Conventions:: Notes on CL function names 147* Naming Conventions:: Notes on CL function names
151@end menu 148@end menu
152 149
153@node Usage, Organization, Overview, Overview 150@node Usage
154@section Usage 151@section Usage
155 152
156@noindent 153@noindent
@@ -166,7 +163,7 @@ It is safe to arrange to load @dfn{CL} at all times, e.g.,
166in your @file{.emacs} file. But it's a good idea, for portability, 163in your @file{.emacs} file. But it's a good idea, for portability,
167to @code{(require 'cl)} in your code even if you do this. 164to @code{(require 'cl)} in your code even if you do this.
168 165
169@node Organization, Installation, Usage, Overview 166@node Organization
170@section Organization 167@section Organization
171 168
172@noindent 169@noindent
@@ -212,7 +209,7 @@ like @code{defkeyword}, and an emulation of the old-style
212multiple-values feature. This file is obsolete and should not be used 209multiple-values feature. This file is obsolete and should not be used
213in new code. @xref{Old CL Compatibility}. 210in new code. @xref{Old CL Compatibility}.
214 211
215@node Installation, Naming Conventions, Organization, Overview 212@node Installation
216@section Installation 213@section Installation
217 214
218@noindent 215@noindent
@@ -226,7 +223,7 @@ directory on your @code{load-path}. Also, format the @file{cl.texi}
226file and put the resulting Info files into a directory in your 223file and put the resulting Info files into a directory in your
227@code{Info-directory-list}. 224@code{Info-directory-list}.
228 225
229@node Naming Conventions, , Installation, Overview 226@node Naming Conventions
230@section Naming Conventions 227@section Naming Conventions
231 228
232@noindent 229@noindent
@@ -280,11 +277,7 @@ and @code{:key} is not used.
280@noindent 277@noindent
281[4] Only when @var{place} is a plain variable name. 278[4] Only when @var{place} is a plain variable name.
282 279
283@iftex 280@node Program Structure
284@chapno=4
285@end iftex
286
287@node Program Structure, Predicates, Overview, Top
288@chapter Program Structure 281@chapter Program Structure
289 282
290@noindent 283@noindent
@@ -301,7 +294,7 @@ and the @code{eval-when} construct.
301@secno=1 294@secno=1
302@end iftex 295@end iftex
303 296
304@node Argument Lists, Time of Evaluation, Program Structure, Program Structure 297@node Argument Lists
305@section Argument Lists 298@section Argument Lists
306 299
307@noindent 300@noindent
@@ -525,7 +518,7 @@ If the optimization quality @code{safety} is set to 0
525arguments and invalid keyword arguments is disabled. By default, 518arguments and invalid keyword arguments is disabled. By default,
526argument lists are rigorously checked. 519argument lists are rigorously checked.
527 520
528@node Time of Evaluation, , Argument Lists, Program Structure 521@node Time of Evaluation
529@section Time of Evaluation 522@section Time of Evaluation
530 523
531@noindent 524@noindent
@@ -675,7 +668,7 @@ Byte-compiled, the above defun will result in the following code
675@end example 668@end example
676@end defspec 669@end defspec
677 670
678@node Predicates, Control Structure, Program Structure, Top 671@node Predicates
679@chapter Predicates 672@chapter Predicates
680 673
681@noindent 674@noindent
@@ -687,7 +680,7 @@ facts are true or false.
687* Equality Predicates:: @code{equalp} 680* Equality Predicates:: @code{equalp}
688@end menu 681@end menu
689 682
690@node Type Predicates, Equality Predicates, Predicates, Predicates 683@node Type Predicates
691@section Type Predicates 684@section Type Predicates
692 685
693@noindent 686@noindent
@@ -820,7 +813,7 @@ names. @xref{Conditionals}. @xref{Assertions}. The @code{map},
820@code{concatenate}, and @code{merge} functions take type-name 813@code{concatenate}, and @code{merge} functions take type-name
821arguments to specify the type of sequence to return. @xref{Sequences}. 814arguments to specify the type of sequence to return. @xref{Sequences}.
822 815
823@node Equality Predicates, , Type Predicates, Predicates 816@node Equality Predicates
824@section Equality Predicates 817@section Equality Predicates
825 818
826@noindent 819@noindent
@@ -848,7 +841,7 @@ MacLisp tradition and uses @code{equal} for these two functions.
848In Emacs, use @code{member*} and @code{assoc*} to get functions 841In Emacs, use @code{member*} and @code{assoc*} to get functions
849which use @code{eql} for comparisons. 842which use @code{eql} for comparisons.
850 843
851@node Control Structure, Macros, Predicates, Top 844@node Control Structure
852@chapter Control Structure 845@chapter Control Structure
853 846
854@noindent 847@noindent
@@ -868,7 +861,7 @@ constructs.
868* Multiple Values:: @code{values}, @code{multiple-value-bind}, etc. 861* Multiple Values:: @code{values}, @code{multiple-value-bind}, etc.
869@end menu 862@end menu
870 863
871@node Assignment, Generalized Variables, Control Structure, Control Structure 864@node Assignment
872@section Assignment 865@section Assignment
873 866
874@noindent 867@noindent
@@ -905,7 +898,7 @@ provides an even more convenient way to swap two variables;
905@code{psetq} always returns @code{nil}. 898@code{psetq} always returns @code{nil}.
906@end defspec 899@end defspec
907 900
908@node Generalized Variables, Variable Bindings, Assignment, Control Structure 901@node Generalized Variables
909@section Generalized Variables 902@section Generalized Variables
910 903
911@noindent 904@noindent
@@ -934,7 +927,7 @@ is a set of forms that can be generalized variables in Lisp.
934* Customizing Setf:: @code{define-modify-macro}, @code{defsetf}, @code{define-setf-method} 927* Customizing Setf:: @code{define-modify-macro}, @code{defsetf}, @code{define-setf-method}
935@end menu 928@end menu
936 929
937@node Basic Setf, Modify Macros, Generalized Variables, Generalized Variables 930@node Basic Setf
938@subsection Basic Setf 931@subsection Basic Setf
939 932
940@noindent 933@noindent
@@ -1105,7 +1098,7 @@ evaluate @var{b} first, then @var{a}, just as in an actual call
1105to @code{wrong-order}. 1098to @code{wrong-order}.
1106@end defspec 1099@end defspec
1107 1100
1108@node Modify Macros, Customizing Setf, Basic Setf, Generalized Variables 1101@node Modify Macros
1109@subsection Modify Macros 1102@subsection Modify Macros
1110 1103
1111@noindent 1104@noindent
@@ -1316,7 +1309,7 @@ blocks for other macros like @code{incf}, @code{pushnew}, and
1316macros are used in the processing of symbol macros; 1309macros are used in the processing of symbol macros;
1317@pxref{Macro Bindings}. 1310@pxref{Macro Bindings}.
1318 1311
1319@node Customizing Setf, , Modify Macros, Generalized Variables 1312@node Customizing Setf
1320@subsection Customizing Setf 1313@subsection Customizing Setf
1321 1314
1322@noindent 1315@noindent
@@ -1529,7 +1522,7 @@ defined later.
1529@secno=4 1522@secno=4
1530@end iftex 1523@end iftex
1531 1524
1532@node Variable Bindings, Conditionals, Generalized Variables, Control Structure 1525@node Variable Bindings
1533@section Variable Bindings 1526@section Variable Bindings
1534 1527
1535@noindent 1528@noindent
@@ -1546,7 +1539,7 @@ are also related to variable bindings.
1546* Macro Bindings:: @code{macrolet} and @code{symbol-macrolet} 1539* Macro Bindings:: @code{macrolet} and @code{symbol-macrolet}
1547@end menu 1540@end menu
1548 1541
1549@node Dynamic Bindings, Lexical Bindings, Variable Bindings, Variable Bindings 1542@node Dynamic Bindings
1550@subsection Dynamic Bindings 1543@subsection Dynamic Bindings
1551 1544
1552@noindent 1545@noindent
@@ -1566,7 +1559,7 @@ If @var{symbols} is shorter than @var{values}, the excess values
1566are ignored. 1559are ignored.
1567@end defspec 1560@end defspec
1568 1561
1569@node Lexical Bindings, Function Bindings, Dynamic Bindings, Variable Bindings 1562@node Lexical Bindings
1570@subsection Lexical Bindings 1563@subsection Lexical Bindings
1571 1564
1572@noindent 1565@noindent
@@ -1680,7 +1673,7 @@ This form is just like @code{lexical-let}, except that the bindings
1680are made sequentially in the manner of @code{let*}. 1673are made sequentially in the manner of @code{let*}.
1681@end defspec 1674@end defspec
1682 1675
1683@node Function Bindings, Macro Bindings, Lexical Bindings, Variable Bindings 1676@node Function Bindings
1684@subsection Function Bindings 1677@subsection Function Bindings
1685 1678
1686@noindent 1679@noindent
@@ -1756,7 +1749,7 @@ function, or a use of its name quoted by @code{quote} or
1756@code{function} to be passed on to, say, @code{mapcar}. 1749@code{function} to be passed on to, say, @code{mapcar}.
1757@end defspec 1750@end defspec
1758 1751
1759@node Macro Bindings, , Function Bindings, Variable Bindings 1752@node Macro Bindings
1760@subsection Macro Bindings 1753@subsection Macro Bindings
1761 1754
1762@noindent 1755@noindent
@@ -1843,7 +1836,7 @@ This package defines a nonstandard @code{in-ref} loop clause that
1843works much like @code{my-dolist}. 1836works much like @code{my-dolist}.
1844@end defspec 1837@end defspec
1845 1838
1846@node Conditionals, Blocks and Exits, Variable Bindings, Control Structure 1839@node Conditionals
1847@section Conditionals 1840@section Conditionals
1848 1841
1849@noindent 1842@noindent
@@ -1917,7 +1910,7 @@ not match any of the clauses, an error is signaled rather than
1917simply returning @code{nil}. 1910simply returning @code{nil}.
1918@end defspec 1911@end defspec
1919 1912
1920@node Blocks and Exits, Iteration, Conditionals, Control Structure 1913@node Blocks and Exits
1921@section Blocks and Exits 1914@section Blocks and Exits
1922 1915
1923@noindent 1916@noindent
@@ -1982,7 +1975,7 @@ Common Lisp loops like @code{do} and @code{dolist} implicitly enclose
1982themselves in @code{nil} blocks. 1975themselves in @code{nil} blocks.
1983@end defspec 1976@end defspec
1984 1977
1985@node Iteration, Loop Facility, Blocks and Exits, Control Structure 1978@node Iteration
1986@section Iteration 1979@section Iteration
1987 1980
1988@noindent 1981@noindent
@@ -2126,7 +2119,7 @@ argument is omitted; it always iterates over the default obarray.
2126@xref{Mapping over Sequences}, for some more functions for 2119@xref{Mapping over Sequences}, for some more functions for
2127iterating over vectors or lists. 2120iterating over vectors or lists.
2128 2121
2129@node Loop Facility, Multiple Values, Iteration, Control Structure 2122@node Loop Facility
2130@section Loop Facility 2123@section Loop Facility
2131 2124
2132@noindent 2125@noindent
@@ -2148,7 +2141,7 @@ with an easy-to-use but very powerful and expressive syntax.
2148* Other Clauses:: @code{with}, @code{if}, @code{initially}, @code{finally} 2141* Other Clauses:: @code{with}, @code{if}, @code{initially}, @code{finally}
2149@end menu 2142@end menu
2150 2143
2151@node Loop Basics, Loop Examples, Loop Facility, Loop Facility 2144@node Loop Basics
2152@subsection Loop Basics 2145@subsection Loop Basics
2153 2146
2154@noindent 2147@noindent
@@ -2207,7 +2200,7 @@ action, and describe the particular loop clauses in great detail.
2207Consult the second edition of Steele's @dfn{Common Lisp, the Language}, 2200Consult the second edition of Steele's @dfn{Common Lisp, the Language},
2208for additional discussion and examples of the @code{loop} macro. 2201for additional discussion and examples of the @code{loop} macro.
2209 2202
2210@node Loop Examples, For Clauses, Loop Basics, Loop Facility 2203@node Loop Examples
2211@subsection Loop Examples 2204@subsection Loop Examples
2212 2205
2213@noindent 2206@noindent
@@ -2280,7 +2273,7 @@ define loops all by themselves, it still creates a single loop
2280rather than some sort of triple-nested loop. You must explicitly 2273rather than some sort of triple-nested loop. You must explicitly
2281nest your @code{loop} constructs if you want nested loops. 2274nest your @code{loop} constructs if you want nested loops.
2282 2275
2283@node For Clauses, Iteration Clauses, Loop Examples, Loop Facility 2276@node For Clauses
2284@subsection For Clauses 2277@subsection For Clauses
2285 2278
2286@noindent 2279@noindent
@@ -2595,7 +2588,7 @@ to process an alist
2595 @result{} (1 2) 2588 @result{} (1 2)
2596@end example 2589@end example
2597 2590
2598@node Iteration Clauses, Accumulation Clauses, For Clauses, Loop Facility 2591@node Iteration Clauses
2599@subsection Iteration Clauses 2592@subsection Iteration Clauses
2600 2593
2601@noindent 2594@noindent
@@ -2654,7 +2647,7 @@ in this case, it returns that non-@code{nil} value. If all the
2654values were @code{nil}, the loop returns @code{nil}. 2647values were @code{nil}, the loop returns @code{nil}.
2655@end table 2648@end table
2656 2649
2657@node Accumulation Clauses, Other Clauses, Iteration Clauses, Loop Facility 2650@node Accumulation Clauses
2658@subsection Accumulation Clauses 2651@subsection Accumulation Clauses
2659 2652
2660@noindent 2653@noindent
@@ -2723,7 +2716,7 @@ accumulate into the same place. From Steele:
2723 @result{} (fred bob ken sue alice joe kris sunshine june) 2716 @result{} (fred bob ken sue alice joe kris sunshine june)
2724@end example 2717@end example
2725 2718
2726@node Other Clauses, , Accumulation Clauses, Loop Facility 2719@node Other Clauses
2727@subsection Other Clauses 2720@subsection Other Clauses
2728 2721
2729@noindent 2722@noindent
@@ -2874,7 +2867,7 @@ and data-type specifiers. Naturally, the @code{for} clauses which
2874iterate over keymaps, overlays, intervals, frames, windows, and 2867iterate over keymaps, overlays, intervals, frames, windows, and
2875buffers are Emacs-specific extensions. 2868buffers are Emacs-specific extensions.
2876 2869
2877@node Multiple Values, , Loop Facility, Control Structure 2870@node Multiple Values
2878@section Multiple Values 2871@section Multiple Values
2879 2872
2880@noindent 2873@noindent
@@ -2916,7 +2909,7 @@ form would see them.
2916Since a perfect emulation is not feasible in Emacs Lisp, this 2909Since a perfect emulation is not feasible in Emacs Lisp, this
2917package opts to keep it as simple and predictable as possible. 2910package opts to keep it as simple and predictable as possible.
2918 2911
2919@node Macros, Declarations, Control Structure, Top 2912@node Macros
2920@chapter Macros 2913@chapter Macros
2921 2914
2922@noindent 2915@noindent
@@ -2994,7 +2987,7 @@ for which no further expansion is possible.
2994and @code{symbol-macrolet} forms for making ``local'' macro 2987and @code{symbol-macrolet} forms for making ``local'' macro
2995definitions. 2988definitions.
2996 2989
2997@node Declarations, Symbols, Macros, Top 2990@node Declarations
2998@chapter Declarations 2991@chapter Declarations
2999 2992
3000@noindent 2993@noindent
@@ -3176,7 +3169,7 @@ disable these warnings and any higher value will enable them.
3176See the documentation for the optimizing byte compiler for details. 3169See the documentation for the optimizing byte compiler for details.
3177@end table 3170@end table
3178 3171
3179@node Symbols, Numbers, Declarations, Top 3172@node Symbols
3180@chapter Symbols 3173@chapter Symbols
3181 3174
3182@noindent 3175@noindent
@@ -3188,7 +3181,7 @@ missing from Emacs Lisp.
3188* Creating Symbols:: @code{gensym}, @code{gentemp} 3181* Creating Symbols:: @code{gensym}, @code{gentemp}
3189@end menu 3182@end menu
3190 3183
3191@node Property Lists, Creating Symbols, Symbols, Symbols 3184@node Property Lists
3192@section Property Lists 3185@section Property Lists
3193 3186
3194@noindent 3187@noindent
@@ -3273,7 +3266,7 @@ out the property and value cells.
3273@secno=2 3266@secno=2
3274@end iftex 3267@end iftex
3275 3268
3276@node Creating Symbols, , Property Lists, Symbols 3269@node Creating Symbols
3277@section Creating Symbols 3270@section Creating Symbols
3278 3271
3279@noindent 3272@noindent
@@ -3318,11 +3311,7 @@ automatically creates all keywords that are called for by
3318keywords as data unrelated to keyword arguments, so the 3311keywords as data unrelated to keyword arguments, so the
3319@code{defkeyword} form has been discontinued. 3312@code{defkeyword} form has been discontinued.
3320 3313
3321@iftex 3314@node Numbers
3322@chapno=11
3323@end iftex
3324
3325@node Numbers, Sequences, Symbols, Top
3326@chapter Numbers 3315@chapter Numbers
3327 3316
3328@noindent 3317@noindent
@@ -3340,7 +3329,7 @@ which were left out of Emacs Lisp.
3340@secno=1 3329@secno=1
3341@end iftex 3330@end iftex
3342 3331
3343@node Predicates on Numbers, Numerical Functions, Numbers, Numbers 3332@node Predicates on Numbers
3344@section Predicates on Numbers 3333@section Predicates on Numbers
3345 3334
3346@noindent 3335@noindent
@@ -3377,7 +3366,7 @@ to @code{floatp}. On other systems, this always returns @code{nil}.
3377@secno=3 3366@secno=3
3378@end iftex 3367@end iftex
3379 3368
3380@node Numerical Functions, Random Numbers, Predicates on Numbers, Numbers 3369@node Numerical Functions
3381@section Numerical Functions 3370@section Numerical Functions
3382 3371
3383@noindent 3372@noindent
@@ -3473,7 +3462,7 @@ multiple values is different.
3473@secno=8 3462@secno=8
3474@end iftex 3463@end iftex
3475 3464
3476@node Random Numbers, Implementation Parameters, Numerical Functions, Numbers 3465@node Random Numbers
3477@section Random Numbers 3466@section Random Numbers
3478 3467
3479@noindent 3468@noindent
@@ -3534,7 +3523,7 @@ This predicate returns @code{t} if @var{object} is a
3534@code{random-state} object, or @code{nil} otherwise. 3523@code{random-state} object, or @code{nil} otherwise.
3535@end defun 3524@end defun
3536 3525
3537@node Implementation Parameters, , Random Numbers, Numbers 3526@node Implementation Parameters
3538@section Implementation Parameters 3527@section Implementation Parameters
3539 3528
3540@noindent 3529@noindent
@@ -3615,11 +3604,7 @@ This is the smallest positive value that can be subtracted from
3615@code{1.11e-16}. 3604@code{1.11e-16}.
3616@end defvar 3605@end defvar
3617 3606
3618@iftex 3607@node Sequences
3619@chapno=13
3620@end iftex
3621
3622@node Sequences, Lists, Numbers, Top
3623@chapter Sequences 3608@chapter Sequences
3624 3609
3625@noindent 3610@noindent
@@ -3636,7 +3621,7 @@ Emacs Lisp includes a few of these, notably @code{elt} and
3636* Sorting Sequences:: @code{sort*}, @code{stable-sort}, @code{merge} 3621* Sorting Sequences:: @code{sort*}, @code{stable-sort}, @code{merge}
3637@end menu 3622@end menu
3638 3623
3639@node Sequence Basics, Mapping over Sequences, Sequences, Sequences 3624@node Sequence Basics
3640@section Sequence Basics 3625@section Sequence Basics
3641 3626
3642@noindent 3627@noindent
@@ -3713,7 +3698,7 @@ example, @code{(remove* ?A @var{str})} may or may not preserve
3713the properties of the characters copied from @var{str} into the 3698the properties of the characters copied from @var{str} into the
3714result. 3699result.
3715 3700
3716@node Mapping over Sequences, Sequence Functions, Sequence Basics, Sequences 3701@node Mapping over Sequences
3717@section Mapping over Sequences 3702@section Mapping over Sequences
3718 3703
3719@noindent 3704@noindent
@@ -3851,7 +3836,7 @@ terms of the @code{loop} macro. In compiled code, @code{loop} will
3851be faster since it generates the loop as in-line code with no 3836be faster since it generates the loop as in-line code with no
3852function calls. 3837function calls.
3853 3838
3854@node Sequence Functions, Searching Sequences, Mapping over Sequences, Sequences 3839@node Sequence Functions
3855@section Sequence Functions 3840@section Sequence Functions
3856 3841
3857@noindent 3842@noindent
@@ -3978,7 +3963,7 @@ The @code{substitute-if}, @code{substitute-if-not}, @code{nsubstitute-if},
3978and @code{nsubstitute-if-not} functions are defined similarly. For 3963and @code{nsubstitute-if-not} functions are defined similarly. For
3979these, a @var{predicate} is given in place of the @var{old} argument. 3964these, a @var{predicate} is given in place of the @var{old} argument.
3980 3965
3981@node Searching Sequences, Sorting Sequences, Sequence Functions, Sequences 3966@node Searching Sequences
3982@section Searching Sequences 3967@section Searching Sequences
3983 3968
3984@noindent 3969@noindent
@@ -4047,7 +4032,7 @@ if no matches were found. If @code{:from-end} is true, the
4047function finds the @emph{rightmost} matching subsequence. 4032function finds the @emph{rightmost} matching subsequence.
4048@end defun 4033@end defun
4049 4034
4050@node Sorting Sequences, , Searching Sequences, Sequences 4035@node Sorting Sequences
4051@section Sorting Sequences 4036@section Sorting Sequences
4052 4037
4053@defun sort* seq predicate @t{&key :key} 4038@defun sort* seq predicate @t{&key :key}
@@ -4106,7 +4091,7 @@ a merged sequence which is (stably) sorted according to
4106@var{predicate}. 4091@var{predicate}.
4107@end defun 4092@end defun
4108 4093
4109@node Lists, Structures, Sequences, Top 4094@node Lists
4110@chapter Lists 4095@chapter Lists
4111 4096
4112@noindent 4097@noindent
@@ -4119,7 +4104,7 @@ The functions described here operate on lists.
4119* Association Lists:: @code{assoc*}, @code{rassoc*}, @code{acons}, @code{pairlis} 4104* Association Lists:: @code{assoc*}, @code{rassoc*}, @code{acons}, @code{pairlis}
4120@end menu 4105@end menu
4121 4106
4122@node List Functions, Substitution of Expressions, Lists, Lists 4107@node List Functions
4123@section List Functions 4108@section List Functions
4124 4109
4125@noindent 4110@noindent
@@ -4212,7 +4197,7 @@ applied to the elements of both trees. @xref{Sequences}.
4212@secno=3 4197@secno=3
4213@end iftex 4198@end iftex
4214 4199
4215@node Substitution of Expressions, Lists as Sets, List Functions, Lists 4200@node Substitution of Expressions
4216@section Substitution of Expressions 4201@section Substitution of Expressions
4217 4202
4218@noindent 4203@noindent
@@ -4261,7 +4246,7 @@ function, if any), is compared with the @code{car}s of
4261This is a destructive version of @code{sublis}. 4246This is a destructive version of @code{sublis}.
4262@end defun 4247@end defun
4263 4248
4264@node Lists as Sets, Association Lists, Substitution of Expressions, Lists 4249@node Lists as Sets
4265@section Lists as Sets 4250@section Lists as Sets
4266 4251
4267@noindent 4252@noindent
@@ -4360,7 +4345,7 @@ of @var{list2}, i.e., whether every element of @var{list1}
4360also appears in @var{list2}. 4345also appears in @var{list2}.
4361@end defun 4346@end defun
4362 4347
4363@node Association Lists, , Lists as Sets, Lists 4348@node Association Lists
4364@section Association Lists 4349@section Association Lists
4365 4350
4366@noindent 4351@noindent
@@ -4404,11 +4389,7 @@ This is equivalent to @code{(nconc (mapcar* 'cons @var{keys} @var{values})
4404@var{alist})}. 4389@var{alist})}.
4405@end defun 4390@end defun
4406 4391
4407@iftex 4392@node Structures
4408@chapno=18
4409@end iftex
4410
4411@node Structures, Assertions, Lists, Top
4412@chapter Structures 4393@chapter Structures
4413 4394
4414@noindent 4395@noindent
@@ -4738,11 +4719,7 @@ of the included type and the first new slot.
4738Except as noted, the @code{defstruct} facility of this package is 4719Except as noted, the @code{defstruct} facility of this package is
4739entirely compatible with that of Common Lisp. 4720entirely compatible with that of Common Lisp.
4740 4721
4741@iftex 4722@node Assertions
4742@chapno=23
4743@end iftex
4744
4745@node Assertions, Efficiency Concerns, Structures, Top
4746@chapter Assertions and Errors 4723@chapter Assertions and Errors
4747 4724
4748@noindent 4725@noindent
@@ -4814,7 +4791,7 @@ If the @var{forms} complete successfully, @code{ignore-errors}
4814returns the result of the last @var{form}. 4791returns the result of the last @var{form}.
4815@end defspec 4792@end defspec
4816 4793
4817@node Efficiency Concerns, Common Lisp Compatibility, Assertions, Top 4794@node Efficiency Concerns
4818@appendix Efficiency Concerns 4795@appendix Efficiency Concerns
4819 4796
4820@appendixsec Macros 4797@appendixsec Macros
@@ -4957,7 +4934,7 @@ code which can be improved by optimization. In particular,
4957optimizing compiler removes @code{block}s which are not actually 4934optimizing compiler removes @code{block}s which are not actually
4958referenced by @code{return} or @code{return-from} inside the block. 4935referenced by @code{return} or @code{return-from} inside the block.
4959 4936
4960@node Common Lisp Compatibility, Old CL Compatibility, Efficiency Concerns, Top 4937@node Common Lisp Compatibility
4961@appendix Common Lisp Compatibility 4938@appendix Common Lisp Compatibility
4962 4939
4963@noindent 4940@noindent
@@ -5019,7 +4996,7 @@ special, distinct type. Also, the @code{:type} slot option is ignored.
5019 4996
5020The second argument of @code{check-type} is treated differently. 4997The second argument of @code{check-type} is treated differently.
5021 4998
5022@node Old CL Compatibility, Porting Common Lisp, Common Lisp Compatibility, Top 4999@node Old CL Compatibility
5023@appendix Old CL Compatibility 5000@appendix Old CL Compatibility
5024 5001
5025@noindent 5002@noindent
@@ -5120,7 +5097,7 @@ older versions of the old package used the unadorned names
5120@code{floor}, @code{ceiling}, etc.; @code{cl-compat} cannot use 5097@code{floor}, @code{ceiling}, etc.; @code{cl-compat} cannot use
5121these names because they conflict with Emacs built-ins. 5098these names because they conflict with Emacs built-ins.
5122 5099
5123@node Porting Common Lisp, GNU Free Documentation License, Old CL Compatibility, Top 5100@node Porting Common Lisp
5124@appendix Porting Common Lisp 5101@appendix Porting Common Lisp
5125 5102
5126@noindent 5103@noindent
@@ -5326,16 +5303,16 @@ note that the current Emacs Lisp compiler does not optimize tail
5326recursion. 5303recursion.
5327@end itemize 5304@end itemize
5328 5305
5329@node GNU Free Documentation License, Function Index, Porting Common Lisp, Top 5306@node GNU Free Documentation License
5330@appendix GNU Free Documentation License 5307@appendix GNU Free Documentation License
5331@include doclicense.texi 5308@include doclicense.texi
5332 5309
5333@node Function Index, Variable Index, GNU Free Documentation License, Top 5310@node Function Index
5334@unnumbered Function Index 5311@unnumbered Function Index
5335 5312
5336@printindex fn 5313@printindex fn
5337 5314
5338@node Variable Index, , Function Index, Top 5315@node Variable Index
5339@unnumbered Variable Index 5316@unnumbered Variable Index
5340 5317
5341@printindex vr 5318@printindex vr
diff --git a/doc/misc/dired-x.texi b/doc/misc/dired-x.texi
index 95c129f411d..b00e451de85 100644
--- a/doc/misc/dired-x.texi
+++ b/doc/misc/dired-x.texi
@@ -111,7 +111,7 @@ For @file{dired-x.el} as distributed with GNU Emacs @value{EMACSVER}.
111 111
112@end ifnottex 112@end ifnottex
113 113
114@node Introduction, Installation, Top, Top 114@node Introduction
115@chapter Introduction 115@chapter Introduction
116 116
117This documents some @emph{extra} features for GNU Emacs's Dired Mode 117This documents some @emph{extra} features for GNU Emacs's Dired Mode
@@ -125,7 +125,7 @@ original @file{dired-x.el}).
125@end menu 125@end menu
126@end ifnottex 126@end ifnottex
127 127
128@node Features, Technical Details, , Introduction 128@node Features
129@section Features 129@section Features
130@cindex Features 130@cindex Features
131 131
@@ -157,7 +157,7 @@ also binds @kbd{C-x C-f} and @kbd{C-x 4 C-f} to
157@code{dired-x-find-file} and @code{dired-x-find-file-other-window}, 157@code{dired-x-find-file} and @code{dired-x-find-file-other-window},
158respectively (@pxref{Find File At Point}). 158respectively (@pxref{Find File At Point}).
159 159
160@node Technical Details, , Features, Introduction 160@node Technical Details
161@section Technical Details 161@section Technical Details
162@cindex Modified functions 162@cindex Modified functions
163@cindex @file{dired-aux.el} 163@cindex @file{dired-aux.el}
@@ -173,7 +173,7 @@ Dired}), if it is active. @code{dired-find-buffer-nocreate} and
173@code{dired-guess-shell-command} (@pxref{Shell Command Guessing}) to 173@code{dired-guess-shell-command} (@pxref{Shell Command Guessing}) to
174offer a smarter default command. 174offer a smarter default command.
175 175
176@node Installation, Omitting Files in Dired, Introduction, Top 176@node Installation
177@chapter Installation 177@chapter Installation
178 178
179@noindent 179@noindent
@@ -211,7 +211,7 @@ when you first type @kbd{C-x d}).
211@end menu 211@end menu
212@end ifnottex 212@end ifnottex
213 213
214@node Optional Installation Dired Jump, Optional Installation File At Point, , Installation 214@node Optional Installation Dired Jump
215@section Optional Installation Dired Jump 215@section Optional Installation Dired Jump
216 216
217@cindex Autoloading @code{dired-jump} and @code{dired-jump-other-window} 217@cindex Autoloading @code{dired-jump} and @code{dired-jump-other-window}
@@ -232,7 +232,7 @@ for these functions. In your @file{.emacs} file put
232(define-key global-map "\C-x4\C-j" 'dired-jump-other-window) 232(define-key global-map "\C-x4\C-j" 'dired-jump-other-window)
233@end example 233@end example
234 234
235@node Optional Installation File At Point, , Optional Installation Dired Jump, Installation 235@node Optional Installation File At Point
236@section Optional Installation File At Point 236@section Optional Installation File At Point
237 237
238@cindex Binding @code{dired-x-find-file} 238@cindex Binding @code{dired-x-find-file}
@@ -251,7 +251,7 @@ or call @code{dired-x-bind-find-file} after changing the value.
251 )) 251 ))
252@end example 252@end example
253 253
254@node Omitting Files in Dired, Local Variables, Installation, Top 254@node Omitting Files in Dired
255@chapter Omitting Files in Dired 255@chapter Omitting Files in Dired
256 256
257@cindex Omitting Files in Dired 257@cindex Omitting Files in Dired
@@ -307,7 +307,7 @@ inside @code{dired-load-hook} (@pxref{Installation}) and then evaluate
307@end menu 307@end menu
308@end ifnottex 308@end ifnottex
309 309
310@node Omitting Variables, Omitting Examples, , Omitting Files in Dired 310@node Omitting Variables
311@section Omitting Variables 311@section Omitting Variables
312 312
313@cindex Customizing file omitting 313@cindex Customizing file omitting
@@ -403,7 +403,7 @@ will show up again after reverting the buffer, unlike the others.
403 403
404@end table 404@end table
405 405
406@node Omitting Examples, Omitting Technical, Omitting Variables, Omitting Files in Dired 406@node Omitting Examples
407@section Examples of Omitting Various File Types 407@section Examples of Omitting Various File Types
408 408
409@itemize @bullet 409@itemize @bullet
@@ -458,7 +458,7 @@ better way to achieve this particular goal is simply to omit @samp{-a} from
458 458
459@end itemize 459@end itemize
460 460
461@node Omitting Technical, , Omitting Examples, Omitting Files in Dired 461@node Omitting Technical
462@section Some Technical Details of Omitting 462@section Some Technical Details of Omitting
463 463
464Loading @file{dired-x.el} will install Dired Omit by putting 464Loading @file{dired-x.el} will install Dired Omit by putting
@@ -466,7 +466,7 @@ Loading @file{dired-x.el} will install Dired Omit by putting
466call @code{dired-extra-startup}, which in turn calls @code{dired-omit-startup} 466call @code{dired-extra-startup}, which in turn calls @code{dired-omit-startup}
467in your @code{dired-mode-hook}. 467in your @code{dired-mode-hook}.
468 468
469@node Local Variables, Shell Command Guessing, Omitting Files in Dired, Top 469@node Local Variables
470@chapter Local Variables for Dired Directories 470@chapter Local Variables for Dired Directories
471 471
472@cindex Local Variables for Dired Directories 472@cindex Local Variables for Dired Directories
@@ -537,7 +537,7 @@ the Dired Local Variables are hacked. It takes the same values as that
537variable. A value of @code{nil} means to ignore any Dired Local Variables. 537variable. A value of @code{nil} means to ignore any Dired Local Variables.
538@end table 538@end table
539 539
540@node Shell Command Guessing, Virtual Dired, Local Variables, Top 540@node Shell Command Guessing
541@chapter Shell Command Guessing 541@chapter Shell Command Guessing
542@cindex Guessing shell commands for files. 542@cindex Guessing shell commands for files.
543 543
@@ -643,7 +643,7 @@ smaller than the @file{.gz} file.
643History list for commands that read dired-shell commands. 643History list for commands that read dired-shell commands.
644@end table 644@end table
645 645
646@node Virtual Dired, Advanced Mark Commands, Shell Command Guessing, Top 646@node Virtual Dired
647@chapter Virtual Dired 647@chapter Virtual Dired
648 648
649@cindex Virtual Dired 649@cindex Virtual Dired
@@ -684,7 +684,7 @@ virtual Dired mode from the @code{auto-mode-alist}. To edit all
684The regexp is a bit more complicated than usual to exclude @file{.dired} 684The regexp is a bit more complicated than usual to exclude @file{.dired}
685local-variable files. 685local-variable files.
686 686
687@node Advanced Mark Commands, Multiple Dired Directories, Virtual Dired, Top 687@node Advanced Mark Commands
688@chapter Advanced Mark Commands 688@chapter Advanced Mark Commands
689 689
690@table @kbd 690@table @kbd
@@ -730,7 +730,7 @@ Flag all files with a certain extension for deletion. A @samp{.} is
730@end menu 730@end menu
731@end ifnottex 731@end ifnottex
732 732
733@node Advanced Cleaning Functions, Advanced Cleaning Variables, , Advanced Mark Commands 733@node Advanced Cleaning Functions
734@section Advanced Cleaning Functions 734@section Advanced Cleaning Functions
735 735
736@table @code 736@table @code
@@ -761,7 +761,7 @@ Flag dispensable files created by @TeX{}, La@TeX{}, @samp{texinfo},
761and @file{*.dvi} files for deletion. 761and @file{*.dvi} files for deletion.
762@end table 762@end table
763 763
764@node Advanced Cleaning Variables, Special Marking Function, Advanced Cleaning Functions, Advanced Mark Commands 764@node Advanced Cleaning Variables
765@section Advanced Cleaning Variables 765@section Advanced Cleaning Variables
766 766
767@noindent Variables used by the above cleaning commands (and in the default value for 767@noindent Variables used by the above cleaning commands (and in the default value for
@@ -800,7 +800,7 @@ Default: @code{(".blg" ".bbl")}
800List of extensions of dispensable files created by Bib@TeX{}. 800List of extensions of dispensable files created by Bib@TeX{}.
801@end table 801@end table
802 802
803@node Special Marking Function, , Advanced Cleaning Variables, Advanced Mark Commands 803@node Special Marking Function
804@section Special Marking Function 804@section Special Marking Function
805 805
806@table @kbd 806@table @kbd
@@ -856,7 +856,7 @@ to mark all @file{.el} files without a corresponding @file{.elc} file.
856 856
857@end table 857@end table
858 858
859@node Multiple Dired Directories, Find File At Point, Advanced Mark Commands, Top 859@node Multiple Dired Directories
860@chapter Multiple Dired Directories and Non-Dired Commands 860@chapter Multiple Dired Directories and Non-Dired Commands
861 861
862@cindex Multiple Dired directories 862@cindex Multiple Dired directories
@@ -876,8 +876,8 @@ The command @code{dired-smart-shell-command}, bound to @kbd{M-!} in
876Dired buffers, is like @code{shell-command}, but it runs with 876Dired buffers, is like @code{shell-command}, but it runs with
877@code{default-directory} bound to the current Dired directory. 877@code{default-directory} bound to the current Dired directory.
878 878
879@node Find File At Point, Miscellaneous Commands, Multiple Dired Directories, Top 879@node Find File At Point
880@section Find File At Point 880@chapter Find File At Point
881@cindex Visiting a file mentioned in a buffer 881@cindex Visiting a file mentioned in a buffer
882@cindex Finding a file at point 882@cindex Finding a file at point
883 883
@@ -952,7 +952,7 @@ that uses the value of @code{dired-x-hands-off-my-keys} to determine if
952@code{find-file-other-window}. See @xref{Optional Installation File At Point}. 952@code{find-file-other-window}. See @xref{Optional Installation File At Point}.
953@end table 953@end table
954 954
955@node Miscellaneous Commands, Bugs, Find File At Point, Top 955@node Miscellaneous Commands
956@chapter Miscellaneous Commands 956@chapter Miscellaneous Commands
957 957
958Miscellaneous features not fitting anywhere else: 958Miscellaneous features not fitting anywhere else:
@@ -1082,7 +1082,7 @@ Bound to @kbd{%Y}. Relative symlink all marked files containing
1082info. 1082info.
1083@end table 1083@end table
1084 1084
1085@node Bugs, GNU Free Documentation License, Miscellaneous Commands, Top 1085@node Bugs
1086@chapter Bugs 1086@chapter Bugs
1087@cindex Bugs 1087@cindex Bugs
1088 1088
@@ -1090,23 +1090,23 @@ info.
1090If you encounter a bug in this package, or wish to suggest an 1090If you encounter a bug in this package, or wish to suggest an
1091enhancement, then please use @kbd{M-x report-emacs-bug} to report it. 1091enhancement, then please use @kbd{M-x report-emacs-bug} to report it.
1092 1092
1093@node GNU Free Documentation License, Concept Index, Bugs, Top 1093@node GNU Free Documentation License
1094@appendix GNU Free Documentation License 1094@appendix GNU Free Documentation License
1095@include doclicense.texi 1095@include doclicense.texi
1096 1096
1097@node Concept Index, Command Index, GNU Free Documentation License, Top 1097@node Concept Index
1098@unnumbered Concept Index 1098@unnumbered Concept Index
1099@printindex cp 1099@printindex cp
1100 1100
1101@node Command Index, Key Index, Concept Index, Top 1101@node Command Index
1102@unnumbered Function Index 1102@unnumbered Function Index
1103@printindex fn 1103@printindex fn
1104 1104
1105@node Key Index, Variable Index, Command Index, Top 1105@node Key Index
1106@unnumbered Key Index 1106@unnumbered Key Index
1107@printindex ky 1107@printindex ky
1108 1108
1109@node Variable Index, , Key Index, Top 1109@node Variable Index
1110@unnumbered Variable Index 1110@unnumbered Variable Index
1111@printindex vr 1111@printindex vr
1112 1112