aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorTom Tromey2013-01-05 19:36:45 -0700
committerTom Tromey2013-01-05 19:36:45 -0700
commite078a23febca14bc919c5806670479c395e3253e (patch)
treee9e4ed91feef744d525264c31974c3ed00146bcd /doc/misc
parent63d535c829a930207b64fe733228f15a554644b1 (diff)
parent7a2657fa3bedbd977f4e11fe030cb4a210c04ab4 (diff)
downloademacs-e078a23febca14bc919c5806670479c395e3253e.tar.gz
emacs-e078a23febca14bc919c5806670479c395e3253e.zip
merge from trunk
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/ChangeLog147
-rw-r--r--doc/misc/Makefile.in331
-rw-r--r--doc/misc/ada-mode.texi83
-rw-r--r--doc/misc/auth.texi34
-rw-r--r--doc/misc/autotype.texi40
-rw-r--r--doc/misc/bovine.texi11
-rw-r--r--doc/misc/calc.texi65
-rw-r--r--doc/misc/cc-mode.texi67
-rw-r--r--doc/misc/cl.texi5
-rw-r--r--doc/misc/dbus.texi5
-rw-r--r--doc/misc/dired-x.texi5
-rw-r--r--doc/misc/ebrowse.texi138
-rw-r--r--doc/misc/ede.texi34
-rw-r--r--doc/misc/ediff.texi65
-rw-r--r--doc/misc/edt.texi19
-rw-r--r--doc/misc/eieio.texi19
-rw-r--r--doc/misc/emacs-gnutls.texi26
-rw-r--r--doc/misc/emacs-mime.texi7
-rw-r--r--doc/misc/epa.texi18
-rw-r--r--doc/misc/erc.texi13
-rw-r--r--doc/misc/ert.texi80
-rw-r--r--doc/misc/eshell.texi11
-rw-r--r--doc/misc/eudc.texi80
-rw-r--r--doc/misc/faq.texi4
-rw-r--r--doc/misc/flymake.texi20
-rw-r--r--doc/misc/forms.texi7
-rw-r--r--doc/misc/gnus-coding.texi28
-rw-r--r--doc/misc/gnus-faq.texi6
-rw-r--r--doc/misc/gnus-news.el4
-rw-r--r--doc/misc/gnus-news.texi2
-rw-r--r--doc/misc/gnus.texi77
-rw-r--r--doc/misc/htmlfontify.texi1612
-rw-r--r--doc/misc/idlwave.texi195
-rw-r--r--doc/misc/info.texi22
-rw-r--r--doc/misc/mairix-el.texi14
-rw-r--r--doc/misc/makefile.w32-in188
-rw-r--r--doc/misc/message.texi11
-rw-r--r--doc/misc/mh-e.texi16
-rw-r--r--doc/misc/newsticker.texi11
-rw-r--r--doc/misc/nxml-mode.texi22
-rw-r--r--doc/misc/org.texi83
-rw-r--r--doc/misc/pcl-cvs.texi85
-rw-r--r--doc/misc/pgg.texi9
-rw-r--r--doc/misc/rcirc.texi56
-rw-r--r--doc/misc/reftex.texi200
-rw-r--r--doc/misc/remember.texi49
-rw-r--r--doc/misc/sasl.texi41
-rw-r--r--doc/misc/sc.texi7
-rw-r--r--doc/misc/sem-user.texi14
-rw-r--r--doc/misc/semantic.texi6
-rw-r--r--doc/misc/ses.texi65
-rw-r--r--doc/misc/sieve.texi7
-rw-r--r--doc/misc/smtpmail.texi20
-rw-r--r--doc/misc/speedbar.texi86
-rw-r--r--doc/misc/srecode.texi19
-rw-r--r--doc/misc/texinfo.tex7
-rw-r--r--doc/misc/tramp.texi47
-rw-r--r--doc/misc/trampver.texi2
-rw-r--r--doc/misc/url.texi6
-rw-r--r--doc/misc/vip.texi103
-rw-r--r--doc/misc/viper.texi195
-rw-r--r--doc/misc/widget.texi195
-rw-r--r--doc/misc/wisent.texi31
-rw-r--r--doc/misc/woman.texi107
64 files changed, 3281 insertions, 1701 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 1ca638bb7fe..d756f4fd0f0 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,144 @@
12013-01-05 Andreas Schwab <schwab@linux-m68k.org>
2
3 * ada-mode.texi: Remove braces from @title argument.
4 * eudc.texi: Likewise.
5 * smtpmail.texi: Likewise.
6 * auth.texi (VERSION): Set before first use.
7 * emacs-gnutls.texi (VERSION): Likewise.
8 * pgg.texi (VERSION): Likewise.
9 * ede.texi (Top): Rename from top, all uses changed.
10 * eshell.texi: Add missing argument to @sp.
11 * forms.texi (Top): Reorder menu to match structure.
12 * htmlfontify.texi (Customisation): Add missing @item in
13 @enumerate.
14 * org.texi (Advanced features): Add missing argument for @item.
15 (Property searches): Use @backslashchar{} in macro argument.
16 * pcl-cvs.texi: Add missing argument to @sp.
17 (Movement commands): Fix use of @itemx.
18 * vip.texi (Misc Commands, Viewing the Buffer): Likewise.
19 * reftex.texi (Options (Creating Citations)): Add missing newline
20 before @end.
21 * tramp.texi (Obtaining Tramp): Remove extra dots.
22 (Configuration): Reorder menu to match structure.
23 (Remote shell setup): Replace literal NUL character by \0.
24 * viper.texi (Marking): Add missing argument for @item.
25
262013-01-04 Glenn Morris <rgm@gnu.org>
27
28 * Makefile.in (INFO_TARGETS, DVI_TARGETS, PDF_TARGETS):
29 Add htmlfontify.
30 (htmlfontify, $(buildinfodir)/htmlfontify$(INFO_EXT))
31 (htmlfontify.dvi, htmlfontify.pdf): New targets.
32 * makefile.w32-in (INFO_TARGETS, DVI_TARGETS, clean): Add htmlfontify.
33 ($(infodir)/htmlfontify$(INFO_EXT), htmlfontify.dvi): New targets.
34
35 * htmlfontify.texi: Miscellaneous fixes and updates.
36 Set copyright to FSF, update license to GFDL 1.3+.
37
382013-01-04 Vivek Dasmohapatra <vivek@etla.org>
39
40 * htmlfontify.texi: New file.
41
422013-01-02 Jay Belanger <jay.p.belanger@gmail.com>
43
44 * calc.texi (Free-Form Dates): Expand on the date reading
45 algorithm.
46
472012-12-27 Glenn Morris <rgm@gnu.org>
48
49 * viper.texi (Rudimentary Changes, Key Bindings, Key Bindings):
50 Avoid some overfull lines.
51
52 * widget.texi (Programming Example): Break some long lines.
53
54 * wisent.texi (Wisent Overview): Fix xref.
55 (Grammar format, Understanding the automaton): Avoid overfill.
56
57 * bovine.texi (Optional Lambda Expression): Allow line break.
58
59 * auth.texi (Help for users): Break long lines.
60
61 * ada-mode.texi (Project file variables):
62 Reword to reduce underfull hbox.
63 (No project files, Use GNAT project file):
64 Use smallexample to make some overfull lines less terrible.
65
66 * autotype.texi, bovine.texi, ede.texi, eieio.texi, pcl-cvs.texi:
67 Fix cross-references to separate manuals.
68
69 * Makefile.in (gfdl): New variable. Use throughout where
70 appropriate so that targets depend on doclicense.texi.
71
722012-12-25 Lars Ingebrigtsen <larsi@gnus.org>
73
74 * gnus.texi (Customizing the IMAP Connection): Mention the other
75 authenticators.
76
772012-12-24 Lars Ingebrigtsen <larsi@gnus.org>
78
79 * gnus.texi (Browse Foreign Server): Document
80 `gnus-browse-delete-group'.
81
822012-12-22 Glenn Morris <rgm@gnu.org>
83
84 * ada-mode.texi, ebrowse.texi, ediff.texi, ert.texi, eshell.texi:
85 * eudc.texi, idlwave.texi, pcl-cvs.texi, rcirc.texi, reftex.texi:
86 * remember.texi, ses.texi, speedbar.texi, vip.texi, viper.texi:
87 * widget.texi, wisent.texi: Nuke hand-written node pointers.
88
89 * Makefile.in (gfdl): New variable. Use throughout where
90 appropriate so that targets depend on doclicense.texi.
91
922012-12-22 Eli Zaretskii <eliz@gnu.org>
93
94 * makefile.w32-in ($(INFO_TARGETS), $(DVI_TARGETS)): Depend on
95 doclicense.texi. Remove doclicense.texi from all targets that
96 mentioned it explicitly.
97 ($(infodir)/woman$(INFO_EXT), woman.dvi): Depend on
98 $(emacsdir)/emacsver.texi.
99 ($(infodir)/erc$(INFO_EXT), erc.dvi): Don't depend on gpl.texi.
100
1012012-12-21 Glenn Morris <rgm@gnu.org>
102
103 * woman.texi (UPDATED, VERSION): Remove in favor of EMACSVER.
104 Include emacsver.texi. Nuke hand-written node pointers.
105 * Makefile.in ($(buildinfodir)/woman$(INFO_EXT), woman.dvi, woman.pdf):
106 Depend on emacsver.texi.
107
108 * auth.texi, emacs-gnutls.texi, epa.texi, ert.texi:
109 * gnus-coding.texi, info.texi, nxml-mode.texi, sasl.texi:
110 May as well just include doclicense.texi in everything.
111
112 * ede.texi, eieio.texi, mairix-el.texi: Include a copy of GFDL,
113 which @copying says is included.
114
115 * ada-mode.texi, auth.texi, autotype.texi, bovine.texi, calc.texi:
116 * cc-mode.texi, cl.texi, dbus.texi, dired-x.texi, ebrowse.texi:
117 * ede.texi, ediff.texi, edt.texi, eieio.texi, emacs-gnutls.texi:
118 * emacs-mime.texi, epa.texi, erc.texi, ert.texi, eshell.texi:
119 * eudc.texi, flymake.texi, forms.texi, gnus-coding.texi, gnus.texi:
120 * idlwave.texi, info.texi, mairix-el.texi, message.texi, mh-e.texi:
121 * newsticker.texi, nxml-mode.texi, pcl-cvs.texi, pgg.texi:
122 * rcirc.texi, reftex.texi, remember.texi, sasl.texi, sc.texi:
123 * semantic.texi, ses.texi, sieve.texi, smtpmail.texi, speedbar.texi:
124 * srecode.texi, tramp.texi, url.texi, vip.texi, viper.texi:
125 * widget.texi, wisent.texi, woman.texi: Do not mention buying
126 copies from the FSF, which does not publish these manuals.
127
128 * erc.texi: No need to include gpl in this small manual.
129
130 * org.texi (copying): Include a copy of the GFDL.
131 (GNU Free Documentation License): New section.
132
1332012-12-21 Bastien Guerry <bzg@gnu.org>
134
135 * org.texi: Fix typos.
136
1372012-12-16 Paul Eggert <eggert@cs.ucla.edu>
138
139 * calc.texi (ISO 8601): Rename from ISO-8601,
140 as it's typically spelled without a hyphen.
141
12012-12-16 Jay Belanger <jay.p.belanger@gmail.com> 1422012-12-16 Jay Belanger <jay.p.belanger@gmail.com>
2 143
3 * calc.texi (ISO-8601): New section. 144 * calc.texi (ISO-8601): New section.
@@ -435,7 +576,7 @@
435 * org.texi (Moving subtrees): Document the ability to archive to a 576 * org.texi (Moving subtrees): Document the ability to archive to a
436 datetree. 577 datetree.
437 578
4382012-09-30 Bastien Guerry <bzg@altern.org> 5792012-09-30 Bastien Guerry <bzg@gnu.org>
439 580
440 * org.texi (Installation, Feedback, Batch execution): Use 581 * org.texi (Installation, Feedback, Batch execution): Use
441 (add-to-list 'load-path ... t) for the contrib dir. 582 (add-to-list 'load-path ... t) for the contrib dir.
@@ -1041,7 +1182,7 @@
1041 1182
1042 * org.texi: Edit :noweb no header argument for correctness. 1183 * org.texi: Edit :noweb no header argument for correctness.
1043 1184
10442012-04-01 Bastien Guerry <bzg@altern.org> 11852012-04-01 Bastien Guerry <bzg@gnu.org>
1045 1186
1046 * org.texi (Customization): Update the approximate number of Org 1187 * org.texi (Customization): Update the approximate number of Org
1047 variables. 1188 variables.
@@ -9812,7 +9953,7 @@
9812;; coding: utf-8 9953;; coding: utf-8
9813;; End: 9954;; End:
9814 9955
9815 Copyright (C) 1993-1999, 2001-2012 Free Software Foundation, Inc. 9956 Copyright (C) 1993-1999, 2001-2013 Free Software Foundation, Inc.
9816 9957
9817 This file is part of GNU Emacs. 9958 This file is part of GNU Emacs.
9818 9959
diff --git a/doc/misc/Makefile.in b/doc/misc/Makefile.in
index c99657fb9bb..3dac35aafee 100644
--- a/doc/misc/Makefile.in
+++ b/doc/misc/Makefile.in
@@ -1,6 +1,6 @@
1#### Makefile for documentation other than the Emacs manual. 1#### Makefile for documentation other than the Emacs manual.
2 2
3# Copyright (C) 1994, 1996-2012 Free Software Foundation, Inc. 3# Copyright (C) 1994, 1996-2013 Free Software Foundation, Inc.
4 4
5# This file is part of GNU Emacs. 5# This file is part of GNU Emacs.
6 6
@@ -27,7 +27,6 @@ srcdir=@srcdir@
27## Where the output files go. 27## Where the output files go.
28buildinfodir = $(srcdir)/../../info 28buildinfodir = $(srcdir)/../../info
29## Directory with emacsver.texi. 29## Directory with emacsver.texi.
30## Currently only used by efaq and calc.
31emacsdir = $(srcdir)/../emacs 30emacsdir = $(srcdir)/../emacs
32 31
33MKDIR_P = @MKDIR_P@ 32MKDIR_P = @MKDIR_P@
@@ -44,7 +43,7 @@ MAKEINFO_OPTS = --force -I$(emacsdir)
44INFO_TARGETS = ada-mode auth autotype bovine calc ccmode cl \ 43INFO_TARGETS = ada-mode auth autotype bovine calc ccmode cl \
45 dbus dired-x ebrowse ede ediff edt eieio \ 44 dbus dired-x ebrowse ede ediff edt eieio \
46 emacs-mime epa erc ert eshell eudc efaq \ 45 emacs-mime epa erc ert eshell eudc efaq \
47 flymake forms gnus emacs-gnutls idlwave info.info \ 46 flymake forms gnus emacs-gnutls htmlfontify idlwave info.info \
48 mairix-el message mh-e newsticker nxml-mode \ 47 mairix-el message mh-e newsticker nxml-mode \
49 org pcl-cvs pgg rcirc remember reftex sasl \ 48 org pcl-cvs pgg rcirc remember reftex sasl \
50 sc semantic ses sieve smtpmail speedbar srecode tramp \ 49 sc semantic ses sieve smtpmail speedbar srecode tramp \
@@ -76,6 +75,7 @@ DVI_TARGETS = \
76 forms.dvi \ 75 forms.dvi \
77 gnus.dvi \ 76 gnus.dvi \
78 emacs-gnutls.dvi \ 77 emacs-gnutls.dvi \
78 htmlfontify.dvi \
79 idlwave.dvi \ 79 idlwave.dvi \
80 info.dvi \ 80 info.dvi \
81 mairix-el.dvi \ 81 mairix-el.dvi \
@@ -130,6 +130,7 @@ PDF_TARGETS = \
130 flymake.pdf \ 130 flymake.pdf \
131 forms.pdf \ 131 forms.pdf \
132 gnus.pdf \ 132 gnus.pdf \
133 htmlfontify.pdf \
133 emacs-gnutls.pdf \ 134 emacs-gnutls.pdf \
134 idlwave.pdf \ 135 idlwave.pdf \
135 info.pdf \ 136 info.pdf \
@@ -170,6 +171,8 @@ ENVADD = TEXINPUTS="$(srcdir):$(emacsdir):$(TEXINPUTS)" \
170 171
171mkinfodir = @${MKDIR_P} ${buildinfodir} 172mkinfodir = @${MKDIR_P} ${buildinfodir}
172 173
174gfdl = ${srcdir}/doclicense.texi
175
173.PHONY: info dvi pdf echo-info 176.PHONY: info dvi pdf echo-info
174## Prevent implicit rule triggering for foo.info. 177## Prevent implicit rule triggering for foo.info.
175.SUFFIXES: 178.SUFFIXES:
@@ -198,194 +201,195 @@ pdf: $(PDF_TARGETS)
198# Note: "<" is not portable in ordinary make rules. 201# Note: "<" is not portable in ordinary make rules.
199 202
200ada-mode : $(buildinfodir)/ada-mode$(INFO_EXT) 203ada-mode : $(buildinfodir)/ada-mode$(INFO_EXT)
201$(buildinfodir)/ada-mode$(INFO_EXT): ${srcdir}/ada-mode.texi 204$(buildinfodir)/ada-mode$(INFO_EXT): ${srcdir}/ada-mode.texi ${gfdl}
202 $(mkinfodir) 205 $(mkinfodir)
203 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ada-mode.texi 206 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ada-mode.texi
204ada-mode.dvi: ${srcdir}/ada-mode.texi 207ada-mode.dvi: ${srcdir}/ada-mode.texi ${gfdl}
205 $(ENVADD) $(TEXI2DVI) ${srcdir}/ada-mode.texi 208 $(ENVADD) $(TEXI2DVI) ${srcdir}/ada-mode.texi
206ada-mode.pdf: ${srcdir}/ada-mode.texi 209ada-mode.pdf: ${srcdir}/ada-mode.texi ${gfdl}
207 $(ENVADD) $(TEXI2PDF) ${srcdir}/ada-mode.texi 210 $(ENVADD) $(TEXI2PDF) ${srcdir}/ada-mode.texi
208 211
209auth : $(buildinfodir)/auth$(INFO_EXT) 212auth : $(buildinfodir)/auth$(INFO_EXT)
210$(buildinfodir)/auth$(INFO_EXT): ${srcdir}/auth.texi 213$(buildinfodir)/auth$(INFO_EXT): ${srcdir}/auth.texi ${gfdl}
211 $(mkinfodir) 214 $(mkinfodir)
212 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/auth.texi 215 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/auth.texi
213auth.dvi: ${srcdir}/auth.texi 216auth.dvi: ${srcdir}/auth.texi ${gfdl}
214 $(ENVADD) $(TEXI2DVI) ${srcdir}/auth.texi 217 $(ENVADD) $(TEXI2DVI) ${srcdir}/auth.texi
215auth.pdf: ${srcdir}/auth.texi 218auth.pdf: ${srcdir}/auth.texi ${gfdl}
216 $(ENVADD) $(TEXI2PDF) ${srcdir}/auth.texi 219 $(ENVADD) $(TEXI2PDF) ${srcdir}/auth.texi
217 220
218autotype : $(buildinfodir)/autotype$(INFO_EXT) 221autotype : $(buildinfodir)/autotype$(INFO_EXT)
219$(buildinfodir)/autotype$(INFO_EXT): ${srcdir}/autotype.texi 222$(buildinfodir)/autotype$(INFO_EXT): ${srcdir}/autotype.texi ${gfdl}
220 $(mkinfodir) 223 $(mkinfodir)
221 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/autotype.texi 224 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/autotype.texi
222autotype.dvi: ${srcdir}/autotype.texi 225autotype.dvi: ${srcdir}/autotype.texi ${gfdl}
223 $(ENVADD) $(TEXI2DVI) ${srcdir}/autotype.texi 226 $(ENVADD) $(TEXI2DVI) ${srcdir}/autotype.texi
224autotype.pdf: ${srcdir}/autotype.texi 227autotype.pdf: ${srcdir}/autotype.texi ${gfdl}
225 $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi 228 $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi
226 229
227bovine : $(buildinfodir)/bovine$(INFO_EXT) 230bovine : $(buildinfodir)/bovine$(INFO_EXT)
228$(buildinfodir)/bovine$(INFO_EXT): ${srcdir}/bovine.texi 231$(buildinfodir)/bovine$(INFO_EXT): ${srcdir}/bovine.texi ${gfdl}
229 $(mkinfodir) 232 $(mkinfodir)
230 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/bovine.texi 233 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/bovine.texi
231bovine.dvi: ${srcdir}/bovine.texi 234bovine.dvi: ${srcdir}/bovine.texi ${gfdl}
232 $(ENVADD) $(TEXI2DVI) ${srcdir}/bovine.texi 235 $(ENVADD) $(TEXI2DVI) ${srcdir}/bovine.texi
233bovine.pdf: ${srcdir}/bovine.texi 236bovine.pdf: ${srcdir}/bovine.texi ${gfdl}
234 $(ENVADD) $(TEXI2PDF) ${srcdir}/bovine.texi 237 $(ENVADD) $(TEXI2PDF) ${srcdir}/bovine.texi
235 238
236calc : $(buildinfodir)/calc$(INFO_EXT) 239calc : $(buildinfodir)/calc$(INFO_EXT)
237$(buildinfodir)/calc$(INFO_EXT): ${srcdir}/calc.texi $(emacsdir)/emacsver.texi 240$(buildinfodir)/calc$(INFO_EXT): ${srcdir}/calc.texi $(emacsdir)/emacsver.texi ${gfdl}
238 $(mkinfodir) 241 $(mkinfodir)
239 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/calc.texi 242 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/calc.texi
240calc.dvi: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi 243calc.dvi: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi ${gfdl}
241 $(ENVADD) $(TEXI2DVI) ${srcdir}/calc.texi 244 $(ENVADD) $(TEXI2DVI) ${srcdir}/calc.texi
242calc.pdf: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi 245calc.pdf: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi ${gfdl}
243 $(ENVADD) $(TEXI2PDF) ${srcdir}/calc.texi 246 $(ENVADD) $(TEXI2PDF) ${srcdir}/calc.texi
244 247
245ccmode : $(buildinfodir)/ccmode$(INFO_EXT) 248ccmode : $(buildinfodir)/ccmode$(INFO_EXT)
246$(buildinfodir)/ccmode$(INFO_EXT): ${srcdir}/cc-mode.texi 249$(buildinfodir)/ccmode$(INFO_EXT): ${srcdir}/cc-mode.texi ${gfdl}
247 $(mkinfodir) 250 $(mkinfodir)
248 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/cc-mode.texi 251 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/cc-mode.texi
249cc-mode.dvi: ${srcdir}/cc-mode.texi 252cc-mode.dvi: ${srcdir}/cc-mode.texi ${gfdl}
250 $(ENVADD) $(TEXI2DVI) ${srcdir}/cc-mode.texi 253 $(ENVADD) $(TEXI2DVI) ${srcdir}/cc-mode.texi
251cc-mode.pdf: ${srcdir}/cc-mode.texi 254cc-mode.pdf: ${srcdir}/cc-mode.texi ${gfdl}
252 $(ENVADD) $(TEXI2PDF) ${srcdir}/cc-mode.texi 255 $(ENVADD) $(TEXI2PDF) ${srcdir}/cc-mode.texi
253 256
254cl : $(buildinfodir)/cl$(INFO_EXT) 257cl : $(buildinfodir)/cl$(INFO_EXT)
255$(buildinfodir)/cl$(INFO_EXT): ${srcdir}/cl.texi $(emacsdir)/emacsver.texi 258$(buildinfodir)/cl$(INFO_EXT): ${srcdir}/cl.texi $(emacsdir)/emacsver.texi ${gfdl}
256 $(mkinfodir) 259 $(mkinfodir)
257 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/cl.texi 260 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/cl.texi
258cl.dvi: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi 261cl.dvi: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi ${gfdl}
259 $(ENVADD) $(TEXI2DVI) ${srcdir}/cl.texi 262 $(ENVADD) $(TEXI2DVI) ${srcdir}/cl.texi
260cl.pdf: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi 263cl.pdf: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi ${gfdl}
261 $(ENVADD) $(TEXI2PDF) ${srcdir}/cl.texi 264 $(ENVADD) $(TEXI2PDF) ${srcdir}/cl.texi
262 265
263dbus : $(buildinfodir)/dbus$(INFO_EXT) 266dbus : $(buildinfodir)/dbus$(INFO_EXT)
264$(buildinfodir)/dbus$(INFO_EXT): ${srcdir}/dbus.texi 267$(buildinfodir)/dbus$(INFO_EXT): ${srcdir}/dbus.texi ${gfdl}
265 $(mkinfodir) 268 $(mkinfodir)
266 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/dbus.texi 269 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/dbus.texi
267dbus.dvi: ${srcdir}/dbus.texi 270dbus.dvi: ${srcdir}/dbus.texi ${gfdl}
268 $(ENVADD) $(TEXI2DVI) ${srcdir}/dbus.texi 271 $(ENVADD) $(TEXI2DVI) ${srcdir}/dbus.texi
269dbus.pdf: ${srcdir}/dbus.texi 272dbus.pdf: ${srcdir}/dbus.texi ${gfdl}
270 $(ENVADD) $(TEXI2PDF) ${srcdir}/dbus.texi 273 $(ENVADD) $(TEXI2PDF) ${srcdir}/dbus.texi
271 274
272dired-x : $(buildinfodir)/dired-x$(INFO_EXT) 275dired-x : $(buildinfodir)/dired-x$(INFO_EXT)
273$(buildinfodir)/dired-x$(INFO_EXT): ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi 276$(buildinfodir)/dired-x$(INFO_EXT): ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi ${gfdl}
274 $(mkinfodir) 277 $(mkinfodir)
275 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/dired-x.texi 278 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/dired-x.texi
276dired-x.dvi: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi 279dired-x.dvi: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi ${gfdl}
277 $(ENVADD) $(TEXI2DVI) ${srcdir}/dired-x.texi 280 $(ENVADD) $(TEXI2DVI) ${srcdir}/dired-x.texi
278dired-x.pdf: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi 281dired-x.pdf: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi ${gfdl}
279 $(ENVADD) $(TEXI2PDF) ${srcdir}/dired-x.texi 282 $(ENVADD) $(TEXI2PDF) ${srcdir}/dired-x.texi
280 283
281ebrowse : $(buildinfodir)/ebrowse$(INFO_EXT) 284ebrowse : $(buildinfodir)/ebrowse$(INFO_EXT)
282$(buildinfodir)/ebrowse$(INFO_EXT): ${srcdir}/ebrowse.texi 285$(buildinfodir)/ebrowse$(INFO_EXT): ${srcdir}/ebrowse.texi ${gfdl}
283 $(mkinfodir) 286 $(mkinfodir)
284 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ebrowse.texi 287 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ebrowse.texi
285ebrowse.dvi: ${srcdir}/ebrowse.texi 288ebrowse.dvi: ${srcdir}/ebrowse.texi ${gfdl}
286 $(ENVADD) $(TEXI2DVI) ${srcdir}/ebrowse.texi 289 $(ENVADD) $(TEXI2DVI) ${srcdir}/ebrowse.texi
287ebrowse.pdf: ${srcdir}/ebrowse.texi 290ebrowse.pdf: ${srcdir}/ebrowse.texi ${gfdl}
288 $(ENVADD) $(TEXI2PDF) ${srcdir}/ebrowse.texi 291 $(ENVADD) $(TEXI2PDF) ${srcdir}/ebrowse.texi
289 292
290ede : $(buildinfodir)/ede$(INFO_EXT) 293ede : $(buildinfodir)/ede$(INFO_EXT)
291$(buildinfodir)/ede$(INFO_EXT): ${srcdir}/ede.texi 294$(buildinfodir)/ede$(INFO_EXT): ${srcdir}/ede.texi ${gfdl}
292 $(mkinfodir) 295 $(mkinfodir)
293 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ede.texi 296 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ede.texi
294ede.dvi: ${srcdir}/ede.texi 297ede.dvi: ${srcdir}/ede.texi ${gfdl}
295 $(ENVADD) $(TEXI2DVI) ${srcdir}/ede.texi 298 $(ENVADD) $(TEXI2DVI) ${srcdir}/ede.texi
296ede.pdf: ${srcdir}/ede.texi 299ede.pdf: ${srcdir}/ede.texi ${gfdl}
297 $(ENVADD) $(TEXI2PDF) ${srcdir}/ede.texi 300 $(ENVADD) $(TEXI2PDF) ${srcdir}/ede.texi
298 301
299ediff : $(buildinfodir)/ediff$(INFO_EXT) 302ediff : $(buildinfodir)/ediff$(INFO_EXT)
300$(buildinfodir)/ediff$(INFO_EXT): ${srcdir}/ediff.texi 303$(buildinfodir)/ediff$(INFO_EXT): ${srcdir}/ediff.texi ${gfdl}
301 $(mkinfodir) 304 $(mkinfodir)
302 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ediff.texi 305 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ediff.texi
303ediff.dvi: ${srcdir}/ediff.texi 306ediff.dvi: ${srcdir}/ediff.texi ${gfdl}
304 $(ENVADD) $(TEXI2DVI) ${srcdir}/ediff.texi 307 $(ENVADD) $(TEXI2DVI) ${srcdir}/ediff.texi
305ediff.pdf: ${srcdir}/ediff.texi 308ediff.pdf: ${srcdir}/ediff.texi ${gfdl}
306 $(ENVADD) $(TEXI2PDF) ${srcdir}/ediff.texi 309 $(ENVADD) $(TEXI2PDF) ${srcdir}/ediff.texi
307 310
308edt : $(buildinfodir)/edt$(INFO_EXT) 311edt : $(buildinfodir)/edt$(INFO_EXT)
309$(buildinfodir)/edt$(INFO_EXT): ${srcdir}/edt.texi 312$(buildinfodir)/edt$(INFO_EXT): ${srcdir}/edt.texi ${gfdl}
310 $(mkinfodir) 313 $(mkinfodir)
311 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/edt.texi 314 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/edt.texi
312edt.dvi: ${srcdir}/edt.texi 315edt.dvi: ${srcdir}/edt.texi ${gfdl}
313 $(ENVADD) $(TEXI2DVI) ${srcdir}/edt.texi 316 $(ENVADD) $(TEXI2DVI) ${srcdir}/edt.texi
314edt.pdf: ${srcdir}/edt.texi 317edt.pdf: ${srcdir}/edt.texi ${gfdl}
315 $(ENVADD) $(TEXI2PDF) ${srcdir}/edt.texi 318 $(ENVADD) $(TEXI2PDF) ${srcdir}/edt.texi
316 319
317eieio : $(buildinfodir)/eieio$(INFO_EXT) 320eieio : $(buildinfodir)/eieio$(INFO_EXT)
318$(buildinfodir)/eieio$(INFO_EXT): ${srcdir}/eieio.texi 321$(buildinfodir)/eieio$(INFO_EXT): ${srcdir}/eieio.texi ${gfdl}
319 $(mkinfodir) 322 $(mkinfodir)
320 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eieio.texi 323 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eieio.texi
321eieio.dvi: ${srcdir}/eieio.texi 324eieio.dvi: ${srcdir}/eieio.texi ${gfdl}
322 $(ENVADD) $(TEXI2DVI) ${srcdir}/eieio.texi 325 $(ENVADD) $(TEXI2DVI) ${srcdir}/eieio.texi
323eieio.pdf: ${srcdir}/eieio.texi 326eieio.pdf: ${srcdir}/eieio.texi ${gfdl}
324 $(ENVADD) $(TEXI2PDF) ${srcdir}/eieio.texi 327 $(ENVADD) $(TEXI2PDF) ${srcdir}/eieio.texi
325 328
326emacs-gnutls : $(buildinfodir)/emacs-gnutls$(INFO_EXT) 329emacs-gnutls : $(buildinfodir)/emacs-gnutls$(INFO_EXT)
327$(buildinfodir)/emacs-gnutls$(INFO_EXT): ${srcdir}/emacs-gnutls.texi 330$(buildinfodir)/emacs-gnutls$(INFO_EXT): ${srcdir}/emacs-gnutls.texi ${gfdl}
328 $(mkinfodir) 331 $(mkinfodir)
329 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/emacs-gnutls.texi 332 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/emacs-gnutls.texi
330emacs-gnutls.dvi: ${srcdir}/emacs-gnutls.texi 333emacs-gnutls.dvi: ${srcdir}/emacs-gnutls.texi ${gfdl}
331 $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-gnutls.texi 334 $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-gnutls.texi
332emacs-gnutls.pdf: ${srcdir}/emacs-gnutls.texi 335emacs-gnutls.pdf: ${srcdir}/emacs-gnutls.texi ${gfdl}
333 $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-gnutls.texi 336 $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-gnutls.texi
334 337
335emacs-mime : $(buildinfodir)/emacs-mime$(INFO_EXT) 338emacs-mime : $(buildinfodir)/emacs-mime$(INFO_EXT)
336$(buildinfodir)/emacs-mime$(INFO_EXT): ${srcdir}/emacs-mime.texi 339$(buildinfodir)/emacs-mime$(INFO_EXT): ${srcdir}/emacs-mime.texi ${gfdl}
337 $(mkinfodir) 340 $(mkinfodir)
338 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) --enable-encoding -o $@ ${srcdir}/emacs-mime.texi 341 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) --enable-encoding -o $@ ${srcdir}/emacs-mime.texi
339emacs-mime.dvi: ${srcdir}/emacs-mime.texi 342emacs-mime.dvi: ${srcdir}/emacs-mime.texi ${gfdl}
340 $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi 343 $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi
341emacs-mime.pdf: ${srcdir}/emacs-mime.texi 344emacs-mime.pdf: ${srcdir}/emacs-mime.texi ${gfdl}
342 $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-mime.texi 345 $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-mime.texi
343 346
344epa : $(buildinfodir)/epa$(INFO_EXT) 347epa : $(buildinfodir)/epa$(INFO_EXT)
345$(buildinfodir)/epa$(INFO_EXT): ${srcdir}/epa.texi 348$(buildinfodir)/epa$(INFO_EXT): ${srcdir}/epa.texi ${gfdl}
346 $(mkinfodir) 349 $(mkinfodir)
347 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/epa.texi 350 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/epa.texi
348epa.dvi: ${srcdir}/epa.texi 351epa.dvi: ${srcdir}/epa.texi ${gfdl}
349 $(ENVADD) $(TEXI2DVI) ${srcdir}/epa.texi 352 $(ENVADD) $(TEXI2DVI) ${srcdir}/epa.texi
350epa.pdf: ${srcdir}/epa.texi 353epa.pdf: ${srcdir}/epa.texi ${gfdl}
351 $(ENVADD) $(TEXI2PDF) ${srcdir}/epa.texi 354 $(ENVADD) $(TEXI2PDF) ${srcdir}/epa.texi
352 355
353erc : $(buildinfodir)/erc$(INFO_EXT) 356erc : $(buildinfodir)/erc$(INFO_EXT)
354$(buildinfodir)/erc$(INFO_EXT): ${srcdir}/erc.texi $(emacsdir)/emacsver.texi 357$(buildinfodir)/erc$(INFO_EXT): ${srcdir}/erc.texi $(emacsdir)/emacsver.texi ${gfdl}
355 $(mkinfodir) 358 $(mkinfodir)
356 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/erc.texi 359 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/erc.texi
357erc.dvi: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi 360erc.dvi: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi ${gfdl}
358 $(ENVADD) $(TEXI2DVI) ${srcdir}/erc.texi 361 $(ENVADD) $(TEXI2DVI) ${srcdir}/erc.texi
359erc.pdf: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi 362erc.pdf: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi ${gfdl}
360 $(ENVADD) $(TEXI2PDF) ${srcdir}/erc.texi 363 $(ENVADD) $(TEXI2PDF) ${srcdir}/erc.texi
361 364
362ert : $(buildinfodir)/ert$(INFO_EXT) 365ert : $(buildinfodir)/ert$(INFO_EXT)
363$(buildinfodir)/ert$(INFO_EXT): ${srcdir}/ert.texi 366$(buildinfodir)/ert$(INFO_EXT): ${srcdir}/ert.texi ${gfdl}
364 $(mkinfodir) 367 $(mkinfodir)
365 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ert.texi 368 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ert.texi
366ert.dvi: ${srcdir}/ert.texi 369ert.dvi: ${srcdir}/ert.texi ${gfdl}
367 $(ENVADD) $(TEXI2DVI) ${srcdir}/ert.texi 370 $(ENVADD) $(TEXI2DVI) ${srcdir}/ert.texi
368ert.pdf: ${srcdir}/ert.texi 371ert.pdf: ${srcdir}/ert.texi ${gfdl}
369 $(ENVADD) $(TEXI2PDF) ${srcdir}/ert.texi 372 $(ENVADD) $(TEXI2PDF) ${srcdir}/ert.texi
370 373
371eshell : $(buildinfodir)/eshell$(INFO_EXT) 374eshell : $(buildinfodir)/eshell$(INFO_EXT)
372$(buildinfodir)/eshell$(INFO_EXT): ${srcdir}/eshell.texi 375$(buildinfodir)/eshell$(INFO_EXT): ${srcdir}/eshell.texi ${gfdl}
373 $(mkinfodir) 376 $(mkinfodir)
374 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eshell.texi 377 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eshell.texi
375eshell.dvi: ${srcdir}/eshell.texi 378eshell.dvi: ${srcdir}/eshell.texi ${gfdl}
376 $(ENVADD) $(TEXI2DVI) ${srcdir}/eshell.texi 379 $(ENVADD) $(TEXI2DVI) ${srcdir}/eshell.texi
377eshell.pdf: ${srcdir}/eshell.texi 380eshell.pdf: ${srcdir}/eshell.texi ${gfdl}
378 $(ENVADD) $(TEXI2PDF) ${srcdir}/eshell.texi 381 $(ENVADD) $(TEXI2PDF) ${srcdir}/eshell.texi
379 382
380eudc : $(buildinfodir)/eudc$(INFO_EXT) 383eudc : $(buildinfodir)/eudc$(INFO_EXT)
381$(buildinfodir)/eudc$(INFO_EXT): ${srcdir}/eudc.texi 384$(buildinfodir)/eudc$(INFO_EXT): ${srcdir}/eudc.texi ${gfdl}
382 $(mkinfodir) 385 $(mkinfodir)
383 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eudc.texi 386 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eudc.texi
384eudc.dvi: ${srcdir}/eudc.texi 387eudc.dvi: ${srcdir}/eudc.texi ${gfdl}
385 $(ENVADD) $(TEXI2DVI) ${srcdir}/eudc.texi 388 $(ENVADD) $(TEXI2DVI) ${srcdir}/eudc.texi
386eudc.pdf: ${srcdir}/eudc.texi 389eudc.pdf: ${srcdir}/eudc.texi ${gfdl}
387 $(ENVADD) $(TEXI2PDF) ${srcdir}/eudc.texi 390 $(ENVADD) $(TEXI2PDF) ${srcdir}/eudc.texi
388 391
392## No gfdl dependency.
389efaq : $(buildinfodir)/efaq$(INFO_EXT) 393efaq : $(buildinfodir)/efaq$(INFO_EXT)
390$(buildinfodir)/efaq$(INFO_EXT): ${srcdir}/faq.texi $(emacsdir)/emacsver.texi 394$(buildinfodir)/efaq$(INFO_EXT): ${srcdir}/faq.texi $(emacsdir)/emacsver.texi
391 $(mkinfodir) 395 $(mkinfodir)
@@ -405,292 +409,301 @@ emacs-faq.text: ${srcdir}/faq.texi $(emacsdir)/emacsver.texi
405 $(MAKEINFO) $(MAKEINFO_OPTS) --plaintext -o $@ ${srcdir}/faq.texi 409 $(MAKEINFO) $(MAKEINFO_OPTS) --plaintext -o $@ ${srcdir}/faq.texi
406 410
407flymake : $(buildinfodir)/flymake$(INFO_EXT) 411flymake : $(buildinfodir)/flymake$(INFO_EXT)
408$(buildinfodir)/flymake$(INFO_EXT): ${srcdir}/flymake.texi 412$(buildinfodir)/flymake$(INFO_EXT): ${srcdir}/flymake.texi ${gfdl}
409 $(mkinfodir) 413 $(mkinfodir)
410 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/flymake.texi 414 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/flymake.texi
411flymake.dvi: ${srcdir}/flymake.texi 415flymake.dvi: ${srcdir}/flymake.texi ${gfdl}
412 $(ENVADD) $(TEXI2DVI) ${srcdir}/flymake.texi 416 $(ENVADD) $(TEXI2DVI) ${srcdir}/flymake.texi
413flymake.pdf: ${srcdir}/flymake.texi 417flymake.pdf: ${srcdir}/flymake.texi ${gfdl}
414 $(ENVADD) $(TEXI2PDF) ${srcdir}/flymake.texi 418 $(ENVADD) $(TEXI2PDF) ${srcdir}/flymake.texi
415 419
416forms : $(buildinfodir)/forms$(INFO_EXT) 420forms : $(buildinfodir)/forms$(INFO_EXT)
417$(buildinfodir)/forms$(INFO_EXT): ${srcdir}/forms.texi 421$(buildinfodir)/forms$(INFO_EXT): ${srcdir}/forms.texi ${gfdl}
418 $(mkinfodir) 422 $(mkinfodir)
419 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/forms.texi 423 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/forms.texi
420forms.dvi: ${srcdir}/forms.texi 424forms.dvi: ${srcdir}/forms.texi ${gfdl}
421 $(ENVADD) $(TEXI2DVI) ${srcdir}/forms.texi 425 $(ENVADD) $(TEXI2DVI) ${srcdir}/forms.texi
422forms.pdf: ${srcdir}/forms.texi 426forms.pdf: ${srcdir}/forms.texi ${gfdl}
423 $(ENVADD) $(TEXI2PDF) ${srcdir}/forms.texi 427 $(ENVADD) $(TEXI2PDF) ${srcdir}/forms.texi
424 428
425# gnus/message/emacs-mime/sieve/pgg are part of Gnus: 429# gnus/message/emacs-mime/sieve/pgg are part of Gnus:
426gnus : $(buildinfodir)/gnus$(INFO_EXT) 430gnus : $(buildinfodir)/gnus$(INFO_EXT)
427$(buildinfodir)/gnus$(INFO_EXT): ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi 431$(buildinfodir)/gnus$(INFO_EXT): ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi ${gfdl}
428 $(mkinfodir) 432 $(mkinfodir)
429 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/gnus.texi 433 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/gnus.texi
430gnus.dvi: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi 434gnus.dvi: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi ${gfdl}
431 sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi 435 sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi
432 $(ENVADD) $(TEXI2DVI) gnustmp.texi 436 $(ENVADD) $(TEXI2DVI) gnustmp.texi
433 cp gnustmp.dvi $@ 437 cp gnustmp.dvi $@
434 rm gnustmp.* 438 rm gnustmp.*
435gnus.pdf: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi 439gnus.pdf: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi ${gfdl}
436 sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi 440 sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi
437 $(ENVADD) $(TEXI2PDF) gnustmp.texi 441 $(ENVADD) $(TEXI2PDF) gnustmp.texi
438 cp gnustmp.pdf $@ 442 cp gnustmp.pdf $@
439 rm gnustmp.* 443 rm gnustmp.*
440 444
445htmlfontify : $(buildinfodir)/htmlfontify$(INFO_EXT)
446$(buildinfodir)/htmlfontify$(INFO_EXT): ${srcdir}/htmlfontify.texi ${gfdl}
447 $(mkinfodir)
448 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/htmlfontify.texi
449htmlfontify.dvi: ${srcdir}/htmlfontify.texi ${gfdl}
450 $(ENVADD) $(TEXI2DVI) ${srcdir}/htmlfontify.texi
451htmlfontify.pdf: ${srcdir}/htmlfontify.texi ${gfdl}
452 $(ENVADD) $(TEXI2PDF) ${srcdir}/htmlfontify.texi
453
441# NB this one needs --no-split even without a .info extension. 454# NB this one needs --no-split even without a .info extension.
442idlwave : $(buildinfodir)/idlwave$(INFO_EXT) 455idlwave : $(buildinfodir)/idlwave$(INFO_EXT)
443$(buildinfodir)/idlwave$(INFO_EXT): ${srcdir}/idlwave.texi 456$(buildinfodir)/idlwave$(INFO_EXT): ${srcdir}/idlwave.texi ${gfdl}
444 $(mkinfodir) 457 $(mkinfodir)
445 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/idlwave.texi 458 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/idlwave.texi
446idlwave.dvi: ${srcdir}/idlwave.texi 459idlwave.dvi: ${srcdir}/idlwave.texi ${gfdl}
447 $(ENVADD) $(TEXI2DVI) ${srcdir}/idlwave.texi 460 $(ENVADD) $(TEXI2DVI) ${srcdir}/idlwave.texi
448idlwave.pdf: ${srcdir}/idlwave.texi 461idlwave.pdf: ${srcdir}/idlwave.texi ${gfdl}
449 $(ENVADD) $(TEXI2PDF) ${srcdir}/idlwave.texi 462 $(ENVADD) $(TEXI2PDF) ${srcdir}/idlwave.texi
450 463
451# NB this one needs --no-split even without a .info extension. 464# NB this one needs --no-split even without a .info extension.
452# Avoid name clash with overall "info" target. 465# Avoid name clash with overall "info" target.
453info.info : $(buildinfodir)/info$(INFO_EXT) 466info.info : $(buildinfodir)/info$(INFO_EXT)
454$(buildinfodir)/info$(INFO_EXT): ${srcdir}/info.texi 467$(buildinfodir)/info$(INFO_EXT): ${srcdir}/info.texi ${gfdl}
455 $(mkinfodir) 468 $(mkinfodir)
456 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/info.texi 469 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/info.texi
457info.dvi: ${srcdir}/info.texi 470info.dvi: ${srcdir}/info.texi ${gfdl}
458 $(ENVADD) $(TEXI2DVI) ${srcdir}/info.texi 471 $(ENVADD) $(TEXI2DVI) ${srcdir}/info.texi
459info.pdf: ${srcdir}/info.texi 472info.pdf: ${srcdir}/info.texi ${gfdl}
460 $(ENVADD) $(TEXI2PDF) ${srcdir}/info.texi 473 $(ENVADD) $(TEXI2PDF) ${srcdir}/info.texi
461 474
462mairix-el : $(buildinfodir)/mairix-el$(INFO_EXT) 475mairix-el : $(buildinfodir)/mairix-el$(INFO_EXT)
463$(buildinfodir)/mairix-el$(INFO_EXT): ${srcdir}/mairix-el.texi 476$(buildinfodir)/mairix-el$(INFO_EXT): ${srcdir}/mairix-el.texi ${gfdl}
464 $(mkinfodir) 477 $(mkinfodir)
465 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/mairix-el.texi 478 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/mairix-el.texi
466mairix-el.dvi: ${srcdir}/mairix-el.texi 479mairix-el.dvi: ${srcdir}/mairix-el.texi ${gfdl}
467 $(ENVADD) $(TEXI2DVI) ${srcdir}/mairix-el.texi 480 $(ENVADD) $(TEXI2DVI) ${srcdir}/mairix-el.texi
468mairix-el.pdf: ${srcdir}/mairix-el.texi 481mairix-el.pdf: ${srcdir}/mairix-el.texi ${gfdl}
469 $(ENVADD) $(TEXI2PDF) ${srcdir}/mairix-el.texi 482 $(ENVADD) $(TEXI2PDF) ${srcdir}/mairix-el.texi
470 483
471message : $(buildinfodir)/message$(INFO_EXT) 484message : $(buildinfodir)/message$(INFO_EXT)
472$(buildinfodir)/message$(INFO_EXT): ${srcdir}/message.texi 485$(buildinfodir)/message$(INFO_EXT): ${srcdir}/message.texi ${gfdl}
473 $(mkinfodir) 486 $(mkinfodir)
474 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/message.texi 487 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/message.texi
475message.dvi: ${srcdir}/message.texi 488message.dvi: ${srcdir}/message.texi ${gfdl}
476 $(ENVADD) $(TEXI2DVI) ${srcdir}/message.texi 489 $(ENVADD) $(TEXI2DVI) ${srcdir}/message.texi
477message.pdf: ${srcdir}/message.texi 490message.pdf: ${srcdir}/message.texi ${gfdl}
478 $(ENVADD) $(TEXI2PDF) ${srcdir}/message.texi 491 $(ENVADD) $(TEXI2PDF) ${srcdir}/message.texi
479 492
480mh-e : $(buildinfodir)/mh-e$(INFO_EXT) 493mh-e : $(buildinfodir)/mh-e$(INFO_EXT)
481$(buildinfodir)/mh-e$(INFO_EXT): ${srcdir}/mh-e.texi 494$(buildinfodir)/mh-e$(INFO_EXT): ${srcdir}/mh-e.texi ${gfdl}
482 $(mkinfodir) 495 $(mkinfodir)
483 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/mh-e.texi 496 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/mh-e.texi
484mh-e.dvi: ${srcdir}/mh-e.texi 497mh-e.dvi: ${srcdir}/mh-e.texi ${gfdl}
485 $(ENVADD) $(TEXI2DVI) ${srcdir}/mh-e.texi 498 $(ENVADD) $(TEXI2DVI) ${srcdir}/mh-e.texi
486mh-e.pdf: ${srcdir}/mh-e.texi 499mh-e.pdf: ${srcdir}/mh-e.texi ${gfdl}
487 $(ENVADD) $(TEXI2PDF) ${srcdir}/mh-e.texi 500 $(ENVADD) $(TEXI2PDF) ${srcdir}/mh-e.texi
488 501
489newsticker : $(buildinfodir)/newsticker$(INFO_EXT) 502newsticker : $(buildinfodir)/newsticker$(INFO_EXT)
490$(buildinfodir)/newsticker$(INFO_EXT): ${srcdir}/newsticker.texi 503$(buildinfodir)/newsticker$(INFO_EXT): ${srcdir}/newsticker.texi ${gfdl}
491 $(mkinfodir) 504 $(mkinfodir)
492 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/newsticker.texi 505 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/newsticker.texi
493newsticker.dvi: ${srcdir}/newsticker.texi 506newsticker.dvi: ${srcdir}/newsticker.texi ${gfdl}
494 $(ENVADD) $(TEXI2DVI) ${srcdir}/newsticker.texi 507 $(ENVADD) $(TEXI2DVI) ${srcdir}/newsticker.texi
495newsticker.pdf: ${srcdir}/newsticker.texi 508newsticker.pdf: ${srcdir}/newsticker.texi ${gfdl}
496 $(ENVADD) $(TEXI2PDF) ${srcdir}/newsticker.texi 509 $(ENVADD) $(TEXI2PDF) ${srcdir}/newsticker.texi
497 510
498nxml-mode : $(buildinfodir)/nxml-mode$(INFO_EXT) 511nxml-mode : $(buildinfodir)/nxml-mode$(INFO_EXT)
499$(buildinfodir)/nxml-mode$(INFO_EXT): ${srcdir}/nxml-mode.texi 512$(buildinfodir)/nxml-mode$(INFO_EXT): ${srcdir}/nxml-mode.texi ${gfdl}
500 $(mkinfodir) 513 $(mkinfodir)
501 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/nxml-mode.texi 514 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/nxml-mode.texi
502nxml-mode.dvi: ${srcdir}/nxml-mode.texi 515nxml-mode.dvi: ${srcdir}/nxml-mode.texi ${gfdl}
503 $(ENVADD) $(TEXI2DVI) ${srcdir}/nxml-mode.texi 516 $(ENVADD) $(TEXI2DVI) ${srcdir}/nxml-mode.texi
504nxml-mode.pdf: ${srcdir}/nxml-mode.texi 517nxml-mode.pdf: ${srcdir}/nxml-mode.texi ${gfdl}
505 $(ENVADD) $(TEXI2PDF) ${srcdir}/nxml-mode.texi 518 $(ENVADD) $(TEXI2PDF) ${srcdir}/nxml-mode.texi
506 519
507org : $(buildinfodir)/org$(INFO_EXT) 520org : $(buildinfodir)/org$(INFO_EXT)
508$(buildinfodir)/org$(INFO_EXT): ${srcdir}/org.texi 521$(buildinfodir)/org$(INFO_EXT): ${srcdir}/org.texi ${gfdl}
509 $(mkinfodir) 522 $(mkinfodir)
510 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/org.texi 523 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/org.texi
511org.dvi: ${srcdir}/org.texi 524org.dvi: ${srcdir}/org.texi ${gfdl}
512 $(ENVADD) $(TEXI2DVI) ${srcdir}/org.texi 525 $(ENVADD) $(TEXI2DVI) ${srcdir}/org.texi
513org.pdf: ${srcdir}/org.texi 526org.pdf: ${srcdir}/org.texi ${gfdl}
514 $(ENVADD) $(TEXI2PDF) ${srcdir}/org.texi 527 $(ENVADD) $(TEXI2PDF) ${srcdir}/org.texi
515 528
516pcl-cvs : $(buildinfodir)/pcl-cvs$(INFO_EXT) 529pcl-cvs : $(buildinfodir)/pcl-cvs$(INFO_EXT)
517$(buildinfodir)/pcl-cvs$(INFO_EXT): ${srcdir}/pcl-cvs.texi 530$(buildinfodir)/pcl-cvs$(INFO_EXT): ${srcdir}/pcl-cvs.texi ${gfdl}
518 $(mkinfodir) 531 $(mkinfodir)
519 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/pcl-cvs.texi 532 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/pcl-cvs.texi
520pcl-cvs.dvi: ${srcdir}/pcl-cvs.texi 533pcl-cvs.dvi: ${srcdir}/pcl-cvs.texi ${gfdl}
521 $(ENVADD) $(TEXI2DVI) ${srcdir}/pcl-cvs.texi 534 $(ENVADD) $(TEXI2DVI) ${srcdir}/pcl-cvs.texi
522pcl-cvs.pdf: ${srcdir}/pcl-cvs.texi 535pcl-cvs.pdf: ${srcdir}/pcl-cvs.texi ${gfdl}
523 $(ENVADD) $(TEXI2PDF) ${srcdir}/pcl-cvs.texi 536 $(ENVADD) $(TEXI2PDF) ${srcdir}/pcl-cvs.texi
524 537
525pgg : $(buildinfodir)/pgg$(INFO_EXT) 538pgg : $(buildinfodir)/pgg$(INFO_EXT)
526$(buildinfodir)/pgg$(INFO_EXT): ${srcdir}/pgg.texi 539$(buildinfodir)/pgg$(INFO_EXT): ${srcdir}/pgg.texi ${gfdl}
527 $(mkinfodir) 540 $(mkinfodir)
528 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/pgg.texi 541 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/pgg.texi
529pgg.dvi: ${srcdir}/pgg.texi 542pgg.dvi: ${srcdir}/pgg.texi ${gfdl}
530 $(ENVADD) $(TEXI2DVI) ${srcdir}/pgg.texi 543 $(ENVADD) $(TEXI2DVI) ${srcdir}/pgg.texi
531pgg.pdf: ${srcdir}/pgg.texi 544pgg.pdf: ${srcdir}/pgg.texi ${gfdl}
532 $(ENVADD) $(TEXI2PDF) ${srcdir}/pgg.texi 545 $(ENVADD) $(TEXI2PDF) ${srcdir}/pgg.texi
533 546
534rcirc : $(buildinfodir)/rcirc$(INFO_EXT) 547rcirc : $(buildinfodir)/rcirc$(INFO_EXT)
535$(buildinfodir)/rcirc$(INFO_EXT): ${srcdir}/rcirc.texi 548$(buildinfodir)/rcirc$(INFO_EXT): ${srcdir}/rcirc.texi ${gfdl}
536 $(mkinfodir) 549 $(mkinfodir)
537 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/rcirc.texi 550 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/rcirc.texi
538rcirc.dvi: ${srcdir}/rcirc.texi 551rcirc.dvi: ${srcdir}/rcirc.texi ${gfdl}
539 $(ENVADD) $(TEXI2DVI) ${srcdir}/rcirc.texi 552 $(ENVADD) $(TEXI2DVI) ${srcdir}/rcirc.texi
540rcirc.pdf: ${srcdir}/rcirc.texi 553rcirc.pdf: ${srcdir}/rcirc.texi ${gfdl}
541 $(ENVADD) $(TEXI2PDF) ${srcdir}/rcirc.texi 554 $(ENVADD) $(TEXI2PDF) ${srcdir}/rcirc.texi
542 555
543reftex : $(buildinfodir)/reftex$(INFO_EXT) 556reftex : $(buildinfodir)/reftex$(INFO_EXT)
544$(buildinfodir)/reftex$(INFO_EXT): ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi 557$(buildinfodir)/reftex$(INFO_EXT): ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi ${gfdl}
545 $(mkinfodir) 558 $(mkinfodir)
546 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/reftex.texi 559 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/reftex.texi
547reftex.dvi: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi 560reftex.dvi: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi ${gfdl}
548 $(ENVADD) $(TEXI2DVI) ${srcdir}/reftex.texi 561 $(ENVADD) $(TEXI2DVI) ${srcdir}/reftex.texi
549reftex.pdf: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi 562reftex.pdf: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi ${gfdl}
550 $(ENVADD) $(TEXI2PDF) ${srcdir}/reftex.texi 563 $(ENVADD) $(TEXI2PDF) ${srcdir}/reftex.texi
551 564
552remember : $(buildinfodir)/remember$(INFO_EXT) 565remember : $(buildinfodir)/remember$(INFO_EXT)
553$(buildinfodir)/remember$(INFO_EXT): ${srcdir}/remember.texi 566$(buildinfodir)/remember$(INFO_EXT): ${srcdir}/remember.texi ${gfdl}
554 $(mkinfodir) 567 $(mkinfodir)
555 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/remember.texi 568 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/remember.texi
556remember.dvi: ${srcdir}/remember.texi 569remember.dvi: ${srcdir}/remember.texi ${gfdl}
557 $(ENVADD) $(TEXI2DVI) ${srcdir}/remember.texi 570 $(ENVADD) $(TEXI2DVI) ${srcdir}/remember.texi
558remember.pdf: ${srcdir}/remember.texi 571remember.pdf: ${srcdir}/remember.texi ${gfdl}
559 $(ENVADD) $(TEXI2PDF) ${srcdir}/remember.texi 572 $(ENVADD) $(TEXI2PDF) ${srcdir}/remember.texi
560 573
561sasl : $(buildinfodir)/sasl$(INFO_EXT) 574sasl : $(buildinfodir)/sasl$(INFO_EXT)
562$(buildinfodir)/sasl$(INFO_EXT): ${srcdir}/sasl.texi 575$(buildinfodir)/sasl$(INFO_EXT): ${srcdir}/sasl.texi ${gfdl}
563 $(mkinfodir) 576 $(mkinfodir)
564 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sasl.texi 577 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sasl.texi
565sasl.dvi: ${srcdir}/sasl.texi 578sasl.dvi: ${srcdir}/sasl.texi ${gfdl}
566 $(ENVADD) $(TEXI2DVI) ${srcdir}/sasl.texi 579 $(ENVADD) $(TEXI2DVI) ${srcdir}/sasl.texi
567sasl.pdf: ${srcdir}/sasl.texi 580sasl.pdf: ${srcdir}/sasl.texi ${gfdl}
568 $(ENVADD) $(TEXI2PDF) ${srcdir}/sasl.texi 581 $(ENVADD) $(TEXI2PDF) ${srcdir}/sasl.texi
569 582
570sc : $(buildinfodir)/sc$(INFO_EXT) 583sc : $(buildinfodir)/sc$(INFO_EXT)
571$(buildinfodir)/sc$(INFO_EXT): ${srcdir}/sc.texi 584$(buildinfodir)/sc$(INFO_EXT): ${srcdir}/sc.texi ${gfdl}
572 $(mkinfodir) 585 $(mkinfodir)
573 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sc.texi 586 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sc.texi
574sc.dvi: ${srcdir}/sc.texi 587sc.dvi: ${srcdir}/sc.texi ${gfdl}
575 $(ENVADD) $(TEXI2DVI) ${srcdir}/sc.texi 588 $(ENVADD) $(TEXI2DVI) ${srcdir}/sc.texi
576sc.pdf: ${srcdir}/sc.texi 589sc.pdf: ${srcdir}/sc.texi ${gfdl}
577 $(ENVADD) $(TEXI2PDF) ${srcdir}/sc.texi 590 $(ENVADD) $(TEXI2PDF) ${srcdir}/sc.texi
578 591
579semantic : $(buildinfodir)/semantic$(INFO_EXT) 592semantic : $(buildinfodir)/semantic$(INFO_EXT)
580$(buildinfodir)/semantic$(INFO_EXT): ${srcdir}/semantic.texi ${srcdir}/sem-user.texi 593$(buildinfodir)/semantic$(INFO_EXT): ${srcdir}/semantic.texi ${srcdir}/sem-user.texi ${gfdl}
581 $(mkinfodir) 594 $(mkinfodir)
582 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/semantic.texi 595 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/semantic.texi
583semantic.dvi: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi 596semantic.dvi: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi ${gfdl}
584 $(ENVADD) $(TEXI2DVI) ${srcdir}/semantic.texi 597 $(ENVADD) $(TEXI2DVI) ${srcdir}/semantic.texi
585semantic.pdf: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi 598semantic.pdf: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi ${gfdl}
586 $(ENVADD) $(TEXI2PDF) ${srcdir}/semantic.texi 599 $(ENVADD) $(TEXI2PDF) ${srcdir}/semantic.texi
587 600
588ses : $(buildinfodir)/ses$(INFO_EXT) 601ses : $(buildinfodir)/ses$(INFO_EXT)
589$(buildinfodir)/ses$(INFO_EXT): ${srcdir}/ses.texi 602$(buildinfodir)/ses$(INFO_EXT): ${srcdir}/ses.texi ${gfdl}
590 $(mkinfodir) 603 $(mkinfodir)
591 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ses.texi 604 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/ses.texi
592ses.dvi: ${srcdir}/ses.texi 605ses.dvi: ${srcdir}/ses.texi ${gfdl}
593 $(ENVADD) $(TEXI2DVI) ${srcdir}/ses.texi 606 $(ENVADD) $(TEXI2DVI) ${srcdir}/ses.texi
594ses.pdf: ${srcdir}/ses.texi 607ses.pdf: ${srcdir}/ses.texi ${gfdl}
595 $(ENVADD) $(TEXI2PDF) ${srcdir}/ses.texi 608 $(ENVADD) $(TEXI2PDF) ${srcdir}/ses.texi
596 609
597sieve : $(buildinfodir)/sieve$(INFO_EXT) 610sieve : $(buildinfodir)/sieve$(INFO_EXT)
598$(buildinfodir)/sieve$(INFO_EXT): ${srcdir}/sieve.texi 611$(buildinfodir)/sieve$(INFO_EXT): ${srcdir}/sieve.texi ${gfdl}
599 $(mkinfodir) 612 $(mkinfodir)
600 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sieve.texi 613 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/sieve.texi
601sieve.dvi: ${srcdir}/sieve.texi 614sieve.dvi: ${srcdir}/sieve.texi ${gfdl}
602 $(ENVADD) $(TEXI2DVI) ${srcdir}/sieve.texi 615 $(ENVADD) $(TEXI2DVI) ${srcdir}/sieve.texi
603sieve.pdf: ${srcdir}/sieve.texi 616sieve.pdf: ${srcdir}/sieve.texi ${gfdl}
604 $(ENVADD) $(TEXI2PDF) ${srcdir}/sieve.texi 617 $(ENVADD) $(TEXI2PDF) ${srcdir}/sieve.texi
605 618
606smtpmail : $(buildinfodir)/smtpmail$(INFO_EXT) 619smtpmail : $(buildinfodir)/smtpmail$(INFO_EXT)
607$(buildinfodir)/smtpmail$(INFO_EXT): ${srcdir}/smtpmail.texi 620$(buildinfodir)/smtpmail$(INFO_EXT): ${srcdir}/smtpmail.texi ${gfdl}
608 $(mkinfodir) 621 $(mkinfodir)
609 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/smtpmail.texi 622 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/smtpmail.texi
610smtpmail.dvi: ${srcdir}/smtpmail.texi 623smtpmail.dvi: ${srcdir}/smtpmail.texi ${gfdl}
611 $(ENVADD) $(TEXI2DVI) ${srcdir}/smtpmail.texi 624 $(ENVADD) $(TEXI2DVI) ${srcdir}/smtpmail.texi
612smtpmail.pdf: ${srcdir}/smtpmail.texi 625smtpmail.pdf: ${srcdir}/smtpmail.texi ${gfdl}
613 $(ENVADD) $(TEXI2PDF) ${srcdir}/smtpmail.texi 626 $(ENVADD) $(TEXI2PDF) ${srcdir}/smtpmail.texi
614 627
615speedbar : $(buildinfodir)/speedbar$(INFO_EXT) 628speedbar : $(buildinfodir)/speedbar$(INFO_EXT)
616$(buildinfodir)/speedbar$(INFO_EXT): ${srcdir}/speedbar.texi 629$(buildinfodir)/speedbar$(INFO_EXT): ${srcdir}/speedbar.texi ${gfdl}
617 $(mkinfodir) 630 $(mkinfodir)
618 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/speedbar.texi 631 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/speedbar.texi
619speedbar.dvi: ${srcdir}/speedbar.texi 632speedbar.dvi: ${srcdir}/speedbar.texi ${gfdl}
620 $(ENVADD) $(TEXI2DVI) ${srcdir}/speedbar.texi 633 $(ENVADD) $(TEXI2DVI) ${srcdir}/speedbar.texi
621speedbar.pdf: ${srcdir}/speedbar.texi 634speedbar.pdf: ${srcdir}/speedbar.texi ${gfdl}
622 $(ENVADD) $(TEXI2PDF) ${srcdir}/speedbar.texi 635 $(ENVADD) $(TEXI2PDF) ${srcdir}/speedbar.texi
623 636
624srecode : $(buildinfodir)/srecode$(INFO_EXT) 637srecode : $(buildinfodir)/srecode$(INFO_EXT)
625$(buildinfodir)/srecode$(INFO_EXT): ${srcdir}/srecode.texi 638$(buildinfodir)/srecode$(INFO_EXT): ${srcdir}/srecode.texi ${gfdl}
626 $(mkinfodir) 639 $(mkinfodir)
627 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/srecode.texi 640 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/srecode.texi
628srecode.dvi: ${srcdir}/srecode.texi 641srecode.dvi: ${srcdir}/srecode.texi ${gfdl}
629 $(ENVADD) $(TEXI2DVI) ${srcdir}/srecode.texi 642 $(ENVADD) $(TEXI2DVI) ${srcdir}/srecode.texi
630srecode.pdf: ${srcdir}/srecode.texi 643srecode.pdf: ${srcdir}/srecode.texi ${gfdl}
631 $(ENVADD) $(TEXI2PDF) ${srcdir}/srecode.texi 644 $(ENVADD) $(TEXI2PDF) ${srcdir}/srecode.texi
632 645
633tramp : $(buildinfodir)/tramp$(INFO_EXT) 646tramp : $(buildinfodir)/tramp$(INFO_EXT)
634$(buildinfodir)/tramp$(INFO_EXT): ${srcdir}/tramp.texi ${srcdir}/trampver.texi 647$(buildinfodir)/tramp$(INFO_EXT): ${srcdir}/tramp.texi ${srcdir}/trampver.texi ${gfdl}
635 $(mkinfodir) 648 $(mkinfodir)
636 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ -D emacs ${srcdir}/tramp.texi 649 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ -D emacs ${srcdir}/tramp.texi
637tramp.dvi: ${srcdir}/tramp.texi ${srcdir}/trampver.texi 650tramp.dvi: ${srcdir}/tramp.texi ${srcdir}/trampver.texi ${gfdl}
638 $(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi 651 $(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi
639tramp.pdf: ${srcdir}/tramp.texi ${srcdir}/trampver.texi 652tramp.pdf: ${srcdir}/tramp.texi ${srcdir}/trampver.texi ${gfdl}
640 $(ENVADD) $(TEXI2PDF) ${srcdir}/tramp.texi 653 $(ENVADD) $(TEXI2PDF) ${srcdir}/tramp.texi
641 654
642url : $(buildinfodir)/url$(INFO_EXT) 655url : $(buildinfodir)/url$(INFO_EXT)
643$(buildinfodir)/url$(INFO_EXT): ${srcdir}/url.texi 656$(buildinfodir)/url$(INFO_EXT): ${srcdir}/url.texi ${gfdl}
644 $(mkinfodir) 657 $(mkinfodir)
645 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/url.texi 658 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/url.texi
646url.dvi: ${srcdir}/url.texi 659url.dvi: ${srcdir}/url.texi ${gfdl}
647 $(ENVADD) $(TEXI2DVI) ${srcdir}/url.texi 660 $(ENVADD) $(TEXI2DVI) ${srcdir}/url.texi
648url.pdf: ${srcdir}/url.texi 661url.pdf: ${srcdir}/url.texi ${gfdl}
649 $(ENVADD) $(TEXI2PDF) ${srcdir}/url.texi 662 $(ENVADD) $(TEXI2PDF) ${srcdir}/url.texi
650 663
651vip : $(buildinfodir)/vip$(INFO_EXT) 664vip : $(buildinfodir)/vip$(INFO_EXT)
652$(buildinfodir)/vip$(INFO_EXT): ${srcdir}/vip.texi 665$(buildinfodir)/vip$(INFO_EXT): ${srcdir}/vip.texi ${gfdl}
653 $(mkinfodir) 666 $(mkinfodir)
654 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/vip.texi 667 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/vip.texi
655vip.dvi: ${srcdir}/vip.texi 668vip.dvi: ${srcdir}/vip.texi ${gfdl}
656 $(ENVADD) $(TEXI2DVI) ${srcdir}/vip.texi 669 $(ENVADD) $(TEXI2DVI) ${srcdir}/vip.texi
657vip.pdf: ${srcdir}/vip.texi 670vip.pdf: ${srcdir}/vip.texi ${gfdl}
658 $(ENVADD) $(TEXI2PDF) ${srcdir}/vip.texi 671 $(ENVADD) $(TEXI2PDF) ${srcdir}/vip.texi
659 672
660viper : $(buildinfodir)/viper$(INFO_EXT) 673viper : $(buildinfodir)/viper$(INFO_EXT)
661$(buildinfodir)/viper$(INFO_EXT): ${srcdir}/viper.texi 674$(buildinfodir)/viper$(INFO_EXT): ${srcdir}/viper.texi ${gfdl}
662 $(mkinfodir) 675 $(mkinfodir)
663 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/viper.texi 676 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/viper.texi
664viper.dvi: ${srcdir}/viper.texi 677viper.dvi: ${srcdir}/viper.texi ${gfdl}
665 $(ENVADD) $(TEXI2DVI) ${srcdir}/viper.texi 678 $(ENVADD) $(TEXI2DVI) ${srcdir}/viper.texi
666viper.pdf: ${srcdir}/viper.texi 679viper.pdf: ${srcdir}/viper.texi ${gfdl}
667 $(ENVADD) $(TEXI2PDF) ${srcdir}/viper.texi 680 $(ENVADD) $(TEXI2PDF) ${srcdir}/viper.texi
668 681
669widget : $(buildinfodir)/widget$(INFO_EXT) 682widget : $(buildinfodir)/widget$(INFO_EXT)
670$(buildinfodir)/widget$(INFO_EXT): ${srcdir}/widget.texi 683$(buildinfodir)/widget$(INFO_EXT): ${srcdir}/widget.texi ${gfdl}
671 $(mkinfodir) 684 $(mkinfodir)
672 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/widget.texi 685 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/widget.texi
673widget.dvi: ${srcdir}/widget.texi 686widget.dvi: ${srcdir}/widget.texi ${gfdl}
674 $(ENVADD) $(TEXI2DVI) ${srcdir}/widget.texi 687 $(ENVADD) $(TEXI2DVI) ${srcdir}/widget.texi
675widget.pdf: ${srcdir}/widget.texi 688widget.pdf: ${srcdir}/widget.texi ${gfdl}
676 $(ENVADD) $(TEXI2PDF) ${srcdir}/widget.texi 689 $(ENVADD) $(TEXI2PDF) ${srcdir}/widget.texi
677 690
678wisent : $(buildinfodir)/wisent$(INFO_EXT) 691wisent : $(buildinfodir)/wisent$(INFO_EXT)
679$(buildinfodir)/wisent$(INFO_EXT): ${srcdir}/wisent.texi 692$(buildinfodir)/wisent$(INFO_EXT): ${srcdir}/wisent.texi ${gfdl}
680 $(mkinfodir) 693 $(mkinfodir)
681 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/wisent.texi 694 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/wisent.texi
682wisent.dvi: ${srcdir}/wisent.texi 695wisent.dvi: ${srcdir}/wisent.texi ${gfdl}
683 $(ENVADD) $(TEXI2DVI) ${srcdir}/wisent.texi 696 $(ENVADD) $(TEXI2DVI) ${srcdir}/wisent.texi
684wisent.pdf: ${srcdir}/wisent.texi 697wisent.pdf: ${srcdir}/wisent.texi ${gfdl}
685 $(ENVADD) $(TEXI2PDF) ${srcdir}/wisent.texi 698 $(ENVADD) $(TEXI2PDF) ${srcdir}/wisent.texi
686 699
687woman : $(buildinfodir)/woman$(INFO_EXT) 700woman : $(buildinfodir)/woman$(INFO_EXT)
688$(buildinfodir)/woman$(INFO_EXT): ${srcdir}/woman.texi 701$(buildinfodir)/woman$(INFO_EXT): ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl}
689 $(mkinfodir) 702 $(mkinfodir)
690 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/woman.texi 703 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/woman.texi
691woman.dvi: ${srcdir}/woman.texi 704woman.dvi: ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl}
692 $(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi 705 $(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi
693woman.pdf: ${srcdir}/woman.texi 706woman.pdf: ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl}
694 $(ENVADD) $(TEXI2PDF) ${srcdir}/woman.texi 707 $(ENVADD) $(TEXI2PDF) ${srcdir}/woman.texi
695 708
696 709
diff --git a/doc/misc/ada-mode.texi b/doc/misc/ada-mode.texi
index 8d06ae0de22..926d6a5749c 100644
--- a/doc/misc/ada-mode.texi
+++ b/doc/misc/ada-mode.texi
@@ -3,7 +3,7 @@
3@settitle Ada Mode 3@settitle Ada Mode
4 4
5@copying 5@copying
6Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. 6Copyright @copyright{} 1999--2013 Free Software Foundation, Inc.
7 7
8@quotation 8@quotation
9Permission is granted to copy, distribute and/or modify this document 9Permission is granted to copy, distribute and/or modify this document
@@ -14,8 +14,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
14is included in the section entitled ``GNU Free Documentation License''. 14is included in the section entitled ``GNU Free Documentation License''.
15 15
16(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 16(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
17modify this GNU manual. Buying copies from the FSF supports it in 17modify this GNU manual.''
18developing GNU and promoting software freedom.''
19@end quotation 18@end quotation
20@end copying 19@end copying
21 20
@@ -26,7 +25,7 @@ developing GNU and promoting software freedom.''
26 25
27@titlepage 26@titlepage
28@sp 10 27@sp 10
29@title{Ada Mode} 28@title Ada Mode
30@sp 2 29@sp 2
31@subtitle An Emacs major mode for programming in Ada 30@subtitle An Emacs major mode for programming in Ada
32@subtitle Ada Mode Version 4.00 31@subtitle Ada Mode Version 4.00
@@ -38,7 +37,7 @@ developing GNU and promoting software freedom.''
38 37
39@contents 38@contents
40 39
41@node Top, Overview, (dir), (dir) 40@node Top
42@top Ada Mode 41@top Ada Mode
43 42
44@ifnottex 43@ifnottex
@@ -65,7 +64,7 @@ developing GNU and promoting software freedom.''
65@end menu 64@end menu
66 65
67 66
68@node Overview, Installation, Top, Top 67@node Overview
69@chapter Overview 68@chapter Overview
70 69
71The Emacs mode for programming in Ada helps the user in understanding 70The Emacs mode for programming in Ada helps the user in understanding
@@ -97,7 +96,7 @@ and other GNAT commands.
97See the Emacs info manual, section 'Running Debuggers Under Emacs', 96See the Emacs info manual, section 'Running Debuggers Under Emacs',
98for general information on debugging. 97for general information on debugging.
99 98
100@node Installation, Customization, Overview, Top 99@node Installation
101@chapter Installation 100@chapter Installation
102 101
103Ada mode is part of the standard Emacs distribution; if you use that, 102Ada mode is part of the standard Emacs distribution; if you use that,
@@ -137,7 +136,7 @@ GNAT-specific).
137 136
138@end itemize 137@end itemize
139 138
140@node Customization, Compiling Executing, Installation, Top 139@node Customization
141@chapter Customizing Ada mode 140@chapter Customizing Ada mode
142 141
143Here we assume you are familiar with setting variables in Emacs, 142Here we assume you are familiar with setting variables in Emacs,
@@ -176,7 +175,7 @@ See the Emacs help for each of these variables for more information.
176* Other customization:: 175* Other customization::
177@end menu 176@end menu
178 177
179@node Non-standard file names, Other compiler, Customization, Customization 178@node Non-standard file names
180@section Non-standard file names 179@section Non-standard file names
181 180
182By default, Ada mode is configured to use the GNAT file naming 181By default, Ada mode is configured to use the GNAT file naming
@@ -218,7 +217,7 @@ rewrite the function @code{ada-make-filename-from-adaname}. Doing that
218is beyond the scope of this manual; see the current definitions in 217is beyond the scope of this manual; see the current definitions in
219@file{ada-mode.el} and @file{ada-xref.el} for examples. 218@file{ada-mode.el} and @file{ada-xref.el} for examples.
220 219
221@node Other compiler, Other customization, Non-standard file names, Customization 220@node Other compiler
222@section Other compiler 221@section Other compiler
223 222
224By default, Ada mode is configured to use the Gnu Ada compiler GNAT. 223By default, Ada mode is configured to use the Gnu Ada compiler GNAT.
@@ -228,7 +227,7 @@ used to run that compiler, either in lisp variables or in Emacs
228Ada mode project files. See @ref{Project file variables} for the list 227Ada mode project files. See @ref{Project file variables} for the list
229of project variables, and the corresponding lisp variables. 228of project variables, and the corresponding lisp variables.
230 229
231@node Other customization, , Other compiler, Customization 230@node Other customization
232@section Other customization 231@section Other customization
233 232
234All user-settable Ada mode variables can be set via the menu 233All user-settable Ada mode variables can be set via the menu
@@ -246,7 +245,7 @@ and the syntax to set a variable is the following:
246(setq variable-name value) 245(setq variable-name value)
247@end example 246@end example
248 247
249@node Compiling Executing, Project files, Customization, Top 248@node Compiling Executing
250@chapter Compiling Executing 249@chapter Compiling Executing
251 250
252Ada projects can be compiled, linked, and executed using commands on 251Ada projects can be compiled, linked, and executed using commands on
@@ -264,7 +263,7 @@ file variables referenced here.
264* Compiler errors:: 263* Compiler errors::
265@end menu 264@end menu
266 265
267@node Compile commands, Compiler errors, Compiling Executing, Compiling Executing 266@node Compile commands
268@section Compile commands 267@section Compile commands
269 268
270Here are the commands for building and using an Ada project, as 269Here are the commands for building and using an Ada project, as
@@ -347,7 +346,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code
347 346
348@end enumerate 347@end enumerate
349 348
350@node Compiler errors, , Compile commands, Compiling Executing 349@node Compiler errors
351@section Compiler errors 350@section Compiler errors
352 351
353The @code{Check file}, @code{Compile file}, and @code{Build} commands 352The @code{Check file}, @code{Compile file}, and @code{Build} commands
@@ -367,7 +366,7 @@ Some error messages might also include references to other files. These
367references are also clickable in the same way, or put point after the 366references are also clickable in the same way, or put point after the
368line number and press @key{RET}. 367line number and press @key{RET}.
369 368
370@node Project files, Compiling Examples, Compiling Executing, Top 369@node Project files
371@chapter Project files 370@chapter Project files
372 371
373An Emacs Ada mode project file specifies what directories hold sources 372An Emacs Ada mode project file specifies what directories hold sources
@@ -386,7 +385,7 @@ an Emacs Ada mode project file.
386* Project file variables:: 385* Project file variables::
387@end menu 386@end menu
388 387
389@node Project File Overview, GUI Editor, Project files, Project files 388@node Project File Overview
390@section Project File Overview 389@section Project File Overview
391 390
392Project files have a simple syntax; they may be edited directly. Each 391Project files have a simple syntax; they may be edited directly. Each
@@ -451,7 +450,7 @@ file extension; if it is @code{.gpr}, the file is treated as a GNAT
451project file. Any other extension is treated as an Emacs Ada mode 450project file. Any other extension is treated as an Emacs Ada mode
452project file. 451project file.
453 452
454@node GUI Editor, Project file variables, Project File Overview, Project files 453@node GUI Editor
455@section GUI Editor 454@section GUI Editor
456 455
457The project file editor is invoked with the menu @samp{Ada | Projects 456The project file editor is invoked with the menu @samp{Ada | Projects
@@ -462,7 +461,7 @@ modification using the @samp{[save]} button at the bottom of the
462buffer, or the @kbd{C-x C-s} binding. To cancel your modifications, 461buffer, or the @kbd{C-x C-s} binding. To cancel your modifications,
463kill the buffer or click on the @samp{[cancel]} button. 462kill the buffer or click on the @samp{[cancel]} button.
464 463
465@node Project file variables, , GUI Editor, Project files 464@node Project file variables
466@section Project file variables 465@section Project file variables
467 466
468The following variables can be defined in a project file; some can 467The following variables can be defined in a project file; some can
@@ -522,8 +521,8 @@ ada_project_path_sep=:
522ada_project_path=$GDS_ROOT/makerules 521ada_project_path=$GDS_ROOT/makerules
523ada_project_path=../opentoken 522ada_project_path=../opentoken
524@end example 523@end example
525the environment variable @code{ADA_PROJECT_PATH} will be set to 524then as a result the environment variable @code{ADA_PROJECT_PATH} will
526@code{"/home/shared/makerules:/home/opentoken/"}. 525be set to @code{"/home/shared/makerules:/home/opentoken/"}.
527 526
528The default value is not the current value of this environment 527The default value is not the current value of this environment
529variable, because that will typically have been set by another 528variable, because that will typically have been set by another
@@ -649,7 +648,7 @@ commands and source navigation.
649 648
650@end table 649@end table
651 650
652@node Compiling Examples, Moving Through Ada Code, Project files, Top 651@node Compiling Examples
653@chapter Compiling Examples 652@chapter Compiling Examples
654 653
655We present several small projects, and walk thru the process of 654We present several small projects, and walk thru the process of
@@ -671,7 +670,7 @@ website mentioned in @xref{Installation}.
671* Use multiple GNAT project files:: 670* Use multiple GNAT project files::
672@end menu 671@end menu
673 672
674@node No project files, Set compiler options, Compiling Examples, Compiling Examples 673@node No project files
675@section No project files 674@section No project files
676This example uses no project files. 675This example uses no project files.
677 676
@@ -731,7 +730,7 @@ In buffer @file{hello.adb}, invoke @samp{Ada | Check file}. You should
731get a @code{*compilation*} buffer containing something like (the 730get a @code{*compilation*} buffer containing something like (the
732directory paths will be different): 731directory paths will be different):
733 732
734@example 733@smallexample
735cd c:/Examples/Example_1/ 734cd c:/Examples/Example_1/
736gnatmake -u -c -gnatc -g c:/Examples/Example_1/hello.adb -cargs -gnatq -gnatQ 735gnatmake -u -c -gnatc -g c:/Examples/Example_1/hello.adb -cargs -gnatq -gnatQ
737gcc -c -Ic:/Examples/Example_1/ -gnatc -g -gnatq -gnatQ -I- c:/Examples/Example_1/hello.adb 736gcc -c -Ic:/Examples/Example_1/ -gnatc -g -gnatq -gnatQ -I- c:/Examples/Example_1/hello.adb
@@ -739,7 +738,7 @@ hello.adb:4:04: "Put_Line" is not visible
739hello.adb:4:04: non-visible declaration at a-textio.ads:264 738hello.adb:4:04: non-visible declaration at a-textio.ads:264
740hello.adb:4:04: non-visible declaration at a-textio.ads:260 739hello.adb:4:04: non-visible declaration at a-textio.ads:260
741gnatmake: "c:/Examples/Example_1/hello.adb" compilation error 740gnatmake: "c:/Examples/Example_1/hello.adb" compilation error
742@end example 741@end smallexample
743 742
744If you have enabled font-lock, the lines with actual errors (starting 743If you have enabled font-lock, the lines with actual errors (starting
745with @file{hello.adb}) are highlighted, with the file name in red. 744with @file{hello.adb}) are highlighted, with the file name in red.
@@ -837,7 +836,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code
837 836
838@end enumerate 837@end enumerate
839 838
840@node Set compiler options, Set source search path, No project files, Compiling Examples 839@node Set compiler options
841@section Set compiler options 840@section Set compiler options
842 841
843This example illustrates using an Emacs Ada mode project file to set a 842This example illustrates using an Emacs Ada mode project file to set a
@@ -899,7 +898,7 @@ used to set the compiler options.
899Fixing the error, linking and running the code proceed as in @ref{No 898Fixing the error, linking and running the code proceed as in @ref{No
900project files}. 899project files}.
901 900
902@node Set source search path, Use GNAT project file, Set compiler options, Compiling Examples 901@node Set source search path
903@section Set source search path 902@section Set source search path
904 903
905In this example, we show how to deal with files in more than one 904In this example, we show how to deal with files in more than one
@@ -983,7 +982,7 @@ compiler error message.
983Fixing the error, linking and running the code proceed as in @ref{No 982Fixing the error, linking and running the code proceed as in @ref{No
984project files}. 983project files}.
985 984
986@node Use GNAT project file, Use multiple GNAT project files, Set source search path, Compiling Examples 985@node Use GNAT project file
987@section Use GNAT project file 986@section Use GNAT project file
988 987
989In this example, we show how to use a GNAT project file, with no Ada 988In this example, we show how to use a GNAT project file, with no Ada
@@ -1046,14 +1045,14 @@ Then, again in @file{hello_4.adb}, invoke @samp{Ada | Set main and
1046Build}. You should get a @code{*compilation*} buffer containing 1045Build}. You should get a @code{*compilation*} buffer containing
1047something like (the directory paths will be different): 1046something like (the directory paths will be different):
1048 1047
1049@example 1048@smallexample
1050cd c:/Examples/Example_4/Gnat_Project/ 1049cd c:/Examples/Example_4/Gnat_Project/
1051gnatmake -o hello_4 hello_4 -Phello_4.gpr -cargs -gnatq -gnatQ -bargs -largs 1050gnatmake -o hello_4 hello_4 -Phello_4.gpr -cargs -gnatq -gnatQ -bargs -largs
1052gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\Gnat_Project\hello_4.adb 1051gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\Gnat_Project\hello_4.adb
1053gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb 1052gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb
1054hello_pkg.adb:2:08: keyword "body" expected here [see file name] 1053hello_pkg.adb:2:08: keyword "body" expected here [see file name]
1055gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error 1054gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error
1056@end example 1055@end smallexample
1057 1056
1058Compare the @code{gcc} options to the compiler output in @ref{Set 1057Compare the @code{gcc} options to the compiler output in @ref{Set
1059compiler options}; this shows that @file{hello_4.gpr} is being used to 1058compiler options}; this shows that @file{hello_4.gpr} is being used to
@@ -1062,7 +1061,7 @@ set the compiler options.
1062Fixing the error, linking and running the code proceed as in @ref{No 1061Fixing the error, linking and running the code proceed as in @ref{No
1063project files}. 1062project files}.
1064 1063
1065@node Use multiple GNAT project files, , Use GNAT project file, Compiling Examples 1064@node Use multiple GNAT project files
1066@section Use multiple GNAT project files 1065@section Use multiple GNAT project files
1067 1066
1068In this example, we show how to use multiple GNAT project files, 1067In this example, we show how to use multiple GNAT project files,
@@ -1113,20 +1112,20 @@ Then, again in @file{hello_5.adb}, invoke @samp{Ada | Set main and
1113Build}. You should get a @code{*compilation*} buffer containing 1112Build}. You should get a @code{*compilation*} buffer containing
1114something like (the directory paths will be different): 1113something like (the directory paths will be different):
1115 1114
1116@example 1115@smallexample
1117cd c:/Examples/Example_5/ 1116cd c:/Examples/Example_5/
1118gnatmake -o hello_5 hello_5 -Phello_5.gpr -g -cargs -gnatq -gnatQ -bargs -largs 1117gnatmake -o hello_5 hello_5 -Phello_5.gpr -g -cargs -gnatq -gnatQ -bargs -largs
1119gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_5\hello_5.adb 1118gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_5\hello_5.adb
1120gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb 1119gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb
1121hello_pkg.adb:2:08: keyword "body" expected here [see file name] 1120hello_pkg.adb:2:08: keyword "body" expected here [see file name]
1122gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error 1121gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error
1123@end example 1122@end smallexample
1124 1123
1125Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown, 1124Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown,
1126demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being 1125demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being
1127used to set the compilation search path. 1126used to set the compilation search path.
1128 1127
1129@node Moving Through Ada Code, Identifier completion, Compiling Examples, Top 1128@node Moving Through Ada Code
1130@chapter Moving Through Ada Code 1129@chapter Moving Through Ada Code
1131 1130
1132There are several easy to use commands to navigate through Ada code. All 1131There are several easy to use commands to navigate through Ada code. All
@@ -1180,7 +1179,7 @@ If the @code{ada-xref-create-ali} variable is non-@code{nil}, Emacs
1180will try to run GNAT for you whenever cross-reference information is 1179will try to run GNAT for you whenever cross-reference information is
1181needed, and is older than the current source file. 1180needed, and is older than the current source file.
1182 1181
1183@node Identifier completion, Automatic Smart Indentation, Moving Through Ada Code, Top 1182@node Identifier completion
1184@chapter Identifier completion 1183@chapter Identifier completion
1185 1184
1186Emacs and Ada mode provide two general ways for the completion of 1185Emacs and Ada mode provide two general ways for the completion of
@@ -1225,7 +1224,7 @@ Complete current identifier using cross-reference information.
1225Complete identifier using buffer information (not Ada-specific). 1224Complete identifier using buffer information (not Ada-specific).
1226@end table 1225@end table
1227 1226
1228@node Automatic Smart Indentation, Formatting Parameter Lists, Identifier completion, Top 1227@node Automatic Smart Indentation
1229@chapter Automatic Smart Indentation 1228@chapter Automatic Smart Indentation
1230 1229
1231Ada mode comes with a full set of rules for automatic indentation. You 1230Ada mode comes with a full set of rules for automatic indentation. You
@@ -1302,7 +1301,7 @@ Indent the current line and display the name of the variable used for
1302indentation. 1301indentation.
1303@end table 1302@end table
1304 1303
1305@node Formatting Parameter Lists, Automatic Casing, Automatic Smart Indentation, Top 1304@node Formatting Parameter Lists
1306@chapter Formatting Parameter Lists 1305@chapter Formatting Parameter Lists
1307 1306
1308@table @kbd 1307@table @kbd
@@ -1315,7 +1314,7 @@ This aligns the declarations on the colon (@samp{:}) separating
1315argument names and argument types, and aligns the @code{in}, 1314argument names and argument types, and aligns the @code{in},
1316@code{out} and @code{in out} keywords. 1315@code{out} and @code{in out} keywords.
1317 1316
1318@node Automatic Casing, Statement Templates, Formatting Parameter Lists, Top 1317@node Automatic Casing
1319@chapter Automatic Casing 1318@chapter Automatic Casing
1320 1319
1321Casing of identifiers, attributes and keywords is automatically 1320Casing of identifiers, attributes and keywords is automatically
@@ -1404,7 +1403,7 @@ Rereads the exception dictionary from the file
1404@code{ada-case-exception-file} (@code{ada-case-read-exceptions}). 1403@code{ada-case-exception-file} (@code{ada-case-read-exceptions}).
1405@end table 1404@end table
1406 1405
1407@node Statement Templates, Comment Handling, Automatic Casing, Top 1406@node Statement Templates
1408@chapter Statement Templates 1407@chapter Statement Templates
1409 1408
1410Templates are defined for most Ada statements, using the Emacs 1409Templates are defined for most Ada statements, using the Emacs
@@ -1495,7 +1494,7 @@ exception (@code{ada-exception}).
1495type (@code{ada-type}). 1494type (@code{ada-type}).
1496@end table 1495@end table
1497 1496
1498@node Comment Handling, GNU Free Documentation License, Statement Templates, Top 1497@node Comment Handling
1499@chapter Comment Handling 1498@chapter Comment Handling
1500 1499
1501By default, comment lines get indented like Ada code. There are a few 1500By default, comment lines get indented like Ada code. There are a few
@@ -1507,18 +1506,18 @@ Start a comment in default column.
1507@item M-j 1506@item M-j
1508Continue comment on next line. 1507Continue comment on next line.
1509@item C-c ; 1508@item C-c ;
1510Comment the selected region (add -- at the beginning of lines). 1509Comment the selected region (add @samp{--} at the beginning of lines).
1511@item C-c : 1510@item C-c :
1512Uncomment the selected region 1511Uncomment the selected region
1513@item M-q 1512@item M-q
1514autofill the current comment. 1513autofill the current comment.
1515@end table 1514@end table
1516 1515
1517@node GNU Free Documentation License, Index, Comment Handling, Top 1516@node GNU Free Documentation License
1518@appendix GNU Free Documentation License 1517@appendix GNU Free Documentation License
1519@include doclicense.texi 1518@include doclicense.texi
1520 1519
1521@node Index, , GNU Free Documentation License, Top 1520@node Index
1522@unnumbered Index 1521@unnumbered Index
1523 1522
1524@printindex fn 1523@printindex fn
diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi
index d18a802d600..36ee400acca 100644
--- a/doc/misc/auth.texi
+++ b/doc/misc/auth.texi
@@ -2,15 +2,15 @@
2 2
3@include gnus-overrides.texi 3@include gnus-overrides.texi
4 4
5@set VERSION 0.3
6
5@setfilename ../../info/auth 7@setfilename ../../info/auth
6@settitle Emacs auth-source Library @value{VERSION} 8@settitle Emacs auth-source Library @value{VERSION}
7 9
8@set VERSION 0.3
9
10@copying 10@copying
11This file describes the Emacs auth-source library. 11This file describes the Emacs auth-source library.
12 12
13Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. 13Copyright @copyright{} 2008--2013 Free Software Foundation, Inc.
14 14
15@quotation 15@quotation
16Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -18,17 +18,10 @@ under the terms of the GNU Free Documentation License, Version 1.3 or
18any later version published by the Free Software Foundation; with no 18any later version published by the Free Software Foundation; with no
19Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 19Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
20and with the Back-Cover Texts as in (a) below. A copy of the license 20and with the Back-Cover Texts as in (a) below. A copy of the license
21is included in the section entitled ``GNU Free Documentation License'' 21is included in the section entitled ``GNU Free Documentation License''.
22in the Emacs manual.
23 22
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 24modify this GNU manual.''
26developing GNU and promoting software freedom.''
27
28This document is part of a collection distributed under the GNU Free
29Documentation License. If you want to distribute this document
30separately from the collection, you can do so by adding a copy of the
31license to the document, as described in section 6 of the license.
32@end quotation 25@end quotation
33@end copying 26@end copying
34 27
@@ -68,6 +61,7 @@ It is a way for multiple applications to share a single configuration
68* Secret Service API:: 61* Secret Service API::
69* Help for developers:: 62* Help for developers::
70* GnuPG and EasyPG Assistant Configuration:: 63* GnuPG and EasyPG Assistant Configuration::
64* GNU Free Documentation License:: The license for this documentation.
71* Index:: 65* Index::
72* Function Index:: 66* Function Index::
73* Variable Index:: 67* Variable Index::
@@ -160,7 +154,8 @@ and simplest configuration is:
160(setq auth-sources '((:source "~/.authinfo.gpg"))) 154(setq auth-sources '((:source "~/.authinfo.gpg")))
161;;; even shorter and the @emph{default}: 155;;; even shorter and the @emph{default}:
162(setq auth-sources '("~/.authinfo.gpg" "~/.authinfo" "~/.netrc")) 156(setq auth-sources '("~/.authinfo.gpg" "~/.authinfo" "~/.netrc"))
163;;; use the Secrets API @var{Login} collection (@pxref{Secret Service API}) 157;;; use the Secrets API @var{Login} collection
158;;; (@pxref{Secret Service API})
164(setq auth-sources '("secrets:Login")) 159(setq auth-sources '("secrets:Login"))
165@end lisp 160@end lisp
166 161
@@ -173,7 +168,8 @@ have unusual setups and the remaining 10% are @emph{really} unusual).
173Here's a mixed example using two sources: 168Here's a mixed example using two sources:
174 169
175@lisp 170@lisp
176(setq auth-sources '((:source (:secrets default) :host "myserver" :user "joe") 171(setq auth-sources '((:source (:secrets default)
172 :host "myserver" :user "joe")
177 "~/.authinfo.gpg")) 173 "~/.authinfo.gpg"))
178@end lisp 174@end lisp
179 175
@@ -522,16 +518,20 @@ To set up gpg-agent, follow the instruction in GnuPG manual
522To set up elisp passphrase cache, set 518To set up elisp passphrase cache, set
523@code{epa-file-cache-passphrase-for-symmetric-encryption}. 519@code{epa-file-cache-passphrase-for-symmetric-encryption}.
524 520
521@node GNU Free Documentation License
522@appendix GNU Free Documentation License
523@include doclicense.texi
524
525@node Index 525@node Index
526@chapter Index 526@unnumbered Index
527@printindex cp 527@printindex cp
528 528
529@node Function Index 529@node Function Index
530@chapter Function Index 530@unnumbered Function Index
531@printindex fn 531@printindex fn
532 532
533@node Variable Index 533@node Variable Index
534@chapter Variable Index 534@unnumbered Variable Index
535@printindex vr 535@printindex vr
536 536
537@bye 537@bye
diff --git a/doc/misc/autotype.texi b/doc/misc/autotype.texi
index aa99b41f204..ad6a2902b1e 100644
--- a/doc/misc/autotype.texi
+++ b/doc/misc/autotype.texi
@@ -10,7 +10,8 @@
10@c @cindex autotypist 10@c @cindex autotypist
11 11
12@copying 12@copying
13Copyright @copyright{} 1994-1995, 1999, 2001-2012 Free Software Foundation, Inc. 13Copyright @copyright{} 1994--1995, 1999, 2001--2013
14Free Software Foundation, Inc.
14 15
15@quotation 16@quotation
16Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -21,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
21is included in the section entitled ``GNU Free Documentation License''. 22is included in the section entitled ``GNU Free Documentation License''.
22 23
23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
24modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
25developing GNU and promoting software freedom.''
26@end quotation 26@end quotation
27@end copying 27@end copying
28 28
@@ -58,7 +58,7 @@ over and over again. This is especially true of form letters and programming
58language constructs. Project-specific header comments, flow-control 58language constructs. Project-specific header comments, flow-control
59constructs or magic numbers are essentially the same every time. Emacs has 59constructs or magic numbers are essentially the same every time. Emacs has
60various features for doing tedious and repetitive typing chores for you 60various features for doing tedious and repetitive typing chores for you
61in addition to the Abbrev features (@pxref{(emacs)Abbrevs}). 61in addition to the Abbrev features (@pxref{Abbrevs,,, emacs, The GNU Emacs Manual}).
62 62
63 One solution is using skeletons, flexible rules that say what to 63 One solution is using skeletons, flexible rules that say what to
64insert, and how to do it. Various programming language modes offer some 64insert, and how to do it. Various programming language modes offer some
@@ -113,7 +113,7 @@ completions and expansions of text at point.
113programming language you are using, skeletons are a means of accomplishing 113programming language you are using, skeletons are a means of accomplishing
114this. Normally skeletons each have a command of their own, that, when called, 114this. Normally skeletons each have a command of their own, that, when called,
115will insert the skeleton. These commands can be issued in the usual ways 115will insert the skeleton. These commands can be issued in the usual ways
116(@pxref{(emacs)Commands}). Modes that offer various skeletons will often 116(@pxref{Commands,,, emacs, The GNU Emacs Manual}). Modes that offer various skeletons will often
117bind these to key-sequences on the @kbd{C-c} prefix, as well as having 117bind these to key-sequences on the @kbd{C-c} prefix, as well as having
118an @cite{Insert} menu and maybe even predefined abbrevs for them 118an @cite{Insert} menu and maybe even predefined abbrevs for them
119(@pxref{Skeletons as Abbrevs}). 119(@pxref{Skeletons as Abbrevs}).
@@ -146,18 +146,18 @@ accomplishing this, and can even, in the case of programming languages,
146reindent the wrapped code for you. 146reindent the wrapped code for you.
147 147
148 Skeleton commands take an optional numeric prefix argument 148 Skeleton commands take an optional numeric prefix argument
149(@pxref{(emacs)Arguments}). This is interpreted in two different ways depending 149(@pxref{Arguments,,, emacs, The GNU Emacs Manual}). This is interpreted in two different ways depending
150on whether the prefix is positive, i.e., forwards oriented, or negative, 150on whether the prefix is positive, i.e., forwards oriented, or negative,
151i.e., backwards oriented. 151i.e., backwards oriented.
152 152
153 A positive prefix means to wrap the skeleton around that many 153 A positive prefix means to wrap the skeleton around that many
154following words. This is accomplished by putting the words there where 154following words. This is accomplished by putting the words there where
155the point is normally left after that skeleton is inserted (@pxref{Using 155the point is normally left after that skeleton is inserted (@pxref{Using
156Skeletons}). The point (@pxref{(emacs)Point}) is left at the next 156Skeletons}). The point (@pxref{Point,,, emacs, The GNU Emacs Manual}) is left at the next
157interesting spot in the skeleton instead. 157interesting spot in the skeleton instead.
158 158
159 A negative prefix means to do something similar with that many previously 159 A negative prefix means to do something similar with that many previously
160marked interregions (@pxref{(emacs)Mark}). In the simplest case, if you type 160marked interregions (@pxref{Mark,,, emacs, The GNU Emacs Manual}). In the simplest case, if you type
161@kbd{M--} just before issuing the skeleton command, that will wrap the 161@kbd{M--} just before issuing the skeleton command, that will wrap the
162skeleton around the current region, just like a positive argument would have 162skeleton around the current region, just like a positive argument would have
163wrapped it around a number of words. 163wrapped it around a number of words.
@@ -189,8 +189,8 @@ tried to follow the order in which you marked these points.
189@cindex skeletons as abbrevs 189@cindex skeletons as abbrevs
190 190
191 Rather than use a key binding for every skeleton command, you can also 191 Rather than use a key binding for every skeleton command, you can also
192define an abbreviation (@pxref{(emacs)Defining Abbrevs}) that will expand 192define an abbreviation (@pxref{Defining Abbrevs,,, emacs, The GNU Emacs Manual}) that will expand
193(@pxref{(emacs)Expanding Abbrevs}) into the skeleton. 193(@pxref{Expanding Abbrevs,,, emacs, The GNU Emacs Manual}) into the skeleton.
194 194
195 Say you want @samp{ifst} to be an abbreviation for the C language if 195 Say you want @samp{ifst} to be an abbreviation for the C language if
196statement. You will tell Emacs that @samp{ifst} expands to the empty string 196statement. You will tell Emacs that @samp{ifst} expands to the empty string
@@ -290,7 +290,7 @@ skeleton. The first argument is the command name, the second is a
290documentation string, and the rest is an interactor and any number of skeleton 290documentation string, and the rest is an interactor and any number of skeleton
291elements together forming a skeleton. This skeleton is assigned to a variable 291elements together forming a skeleton. This skeleton is assigned to a variable
292of the same name as the command and can thus be overridden from your 292of the same name as the command and can thus be overridden from your
293@file{~/.emacs} file (@pxref{(emacs)Init File}). 293@file{~/.emacs} file (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
294 294
295 295
296 296
@@ -309,14 +309,14 @@ fingers backwards, this can be quite relieving too.
309 309
310@findex skeleton-pair-insert-maybe 310@findex skeleton-pair-insert-maybe
311@vindex skeleton-pair 311@vindex skeleton-pair
312 This is done by binding the first key (@pxref{(emacs)Rebinding}) of 312 This is done by binding the first key (@pxref{Rebinding,,, emacs, The GNU Emacs Manual}) of
313the pair to @code{skeleton-pair-insert-maybe} instead of 313the pair to @code{skeleton-pair-insert-maybe} instead of
314@code{self-insert-command}. The ``maybe'' comes from the fact that 314@code{self-insert-command}. The ``maybe'' comes from the fact that
315this at-first surprising behavior is initially turned off. To enable 315this at-first surprising behavior is initially turned off. To enable
316it, you must set @code{skeleton-pair} to some non-@code{nil} value. 316it, you must set @code{skeleton-pair} to some non-@code{nil} value.
317And even then, a positive argument (@pxref{(emacs)Arguments}) will 317And even then, a positive argument (@pxref{Arguments,,, emacs, The GNU Emacs Manual}) will
318make this key behave like a self-inserting key 318make this key behave like a self-inserting key
319(@pxref{(emacs)Inserting Text}). 319(@pxref{Inserting Text,,, emacs, The GNU Emacs Manual}).
320 320
321@vindex skeleton-pair-on-word 321@vindex skeleton-pair-on-word
322 While this breaks with the stated intention of always balancing pairs, it 322 While this breaks with the stated intention of always balancing pairs, it
@@ -354,7 +354,7 @@ the buffer. The main application for this function, as its name suggests,
354is to have it be called automatically every time an empty, and only an 354is to have it be called automatically every time an empty, and only an
355empty file is visited. This is accomplished by putting @code{(add-hook 355empty file is visited. This is accomplished by putting @code{(add-hook
356'find-file-hook 'auto-insert)} into your @file{~/.emacs} file 356'find-file-hook 'auto-insert)} into your @file{~/.emacs} file
357(@pxref{(emacs)Init File}). 357(@pxref{Init File,,, emacs, The GNU Emacs Manual}).
358 358
359@vindex auto-insert-alist 359@vindex auto-insert-alist
360 What gets inserted, if anything, is determined by the variable 360 What gets inserted, if anything, is determined by the variable
@@ -392,10 +392,10 @@ source files insert the usual header, with a copyright of your
392environment variable @env{$ORGANIZATION} or else the FSF, and prompt 392environment variable @env{$ORGANIZATION} or else the FSF, and prompt
393for valid keywords describing the contents. Files in a @file{bin} 393for valid keywords describing the contents. Files in a @file{bin}
394directory for which Emacs could determine no specialized mode 394directory for which Emacs could determine no specialized mode
395(@pxref{(emacs)Choosing Modes}) are set to Shell script mode. 395(@pxref{Choosing Modes,,, emacs, The GNU Emacs Manual}) are set to Shell script mode.
396 396
397@findex define-auto-insert 397@findex define-auto-insert
398 In Lisp (@pxref{(emacs)Init File}) you can use the function 398 In Lisp (@pxref{Init File,,, emacs, The GNU Emacs Manual}) you can use the function
399@code{define-auto-insert} to add to or modify 399@code{define-auto-insert} to add to or modify
400@code{auto-insert-alist}. See its documentation with @kbd{C-h f 400@code{auto-insert-alist}. See its documentation with @kbd{C-h f
401define-auto-insert}. 401define-auto-insert}.
@@ -438,7 +438,7 @@ expression that matched the filename.
438 @kbd{M-x copyright} is a skeleton inserting command, that adds a copyright 438 @kbd{M-x copyright} is a skeleton inserting command, that adds a copyright
439notice at the point. The ``by'' part is taken from your environment variable 439notice at the point. The ``by'' part is taken from your environment variable
440@env{$ORGANIZATION} or if that isn't set you are prompted for it. If the 440@env{$ORGANIZATION} or if that isn't set you are prompted for it. If the
441buffer has a comment syntax (@pxref{(emacs)Comments}), this is inserted as a comment. 441buffer has a comment syntax (@pxref{Comments,,, emacs, The GNU Emacs Manual}), this is inserted as a comment.
442 442
443@findex copyright-update 443@findex copyright-update
444@vindex copyright-limit 444@vindex copyright-limit
@@ -450,13 +450,13 @@ existing ones, in the same format as the preceding year, i.e., 1994, '94 or 94.
450If a dash-separated year list up to last year is found, that is extended to 450If a dash-separated year list up to last year is found, that is extended to
451current year, else the year is added separated by a comma. Or it replaces 451current year, else the year is added separated by a comma. Or it replaces
452them when this is called with a prefix argument. If a header referring to a 452them when this is called with a prefix argument. If a header referring to a
453wrong version of the GNU General Public License (@pxref{(emacs)Copying}) is found, 453wrong version of the GNU General Public License (@pxref{Copying,,, emacs, The GNU Emacs Manual}) is found,
454that is updated too. 454that is updated too.
455 455
456 An interesting application for this function is to have it be called 456 An interesting application for this function is to have it be called
457automatically every time a file is saved. This is accomplished by 457automatically every time a file is saved. This is accomplished by
458putting @code{(add-hook 'before-save-hook 'copyright-update)} into 458putting @code{(add-hook 'before-save-hook 'copyright-update)} into
459your @file{~/.emacs} file (@pxref{(emacs)Init File}). Alternative, 459your @file{~/.emacs} file (@pxref{Init File,,, emacs, The GNU Emacs Manual}). Alternative,
460you can do @kbd{M-x customize-variable @key{RET} before-save-hook 460you can do @kbd{M-x customize-variable @key{RET} before-save-hook
461@key{RET}}. @code{copyright-update} is conveniently listed as an 461@key{RET}}. @code{copyright-update} is conveniently listed as an
462option in the customization buffer. 462option in the customization buffer.
diff --git a/doc/misc/bovine.texi b/doc/misc/bovine.texi
index a263cadabae..48d5cf9e18a 100644
--- a/doc/misc/bovine.texi
+++ b/doc/misc/bovine.texi
@@ -23,7 +23,7 @@
23@c %**end of header 23@c %**end of header
24 24
25@copying 25@copying
26Copyright @copyright{} 1999-2004, 2012 Free Software Foundation, Inc. 26Copyright @copyright{} 1999--2004, 2012--2013 Free Software Foundation, Inc.
27 27
28@quotation 28@quotation
29Permission is granted to copy, distribute and/or modify this document 29Permission is granted to copy, distribute and/or modify this document
@@ -34,8 +34,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
34is included in the section entitled ``GNU Free Documentation License''. 34is included in the section entitled ``GNU Free Documentation License''.
35 35
36(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 36(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
37modify this GNU manual. Buying copies from the FSF supports it in 37modify this GNU manual.''
38developing GNU and promoting software freedom.''
39@end quotation 38@end quotation
40@end copying 39@end copying
41 40
@@ -139,7 +138,7 @@ of simplified Emacs Lisp expressions for concocting the parse tree.
139In bison, each time an element of @var{components} is found, it is 138In bison, each time an element of @var{components} is found, it is
140@dfn{shifted} onto the parser stack. (The stack of matched elements.) 139@dfn{shifted} onto the parser stack. (The stack of matched elements.)
141When all @var{components}' elements have been matched, it is 140When all @var{components}' elements have been matched, it is
142@dfn{reduced} to @var{result}. @xref{(bison)Algorithm}. 141@dfn{reduced} to @var{result}. @xref{Algorithm,,, bison, The GNU Bison Manual}.
143 142
144A particular @var{result} written into your grammar becomes 143A particular @var{result} written into your grammar becomes
145the parser's goal. It is designated by a @code{%start} statement 144the parser's goal. It is designated by a @code{%start} statement
@@ -369,8 +368,8 @@ Is the kind of tag being create, such as @code{function}, or
369@code{variable}, though any symbol will work. 368@code{variable}, though any symbol will work.
370 369
371@item attributes 370@item attributes
372Is an optional set of labeled values such as @w{@code{:constant-flag t :parent 371Is an optional set of labeled values such as @code{:constant-flag t :parent
373"parenttype"}}. 372"parenttype"}.
374@end table 373@end table
375 374
376@item (TAG-VARIABLE @var{name} @var{type} @var{default-value} [@var{attributes}]) 375@item (TAG-VARIABLE @var{name} @var{type} @var{default-value} [@var{attributes}])
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index 71a90e1a3b3..5dabf5cd314 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -94,7 +94,7 @@ This file documents Calc, the GNU Emacs calculator, included with
94GNU Emacs @value{EMACSVER}. 94GNU Emacs @value{EMACSVER}.
95@end ifnotinfo 95@end ifnotinfo
96 96
97Copyright @copyright{} 1990-1991, 2001-2012 Free Software Foundation, Inc. 97Copyright @copyright{} 1990--1991, 2001--2013 Free Software Foundation, Inc.
98 98
99@quotation 99@quotation
100Permission is granted to copy, distribute and/or modify this document 100Permission is granted to copy, distribute and/or modify this document
@@ -106,8 +106,7 @@ Texts as in (a) below. A copy of the license is included in the section
106entitled ``GNU Free Documentation License.'' 106entitled ``GNU Free Documentation License.''
107 107
108(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 108(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
109modify this GNU manual. Buying copies from the FSF supports it in 109modify this GNU manual.''
110developing GNU and promoting software freedom.''
111@end quotation 110@end quotation
112@end copying 111@end copying
113 112
@@ -13417,27 +13416,27 @@ dates. @xref{Specifying Operators}. To avoid confusion with nameless
13417functions, your date formats should avoid using the @samp{#} character. 13416functions, your date formats should avoid using the @samp{#} character.
13418 13417
13419@menu 13418@menu
13420* ISO-8601:: 13419* ISO 8601::
13421* Date Formatting Codes:: 13420* Date Formatting Codes::
13422* Free-Form Dates:: 13421* Free-Form Dates::
13423* Standard Date Formats:: 13422* Standard Date Formats::
13424@end menu 13423@end menu
13425 13424
13426@node ISO-8601, Date Formatting Codes, Date Formats, Date Formats 13425@node ISO 8601, Date Formatting Codes, Date Formats, Date Formats
13427@subsubsection ISO-8601 13426@subsubsection ISO 8601
13428 13427
13429@noindent 13428@noindent
13430@cindex ISO-8601 13429@cindex ISO 8601
13431The same date can be written down in different formats and Calc tries 13430The same date can be written down in different formats and Calc tries
13432to allow you to choose your preferred format. Some common formats are 13431to allow you to choose your preferred format. Some common formats are
13433ambiguous, however; for example, 10/11/2012 means October 11, 13432ambiguous, however; for example, 10/11/2012 means October 11,
134342012 in the United States but it means November 10, 2012 in 134332012 in the United States but it means November 10, 2012 in
13435Europe. To help avoid such ambiguities, the International Organization 13434Europe. To help avoid such ambiguities, the International Organization
13436for Standardization (ISO) provides the ISO-8601 standard, which 13435for Standardization (ISO) provides the ISO 8601 standard, which
13437provides three different but easily distinguishable and unambiguous 13436provides three different but easily distinguishable and unambiguous
13438ways to represent a date. 13437ways to represent a date.
13439 13438
13440The ISO-8601 calendar date representation is 13439The ISO 8601 calendar date representation is
13441 13440
13442@example 13441@example
13443 @var{YYYY}-@var{MM}-@var{DD} 13442 @var{YYYY}-@var{MM}-@var{DD}
@@ -13452,9 +13451,9 @@ later.) The year, which should be padded with zeros to ensure it has at
13452least four digits, is the Gregorian year, except that the year before 13451least four digits, is the Gregorian year, except that the year before
134530001 (1 AD) is the year 0000 (1 BC). The date October 11, 2012 is 134520001 (1 AD) is the year 0000 (1 BC). The date October 11, 2012 is
13454written 2012-10-11 in this representation and November 10, 2012 is 13453written 2012-10-11 in this representation and November 10, 2012 is
13455written 2012-11-10. 13454written 2012-11-10.
13456 13455
13457The ISO-8601 ordinal date representation is 13456The ISO 8601 ordinal date representation is
13458 13457
13459@example 13458@example
13460 @var{YYYY}-@var{DDD} 13459 @var{YYYY}-@var{DDD}
@@ -13463,9 +13462,9 @@ The ISO-8601 ordinal date representation is
13463@noindent 13462@noindent
13464where @var{YYYY} is the year, as above, and @var{DDD} is the day of the year. 13463where @var{YYYY} is the year, as above, and @var{DDD} is the day of the year.
13465The date December 31, 2011 is written 2011-365 in this representation 13464The date December 31, 2011 is written 2011-365 in this representation
13466and January 1, 2012 is written 2012-001. 13465and January 1, 2012 is written 2012-001.
13467 13466
13468The ISO-8601 week date representation is 13467The ISO 8601 week date representation is
13469 13468
13470@example 13469@example
13471 @var{YYYY}-W@var{ww}-@var{D} 13470 @var{YYYY}-W@var{ww}-@var{D}
@@ -13476,32 +13475,32 @@ where @var{YYYY} is the ISO week-numbering year, @var{ww} is the two
13476digit week number (preceded by a literal ``W''), and @var{D} is the day 13475digit week number (preceded by a literal ``W''), and @var{D} is the day
13477of the week (1 for Monday through 7 for Sunday). The ISO week-numbering 13476of the week (1 for Monday through 7 for Sunday). The ISO week-numbering
13478year is based on the Gregorian year but can differ slightly. The first 13477year is based on the Gregorian year but can differ slightly. The first
13479week of an ISO week-numbering year is the week with the Gregorian year's 13478week of an ISO week-numbering year is the week with the Gregorian year's
13480first Thursday in it (equivalently, the week containing January 4); 13479first Thursday in it (equivalently, the week containing January 4);
13481any day of that week (Monday through Sunday) is part of the same ISO 13480any day of that week (Monday through Sunday) is part of the same ISO
13482week-numbering year, any day from the previous week is part of the 13481week-numbering year, any day from the previous week is part of the
13483previous year. For example, January 4, 2013 is on a Friday, and so 13482previous year. For example, January 4, 2013 is on a Friday, and so
13484the first week for the ISO week-numbering year 2013 starts on 13483the first week for the ISO week-numbering year 2013 starts on
13485Monday, December 31, 2012. The day December 31, 2012 is then part of the 13484Monday, December 31, 2012. The day December 31, 2012 is then part of the
13486Gregorian year 2012 but ISO week-numbering year 2013. In the week 13485Gregorian year 2012 but ISO week-numbering year 2013. In the week
13487date representation, this week goes from 2013-W01-1 (December 31, 13486date representation, this week goes from 2013-W01-1 (December 31,
134882012) to 2013-W01-7 (January 6, 2013). 134872012) to 2013-W01-7 (January 6, 2013).
13489 13488
13490All three ISO-8601 representations arrange the numbers from most 13489All three ISO 8601 representations arrange the numbers from most
13491significant to least significant; as well as being unambiguous 13490significant to least significant; as well as being unambiguous
13492representations, they are easy to sort since chronological order in 13491representations, they are easy to sort since chronological order in
13493this formats corresponds to lexicographical order. The hyphens are 13492this formats corresponds to lexicographical order. The hyphens are
13494sometimes omitted. 13493sometimes omitted.
13495 13494
13496The ISO-8601 standard uses a 24 hour clock; a particular time is 13495The ISO 8601 standard uses a 24 hour clock; a particular time is
13497represented by @var{hh}:@var{mm}:@var{ss} where @var{hh} is the 13496represented by @var{hh}:@var{mm}:@var{ss} where @var{hh} is the
13498two-digit hour (from 00 to 24), @var{mm} is the two-digit minute (from 13497two-digit hour (from 00 to 24), @var{mm} is the two-digit minute (from
1349900 to 59) and @var{ss} is the two-digit second. The seconds or minutes 1349800 to 59) and @var{ss} is the two-digit second. The seconds or minutes
13500and seconds can be omitted, and decimals can be added. If a date with a 13499and seconds can be omitted, and decimals can be added. If a date with a
13501time is represented, they should be separated by a literal ``T'', so noon 13500time is represented, they should be separated by a literal ``T'', so noon
13502on December 13, 2012 can be represented as 2012-12-13T12:00 13501on December 13, 2012 can be represented as 2012-12-13T12:00.
13503 13502
13504@node Date Formatting Codes, Free-Form Dates, ISO-8601, Date Formats 13503@node Date Formatting Codes, Free-Form Dates, ISO 8601, Date Formats
13505@subsubsection Date Formatting Codes 13504@subsubsection Date Formatting Codes
13506 13505
13507@noindent 13506@noindent
@@ -13543,9 +13542,9 @@ Year: ``1991'' for 1991, ``23'' for 23 AD.
13543@item YYYY 13542@item YYYY
13544Year: ``1991'' for 1991, ``+23'' for 23 AD. 13543Year: ``1991'' for 1991, ``+23'' for 23 AD.
13545@item ZYYY 13544@item ZYYY
13546Year: ``1991'' for 1991, ``0023'' for 23 AD., ``0000'' for 1 BC. 13545Year: ``1991'' for 1991, ``0023'' for 23 AD, ``0000'' for 1 BC.
13547@item IYYY 13546@item IYYY
13548Year: ISO-8601 week-numbering year. 13547Year: ISO 8601 week-numbering year.
13549@item aa 13548@item aa
13550Year: ``ad'' or blank. 13549Year: ``ad'' or blank.
13551@item AA 13550@item AA
@@ -13607,7 +13606,7 @@ Weekday: ``SUNDAY'' for Sunday.
13607@item Wwww 13606@item Wwww
13608Weekday: ``Sunday'' for Sunday. 13607Weekday: ``Sunday'' for Sunday.
13609@item Iww 13608@item Iww
13610Week number: ISO-8601 week number, ``W01'' for week 1. 13609Week number: ISO 8601 week number, ``W01'' for week 1.
13611@item d 13610@item d
13612Day of year: ``34'' for Feb. 3. 13611Day of year: ``34'' for Feb. 3.
13613@item ddd 13612@item ddd
@@ -13718,15 +13717,21 @@ abbreviated to one letter, and the alternate forms @samp{a.m.},
13718@samp{p.m.}, and @samp{mid} are also understood. Obviously 13717@samp{p.m.}, and @samp{mid} are also understood. Obviously
13719@samp{noon} and @samp{midnight} are allowed only on 12:00:00. 13718@samp{noon} and @samp{midnight} are allowed only on 12:00:00.
13720The words @samp{noon}, @samp{mid}, and @samp{midnight} are also 13719The words @samp{noon}, @samp{mid}, and @samp{midnight} are also
13721recognized with no number attached. 13720recognized with no number attached. Midnight will represent the
13721beginning of a day.
13722 13722
13723If there is no AM/PM indicator, the time is interpreted in 24-hour 13723If there is no AM/PM indicator, the time is interpreted in 24-hour
13724format. 13724format.
13725 13725
13726To read the date portion, all words and numbers are isolated 13726When reading the date portion, Calc first checks to see if it is an
13727from the string; other characters are ignored. All words must 13727ISO 8601 week-numbering date; if the string contains an integer
13728be either month names or day-of-week names (the latter of which 13728representing the year, a ``W'' followed by two digits for the week
13729are ignored). Names can be written in full or as three-letter 13729number, and an integer from 1 to 7 representing the weekday (in that
13730order), then all other characters are ignored and this information
13731determines the date. Otherwise, all words and numbers are isolated
13732from the string; other characters are ignored. All words must be
13733either month names or day-of-week names (the latter of which are
13734ignored). Names can be written in full or as three-letter
13730abbreviations. 13735abbreviations.
13731 13736
13732Large numbers, or numbers with @samp{+} or @samp{-} signs, 13737Large numbers, or numbers with @samp{+} or @samp{-} signs,
@@ -13792,7 +13797,7 @@ command (@pxref{Mode Settings}).
13792@item 10 13797@item 10
13793@samp{ZYYY-MM-DD Www< hh:mm>} (Org mode format) 13798@samp{ZYYY-MM-DD Www< hh:mm>} (Org mode format)
13794@item 11 13799@item 11
13795@samp{IYYY-Iww-w<Thh:mm:ss>} (ISO-8601 week numbering format) 13800@samp{IYYY-Iww-w<Thh:mm:ss>} (ISO 8601 week numbering format)
13796@end table 13801@end table
13797 13802
13798@node Truncating the Stack, Justification, Date Formats, Display Modes 13803@node Truncating the Stack, Justification, Date Formats, Display Modes
@@ -17436,7 +17441,7 @@ daylight saving computations. This is an internal version of
17436the user-level @code{pwday} function described in the previous 17441the user-level @code{pwday} function described in the previous
17437section. It takes four arguments: The floating-point date value, 17442section. It takes four arguments: The floating-point date value,
17438the corresponding six-element date list, the day-of-month number, 17443the corresponding six-element date list, the day-of-month number,
17439and the weekday number (0-6). 17444and the weekday number (0--6).
17440 17445
17441The default daylight saving hook ignores the time zone name, but a 17446The default daylight saving hook ignores the time zone name, but a
17442more sophisticated hook could use different algorithms for different 17447more sophisticated hook could use different algorithms for different
@@ -36749,7 +36754,7 @@ time zone number or name from the top of the stack. @xref{Time Zones}.
36749 36754
36750@c 17 36755@c 17
36751@item 36756@item
36752A prefix argument specifies a day number (0-6, 0-31, or 0-366). 36757A prefix argument specifies a day number (0--6, 0--31, or 0--366).
36753 36758
36754@c 18 36759@c 18
36755@item 36760@item
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index 76d9eb42883..f63c6c54a16 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -156,7 +156,7 @@ CC Mode
156@copying 156@copying
157This manual is for CC Mode in Emacs. 157This manual is for CC Mode in Emacs.
158 158
159Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. 159Copyright @copyright{} 1995--2013 Free Software Foundation, Inc.
160 160
161@quotation 161@quotation
162Permission is granted to copy, distribute and/or modify this document 162Permission is granted to copy, distribute and/or modify this document
@@ -167,8 +167,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
167is included in the section entitled ``GNU Free Documentation License''. 167is included in the section entitled ``GNU Free Documentation License''.
168 168
169(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 169(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
170modify this GNU manual. Buying copies from the FSF supports it in 170modify this GNU manual.''
171developing GNU and promoting software freedom.''
172@end quotation 171@end quotation
173@end copying 172@end copying
174 173
@@ -220,7 +219,7 @@ Objective-C, Java, CORBA IDL (and the variants PSDL and CIDL), Pike
220and AWK code. It provides syntax-based indentation, font locking, and 219and AWK code. It provides syntax-based indentation, font locking, and
221has several handy commands and some minor modes to make the editing 220has several handy commands and some minor modes to make the editing
222easier. It does not provide tools to look up and navigate between 221easier. It does not provide tools to look up and navigate between
223functions, classes etc - there are other packages for that. 222functions, classes, etc.; there are other packages for that.
224 223
225@insertcopying 224@insertcopying
226@end ifnottex 225@end ifnottex
@@ -370,7 +369,7 @@ Late in 1997, Martin Stjernholm joined Barry on the @ccmode{}
370Maintainers Team, and implemented the Pike support. In 2000 Martin 369Maintainers Team, and implemented the Pike support. In 2000 Martin
371took over as the sole maintainer. In 2001 Alan Mackenzie joined the 370took over as the sole maintainer. In 2001 Alan Mackenzie joined the
372team, implementing AWK support in version 5.30. @ccmode{} did not 371team, implementing AWK support in version 5.30. @ccmode{} did not
373originally contain the font lock support for its languages --- that 372originally contain the font lock support for its languages; that
374was added in version 5.30. 373was added in version 5.30.
375 374
376This manual describes @ccmode{} 375This manual describes @ccmode{}
@@ -442,7 +441,7 @@ increasing detail.
442@itemize @bullet 441@itemize @bullet
443@item 442@item
444The chapter ``Configuration Basics'' tells you @emph{how} to write 443The chapter ``Configuration Basics'' tells you @emph{how} to write
445customizations - whether in hooks, in styles, in both, or in neither, 444customizations: whether in hooks, in styles, in both, or in neither,
446depending on your needs. It describes the @ccmode{} style system and 445depending on your needs. It describes the @ccmode{} style system and
447lists the standard styles that @ccmode{} supplies. 446lists the standard styles that @ccmode{} supplies.
448 447
@@ -469,7 +468,7 @@ The FAQ contains a list of common problems and questions.
469 468
470@item 469@item
471The next two chapters tell you how to get in touch with the @ccmode{} 470The next two chapters tell you how to get in touch with the @ccmode{}
472project - whether for updating @ccmode{} or submitting bug reports. 471project: whether for updating @ccmode{} or submitting bug reports.
473@end itemize 472@end itemize
474 473
475@noindent 474@noindent
@@ -716,7 +715,7 @@ current line.
716When it is @code{nil}, @key{TAB} (re)indents the line only if point is 715When it is @code{nil}, @key{TAB} (re)indents the line only if point is
717to the left of the first non-whitespace character on the line. 716to the left of the first non-whitespace character on the line.
718Otherwise it inserts some whitespace (a tab or an equivalent number of 717Otherwise it inserts some whitespace (a tab or an equivalent number of
719spaces - see below) at point. 718spaces; see below) at point.
720@item 719@item
721With some other value, the line is reindented. Additionally, if point 720With some other value, the line is reindented. Additionally, if point
722is within a string or comment, some whitespace is inserted. 721is within a string or comment, some whitespace is inserted.
@@ -821,10 +820,10 @@ often (in seconds) progress messages are to be displayed.
821@kindex C-c C-c 820@kindex C-c C-c
822@findex comment-region 821@findex comment-region
823This command comments out the lines that start in the region. With a 822This command comments out the lines that start in the region. With a
824negative argument, it does the opposite - it deletes the comment 823negative argument, it does the opposite: it deletes the comment
825delimiters from these lines. @xref{Multi-Line Comments,,, emacs, GNU 824delimiters from these lines. @xref{Multi-Line Comments,,, emacs, GNU
826Emacs Manual}, for fuller details. @code{comment-region} isn't 825Emacs Manual}, for fuller details. @code{comment-region} isn't
827actually part of @ccmode{} - it is given a @ccmode{} binding for 826actually part of @ccmode{}; it is given a @ccmode{} binding for
828convenience. 827convenience.
829 828
830@item @kbd{M-;} (@code{comment-dwim} or @code{indent-for-comment} @footnote{The name of this command varies between (X)Emacs versions.}) 829@item @kbd{M-;} (@code{comment-dwim} or @code{indent-for-comment} @footnote{The name of this command varies between (X)Emacs versions.})
@@ -1148,7 +1147,7 @@ them yourself, e.g., after typing @samp{@}}s. Its action is suppressed
1148when electric mode is disabled. 1147when electric mode is disabled.
1149@item hungry-delete mode 1148@item hungry-delete mode
1150This lets you delete a contiguous block of whitespace with a single 1149This lets you delete a contiguous block of whitespace with a single
1151key - for example, the newline and indentation just inserted by 1150key: for example, the newline and indentation just inserted by
1152auto-newline when you want to back up and write a comment after the 1151auto-newline when you want to back up and write a comment after the
1153last statement. 1152last statement.
1154@item subword mode 1153@item subword mode
@@ -1177,7 +1176,7 @@ are enabled but the other two modes are disabled.
1177 1176
1178@ccmode{} displays the current state of the first four of these minor 1177@ccmode{} displays the current state of the first four of these minor
1179modes on the modeline by appending letters to the major mode's name, 1178modes on the modeline by appending letters to the major mode's name,
1180one letter for each enabled minor mode - @samp{l} for electric mode, 1179one letter for each enabled minor mode: @samp{l} for electric mode,
1181@samp{a} for auto-newline mode, @samp{h} for hungry delete mode, and 1180@samp{a} for auto-newline mode, @samp{h} for hungry delete mode, and
1182@samp{w} for subword mode. If all these modes were enabled, you'd see 1181@samp{w} for subword mode. If all these modes were enabled, you'd see
1183@samp{C/lahw}@footnote{The @samp{C} would be replaced with the name of 1182@samp{C/lahw}@footnote{The @samp{C} would be replaced with the name of
@@ -1235,7 +1234,7 @@ turn it (or them) off.
1235@cindex electric characters 1234@cindex electric characters
1236@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1235@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1237 1236
1238Most punctuation keys provide @dfn{electric} behavior - as well as 1237Most punctuation keys provide @dfn{electric} behavior: as well as
1239inserting themselves they perform some other action, such as 1238inserting themselves they perform some other action, such as
1240reindenting the line. This reindentation saves you from having to 1239reindenting the line. This reindentation saves you from having to
1241reindent a line manually after typing, say, a @samp{@}}. A few 1240reindent a line manually after typing, say, a @samp{@}}. A few
@@ -2102,7 +2101,7 @@ initialization and the result is prepended. For an example, see
2102@code{javadoc-font-lock-keywords} in @file{cc-fonts.el}. 2101@code{javadoc-font-lock-keywords} in @file{cc-fonts.el}.
2103 2102
2104If you add support for another doc comment style, please consider 2103If you add support for another doc comment style, please consider
2105contributing it - send a note to @email{bug-cc-mode@@gnu.org}. 2104contributing it: send a note to @email{bug-cc-mode@@gnu.org}.
2106 2105
2107 2106
2108@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 2107@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@@ -2250,7 +2249,7 @@ more sophisticated facilities, hooks and styles.
2250An Emacs @dfn{hook} is a place to put Lisp functions that you want 2249An Emacs @dfn{hook} is a place to put Lisp functions that you want
2251Emacs to execute later in specific circumstances. 2250Emacs to execute later in specific circumstances.
2252@xref{Hooks,,,@lispref{}, @lispreftitle{}}. @ccmode{} supplies a main 2251@xref{Hooks,,,@lispref{}, @lispreftitle{}}. @ccmode{} supplies a main
2253hook and a language-specific hook for each language it supports - any 2252hook and a language-specific hook for each language it supports; any
2254functions you put onto these hooks get executed as the last part of a 2253functions you put onto these hooks get executed as the last part of a
2255buffer's initialization. Typically you put most of your customization 2254buffer's initialization. Typically you put most of your customization
2256within the main hook, and use the language-specific hooks to vary the 2255within the main hook, and use the language-specific hooks to vary the
@@ -2684,7 +2683,7 @@ string.
2684If none of the built-in styles is appropriate, you'll probably want to 2683If none of the built-in styles is appropriate, you'll probably want to
2685create a new @dfn{style definition}, possibly based on an existing 2684create a new @dfn{style definition}, possibly based on an existing
2686style. To do this, put the new style's settings into a list with the 2685style. To do this, put the new style's settings into a list with the
2687following format - the list can then be passed as an argument to the 2686following format; the list can then be passed as an argument to the
2688function @code{c-add-style}. You can see an example of a style 2687function @code{c-add-style}. You can see an example of a style
2689definition in @ref{Sample .emacs File}. 2688definition in @ref{Sample .emacs File}.
2690 2689
@@ -3167,7 +3166,7 @@ different ways, depending on the character just typed:
3167@item Braces and Colons 3166@item Braces and Colons
3168@ccmode{} first determines the syntactic context of the brace or colon 3167@ccmode{} first determines the syntactic context of the brace or colon
3169(@pxref{Syntactic Symbols}), then looks for a corresponding element in 3168(@pxref{Syntactic Symbols}), then looks for a corresponding element in
3170an alist. This element specifies where to put newlines - this is any 3169an alist. This element specifies where to put newlines: this is any
3171combination of before and after the brace or colon. If no alist 3170combination of before and after the brace or colon. If no alist
3172element is found, newlines are inserted both before and after a brace, 3171element is found, newlines are inserted both before and after a brace,
3173but none are inserted around a colon. See @ref{Hanging Braces} and 3172but none are inserted around a colon. See @ref{Hanging Braces} and
@@ -3268,7 +3267,7 @@ syntactic symbol, the associated value is either @code{nil}, a list,
3268or a function. 3267or a function.
3269 3268
3270@table @asis 3269@table @asis
3271@item The Key - the syntactic symbol 3270@item The Key: the syntactic symbol
3272The syntactic symbols that are useful as keys in this list are 3271The syntactic symbols that are useful as keys in this list are
3273@code{brace-list-intro}, @code{statement-cont}, 3272@code{brace-list-intro}, @code{statement-cont},
3274@code{inexpr-class-open}, @code{inexpr-class-close}, and all the 3273@code{inexpr-class-open}, @code{inexpr-class-close}, and all the
@@ -3291,7 +3290,7 @@ lists in this regard, even though they do for normal indentation
3291purposes. It's currently not possible to set automatic newlines on 3290purposes. It's currently not possible to set automatic newlines on
3292these constructs. 3291these constructs.
3293 3292
3294@item The associated value - the ``ACTION'' list or function 3293@item The associated value: the ``ACTION'' list or function
3295The value associated with each syntactic symbol in this association 3294The value associated with each syntactic symbol in this association
3296list is called an @var{action}, which can be either a list or a 3295list is called an @var{action}, which can be either a list or a
3297function which returns a list. @xref{Custom Braces}, for how to use 3296function which returns a list. @xref{Custom Braces}, for how to use
@@ -3461,7 +3460,7 @@ that the brace appears on a line by itself.
3461 3460
3462Using a mechanism similar to brace hanging (@pxref{Hanging Braces}), 3461Using a mechanism similar to brace hanging (@pxref{Hanging Braces}),
3463colons can also be made to hang using the style variable 3462colons can also be made to hang using the style variable
3464@code{c-hanging-colons-alist} - When a colon is typed, @ccmode 3463@code{c-hanging-colons-alist}: when a colon is typed, @ccmode
3465determines its syntactic context, looks this up in the alist 3464determines its syntactic context, looks this up in the alist
3466@code{c-changing-colons-alist} and inserts up to two newlines 3465@code{c-changing-colons-alist} and inserts up to two newlines
3467accordingly. Here, however, If @ccmode fails to find an entry for a 3466accordingly. Here, however, If @ccmode fails to find an entry for a
@@ -3472,17 +3471,17 @@ newly typed colon.
3472@vindex hanging-colons-alist (c-) 3471@vindex hanging-colons-alist (c-)
3473 3472
3474@table @asis 3473@table @asis
3475@item The Key - the syntactic symbol 3474@item The Key: the syntactic symbol
3476The syntactic symbols appropriate as keys in this association list 3475The syntactic symbols appropriate as keys in this association list
3477are: @code{case-label}, @code{label}, @code{access-label}, 3476are: @code{case-label}, @code{label}, @code{access-label},
3478@code{member-init-intro}, and @code{inher-intro}. @xref{Syntactic 3477@code{member-init-intro}, and @code{inher-intro}. @xref{Syntactic
3479Symbols}. Elements with any other value as a key get ignored. 3478Symbols}. Elements with any other value as a key get ignored.
3480 3479
3481@item The associate value - the ``ACTION'' list 3480@item The associated value: the ``ACTION'' list
3482The @var{action} here is simply a list containing a combination of the 3481The @var{action} here is simply a list containing a combination of the
3483symbols @code{before} and @code{after}. Unlike in 3482symbols @code{before} and @code{after}. Unlike in
3484@code{c-hanging-braces-alist}, functions as @var{actions} are not 3483@code{c-hanging-braces-alist}, functions as @var{actions} are not
3485supported - there doesn't seem to be any need for them. 3484supported; there doesn't seem to be any need for them.
3486@end table 3485@end table
3487@end defopt 3486@end defopt
3488 3487
@@ -3914,7 +3913,7 @@ recognized, e.g., @code{statement}, @code{substatement},
3914@code{class-open}, @code{class-close}, etc. @xref{Syntactic Symbols}, 3913@code{class-open}, @code{class-close}, etc. @xref{Syntactic Symbols},
3915for a complete list of currently recognized syntactic symbols and 3914for a complete list of currently recognized syntactic symbols and
3916their semantics. The remaining entries are various data associated 3915their semantics. The remaining entries are various data associated
3917with the recognized construct - there might be zero or more. 3916with the recognized construct; there might be zero or more.
3918 3917
3919@cindex anchor position 3918@cindex anchor position
3920Conceptually, a line of code is always indented relative to some 3919Conceptually, a line of code is always indented relative to some
@@ -4571,7 +4570,7 @@ example:
4571Here, lines 4, 7, and 10 are all assigned @code{case-label} syntax, 4570Here, lines 4, 7, and 10 are all assigned @code{case-label} syntax,
4572while lines 5 and 8 are assigned @code{statement-case-intro}. Line 11 4571while lines 5 and 8 are assigned @code{statement-case-intro}. Line 11
4573is treated slightly differently since it contains a brace that opens a 4572is treated slightly differently since it contains a brace that opens a
4574block --- it is given @code{statement-case-open} syntax. 4573block; it is given @code{statement-case-open} syntax.
4575 4574
4576@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 4575@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
4577@node Brace List Symbols, External Scope Symbols, Switch Statement Symbols, Syntactic Symbols 4576@node Brace List Symbols, External Scope Symbols, Switch Statement Symbols, Syntactic Symbols
@@ -4799,7 +4798,7 @@ Line 2 is assigned the @code{func-decl-cont} syntax.
4799@ssindex comment-intro 4798@ssindex comment-intro
4800Line 4 is assigned both @code{defun-block-intro} @emph{and} 4799Line 4 is assigned both @code{defun-block-intro} @emph{and}
4801@code{comment-intro} syntax. A syntactic element with 4800@code{comment-intro} syntax. A syntactic element with
4802@code{comment-intro} has no anchor point --- It is always accompanied 4801@code{comment-intro} has no anchor point. It is always accompanied
4803by another syntactic element which does have one. 4802by another syntactic element which does have one.
4804 4803
4805@item 4804@item
@@ -5283,15 +5282,15 @@ values that the special symbols correspond to:
5283@item + 5282@item +
5284@code{c-basic-offset} times 1 5283@code{c-basic-offset} times 1
5285@item - 5284@item -
5286@code{c-basic-offset} times -1 5285@code{c-basic-offset} times @minus{}1
5287@item ++ 5286@item ++
5288@code{c-basic-offset} times 2 5287@code{c-basic-offset} times 2
5289@item -- 5288@item --
5290@code{c-basic-offset} times -2 5289@code{c-basic-offset} times @minus{}2
5291@item * 5290@item *
5292@code{c-basic-offset} times 0.5 5291@code{c-basic-offset} times 0.5
5293@item / 5292@item /
5294@code{c-basic-offset} times -0.5 5293@code{c-basic-offset} times @minus{}0.5
5295@end table 5294@end table
5296 5295
5297@item A vector 5296@item A vector
@@ -5333,10 +5332,10 @@ Use the first offset that doesn't evaluate to @code{nil}. Subsequent
5333elements of the list don't get evaluated. 5332elements of the list don't get evaluated.
5334@item min 5333@item min
5335Use the minimum of all the offsets. All must be either relative or 5334Use the minimum of all the offsets. All must be either relative or
5336absolute - they can't be mixed. 5335absolute; they can't be mixed.
5337@item max 5336@item max
5338Use the maximum of all the offsets. All must be either relative or 5337Use the maximum of all the offsets. All must be either relative or
5339absolute - they can't be mixed. 5338absolute; they can't be mixed.
5340@item add 5339@item add
5341Add all the evaluated offsets together. Exactly one of them may be 5340Add all the evaluated offsets together. Exactly one of them may be
5342absolute, in which case the result is absolute. Any relative offsets 5341absolute, in which case the result is absolute. Any relative offsets
@@ -5494,7 +5493,7 @@ any problems writing custom line-up functions for AWK mode.
5494The calling convention for line-up functions is described fully in 5493The calling convention for line-up functions is described fully in
5495@ref{Custom Line-Up}. Roughly speaking, the return value is either an 5494@ref{Custom Line-Up}. Roughly speaking, the return value is either an
5496offset itself (such as @code{+} or @code{[0]}) or it's @code{nil}, 5495offset itself (such as @code{+} or @code{[0]}) or it's @code{nil},
5497meaning ``this function is inappropriate in this case - try a 5496meaning ``this function is inappropriate in this case; try a
5498different one''. @xref{c-offsets-alist}. 5497different one''. @xref{c-offsets-alist}.
5499 5498
5500The subsections below describe all the standard line-up functions, 5499The subsections below describe all the standard line-up functions,
@@ -6515,12 +6514,12 @@ your setup for this by using the access functions
6515@vindex c-syntactic-context 6514@vindex c-syntactic-context
6516@vindex syntactic-context (c-) 6515@vindex syntactic-context (c-)
6517Some syntactic symbols, e.g., @code{arglist-cont-nonempty}, have more 6516Some syntactic symbols, e.g., @code{arglist-cont-nonempty}, have more
6518info in the syntactic element - typically other positions that can be 6517info in the syntactic element: typically other positions that can be
6519interesting besides the anchor position. That info can't be accessed 6518interesting besides the anchor position. That info can't be accessed
6520through the passed argument, which is a cons cell. Instead, you can 6519through the passed argument, which is a cons cell. Instead, you can
6521get this information from the variable @code{c-syntactic-element}, 6520get this information from the variable @code{c-syntactic-element},
6522which is dynamically bound to the complete syntactic element. The 6521which is dynamically bound to the complete syntactic element. The
6523variable @code{c-syntactic-context} might also be useful - it gets 6522variable @code{c-syntactic-context} might also be useful: it gets
6524dynamically bound to the complete syntactic context. @xref{Custom 6523dynamically bound to the complete syntactic context. @xref{Custom
6525Braces}. 6524Braces}.
6526 6525
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index 725ac4269af..c3657415078 100644
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -6,7 +6,7 @@
6@copying 6@copying
7This file documents the GNU Emacs Common Lisp emulation package. 7This file documents the GNU Emacs Common Lisp emulation package.
8 8
9Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. 9Copyright @copyright{} 1993, 2001--2013 Free Software Foundation, Inc.
10 10
11@quotation 11@quotation
12Permission is granted to copy, distribute and/or modify this document 12Permission is granted to copy, distribute and/or modify this document
@@ -17,8 +17,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
17is included in the section entitled ``GNU Free Documentation License''. 17is included in the section entitled ``GNU Free Documentation License''.
18 18
19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
20modify this GNU manual. Buying copies from the FSF supports it in 20modify this GNU manual.''
21developing GNU and promoting software freedom.''
22@end quotation 21@end quotation
23@end copying 22@end copying
24 23
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index 1f9a401df90..c40a5e313f5 100644
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -9,7 +9,7 @@
9@syncodeindex fn cp 9@syncodeindex fn cp
10 10
11@copying 11@copying
12Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. 12Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
13 13
14@quotation 14@quotation
15Permission is granted to copy, distribute and/or modify this document 15Permission is granted to copy, distribute and/or modify this document
@@ -20,8 +20,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License''. 20is included in the section entitled ``GNU Free Documentation License''.
21 21
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 23modify this GNU manual.''
24developing GNU and promoting software freedom.''
25@end quotation 24@end quotation
26@end copying 25@end copying
27 26
diff --git a/doc/misc/dired-x.texi b/doc/misc/dired-x.texi
index cd1ad79eab5..2cf25641350 100644
--- a/doc/misc/dired-x.texi
+++ b/doc/misc/dired-x.texi
@@ -19,7 +19,7 @@
19@comment %**end of header (This is for running Texinfo on a region.) 19@comment %**end of header (This is for running Texinfo on a region.)
20 20
21@copying 21@copying
22Copyright @copyright{} 1994-1995, 1999, 2001-2012 22Copyright @copyright{} 1994--1995, 1999, 2001--2013
23Free Software Foundation, Inc. 23Free Software Foundation, Inc.
24 24
25@quotation 25@quotation
@@ -31,8 +31,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
31is included in the section entitled ``GNU Free Documentation License''. 31is included in the section entitled ``GNU Free Documentation License''.
32 32
33(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 33(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
34modify this GNU manual. Buying copies from the FSF supports it in 34modify this GNU manual.''
35developing GNU and promoting software freedom.''
36@end quotation 35@end quotation
37@end copying 36@end copying
38 37
diff --git a/doc/misc/ebrowse.texi b/doc/misc/ebrowse.texi
index e13ca4714a7..c7f3e3b1a61 100644
--- a/doc/misc/ebrowse.texi
+++ b/doc/misc/ebrowse.texi
@@ -10,7 +10,7 @@
10@copying 10@copying
11This file documents Ebrowse, a C++ class browser for GNU Emacs. 11This file documents Ebrowse, a C++ class browser for GNU Emacs.
12 12
13Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. 13Copyright @copyright{} 2000--2013 Free Software Foundation, Inc.
14 14
15@quotation 15@quotation
16Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -21,8 +21,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
21is included in the section entitled ``GNU Free Documentation License''. 21is included in the section entitled ``GNU Free Documentation License''.
22 22
23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
24modify this GNU manual. Buying copies from the FSF supports it in 24modify this GNU manual.''
25developing GNU and promoting software freedom.''
26@end quotation 25@end quotation
27@end copying 26@end copying
28 27
@@ -45,7 +44,7 @@ developing GNU and promoting software freedom.''
45@contents 44@contents
46 45
47@ifnottex 46@ifnottex
48@node Top, Overview, (dir), (dir) 47@node Top
49@top Ebrowse 48@top Ebrowse
50 49
51You can browse C++ class hierarchies from within Emacs by using 50You can browse C++ class hierarchies from within Emacs by using
@@ -68,7 +67,7 @@ Ebrowse.
68 67
69 68
70 69
71@node Overview, Generating browser files, Top, Top 70@node Overview
72@chapter Introduction 71@chapter Introduction
73 72
74When working in software projects using C++, I frequently missed 73When working in software projects using C++, I frequently missed
@@ -178,8 +177,7 @@ them, if you like.
178 177
179 178
180 179
181@node Generating browser files, Loading a Tree, Overview, Top 180@node Generating browser files
182@comment node-name, next, previous, up
183@chapter Processing Source Files 181@chapter Processing Source Files
184 182
185@cindex @command{ebrowse}, the program 183@cindex @command{ebrowse}, the program
@@ -226,7 +224,7 @@ available command line options.@refill
226 224
227 225
228@comment name, next, prev, up 226@comment name, next, prev, up
229@node Input files, Output file, Generating browser files, Generating browser files 227@node Input files
230@section Specifying Input Files 228@section Specifying Input Files
231 229
232@table @samp 230@table @samp
@@ -267,7 +265,7 @@ properly identifying friend functions of a class.
267 265
268 266
269@comment name, next, prev, up 267@comment name, next, prev, up
270@node Output file, Structs and unions, Input files, Generating browser files 268@node Output file
271@section Changing the Output File Name 269@section Changing the Output File Name
272 270
273@table @samp 271@table @samp
@@ -302,7 +300,7 @@ with this command line option.
302 300
303 301
304@comment name, next, prev, up 302@comment name, next, prev, up
305@node Structs and unions, Matching, Output file, Generating browser files 303@node Structs and unions
306@section Structs and Unions 304@section Structs and Unions
307@cindex structs 305@cindex structs
308@cindex unions 306@cindex unions
@@ -322,7 +320,7 @@ tree.
322 320
323 321
324@comment name, next, prev, up 322@comment name, next, prev, up
325@node Matching, Verbosity, Structs and unions, Generating browser files 323@node Matching
326@section Regular Expressions 324@section Regular Expressions
327 325
328@cindex regular expressions, recording 326@cindex regular expressions, recording
@@ -375,8 +373,7 @@ the probability that it will no longer match after editing the file.
375 373
376 374
377 375
378@node Verbosity, , Matching, Generating browser files 376@node Verbosity
379@comment node-name, next, previous, up
380@section Verbose Mode 377@section Verbose Mode
381@cindex verbose operation 378@cindex verbose operation
382 379
@@ -396,8 +393,7 @@ the names of the classes seen.
396 393
397 394
398 395
399@node Loading a Tree, Tree Buffers, Generating browser files, Top 396@node Loading a Tree
400@comment node-name, next, previous, up
401@chapter Starting to Browse 397@chapter Starting to Browse
402@cindex loading 398@cindex loading
403@cindex browsing 399@cindex browsing
@@ -437,8 +433,7 @@ where no highlight is displayed.
437@comment *** 433@comment ***
438@comment **************************************************************** 434@comment ****************************************************************
439 435
440@node Tree Buffers, Member Buffers, Loading a Tree, Top 436@node Tree Buffers
441@comment node-name, next, previous, up
442@chapter Tree Buffers 437@chapter Tree Buffers
443@cindex tree buffer mode 438@cindex tree buffer mode
444@cindex class trees 439@cindex class trees
@@ -469,8 +464,7 @@ buffers.
469 464
470 465
471 466
472@node Source Display, Member Display, Tree Buffers, Tree Buffers 467@node Source Display
473@comment node-name, next, previous, up
474@section Viewing and Finding Class Declarations 468@section Viewing and Finding Class Declarations
475@cindex viewing, class 469@cindex viewing, class
476@cindex finding a class 470@cindex finding a class
@@ -498,8 +492,7 @@ The same functionality is available from the menu opened with
498 492
499 493
500 494
501@node Member Display, Go to Class, Source Display, Tree Buffers 495@node Member Display
502@comment node-name, next, previous, up
503@section Displaying Members 496@section Displaying Members
504@cindex @samp{*Members*} buffer 497@cindex @samp{*Members*} buffer
505@cindex @samp{*Globals*} 498@cindex @samp{*Globals*}
@@ -562,8 +555,7 @@ These lists are also available from the class' context menu invoked with
562 555
563 556
564 557
565@node Go to Class, Quitting, Member Display, Tree Buffers 558@node Go to Class
566@comment node-name, next, previous, up
567@section Finding a Class 559@section Finding a Class
568@cindex locate class 560@cindex locate class
569@cindex expanding branches 561@cindex expanding branches
@@ -590,8 +582,7 @@ local copy of the regular expression last searched in it.
590 582
591 583
592 584
593@node Quitting, File Name Display, Go to Class, Tree Buffers 585@node Quitting
594@comment node-name, next, previous, up
595@section Burying a Tree Buffer 586@section Burying a Tree Buffer
596@cindex burying tree buffer 587@cindex burying tree buffer
597 588
@@ -603,8 +594,7 @@ Is a synonym for @kbd{M-x bury-buffer}.
603 594
604 595
605 596
606@node File Name Display, Expanding and Collapsing, Quitting, Tree Buffers 597@node File Name Display
607@comment node-name, next, previous, up
608@section Displaying File Names 598@section Displaying File Names
609 599
610@table @kbd 600@table @kbd
@@ -634,8 +624,7 @@ Here is an example of a tree buffer with file names displayed.
634@end example 624@end example
635 625
636 626
637@node Expanding and Collapsing, Tree Indentation, File Name Display, Tree Buffers 627@node Expanding and Collapsing
638@comment node-name, next, previous, up
639@section Expanding and Collapsing a Tree 628@section Expanding and Collapsing a Tree
640@cindex expand tree branch 629@cindex expand tree branch
641@cindex collapse tree branch 630@cindex collapse tree branch
@@ -674,8 +663,7 @@ This command expands all collapsed branches in the tree.
674 663
675 664
676 665
677@node Tree Indentation, Killing Classes, Expanding and Collapsing, Tree Buffers 666@node Tree Indentation
678@comment node-name, next, previous, up
679@section Changing the Tree Indentation 667@section Changing the Tree Indentation
680@cindex tree indentation 668@cindex tree indentation
681@cindex indentation of the tree 669@cindex indentation of the tree
@@ -690,8 +678,7 @@ available from the tree buffer's context menu.
690 678
691 679
692 680
693@node Killing Classes, Saving a Tree, Tree Indentation, Tree Buffers 681@node Killing Classes
694@comment node-name, next, previous, up
695@section Removing Classes from the Tree 682@section Removing Classes from the Tree
696@cindex killing classes 683@cindex killing classes
697@cindex class, remove from tree 684@cindex class, remove from tree
@@ -706,9 +693,7 @@ deletion is actually performed.
706 693
707 694
708 695
709@node Saving a Tree, Statistics, Killing Classes, Tree Buffers 696@node Saving a Tree
710@comment node-name, next, previous, up
711@comment node-name, next, previous, up
712@section Saving a Tree 697@section Saving a Tree
713@cindex save tree to a file 698@cindex save tree to a file
714@cindex tree, save to a file 699@cindex tree, save to a file
@@ -726,8 +711,8 @@ Writes the tree to a file whose name is read from the minibuffer.
726 711
727 712
728 713
729@node Statistics, Marking Classes, Saving a Tree, Tree Buffers 714@node Statistics
730@comment node-name, next, previous, up 715@section Statistics
731@cindex statistics for a tree 716@cindex statistics for a tree
732@cindex tree statistics 717@cindex tree statistics
733@cindex class statistics 718@cindex class statistics
@@ -742,8 +727,8 @@ context menu.
742 727
743 728
744 729
745@node Marking Classes, , Statistics, Tree Buffers 730@node Marking Classes
746@comment node-name, next, previous, up 731@section Marking Classes
747@cindex marking classes 732@cindex marking classes
748@cindex operations on marked classes 733@cindex operations on marked classes
749 734
@@ -784,8 +769,7 @@ display, like in the following example
784@c *** 769@c ***
785@c **************************************************************** 770@c ****************************************************************
786 771
787@node Member Buffers, Tags-like Functions, Tree Buffers, Top 772@node Member Buffers
788@comment node-name, next, previous, up
789@chapter Member Buffers 773@chapter Member Buffers
790@cindex members 774@cindex members
791@cindex member buffer mode 775@cindex member buffer mode
@@ -835,8 +819,7 @@ buffer: members, classes, and the buffer itself.
835 819
836 820
837 821
838@node Switching Member Lists, Finding/Viewing, Member Buffers, Member Buffers 822@node Switching Member Lists
839@comment node-name, next, previous, up
840@section Switching Member Lists 823@section Switching Member Lists
841@cindex member lists, in member buffers 824@cindex member lists, in member buffers
842@cindex static members 825@cindex static members
@@ -882,8 +865,7 @@ context menu.
882 865
883 866
884 867
885@node Finding/Viewing, Inherited Members, Switching Member Lists, Member Buffers 868@node Finding/Viewing
886@comment node-name, next, previous, up
887@section Finding and Viewing Member Source 869@section Finding and Viewing Member Source
888@cindex finding members, in member buffers 870@cindex finding members, in member buffers
889@cindex viewing members, in member buffers 871@cindex viewing members, in member buffers
@@ -920,8 +902,7 @@ displayed when clicking @kbd{Mouse-2} on a member name.
920 902
921 903
922 904
923@node Inherited Members, Searching Members, Finding/Viewing, Member Buffers 905@node Inherited Members
924@comment node-name, next, previous, up
925@section Display of Inherited Members 906@section Display of Inherited Members
926@cindex superclasses, members 907@cindex superclasses, members
927@cindex base classes, members 908@cindex base classes, members
@@ -936,8 +917,7 @@ buffer. This is also in the buffer's context menu.
936 917
937 918
938 919
939@node Searching Members, Switching to Tree, Inherited Members, Member Buffers 920@node Searching Members
940@comment node-name, next, previous, up
941@section Searching Members 921@section Searching Members
942@cindex searching members 922@cindex searching members
943 923
@@ -966,8 +946,7 @@ a mouse.
966 946
967 947
968 948
969@node Switching to Tree, Filters, Searching Members, Member Buffers 949@node Switching to Tree
970@comment node-name, next, previous, up
971@section Switching to Tree Buffer 950@section Switching to Tree Buffer
972@cindex tree buffer, switch to 951@cindex tree buffer, switch to
973@cindex buffer switching 952@cindex buffer switching
@@ -985,8 +964,7 @@ displayed in the member buffer.
985 964
986 965
987 966
988@node Filters, Attributes, Switching to Tree, Member Buffers 967@node Filters
989@comment node-name, next, previous, up
990@section Filters 968@section Filters
991@cindex filters 969@cindex filters
992 970
@@ -1030,8 +1008,7 @@ These commands are also found in the buffer's context menu.
1030 1008
1031 1009
1032 1010
1033@node Attributes, Long and Short Display, Filters, Member Buffers 1011@node Attributes
1034@comment node-name, next, previous, up
1035@section Displaying Member Attributes 1012@section Displaying Member Attributes
1036@cindex attributes 1013@cindex attributes
1037@cindex member attribute display 1014@cindex member attribute display
@@ -1087,8 +1064,7 @@ This command is also in the buffer's context menu.
1087 1064
1088 1065
1089 1066
1090@node Long and Short Display, Regexp Display, Attributes, Member Buffers 1067@node Long and Short Display
1091@comment node-name, next, previous, up
1092@section Long and Short Member Display 1068@section Long and Short Member Display
1093@cindex display form 1069@cindex display form
1094@cindex long display 1070@cindex long display
@@ -1122,8 +1098,7 @@ not been produced with the @command{ebrowse} option @samp{--no-regexps}.
1122 1098
1123 1099
1124 1100
1125@node Regexp Display, Switching Classes, Long and Short Display, Member Buffers 1101@node Regexp Display
1126@comment node-name, next, previous, up
1127@section Display of Regular Expressions 1102@section Display of Regular Expressions
1128@cindex regular expression display 1103@cindex regular expression display
1129 1104
@@ -1141,8 +1116,7 @@ see @ref{Matching, --no-regexps, Regular Expressions}.
1141 1116
1142 1117
1143 1118
1144@node Switching Classes, Killing/Burying, Regexp Display, Member Buffers 1119@node Switching Classes
1145@comment node-name, next, previous, up
1146@section Displaying Another Class 1120@section Displaying Another Class
1147@cindex base class, display 1121@cindex base class, display
1148@cindex derived class, display 1122@cindex derived class, display
@@ -1174,8 +1148,7 @@ Switch to the next sibling of the class in the class tree.
1174 1148
1175 1149
1176 1150
1177@node Killing/Burying, Column Width, Switching Classes, Member Buffers 1151@node Killing/Burying
1178@comment node-name, next, previous, up
1179@section Burying a Member Buffer 1152@section Burying a Member Buffer
1180@cindex burying member buffers 1153@cindex burying member buffers
1181 1154
@@ -1187,8 +1160,7 @@ This command is a synonym for @kbd{M-x bury-buffer}.
1187 1160
1188 1161
1189 1162
1190@node Column Width, Redisplay, Killing/Burying, Member Buffers 1163@node Column Width
1191@comment node-name, next, previous, up
1192@section Setting the Column Width 1164@section Setting the Column Width
1193@cindex column width 1165@cindex column width
1194@cindex member indentation 1166@cindex member indentation
@@ -1203,8 +1175,7 @@ This command sets the column width depending on the display form used
1203 1175
1204 1176
1205 1177
1206@node Redisplay, Getting Help, Column Width, Member Buffers 1178@node Redisplay
1207@comment node-name, next, previous, up
1208@section Forced Redisplay 1179@section Forced Redisplay
1209@cindex redisplay of member buffers 1180@cindex redisplay of member buffers
1210 1181
@@ -1219,8 +1190,8 @@ columns.
1219 1190
1220 1191
1221 1192
1222@node Getting Help, , Redisplay, Member Buffers 1193@node Getting Help
1223@comment node-name, next, previous, up 1194@section Getting Help
1224@cindex help 1195@cindex help
1225 1196
1226@table @kbd 1197@table @kbd
@@ -1235,8 +1206,7 @@ This key is bound to @code{describe-mode}.
1235@comment *** TAGS LIKE FUNCTIONS 1206@comment *** TAGS LIKE FUNCTIONS
1236@comment ************************************************************** 1207@comment **************************************************************
1237 1208
1238@node Tags-like Functions, GNU Free Documentation License, Member Buffers, Top 1209@node Tags-like Functions
1239@comment node-name, next, previous, up
1240@chapter Tags-like Functions 1210@chapter Tags-like Functions
1241 1211
1242Ebrowse provides tags functions similar to those of the standard 1212Ebrowse provides tags functions similar to those of the standard
@@ -1255,8 +1225,7 @@ Emacs Tags facility, but better suited to the needs of C++ programmers.
1255 1225
1256 1226
1257 1227
1258@node Finding and Viewing, Position Stack, Tags-like Functions, Tags-like Functions 1228@node Finding and Viewing
1259@comment node-name, next, previous, up
1260@section Finding and Viewing Members 1229@section Finding and Viewing Members
1261@cindex finding class member, in C++ source 1230@cindex finding class member, in C++ source
1262@cindex viewing class member, in C++ source 1231@cindex viewing class member, in C++ source
@@ -1315,8 +1284,7 @@ View a member's declaration in another frame.
1315 1284
1316 1285
1317 1286
1318@node Position Stack, Search & Replace, Finding and Viewing, Tags-like Functions 1287@node Position Stack
1319@comment node-name, next, previous, up
1320@section The Position Stack 1288@section The Position Stack
1321@cindex position stack 1289@cindex position stack
1322 1290
@@ -1352,8 +1320,7 @@ view a position with @kbd{v}.
1352 1320
1353 1321
1354 1322
1355@node Search & Replace, Members in Files, Position Stack, Tags-like Functions 1323@node Search & Replace
1356@comment node-name, next, previous, up
1357@section Searching and Replacing 1324@section Searching and Replacing
1358@cindex searching multiple C++ files 1325@cindex searching multiple C++ files
1359@cindex replacing in multiple C++ files 1326@cindex replacing in multiple C++ files
@@ -1390,8 +1357,7 @@ This restarts the last tags operation with the next file in the list.
1390 1357
1391 1358
1392 1359
1393@node Members in Files, Apropos, Search & Replace, Tags-like Functions 1360@node Members in Files
1394@comment node-name, next, previous, up
1395@section Members in Files 1361@section Members in Files
1396@cindex files 1362@cindex files
1397@cindex members in file, listing 1363@cindex members in file, listing
@@ -1404,8 +1370,7 @@ name is read from the minibuffer with completion.
1404 1370
1405 1371
1406 1372
1407@node Apropos, Symbol Completion, Members in Files, Tags-like Functions 1373@node Apropos
1408@comment node-name, next, previous, up
1409@section Member Apropos 1374@section Member Apropos
1410@cindex apropos on class members 1375@cindex apropos on class members
1411@cindex members, matching regexp 1376@cindex members, matching regexp
@@ -1422,8 +1387,7 @@ command @kbd{C-c C-m f}, for example, to jump to a specific member.
1422 1387
1423 1388
1424 1389
1425@node Symbol Completion, Member Buffer Display, Apropos, Tags-like Functions 1390@node Symbol Completion
1426@comment node-name, next, previous, up
1427@section Symbol Completion 1391@section Symbol Completion
1428@cindex completion 1392@cindex completion
1429@cindex symbol completion 1393@cindex symbol completion
@@ -1433,7 +1397,7 @@ The command @kbd{C-c C-m @key{TAB}} completes the symbol in front of point.
1433 1397
1434 1398
1435 1399
1436@node Member Buffer Display, , Symbol Completion, Tags-like Functions 1400@node Member Buffer Display
1437@section Quick Member Display 1401@section Quick Member Display
1438@cindex member buffer, for member at point 1402@cindex member buffer, for member at point
1439 1403
@@ -1441,12 +1405,12 @@ You can quickly display a member buffer containing the member the cursor
1441in on with the command @kbd{C-c C-m m}. 1405in on with the command @kbd{C-c C-m m}.
1442 1406
1443 1407
1444@node GNU Free Documentation License, Concept Index, Tags-like Functions, Top 1408@node GNU Free Documentation License
1445@appendix GNU Free Documentation License 1409@appendix GNU Free Documentation License
1446@include doclicense.texi 1410@include doclicense.texi
1447 1411
1448 1412
1449@node Concept Index, , GNU Free Documentation License, Top 1413@node Concept Index
1450@unnumbered Concept Index 1414@unnumbered Concept Index
1451@printindex cp 1415@printindex cp
1452 1416
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index 34ec72fc193..cadd815025c 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -5,7 +5,8 @@
5@copying 5@copying
6This file describes EDE, the Emacs Development Environment. 6This file describes EDE, the Emacs Development Environment.
7 7
8Copyright @copyright{} 1998-2001, 2004-2005, 2008-2012 Free Software Foundation, Inc. 8Copyright @copyright{} 1998--2001, 2004--2005, 2008--2013
9Free Software Foundation, Inc.
9 10
10@quotation 11@quotation
11Permission is granted to copy, distribute and/or modify this document 12Permission is granted to copy, distribute and/or modify this document
@@ -16,8 +17,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
16is included in the section entitled ``GNU Free Documentation License.'' 17is included in the section entitled ``GNU Free Documentation License.''
17 18
18(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
19modify this GNU manual. Buying copies from the FSF supports it in 20modify this GNU manual.''
20developing GNU and promoting software freedom.''
21@end quotation 21@end quotation
22@end copying 22@end copying
23 23
@@ -63,7 +63,7 @@ developing GNU and promoting software freedom.''
63 63
64@contents 64@contents
65 65
66@node top, EDE Project Concepts, (dir), (dir) 66@node Top, EDE Project Concepts, (dir), (dir)
67@top EDE 67@top EDE
68@comment node-name, next, previous, up 68@comment node-name, next, previous, up
69 69
@@ -88,9 +88,10 @@ learn and adopt GNU ways of doing things.
88* Building and Debugging:: Initiating a build or debug session. 88* Building and Debugging:: Initiating a build or debug session.
89* Miscellaneous commands:: Other project related commands. 89* Miscellaneous commands:: Other project related commands.
90* Extending EDE:: Programming and extending @ede{}. 90* Extending EDE:: Programming and extending @ede{}.
91* GNU Free Documentation License:: The license for this documentation.
91@end menu 92@end menu
92 93
93@node EDE Project Concepts, EDE Mode, top, top 94@node EDE Project Concepts, EDE Mode, Top, Top
94@chapter @ede{} Project Concepts 95@chapter @ede{} Project Concepts
95 96
96@ede{} is a generic interface for managing projects. It specifies a 97@ede{} is a generic interface for managing projects. It specifies a
@@ -125,7 +126,7 @@ of search to files in a single target, or to discover the location of
125documentation or interface files. @ede{} can provide this 126documentation or interface files. @ede{} can provide this
126information. 127information.
127 128
128@node EDE Mode, Quick Start, EDE Project Concepts, top 129@node EDE Mode, Quick Start, EDE Project Concepts, Top
129@chapter @ede{} Mode 130@chapter @ede{} Mode
130 131
131@ede{} is implemented as a minor mode, which augments other modes such 132@ede{} is implemented as a minor mode, which augments other modes such
@@ -142,7 +143,7 @@ bar. This menu provides several menu items for high-level @ede{}
142commands. These menu items, and their corresponding keybindings, are 143commands. These menu items, and their corresponding keybindings, are
143independent of the type of project you are actually working on. 144independent of the type of project you are actually working on.
144 145
145@node Quick Start, Creating a project, EDE Mode, top 146@node Quick Start, Creating a project, EDE Mode, Top
146@chapter Quick Start 147@chapter Quick Start
147 148
148Once you have @ede{} enabled, you can create a project. This chapter 149Once you have @ede{} enabled, you can create a project. This chapter
@@ -438,7 +439,7 @@ C-c . R RET RET
438If your program takes command line arguments, you can type them in 439If your program takes command line arguments, you can type them in
439when it offers the command line you want to use to run your program. 440when it offers the command line you want to use to run your program.
440 441
441@node Creating a project, Modifying your project, Quick Start, top 442@node Creating a project, Modifying your project, Quick Start, Top
442@chapter Creating a project 443@chapter Creating a project
443 444
444To create a new project, first visit a file that you want to include 445To create a new project, first visit a file that you want to include
@@ -496,7 +497,7 @@ the top-most project's makefile as a starting place for the build. How
496the toplevel project handles subprojects in the build process is 497the toplevel project handles subprojects in the build process is
497dependent on that project's type. 498dependent on that project's type.
498 499
499@node Modifying your project, Building and Debugging, Creating a project, top 500@node Modifying your project, Building and Debugging, Creating a project, Top
500@chapter Modifying your project 501@chapter Modifying your project
501 502
502In this chapter, we describe the generic features for manipulating 503In this chapter, we describe the generic features for manipulating
@@ -677,7 +678,7 @@ block for ``configurations''. Add a new named configuration here.
677To switch between different active configurations, modify the 678To switch between different active configurations, modify the
678``configuration default'' slot. 679``configuration default'' slot.
679 680
680@node Building and Debugging, Miscellaneous commands, Modifying your project, top 681@node Building and Debugging, Miscellaneous commands, Modifying your project, Top
681@chapter Building and Debugging 682@chapter Building and Debugging
682 683
683@ede{} provides the following ``project-aware'' compilation and 684@ede{} provides the following ``project-aware'' compilation and
@@ -696,7 +697,7 @@ Build a distribution file for your project.
696 697
697These commands are also available from the @samp{Development} menu. 698These commands are also available from the @samp{Development} menu.
698 699
699@node Miscellaneous commands, Extending EDE, Building and Debugging, top 700@node Miscellaneous commands, Extending EDE, Building and Debugging, Top
700@chapter Miscellaneous commands 701@chapter Miscellaneous commands
701 702
702If you opt to go in and edit @ede{} project files directly---for 703If you opt to go in and edit @ede{} project files directly---for
@@ -1092,7 +1093,7 @@ You can add your own locate tool but subclassing from
1092methods. See the code in @file{ede-locate.el} for GNU Global as a 1093methods. See the code in @file{ede-locate.el} for GNU Global as a
1093simple example. 1094simple example.
1094 1095
1095@node Extending EDE, , Miscellaneous commands, top 1096@node Extending EDE, GNU Free Documentation License, Miscellaneous commands, Top
1096@chapter Extending @ede{} 1097@chapter Extending @ede{}
1097 1098
1098This chapter is intended for users who want to write new parts or fix 1099This chapter is intended for users who want to write new parts or fix
@@ -1109,7 +1110,7 @@ superclasses. In this way, specific behaviors such as how a project
1109is saved, or how a target is compiled can be customized by a project 1110is saved, or how a target is compiled can be customized by a project
1110author in detail. @ede{} communicates to these project objects via an 1111author in detail. @ede{} communicates to these project objects via an
1111API using methods. The commands you use in @ede{} mode are high-level 1112API using methods. The commands you use in @ede{} mode are high-level
1112functional wrappers over these methods. @xref{(eieio)Top}. For 1113functional wrappers over these methods. @xref{Top,,, eieio, EIEIO manual}. For
1113details on using @eieio{} to extending classes, and writing methods. 1114details on using @eieio{} to extending classes, and writing methods.
1114 1115
1115If you intend to extend @ede{}, it is most likely that a new target type is 1116If you intend to extend @ede{}, it is most likely that a new target type is
@@ -1360,7 +1361,8 @@ association when a file is loaded. It is generally unnecessary to
1360override this unless you keep auxiliary files. 1361override this unless you keep auxiliary files.
1361@end table 1362@end table
1362 1363
1363These methods are used by the semantic package extensions @xref{(semantic)Top}. 1364These methods are used by the semantic package extensions.
1365@xref{Top,,, semantic, Semantic manual}.
1364 1366
1365@table @code 1367@table @code
1366@item ede-buffer-header-file 1368@item ede-buffer-header-file
@@ -4436,4 +4438,8 @@ For example, C code uses .o on unix, and Emacs Lisp uses .elc.
4436@end table 4438@end table
4437@end table 4439@end table
4438 4440
4441@node GNU Free Documentation License, , Extending EDE, Top
4442@appendix GNU Free Documentation License
4443@include doclicense.texi
4444
4439@bye 4445@bye
diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi
index 55bfb9f6cb8..1e4c888a9e7 100644
--- a/doc/misc/ediff.texi
+++ b/doc/misc/ediff.texi
@@ -25,7 +25,7 @@
25This file documents Ediff, a comprehensive visual interface to Unix diff 25This file documents Ediff, a comprehensive visual interface to Unix diff
26and patch utilities. 26and patch utilities.
27 27
28Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. 28Copyright @copyright{} 1995--2013 Free Software Foundation, Inc.
29 29
30@quotation 30@quotation
31Permission is granted to copy, distribute and/or modify this document 31Permission is granted to copy, distribute and/or modify this document
@@ -36,8 +36,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
36is included in the section entitled ``GNU Free Documentation License''. 36is included in the section entitled ``GNU Free Documentation License''.
37 37
38(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 38(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
39modify this GNU manual. Buying copies from the FSF supports it in 39modify this GNU manual.''
40developing GNU and promoting software freedom.''
41@end quotation 40@end quotation
42@end copying 41@end copying
43 42
@@ -62,7 +61,7 @@ developing GNU and promoting software freedom.''
62 61
63@contents 62@contents
64 63
65@node Top, Introduction, (dir), (dir) 64@node Top
66@top Ediff 65@top Ediff
67 66
68@insertcopying 67@insertcopying
@@ -80,7 +79,7 @@ developing GNU and promoting software freedom.''
80* Index:: 79* Index::
81@end menu 80@end menu
82 81
83@node Introduction, Major Entry Points, Top, Top 82@node Introduction
84@chapter Introduction 83@chapter Introduction
85 84
86@cindex Comparing files and buffers 85@cindex Comparing files and buffers
@@ -128,7 +127,7 @@ functions are adaptations from Emerge. Although Ediff subsumes and greatly
128extends Emerge, much of the functionality in Ediff is influenced by Emerge. 127extends Emerge, much of the functionality in Ediff is influenced by Emerge.
129The architecture and the interface are, of course, drastically different. 128The architecture and the interface are, of course, drastically different.
130 129
131@node Major Entry Points, Session Commands, Introduction, Top 130@node Major Entry Points
132@chapter Major Entry Points 131@chapter Major Entry Points
133 132
134When Ediff starts up, it displays a small control window, which accepts the 133When Ediff starts up, it displays a small control window, which accepts the
@@ -398,7 +397,7 @@ Moreover, the functions @code{ediff-directory-revisions},
398related Ediff sessions by taking a directory and comparing (or merging) 397related Ediff sessions by taking a directory and comparing (or merging)
399versions of files in that directory. 398versions of files in that directory.
400 399
401@node Session Commands, Registry of Ediff Sessions, Major Entry Points, Top 400@node Session Commands
402@chapter Session Commands 401@chapter Session Commands
403 402
404All Ediff commands are displayed in a Quick Help window, unless you type 403All Ediff commands are displayed in a Quick Help window, unless you type
@@ -431,7 +430,7 @@ command (see @kbd{ga}, @kbd{gb}, and @kbd{gc}).
431* Other Session Commands:: Commands that are not bound to keys. 430* Other Session Commands:: Commands that are not bound to keys.
432@end menu 431@end menu
433 432
434@node Quick Help Commands,Other Session Commands,,Session Commands 433@node Quick Help Commands
435@section Quick Help Commands 434@section Quick Help Commands
436@cindex command help 435@cindex command help
437@cindex important commands 436@cindex important commands
@@ -557,8 +556,8 @@ Makes the next difference region current.
557Makes the very first difference region current. 556Makes the very first difference region current.
558 557
559@kbd{-j} makes the last region current. Typing a number, N, and then `j' 558@kbd{-j} makes the last region current. Typing a number, N, and then `j'
560makes the difference region N current. Typing -N (a negative number) then 559makes the difference region N current. Typing @minus{}N (a negative number) then
561`j' makes current the region Last - N. 560`j' makes current the region Last @minus{} N.
562 561
563@item ga 562@item ga
564@kindex ga 563@kindex ga
@@ -912,7 +911,7 @@ merge buffer and then select regions in those buffers.
912 911
913@end table 912@end table
914 913
915@node Other Session Commands,,Quick Help Commands,Session Commands 914@node Other Session Commands
916@section Other Session Commands 915@section Other Session Commands
917 916
918The following commands can be invoked from within any Ediff session, 917The following commands can be invoked from within any Ediff session,
@@ -955,7 +954,7 @@ difference.
955@vindex ediff-use-toolbar-p 954@vindex ediff-use-toolbar-p
956The use of the toolbar can also be specified via the variable 955The use of the toolbar can also be specified via the variable
957@code{ediff-use-toolbar-p} (default is @code{t}). This variable can be set 956@code{ediff-use-toolbar-p} (default is @code{t}). This variable can be set
958only in @file{.emacs} --- do @strong{not} change it interactively. Use the 957only in @file{.emacs}: do @strong{not} change it interactively. Use the
959function @code{ediff-toggle-use-toolbar} instead. 958function @code{ediff-toggle-use-toolbar} instead.
960 959
961@item ediff-revert-buffers-then-recompute-diffs 960@item ediff-revert-buffers-then-recompute-diffs
@@ -978,7 +977,7 @@ making it run faster. The function @code{ediff-profile} toggles
978profiling of ediff commands. 977profiling of ediff commands.
979@end table 978@end table
980 979
981@node Registry of Ediff Sessions, Session Groups, Session Commands, Top 980@node Registry of Ediff Sessions
982@chapter Registry of Ediff Sessions 981@chapter Registry of Ediff Sessions
983 982
984Ediff maintains a registry of all its invocations that are 983Ediff maintains a registry of all its invocations that are
@@ -1009,7 +1008,7 @@ and @kbd{DEL} (previous registry record). There are other commands as well,
1009but you don't need to memorize them, since they are listed at the top of 1008but you don't need to memorize them, since they are listed at the top of
1010the registry buffer. 1009the registry buffer.
1011 1010
1012@node Session Groups, Remote and Compressed Files, Registry of Ediff Sessions, Top 1011@node Session Groups
1013@chapter Session Groups 1012@chapter Session Groups
1014 1013
1015Several major entries of Ediff perform comparison and merging on 1014Several major entries of Ediff perform comparison and merging on
@@ -1128,7 +1127,7 @@ user whether or not to do a recursive descent.
1128 1127
1129 1128
1130 1129
1131@node Remote and Compressed Files, Customization, Session Groups, Top 1130@node Remote and Compressed Files
1132@chapter Remote and Compressed Files 1131@chapter Remote and Compressed Files
1133 1132
1134Ediff works with remote, compressed, and encrypted files. Ediff 1133Ediff works with remote, compressed, and encrypted files. Ediff
@@ -1151,7 +1150,7 @@ i.e., the original is renamed into @file{source-name.orig} and the result
1151of the patch is placed into the file source-name (@file{_orig} is used 1150of the patch is placed into the file source-name (@file{_orig} is used
1152on systems like DOS, etc.) 1151on systems like DOS, etc.)
1153 1152
1154@node Customization, Credits, Remote and Compressed Files, Top 1153@node Customization
1155@chapter Customization 1154@chapter Customization
1156 1155
1157Ediff has a rather self-explanatory interface, and in most cases you 1156Ediff has a rather self-explanatory interface, and in most cases you
@@ -1187,7 +1186,7 @@ refer to Emacs manual for the information on how to set Emacs X resources.
1187* Notes on Heavy-duty Customization:: Customization for the gurus. 1186* Notes on Heavy-duty Customization:: Customization for the gurus.
1188@end menu 1187@end menu
1189 1188
1190@node Hooks, Quick Help Customization, Customization, Customization 1189@node Hooks
1191@section Hooks 1190@section Hooks
1192 1191
1193The bulk of customization can be done via the following hooks: 1192The bulk of customization can be done via the following hooks:
@@ -1327,13 +1326,13 @@ Hooks run just before exiting a session group.
1327@item ediff-meta-buffer-keymap-setup-hook 1326@item ediff-meta-buffer-keymap-setup-hook
1328@vindex ediff-meta-buffer-keymap-setup-hook 1327@vindex ediff-meta-buffer-keymap-setup-hook
1329@vindex ediff-meta-buffer-map 1328@vindex ediff-meta-buffer-map
1330Hooks run just after setting up the @code{ediff-meta-buffer-map} --- the 1329Hooks run just after setting up the @code{ediff-meta-buffer-map}, the
1331map that controls key bindings in the meta buffer. Since 1330map that controls key bindings in the meta buffer. Since
1332@code{ediff-meta-buffer-map} is a local variable, you can set different 1331@code{ediff-meta-buffer-map} is a local variable, you can set different
1333bindings for different kinds of meta buffers. 1332bindings for different kinds of meta buffers.
1334@end table 1333@end table
1335 1334
1336@node Quick Help Customization, Window and Frame Configuration, Hooks, Customization 1335@node Quick Help Customization
1337@section Quick Help Customization 1336@section Quick Help Customization
1338@vindex ediff-use-long-help-message 1337@vindex ediff-use-long-help-message
1339@vindex ediff-control-buffer 1338@vindex ediff-control-buffer
@@ -1357,7 +1356,7 @@ basis, you must use @code{ediff-startup-hook} to change the value of
1357the variable @code{ediff-help-message}, which is local to 1356the variable @code{ediff-help-message}, which is local to
1358@code{ediff-control-buffer}. 1357@code{ediff-control-buffer}.
1359 1358
1360@node Window and Frame Configuration, Selective Browsing, Quick Help Customization, Customization 1359@node Window and Frame Configuration
1361@section Window and Frame Configuration 1360@section Window and Frame Configuration
1362 1361
1363On a non-windowing display, Ediff sets things up in one frame, splitting 1362On a non-windowing display, Ediff sets things up in one frame, splitting
@@ -1494,7 +1493,7 @@ can switch between sessions by suspending one session and then switching
1494to another control panel. (Different control panel buffers are 1493to another control panel. (Different control panel buffers are
1495distinguished by a numerical suffix, e.g., @samp{Ediff Control Panel<3>}.) 1494distinguished by a numerical suffix, e.g., @samp{Ediff Control Panel<3>}.)
1496 1495
1497@node Selective Browsing, Highlighting Difference Regions, Window and Frame Configuration, Customization 1496@node Selective Browsing
1498@section Selective Browsing 1497@section Selective Browsing
1499 1498
1500Sometimes it is convenient to be able to step through only some difference 1499Sometimes it is convenient to be able to step through only some difference
@@ -1609,7 +1608,7 @@ ignoring letter case or not. It can be set in @file{.emacs} using
1609When case sensitivity is toggled, all difference 1608When case sensitivity is toggled, all difference
1610regions are recomputed. 1609regions are recomputed.
1611 1610
1612@node Highlighting Difference Regions, Narrowing, Selective Browsing, Customization 1611@node Highlighting Difference Regions
1613@section Highlighting Difference Regions 1612@section Highlighting Difference Regions
1614 1613
1615The following variables control the way Ediff highlights difference 1614The following variables control the way Ediff highlights difference
@@ -1736,7 +1735,7 @@ faces, you can modify them when Ediff is being loaded using
1736or @code{set/make-face-@dots{}} as shown above. Emacs's low-level 1735or @code{set/make-face-@dots{}} as shown above. Emacs's low-level
1737face-manipulation functions should be avoided. 1736face-manipulation functions should be avoided.
1738 1737
1739@node Narrowing, Refinement of Difference Regions, Highlighting Difference Regions, Customization 1738@node Narrowing
1740@section Narrowing 1739@section Narrowing
1741 1740
1742If buffers being compared are narrowed at the time of invocation of 1741If buffers being compared are narrowed at the time of invocation of
@@ -1768,7 +1767,7 @@ Controls whether on quitting Ediff should restore the accessible range
1768that existed before the current invocation. 1767that existed before the current invocation.
1769@end table 1768@end table
1770 1769
1771@node Refinement of Difference Regions, Patch and Diff Programs, Narrowing, Customization 1770@node Refinement of Difference Regions
1772@section Refinement of Difference Regions 1771@section Refinement of Difference Regions
1773 1772
1774Ediff has variables to control the way fine differences are 1773Ediff has variables to control the way fine differences are
@@ -1840,7 +1839,7 @@ command @kbd{@@}. Repeated typing of this key cycles through three
1840different states: auto-refining, no-auto-refining, and no-highlighting 1839different states: auto-refining, no-auto-refining, and no-highlighting
1841of fine differences. 1840of fine differences.
1842 1841
1843@node Patch and Diff Programs, Merging and diff3, Refinement of Difference Regions, Customization 1842@node Patch and Diff Programs
1844@section Patch and Diff Programs 1843@section Patch and Diff Programs
1845 1844
1846This section describes variables that specify the programs to be used for 1845This section describes variables that specify the programs to be used for
@@ -1949,7 +1948,7 @@ Specifies the default directory to look for patches.
1949@code{diff}. Instead, make sure you are using some implementation of POSIX 1948@code{diff}. Instead, make sure you are using some implementation of POSIX
1950@code{diff}, such as @code{gnudiff}. 1949@code{diff}, such as @code{gnudiff}.
1951 1950
1952@node Merging and diff3, Support for Version Control, Patch and Diff Programs, Customization 1951@node Merging and diff3
1953@section Merging and diff3 1952@section Merging and diff3
1954 1953
1955Ediff supports three-way comparison via the functions @code{ediff-files3} and 1954Ediff supports three-way comparison via the functions @code{ediff-files3} and
@@ -2153,7 +2152,7 @@ When merge buffers are saved automatically as directed by
2153specified by the variable @code{ediff-merge-filename-prefix}. The default 2152specified by the variable @code{ediff-merge-filename-prefix}. The default
2154is @code{merge_}, but this can be changed by the user. 2153is @code{merge_}, but this can be changed by the user.
2155 2154
2156@node Support for Version Control, Customizing the Mode Line, Merging and diff3, Customization 2155@node Support for Version Control
2157@section Support for Version Control 2156@section Support for Version Control
2158 2157
2159 2158
@@ -2198,7 +2197,7 @@ In case of @file{pcl-cvs.el}, Ediff can also be invoked via the function
2198@code{run-ediff-from-cvs-buffer}---see the documentation string for this 2197@code{run-ediff-from-cvs-buffer}---see the documentation string for this
2199function. 2198function.
2200 2199
2201@node Customizing the Mode Line, Miscellaneous, Support for Version Control, Customization 2200@node Customizing the Mode Line
2202@section Customizing the Mode Line 2201@section Customizing the Mode Line
2203 2202
2204When Ediff is running, the mode line of @samp{Ediff Control Panel} 2203When Ediff is running, the mode line of @samp{Ediff Control Panel}
@@ -2217,7 +2216,7 @@ don't like the way Ediff changes the mode line, you can use
2217@pindex @file{uniquify.el} 2216@pindex @file{uniquify.el}
2218@pindex @file{mode-line.el} 2217@pindex @file{mode-line.el}
2219 2218
2220@node Miscellaneous, Notes on Heavy-duty Customization, Customizing the Mode Line, Customization 2219@node Miscellaneous
2221@section Miscellaneous 2220@section Miscellaneous
2222 2221
2223Here are a few other variables for customizing Ediff: 2222Here are a few other variables for customizing Ediff:
@@ -2334,7 +2333,7 @@ Try different settings and see which one is for you.
2334@end table 2333@end table
2335 2334
2336 2335
2337@node Notes on Heavy-duty Customization, , Miscellaneous, Customization 2336@node Notes on Heavy-duty Customization
2338@section Notes on Heavy-duty Customization 2337@section Notes on Heavy-duty Customization
2339 2338
2340Some users need to customize Ediff in rather sophisticated ways, which 2339Some users need to customize Ediff in rather sophisticated ways, which
@@ -2403,7 +2402,7 @@ non-@code{nil} only if Ediff uses the multiframe display, i.e., when
2403the control buffer is in its own frame. 2402the control buffer is in its own frame.
2404@end table 2403@end table
2405 2404
2406@node Credits, GNU Free Documentation License, Customization, Top 2405@node Credits
2407@chapter Credits 2406@chapter Credits
2408 2407
2409Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired 2408Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired
@@ -2521,12 +2520,12 @@ Ilya Zakharevich (ilya at math.ohio-state.edu),
2521Eli Zaretskii (eliz at is.elta.co.il) 2520Eli Zaretskii (eliz at is.elta.co.il)
2522@end example 2521@end example
2523 2522
2524@node GNU Free Documentation License, Index, Credits, Top 2523@node GNU Free Documentation License
2525@appendix GNU Free Documentation License 2524@appendix GNU Free Documentation License
2526@include doclicense.texi 2525@include doclicense.texi
2527 2526
2528 2527
2529@node Index, , GNU Free Documentation License, Top 2528@node Index
2530@unnumbered Index 2529@unnumbered Index
2531@printindex cp 2530@printindex cp
2532 2531
diff --git a/doc/misc/edt.texi b/doc/misc/edt.texi
index 12e65100e4e..339d59bd123 100644
--- a/doc/misc/edt.texi
+++ b/doc/misc/edt.texi
@@ -5,7 +5,7 @@
5@copying 5@copying
6This file documents the EDT emulation package for Emacs. 6This file documents the EDT emulation package for Emacs.
7 7
8Copyright @copyright{} 1986, 1992, 1994-1995, 1999-2012 8Copyright @copyright{} 1986, 1992, 1994--1995, 1999--2013
9Free Software Foundation, Inc. 9Free Software Foundation, Inc.
10 10
11@quotation 11@quotation
@@ -17,8 +17,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
17is included in the section entitled ``GNU Free Documentation License''. 17is included in the section entitled ``GNU Free Documentation License''.
18 18
19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
20modify this GNU manual. Buying copies from the FSF supports it in 20modify this GNU manual.''
21developing GNU and promoting software freedom.''
22@end quotation 21@end quotation
23@end copying 22@end copying
24 23
@@ -103,25 +102,25 @@ how to customize it to your liking.
103@itemize 102@itemize
104 103
105@item 104@item
106@file{edt.texi} - This manual. 105@file{edt.texi}---This manual.
107 106
108@item 107@item
109@file{edt-user.el} - An example customization file. 108@file{edt-user.el}---An example customization file.
110 109
111@item 110@item
112@file{edt.el} - EDT emulation functions and default configuration. 111@file{edt.el}---EDT emulation functions and default configuration.
113 112
114@item 113@item
115@file{edt-lk201.el} - Built-in support for DEC LK-201 keyboards. 114@file{edt-lk201.el}---Built-in support for DEC LK-201 keyboards.
116 115
117@item 116@item
118@file{edt-vt100.el} - Built-in support for DEC VT-100 (and above) terminals. 117@file{edt-vt100.el}---Built-in support for DEC VT-100 (and above) terminals.
119 118
120@item 119@item
121@file{edt-pc.el} - Built-in support for PC 101 Keyboards under MS-DOS. 120@file{edt-pc.el}---Built-in support for PC 101 Keyboards under MS-DOS.
122 121
123@item 122@item
124@file{edt-mapper.el} - Create an EDT LK-201 map file for keyboards 123@file{edt-mapper.el}---Create an EDT LK-201 map file for keyboards
125without built-in support. 124without built-in support.
126 125
127@end itemize 126@end itemize
diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi
index fc92a76ff36..b16144e98a2 100644
--- a/doc/misc/eieio.texi
+++ b/doc/misc/eieio.texi
@@ -11,7 +11,7 @@
11@copying 11@copying
12This manual documents EIEIO, an object framework for Emacs Lisp. 12This manual documents EIEIO, an object framework for Emacs Lisp.
13 13
14Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License.'' 22is included in the section entitled ``GNU Free Documentation License.''
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
@@ -77,6 +76,7 @@ Emacs.
77* Naming Conventions:: Name your objects in an Emacs friendly way. 76* Naming Conventions:: Name your objects in an Emacs friendly way.
78* CLOS compatibility:: What are the differences? 77* CLOS compatibility:: What are the differences?
79* Wish List:: Things about EIEIO that could be improved. 78* Wish List:: Things about EIEIO that could be improved.
79* GNU Free Documentation License:: The license for this documentation.
80* Function Index:: 80* Function Index::
81@end menu 81@end menu
82 82
@@ -446,7 +446,7 @@ that default value with @code{oset-default}. @ref{Accessing Slots}.
446 446
447@item :type 447@item :type
448An unquoted type specifier used to validate data set into this slot. 448An unquoted type specifier used to validate data set into this slot.
449@xref{(cl)Type Predicates}. 449@xref{Type Predicates,,,cl,Common Lisp Extensions}.
450Here are some examples: 450Here are some examples:
451 @table @code 451 @table @code
452 @item symbol 452 @item symbol
@@ -1571,7 +1571,7 @@ all these classes, subsection headings, and indexes.
1571 1571
1572Each class will be indexed using the texinfo labeled index 1572Each class will be indexed using the texinfo labeled index
1573@var{indexstring} which is a two letter description. 1573@var{indexstring} which is a two letter description.
1574@xref{(texinfo) New Indices}. 1574@xref{New Indices,,,texinfo,Texinfo manual}.
1575 1575
1576To use this command, the texinfo macro 1576To use this command, the texinfo macro
1577 1577
@@ -1874,8 +1874,9 @@ instead pre-builds a method that gets the slot's value.
1874 1874
1875@item :type 1875@item :type
1876Specifier uses the @code{typep} function from the @file{cl} 1876Specifier uses the @code{typep} function from the @file{cl}
1877package. @xref{(cl)Type Predicates}. It therefore has the same issues as 1877package. @xref{Type Predicates,,,cl,Common Lisp Extensions}.
1878that package. Extensions include the ability to provide object names. 1878It therefore has the same issues as that package. Extensions include
1879the ability to provide object names.
1879@end table 1880@end table
1880 1881
1881Defclass also supports class options, but does not currently use values 1882Defclass also supports class options, but does not currently use values
@@ -1950,6 +1951,10 @@ buffers.
1950Allow method overloading of method-like functions in Emacs. 1951Allow method overloading of method-like functions in Emacs.
1951@end enumerate 1952@end enumerate
1952 1953
1954@node GNU Free Documentation License
1955@appendix GNU Free Documentation License
1956@include doclicense.texi
1957
1953@node Function Index 1958@node Function Index
1954@unnumbered Function Index 1959@unnumbered Function Index
1955 1960
diff --git a/doc/misc/emacs-gnutls.texi b/doc/misc/emacs-gnutls.texi
index 12e65c9e8dd..740dfee41ed 100644
--- a/doc/misc/emacs-gnutls.texi
+++ b/doc/misc/emacs-gnutls.texi
@@ -1,14 +1,14 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2 2
3@set VERSION 0.3
4
3@setfilename ../../info/emacs-gnutls 5@setfilename ../../info/emacs-gnutls
4@settitle Emacs GnuTLS Integration @value{VERSION} 6@settitle Emacs GnuTLS Integration @value{VERSION}
5 7
6@set VERSION 0.3
7
8@copying 8@copying
9This file describes the Emacs GnuTLS integration. 9This file describes the Emacs GnuTLS integration.
10 10
11Copyright @copyright{} 2012 Free Software Foundation, Inc. 11Copyright @copyright{} 2012--2013 Free Software Foundation, Inc.
12 12
13@quotation 13@quotation
14Permission is granted to copy, distribute and/or modify this document 14Permission is granted to copy, distribute and/or modify this document
@@ -16,17 +16,10 @@ under the terms of the GNU Free Documentation License, Version 1.3 or
16any later version published by the Free Software Foundation; with no 16any later version published by the Free Software Foundation; with no
17Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 17Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
18and with the Back-Cover Texts as in (a) below. A copy of the license 18and with the Back-Cover Texts as in (a) below. A copy of the license
19is included in the section entitled ``GNU Free Documentation License'' 19is included in the section entitled ``GNU Free Documentation License''.
20in the Emacs manual.
21 20
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 22modify this GNU manual.''
24developing GNU and promoting software freedom.''
25
26This document is part of a collection distributed under the GNU Free
27Documentation License. If you want to distribute this document
28separately from the collection, you can do so by adding a copy of the
29license to the document, as described in section 6 of the license.
30@end quotation 23@end quotation
31@end copying 24@end copying
32 25
@@ -61,6 +54,7 @@ Emacs Lisp library.
61* Overview:: Overview of the GnuTLS integration. 54* Overview:: Overview of the GnuTLS integration.
62* Help For Users:: 55* Help For Users::
63* Help For Developers:: 56* Help For Developers::
57* GNU Free Documentation License:: The license for this documentation.
64* Function Index:: 58* Function Index::
65* Variable Index:: 59* Variable Index::
66@end menu 60@end menu
@@ -185,12 +179,16 @@ Please see @file{gnutls.el} for the @var{spec} details and for usage,
185but do not rely on this function's interface if possible. 179but do not rely on this function's interface if possible.
186@end defun 180@end defun
187 181
182@node GNU Free Documentation License
183@appendix GNU Free Documentation License
184@include doclicense.texi
185
188@node Function Index 186@node Function Index
189@chapter Function Index 187@unnumbered Function Index
190@printindex fn 188@printindex fn
191 189
192@node Variable Index 190@node Variable Index
193@chapter Variable Index 191@unnumbered Variable Index
194@printindex vr 192@printindex vr
195 193
196@bye 194@bye
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index 966cace7f6e..216e4733cd1 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -11,7 +11,7 @@
11@copying 11@copying
12This file documents the Emacs MIME interface functionality. 12This file documents the Emacs MIME interface functionality.
13 13
14Copyright @copyright{} 1998-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 1998--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License''. 22is included in the section entitled ``GNU Free Documentation License''.
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
@@ -1856,7 +1855,7 @@ Conformance Criteria and Examples
1856Languages, and Continuations 1855Languages, and Continuations
1857 1856
1858@item RFC1843 1857@item RFC1843
1859HZ - A Data Format for Exchanging Files of Arbitrarily Mixed Chinese and 1858HZ---A Data Format for Exchanging Files of Arbitrarily Mixed Chinese and
1860@acronym{ASCII} characters 1859@acronym{ASCII} characters
1861 1860
1862@item draft-ietf-drums-msg-fmt-05.txt 1861@item draft-ietf-drums-msg-fmt-05.txt
diff --git a/doc/misc/epa.texi b/doc/misc/epa.texi
index 9dfdf5ff0c3..e21851ef37a 100644
--- a/doc/misc/epa.texi
+++ b/doc/misc/epa.texi
@@ -9,7 +9,7 @@
9@copying 9@copying
10This file describes EasyPG Assistant @value{VERSION}. 10This file describes EasyPG Assistant @value{VERSION}.
11 11
12Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. 12Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
13 13
14@quotation 14@quotation
15Permission is granted to copy, distribute and/or modify this document 15Permission is granted to copy, distribute and/or modify this document
@@ -17,17 +17,10 @@ under the terms of the GNU Free Documentation License, Version 1.3 or
17any later version published by the Free Software Foundation; with no 17any later version published by the Free Software Foundation; with no
18Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 18Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
19and with the Back-Cover Texts as in (a) below. A copy of the license 19and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License'' 20is included in the section entitled ``GNU Free Documentation License''.
21in the Emacs manual.
22 21
23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
24modify this GNU manual. Buying copies from the FSF supports it in 23modify this GNU manual.''
25developing GNU and promoting software freedom.''
26
27This document is part of a collection distributed under the GNU Free
28Documentation License. If you want to distribute this document
29separately from the collection, you can do so by adding a copy of the
30license to the document, as described in section 6 of the license.
31@end quotation 24@end quotation
32@end copying 25@end copying
33 26
@@ -68,6 +61,7 @@ called EasyPG Library.
68* Commands:: 61* Commands::
69* Caching Passphrases:: 62* Caching Passphrases::
70* Bug Reports:: 63* Bug Reports::
64* GNU Free Documentation License:: The license for this documentation.
71@end menu 65@end menu
72 66
73@node Overview 67@node Overview
@@ -493,6 +487,10 @@ Before reporting the bug, you should set @code{epg-debug} in the
493of the @samp{ *epg-debug*} buffer. Note that the first letter of the 487of the @samp{ *epg-debug*} buffer. Note that the first letter of the
494buffer name is a whitespace. 488buffer name is a whitespace.
495 489
490@node GNU Free Documentation License
491@appendix GNU Free Documentation License
492@include doclicense.texi
493
496@bye 494@bye
497 495
498@c End: 496@c End:
diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 8c8e0b56cd0..cc61cd1ab5b 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -9,7 +9,7 @@
9@copying 9@copying
10This manual is for ERC as distributed with Emacs @value{EMACSVER}. 10This manual is for ERC as distributed with Emacs @value{EMACSVER}.
11 11
12Copyright @copyright{} 2005-2012 Free Software Foundation, Inc. 12Copyright @copyright{} 2005--2013 Free Software Foundation, Inc.
13 13
14@quotation 14@quotation
15Permission is granted to copy, distribute and/or modify this document 15Permission is granted to copy, distribute and/or modify this document
@@ -20,8 +20,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License''. 20is included in the section entitled ``GNU Free Documentation License''.
21 21
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 23modify this GNU manual.''
24developing GNU and promoting software freedom.''
25 24
26All Emacs Lisp code contained in this document may be used, distributed, 25All Emacs Lisp code contained in this document may be used, distributed,
27and modified without restriction. 26and modified without restriction.
@@ -62,10 +61,6 @@ and modified without restriction.
62* Advanced Usage:: Cool ways of using ERC. 61* Advanced Usage:: Cool ways of using ERC.
63* Getting Help and Reporting Bugs:: 62* Getting Help and Reporting Bugs::
64* History:: The history of ERC. 63* History:: The history of ERC.
65* Copying:: The GNU General Public License gives you
66 permission to redistribute ERC on
67 certain terms; it also explains that
68 there is no warranty.
69* GNU Free Documentation License:: The license for this documentation. 64* GNU Free Documentation License:: The license for this documentation.
70* Concept Index:: Search for terms. 65* Concept Index:: Search for terms.
71 66
@@ -855,10 +850,6 @@ is maintained as part of Emacs.
855 850
856@end itemize 851@end itemize
857 852
858@node Copying
859@appendix GNU GENERAL PUBLIC LICENSE
860@include gpl.texi
861
862@node GNU Free Documentation License 853@node GNU Free Documentation License
863@appendix GNU Free Documentation License 854@appendix GNU Free Documentation License
864@include doclicense.texi 855@include doclicense.texi
diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi
index 146a6ccbc35..8728d53ea27 100644
--- a/doc/misc/ert.texi
+++ b/doc/misc/ert.texi
@@ -10,7 +10,7 @@
10@end direntry 10@end direntry
11 11
12@copying 12@copying
13Copyright @copyright{} 2008, 2010-2012 Free Software Foundation, Inc. 13Copyright @copyright{} 2008, 2010--2013 Free Software Foundation, Inc.
14 14
15@quotation 15@quotation
16Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -18,21 +18,14 @@ under the terms of the GNU Free Documentation License, Version 1.3 or
18any later version published by the Free Software Foundation; with no 18any later version published by the Free Software Foundation; with no
19Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 19Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
20and with the Back-Cover Texts as in (a) below. A copy of the license 20and with the Back-Cover Texts as in (a) below. A copy of the license
21is included in the section entitled ``GNU Free Documentation License'' 21is included in the section entitled ``GNU Free Documentation License''.
22in the Emacs manual.
23 22
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 24modify this GNU manual.''
26developing GNU and promoting software freedom.''
27
28This document is part of a collection distributed under the GNU Free
29Documentation License. If you want to distribute this document
30separately from the collection, you can do so by adding a copy of the
31license to the document, as described in section 6 of the license.
32@end quotation 25@end quotation
33@end copying 26@end copying
34 27
35@node Top, Introduction, (dir), (dir) 28@node Top
36@top ERT: Emacs Lisp Regression Testing 29@top ERT: Emacs Lisp Regression Testing
37 30
38ERT is a tool for automated testing in Emacs Lisp. Its main features 31ERT is a tool for automated testing in Emacs Lisp. Its main features
@@ -53,6 +46,7 @@ traditional software development methods.
53* How to Debug Tests:: What to do if a test fails. 46* How to Debug Tests:: What to do if a test fails.
54* Extending ERT:: ERT is extensible in several ways. 47* Extending ERT:: ERT is extensible in several ways.
55* Other Testing Concepts:: Features not in ERT. 48* Other Testing Concepts:: Features not in ERT.
49* GNU Free Documentation License:: The license for this documentation.
56 50
57@detailmenu 51@detailmenu
58 --- The Detailed Node Listing --- 52 --- The Detailed Node Listing ---
@@ -85,15 +79,19 @@ Other Testing Concepts
85* Mocks and Stubs:: Stubbing out code that is irrelevant to the test. 79* Mocks and Stubs:: Stubbing out code that is irrelevant to the test.
86* Fixtures and Test Suites:: How ERT differs from tools for other languages. 80* Fixtures and Test Suites:: How ERT differs from tools for other languages.
87 81
82Appendix
83
84* GNU Free Documentation License:: The license for this documentation.
85
88@end detailmenu 86@end detailmenu
89@end menu 87@end menu
90 88
91@node Introduction, How to Run Tests, Top, Top 89@node Introduction
92@chapter Introduction 90@chapter Introduction
93 91
94ERT allows you to define @emph{tests} in addition to functions, 92ERT allows you to define @emph{tests} in addition to functions,
95macros, variables, and the other usual Lisp constructs. Tests are 93macros, variables, and the other usual Lisp constructs. Tests are
96simply Lisp code --- code that invokes other code and checks whether 94simply Lisp code: code that invokes other code and checks whether
97it behaves as expected. 95it behaves as expected.
98 96
99ERT keeps track of the tests that are defined and provides convenient 97ERT keeps track of the tests that are defined and provides convenient
@@ -134,8 +132,8 @@ will pass if the three calls to @code{equal} all return true
134better error reporting. @xref{The @code{should} Macro}. 132better error reporting. @xref{The @code{should} Macro}.
135 133
136Each test should have a name that describes what functionality it tests. 134Each test should have a name that describes what functionality it tests.
137Test names can be chosen arbitrarily --- they are in a 135Test names can be chosen arbitrarily---they are in a
138namespace separate from functions and variables --- but should follow 136namespace separate from functions and variables---but should follow
139the usual Emacs Lisp convention of having a prefix that indicates 137the usual Emacs Lisp convention of having a prefix that indicates
140which package they belong to. Test names are displayed by ERT when 138which package they belong to. Test names are displayed by ERT when
141reporting failures and can be used when selecting which tests to run. 139reporting failures and can be used when selecting which tests to run.
@@ -156,7 +154,7 @@ test. Tests should clean up even if they fail. @xref{Tests and Their
156Environment}. 154Environment}.
157 155
158 156
159@node How to Run Tests, How to Write Tests, Introduction, Top 157@node How to Run Tests
160@chapter How to Run Tests 158@chapter How to Run Tests
161 159
162You can run tests either in the Emacs you are working in, or on the 160You can run tests either in the Emacs you are working in, or on the
@@ -174,7 +172,7 @@ different Emacs versions.
174@end menu 172@end menu
175 173
176 174
177@node Running Tests Interactively, Running Tests in Batch Mode, How to Run Tests, How to Run Tests 175@node Running Tests Interactively
178@section Running Tests Interactively 176@section Running Tests Interactively
179 177
180You can run the tests that are currently defined in your Emacs with 178You can run the tests that are currently defined in your Emacs with
@@ -253,7 +251,7 @@ while point is on a test failure will increase the limits to show more
253of the expression. 251of the expression.
254 252
255 253
256@node Running Tests in Batch Mode, Test Selectors, Running Tests Interactively, How to Run Tests 254@node Running Tests in Batch Mode
257@section Running Tests in Batch Mode 255@section Running Tests in Batch Mode
258 256
259ERT supports automated invocations from the command line or from 257ERT supports automated invocations from the command line or from
@@ -277,7 +275,7 @@ additional @code{-L} flags to ensure that @code{my-tests.el} and all the
277files that it requires are on your @code{load-path}. 275files that it requires are on your @code{load-path}.
278 276
279 277
280@node Test Selectors, , Running Tests in Batch Mode, How to Run Tests 278@node Test Selectors
281@section Test Selectors 279@section Test Selectors
282 280
283Functions like @code{ert} accept a @emph{test selector}, a Lisp 281Functions like @code{ert} accept a @emph{test selector}, a Lisp
@@ -316,7 +314,7 @@ result in the last run, and tag-based selectors such as @code{(not
316@code{:causes-redisplay}. 314@code{:causes-redisplay}.
317 315
318 316
319@node How to Write Tests, How to Debug Tests, How to Run Tests, Top 317@node How to Write Tests
320@chapter How to Write Tests 318@chapter How to Write Tests
321 319
322ERT lets you define tests in the same way you define functions. You 320ERT lets you define tests in the same way you define functions. You
@@ -336,7 +334,7 @@ to find where a test was defined if the test was loaded from a file.
336* Useful Techniques:: Some examples. 334* Useful Techniques:: Some examples.
337@end menu 335@end menu
338 336
339@node The @code{should} Macro, Expected Failures, How to Write Tests, How to Write Tests 337@node The @code{should} Macro
340@section The @code{should} Macro 338@section The @code{should} Macro
341 339
342Test bodies can include arbitrary code; but to be useful, they need to 340Test bodies can include arbitrary code; but to be useful, they need to
@@ -400,7 +398,7 @@ default.
400@code{should} reports. 398@code{should} reports.
401 399
402 400
403@node Expected Failures, Tests and Their Environment, The @code{should} Macro, How to Write Tests 401@node Expected Failures
404@section Expected Failures 402@section Expected Failures
405 403
406Some bugs are complicated to fix, or not very important, and are left as 404Some bugs are complicated to fix, or not very important, and are left as
@@ -453,7 +451,7 @@ versions, specific architectures, etc.:
453@end lisp 451@end lisp
454 452
455 453
456@node Tests and Their Environment, Useful Techniques, Expected Failures, How to Write Tests 454@node Tests and Their Environment
457@section Tests and Their Environment 455@section Tests and Their Environment
458 456
459The outcome of running a test should not depend on the current state 457The outcome of running a test should not depend on the current state
@@ -504,11 +502,11 @@ buffer if one is already visiting the requested file; and it runs
504Instead, it is better to use lower-level mechanisms with simple and 502Instead, it is better to use lower-level mechanisms with simple and
505predictable semantics like @code{with-temp-buffer}, @code{insert} or 503predictable semantics like @code{with-temp-buffer}, @code{insert} or
506@code{insert-file-contents-literally}, and to activate any desired mode 504@code{insert-file-contents-literally}, and to activate any desired mode
507by calling the corresponding function directly --- after binding the 505by calling the corresponding function directly, after binding the
508hook variables to nil. This avoids the above problems. 506hook variables to nil. This avoids the above problems.
509 507
510 508
511@node Useful Techniques, , Tests and Their Environment, How to Write Tests 509@node Useful Techniques
512@section Useful Techniques when Writing Tests 510@section Useful Techniques when Writing Tests
513 511
514Testing simple functions that have no side effects and no dependencies 512Testing simple functions that have no side effects and no dependencies
@@ -561,9 +559,9 @@ could be used instead.
561The reason why this test only checks the first line of the backtrace 559The reason why this test only checks the first line of the backtrace
562is that the remainder of the backtrace is dependent on ERT's internals 560is that the remainder of the backtrace is dependent on ERT's internals
563as well as whether the code is running interpreted or compiled. By 561as well as whether the code is running interpreted or compiled. By
564looking only at the first line, the test checks a useful property 562looking only at the first line, the test checks a useful property---that
565--- that the backtrace correctly captures the call to @code{signal} that 563the backtrace correctly captures the call to @code{signal} that
566results from the call to @code{ert-fail} --- without being brittle. 564results from the call to @code{ert-fail}---without being brittle.
567 565
568This example also shows that writing tests is much easier if the code 566This example also shows that writing tests is much easier if the code
569under test was structured with testing in mind. 567under test was structured with testing in mind.
@@ -589,7 +587,7 @@ for testing. Usually, this makes the interfaces easier to use as
589well. 587well.
590 588
591 589
592@node How to Debug Tests, Extending ERT, How to Write Tests, Top 590@node How to Debug Tests
593@chapter How to Debug Tests 591@chapter How to Debug Tests
594 592
595This section describes how to use ERT's features to understand why 593This section describes how to use ERT's features to understand why
@@ -602,7 +600,7 @@ a test failed.
602@end menu 600@end menu
603 601
604 602
605@node Understanding Explanations, Interactive Debugging, How to Debug Tests, How to Debug Tests 603@node Understanding Explanations
606@section Understanding Explanations 604@section Understanding Explanations
607 605
608Failed @code{should} forms are reported like this: 606Failed @code{should} forms are reported like this:
@@ -669,7 +667,7 @@ ERT only provides explanations for predicates that have an explanation
669function registered. @xref{Defining Explanation Functions}. 667function registered. @xref{Defining Explanation Functions}.
670 668
671 669
672@node Interactive Debugging, , Understanding Explanations, How to Debug Tests 670@node Interactive Debugging
673@section Interactive Debugging 671@section Interactive Debugging
674 672
675Debugging failed tests essentially works the same way as debugging any 673Debugging failed tests essentially works the same way as debugging any
@@ -701,12 +699,12 @@ strips them out, so it is more convenient.
701failed. This can be useful to figure out how far it got. 699failed. This can be useful to figure out how far it got.
702 700
703@item You can instrument tests for debugging the same way you instrument 701@item You can instrument tests for debugging the same way you instrument
704@code{defun}s for debugging --- go to the source code of the test and 702@code{defun}s for debugging: go to the source code of the test and
705type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and 703type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and
706re-run the test with @kbd{r} or @kbd{d}. 704re-run the test with @kbd{r} or @kbd{d}.
707 705
708@item If you have been editing and rearranging tests, it is possible that 706@item If you have been editing and rearranging tests, it is possible that
709ERT remembers an old test that you have since renamed or removed --- 707ERT remembers an old test that you have since renamed or removed:
710renamings or removals of definitions in the source code leave around a 708renamings or removals of definitions in the source code leave around a
711stray definition under the old name in the running process (this is a 709stray definition under the old name in the running process (this is a
712common problem in Lisp). In such a situation, hit @kbd{D} to let ERT 710common problem in Lisp). In such a situation, hit @kbd{D} to let ERT
@@ -714,7 +712,7 @@ forget about the obsolete test.
714@end itemize 712@end itemize
715 713
716 714
717@node Extending ERT, Other Testing Concepts, How to Debug Tests, Top 715@node Extending ERT
718@chapter Extending ERT 716@chapter Extending ERT
719 717
720There are several ways to add functionality to ERT. 718There are several ways to add functionality to ERT.
@@ -725,7 +723,7 @@ There are several ways to add functionality to ERT.
725@end menu 723@end menu
726 724
727 725
728@node Defining Explanation Functions, Low-Level Functions for Working with Tests, Extending ERT, Extending ERT 726@node Defining Explanation Functions
729@section Defining Explanation Functions 727@section Defining Explanation Functions
730 728
731The explanation function for a predicate is a function that takes the 729The explanation function for a predicate is a function that takes the
@@ -743,7 +741,7 @@ The value of the property should be the symbol that names the
743explanation function. 741explanation function.
744 742
745 743
746@node Low-Level Functions for Working with Tests, , Defining Explanation Functions, Extending ERT 744@node Low-Level Functions for Working with Tests
747@section Low-Level Functions for Working with Tests 745@section Low-Level Functions for Working with Tests
748 746
749Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} 747Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch}
@@ -759,7 +757,7 @@ meant to be usable by other code. But there is no mature API yet.
759Contributions to ERT are welcome. 757Contributions to ERT are welcome.
760 758
761 759
762@node Other Testing Concepts, , Extending ERT, Top 760@node Other Testing Concepts
763@chapter Other Testing Concepts 761@chapter Other Testing Concepts
764 762
765For information on mocks, stubs, fixtures, or test suites, see below. 763For information on mocks, stubs, fixtures, or test suites, see below.
@@ -770,7 +768,7 @@ For information on mocks, stubs, fixtures, or test suites, see below.
770* Fixtures and Test Suites:: How ERT differs from tools for other languages. 768* Fixtures and Test Suites:: How ERT differs from tools for other languages.
771@end menu 769@end menu
772 770
773@node Mocks and Stubs, Fixtures and Test Suites, Other Testing Concepts, Other Testing Concepts 771@node Mocks and Stubs
774@section Other Tools for Emacs Lisp 772@section Other Tools for Emacs Lisp
775 773
776Stubbing out functions or using so-called @emph{mocks} can make it 774Stubbing out functions or using so-called @emph{mocks} can make it
@@ -783,7 +781,7 @@ ERT does not have built-in support for mocks or stubs. The package
783offers mocks for Emacs Lisp and can be used in conjunction with ERT. 781offers mocks for Emacs Lisp and can be used in conjunction with ERT.
784 782
785 783
786@node Fixtures and Test Suites, , Mocks and Stubs, Other Testing Concepts 784@node Fixtures and Test Suites
787@section Fixtures and Test Suites 785@section Fixtures and Test Suites
788 786
789In many ways, ERT is similar to frameworks for other languages like 787In many ways, ERT is similar to frameworks for other languages like
@@ -842,6 +840,10 @@ e.g., to run quick tests during interactive development and slow tests less
842often. This can be achieved with the @code{:tag} argument to 840often. This can be achieved with the @code{:tag} argument to
843@code{ert-deftest} and @code{tag} test selectors. 841@code{ert-deftest} and @code{tag} test selectors.
844 842
843@node GNU Free Documentation License
844@appendix GNU Free Documentation License
845@include doclicense.texi
846
845@bye 847@bye
846 848
847@c LocalWords: ERT JUnit namespace docstring ERT's 849@c LocalWords: ERT JUnit namespace docstring ERT's
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 81bc1edc169..504940c5c6b 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -8,7 +8,7 @@
8@copying 8@copying
9This manual is for Eshell, the Emacs shell. 9This manual is for Eshell, the Emacs shell.
10 10
11Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. 11Copyright @copyright{} 1999--2013 Free Software Foundation, Inc.
12 12
13@quotation 13@quotation
14Permission is granted to copy, distribute and/or modify this document 14Permission is granted to copy, distribute and/or modify this document
@@ -19,8 +19,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
19is included in the section entitled ``GNU Free Documentation License''. 19is included in the section entitled ``GNU Free Documentation License''.
20 20
21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
22modify this GNU manual. Buying copies from the FSF supports it in 22modify this GNU manual.''
23developing GNU and promoting software freedom.''
24@end quotation 23@end quotation
25@end copying 24@end copying
26 25
@@ -33,9 +32,9 @@ developing GNU and promoting software freedom.''
33@sp 4 32@sp 4
34@c The title is printed in a large font. 33@c The title is printed in a large font.
35@center @titlefont{User's Guide} 34@center @titlefont{User's Guide}
36@sp 35@sp 1
37@center @titlefont{to} 36@center @titlefont{to}
38@sp 37@sp 1
39@center @titlefont{Eshell: The Emacs Shell} 38@center @titlefont{Eshell: The Emacs Shell}
40@ignore 39@ignore
41@sp 2 40@sp 2
@@ -58,7 +57,7 @@ developing GNU and promoting software freedom.''
58@c ================================================================ 57@c ================================================================
59 58
60@ifnottex 59@ifnottex
61@node Top, What is Eshell?, (dir), (dir) 60@node Top
62@top Eshell 61@top Eshell
63 62
64Eshell is a shell-like command interpreter 63Eshell is a shell-like command interpreter
diff --git a/doc/misc/eudc.texi b/doc/misc/eudc.texi
index a21e73019b9..5b06cc7f11a 100644
--- a/doc/misc/eudc.texi
+++ b/doc/misc/eudc.texi
@@ -12,7 +12,7 @@ EUDC is the Emacs Unified Directory Client, a common interface to
12directory servers using various protocols such as LDAP or the CCSO white 12directory servers using various protocols such as LDAP or the CCSO white
13pages directory system (PH/QI) 13pages directory system (PH/QI)
14 14
15Copyright @copyright{} 1998, 2000-2012 Free Software Foundation, Inc. 15Copyright @copyright{} 1998, 2000--2013 Free Software Foundation, Inc.
16 16
17@quotation 17@quotation
18Permission is granted to copy, distribute and/or modify this document 18Permission is granted to copy, distribute and/or modify this document
@@ -23,8 +23,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
23is included in the section entitled ``GNU Free Documentation License''. 23is included in the section entitled ``GNU Free Documentation License''.
24 24
25(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 25(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
26modify this GNU manual. Buying copies from the FSF supports it in 26modify this GNU manual.''
27developing GNU and promoting software freedom.''
28@end quotation 27@end quotation
29@end copying 28@end copying
30 29
@@ -36,8 +35,8 @@ developing GNU and promoting software freedom.''
36@footnotestyle end 35@footnotestyle end
37 36
38@titlepage 37@titlepage
39@title{EUDC Manual} 38@title EUDC Manual
40@subtitle{The Emacs Unified Directory Client} 39@subtitle The Emacs Unified Directory Client
41@author by Oscar Figueiredo 40@author by Oscar Figueiredo
42@code{1.30b} 41@code{1.30b}
43 42
@@ -49,9 +48,8 @@ developing GNU and promoting software freedom.''
49@contents 48@contents
50 49
51@ifnottex 50@ifnottex
52@node Top, Overview, (dir), (dir) 51@node Top
53@top Emacs Unified Directory Client 52@top Emacs Unified Directory Client
54@comment node-name, next, previous, up
55 53
56@insertcopying 54@insertcopying
57@end ifnottex 55@end ifnottex
@@ -70,8 +68,7 @@ developing GNU and promoting software freedom.''
70 68
71 69
72 70
73@node Overview, Installation, Top, Top 71@node Overview
74@comment node-name, next, previous, up
75@chapter Overview 72@chapter Overview
76 73
77EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user 74EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user
@@ -116,8 +113,7 @@ Interface to BBDB to let you insert server records into your own BBDB database
116 113
117 114
118 115
119@node LDAP, CCSO PH/QI, Overview, Overview 116@node LDAP
120@comment node-name, next, previous, up
121@section LDAP 117@section LDAP
122 118
123LDAP, @dfn{the Lightweight Directory Access Protocol}, is a communication 119LDAP, @dfn{the Lightweight Directory Access Protocol}, is a communication
@@ -143,8 +139,7 @@ EUDC requires external support to access LDAP directory servers
143(@pxref{LDAP Requirements}) 139(@pxref{LDAP Requirements})
144 140
145 141
146@node CCSO PH/QI, BBDB, LDAP, Overview 142@node CCSO PH/QI
147@comment node-name, next, previous, up
148@section CCSO PH/QI 143@section CCSO PH/QI
149 144
150The Central Computing Services Office (CCSO) of the University of 145The Central Computing Services Office (CCSO) of the University of
@@ -165,8 +160,7 @@ possible to change records in the database. This is not implemented in
165EUDC. 160EUDC.
166 161
167 162
168@node BBDB, , CCSO PH/QI, Overview 163@node BBDB
169@comment node-name, next, previous, up
170@section BBDB 164@section BBDB
171 165
172BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs 166BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs
@@ -188,8 +182,7 @@ performing queries on multiple servers.
188EUDC also offers a means to insert results from directory queries into 182EUDC also offers a means to insert results from directory queries into
189your own local BBDB (@pxref{Creating BBDB Records}) 183your own local BBDB (@pxref{Creating BBDB Records})
190 184
191@node Installation, Usage, Overview, Top 185@node Installation
192@comment node-name, next, previous, up
193@chapter Installation 186@chapter Installation
194 187
195Add the following to your @file{.emacs} init file: 188Add the following to your @file{.emacs} init file:
@@ -219,8 +212,7 @@ email composition buffers (@pxref{Inline Query Expansion})
219* LDAP Requirements:: EUDC needs external support for LDAP 212* LDAP Requirements:: EUDC needs external support for LDAP
220@end menu 213@end menu
221 214
222@node LDAP Requirements, , Installation, Installation 215@node LDAP Requirements
223@comment node-name, next, previous, up
224@section LDAP Requirements 216@section LDAP Requirements
225 217
226LDAP support is added by means of @file{ldap.el}, which is part of Emacs. 218LDAP support is added by means of @file{ldap.el}, which is part of Emacs.
@@ -229,8 +221,7 @@ LDAP support is added by means of @file{ldap.el}, which is part of Emacs.
229(@url{http://www.openldap.org/}). 221(@url{http://www.openldap.org/}).
230 222
231 223
232@node Usage, Credits, Installation, Top 224@node Usage
233@comment node-name, next, previous, up
234@chapter Usage 225@chapter Usage
235 226
236This chapter describes the usage of EUDC@. Most functions and 227This chapter describes the usage of EUDC@. Most functions and
@@ -249,8 +240,7 @@ submenu of the @samp{Tools} submenu.
249@end menu 240@end menu
250 241
251 242
252@node Querying Servers, Query Form, Usage, Usage 243@node Querying Servers
253@comment node-name, next, previous, up
254@section Querying Servers 244@section Querying Servers
255 245
256EUDC's basic functionality is to let you query a directory server and 246EUDC's basic functionality is to let you query a directory server and
@@ -264,7 +254,7 @@ to customize in this process.
264* Duplicate Attributes:: What to do when records have duplicate attributes 254* Duplicate Attributes:: What to do when records have duplicate attributes
265@end menu 255@end menu
266 256
267@node Selecting a Server, Return Attributes, Querying Servers, Querying Servers 257@node Selecting a Server
268@subsection Selecting a Server 258@subsection Selecting a Server
269 259
270Before doing any query you will need to set the directory server. You 260Before doing any query you will need to set the directory server. You
@@ -303,7 +293,7 @@ This command accessible from @samp{New Server} submenu lets you specify a
303new directory server and protocol. 293new directory server and protocol.
304@end deffn 294@end deffn
305 295
306@node Return Attributes, Duplicate Attributes, Selecting a Server, Querying Servers 296@node Return Attributes
307@subsection Return Attributes 297@subsection Return Attributes
308 298
309Directory servers may be configured to return a default set of 299Directory servers may be configured to return a default set of
@@ -327,7 +317,7 @@ If non-@code{nil}, entries that do not contain all the requested return
327attributes are ignored. Default is @code{t}. 317attributes are ignored. Default is @code{t}.
328@end defopt 318@end defopt
329 319
330@node Duplicate Attributes, , Return Attributes, Querying Servers 320@node Duplicate Attributes
331@subsection Duplicate Attributes 321@subsection Duplicate Attributes
332 322
333Directory standards may authorize different instances of the same 323Directory standards may authorize different instances of the same
@@ -382,8 +372,7 @@ to all attribute names. Available methods are: @code{list},
382 372
383 373
384 374
385@node Query Form, Display of Query Results, Querying Servers, Usage 375@node Query Form
386@comment node-name, next, previous, up
387@section Query Form 376@section Query Form
388 377
389The simplest way to query your directory server is to use the query 378The simplest way to query your directory server is to use the query
@@ -437,8 +426,7 @@ Otherwise, directory query/response forms display the user attribute
437names defined in @code{eudc-user-attribute-names-alist}. 426names defined in @code{eudc-user-attribute-names-alist}.
438@end defvar 427@end defvar
439 428
440@node Display of Query Results, Inline Query Expansion, Query Form, Usage 429@node Display of Query Results
441@comment node-name, next, previous, up
442@section Display of Query Results 430@section Display of Query Results
443 431
444Upon successful completion of a form query, EUDC will display a buffer 432Upon successful completion of a form query, EUDC will display a buffer
@@ -515,8 +503,7 @@ be passed to the program.
515@end defvar 503@end defvar
516 504
517 505
518@node Inline Query Expansion, The Server Hotlist, Display of Query Results, Usage 506@node Inline Query Expansion
519@comment node-name, next, previous, up
520@section Inline Query Expansion 507@section Inline Query Expansion
521 508
522Inline query expansion is a powerful method to get completion from your 509Inline query expansion is a powerful method to get completion from your
@@ -616,8 +603,7 @@ Default is @code{select}
616 603
617 604
618 605
619@node The Server Hotlist, Multi-server Queries, Inline Query Expansion, Usage 606@node The Server Hotlist
620@comment node-name, next, previous, up
621@section The Server Hotlist 607@section The Server Hotlist
622 608
623EUDC lets you maintain a list of frequently used servers so that you 609EUDC lets you maintain a list of frequently used servers so that you
@@ -655,8 +641,7 @@ loaded.
655* The Hotlist Edit Buffer:: An interactive hotlist editing facility 641* The Hotlist Edit Buffer:: An interactive hotlist editing facility
656@end menu 642@end menu
657 643
658@node The Hotlist Edit Buffer, , The Server Hotlist, The Server Hotlist 644@node The Hotlist Edit Buffer
659@comment node-name, next, previous, up
660@subsection The Hotlist Edit Buffer 645@subsection The Hotlist Edit Buffer
661 646
662The hotlist edit buffer offers a means to manage a list of frequently 647The hotlist edit buffer offers a means to manage a list of frequently
@@ -692,8 +677,7 @@ Save the changes and quit the hotlist edit buffer. Use @kbd{x} or
692@end deffn 677@end deffn
693 678
694 679
695@node Multi-server Queries, Creating BBDB Records, The Server Hotlist, Usage 680@node Multi-server Queries
696@comment node-name, next, previous, up
697@section Multi-server Queries 681@section Multi-server Queries
698 682
699When using inline query expansion (@pxref{Inline Query Expansion}), EUDC 683When using inline query expansion (@pxref{Inline Query Expansion}), EUDC
@@ -724,8 +708,7 @@ that all available servers should be tried.
724 708
725 709
726 710
727@node Creating BBDB Records, Server/Protocol Locals, Multi-server Queries, Usage 711@node Creating BBDB Records
728@comment node-name, next, previous, up
729@section Creating BBDB Records 712@section Creating BBDB Records
730 713
731@findex eudc-insert-record-at-point-into-bbdb 714@findex eudc-insert-record-at-point-into-bbdb
@@ -840,8 +823,7 @@ Note that only a subset of the attributes you selected with
840actually be inserted as part of the newly created BBDB record. 823actually be inserted as part of the newly created BBDB record.
841 824
842 825
843@node Server/Protocol Locals, , Creating BBDB Records, Usage 826@node Server/Protocol Locals
844@comment node-name, next, previous, up
845@section Server/Protocol Locals 827@section Server/Protocol Locals
846 828
847EUDC can be customized independently for each server or directory 829EUDC can be customized independently for each server or directory
@@ -853,8 +835,7 @@ like buffer-local bindings but on a per server or per protocol basis.
853* Manipulating local bindings:: Functions to set and query local bindings 835* Manipulating local bindings:: Functions to set and query local bindings
854@end menu 836@end menu
855 837
856@node Manipulating local bindings, , Server/Protocol Locals, Server/Protocol Locals 838@node Manipulating local bindings
857@comment node-name, next, previous, up
858@subsection Manipulating local bindings 839@subsection Manipulating local bindings
859 840
860EUDC offers functions that let you set and query variables on a per 841EUDC offers functions that let you set and query variables on a per
@@ -931,8 +912,7 @@ Update all EUDC variables according to their local settings.
931 912
932 913
933 914
934@node Credits, GNU Free Documentation License, Usage, Top 915@node Credits
935@comment node-name, next, previous, up
936@chapter Credits 916@chapter Credits
937 917
938EUDC was written by Oscar Figueiredo based on @file{ph.el} by the 918EUDC was written by Oscar Figueiredo based on @file{ph.el} by the
@@ -941,18 +921,16 @@ same author.
941Thanks to Soren Dayton for his suggestions, his enthusiasm and his help 921Thanks to Soren Dayton for his suggestions, his enthusiasm and his help
942in testing and proofreading the code and docs of @file{ph.el}. 922in testing and proofreading the code and docs of @file{ph.el}.
943 923
944@node GNU Free Documentation License, Command and Function Index, Credits, Top 924@node GNU Free Documentation License
945@appendix GNU Free Documentation License 925@appendix GNU Free Documentation License
946@include doclicense.texi 926@include doclicense.texi
947 927
948@node Command and Function Index, Variables Index, GNU Free Documentation License, Top 928@node Command and Function Index
949@comment node-name, next, previous, up
950@unnumbered Command and Function Index 929@unnumbered Command and Function Index
951 930
952@printindex fn 931@printindex fn
953 932
954@node Variables Index, , Command and Function Index, Top 933@node Variables Index
955@comment node-name, next, previous, up
956@unnumbered Variables Index 934@unnumbered Variables Index
957 935
958@printindex vr 936@printindex vr
diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi
index ec0d6bfe4cc..8f3c0c2d623 100644
--- a/doc/misc/faq.texi
+++ b/doc/misc/faq.texi
@@ -11,7 +11,7 @@
11@c appreciate a notice if you do). 11@c appreciate a notice if you do).
12 12
13@copying 13@copying
14Copyright @copyright{} 2001-2012 Free Software Foundation, Inc.@* 14Copyright @copyright{} 2001--2013 Free Software Foundation, Inc.@*
15Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000 15Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000
16Reuven M. Lerner@* 16Reuven M. Lerner@*
17Copyright @copyright{} 1992, 1993 Steven Byrnes@* 17Copyright @copyright{} 1992, 1993 Steven Byrnes@*
@@ -2738,7 +2738,7 @@ type @kbd{C-h C-p} to read it.
2738 2738
2739Old versions (i.e., anything before 19.29) of Emacs had problems editing 2739Old versions (i.e., anything before 19.29) of Emacs had problems editing
2740files larger than 8 megabytes. In versions 19.29 and later, the maximum 2740files larger than 8 megabytes. In versions 19.29 and later, the maximum
2741buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. 2741buffer size is at least 2^27@minus{}1, or 134,217,727 bytes, or 132 MBytes.
2742The maximum buffer size on 32-bit machines increased to 256 MBytes in 2742The maximum buffer size on 32-bit machines increased to 256 MBytes in
2743Emacs 22, and again to 512 MBytes in Emacs 23.2. 2743Emacs 22, and again to 512 MBytes in Emacs 23.2.
2744 2744
diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi
index e82bfdfa6c5..1807f108e3b 100644
--- a/doc/misc/flymake.texi
+++ b/doc/misc/flymake.texi
@@ -11,8 +11,7 @@
11This manual is for GNU Flymake (version @value{VERSION}, @value{UPDATED}), 11This manual is for GNU Flymake (version @value{VERSION}, @value{UPDATED}),
12which is a universal on-the-fly syntax checker for GNU Emacs. 12which is a universal on-the-fly syntax checker for GNU Emacs.
13 13
14Copyright @copyright{} 2004-2012 14Copyright @copyright{} 2004--2013 Free Software Foundation, Inc.
15Free Software Foundation, Inc.
16 15
17@quotation 16@quotation
18Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -23,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
23is included in the section entitled ``GNU Free Documentation License''. 22is included in the section entitled ``GNU Free Documentation License''.
24 23
25(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
26modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
27developing GNU and promoting software freedom.''
28@end quotation 26@end quotation
29@end copying 27@end copying
30 28
@@ -357,8 +355,8 @@ Which fringe (if any) should show the warning/error bitmaps.
357@cindex Adding support for a new syntax check tool 355@cindex Adding support for a new syntax check tool
358 356
359@menu 357@menu
360* Example -- Configuring a tool called directly:: 358* Example---Configuring a tool called directly::
361* Example -- Configuring a tool called via make:: 359* Example---Configuring a tool called via make::
362@end menu 360@end menu
363 361
364Syntax check tools are configured using the 362Syntax check tools are configured using the
@@ -408,8 +406,8 @@ the @code{flymake-err-line-patterns} list.
408The following sections contain some examples of configuring Flymake 406The following sections contain some examples of configuring Flymake
409support for various syntax check tools. 407support for various syntax check tools.
410 408
411@node Example -- Configuring a tool called directly 409@node Example---Configuring a tool called directly
412@subsection Example -- Configuring a tool called directly 410@subsection Example---Configuring a tool called directly
413@cindex Adding support for perl 411@cindex Adding support for perl
414 412
415In this example, we will add support for @code{perl} as a syntax check 413In this example, we will add support for @code{perl} as a syntax check
@@ -457,8 +455,8 @@ Finally, we add an entry to @code{flymake-err-line-patterns}:
457 flymake-err-line-patterns)) 455 flymake-err-line-patterns))
458@end lisp 456@end lisp
459 457
460@node Example -- Configuring a tool called via make 458@node Example---Configuring a tool called via make
461@subsection Example -- Configuring a tool called via make 459@subsection Example---Configuring a tool called via make
462@cindex Adding support for C (gcc+make) 460@cindex Adding support for C (gcc+make)
463 461
464In this example we will add support for C files syntax checked by 462In this example we will add support for C files syntax checked by
@@ -530,7 +528,7 @@ check-syntax:
530Syntax check is started by calling @code{flymake-start-syntax-check-for-current-buffer}. 528Syntax check is started by calling @code{flymake-start-syntax-check-for-current-buffer}.
531Flymake first determines whether it is able to do syntax 529Flymake first determines whether it is able to do syntax
532check. It then saves a copy of the buffer in a temporary file in the 530check. It then saves a copy of the buffer in a temporary file in the
533buffer's directory (or in the system temp directory -- for java 531buffer's directory (or in the system temp directory, for java
534files), creates a syntax check command and launches a process with 532files), creates a syntax check command and launches a process with
535this command. The output is parsed using a list of error message patterns, 533this command. The output is parsed using a list of error message patterns,
536and error information (file name, line number, type and text) is 534and error information (file name, line number, type and text) is
diff --git a/doc/misc/forms.texi b/doc/misc/forms.texi
index 7f84de9754b..43ffab26c9b 100644
--- a/doc/misc/forms.texi
+++ b/doc/misc/forms.texi
@@ -18,7 +18,7 @@
18@copying 18@copying
19This file documents Forms mode, a form-editing major mode for GNU Emacs. 19This file documents Forms mode, a form-editing major mode for GNU Emacs.
20 20
21Copyright @copyright{} 1989, 1997, 2001-2012 Free Software Foundation, Inc. 21Copyright @copyright{} 1989, 1997, 2001--2013 Free Software Foundation, Inc.
22 22
23@quotation 23@quotation
24Permission is granted to copy, distribute and/or modify this document 24Permission is granted to copy, distribute and/or modify this document
@@ -29,8 +29,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
29is included in the section entitled ``GNU Free Documentation License''. 29is included in the section entitled ``GNU Free Documentation License''.
30 30
31(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 31(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
32modify this GNU manual. Buying copies from the FSF supports it in 32modify this GNU manual.''
33developing GNU and promoting software freedom.''
34@end quotation 33@end quotation
35@end copying 34@end copying
36 35
@@ -88,8 +87,8 @@ how to present it.
88* Miscellaneous:: Forms mode messages and other remarks. 87* Miscellaneous:: Forms mode messages and other remarks.
89* Error Messages:: List of error messages forms mode can produce. 88* Error Messages:: List of error messages forms mode can produce.
90* Long Example:: A more complex control file example. 89* Long Example:: A more complex control file example.
91* GNU Free Documentation License:: The license for this documentation.
92* Credits:: Thanks everyone. 90* Credits:: Thanks everyone.
91* GNU Free Documentation License:: The license for this documentation.
93* Index:: Index to this manual. 92* Index:: Index to this manual.
94@end menu 93@end menu
95@end ifnottex 94@end ifnottex
diff --git a/doc/misc/gnus-coding.texi b/doc/misc/gnus-coding.texi
index 2bc064071ec..15393ad8032 100644
--- a/doc/misc/gnus-coding.texi
+++ b/doc/misc/gnus-coding.texi
@@ -7,26 +7,19 @@
7@syncodeindex pg cp 7@syncodeindex pg cp
8 8
9@copying 9@copying
10Copyright @copyright{} 2004-2005, 2007-2012 Free Software 10Copyright @copyright{} 2004--2005, 2007--2013 Free Software
11Foundation, Inc. 11Foundation, Inc.
12 12
13@quotation 13@quotation
14Permission is granted to copy, distribute and/or modify this document 14Permission is granted to copy, distribute and/or modify this document
15under the terms of the GNU Free Documentation License, Version 1.3 or 15under the terms of the GNU Free Documentation License, Version 1.3 or
16any later version published by the Free Software Foundation; with no 16any later version published by the Free Software Foundation; with no
17Invariant Sections, with the Front-Cover texts being ``A GNU 17Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
18Manual'', and with the Back-Cover Texts as in (a) below. A copy of the 18and with the Back-Cover Texts as in (a) below. A copy of the license
19license is included in the section entitled ``GNU Free Documentation 19is included in the section entitled ``GNU Free Documentation License''.
20License'' in the Gnus manual.
21 20
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 22modify this GNU manual.''
24developing GNU and promoting software freedom.''
25
26This document is part of a collection distributed under the GNU Free
27Documentation License. If you want to distribute this document
28separately from the collection, you can do so by adding a copy of the
29license to the document, as described in section 6 of the license.
30@end quotation 23@end quotation
31@end copying 24@end copying
32 25
@@ -54,6 +47,7 @@ This manual describes @dots{}
54@menu 47@menu
55* Gnus Coding Style:: Gnus Coding Style 48* Gnus Coding Style:: Gnus Coding Style
56* Gnus Maintenance Guide:: Gnus Maintenance Guide 49* Gnus Maintenance Guide:: Gnus Maintenance Guide
50* GNU Free Documentation License:: The license for this documentation.
57@end menu 51@end menu
58 52
59@c @ref{Gnus Reference Guide, ,Gnus Reference Guide, gnus, The Gnus Newsreader} 53@c @ref{Gnus Reference Guide, ,Gnus Reference Guide, gnus, The Gnus Newsreader}
@@ -306,7 +300,7 @@ reason.
306@c (typically so far the only exception has been that the changes 300@c (typically so far the only exception has been that the changes
307@c already exist in the trunk in modified form). 301@c already exist in the trunk in modified form).
308Because of this, when the next major version of Gnus will be included in 302Because of this, when the next major version of Gnus will be included in
309Emacs, it should be very easy -- just plonk in the files from the Gnus 303Emacs, it should be very easy---just plonk in the files from the Gnus
310trunk without worrying about lost changes from the Emacs tree. 304trunk without worrying about lost changes from the Emacs tree.
311 305
312The effect of this is that as hacker, you should generally only have to 306The effect of this is that as hacker, you should generally only have to
@@ -320,7 +314,7 @@ tree, and it will show up in the Gnus tree a few days later.
320 314
321If you don't have Emacs bzr access (or it's inconvenient), you can 315If you don't have Emacs bzr access (or it's inconvenient), you can
322change such a file in the v5-10 branch, and it should propagate to Emacs 316change such a file in the v5-10 branch, and it should propagate to Emacs
323bzr -- however, it will get some extra scrutiny (by Miles) to see if the 317bzr---however, it will get some extra scrutiny (by Miles) to see if the
324changes are possibly controversial and need discussion on the mailing 318changes are possibly controversial and need discussion on the mailing
325list. Many changes are obvious bug-fixes however, so often there won't 319list. Many changes are obvious bug-fixes however, so often there won't
326be any problem. 320be any problem.
@@ -335,7 +329,7 @@ including improvements on the documentation.
335If you know that there will be conflicts (perhaps because the affected 329If you know that there will be conflicts (perhaps because the affected
336source code is different in v5-10 and the Gnus git trunk), then you can 330source code is different in v5-10 and the Gnus git trunk), then you can
337install your change in both places, and when I try to sync them, there 331install your change in both places, and when I try to sync them, there
338will be a conflict -- however, since in most such cases there would be a 332will be a conflict---however, since in most such cases there would be a
339conflict @emph{anyway}, it's often easier for me to resolve it simply if 333conflict @emph{anyway}, it's often easier for me to resolve it simply if
340I see two @samp{identical} changes, and can just choose the proper one, 334I see two @samp{identical} changes, and can just choose the proper one,
341rather than having to actually fix the code. 335rather than having to actually fix the code.
@@ -387,6 +381,10 @@ If the variable is new in No Gnus use @code{:version "23.1" ;; No Gnus}.
387The same applies for customizable variables when its default value was 381The same applies for customizable variables when its default value was
388changed. 382changed.
389 383
384@node GNU Free Documentation License
385@appendix GNU Free Documentation License
386@include doclicense.texi
387
390@c Local Variables: 388@c Local Variables:
391@c mode: texinfo 389@c mode: texinfo
392@c coding: iso-8859-1 390@c coding: iso-8859-1
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 038b78cced3..2a1f5ac2cc1 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -1,7 +1,7 @@
1@c \input texinfo @c -*-texinfo-*- 1@c \input texinfo @c -*-texinfo-*-
2@c Uncomment 1st line before texing this file alone. 2@c Uncomment 1st line before texing this file alone.
3@c %**start of header 3@c %**start of header
4@c Copyright (C) 1995, 2001-2012 Free Software Foundation, Inc. 4@c Copyright (C) 1995, 2001-2013 Free Software Foundation, Inc.
5@c 5@c
6@setfilename gnus-faq.info 6@setfilename gnus-faq.info
7@settitle Frequently Asked Questions 7@settitle Frequently Asked Questions
@@ -80,7 +80,7 @@ want.
80 80
81This FAQ was maintained by Justin Sheehy until March 2002. He 81This FAQ was maintained by Justin Sheehy until March 2002. He
82would like to thank Steve Baur and Per Abrahamsen for doing a wonderful 82would like to thank Steve Baur and Per Abrahamsen for doing a wonderful
83job with this FAQ before him. We would like to do the same - thanks, 83job with this FAQ before him. We would like to do the same: thanks,
84Justin! 84Justin!
85 85
86This version is much nicer than the unofficial hypertext 86This version is much nicer than the unofficial hypertext
@@ -1038,7 +1038,7 @@ mail groups. Is this a bug?
1038 1038
1039No, that's a matter of design of Gnus, fixing this would 1039No, that's a matter of design of Gnus, fixing this would
1040mean reimplementation of major parts of Gnus' 1040mean reimplementation of major parts of Gnus'
1041back ends. Gnus thinks "highest-article-number - 1041back ends. Gnus thinks "highest-article-number @minus{}
1042lowest-article-number = total-number-of-articles". This 1042lowest-article-number = total-number-of-articles". This
1043works OK for Usenet groups, but if you delete and move 1043works OK for Usenet groups, but if you delete and move
1044many messages in mail groups, this fails. To cure the 1044many messages in mail groups, this fails. To cure the
diff --git a/doc/misc/gnus-news.el b/doc/misc/gnus-news.el
index 0c083c85a4d..ff082e4ecf0 100644
--- a/doc/misc/gnus-news.el
+++ b/doc/misc/gnus-news.el
@@ -1,5 +1,5 @@
1;;; gnus-news.el --- a hack to create GNUS-NEWS from texinfo source 1;;; gnus-news.el --- a hack to create GNUS-NEWS from texinfo source
2;; Copyright (C) 2004-2012 Free Software Foundation, Inc. 2;; Copyright (C) 2004-2013 Free Software Foundation, Inc.
3 3
4;; Author: Reiner Steib <Reiner.Steib@gmx.de> 4;; Author: Reiner Steib <Reiner.Steib@gmx.de>
5;; Keywords: tools 5;; Keywords: tools
@@ -26,7 +26,7 @@
26(defvar gnus-news-header-disclaimer 26(defvar gnus-news-header-disclaimer
27"GNUS NEWS -- history of user-visible changes. 27"GNUS NEWS -- history of user-visible changes.
28 28
29Copyright (C) 1999-2012 Free Software Foundation, Inc. 29Copyright (C) 1999-2013 Free Software Foundation, Inc.
30See the end of the file for license conditions. 30See the end of the file for license conditions.
31 31
32Please send Gnus bug reports to bugs@gnus.org. 32Please send Gnus bug reports to bugs@gnus.org.
diff --git a/doc/misc/gnus-news.texi b/doc/misc/gnus-news.texi
index 19bbe01667c..9c1ecb19748 100644
--- a/doc/misc/gnus-news.texi
+++ b/doc/misc/gnus-news.texi
@@ -1,6 +1,6 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2 2
3@c Copyright (C) 2004-2012 Free Software Foundation, Inc. 3@c Copyright (C) 2004-2013 Free Software Foundation, Inc.
4 4
5@c Permission is granted to anyone to make or distribute verbatim copies 5@c Permission is granted to anyone to make or distribute verbatim copies
6@c of this document as received, in any medium, provided that the 6@c of this document as received, in any medium, provided that the
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index dfc422479e3..b5029e5d6a8 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -11,7 +11,7 @@
11@documentencoding UTF-8 11@documentencoding UTF-8
12 12
13@copying 13@copying
14Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 1995--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License''. 22is included in the section entitled ``GNU Free Documentation License''.
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
@@ -1297,7 +1296,7 @@ subscribing these groups.
1297variable defaults to @code{gnus-subscribe-alphabetically}. 1296variable defaults to @code{gnus-subscribe-alphabetically}.
1298 1297
1299The ``options -n'' format is very simplistic. The syntax above is all 1298The ``options -n'' format is very simplistic. The syntax above is all
1300that is supports -- you can force-subscribe hierarchies, or you can 1299that is supports: you can force-subscribe hierarchies, or you can
1301deny hierarchies, and that's it. 1300deny hierarchies, and that's it.
1302 1301
1303@vindex gnus-options-not-subscribe 1302@vindex gnus-options-not-subscribe
@@ -2144,14 +2143,14 @@ In groups in some news servers, there might be a big gap between a few
2144very old articles that will never be expired and the recent ones. In 2143very old articles that will never be expired and the recent ones. In
2145such a case, the server will return the data like @code{(1 . 30000000)} 2144such a case, the server will return the data like @code{(1 . 30000000)}
2146for the @code{LIST ACTIVE group} command, for example. Even if there 2145for the @code{LIST ACTIVE group} command, for example. Even if there
2147are actually only the articles 1-10 and 29999900-30000000, Gnus doesn't 2146are actually only the articles 1--10 and 29999900--30000000, Gnus doesn't
2148know it at first and prepares for getting 30000000 articles. However, 2147know it at first and prepares for getting 30000000 articles. However,
2149it will consume hundreds megabytes of memories and might make Emacs get 2148it will consume hundreds megabytes of memories and might make Emacs get
2150stuck as the case may be. If you use such news servers, set the 2149stuck as the case may be. If you use such news servers, set the
2151variable @code{gnus-newsgroup-maximum-articles} to a positive number. 2150variable @code{gnus-newsgroup-maximum-articles} to a positive number.
2152The value means that Gnus ignores articles other than this number of the 2151The value means that Gnus ignores articles other than this number of the
2153latest ones in every group. For instance, the value 10000 makes Gnus 2152latest ones in every group. For instance, the value 10000 makes Gnus
2154get only the articles 29990001-30000000 (if the latest article number is 2153get only the articles 29990001--30000000 (if the latest article number is
215530000000 in a group). Note that setting this variable to a number might 215430000000 in a group). Note that setting this variable to a number might
2156prevent you from reading very old articles. The default value of the 2155prevent you from reading very old articles. The default value of the
2157variable @code{gnus-newsgroup-maximum-articles} is @code{nil}, which 2156variable @code{gnus-newsgroup-maximum-articles} is @code{nil}, which
@@ -3646,6 +3645,15 @@ Describe the current group (@code{gnus-browse-describe-group}).
3646@findex gnus-browse-describe-briefly 3645@findex gnus-browse-describe-briefly
3647Describe browse mode briefly (well, there's not much to describe, is 3646Describe browse mode briefly (well, there's not much to describe, is
3648there) (@code{gnus-browse-describe-briefly}). 3647there) (@code{gnus-browse-describe-briefly}).
3648
3649@item DEL
3650@kindex DEL (Browse)
3651@findex gnus-browse-delete-group
3652This function will delete the current group
3653(@code{gnus-browse-delete-group}). If given a prefix, this function
3654will actually delete all the articles in the group, and forcibly
3655remove the group itself from the face of the Earth. Use a prefix only
3656if you are absolutely sure of what you are doing.
3649@end table 3657@end table
3650 3658
3651 3659
@@ -3824,7 +3832,7 @@ So, to move a topic to the beginning of the list of topics, just hit
3824@kbd{C-k} on it. This is like the ``cut'' part of cut and paste. Then, 3832@kbd{C-k} on it. This is like the ``cut'' part of cut and paste. Then,
3825move the cursor to the beginning of the buffer (just below the ``Gnus'' 3833move the cursor to the beginning of the buffer (just below the ``Gnus''
3826topic) and hit @kbd{C-y}. This is like the ``paste'' part of cut and 3834topic) and hit @kbd{C-y}. This is like the ``paste'' part of cut and
3827paste. Like I said -- E-Z. 3835paste. Like I said---E-Z.
3828 3836
3829You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics. So 3837You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics. So
3830you can move topics around as well as groups. 3838you can move topics around as well as groups.
@@ -13666,7 +13674,7 @@ server. The default value of this variable is @code{("XOVER"
13666@vindex nntp-nov-gap 13674@vindex nntp-nov-gap
13667@code{nntp} normally sends just one big request for @acronym{NOV} lines to 13675@code{nntp} normally sends just one big request for @acronym{NOV} lines to
13668the server. The server responds with one huge list of lines. However, 13676the server. The server responds with one huge list of lines. However,
13669if you have read articles 2-5000 in the group, and only want to read 13677if you have read articles 2--5000 in the group, and only want to read
13670article 1 and 5001, that means that @code{nntp} will fetch 4999 @acronym{NOV} 13678article 1 and 5001, that means that @code{nntp} will fetch 4999 @acronym{NOV}
13671lines that you will not need. This variable says how 13679lines that you will not need. This variable says how
13672big a gap between two consecutive articles is allowed to be before the 13680big a gap between two consecutive articles is allowed to be before the
@@ -14200,7 +14208,11 @@ what you need.
14200 14208
14201@item nnimap-authenticator 14209@item nnimap-authenticator
14202Some @acronym{IMAP} servers allow anonymous logins. In that case, 14210Some @acronym{IMAP} servers allow anonymous logins. In that case,
14203this should be set to @code{anonymous}. 14211this should be set to @code{anonymous}. If this variable isn't set,
14212the normal login methods will be used. If you wish to specify a
14213specific login method to be used, you can set this variable to either
14214@code{login} (the traditional @acronym{IMAP} login method),
14215@code{plain} or @code{cram-md5}.
14204 14216
14205@item nnimap-expunge 14217@item nnimap-expunge
14206If non-@code{nil}, expunge articles after deleting them. This is always done 14218If non-@code{nil}, expunge articles after deleting them. This is always done
@@ -15962,7 +15974,7 @@ Decode Quoted Readable encoding.
15962If you are a member of a couple of mailing lists, you will sometimes 15974If you are a member of a couple of mailing lists, you will sometimes
15963receive two copies of the same mail. This can be quite annoying, so 15975receive two copies of the same mail. This can be quite annoying, so
15964@code{nnmail} checks for and treats any duplicates it might find. To do 15976@code{nnmail} checks for and treats any duplicates it might find. To do
15965this, it keeps a cache of old @code{Message-ID}s--- 15977this, it keeps a cache of old @code{Message-ID}s:
15966@code{nnmail-message-id-cache-file}, which is @file{~/.nnmail-cache} by 15978@code{nnmail-message-id-cache-file}, which is @file{~/.nnmail-cache} by
15967default. The approximate maximum number of @code{Message-ID}s stored 15979default. The approximate maximum number of @code{Message-ID}s stored
15968there is controlled by the @code{nnmail-message-id-cache-length} 15980there is controlled by the @code{nnmail-message-id-cache-length}
@@ -16626,8 +16638,8 @@ future. Here are some high and low points on each:
16626@table @code 16638@table @code
16627@item nnmbox 16639@item nnmbox
16628 16640
16629UNIX systems have historically had a single, very common, and well- 16641UNIX systems have historically had a single, very common, and well-defined
16630defined format. All messages arrive in a single @dfn{spool file}, and 16642format. All messages arrive in a single @dfn{spool file}, and
16631they are delineated by a line whose regular expression matches 16643they are delineated by a line whose regular expression matches
16632@samp{^From_}. (My notational use of @samp{_} is to indicate a space, 16644@samp{^From_}. (My notational use of @samp{_} is to indicate a space,
16633to make it clear in this instance that this is not the RFC-specified 16645to make it clear in this instance that this is not the RFC-specified
@@ -21174,7 +21186,7 @@ features (inspired by the Google search input language):
21174AND, OR, and NOT are supported, and parentheses can be used to control 21186AND, OR, and NOT are supported, and parentheses can be used to control
21175operator precedence, e.g., (emacs OR xemacs) AND linux. Note that 21187operator precedence, e.g., (emacs OR xemacs) AND linux. Note that
21176operators must be written with all capital letters to be 21188operators must be written with all capital letters to be
21177recognized. Also preceding a term with a - sign is equivalent to NOT 21189recognized. Also preceding a term with a @minus{} sign is equivalent to NOT
21178term. 21190term.
21179 21191
21180@item Automatic AND queries 21192@item Automatic AND queries
@@ -21222,7 +21234,8 @@ Note that operators must be written with all capital letters to be
21222recognized. 21234recognized.
21223 21235
21224@item Required and excluded terms 21236@item Required and excluded terms
21225+ and - can be used to require or exclude terms, e.g., football -american 21237+ and @minus{} can be used to require or exclude terms, e.g., football
21238@minus{}american
21226 21239
21227@item Unicode handling 21240@item Unicode handling
21228The search engine converts all text to utf-8, so searching should work 21241The search engine converts all text to utf-8, so searching should work
@@ -21359,7 +21372,7 @@ This engine is obsolete.
21359@table @code 21372@table @code
21360 21373
21361@item nnir-method-default-engines 21374@item nnir-method-default-engines
21362Alist of server backend - search engine pairs. The default associations 21375Alist of pairs of server backends and search engines. The default associations
21363are 21376are
21364@example 21377@example
21365(nnimap . imap) 21378(nnimap . imap)
@@ -22574,7 +22587,7 @@ configuration function will use @code{group} as the key. A full list of
22574possible names is listed below. 22587possible names is listed below.
22575 22588
22576The @dfn{value} (i.e., the @dfn{split}) says how much space each buffer 22589The @dfn{value} (i.e., the @dfn{split}) says how much space each buffer
22577should occupy. To take the @code{article} split as an example - 22590should occupy. To take the @code{article} split as an example:
22578 22591
22579@lisp 22592@lisp
22580(article (vertical 1.0 (summary 0.25 point) 22593(article (vertical 1.0 (summary 0.25 point)
@@ -26351,9 +26364,9 @@ with the information when possible).
26351 26364
26352On the January 31th 2012, Ma Gnus was begun. 26365On the January 31th 2012, Ma Gnus was begun.
26353 26366
26354If you happen upon a version of Gnus that has a prefixed name -- 26367If you happen upon a version of Gnus that has a prefixed name---``(ding)
26355``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'', 26368Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'',
26356``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'', ``Ma Gnus'' -- don't 26369``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'', ``Ma Gnus''---don't
26357panic. Don't let it know that you're frightened. Back away. Slowly. 26370panic. Don't let it know that you're frightened. Back away. Slowly.
26358Whatever you do, don't run. Walk away, calmly, until you're out of 26371Whatever you do, don't run. Walk away, calmly, until you're out of
26359its reach. Find a proper released version of Gnus and snuggle up to 26372its reach. Find a proper released version of Gnus and snuggle up to
@@ -26500,14 +26513,14 @@ on Son-of-RFC 1036. They have produced a number of drafts proposing
26500various changes to the format of news articles. The Gnus towers will 26513various changes to the format of news articles. The Gnus towers will
26501look into implementing the changes when the draft is accepted as an RFC. 26514look into implementing the changes when the draft is accepted as an RFC.
26502 26515
26503@item MIME - RFC 2045-2049 etc 26516@item MIME---RFC 2045--2049 etc
26504@cindex @acronym{MIME} 26517@cindex @acronym{MIME}
26505All the various @acronym{MIME} RFCs are supported. 26518All the various @acronym{MIME} RFCs are supported.
26506 26519
26507@item Disposition Notifications - RFC 2298 26520@item Disposition Notifications---RFC 2298
26508Message Mode is able to request notifications from the receiver. 26521Message Mode is able to request notifications from the receiver.
26509 26522
26510@item PGP - RFC 1991 and RFC 2440 26523@item PGP---RFC 1991 and RFC 2440
26511@cindex RFC 1991 26524@cindex RFC 1991
26512@cindex RFC 2440 26525@cindex RFC 2440
26513RFC 1991 is the original @acronym{PGP} message specification, 26526RFC 1991 is the original @acronym{PGP} message specification,
@@ -26517,15 +26530,15 @@ non-@acronym{MIME} aware @acronym{PGP} format. Gnus supports both
26517encoding (signing and encryption) and decoding (verification and 26530encoding (signing and encryption) and decoding (verification and
26518decryption). 26531decryption).
26519 26532
26520@item PGP/MIME - RFC 2015/3156 26533@item PGP/MIME---RFC 2015/3156
26521RFC 2015 (superseded by 3156 which references RFC 2440 instead of RFC 26534RFC 2015 (superseded by 3156 which references RFC 2440 instead of RFC
265221991) describes the @acronym{MIME}-wrapping around the RFC 1991/2440 format. 265351991) describes the @acronym{MIME}-wrapping around the RFC 1991/2440 format.
26523Gnus supports both encoding and decoding. 26536Gnus supports both encoding and decoding.
26524 26537
26525@item S/MIME - RFC 2633 26538@item S/MIME---RFC 2633
26526RFC 2633 describes the @acronym{S/MIME} format. 26539RFC 2633 describes the @acronym{S/MIME} format.
26527 26540
26528@item IMAP - RFC 1730/2060, RFC 2195, RFC 2086, RFC 2359, RFC 2595, RFC 1731 26541@item IMAP---RFC 1730/2060, RFC 2195, RFC 2086, RFC 2359, RFC 2595, RFC 1731
26529RFC 1730 is @acronym{IMAP} version 4, updated somewhat by RFC 2060 26542RFC 1730 is @acronym{IMAP} version 4, updated somewhat by RFC 2060
26530(@acronym{IMAP} 4 revision 1). RFC 2195 describes CRAM-MD5 26543(@acronym{IMAP} 4 revision 1). RFC 2195 describes CRAM-MD5
26531authentication for @acronym{IMAP}. RFC 2086 describes access control 26544authentication for @acronym{IMAP}. RFC 2086 describes access control
@@ -26580,7 +26593,7 @@ circles) @dfn{snapshots}. During this phase, Gnus is assumed to be
26580unstable and should not be used by casual users. Gnus alpha releases 26593unstable and should not be used by casual users. Gnus alpha releases
26581have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}. 26594have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}.
26582 26595
26583After futzing around for 10-100 alpha releases, Gnus is declared 26596After futzing around for 10--100 alpha releases, Gnus is declared
26584@dfn{frozen}, and only bug fixes are applied. Gnus loses the prefix, 26597@dfn{frozen}, and only bug fixes are applied. Gnus loses the prefix,
26585and is called things like ``Gnus 5.10.1'' instead. Normal people are 26598and is called things like ``Gnus 5.10.1'' instead. Normal people are
26586supposed to be able to use these, and these are mostly discussed on the 26599supposed to be able to use these, and these are mostly discussed on the
@@ -28167,7 +28180,7 @@ The behavior can be changed by customizing @code{message-insert-canlock}.
28167 28180
28168@item 28181@item
28169Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC 28182Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC
281702015/3156) and @acronym{S/MIME} (RFC 2630-2633). 281832015/3156) and @acronym{S/MIME} (RFC 2630--2633).
28171 28184
28172It needs an external @acronym{S/MIME} and OpenPGP implementation, but no 28185It needs an external @acronym{S/MIME} and OpenPGP implementation, but no
28173additional Lisp libraries. This add several menu items to the 28186additional Lisp libraries. This add several menu items to the
@@ -28586,10 +28599,10 @@ know that the server makes wrong @acronym{NOV} data.
28586 28599
28587@item level 28600@item level
28588@cindex levels 28601@cindex levels
28589Each group is subscribed at some @dfn{level} or other (1-9). The ones 28602Each group is subscribed at some @dfn{level} or other (1--9). The ones
28590that have a lower level are ``more'' subscribed than the groups with a 28603that have a lower level are ``more'' subscribed than the groups with a
28591higher level. In fact, groups on levels 1-5 are considered 28604higher level. In fact, groups on levels 1--5 are considered
28592@dfn{subscribed}; 6-7 are @dfn{unsubscribed}; 8 are @dfn{zombies}; and 9 28605@dfn{subscribed}; 6--7 are @dfn{unsubscribed}; 8 are @dfn{zombies}; and 9
28593are @dfn{killed}. Commands for listing groups and scanning for new 28606are @dfn{killed}. Commands for listing groups and scanning for new
28594articles will all use the numeric prefix as @dfn{working level}. 28607articles will all use the numeric prefix as @dfn{working level}.
28595 28608
@@ -29165,8 +29178,8 @@ return value.
29165 29178
29166Some back ends could be said to be @dfn{server-forming} back ends, and 29179Some back ends could be said to be @dfn{server-forming} back ends, and
29167some might be said not to be. The latter are back ends that generally 29180some might be said not to be. The latter are back ends that generally
29168only operate on one group at a time, and have no concept of ``server'' 29181only operate on one group at a time, and have no concept of ``server'';
29169---they have a group, and they deliver info on that group and nothing 29182they have a group, and they deliver info on that group and nothing
29170more. 29183more.
29171 29184
29172Gnus identifies each message by way of group name and article number. A 29185Gnus identifies each message by way of group name and article number. A
diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi
new file mode 100644
index 00000000000..911cdd3cd5f
--- /dev/null
+++ b/doc/misc/htmlfontify.texi
@@ -0,0 +1,1612 @@
1\input texinfo
2@comment %**start of header
3@setfilename ../../info/htmlfontify
4@settitle Htmlfontify User Manual
5@exampleindent 2
6@comment %**end of header
7
8@copying
9This manual documents Htmlfontify, a source code -> crosslinked +
10formatted + syntax colorised html transformer.
11
12Copyright @copyright{} 2002, 2003, 2013 Free Software Foundation, Inc.
13
14@quotation
15Permission is granted to copy, distribute and/or modify this document
16under the terms of the GNU Free Documentation License, Version 1.3 or
17any later version published by the Free Software Foundation; with no
18Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
19and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License''.
21
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual.''
24@end quotation
25@end copying
26
27@dircategory Emacs misc features
28@direntry
29* Htmlfontify: (htmlfontify). Convert source code to html.
30@end direntry
31
32@titlepage
33@title Htmlfontify User Manual
34@sp 4
35@subtitle Htmlfontify version 0.20
36@sp 1
37@subtitle Jun 2002
38@sp 5
39@author Vivek Dasmohapatra
40@page
41
42@vskip 0pt plus 1filll
43@noindent
44@insertcopying
45@end titlepage
46
47@contents
48
49@ifnottex
50@node Top
51@top Htmlfontify
52
53@insertcopying
54@end ifnottex
55
56@menu
57* Introduction:: About Htmlfontify.
58* Usage & Examples:: How to use Htmlfontify.
59* Customisation:: Fine-tuning Htmlfontify's behaviour.
60* Requirements:: External programs used by Htmlfontify.
61* GNU Free Documentation License:: The license for this documentation.
62* Index:: Index of contents.
63@end menu
64
65@node Introduction
66@chapter Introduction
67@cindex Introduction
68
69Htmlfontify provides a means of converting individual Emacs buffers,
70source files, or entire source trees to html, preserving formatting
71and Emacs colorisation / syntax highlighting as much as possible
72through careful application of CSS stylesheets and html tags.
73
74It can also turn instances of functions, methods and (for some
75languages) variables and other constructs and items into links
76to their definitions, and create an index file (or files) of
77all such symbols, also linked to their points of definition.
78
79Htmlfontify also provides several customisation items, which should
80allow it to mesh more-or-less seamlessly with various templating or
81publishing systems (in the event, for instance, that you don't want
82to produce the html pages directly).
83
84@node Usage & Examples
85@chapter Usage & Examples
86@cindex Usage & Examples
87
88Htmlfontify can be used both interactively and as part of another
89elisp function. If you're running it in a modern Emacs, it will also
90run when attached to a terminal (i.e., without X) or even when in
91batch mode.
92
93@menu
94* Interactive:: Using Htmlfontify interactively.
95* Non-interactive:: Using Htmlfontify from elisp.
96* Variables:: Variables (other than customisation entries).
97* Data Structures:: Important data structures.
98* Examples:: Example(s) of Htmlfontify in use.
99@end menu
100
101@node Interactive
102@section Interactive
103@cindex Interactive
104@cindex functions (interactive)
105
106Htmlfontify provides the following interactive functions:
107
108@table @code
109@item htmlfontify-buffer
110@findex htmlfontify-buffer
111@anchor{htmlfontify-buffer}
112
113@lisp
114
115(htmlfontify-buffer &optional @var{srcdir} @var{file})
116@end lisp
117
118Create a new buffer, named for the current buffer + a .html extension,
119containing an inline CSS-stylesheet and formatted CSS-markup html that
120reproduces the look of the current Emacs buffer as closely as possible.
121
122``Dangerous'' characters in the existing buffer are turned into html
123entities, so you should even be able to do html-within-html fontified
124display.
125
126You should, however, note that random control or eight-bit characters
127such as ^L (\x0c) or ¤ (\xa4) won't get mapped yet.
128
129If the @var{srcdir} and @var{file} arguments are set, lookup etags
130derived entries in the @ref{hfy-tags-cache} and add html anchors
131and hyperlinks as appropriate.
132
133@item htmlfontify-run-etags
134@findex htmlfontify-run-etags
135@anchor{htmlfontify-run-etags}
136
137@lisp
138
139(htmlfontify-run-etags @var{srcdir})
140@end lisp
141
142Load the etags cache for @var{srcdir}. See @ref{hfy-load-tags-cache}.
143
144@item htmlfontify-copy-and-link-dir
145@findex htmlfontify-copy-and-link-dir
146@anchor{htmlfontify-copy-and-link-dir}
147
148@lisp
149
150(htmlfontify-copy-and-link-dir @var{srcdir} @var{dstdir} &optional @var{f-ext} @var{l-ext})
151@end lisp
152
153Trawl @var{srcdir} and write fontified-and-hyperlinked output in
154@var{dstdir}. @var{f-ext} and @var{l-ext} specify values for
155@ref{hfy-extn} and @ref{hfy-link-extn}.
156
157You may also want to set @ref{hfy-page-header} and @ref{hfy-page-footer}.
158
159@item htmlfontify-load-rgb-file
160@findex htmlfontify-load-rgb-file
161@anchor{htmlfontify-load-rgb-file}
162
163@lisp
164
165(htmlfontify-load-rgb-file &optional @var{file})
166@end lisp
167
168Load an X11 style rgb.txt file (search @code{hfy-rgb-load-path} if
169@var{file} is not specified).
170
171Note that this is not necessary if all you want is the standard X11
172(XFree86 4.1.0) color name -> rgb triplet mapping. Htmlfontify has
173a copy built in, for use when it cannot contact an X server.
174
175Loads the variable @code{hfy-rgb-txt-color-map}, which is used by
176@ref{hfy-fallback-color-values}.
177
178@item htmlfontify-unload-rgb-file
179@findex htmlfontify-unload-rgb-file
180@anchor{htmlfontify-unload-rgb-file}
181
182@lisp
183
184(htmlfontify-unload-rgb-file)
185@end lisp
186
187Unload the currently loaded X11 style rgb.txt file (if any).
188@end table
189
190@node Non-interactive
191@section Non-interactive
192@cindex Noninteractive
193@cindex functions (noninteractive)
194
195In addition to the aforementioned interactive methods, Htmlfontify
196provides the following non-interactive ones:
197
198@table @code
199@comment AUTOGENERATED BLOCK
200
201@item hfy-face-to-style
202@findex hfy-face-to-style
203@anchor{hfy-face-to-style}
204
205@lisp
206
207(hfy-face-to-style @var{fn})
208@end lisp
209
210Take @var{fn}, a font or @code{defface} style font specification,
211(as returned by @code{face-attr-construct} or @ref{hfy-face-attr-for-class})
212and return a @ref{hfy-style-assoc}.
213
214See also: @ref{hfy-face-to-style-i}, @ref{hfy-flatten-style}.
215
216@item hfy-fallback-color-values
217@findex hfy-fallback-color-values
218@anchor{hfy-fallback-color-values}
219
220@lisp
221
222(hfy-fallback-color-values @var{color-string})
223@end lisp
224
225Use a fallback method for obtaining the rgb values for a color.
226If @ref{htmlfontify-load-rgb-file} has been called, it uses the
227color map specified, otherwise it uses Htmlfontify's built in map.
228
229@item hfy-combined-face-spec
230@findex hfy-combined-face-spec
231@anchor{hfy-combined-face-spec}
232
233@lisp
234
235(hfy-combined-face-spec @var{face})
236@end lisp
237
238Return a @code{defface} style alist of possible specifications for
239@var{face}, with any entries resulting from user customisation
240(@code{custom-set-faces}) taking precedence.
241
242See also: @ref{hfy-default-face-def}
243
244@item hfy-word-regex
245@findex hfy-word-regex
246@anchor{hfy-word-regex}
247
248@lisp
249
250(hfy-word-regex @var{string})
251@end lisp
252
253Return a regex that matches @var{string} as the first @code{match-string},
254with non word characters on either side (vaguely emulating the perl @code{\b}
255regex atom).
256
257@item hfy-force-fontification
258@findex hfy-force-fontification
259@anchor{hfy-force-fontification}
260
261@lisp
262
263(hfy-force-fontification)
264@end lisp
265
266Emacs's fontification is designed for interactive use. As such, it sometimes
267does things like deferring fontification until a section of the buffer is
268exposed and rendered, or until Emacs is idle for a while. Sometimes, in
269non-interactive circumstances, or if it can't see X, it doesn't bother
270with some of the harder stuff. While this is all great from the perspective
271of a user waiting for Emacs to load a 20000 line file and colorise it,
272it's a pain from the point of view from non-interactive code. This function
273lies, cheats, steals and generally bullies Emacs into fontifying a buffer
274from start to finish, with all the extra frills, whether it thinks it nneds
275to or not. Oh yes: it operates on the current buffer.
276
277@item hfy-link-style-string
278@findex hfy-link-style-string
279@anchor{hfy-link-style-string}
280
281@lisp
282
283(hfy-link-style-string @var{style-string})
284@end lisp
285
286Replace the end of a CSS style declaration @var{style-string} with the contents
287of the variable @ref{hfy-src-doc-link-style}, removing text matching the
288regex @ref{hfy-src-doc-link-unstyle} first, if necessary.
289
290
291@item hfy-prepare-index-i
292@findex hfy-prepare-index-i
293@anchor{hfy-prepare-index-i}
294
295@lisp
296
297(hfy-prepare-index-i @var{srcdir} @var{dstdir} @var{filename} &optional @var{stub} @var{map})
298@end lisp
299
300Prepare a tags index buffer for @var{srcdir}.
301@ref{hfy-tags-cache} must already have an entry for @var{srcdir} for
302this to work. @ref{hfy-page-header}, @ref{hfy-page-footer},
303@ref{hfy-link-extn} and @ref{hfy-extn} all play a part here.
304
305If @var{stub} is set, prepare an (appropriately named) index buffer
306specifically for entries beginning with @var{stub}.
307
308If @var{map} is set, use that instead of @ref{hfy-tags-cache}.
309
310@item hfy-compile-stylesheet
311@findex hfy-compile-stylesheet
312@anchor{hfy-compile-stylesheet}
313
314@lisp
315
316(hfy-compile-stylesheet)
317@end lisp
318
319Trawl the current buffer, construct and return a @ref{hfy-sheet-assoc}.
320
321@item hfy-css-name
322@findex hfy-css-name
323@anchor{hfy-css-name}
324
325@lisp
326
327(hfy-css-name @var{fn})
328@end lisp
329
330Strip some of the boring bits from a font-name and return a CSS style
331name. If @var{fn} is a @code{defface} attribute list, either construct
332a name for it, store it in the cache, and return it, or just fetch it
333from the cache if it's already there.
334
335@item hfy-make-directory
336@findex hfy-make-directory
337@anchor{hfy-make-directory}
338
339@lisp
340
341(hfy-make-directory @var{dir})
342@end lisp
343
344Approximate equivalent of @code{mkdir -p @var{dir}}.
345
346@item hfy-triplet
347@findex hfy-triplet
348@anchor{hfy-triplet}
349
350@lisp
351
352(hfy-triplet @var{color})
353@end lisp
354
355Takes a color name (string) and return a CSS rgb(R, G, B) triplet string.
356Uses the definition of ``white'' to map the numbers to the 0-255 range, so
357if you've redefined white, (especially if you've redefined it to have
358a triplet member lower than that of the color you are processing,
359strange things may happen).
360
361@item hfy-default-footer
362@findex hfy-default-footer
363@anchor{hfy-default-footer}
364
365@lisp
366
367(hfy-default-footer @var{file})
368@end lisp
369
370Default value for @ref{hfy-page-footer}
371
372@item hfy-list-files
373@findex hfy-list-files
374@anchor{hfy-list-files}
375
376@lisp
377
378(hfy-list-files @var{directory})
379@end lisp
380
381Return a list of files under @var{directory}.
382Strips any leading @samp{./} from each filename.
383
384@item hfy-color-vals
385@findex hfy-color-vals
386@anchor{hfy-color-vals}
387
388@lisp
389
390(hfy-color-vals @var{color})
391@end lisp
392
393Where @var{color} is a color name or #XXXXXX style triplet, return a list of
3943 (16 bit) rgb values for said color. If a window system is unavailable,
395calls @ref{hfy-fallback-color-values}.
396
397@item hfy-href-stub
398@findex hfy-href-stub
399@anchor{hfy-href-stub}
400
401@lisp
402
403(hfy-href-stub @var{this-file} @var{def-files} @var{tag})
404@end lisp
405
406Return an href stub for a tag href: if @var{def-files} (list of files
407containing definitions for the tag in question) contains only one entry,
408the href should link straight to that file. Otherwise, the link should
409be to the index file.
410
411We are not yet concerned with the file extensions/tag line number and
412so on at this point.
413
414If @ref{hfy-split-index} is set, and the href will be to an index file
415rather than a source file, append a @samp{.X} to @ref{hfy-index-file}, where
416@samp{X} is the uppercased first character of @var{tag}.
417
418See also: @ref{hfy-relstub}, @ref{hfy-index-file}.
419
420@item hfy-line-number
421@findex hfy-line-number
422@anchor{hfy-line-number}
423
424@lisp
425
426(hfy-line-number)
427@end lisp
428
429Returns the line number of the point in the current buffer.
430
431@item hfy-merge-adjacent-spans
432@findex hfy-merge-adjacent-spans
433@anchor{hfy-merge-adjacent-spans}
434
435@lisp
436
437(hfy-merge-adjacent-spans @var{face-map})
438@end lisp
439
440Where @var{face-map} is a @ref{hfy-facemap-assoc} for the current buffer,
441this function merges adjacent style blocks which are of the same value
442and are separated by nothing more interesting than whitespace.
443
444@code{<span class="foo">narf</span> <span class="foo">brain</span>}
445
446(as interpreted from @var{face-map}) would become:
447
448@code{<span class="foo">narf brain</span>}
449
450Returns a modified copy of @var{face-map} (also a @ref{hfy-facemap-assoc}).
451
452@item hfy-mark-tag-names
453@findex hfy-mark-tag-names
454@anchor{hfy-mark-tag-names}
455
456@lisp
457
458(hfy-mark-tag-names @var{srcdir} @var{file})
459@end lisp
460
461Mark tags in @var{file} (lookup @var{srcdir} in @ref{hfy-tags-cache}) with the
462@code{hfy-anchor} property, with a value of @samp{tag.line-number}.
463
464@item hfy-weight
465@findex hfy-weight
466@anchor{hfy-weight}
467
468@lisp
469
470(hfy-weight @var{weight})
471@end lisp
472
473Derive a font-weight CSS specifier from an Emacs weight specification symbol.
474
475@item hfy-size
476@findex hfy-size
477@anchor{hfy-size}
478
479@lisp
480
481(hfy-size @var{height})
482@end lisp
483
484Derive a CSS font-size specifier from an Emacs font @code{:height} attribute.
485Does not cope with the case where height is a function to be applied to
486the height of the underlying font.
487
488@item hfy-default-header
489@findex hfy-default-header
490@anchor{hfy-default-header}
491
492@lisp
493
494(hfy-default-header @var{file} @var{style})
495@end lisp
496
497Default value for @ref{hfy-page-header}
498
499@item hfy-family
500@findex hfy-family
501@anchor{hfy-family}
502
503@lisp
504
505(hfy-family @var{family})
506@end lisp
507
508Derives a CSS font-family specifier from an Emacs @code{:family} attribute.
509
510@item hfy-mark-tag-hrefs
511@findex hfy-mark-tag-hrefs
512@anchor{hfy-mark-tag-hrefs}
513
514@lisp
515
516(hfy-mark-tag-hrefs @var{srcdir} @var{file})
517@end lisp
518
519Mark href start points with the @code{hfy-link} property (value: href string).
520
521Mark href end points with the @code{hfy-endl} property (value @code{t}).
522
523Avoid overlapping links, and mark links in descending length of
524tag name in order to prevent subtags from usurping supertags;
525e.g., ``term'' for ``terminal'').
526
527@item hfy-box
528@findex hfy-box
529@anchor{hfy-box}
530
531@lisp
532
533(hfy-box @var{box})
534@end lisp
535
536Derive CSS border-* attributes from the Emacs @code{:box} attribute.
537
538@item hfy-box-to-style
539@findex hfy-box-to-style
540@anchor{hfy-box-to-style}
541
542@lisp
543
544(hfy-box-to-style @var{spec})
545@end lisp
546
547Convert a complex @code{:box} Emacs font attribute set to a list of
548CSS border-* attributes. Don't call this directly---it is called by
549@ref{hfy-box} when necessary.
550
551@item hfy-html-enkludge-buffer
552@findex hfy-html-enkludge-buffer
553@anchor{hfy-html-enkludge-buffer}
554
555@lisp
556
557(hfy-html-enkludge-buffer)
558@end lisp
559
560Mark dangerous @samp{["<>]} characters with the @code{hfy-quoteme} property.
561
562See also @ref{hfy-html-dekludge-buffer}.
563
564@item hfy-buffer
565@findex hfy-buffer
566@anchor{hfy-buffer}
567
568@lisp
569
570(hfy-buffer)
571@end lisp
572
573Generate and return an Htmlfontify html output buffer for the current
574buffer. May trample an existing buffer.
575
576@item hfy-fontified-p
577@findex hfy-fontified-p
578@anchor{hfy-fontified-p}
579
580@lisp
581
582(hfy-fontified-p)
583@end lisp
584
585@code{font-lock} doesn't like to say a buffer's been fontified when in
586batch mode, but we want to know if we should fontify or raw copy, so in
587batch mode we check for non-default face properties. Otherwise we test
588@code{font-lock-mode} and @code{font-lock-fontified} for truth.
589
590@item hfy-lookup
591@findex hfy-lookup
592@anchor{hfy-lookup}
593
594@lisp
595
596(hfy-lookup @var{face} @var{style})
597@end lisp
598
599Where @var{style} is a @ref{hfy-sheet-assoc} and @var{face} is an Emacs face,
600return the relevant @var{css} style name.
601
602@item hfy-fontify-buffer
603@findex hfy-fontify-buffer
604@anchor{hfy-fontify-buffer}
605
606@lisp
607
608(hfy-fontify-buffer &optional @var{srcdir} @var{file})
609@end lisp
610
611Implement the guts of @ref{htmlfontify-buffer}.
612
613@item hfy-color
614@findex hfy-color
615@anchor{hfy-color}
616
617@lisp
618
619(hfy-color @var{color})
620@end lisp
621
622Convert an Emacs :foreground property to a CSS color property.
623
624@item hfy-flatten-style
625@findex hfy-flatten-style
626@anchor{hfy-flatten-style}
627
628@lisp
629
630(hfy-flatten-style @var{style})
631@end lisp
632
633Take @var{style} (see @ref{hfy-face-to-style-i}, @ref{hfy-face-to-style})
634and merge any multiple attributes appropriately. Currently only font-size is
635merged down to a single occurrence---others may need special handling, but I
636haven't encountered them yet. Returns a @ref{hfy-style-assoc}.
637
638@item hfy-size-to-int
639@findex hfy-size-to-int
640@anchor{hfy-size-to-int}
641
642@lisp
643
644(hfy-size-to-int @var{spec})
645@end lisp
646
647Convert @var{spec}, a CSS font-size specifier, back to an Emacs
648@code{:height} attribute value. Used while merging multiple font-size
649attributes.
650
651@item hfy-sprintf-stylesheet
652@findex hfy-sprintf-stylesheet
653@anchor{hfy-sprintf-stylesheet}
654
655@lisp
656
657(hfy-sprintf-stylesheet @var{css} @var{file})
658@end lisp
659
660Generates a header, via @ref{hfy-page-header}, for @var{file}, containing the
661stylesheet derived from @var{css}, which is a @ref{hfy-sheet-assoc}. Returns a
662string containing the same.
663
664@item hfy-relstub
665@findex hfy-relstub
666@anchor{hfy-relstub}
667
668@lisp
669
670(hfy-relstub @var{file} &optional @var{start})
671@end lisp
672
673Return a @samp{../} stub of the appropriate length for the current source
674tree depth (as determined from @var{file}). @c iyswim.
675
676@item hfy-compile-face-map
677@findex hfy-compile-face-map
678@anchor{hfy-compile-face-map}
679
680@lisp
681
682(hfy-compile-face-map)
683@end lisp
684
685Compile and return a @ref{hfy-facemap-assoc} for the current buffer.
686
687@item hfy-prepare-index
688@findex hfy-prepare-index
689@anchor{hfy-prepare-index}
690
691@lisp
692
693(hfy-prepare-index @var{srcdir} @var{dstdir})
694@end lisp
695
696Return as list of index buffer(s), as determined by @ref{hfy-split-index}.
697Uses @ref{hfy-prepare-index-i} to do this.
698
699@item hfy-prepare-tag-map
700@findex hfy-prepare-tag-map
701@anchor{hfy-prepare-tag-map}
702
703@lisp
704
705(hfy-prepare-tag-map @var{srcdir} @var{dstdir})
706@end lisp
707
708Prepare the counterpart(s) to the index buffer(s)---a list of buffers with
709the same structure, but listing (and linking to) instances of tags (as
710opposed to their definitions).
711
712See also: @ref{hfy-prepare-index}, @ref{hfy-split-index}
713
714@item hfy-subtract-maps
715@findex hfy-subtract-maps
716@anchor{hfy-subtract-maps}
717
718@lisp
719
720(hfy-subtract-maps @var{srcdir})
721@end lisp
722
723Internal function---strips definitions of tags from the instance map.
724See: @ref{hfy-tags-cache} and @ref{hfy-tags-rmap}
725
726@item hfy-face-to-style-i
727@findex hfy-face-to-style-i
728@anchor{hfy-face-to-style-i}
729
730@lisp
731
732(hfy-face-to-style-i @var{fn})
733@end lisp
734
735The guts of @ref{hfy-face-to-style}. @var{fn} should be a @code{defface}
736font specification, as returned by @code{face-attr-construct} or
737@ref{hfy-face-attr-for-class}. Note that this function does not get
738font-sizes right if they are based on inherited modifiers (via the
739:inherit) attribute, and any other modifiers that are cumulative if they
740appear multiple times need to be merged by the user---@ref{hfy-flatten-style}
741should do this.
742
743@item hfy-face-to-css
744@findex hfy-face-to-css
745@anchor{hfy-face-to-css}
746
747@lisp
748
749(hfy-face-to-css @var{fn})
750@end lisp
751
752Take @var{fn}, a font or @code{defface} specification (c.f.
753@code{face-attr-construct}) and return a CSS style specification.
754
755See also: @ref{hfy-face-to-style}
756
757@item hfy-html-quote
758@findex hfy-html-quote
759@anchor{hfy-html-quote}
760
761@lisp
762
763(hfy-html-quote @var{char-string})
764@end lisp
765
766Map a string (usually 1 character long) to an html safe string
767(entity) if need be.
768
769@item hfy-link-style
770@findex hfy-link-style
771@anchor{hfy-link-style}
772
773@lisp
774
775(hfy-link-style @var{style-string})
776@end lisp
777
778Convert the CSS style spec @var{style-string} to its equivalent
779hyperlink style.
780
781See: @ref{hfy-link-style-fun}.
782
783@item hfy-p-to-face
784@findex hfy-p-to-face
785@anchor{hfy-p-to-face}
786
787@lisp
788
789(hfy-p-to-face @var{props})
790@end lisp
791
792Given @var{props}, a list of text-properties, return the value of the
793face property, or nil.
794
795@item hfy-box-to-border-assoc
796@findex hfy-box-to-border-assoc
797@anchor{hfy-box-to-border-assoc}
798
799@lisp
800
801(hfy-box-to-border-assoc @var{spec})
802@end lisp
803
804Helper function for @ref{hfy-box-to-style}.
805
806@item hfy-face-attr-for-class
807@findex hfy-face-attr-for-class
808@anchor{hfy-face-attr-for-class}
809
810@lisp
811
812(hfy-face-attr-for-class @var{face} &optional @var{class})
813@end lisp
814
815Return the face attributes for @var{face}. If @var{class} is set, it
816must be a @code{defface} alist key [see below]. Prior to version 0.18,
817the first face specification returned by @ref{hfy-combined-face-spec}
818which @emph{didn't} clash with @var{class} was returned. In versions
819from 0.18 onwards, each font attribute list is scored, and the
820non-conflicting list with the highest score is returned. (A specification
821with a class of @code{t} is considered to match any class you specify.
822This matches Emacs's behaviour when deciding on which face attributes to
823use, to the best of my understanding ).
824
825If @var{class} is nil, then you just get get whatever
826@code{face-attr-construct} returns; i.e., the current specification in
827effect for @var{face}.
828
829See @ref{hfy-display-class} for details of valid values for @var{class}.
830
831@item hfy-face-at
832@findex hfy-face-at
833@anchor{hfy-face-at}
834
835@lisp
836
837(hfy-face-at P)
838@end lisp
839
840Find face in effect at point P. If overlays are to be considered
841(see @ref{hfy-optimisations}) then this may return a @code{defface} style
842list of face properties instead of a face symbol.
843
844@item hfy-bgcol
845@findex hfy-bgcol
846@anchor{hfy-bgcol}
847
848@lisp
849
850(hfy-bgcol @var{color})
851@end lisp
852
853As per @ref{hfy-color} but for background colors.
854
855@item hfy-kludge-cperl-mode
856@findex hfy-kludge-cperl-mode
857@anchor{hfy-kludge-cperl-mode}
858
859@lisp
860
861(hfy-kludge-cperl-mode)
862@end lisp
863
864cperl mode does its damndest not to do some of its fontification when not
865in a windowing system---we try to trick it@dots{}
866
867@item hfy-href
868@findex hfy-href
869@anchor{hfy-href}
870
871@lisp
872
873(hfy-href @var{this-file} @var{def-files} @var{tag} @var{tag-map})
874@end lisp
875
876Return a relative href to the tag in question, based on
877
878@var{this-file} @ref{hfy-link-extn} @ref{hfy-extn} @var{def-files} @var{tag} and @var{tag-map}
879
880@var{this-file} is the current source file
881@var{def-files} is a list of file containing possible link endpoints for @var{tag}
882@var{tag} is the @var{tag} in question
883@var{tag-map} is the entry in @ref{hfy-tags-cache}.
884
885@item hfy-shell
886@findex hfy-shell
887@anchor{hfy-shell}
888
889@lisp
890
891(hfy-shell)
892@end lisp
893
894Returns a best guess at a Bourne compatible shell to use: If the current
895shell doesn't look promising, fall back to @ref{hfy-shell-file-name}.
896
897@item hfy-load-tags-cache
898@findex hfy-load-tags-cache
899@anchor{hfy-load-tags-cache}
900
901@lisp
902
903(hfy-load-tags-cache @var{srcdir})
904@end lisp
905
906Run @ref{hfy-etags-cmd} on @var{srcdir}: load @ref{hfy-tags-cache} and @ref{hfy-tags-sortl}.
907
908@item hfy-parse-tags-buffer
909@findex hfy-parse-tags-buffer
910@anchor{hfy-parse-tags-buffer}
911
912@lisp
913
914(hfy-parse-tags-buffer @var{srcdir} @var{buffer})
915@end lisp
916
917Parse a @var{buffer} containing etags formatted output, loading the
918@ref{hfy-tags-cache} and @ref{hfy-tags-sortl} entries for @var{srcdir}.
919
920@item hfy-interq
921@findex hfy-interq
922@anchor{hfy-interq}
923
924@lisp
925
926(hfy-interq @var{set-a} @var{set-b})
927@end lisp
928
929Return the intersection (using @code{eq}) of 2 lists.
930
931@item hfy-text-p
932@findex hfy-text-p
933@anchor{hfy-text-p}
934
935@lisp
936
937(hfy-text-p @var{srcdir} @var{file})
938@end lisp
939
940Is @var{srcdir}/@var{file} text? Uses @ref{hfy-istext-command} to determine this.
941
942@item hfy-opt
943@findex hfy-opt
944@anchor{hfy-opt}
945
946@lisp
947
948(hfy-opt @var{symbol})
949@end lisp
950
951Is @ref{hfy-optimisations} member @var{symbol} set or not?
952
953@item hfy-dirname
954@findex hfy-dirname
955@anchor{hfy-dirname}
956
957@lisp
958
959(hfy-dirname @var{file})
960@end lisp
961
962Return everything preceding the last @samp{/} from a relative filename,
963on the assumption that this will produce a relative directory name. Hardly
964bombproof, but good enough in the context in which it is being used.
965
966@item hfy-html-dekludge-buffer
967@findex hfy-html-dekludge-buffer
968@anchor{hfy-html-dekludge-buffer}
969
970@lisp
971
972(hfy-html-dekludge-buffer)
973@end lisp
974
975Transform all dangerous characters marked with the @code{hfy-quoteme} property
976using @ref{hfy-html-quote}
977
978See also @ref{hfy-html-enkludge-buffer}.
979
980@item hfy-copy-and-fontify-file
981@findex hfy-copy-and-fontify-file
982@anchor{hfy-copy-and-fontify-file}
983
984@lisp
985
986(hfy-copy-and-fontify-file @var{srcdir} @var{dstdir} @var{file})
987@end lisp
988
989Open @var{file} in @var{srcdir}---if fontified, write a fontified copy to @var{dstdir}
990adding an extension of @ref{hfy-extn}. Fontification is actually done by
991@ref{htmlfontify-buffer}. If the buffer is not fontified, just copy it.
992
993@item hfy-decor
994@findex hfy-decor
995@anchor{hfy-decor}
996
997@lisp
998
999(hfy-decor @var{tag} @var{val})
1000@end lisp
1001
1002Derive CSS text-decoration specifiers from various Emacs font attributes.
1003
1004@item hfy-slant
1005@findex hfy-slant
1006@anchor{hfy-slant}
1007
1008@lisp
1009
1010(hfy-slant @var{slant})
1011@end lisp
1012
1013Derive a font-style CSS specifier from the Emacs :slant
1014attribute---CSS does not define the reverse-* styles, so just maps
1015those to the regular specifiers.
1016
1017@item hfy-tags-for-file
1018@findex hfy-tags-for-file
1019@anchor{hfy-tags-for-file}
1020
1021@lisp
1022
1023(hfy-tags-for-file @var{srcdir} @var{file})
1024@end lisp
1025
1026List of etags tags that have definitions in this @var{file}. Looks up
1027the tags cache in @ref{hfy-tags-cache} using @var{srcdir} as the key.
1028
1029@item hfy-width
1030@findex hfy-width
1031@anchor{hfy-width}
1032
1033@lisp
1034
1035(hfy-width @var{width})
1036@end lisp
1037
1038Convert an Emacs @code{:width} attribute to a CSS font-stretch attribute.
1039
1040@comment /AUTOGENERATED BLOCK
1041@end table
1042
1043@node Variables
1044@section Variables
1045@cindex variables
1046
1047Important variables that are not customisation items:
1048
1049@table @code
1050
1051@item hfy-tags-cache
1052@vindex hfy-tags-cache
1053@anchor{hfy-tags-cache}
1054
1055This is an alist of the form:
1056
1057@example
1058(("/src/dir/0" . tag-hash0) ("/src/dir/1" tag-hash1) @dots{} )
1059@end example
1060
1061Each tag hash entry then contains entries of the form:
1062
1063@example
1064"tag_string" => (("file/name.ext" line char) @dots{} )
1065@end example
1066
1067i.e., an alist mapping (relative) file paths to line and character offsets.
1068
1069See @ref{hfy-load-tags-cache}.
1070
1071@item hfy-tags-rmap
1072@vindex hfy-tags-rmap
1073@anchor{hfy-tags-rmap}
1074
1075@code{hfy-tags-rmap} is an alist of the form:
1076
1077@lisp
1078(("/src/dir" . tag-rmap-hash))
1079@end lisp
1080
1081Where tag-rmap-hash has entries of the form:
1082
1083@example
1084"tag_string" => ( "file/name.ext" line char )
1085@end example
1086
1087Unlike @ref{hfy-tags-cache} these are the locations of occurrences of
1088tagged items, not the locations of their definitions.
1089
1090@item hfy-tags-sortl
1091@vindex hfy-tags-sortl
1092@anchor{hfy-tags-sortl}
1093
1094@code{hfy-tags-sortl} is an alist of the form:
1095
1096@example
1097(("/src/dir" . (tag0 tag1 tag2)) @dots{} )
1098@end example
1099
1100Where the tags are stored in descending order of length.
1101
1102See: @ref{hfy-load-tags-cache}.
1103
1104@end table
1105
1106@node Data Structures
1107@section Data Structures
1108@cindex Data Structures
1109
1110Some of the (informal) data structures used in Htmlfontify are detailed here:
1111
1112@table @code
1113
1114@item hfy-style-assoc
1115@cindex hfy-style-assoc
1116@anchor{hfy-style-assoc}
1117
1118An assoc representing/describing an Emacs face. Properties may be repeated,
1119in which case later properties should be treated as if they were inherited
1120from a ``parent'' font. (For some properties, only the first encountered value
1121is of any importance, for others the values might be cumulative, and for
1122others they might be cumulative in a complex way.)
1123
1124Some examples:
1125
1126@lisp
1127(hfy-face-to-style 'default) =>
1128
1129 (("background" . "rgb(0, 0, 0)" )
1130 ("color" . "rgb(255, 255, 255)")
1131 ("font-style" . "normal" )
1132 ("font-weight" . "500" )
1133 ("font-stretch" . "normal" )
1134 ("font-family" . "misc-fixed" )
1135 ("font-size" . "13pt" )
1136 ("text-decoration" . "none" ))
1137
1138(hfy-face-to-style 'Info-title-3-face) =>
1139
1140 (("font-weight" . "700" )
1141 ("font-family" . "helv" )
1142 ("font-size" . "120%" )
1143 ("text-decoration" . "none") )
1144@end lisp
1145
1146@item hfy-sheet-assoc
1147@cindex hfy-sheet-assoc
1148@anchor{hfy-sheet-assoc}
1149
1150An assoc with elements of the form @samp{(face-name style-name . style-string)}.
1151The actual stylesheet for each page is derived from one of these.
1152
1153@lisp
1154'((default "default" . "@{ background: black; color: white@}")
1155 (font-lock-string-face "string" . "@{ color: rgb(64,224,208) @}"))
1156@end lisp
1157
1158@item hfy-facemap-assoc
1159@cindex hfy-facemap-assoc
1160@anchor{hfy-facemap-assoc}
1161
1162An assoc of @code{(point . @var{face-symbol})} or
1163@code{(point . @code{defface} attribute list)} and @code{(point
1164. end)} elements, in descending order of point value (i.e., from the
1165file's end to its beginning). The map is in reverse order because
1166inserting a @samp{<style>} tag (or any other string) at @var{point}
1167invalidates the map for all entries with a greater value of point. By
1168traversing the map from greatest to least @var{point}, we still
1169invalidate the map as we go, but only those points we have already
1170dealt with (and therefore no longer care about) will be invalid at any
1171time.
1172
1173@lisp
1174'((64820 . end)
1175 (64744 . font-lock-comment-face)
1176 (64736 . end)
1177 (64722 . font-lock-string-face)
1178 (64630 . end)
1179 (64623 . font-lock-string-face)
1180 (64449 . end)
1181 ;; Big similar section elided. You get the idea.
1182 (5459 . end)
1183 (5431 . (:inherit font-lock-keyword-face :background "7e7e7e"))
1184 (5431 . end)
1185 (4285 . font-lock-constant-face)
1186 (4285 . end)
1187 (4221 . font-lock-comment-face)
1188 (4221 . end)
1189 (4197 . font-lock-constant-face)
1190 (4197 . end)
1191 (1 . font-lock-comment-face))
1192@end lisp
1193
1194@end table
1195
1196@node Examples
1197@section Examples
1198@cindex Examples
1199
1200The following is a lump of code I use to fontify source code on my
1201site, @url{http://rtfm.etla.org/} (which was the reason, incidentally,
1202that Htmlfontify was written in the first place).
1203
1204@lisp
1205(defvar rtfm-section nil)
1206
1207;; Constructs an appropriate header string to fit in with rtfm's
1208;; templating system, based on the file and the stylesheet string
1209(defun rtfm-build-page-header (file style)
1210 (format "#define TEMPLATE red+black.html
1211#define DEBUG 1
1212#include <build/menu-dirlist|>\n
1213html-css-url := /css/red+black.css
1214title := rtfm.etla.org ( %s / src/%s )
1215bodytag :=
1216head <=STYLESHEET;\n
1217%s
1218STYLESHEET
1219main-title := rtfm / %s / src/%s\n
1220main-content <=MAIN_CONTENT;\n" rtfm-section file style rtfm-section file))
1221
1222;; the footer:
1223(defun rtfm-build-page-footer (file) "\nMAIN_CONTENT\n")
1224
1225(defun rtfm-fontify-buffer (section)
1226 (interactive "s section[eg- emacs / p4-blame]: ")
1227 (require 'htmlfontify)
1228 (let ((hfy-page-header 'rtfm-build-page-header)
1229 (hfy-page-footer 'rtfm-build-page-footer)
1230 (rtfm-section section))
1231 (htmlfontify-buffer)
1232 )
1233 )
1234
1235;; Here's the function I actually call---it asks me for a section label,
1236;; and source and destination directories, and then binds a couple of
1237;; customisation variable in a let before calling htmlfontify:
1238(defun rtfm-build-source-docs (section srcdir destdir)
1239 (interactive
1240 "s section[eg- emacs / p4-blame]:\nD source-dir: \nD output-dir: ")
1241 (require 'htmlfontify)
1242 (hfy-load-tags-cache srcdir)
1243 (let ((hfy-page-header 'rtfm-build-page-header)
1244 (hfy-page-footer 'rtfm-build-page-footer)
1245 (rtfm-section section)
1246 (hfy-index-file "index")
1247 (auto-mode-alist (append auto-mode-alist
1248 '(("dbi\\(shell\\|gtk\\)$" . cperl-mode)
1249 ("\\.xpm$" . c-mode ))))
1250 )
1251 (htmlfontify-run-etags srcdir)
1252 (htmlfontify-copy-and-link-dir srcdir destdir ".src" ".html")))
1253@end lisp
1254
1255@node Customisation
1256@chapter Customisation
1257@cindex variables (customisation)
1258
1259Htmlfontify provides the following variable and customisation entries:
1260
1261@table @code
1262@comment AUTOGENERATED BLOCK
1263
1264@item hfy-link-style-fun
1265@vindex hfy-link-style-fun
1266@anchor{hfy-link-style-fun}
1267
1268Set this to a function, which will be called with one argument
1269(a @samp{@{ foo: bar; @dots{}@}} CSS style-string)---it should return a copy of
1270its argument, altered so as to make any changes you want made for text which
1271is a hyperlink, in addition to being in the class to which that style would
1272normally be applied.
1273
1274@item hfy-html-quote-regex
1275@vindex hfy-html-quote-regex
1276@anchor{hfy-html-quote-regex}
1277
1278Regex to match (with a single back-reference per match) strings in HTML
1279which should be quoted with @ref{hfy-html-quote}
1280(and @pxref{hfy-html-quote-map}) to make them safe.
1281
1282@item hfy-page-footer
1283@vindex hfy-page-footer
1284@anchor{hfy-page-footer}
1285
1286As @ref{hfy-page-header}, but generates the output footer
1287(and takes only 1 argument, the filename).
1288
1289@item hfy-display-class
1290@vindex hfy-display-class
1291@anchor{hfy-display-class}
1292
1293Display class to use to determine which display class to use when
1294calculating a face's attributes. This is useful when, for example, you
1295are running Emacs on a tty or in batch mode, and want Htmlfontify to have
1296access to the face spec you would use if you were connected to an X display.
1297
1298Some valid class specification elements are:
1299
1300@lisp
1301 '(class color)
1302 '(class grayscale)
1303 '(background dark)
1304 '(background light)
1305 '(type x-toolkit)
1306 '(type tty)
1307 '(type motif)
1308 '(type lucid)
1309@end lisp
1310
1311Multiple values for a tag may be combined, to indicate that any one or more
1312of these values in the specification key constitutes a match, eg:
1313
1314'((class color grayscale) (type tty)) would match any of:
1315@lisp
1316 '((class color))
1317 '((class grayscale))
1318 '((class color grayscale)))
1319 '((class color foo))
1320 '((type tty))
1321 '((type tty) (class color))
1322@end lisp
1323and so on.
1324
1325@item hfy-page-header
1326@vindex hfy-page-header
1327@anchor{hfy-page-header}
1328
1329Function called with two arguments (the filename relative to the top
1330level source directory being etag'd and fontified), and a string containing
1331the @samp{<style>@dots{}</style>} text to embed in the document---the string
1332returned will be used as the header for the htmlfontified version of
1333the source file.
1334
1335See also: @ref{hfy-page-footer}
1336
1337@item hfy-src-doc-link-style
1338@vindex hfy-src-doc-link-style
1339@anchor{hfy-src-doc-link-style}
1340
1341String to add to the @samp{<style> a} variant of an Htmlfontify CSS class.
1342
1343@item hfy-fast-lock-save
1344@vindex hfy-fast-lock-save
1345@anchor{hfy-fast-lock-save}
1346
1347Minimum size of a buffer for cached fontification.
1348This value is temporarily assigned to @code{fast-lock-minimum-size} during
1349html-fontification.
1350
1351Only buffers more than this can have associated Font Lock cache files saved.
1352
1353If nil, means cache files are never created.
1354
1355If a list, each element should be a cons pair of the form
1356@code{(@var{major-mode} . @var{size})}, where @var{major-mode}
1357is a symbol or t (meaning the default). For example:
1358
1359@lisp
1360 ((c-mode . 25600 )
1361 (c++-mode . 25600 )
1362 (rmail-mode . 1048576))
1363@end lisp
1364
1365means that the minimum size is 25K for buffers in C or C++ modes, one megabyte
1366for buffers in Rmail mode, and size is irrelevant (i.e., no saves) otherwise.
1367
1368@item hfy-split-index
1369@vindex hfy-split-index
1370@anchor{hfy-split-index}
1371
1372Whether or not to split the index @ref{hfy-index-file} alphabetically
1373on the first letter of each tag. Useful when the index would otherwise
1374be large and take a long time to render or be difficult to navigate.
1375
1376@item hfy-find-cmd
1377@vindex hfy-find-cmd
1378@anchor{hfy-find-cmd}
1379
1380``find'' command used to harvest a list of files to attempt to fontify.
1381
1382@item hfy-extn
1383@vindex hfy-extn
1384@anchor{hfy-extn}
1385
1386File extension used for output files
1387
1388@item hfy-default-face-def
1389@vindex hfy-default-face-def
1390@anchor{hfy-default-face-def}
1391
1392Fallback @code{defface} specification for the face @code{default}, used
1393when @ref{hfy-display-class} has been set (the normal Htmlfontify way of
1394extracting potentially non-current face information doesn't necessarily
1395work for @code{default}).
1396
1397For example, I customise this to:
1398
1399@lisp
1400((t :background "black" :foreground "white" :family "misc-fixed"))
1401@end lisp
1402
1403@item hfy-init-kludge-hooks
1404@vindex hfy-init-kludge-hooks
1405@anchor{hfy-init-kludge-hooks}
1406
1407List of functions to call when starting htmlfontify-buffer to do any
1408kludging necessary to get highlighting modes to bahave as you want, even
1409when not running under a window system.
1410
1411@item hfy-shell-file-name
1412@vindex hfy-shell-file-name
1413@anchor{hfy-shell-file-name}
1414
1415Should be set to a Bourne compatible shell, which will be invoked
1416for the more complex shell interactions needed by Htmlfontify.
1417Currently this is only required/used when using GNU etags, see
1418@ref{hfy-etags-cmd-alist} for details.
1419
1420@item hfy-optimisations
1421@vindex hfy-optimisations
1422@anchor{hfy-optimisations}
1423
1424Optimisations to turn on. So far, the following have been implemented:
1425
1426@table @option
1427@item merge-adjacent-tags
1428If two (or more) span tags are adjacent, identical and separated by nothing
1429more than whitespace, they will be merged into one span.
1430
1431@item zap-comment-links
1432Suppress hyperlinking of tags found in comments.
1433
1434@item zap-string-links
1435Suppress hyperlinking of tags found in strings.
1436
1437@item div-wrapper
1438Add @samp{<div class="default"> </div>} tags around the fontified body.
1439(Some people like this because they cut and paste the html into
1440a page with different colors than the fontified code.)
1441
1442@item keep-overlays
1443Preserve overlay highlighting (c.f. @code{ediff} or @code{goo-font-lock})
1444as well as basic faces. Can result in extremely verbose highlighting
1445if there are many overlays (as is the case with @code{goo-font-lock}).
1446
1447@end table
1448
1449And the following are planned but not yet available:
1450
1451@table @option
1452@item kill-context-leak
1453Suppress hyperlinking between files highlighted by different modes.
1454
1455@end table
1456
1457Note: like compiler optimisations, these optimise the _output_ of the code,
1458not the processing of the source itself, and are therefore likely to slow
1459Htmlfontify down, at least a little. Except for skip-refontification,
1460which can never slow you down, but may result in incomplete fontification.
1461
1462@item hfy-src-doc-link-unstyle
1463@vindex hfy-src-doc-link-unstyle
1464@anchor{hfy-src-doc-link-unstyle}
1465
1466Regex to remove from the <style> a variant of an Htmlfontify CSS class.
1467
1468@item hfy-link-extn
1469@vindex hfy-link-extn
1470@anchor{hfy-link-extn}
1471
1472File extension used for href links---useful where the Htmlfontify
1473output files are going to be processed again, with a rersulting change
1474in file extension. If @code{nil}, then any code using this should fall back
1475to @ref{hfy-extn}.
1476
1477@item hfy-istext-command
1478@vindex hfy-istext-command
1479@anchor{hfy-istext-command}
1480
1481Command to run with the name of a file, to see whether it is a text file
1482or not. The command should emit a string containing the word @samp{text} if
1483the file is a text file, and a string not containing @samp{text} otherwise.
1484
1485@item hfy-etags-cmd-alist
1486@vindex hfy-etags-cmd-alist
1487@anchor{hfy-etags-cmd-alist}
1488
1489An alist of possible shell commands that will generate etags output that
1490Htmlfontify can use. @samp{%s} will be replaced by @ref{hfy-etags-bin}.
1491
1492@item hfy-etags-bin
1493@vindex hfy-etags-bin
1494@anchor{hfy-etags-bin}
1495
1496The location of the etags binary (we begin by assuming it's in your path).
1497
1498Note that if etags is not in your path, you will need to alter the shell
1499commands in @ref{hfy-etags-cmd-alist}.
1500
1501[As of version 0.17, this requirement has been removed: it should
1502 all just work(tm).]
1503
1504@item hfy-etags-cmd
1505@vindex hfy-etags-cmd
1506@anchor{hfy-etags-cmd}
1507
1508An etags shell command to run in the source directory to generate a tags
1509file for the whole source tree from there on down. The command should emit
1510the etags output on standard output.
1511
1512Two canned commands are provided---they drive Emacs's etags and
1513exuberant-ctags's etags respectively.
1514
1515@item hfy-etag-regex
1516@vindex hfy-etag-regex
1517@anchor{hfy-etag-regex}
1518
1519Regex used to parse an etags entry: must have 3 subexps, corresponding,
1520in order, to:
1521
1522@enumerate
1523@item
1524The tag
1525@item
1526The line
1527@item
1528The character (point) at which the tag occurs
1529@end enumerate
1530
1531@item hfy-index-file
1532@vindex hfy-index-file
1533@anchor{hfy-index-file}
1534
1535Name (sans extension) of the index file produced during
1536fontification-and-hyperlinking.
1537
1538@item hfy-instance-file
1539@vindex hfy-instance-file
1540@anchor{hfy-instance-file}
1541
1542Name (sans extension) of the tag usage index file produced during
1543fontification-and-hyperlinking.
1544
1545@item hfy-html-quote-map
1546@vindex hfy-html-quote-map
1547@anchor{hfy-html-quote-map}
1548
1549An alist of character -> entity mappings used to make the text html-safe.
1550
1551@comment /AUTOGENERATED BLOCK
1552@end table
1553
1554@node Requirements
1555@chapter Requirements
1556@cindex Requirements, Prerequisites
1557
1558Htmlfontify has a couple of external requirements:
1559
1560@itemize @bullet
1561
1562@item
1563GNU Emacs 20.7+ or 21.1+
1564
1565Other versions may work---these have been used successfully by the
1566author. If you intend to use Htmlfontify in batch mode, 21.1+ is
1567pretty much required. The author does not know if XEmacs, NTemacs,
1568or J.Random Emacs will run Htmlfontify, but reports/patches/bags of
1569money are always welcome.
1570
1571@item
1572A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts
1573to autodetect the version you have and customise itself accordingly,
1574but you should be able to override this.
1575
1576See: @ref{Customisation}
1577
1578@item
1579A copy of find (e.g., GNU find) that provides the @code{-path} predicate.
1580
1581You may be able to work around this with a suitable clever shell
1582command and the customisation entry: @ref{hfy-find-cmd}
1583
1584@item
1585A copy of sed (e.g., GNU sed).
1586
1587@item
1588A copy of the @code{file} command.
1589
1590@end itemize
1591
1592@node GNU Free Documentation License
1593@appendix GNU Free Documentation License
1594@include doclicense.texi
1595
1596@node Index
1597@unnumbered Index
1598
1599@table @var
1600@item Concepts
1601@printindex cp
1602
1603@item Functions
1604@printindex fn
1605
1606@item Variables & Customisation
1607@printindex vr
1608
1609@end table
1610
1611@setchapternewpage odd
1612@bye
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index 436fa28b1fb..a756cc6b6c6 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -22,7 +22,7 @@ Emacs, and interacting with an IDL shell run as a subprocess.
22This is edition @value{EDITION} of the IDLWAVE User Manual for IDLWAVE 22This is edition @value{EDITION} of the IDLWAVE User Manual for IDLWAVE
23@value{VERSION}. 23@value{VERSION}.
24 24
25Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. 25Copyright @copyright{} 1999--2013 Free Software Foundation, Inc.
26 26
27@quotation 27@quotation
28Permission is granted to copy, distribute and/or modify this document 28Permission is granted to copy, distribute and/or modify this document
@@ -33,8 +33,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
33is included in the section entitled ``GNU Free Documentation License''. 33is included in the section entitled ``GNU Free Documentation License''.
34 34
35(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 35(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
36modify this GNU manual. Buying copies from the FSF supports it in 36modify this GNU manual.''
37developing GNU and promoting software freedom.''
38@end quotation 37@end quotation
39@end copying 38@end copying
40 39
@@ -56,7 +55,7 @@ developing GNU and promoting software freedom.''
56@contents 55@contents
57 56
58@ifnottex 57@ifnottex
59@node Top, Introduction, (dir), (dir) 58@node Top
60@top IDLWAVE 59@top IDLWAVE
61 60
62IDLWAVE is a package which supports editing source code written in the 61IDLWAVE is a package which supports editing source code written in the
@@ -85,9 +84,9 @@ Interactive Data Language (IDL), and running IDL as an inferior shell.
85 84
86Getting Started (Tutorial) 85Getting Started (Tutorial)
87 86
88* Lesson I -- Development Cycle:: 87* Lesson I---Development Cycle::
89* Lesson II -- Customization:: 88* Lesson II---Customization::
90* Lesson III -- User Catalog:: 89* Lesson III---User Catalog::
91 90
92The IDLWAVE Major Mode 91The IDLWAVE Major Mode
93 92
@@ -166,7 +165,7 @@ Catalogs
166@end detailmenu 165@end detailmenu
167@end menu 166@end menu
168 167
169@node Introduction, IDLWAVE in a Nutshell, Top, Top 168@node Introduction
170@chapter Introduction 169@chapter Introduction
171@cindex Introduction 170@cindex Introduction
172@cindex CORBA (Common Object Request Broker Architecture) 171@cindex CORBA (Common Object Request Broker Architecture)
@@ -264,7 +263,7 @@ had to be renamed because of a name space conflict with CORBA's
264@code{idl-mode}, defined in Emacs in the file @file{cc-mode.el}. 263@code{idl-mode}, defined in Emacs in the file @file{cc-mode.el}.
265 264
266In this manual, each section ends with a list of related user options. 265In this manual, each section ends with a list of related user options.
267Don't be confused by the sheer number of options available --- in most 266Don't be confused by the sheer number of options available: in most
268cases the default settings are just fine. The variables are listed here 267cases the default settings are just fine. The variables are listed here
269to make sure you know where to look if you want to change anything. For 268to make sure you know where to look if you want to change anything. For
270a full description of what a particular variable does and how to 269a full description of what a particular variable does and how to
@@ -272,7 +271,7 @@ configure it, see the documentation string of that variable (available
272with @kbd{C-h v}). Some configuration examples are also given in the 271with @kbd{C-h v}). Some configuration examples are also given in the
273appendix. 272appendix.
274 273
275@node IDLWAVE in a Nutshell, Getting Started, Introduction, Top 274@node IDLWAVE in a Nutshell
276@chapter IDLWAVE in a Nutshell 275@chapter IDLWAVE in a Nutshell
277@cindex Summary of important commands 276@cindex Summary of important commands
278@cindex IDLWAVE in a Nutshell 277@cindex IDLWAVE in a Nutshell
@@ -366,19 +365,19 @@ at point.
366<A NAME="TUTORIAL"></A> 365<A NAME="TUTORIAL"></A>
367@end html 366@end html
368 367
369@node Getting Started, The IDLWAVE Major Mode, IDLWAVE in a Nutshell, Top 368@node Getting Started
370@chapter Getting Started (Tutorial) 369@chapter Getting Started (Tutorial)
371@cindex Quick-Start 370@cindex Quick-Start
372@cindex Tutorial 371@cindex Tutorial
373@cindex Getting Started 372@cindex Getting Started
374 373
375@menu 374@menu
376* Lesson I -- Development Cycle:: 375* Lesson I---Development Cycle::
377* Lesson II -- Customization:: 376* Lesson II---Customization::
378* Lesson III -- User Catalog:: 377* Lesson III---User Catalog::
379@end menu 378@end menu
380 379
381@node Lesson I -- Development Cycle, Lesson II -- Customization, Getting Started, Getting Started 380@node Lesson I---Development Cycle
382@section Lesson I: Development Cycle 381@section Lesson I: Development Cycle
383 382
384The purpose of this tutorial is to guide you through a very basic 383The purpose of this tutorial is to guide you through a very basic
@@ -449,7 +448,7 @@ cursor after the @code{end} statement of the @code{for} loop and press
449@key{SPC}. IDLWAVE blinks back to the beginning of the block and 448@key{SPC}. IDLWAVE blinks back to the beginning of the block and
450changes the generic @code{end} to the specific @code{endfor} 449changes the generic @code{end} to the specific @code{endfor}
451automatically (as long as the variable @code{idlwave-expand-generic-end} 450automatically (as long as the variable @code{idlwave-expand-generic-end}
452is turned on --- @pxref{Lesson II -- Customization}). Now place the 451is turned on; @pxref{Lesson II---Customization}). Now place the
453cursor in any line you would like to split and press @kbd{M-@key{RET}}. 452cursor in any line you would like to split and press @kbd{M-@key{RET}}.
454The line is split at the cursor position, with the continuation @samp{$} 453The line is split at the cursor position, with the continuation @samp{$}
455and indentation all taken care of. Use @kbd{C-/} to undo the last 454and indentation all taken care of. Use @kbd{C-/} to undo the last
@@ -505,7 +504,7 @@ Recompile with @kbd{C-c C-d C-c}. Jump back into the shell with
505@kbd{C-c C-s}, press the @key{UP} arrow to recall the previous command 504@kbd{C-c C-s}, press the @key{UP} arrow to recall the previous command
506and execute again. 505and execute again.
507 506
508This time we get a plot, but it is pretty ugly --- the points are all 507This time we get a plot, but it is pretty ugly: the points are all
509connected with a line. Hmm, isn't there a way for @code{plot} to use 508connected with a line. Hmm, isn't there a way for @code{plot} to use
510symbols instead? What was that keyword? Position the cursor on the 509symbols instead? What was that keyword? Position the cursor on the
511plot line after a comma (where you'd normally type a keyword), and hit 510plot line after a comma (where you'd normally type a keyword), and hit
@@ -521,7 +520,7 @@ by now: @kbd{C-c C-d C-c}), go back to the shell (if it's vanished,
521you know what to do: @kbd{C-c C-s}) and execute again. Now things 520you know what to do: @kbd{C-c C-s}) and execute again. Now things
522look pretty good. 521look pretty good.
523 522
524Let's try a different day --- how about April fool's day? 523Let's try a different day. How about April fool's day?
525 524
526@example 525@example
527plot_wday,1,4 526plot_wday,1,4
@@ -552,14 +551,14 @@ command. Everything should now work fine. How about those leap years?
552Change the code to plot 100 years and see that every 28 years, the 551Change the code to plot 100 years and see that every 28 years, the
553sequence of weekdays repeats. 552sequence of weekdays repeats.
554 553
555@node Lesson II -- Customization, Lesson III -- User Catalog, Lesson I -- Development Cycle, Getting Started 554@node Lesson II---Customization
556@section Lesson II: Customization 555@section Lesson II: Customization
557 556
558Emacs is probably the most customizable piece of software ever written, 557Emacs is probably the most customizable piece of software ever written,
559and it would be a shame if you did not make use of this to adapt IDLWAVE 558and it would be a shame if you did not make use of this to adapt IDLWAVE
560to your own preferences. Customizing Emacs or IDLWAVE is accomplished 559to your own preferences. Customizing Emacs or IDLWAVE is accomplished
561by setting Lisp variables in the @file{.emacs} file in your home 560by setting Lisp variables in the @file{.emacs} file in your home
562directory --- but do not be dismayed; for the most part, you can just 561directory---but do not be dismayed; for the most part, you can just
563copy and work from the examples given here. 562copy and work from the examples given here.
564 563
565Let's first use a boolean variable. These are variables which you turn 564Let's first use a boolean variable. These are variables which you turn
@@ -636,7 +635,7 @@ breakpoints (try it, it's easier). You can enable this with:
636 635
637@noindent to get compilation on @kbd{S-c}. Often, a modifier key like 636@noindent to get compilation on @kbd{S-c}. Often, a modifier key like
638@key{SUPER} or @key{HYPER} is bound or can be bound to an otherwise 637@key{SUPER} or @key{HYPER} is bound or can be bound to an otherwise
639unused key on your keyboard --- consult your system documentation. 638unused key on your keyboard; consult your system documentation.
640 639
641You can also assign specific commands to keys. This you must do in the 640You can also assign specific commands to keys. This you must do in the
642@emph{mode-hook}, a special function which is run when a new IDLWAVE 641@emph{mode-hook}, a special function which is run when a new IDLWAVE
@@ -662,7 +661,7 @@ endless. Here we set function keys f4-f8 to common debugging commands.
662 (local-set-key [f8] 'idlwave-shell-clear-all-bp))) 661 (local-set-key [f8] 'idlwave-shell-clear-all-bp)))
663@end lisp 662@end lisp
664 663
665@node Lesson III -- User Catalog, , Lesson II -- Customization, Getting Started 664@node Lesson III---User Catalog
666@section Lesson III: User and Library Catalogs 665@section Lesson III: User and Library Catalogs
667 666
668We have already used the routine info display in the first part of this 667We have already used the routine info display in the first part of this
@@ -685,7 +684,7 @@ Directories} from the IDLWAVE entry in the menu bar. If necessary,
685start the shell first with @kbd{C-c C-s} (@pxref{Starting the Shell}). 684start the shell first with @kbd{C-c C-s} (@pxref{Starting the Shell}).
686IDLWAVE will find out about the IDL @code{!PATH} variable and offer a 685IDLWAVE will find out about the IDL @code{!PATH} variable and offer a
687list of directories on the path. Simply select them all (or whichever 686list of directories on the path. Simply select them all (or whichever
688you want --- directories with existing library catalogs will not be 687you want; directories with existing library catalogs will not be
689selected by default) and click on the @samp{Scan&Save} button. Then 688selected by default) and click on the @samp{Scan&Save} button. Then
690go for a cup of coffee while IDLWAVE collects information for each and 689go for a cup of coffee while IDLWAVE collects information for each and
691every IDL routine on your search path. All this information is 690every IDL routine on your search path. All this information is
@@ -722,7 +721,7 @@ the manual, look at the documentation strings of interesting variables
722(with @kbd{C-h v idlwave<-variable-name> @key{RET}}) and ask the 721(with @kbd{C-h v idlwave<-variable-name> @key{RET}}) and ask the
723remaining questions on the newsgroup @code{comp.lang.idl-pvwave}. 722remaining questions on the newsgroup @code{comp.lang.idl-pvwave}.
724 723
725@node The IDLWAVE Major Mode, The IDLWAVE Shell, Getting Started, Top 724@node The IDLWAVE Major Mode
726@chapter The IDLWAVE Major Mode 725@chapter The IDLWAVE Major Mode
727@cindex IDLWAVE major mode 726@cindex IDLWAVE major mode
728@cindex Major mode, @code{idlwave-mode} 727@cindex Major mode, @code{idlwave-mode}
@@ -746,7 +745,7 @@ them.
746* Misc Options:: Things that fit nowhere else 745* Misc Options:: Things that fit nowhere else
747@end menu 746@end menu
748 747
749@node Code Formatting, Routine Info, The IDLWAVE Major Mode, The IDLWAVE Major Mode 748@node Code Formatting
750@section Code Formatting 749@section Code Formatting
751@cindex Code formatting 750@cindex Code formatting
752@cindex Formatting, of code 751@cindex Formatting, of code
@@ -774,7 +773,7 @@ you. After configuring it to match your coding standards, you can
774rely on it to help keep your code neat and organized. 773rely on it to help keep your code neat and organized.
775 774
776 775
777@node Code Indentation, Continued Statement Indentation, Code Formatting, Code Formatting 776@node Code Indentation
778@subsection Code Indentation 777@subsection Code Indentation
779@cindex Code indentation 778@cindex Code indentation
780@cindex Indentation 779@cindex Indentation
@@ -814,7 +813,7 @@ Extra indentation applied to block END lines. A value equal to negative
814BEGIN lines. 813BEGIN lines.
815@end defopt 814@end defopt
816 815
817@node Continued Statement Indentation, Comment Indentation, Code Indentation, Code Formatting 816@node Continued Statement Indentation
818@subsection Continued Statement Indentation 817@subsection Continued Statement Indentation
819@cindex Indentation, continued statement 818@cindex Indentation, continued statement
820@cindex Continued statement indentation 819@cindex Continued statement indentation
@@ -888,7 +887,7 @@ parenthesis, regardless of whether the
888@code{idlwave-max-extra-continuation-indent} limit is satisfied. 887@code{idlwave-max-extra-continuation-indent} limit is satisfied.
889@end defopt 888@end defopt
890 889
891@node Comment Indentation, Continuation Lines, Continued Statement Indentation, Code Formatting 890@node Comment Indentation
892@subsection Comment Indentation 891@subsection Comment Indentation
893@cindex Comment indentation 892@cindex Comment indentation
894@cindex Hanging paragraphs 893@cindex Hanging paragraphs
@@ -925,7 +924,7 @@ A comment that starts with this regexp is indented as if it is a part of
925IDL code. 924IDL code.
926@end defopt 925@end defopt
927 926
928@node Continuation Lines, Syntax Highlighting, Comment Indentation, Code Formatting 927@node Continuation Lines
929@subsection Continuation Lines and Filling 928@subsection Continuation Lines and Filling
930@cindex Continuation lines 929@cindex Continuation lines
931@cindex Line splitting 930@cindex Line splitting
@@ -1001,7 +1000,7 @@ Non-@code{nil} means use last match on line for
1001@code{idlwave-indent-regexp}. 1000@code{idlwave-indent-regexp}.
1002@end defopt 1001@end defopt
1003 1002
1004@node Syntax Highlighting, Octals and Highlighting, Continuation Lines, Code Formatting 1003@node Syntax Highlighting
1005@subsection Syntax Highlighting 1004@subsection Syntax Highlighting
1006@cindex Syntax highlighting 1005@cindex Syntax highlighting
1007@cindex Highlighting of syntax 1006@cindex Highlighting of syntax
@@ -1029,7 +1028,7 @@ Items which should be fontified on the default fontification level
10292. 10282.
1030@end defopt 1029@end defopt
1031 1030
1032@node Octals and Highlighting, , Syntax Highlighting, Code Formatting 1031@node Octals and Highlighting
1033@subsection Octals and Highlighting 1032@subsection Octals and Highlighting
1034@cindex Syntax highlighting, Octals 1033@cindex Syntax highlighting, Octals
1035@cindex Highlighting of syntax, Octals 1034@cindex Highlighting of syntax, Octals
@@ -1059,7 +1058,7 @@ altogether, and use the more sensible alternative IDL provides:
1059@noindent This simultaneously solves the font-lock problem and is more 1058@noindent This simultaneously solves the font-lock problem and is more
1060consistent with the notation for hexadecimal numbers, e.g., @code{'C5'XB}. 1059consistent with the notation for hexadecimal numbers, e.g., @code{'C5'XB}.
1061 1060
1062@node Routine Info, Online Help, Code Formatting, The IDLWAVE Major Mode 1061@node Routine Info
1063@section Routine Info 1062@section Routine Info
1064@cindex Routine info 1063@cindex Routine info
1065@cindex Updating routine info 1064@cindex Updating routine info
@@ -1237,7 +1236,7 @@ Maximum number of source files displayed in the Routine Info window.
1237@html 1236@html
1238<A NAME="ONLINE_HELP"></A> 1237<A NAME="ONLINE_HELP"></A>
1239@end html 1238@end html
1240@node Online Help, Completion, Routine Info, The IDLWAVE Major Mode 1239@node Online Help
1241@section Online Help 1240@section Online Help
1242 1241
1243@cindex Online Help 1242@cindex Online Help
@@ -1252,8 +1251,8 @@ For IDL system routines, extensive documentation is supplied with IDL@.
1252IDLWAVE can access the HTML version of this documentation very quickly 1251IDLWAVE can access the HTML version of this documentation very quickly
1253and accurately, based on the local context. This can be @emph{much} 1252and accurately, based on the local context. This can be @emph{much}
1254faster than using the IDL online help application, because IDLWAVE 1253faster than using the IDL online help application, because IDLWAVE
1255usually gets you to the right place in the documentation directly --- 1254usually gets you to the right place in the documentation directly---e.g.,
1256e.g., a specific keyword of a routine --- without any additional browsing 1255a specific keyword of a routine---without any additional browsing
1257and scrolling. 1256and scrolling.
1258 1257
1259For this online help to work, an HTML version of the IDL documentation 1258For this online help to work, an HTML version of the IDL documentation
@@ -1344,7 +1343,7 @@ directly in the originating source file.
1344* Help with Source:: 1343* Help with Source::
1345@end menu 1344@end menu
1346 1345
1347@node Help with HTML Documentation, Help with Source, Online Help, Online Help 1346@node Help with HTML Documentation
1348@subsection Help with HTML Documentation 1347@subsection Help with HTML Documentation
1349@cindex HTML Help 1348@cindex HTML Help
1350@cindex Help using HTML manuals 1349@cindex Help using HTML manuals
@@ -1423,7 +1422,7 @@ contains "-w3".
1423The face for links to IDLWAVE online help. 1422The face for links to IDLWAVE online help.
1424@end defopt 1423@end defopt
1425 1424
1426@node Help with Source, , Help with HTML Documentation, Online Help 1425@node Help with Source
1427@subsection Help with Source 1426@subsection Help with Source
1428@cindex Help using routine source 1427@cindex Help using routine source
1429 1428
@@ -1510,7 +1509,7 @@ The case-insensitive heading word in doclib headers to locate the
1510@end defopt 1509@end defopt
1511 1510
1512 1511
1513@node Completion, Routine Source, Online Help, The IDLWAVE Major Mode 1512@node Completion
1514@section Completion 1513@section Completion
1515@cindex Completion 1514@cindex Completion
1516@cindex Keyword completion 1515@cindex Keyword completion
@@ -1526,7 +1525,7 @@ IDLWAVE offers completion for class names, routine names, keywords,
1526system variables, system variable tags, class structure tags, regular 1525system variables, system variable tags, class structure tags, regular
1527structure tags and file names. As in many programming modes, completion 1526structure tags and file names. As in many programming modes, completion
1528is bound to @kbd{M-@key{TAB}} (or simply @kbd{@key{TAB}} in the IDLWAVE 1527is bound to @kbd{M-@key{TAB}} (or simply @kbd{@key{TAB}} in the IDLWAVE
1529Shell --- @pxref{Using the Shell}). Completion uses exactly the same 1528Shell; @pxref{Using the Shell}). Completion uses exactly the same
1530internal information as routine info, so when necessary (rarely) it can 1529internal information as routine info, so when necessary (rarely) it can
1531be updated with @kbd{C-c C-i} (@code{idlwave-update-routine-info}). 1530be updated with @kbd{C-c C-i} (@code{idlwave-update-routine-info}).
1532 1531
@@ -1582,7 +1581,7 @@ text.
1582 1581
1583@cindex Completion, canceling 1582@cindex Completion, canceling
1584@cindex Canceling completion 1583@cindex Canceling completion
1585Completion is not a blocking operation --- you are free to continue 1584Completion is not a blocking operation; you are free to continue
1586editing, enter commands, or simply ignore the @file{*Completions*} 1585editing, enter commands, or simply ignore the @file{*Completions*}
1587buffer during a completion operation. If, however, the most recent 1586buffer during a completion operation. If, however, the most recent
1588command was a completion, @kbd{C-g} will remove the buffer and restore 1587command was a completion, @kbd{C-g} will remove the buffer and restore
@@ -1618,7 +1617,7 @@ available.
1618* Structure Tag Completion:: Completing state.Tag 1617* Structure Tag Completion:: Completing state.Tag
1619@end menu 1618@end menu
1620 1619
1621@node Case of Completed Words, Object Method Completion and Class Ambiguity, Completion, Completion 1620@node Case of Completed Words
1622@subsection Case of Completed Words 1621@subsection Case of Completed Words
1623@cindex Case of completed words 1622@cindex Case of completed words
1624@cindex Mixed case completion 1623@cindex Mixed case completion
@@ -1655,7 +1654,7 @@ Non-@code{nil} means the empty string is considered lower case for
1655completion. 1654completion.
1656@end defopt 1655@end defopt
1657 1656
1658@node Object Method Completion and Class Ambiguity, Object Method Completion in the Shell, Case of Completed Words, Completion 1657@node Object Method Completion and Class Ambiguity
1659@subsection Object Method Completion and Class Ambiguity 1658@subsection Object Method Completion and Class Ambiguity
1660@cindex Object methods 1659@cindex Object methods
1661@cindex Class ambiguity 1660@cindex Class ambiguity
@@ -1718,7 +1717,7 @@ Face to highlight object operator arrows @samp{->} which carry a saved
1718class text property. 1717class text property.
1719@end defopt 1718@end defopt
1720 1719
1721@node Object Method Completion in the Shell, Class and Keyword Inheritance, Object Method Completion and Class Ambiguity, Completion 1720@node Object Method Completion in the Shell
1722@subsection Object Method Completion in the Shell 1721@subsection Object Method Completion in the Shell
1723@cindex Method Completion in Shell 1722@cindex Method Completion in Shell
1724In the IDLWAVE Shell (@pxref{The IDLWAVE Shell}), objects on which 1723In the IDLWAVE Shell (@pxref{The IDLWAVE Shell}), objects on which
@@ -1731,7 +1730,7 @@ class found will be used to select appropriate completions, routine
1731info, or help. If unsuccessful, information from all known classes will 1730info, or help. If unsuccessful, information from all known classes will
1732be used (as in the buffer). 1731be used (as in the buffer).
1733 1732
1734@node Class and Keyword Inheritance, Structure Tag Completion, Object Method Completion in the Shell, Completion 1733@node Class and Keyword Inheritance
1735@subsection Class and Keyword Inheritance 1734@subsection Class and Keyword Inheritance
1736@cindex Inheritance, class 1735@cindex Inheritance, class
1737@cindex Keyword inheritance 1736@cindex Keyword inheritance
@@ -1777,7 +1776,7 @@ A list of regular expressions to match methods for which simple
1777class-driven keyword inheritance will be used for Completion. 1776class-driven keyword inheritance will be used for Completion.
1778@end defopt 1777@end defopt
1779 1778
1780@node Structure Tag Completion, , Class and Keyword Inheritance, Completion 1779@node Structure Tag Completion
1781@subsection Structure Tag Completion 1780@subsection Structure Tag Completion
1782@cindex Completion, structure tag 1781@cindex Completion, structure tag
1783@cindex Structure tag completion 1782@cindex Structure tag completion
@@ -1819,7 +1818,7 @@ IDL> st.[Tab]
1819@noindent will complete with all structure fields of the structure 1818@noindent will complete with all structure fields of the structure
1820@code{st}. 1819@code{st}.
1821 1820
1822@node Routine Source, Resolving Routines, Completion, The IDLWAVE Major Mode 1821@node Routine Source
1823@section Routine Source 1822@section Routine Source
1824@cindex Routine source file 1823@cindex Routine source file
1825@cindex Module source file 1824@cindex Module source file
@@ -1845,7 +1844,7 @@ sometimes created. The special command @kbd{C-c C-k}
1845(@code{idlwave-kill-autoloaded-buffers}) can be used to easily remove 1844(@code{idlwave-kill-autoloaded-buffers}) can be used to easily remove
1846these buffers. 1845these buffers.
1847 1846
1848@node Resolving Routines, Code Templates, Routine Source, The IDLWAVE Major Mode 1847@node Resolving Routines
1849@section Resolving Routines 1848@section Resolving Routines
1850@cindex @code{RESOLVE_ROUTINE} 1849@cindex @code{RESOLVE_ROUTINE}
1851@cindex Compiling library modules 1850@cindex Compiling library modules
@@ -1866,7 +1865,7 @@ compile the modules first, and even without a running shell.
1866@xref{Sources of Routine Info}, for more information on the ways IDLWAVE 1865@xref{Sources of Routine Info}, for more information on the ways IDLWAVE
1867collects data about routines, and how to update this information. 1866collects data about routines, and how to update this information.
1868 1867
1869@node Code Templates, Abbreviations, Resolving Routines, The IDLWAVE Major Mode 1868@node Code Templates
1870@section Code Templates 1869@section Code Templates
1871@cindex Code templates 1870@cindex Code templates
1872@cindex Templates 1871@cindex Templates
@@ -1888,7 +1887,7 @@ templates, this is done with direct key bindings:
1888All code templates are also available as abbreviations 1887All code templates are also available as abbreviations
1889(@pxref{Abbreviations}). 1888(@pxref{Abbreviations}).
1890 1889
1891@node Abbreviations, Actions, Code Templates, The IDLWAVE Major Mode 1890@node Abbreviations
1892@section Abbreviations 1891@section Abbreviations
1893@cindex Abbreviations 1892@cindex Abbreviations
1894 1893
@@ -1899,7 +1898,7 @@ used to insert code templates all start with a @samp{\} (the backslash),
1899or, optionally, any other character set in 1898or, optionally, any other character set in
1900@code{idlwave-abbrev-start-char}. IDLWAVE ensures that abbreviations are 1899@code{idlwave-abbrev-start-char}. IDLWAVE ensures that abbreviations are
1901only expanded where they should be (i.e., not in a string or comment), 1900only expanded where they should be (i.e., not in a string or comment),
1902and permits the point to be moved after an abbreviation expansion --- 1901and permits the point to be moved after an abbreviation expansion:
1903very useful for positioning the mark inside of parentheses, etc. 1902very useful for positioning the mark inside of parentheses, etc.
1904 1903
1905Special abbreviations are pre-defined for code templates and other 1904Special abbreviations are pre-defined for code templates and other
@@ -2074,7 +2073,7 @@ Non-@code{nil} means the abbrev hook can move point, e.g., to end up
2074between the parentheses of a function call. 2073between the parentheses of a function call.
2075@end defopt 2074@end defopt
2076 2075
2077@node Actions, Doc Header, Abbreviations, The IDLWAVE Major Mode 2076@node Actions
2078@section Actions 2077@section Actions
2079@cindex Actions 2078@cindex Actions
2080@cindex Coding standards, enforcing 2079@cindex Coding standards, enforcing
@@ -2122,7 +2121,7 @@ settings are described below and set separately.
2122* Case Changes:: Enforcing upper case keywords 2121* Case Changes:: Enforcing upper case keywords
2123@end menu 2122@end menu
2124 2123
2125@node Block Boundary Check, Padding Operators, Actions, Actions 2124@node Block Boundary Check
2126@subsection Block Boundary Check 2125@subsection Block Boundary Check
2127@cindex Block boundary check 2126@cindex Block boundary check
2128@cindex @code{END} type checking 2127@cindex @code{END} type checking
@@ -2155,7 +2154,7 @@ Non-@code{nil} means expand generic END to ENDIF/ENDELSE/ENDWHILE etc.
2155Non-@code{nil} means re-indent line after END was typed. 2154Non-@code{nil} means re-indent line after END was typed.
2156@end defopt 2155@end defopt
2157 2156
2158@node Padding Operators, Case Changes, Block Boundary Check, Actions 2157@node Padding Operators
2159@subsection Padding Operators 2158@subsection Padding Operators
2160@cindex Padding operators with spaces 2159@cindex Padding operators with spaces
2161@cindex Operators, padding with spaces 2160@cindex Operators, padding with spaces
@@ -2204,7 +2203,7 @@ surrounded with spaces by @code{idlwave-surround}.
2204Non-@code{nil} means space-pad the @samp{=} in keyword assignments. 2203Non-@code{nil} means space-pad the @samp{=} in keyword assignments.
2205@end defopt 2204@end defopt
2206 2205
2207@node Case Changes, , Padding Operators, Actions 2206@node Case Changes
2208@subsection Case Changes 2207@subsection Case Changes
2209@cindex Case changes 2208@cindex Case changes
2210@cindex Upcase, enforcing for reserved words 2209@cindex Upcase, enforcing for reserved words
@@ -2246,7 +2245,7 @@ expansion.
2246@end defopt 2245@end defopt
2247 2246
2248 2247
2249@node Doc Header, Motion Commands, Actions, The IDLWAVE Major Mode 2248@node Doc Header
2250@section Documentation Header 2249@section Documentation Header
2251@cindex Documentation header 2250@cindex Documentation header
2252@cindex DocLib header 2251@cindex DocLib header
@@ -2290,7 +2289,7 @@ Regexp matching the start of a document library header.
2290Regexp matching the start of a document library header. 2289Regexp matching the start of a document library header.
2291@end defopt 2290@end defopt
2292 2291
2293@node Motion Commands, Misc Options, Doc Header, The IDLWAVE Major Mode 2292@node Motion Commands
2294@section Motion Commands 2293@section Motion Commands
2295@cindex Motion commands 2294@cindex Motion commands
2296@cindex Program structure, moving through 2295@cindex Program structure, moving through
@@ -2340,7 +2339,7 @@ IDL program:
2340@end multitable 2339@end multitable
2341 2340
2342 2341
2343@node Misc Options, , Motion Commands, The IDLWAVE Major Mode 2342@node Misc Options
2344@section Miscellaneous Options 2343@section Miscellaneous Options
2345@cindex Hooks 2344@cindex Hooks
2346 2345
@@ -2361,7 +2360,7 @@ Normal hook. Executed when a buffer is put into @code{idlwave-mode}.
2361Normal hook. Executed when @file{idlwave.el} is loaded. 2360Normal hook. Executed when @file{idlwave.el} is loaded.
2362@end defopt 2361@end defopt
2363 2362
2364@node The IDLWAVE Shell, Acknowledgments, The IDLWAVE Major Mode, Top 2363@node The IDLWAVE Shell
2365@chapter The IDLWAVE Shell 2364@chapter The IDLWAVE Shell
2366@cindex IDLWAVE shell 2365@cindex IDLWAVE shell
2367@cindex Major mode, @code{idlwave-shell-mode} 2366@cindex Major mode, @code{idlwave-shell-mode}
@@ -2378,7 +2377,7 @@ interactively, to compile and run IDL programs in Emacs buffers and to
2378debug these programs. The IDLWAVE shell is built on @file{comint}, an 2377debug these programs. The IDLWAVE shell is built on @file{comint}, an
2379Emacs packages which handles the communication with the IDL program. 2378Emacs packages which handles the communication with the IDL program.
2380Unfortunately, IDL for Windows does not have command-prompt versions and 2379Unfortunately, IDL for Windows does not have command-prompt versions and
2381thus do not allow the interaction with Emacs --- so the IDLWAVE shell 2380thus do not allow the interaction with Emacs, so the IDLWAVE shell
2382currently only works under Unix and MacOSX. 2381currently only works under Unix and MacOSX.
2383 2382
2384@menu 2383@menu
@@ -2390,7 +2389,7 @@ currently only works under Unix and MacOSX.
2390* Custom Expression Examination:: 2389* Custom Expression Examination::
2391@end menu 2390@end menu
2392 2391
2393@node Starting the Shell, Using the Shell, The IDLWAVE Shell, The IDLWAVE Shell 2392@node Starting the Shell
2394@section Starting the Shell 2393@section Starting the Shell
2395@cindex Starting the shell 2394@cindex Starting the shell
2396@cindex Shell, starting 2395@cindex Shell, starting
@@ -2500,7 +2499,7 @@ The prefix for temporary IDL files used when compiling regions.
2500Hook for customizing @code{idlwave-shell-mode}. 2499Hook for customizing @code{idlwave-shell-mode}.
2501@end defopt 2500@end defopt
2502 2501
2503@node Using the Shell, Commands Sent to the Shell, Starting the Shell, The IDLWAVE Shell 2502@node Using the Shell
2504@section Using the Shell 2503@section Using the Shell
2505@cindex Comint 2504@cindex Comint
2506@cindex Shell, basic commands 2505@cindex Shell, basic commands
@@ -2627,7 +2626,7 @@ The three regular expressions which match the magic spells for input
2627modes. 2626modes.
2628@end defopt 2627@end defopt
2629 2628
2630@node Commands Sent to the Shell, Debugging IDL Programs, Using the Shell, The IDLWAVE Shell 2629@node Commands Sent to the Shell
2631@section Commands Sent to the Shell 2630@section Commands Sent to the Shell
2632@cindex Commands in shell, showing 2631@cindex Commands in shell, showing
2633@cindex Showing commands in shell 2632@cindex Showing commands in shell
@@ -2668,7 +2667,7 @@ As a special case, any error message in the output will be displayed
2668(e.g., stepping to an error). 2667(e.g., stepping to an error).
2669@end defopt 2668@end defopt
2670 2669
2671@node Debugging IDL Programs, Examining Variables, Commands Sent to the Shell, The IDLWAVE Shell 2670@node Debugging IDL Programs
2672@section Debugging IDL Programs 2671@section Debugging IDL Programs
2673@cindex Debugging 2672@cindex Debugging
2674@cindex Keybindings for debugging 2673@cindex Keybindings for debugging
@@ -2706,7 +2705,7 @@ buffers.
2706@end menu 2705@end menu
2707 2706
2708 2707
2709@node A Tale of Two Modes, Debug Key Bindings, Debugging IDL Programs, Debugging IDL Programs 2708@node A Tale of Two Modes
2710@subsection A Tale of Two Modes 2709@subsection A Tale of Two Modes
2711@cindex Electric Debug Mode 2710@cindex Electric Debug Mode
2712@cindex Debugging Interface 2711@cindex Debugging Interface
@@ -2726,7 +2725,7 @@ Mode}, for more on that mode. Note that electric debug mode can be
2726prevented from activating automatically by customizing the variable 2725prevented from activating automatically by customizing the variable
2727@code{idlwave-shell-automatic-electric-debug}. 2726@code{idlwave-shell-automatic-electric-debug}.
2728 2727
2729@node Debug Key Bindings, Breakpoints and Stepping, A Tale of Two Modes, Debugging IDL Programs 2728@node Debug Key Bindings
2730@subsection Debug Key Bindings 2729@subsection Debug Key Bindings
2731@kindex C-c C-d 2730@kindex C-c C-d
2732@cindex Key bindings 2731@cindex Key bindings
@@ -2736,8 +2735,8 @@ the prefix key @kbd{C-c C-d}, so, for example, setting a breakpoint is
2736done with @kbd{C-c C-d C-b}, and compiling a source file with @kbd{C-c 2735done with @kbd{C-c C-d C-b}, and compiling a source file with @kbd{C-c
2737C-d C-c}. You can also easily configure IDLWAVE to use one or more 2736C-d C-c}. You can also easily configure IDLWAVE to use one or more
2738modifier keys not in use by other commands, in lieu of the prefix 2737modifier keys not in use by other commands, in lieu of the prefix
2739@kbd{C-c C-d} (though these bindings will typically also be available 2738@kbd{C-c C-d} (though these bindings will typically also be available;
2740--- see @code{idlwave-shell-activate-prefix-keybindings}). For 2739see @code{idlwave-shell-activate-prefix-keybindings}). For
2741example, if you include in @file{.emacs}: 2740example, if you include in @file{.emacs}:
2742 2741
2743@lisp 2742@lisp
@@ -2750,9 +2749,9 @@ source file will be on @kbd{C-S-c}, deleting a breakpoint @kbd{C-S-d},
2750etc. In the remainder of this chapter we will assume that the 2749etc. In the remainder of this chapter we will assume that the
2751@kbd{C-c C-d} bindings are active, but each of these bindings will 2750@kbd{C-c C-d} bindings are active, but each of these bindings will
2752have an equivalent shortcut if modifiers are given in the 2751have an equivalent shortcut if modifiers are given in the
2753@code{idlwave-shell-debug-modifiers} variable (@pxref{Lesson II -- 2752@code{idlwave-shell-debug-modifiers} variable (@pxref{Lesson
2754Customization}). A much simpler and faster form of debugging for 2753II---Customization}). A much simpler and faster form of debugging for
2755running code is also available by default --- see @ref{Electric Debug 2754running code is also available by default; see @ref{Electric Debug
2756Mode}. 2755Mode}.
2757 2756
2758@defopt idlwave-shell-prefix-key (@kbd{C-c C-d}) 2757@defopt idlwave-shell-prefix-key (@kbd{C-c C-d})
@@ -2772,7 +2771,7 @@ more of @code{control}, @code{meta}, @code{super}, @code{hyper},
2772@code{alt}, and @code{shift}. 2771@code{alt}, and @code{shift}.
2773@end defopt 2772@end defopt
2774 2773
2775@node Breakpoints and Stepping, Compiling Programs, Debug Key Bindings, Debugging IDL Programs 2774@node Breakpoints and Stepping
2776@subsection Breakpoints and Stepping 2775@subsection Breakpoints and Stepping
2777@cindex Breakpoints 2776@cindex Breakpoints
2778@cindex Stepping 2777@cindex Stepping
@@ -2788,7 +2787,7 @@ prefix arg of 1 (i.e., @kbd{C-1 C-c C-d C-b}), the breakpoint gets a
2788With a numeric prefix greater than one (e.g., @kbd{C-4 C-c C-d C-b}), 2787With a numeric prefix greater than one (e.g., @kbd{C-4 C-c C-d C-b}),
2789the breakpoint will only be active the @code{nth} time it is hit. 2788the breakpoint will only be active the @code{nth} time it is hit.
2790With a single non-numeric prefix (i.e., @kbd{C-u C-c C-d C-b}), prompt 2789With a single non-numeric prefix (i.e., @kbd{C-u C-c C-d C-b}), prompt
2791for a condition --- an IDL expression to be evaluated and trigger the 2790for a condition: an IDL expression to be evaluated and trigger the
2792breakpoint only if true. To clear the breakpoint in the current line, 2791breakpoint only if true. To clear the breakpoint in the current line,
2793use @kbd{C-c C-d C-d} (@code{idlwave-clear-current-bp}). When 2792use @kbd{C-c C-d C-d} (@code{idlwave-clear-current-bp}). When
2794executed from the shell window, the breakpoint where IDL is currently 2793executed from the shell window, the breakpoint where IDL is currently
@@ -2904,7 +2903,7 @@ configured in @code{idlwave-shell-mark-stop-line}.
2904@end defopt 2903@end defopt
2905 2904
2906 2905
2907@node Compiling Programs, Walking the Calling Stack, Breakpoints and Stepping, Debugging IDL Programs 2906@node Compiling Programs
2908@subsection Compiling Programs 2907@subsection Compiling Programs
2909@cindex Compiling programs 2908@cindex Compiling programs
2910@cindex Programs, compiling 2909@cindex Programs, compiling
@@ -2937,7 +2936,7 @@ level program @kbd{C-c C-d C-e} (@code{idlwave-shell-run-region}) is
2937very useful. A temporary file is created holding the contents of the 2936very useful. A temporary file is created holding the contents of the
2938current region (with @code{END} appended), and run from the shell. 2937current region (with @code{END} appended), and run from the shell.
2939 2938
2940@node Walking the Calling Stack, Electric Debug Mode, Compiling Programs, Debugging IDL Programs 2939@node Walking the Calling Stack
2941@subsection Walking the Calling Stack 2940@subsection Walking the Calling Stack
2942@cindex Calling stack, walking 2941@cindex Calling stack, walking
2943 2942
@@ -2959,7 +2958,7 @@ higher calling stack levels.
2959@html 2958@html
2960<A NAME="EDEBUG"></A> 2959<A NAME="EDEBUG"></A>
2961@end html 2960@end html
2962@node Electric Debug Mode, , Walking the Calling Stack, Debugging IDL Programs 2961@node Electric Debug Mode
2963@subsection Electric Debug Mode 2962@subsection Electric Debug Mode
2964@cindex Electric Debug Mode 2963@cindex Electric Debug Mode
2965@cindex @samp{*Debugging*} 2964@cindex @samp{*Debugging*}
@@ -3096,7 +3095,7 @@ window, but is useful for immediate stepping, etc.
3096@html 3095@html
3097<A NAME="EXAMINE"></A> 3096<A NAME="EXAMINE"></A>
3098@end html 3097@end html
3099@node Examining Variables, Custom Expression Examination, Debugging IDL Programs, The IDLWAVE Shell 3098@node Examining Variables
3100@section Examining Variables 3099@section Examining Variables
3101@cindex @code{PRINT} expressions 3100@cindex @code{PRINT} expressions
3102@cindex @code{HELP}, on expressions 3101@cindex @code{HELP}, on expressions
@@ -3119,10 +3118,10 @@ time (as long as the shell is running), and are very useful when
3119execution is stopped in a buffer due to a triggered breakpoint or error, 3118execution is stopped in a buffer due to a triggered breakpoint or error,
3120or while composing a long command in the IDLWAVE shell. In the latter 3119or while composing a long command in the IDLWAVE shell. In the latter
3121case, the command is sent to the shell and its output is visible, but 3120case, the command is sent to the shell and its output is visible, but
3122point remains unmoved in the command being composed --- you can inspect 3121point remains unmoved in the command being composed: you can inspect
3123the constituents of a command you're building without interrupting the 3122the constituents of a command you're building without interrupting the
3124process of building it! You can even print arbitrary expressions from 3123process of building it! You can even print arbitrary expressions from
3125older input or output further up in the shell window --- any expression, 3124older input or output further up in the shell window; any expression,
3126variable, number, or function you see can be examined. 3125variable, number, or function you see can be examined.
3127 3126
3128If the variable @code{idlwave-shell-separate-examine-output} is 3127If the variable @code{idlwave-shell-separate-examine-output} is
@@ -3203,7 +3202,7 @@ The maximum number of leading array entries to print, when examining
3203array expressions. 3202array expressions.
3204@end defopt 3203@end defopt
3205 3204
3206@node Custom Expression Examination, , Examining Variables, The IDLWAVE Shell 3205@node Custom Expression Examination
3207@section Custom Expression Examination 3206@section Custom Expression Examination
3208@cindex Expressions, custom examination 3207@cindex Expressions, custom examination
3209@cindex Custom expression examination 3208@cindex Custom expression examination
@@ -3273,7 +3272,7 @@ examine command strings to send, after all instances of @code{___}
3273(three underscores) are replaced by the indicated expression. 3272(three underscores) are replaced by the indicated expression.
3274@end defopt 3273@end defopt
3275 3274
3276@node Acknowledgments, Sources of Routine Info, The IDLWAVE Shell, Top 3275@node Acknowledgments
3277@chapter Acknowledgments 3276@chapter Acknowledgments
3278@cindex Acknowledgments 3277@cindex Acknowledgments
3279@cindex Maintainer, of IDLWAVE 3278@cindex Maintainer, of IDLWAVE
@@ -3352,7 +3351,7 @@ scripts and documentation to interface with the IDL Assistant.
3352@noindent 3351@noindent
3353Thanks to everyone! 3352Thanks to everyone!
3354 3353
3355@node Sources of Routine Info, HTML Help Browser Tips, Acknowledgments, Top 3354@node Sources of Routine Info
3356@appendix Sources of Routine Info 3355@appendix Sources of Routine Info
3357 3356
3358@cindex Sources of routine information 3357@cindex Sources of routine information
@@ -3369,7 +3368,7 @@ know about the accessible routines.
3369* Documentation Scan:: Scanning the IDL Manuals 3368* Documentation Scan:: Scanning the IDL Manuals
3370@end menu 3369@end menu
3371 3370
3372@node Routine Definitions, Routine Information Sources, Sources of Routine Info, Sources of Routine Info 3371@node Routine Definitions
3373@appendixsec Routine Definitions 3372@appendixsec Routine Definitions
3374@cindex Routine definitions 3373@cindex Routine definitions
3375@cindex IDL variable @code{!PATH} 3374@cindex IDL variable @code{!PATH}
@@ -3405,7 +3404,7 @@ cannot provide routine info and completion for such external routines,
3405except by querying the Shell for calling information (DLMs only). 3404except by querying the Shell for calling information (DLMs only).
3406@end enumerate 3405@end enumerate
3407 3406
3408@node Routine Information Sources, Catalogs, Routine Definitions, Sources of Routine Info 3407@node Routine Information Sources
3409@appendixsec Routine Information Sources 3408@appendixsec Routine Information Sources
3410@cindex Routine info sources 3409@cindex Routine info sources
3411@cindex Builtin list of routines 3410@cindex Builtin list of routines
@@ -3492,7 +3491,7 @@ Controls under what circumstances routine info is updated automatically.
3492@html 3491@html
3493<A NAME="CATALOGS"></A> 3492<A NAME="CATALOGS"></A>
3494@end html 3493@end html
3495@node Catalogs, Load-Path Shadows, Routine Information Sources, Sources of Routine Info 3494@node Catalogs
3496@appendixsec Catalogs 3495@appendixsec Catalogs
3497@cindex Catalogs 3496@cindex Catalogs
3498 3497
@@ -3506,7 +3505,7 @@ Starting with version 5.0, there are two types of catalogs available
3506with IDLWAVE@. The traditional @emph{user catalog} and the newer 3505with IDLWAVE@. The traditional @emph{user catalog} and the newer
3507@emph{library catalogs}. Although they can be used interchangeably, the 3506@emph{library catalogs}. Although they can be used interchangeably, the
3508library catalogs are more flexible, and preferred. There are few 3507library catalogs are more flexible, and preferred. There are few
3509occasions when a user catalog might be preferred --- read below. Both 3508occasions when a user catalog might be preferred---read below. Both
3510types of catalogs can coexist without causing problems. 3509types of catalogs can coexist without causing problems.
3511 3510
3512To facilitate the catalog systems, IDLWAVE stores information it gathers 3511To facilitate the catalog systems, IDLWAVE stores information it gathers
@@ -3554,7 +3553,7 @@ later).
3554@html 3553@html
3555<A NAME="LIBRARY_CATALOGS"></A> 3554<A NAME="LIBRARY_CATALOGS"></A>
3556@end html 3555@end html
3557@node Library Catalogs, User Catalog, Catalogs, Catalogs 3556@node Library Catalogs
3558@appendixsubsec Library Catalogs 3557@appendixsubsec Library Catalogs
3559@cindex @file{.idlwave_catalog} 3558@cindex @file{.idlwave_catalog}
3560@cindex Library catalogs 3559@cindex Library catalogs
@@ -3564,7 +3563,7 @@ Library catalogs consist of files named @file{.idlwave_catalog} stored
3564in directories containing @code{.pro} routine files. They are 3563in directories containing @code{.pro} routine files. They are
3565discovered on the IDL search path and loaded automatically when routine 3564discovered on the IDL search path and loaded automatically when routine
3566information is read. Each catalog file documents the routines found in 3565information is read. Each catalog file documents the routines found in
3567that directory --- one catalog per directory. Every catalog has a 3566that directory---one catalog per directory. Every catalog has a
3568library name associated with it (e.g., @emph{AstroLib}). This name will 3567library name associated with it (e.g., @emph{AstroLib}). This name will
3569be shown briefly when the catalog is found, and in the routine info of 3568be shown briefly when the catalog is found, and in the routine info of
3570routines it documents. 3569routines it documents.
@@ -3618,7 +3617,7 @@ Whether to search for and load library catalogs. Disable if load
3618performance is a problem and/or the catalogs are not needed. 3617performance is a problem and/or the catalogs are not needed.
3619@end defopt 3618@end defopt
3620 3619
3621@node User Catalog, , Library Catalogs, Catalogs 3620@node User Catalog
3622@appendixsubsec User Catalog 3621@appendixsubsec User Catalog
3623@cindex User catalog 3622@cindex User catalog
3624@cindex IDL library routine info 3623@cindex IDL library routine info
@@ -3691,7 +3690,7 @@ Alist of regular expressions matching special library directories for
3691labeling in routine-info display. 3690labeling in routine-info display.
3692@end defopt 3691@end defopt
3693 3692
3694@node Load-Path Shadows, Documentation Scan, Catalogs, Sources of Routine Info 3693@node Load-Path Shadows
3695@appendixsec Load-Path Shadows 3694@appendixsec Load-Path Shadows
3696@cindex Load-path shadows 3695@cindex Load-path shadows
3697@cindex Shadows, load-path 3696@cindex Shadows, load-path
@@ -3751,7 +3750,7 @@ routines.
3751Another way to find out if a specific routine has multiple definitions 3750Another way to find out if a specific routine has multiple definitions
3752on the load path is routine info display (@pxref{Routine Info}). 3751on the load path is routine info display (@pxref{Routine Info}).
3753 3752
3754@node Documentation Scan, , Load-Path Shadows, Sources of Routine Info 3753@node Documentation Scan
3755@appendixsec Documentation Scan 3754@appendixsec Documentation Scan
3756@cindex @file{get_html_rinfo} 3755@cindex @file{get_html_rinfo}
3757@cindex @file{idlw-rinfo.el} 3756@cindex @file{idlw-rinfo.el}
@@ -3784,7 +3783,7 @@ scanning the HTML documents produced from the IDL documentation.
3784Instructions on how to use @file{get_html_rinfo} are in the program 3783Instructions on how to use @file{get_html_rinfo} are in the program
3785itself. 3784itself.
3786 3785
3787@node HTML Help Browser Tips, Configuration Examples, Sources of Routine Info, Top 3786@node HTML Help Browser Tips
3788@appendix HTML Help Browser Tips 3787@appendix HTML Help Browser Tips
3789@cindex Browser Tips 3788@cindex Browser Tips
3790 3789
@@ -3859,7 +3858,7 @@ Note that you can open the file in an external browser from within
3859@code{w3m} using @kbd{M}. 3858@code{w3m} using @kbd{M}.
3860@end itemize 3859@end itemize
3861 3860
3862@node Configuration Examples, Windows and MacOS, HTML Help Browser Tips, Top 3861@node Configuration Examples
3863@appendix Configuration Examples 3862@appendix Configuration Examples
3864@cindex Configuration examples 3863@cindex Configuration examples
3865@cindex Example configuration 3864@cindex Example configuration
@@ -4022,7 +4021,7 @@ user is King!
4022@html 4021@html
4023<A NAME="WINDOWS_MAC"></A> 4022<A NAME="WINDOWS_MAC"></A>
4024@end html 4023@end html
4025@node Windows and MacOS, Troubleshooting, Configuration Examples, Top 4024@node Windows and MacOS
4026@appendix Windows and MacOS 4025@appendix Windows and MacOS
4027@cindex Windows 4026@cindex Windows
4028@cindex MacOS 4027@cindex MacOS
@@ -4062,13 +4061,13 @@ system. I am assuming that IDLWAVE has been installed in
4062 4061
4063@end lisp 4062@end lisp
4064 4063
4065@noindent Furthermore, Windows sometimes tries to outsmart you --- make 4064@noindent Furthermore, Windows sometimes tries to outsmart you; make
4066sure you check the following things: 4065sure you check the following things:
4067 4066
4068@itemize @bullet 4067@itemize @bullet
4069@item When you download the IDLWAVE distribution, make sure you save the 4068@item When you download the IDLWAVE distribution, make sure you save the
4070file under the names @file{idlwave.tar.gz}. 4069file under the names @file{idlwave.tar.gz}.
4071@item M-TAB switches among running programs --- use Esc-TAB 4070@item M-TAB switches among running programs---use Esc-TAB
4072instead. 4071instead.
4073@item Other issues as yet unnamed... 4072@item Other issues as yet unnamed...
4074@end itemize 4073@end itemize
@@ -4080,7 +4079,7 @@ help can skip the browser and use the HTMLHelp functionality directly.
4080@html 4079@html
4081<A NAME="TROUBLE"></A> 4080<A NAME="TROUBLE"></A>
4082@end html 4081@end html
4083@node Troubleshooting, GNU Free Documentation License, Windows and MacOS, Top 4082@node Troubleshooting
4084@appendix Troubleshooting 4083@appendix Troubleshooting
4085@cindex Troubleshooting 4084@cindex Troubleshooting
4086 4085
@@ -4286,11 +4285,11 @@ IDLWAVE is @samp{fsf-compat, xemacs-base, mail-lib}.
4286 4285
4287@end enumerate 4286@end enumerate
4288 4287
4289@node GNU Free Documentation License, Index, Troubleshooting, Top 4288@node GNU Free Documentation License
4290@appendix GNU Free Documentation License 4289@appendix GNU Free Documentation License
4291@include doclicense.texi 4290@include doclicense.texi
4292 4291
4293@node Index, , GNU Free Documentation License, Top 4292@node Index
4294@unnumbered Index 4293@unnumbered Index
4295@printindex cp 4294@printindex cp
4296 4295
diff --git a/doc/misc/info.texi b/doc/misc/info.texi
index 141b8da5728..70dfffde393 100644
--- a/doc/misc/info.texi
+++ b/doc/misc/info.texi
@@ -14,25 +14,18 @@
14This file describes how to use Info, the on-line, menu-driven GNU 14This file describes how to use Info, the on-line, menu-driven GNU
15documentation system. 15documentation system.
16 16
17Copyright @copyright{} 1989, 1992, 1996-2012 Free Software Foundation, Inc. 17Copyright @copyright{} 1989, 1992, 1996--2013 Free Software Foundation, Inc.
18 18
19@quotation 19@quotation
20Permission is granted to copy, distribute and/or modify this document 20Permission is granted to copy, distribute and/or modify this document
21under the terms of the GNU Free Documentation License, Version 1.3 or 21under the terms of the GNU Free Documentation License, Version 1.3 or
22any later version published by the Free Software Foundation; with no 22any later version published by the Free Software Foundation; with no
23Invariant Sections, with the Front-Cover texts being ``A GNU 23Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
24Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the 24and with the Back-Cover Texts as in (a) below. A copy of the license
25license is included in the section entitled ``GNU Free Documentation 25is included in the section entitled ``GNU Free Documentation License''.
26License'' in the Emacs manual.
27 26
28(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 27(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
29modify this GNU manual. Buying copies from the FSF supports it in 28modify this GNU manual.''
30developing GNU and promoting software freedom.''
31
32This document is part of a collection distributed under the GNU Free
33Documentation License. If you want to distribute this document
34separately from the collection, you can do so by adding a copy of the
35license to the document, as described in section 6 of the license.
36@end quotation 29@end quotation
37@end copying 30@end copying
38 31
@@ -84,6 +77,7 @@ Started' chapter.
84* Getting Started:: Getting started using an Info reader. 77* Getting Started:: Getting started using an Info reader.
85* Advanced:: Advanced Info commands. 78* Advanced:: Advanced Info commands.
86* Expert Info:: Info commands for experts. 79* Expert Info:: Info commands for experts.
80* GNU Free Documentation License:: The license for this documentation.
87* Index:: An index of topics, commands, and variables. 81* Index:: An index of topics, commands, and variables.
88@end menu 82@end menu
89 83
@@ -1504,6 +1498,10 @@ usually few.
1504To check an Info file, do @kbd{M-x Info-validate} while looking at any 1498To check an Info file, do @kbd{M-x Info-validate} while looking at any
1505node of the file with Emacs Info mode. 1499node of the file with Emacs Info mode.
1506 1500
1501@node GNU Free Documentation License
1502@appendix GNU Free Documentation License
1503@include doclicense.texi
1504
1507@node Index 1505@node Index
1508@unnumbered Index 1506@unnumbered Index
1509 1507
diff --git a/doc/misc/mairix-el.texi b/doc/misc/mairix-el.texi
index 1e835d44838..ff5b2ca6748 100644
--- a/doc/misc/mairix-el.texi
+++ b/doc/misc/mairix-el.texi
@@ -6,7 +6,7 @@
6@documentencoding ISO-8859-1 6@documentencoding ISO-8859-1
7 7
8@copying 8@copying
9Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. 9Copyright @copyright{} 2008--2013 Free Software Foundation, Inc.
10 10
11@quotation 11@quotation
12Permission is granted to copy, distribute and/or modify this document 12Permission is granted to copy, distribute and/or modify this document
@@ -17,8 +17,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
17is included in the section entitled ``GNU Free Documentation License''. 17is included in the section entitled ``GNU Free Documentation License''.
18 18
19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
20modify this GNU manual. Buying copies from the FSF supports it in 20modify this GNU manual.''
21developing GNU and promoting software freedom.''
22@end quotation 21@end quotation
23@end copying 22@end copying
24 23
@@ -28,7 +27,7 @@ developing GNU and promoting software freedom.''
28@end direntry 27@end direntry
29 28
30@titlepage 29@titlepage
31@title mairix.el - Mairix interface for Emacs 30@title mairix.el---Mairix interface for Emacs
32 31
33@author David Engster 32@author David Engster
34@page 33@page
@@ -39,7 +38,7 @@ developing GNU and promoting software freedom.''
39@contents 38@contents
40 39
41@node Top 40@node Top
42@top mairix.el - Mairix interface for Emacs 41@top mairix.el---Mairix interface for Emacs
43 42
44Mairix is a tool for indexing and searching words in locally stored 43Mairix is a tool for indexing and searching words in locally stored
45mail. It was written by Richard Curnow and is licensed under the 44mail. It was written by Richard Curnow and is licensed under the
@@ -61,6 +60,7 @@ database.
61* Setting up mairix.el:: Set up mairix.el 60* Setting up mairix.el:: Set up mairix.el
62* Using mairix.el:: List of interactive functions 61* Using mairix.el:: List of interactive functions
63* Extending mairix.el:: Support your favorite mail reader! 62* Extending mairix.el:: Support your favorite mail reader!
63* GNU Free Documentation License:: The license for this documentation.
64@end menu 64@end menu
65 65
66@node About mairix and mairix.el 66@node About mairix and mairix.el
@@ -346,6 +346,8 @@ Then add the functions to @code{mairix-display-functions} and
346 346
347And that's it! 347And that's it!
348 348
349 349@node GNU Free Documentation License
350@appendix GNU Free Documentation License
351@include doclicense.texi
350 352
351@bye 353@bye
diff --git a/doc/misc/makefile.w32-in b/doc/misc/makefile.w32-in
index 84ad720052e..11c76dcfcf7 100644
--- a/doc/misc/makefile.w32-in
+++ b/doc/misc/makefile.w32-in
@@ -1,6 +1,6 @@
1#### -*- Makefile -*- for documentation other than the Emacs manual. 1#### -*- Makefile -*- for documentation other than the Emacs manual.
2 2
3# Copyright (C) 2003-2012 Free Software Foundation, Inc. 3# Copyright (C) 2003-2013 Free Software Foundation, Inc.
4 4
5# This file is part of GNU Emacs. 5# This file is part of GNU Emacs.
6 6
@@ -56,7 +56,7 @@ INFO_TARGETS = $(infodir)/ccmode$(INFO_EXT) \
56 $(infodir)/auth$(INFO_EXT) $(infodir)/eieio$(INFO_EXT) $(infodir)/ede$(INFO_EXT) \ 56 $(infodir)/auth$(INFO_EXT) $(infodir)/eieio$(INFO_EXT) $(infodir)/ede$(INFO_EXT) \
57 $(infodir)/semantic$(INFO_EXT) $(infodir)/edt$(INFO_EXT) $(infodir)/emacs-gnutls$(INFO_EXT) \ 57 $(infodir)/semantic$(INFO_EXT) $(infodir)/edt$(INFO_EXT) $(infodir)/emacs-gnutls$(INFO_EXT) \
58 $(infodir)/srecode$(INFO_EXT) $(infodir)/bovine$(INFO_EXT) \ 58 $(infodir)/srecode$(INFO_EXT) $(infodir)/bovine$(INFO_EXT) \
59 $(infodir)/wisent$(INFO_EXT) 59 $(infodir)/wisent$(INFO_EXT) $(infodir)/htmlfontify$(INFO_EXT)
60DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \ 60DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \
61 ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \ 61 ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \
62 sieve.dvi pgg.dvi mh-e.dvi \ 62 sieve.dvi pgg.dvi mh-e.dvi \
@@ -68,7 +68,7 @@ DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \
68 remember.dvi nxml-mode.dvi \ 68 remember.dvi nxml-mode.dvi \
69 epa.dvi mairix-el.dvi sasl.dvi auth.dvi eieio.dvi ede.dvi \ 69 epa.dvi mairix-el.dvi sasl.dvi auth.dvi eieio.dvi ede.dvi \
70 semantic.dvi edt.dvi emacs-gnutls.dvi srecode.dvi bovine.dvi \ 70 semantic.dvi edt.dvi emacs-gnutls.dvi srecode.dvi bovine.dvi \
71 wisent.dvi 71 wisent.dvi htmlfontify.dvi
72INFOSOURCES = info.texi 72INFOSOURCES = info.texi
73 73
74# The following rule does not work with all versions of `make'. 74# The following rule does not work with all versions of `make'.
@@ -106,102 +106,100 @@ info.dvi: $(INFOSOURCES)
106 $(ENVADD) $(TEXI2DVI) $(srcdir)/info.texi 106 $(ENVADD) $(TEXI2DVI) $(srcdir)/info.texi
107 107
108 108
109$(infodir)/ccmode$(INFO_EXT): cc-mode.texi doclicense.texi 109$(infodir)/ccmode$(INFO_EXT): cc-mode.texi
110 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ cc-mode.texi 110 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ cc-mode.texi
111cc-mode.dvi: cc-mode.texi doclicense.texi 111cc-mode.dvi: cc-mode.texi
112 $(ENVADD) $(TEXI2DVI) $(srcdir)/cc-mode.texi 112 $(ENVADD) $(TEXI2DVI) $(srcdir)/cc-mode.texi
113 113
114$(infodir)/ada-mode$(INFO_EXT): ada-mode.texi doclicense.texi 114$(infodir)/ada-mode$(INFO_EXT): ada-mode.texi
115 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ada-mode.texi 115 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ada-mode.texi
116ada-mode.dvi: ada-mode.texi doclicense.texi 116ada-mode.dvi: ada-mode.texi
117 $(ENVADD) $(TEXI2DVI) $(srcdir)/ada-mode.texi 117 $(ENVADD) $(TEXI2DVI) $(srcdir)/ada-mode.texi
118 118
119$(infodir)/pcl-cvs$(INFO_EXT): pcl-cvs.texi doclicense.texi 119$(infodir)/pcl-cvs$(INFO_EXT): pcl-cvs.texi
120 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ pcl-cvs.texi 120 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ pcl-cvs.texi
121pcl-cvs.dvi: pcl-cvs.texi doclicense.texi 121pcl-cvs.dvi: pcl-cvs.texi
122 $(ENVADD) $(TEXI2DVI) $(srcdir)/pcl-cvs.texi 122 $(ENVADD) $(TEXI2DVI) $(srcdir)/pcl-cvs.texi
123 123
124$(infodir)/eshell$(INFO_EXT): eshell.texi doclicense.texi 124$(infodir)/eshell$(INFO_EXT): eshell.texi
125 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ eshell.texi 125 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ eshell.texi
126eshell.dvi: eshell.texi doclicense.texi 126eshell.dvi: eshell.texi
127 $(ENVADD) $(TEXI2DVI) $(srcdir)/eshell.texi 127 $(ENVADD) $(TEXI2DVI) $(srcdir)/eshell.texi
128 128
129$(infodir)/cl$(INFO_EXT): cl.texi doclicense.texi 129$(infodir)/cl$(INFO_EXT): cl.texi
130 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ cl.texi 130 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ cl.texi
131cl.dvi: cl.texi doclicense.texi 131cl.dvi: cl.texi
132 $(ENVADD) $(TEXI2DVI) $(srcdir)/cl.texi 132 $(ENVADD) $(TEXI2DVI) $(srcdir)/cl.texi
133 133
134$(infodir)/dbus$(INFO_EXT): dbus.texi doclicense.texi 134$(infodir)/dbus$(INFO_EXT): dbus.texi
135 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ dbus.texi 135 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ dbus.texi
136dbus.dvi: dbus.texi doclicense.texi 136dbus.dvi: dbus.texi
137 $(ENVADD) $(TEXI2DVI) $(srcdir)/dbus.texi 137 $(ENVADD) $(TEXI2DVI) $(srcdir)/dbus.texi
138 138
139$(infodir)/dired-x$(INFO_EXT): dired-x.texi $(emacsdir)/emacsver.texi doclicense.texi 139$(infodir)/dired-x$(INFO_EXT): dired-x.texi $(emacsdir)/emacsver.texi
140 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ dired-x.texi 140 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ dired-x.texi
141dired-x.dvi: dired-x.texi $(emacsdir)/emacsver.texi doclicense.texi 141dired-x.dvi: dired-x.texi $(emacsdir)/emacsver.texi
142 $(ENVADD) $(TEXI2DVI) $(srcdir)/dired-x.texi 142 $(ENVADD) $(TEXI2DVI) $(srcdir)/dired-x.texi
143 143
144$(infodir)/ediff$(INFO_EXT): ediff.texi doclicense.texi 144$(infodir)/ediff$(INFO_EXT): ediff.texi
145 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ediff.texi 145 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ediff.texi
146ediff.dvi: ediff.texi doclicense.texi 146ediff.dvi: ediff.texi
147 $(ENVADD) $(TEXI2DVI) $(srcdir)/ediff.texi 147 $(ENVADD) $(TEXI2DVI) $(srcdir)/ediff.texi
148 148
149$(infodir)/flymake$(INFO_EXT): flymake.texi doclicense.texi 149$(infodir)/flymake$(INFO_EXT): flymake.texi
150 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ flymake.texi 150 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ flymake.texi
151flymake.dvi: flymake.texi doclicense.texi 151flymake.dvi: flymake.texi
152 $(ENVADD) $(TEXI2DVI) $(srcdir)/flymake.texi 152 $(ENVADD) $(TEXI2DVI) $(srcdir)/flymake.texi
153 153
154$(infodir)/forms$(INFO_EXT): forms.texi doclicense.texi 154$(infodir)/forms$(INFO_EXT): forms.texi
155 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ forms.texi 155 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ forms.texi
156forms.dvi: forms.texi doclicense.texi 156forms.dvi: forms.texi
157 $(ENVADD) $(TEXI2DVI) $(srcdir)/forms.texi 157 $(ENVADD) $(TEXI2DVI) $(srcdir)/forms.texi
158 158
159# gnus/message/emacs-mime/sieve/pgg are part of Gnus: 159# gnus/message/emacs-mime/sieve/pgg are part of Gnus:
160$(infodir)/gnus$(INFO_EXT): gnus.texi gnus-overrides.texi message.texi emacs-mime.texi \ 160$(infodir)/gnus$(INFO_EXT): gnus.texi gnus-overrides.texi message.texi emacs-mime.texi \
161 sieve.texi pgg.texi sasl.texi gnus-news.texi gnus-faq.texi \ 161 sieve.texi pgg.texi sasl.texi gnus-news.texi gnus-faq.texi
162 doclicense.texi
163 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ gnus.texi 162 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ gnus.texi
164gnus.dvi: gnus.texi gnus-overrides.texi message.texi emacs-mime.texi \ 163gnus.dvi: gnus.texi gnus-overrides.texi message.texi emacs-mime.texi \
165 sieve.texi pgg.texi sasl.texi gnus-news.texi gnus-faq.texi \ 164 sieve.texi pgg.texi sasl.texi gnus-news.texi gnus-faq.texi
166 doclicense.texi
167 sed -e "/@iflatex/,/@end iflatex/d" $(srcdir)/gnus.texi > gnustmp.texi 165 sed -e "/@iflatex/,/@end iflatex/d" $(srcdir)/gnus.texi > gnustmp.texi
168 $(ENVADD) $(TEXI2DVI) gnustmp.texi 166 $(ENVADD) $(TEXI2DVI) gnustmp.texi
169 cp gnustmp.dvi $*.dvi 167 cp gnustmp.dvi $*.dvi
170 rm gnustmp.* 168 rm gnustmp.*
171# 169#
172$(infodir)/message$(INFO_EXT): message.texi gnus-overrides.texi doclicense.texi 170$(infodir)/message$(INFO_EXT): message.texi gnus-overrides.texi
173 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ message.texi 171 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ message.texi
174message.dvi: message.texi gnus-overrides.texi doclicense.texi 172message.dvi: message.texi gnus-overrides.texi
175 $(ENVADD) $(TEXI2DVI) $(srcdir)/message.texi 173 $(ENVADD) $(TEXI2DVI) $(srcdir)/message.texi
176# 174#
177$(infodir)/emacs-mime$(INFO_EXT): emacs-mime.texi gnus-overrides.texi doclicense.texi 175$(infodir)/emacs-mime$(INFO_EXT): emacs-mime.texi gnus-overrides.texi
178 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ --enable-encoding emacs-mime.texi 176 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ --enable-encoding emacs-mime.texi
179emacs-mime.dvi: emacs-mime.texi gnus-overrides.texi doclicense.texi 177emacs-mime.dvi: emacs-mime.texi gnus-overrides.texi
180 $(ENVADD) $(TEXI2DVI) $(srcdir)/emacs-mime.texi 178 $(ENVADD) $(TEXI2DVI) $(srcdir)/emacs-mime.texi
181# 179#
182$(infodir)/sieve$(INFO_EXT): sieve.texi gnus-overrides.texi doclicense.texi 180$(infodir)/sieve$(INFO_EXT): sieve.texi gnus-overrides.texi
183 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ sieve.texi 181 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ sieve.texi
184sieve.dvi: sieve.texi gnus-overrides.texi doclicense.texi 182sieve.dvi: sieve.texi gnus-overrides.texi
185 $(ENVADD) $(TEXI2DVI) $(srcdir)/sieve.texi 183 $(ENVADD) $(TEXI2DVI) $(srcdir)/sieve.texi
186# 184#
187$(infodir)/pgg$(INFO_EXT): pgg.texi gnus-overrides.texi doclicense.texi 185$(infodir)/pgg$(INFO_EXT): pgg.texi gnus-overrides.texi
188 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ pgg.texi 186 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ pgg.texi
189pgg.dvi: pgg.texi gnus-overrides.texi doclicense.texi 187pgg.dvi: pgg.texi gnus-overrides.texi
190 $(ENVADD) $(TEXI2DVI) $(srcdir)/pgg.texi 188 $(ENVADD) $(TEXI2DVI) $(srcdir)/pgg.texi
191 189
192$(infodir)/mh-e$(INFO_EXT): mh-e.texi doclicense.texi gpl.texi 190$(infodir)/mh-e$(INFO_EXT): mh-e.texi gpl.texi
193 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ mh-e.texi 191 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ mh-e.texi
194mh-e.dvi: mh-e.texi doclicense.texi gpl.texi 192mh-e.dvi: mh-e.texi gpl.texi
195 $(ENVADD) $(TEXI2DVI) $(srcdir)/mh-e.texi 193 $(ENVADD) $(TEXI2DVI) $(srcdir)/mh-e.texi
196 194
197$(infodir)/reftex$(INFO_EXT): reftex.texi doclicense.texi 195$(infodir)/reftex$(INFO_EXT): reftex.texi
198 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ reftex.texi 196 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ reftex.texi
199reftex.dvi: reftex.texi doclicense.texi 197reftex.dvi: reftex.texi
200 $(ENVADD) $(TEXI2DVI) $(srcdir)/reftex.texi 198 $(ENVADD) $(TEXI2DVI) $(srcdir)/reftex.texi
201 199
202$(infodir)/remember$(INFO_EXT): remember.texi doclicense.texi 200$(infodir)/remember$(INFO_EXT): remember.texi
203 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ remember.texi 201 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ remember.texi
204remember.dvi: remember.texi doclicense.texix 202remember.dvi: remember.texix
205 $(ENVADD) $(TEXI2DVI) $(srcdir)/remember.texi 203 $(ENVADD) $(TEXI2DVI) $(srcdir)/remember.texi
206 204
207$(infodir)/sasl$(INFO_EXT): sasl.texi gnus-overrides.texi 205$(infodir)/sasl$(INFO_EXT): sasl.texi gnus-overrides.texi
@@ -209,24 +207,24 @@ $(infodir)/sasl$(INFO_EXT): sasl.texi gnus-overrides.texi
209sasl.dvi: sasl.texi gnus-overrides.texi 207sasl.dvi: sasl.texi gnus-overrides.texi
210 $(ENVADD) $(TEXI2DVI) $(srcdir)/sasl.texi 208 $(ENVADD) $(TEXI2DVI) $(srcdir)/sasl.texi
211 209
212$(infodir)/sc$(INFO_EXT): sc.texi doclicense.texi 210$(infodir)/sc$(INFO_EXT): sc.texi
213 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ sc.texi 211 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ sc.texi
214sc.dvi: sc.texi doclicense.texi 212sc.dvi: sc.texi
215 $(ENVADD) $(TEXI2DVI) $(srcdir)/sc.texi 213 $(ENVADD) $(TEXI2DVI) $(srcdir)/sc.texi
216 214
217$(infodir)/vip$(INFO_EXT): vip.texi doclicense.texi 215$(infodir)/vip$(INFO_EXT): vip.texi
218 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ vip.texi 216 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ vip.texi
219vip.dvi: vip.texi doclicense.texi 217vip.dvi: vip.texi
220 $(ENVADD) $(TEXI2DVI) $(srcdir)/vip.texi 218 $(ENVADD) $(TEXI2DVI) $(srcdir)/vip.texi
221 219
222$(infodir)/viper$(INFO_EXT): viper.texi doclicense.texi 220$(infodir)/viper$(INFO_EXT): viper.texi
223 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ viper.texi 221 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ viper.texi
224viper.dvi: viper.texi doclicense.texi 222viper.dvi: viper.texi
225 $(ENVADD) $(TEXI2DVI) $(srcdir)/viper.texi 223 $(ENVADD) $(TEXI2DVI) $(srcdir)/viper.texi
226 224
227$(infodir)/widget$(INFO_EXT): widget.texi doclicense.texi 225$(infodir)/widget$(INFO_EXT): widget.texi
228 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ widget.texi 226 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ widget.texi
229widget.dvi: widget.texi doclicense.texi 227widget.dvi: widget.texi
230 $(ENVADD) $(TEXI2DVI) $(srcdir)/widget.texi 228 $(ENVADD) $(TEXI2DVI) $(srcdir)/widget.texi
231 229
232$(infodir)/efaq$(INFO_EXT): faq.texi $(emacsdir)/emacsver.texi 230$(infodir)/efaq$(INFO_EXT): faq.texi $(emacsdir)/emacsver.texi
@@ -234,56 +232,56 @@ $(infodir)/efaq$(INFO_EXT): faq.texi $(emacsdir)/emacsver.texi
234faq.dvi: faq.texi $(emacsdir)/emacsver.texi 232faq.dvi: faq.texi $(emacsdir)/emacsver.texi
235 $(ENVADD) $(TEXI2DVI) $(srcdir)/faq.texi 233 $(ENVADD) $(TEXI2DVI) $(srcdir)/faq.texi
236 234
237$(infodir)/autotype$(INFO_EXT): autotype.texi doclicense.texi 235$(infodir)/autotype$(INFO_EXT): autotype.texi
238 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ autotype.texi 236 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ autotype.texi
239autotype.dvi: autotype.texi doclicense.texi 237autotype.dvi: autotype.texi
240 $(ENVADD) $(TEXI2DVI) $(srcdir)/autotype.texi 238 $(ENVADD) $(TEXI2DVI) $(srcdir)/autotype.texi
241 239
242$(infodir)/calc$(INFO_EXT): calc.texi $(emacsdir)/emacsver.texi gpl.texi doclicense.texi 240$(infodir)/calc$(INFO_EXT): calc.texi $(emacsdir)/emacsver.texi gpl.texi
243 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ calc.texi 241 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ calc.texi
244calc.dvi: calc.texi $(emacsdir)/emacsver.texi gpl.texi doclicense.texi 242calc.dvi: calc.texi $(emacsdir)/emacsver.texi gpl.texi
245 $(ENVADD) $(TEXI2DVI) $(srcdir)/calc.texi 243 $(ENVADD) $(TEXI2DVI) $(srcdir)/calc.texi
246 244
247# This is produced with --no-split to avoid making files whose 245# This is produced with --no-split to avoid making files whose
248# names clash on DOS 8+3 filesystems 246# names clash on DOS 8+3 filesystems
249$(infodir)/idlwave$(INFO_EXT): idlwave.texi doclicense.texi 247$(infodir)/idlwave$(INFO_EXT): idlwave.texi
250 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ idlwave.texi 248 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ idlwave.texi
251idlwave.dvi: idlwave.texi doclicense.texi 249idlwave.dvi: idlwave.texi
252 $(ENVADD) $(TEXI2DVI) $(srcdir)/idlwave.texi 250 $(ENVADD) $(TEXI2DVI) $(srcdir)/idlwave.texi
253 251
254$(infodir)/eudc$(INFO_EXT): eudc.texi doclicense.texi 252$(infodir)/eudc$(INFO_EXT): eudc.texi
255 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ eudc.texi 253 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ eudc.texi
256eudc.dvi: eudc.texi doclicense.texi 254eudc.dvi: eudc.texi
257 $(ENVADD) $(TEXI2DVI) $(srcdir)/eudc.texi 255 $(ENVADD) $(TEXI2DVI) $(srcdir)/eudc.texi
258 256
259$(infodir)/ebrowse$(INFO_EXT): ebrowse.texi doclicense.texi 257$(infodir)/ebrowse$(INFO_EXT): ebrowse.texi
260 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ebrowse.texi 258 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ebrowse.texi
261ebrowse.dvi: ebrowse.texi doclicense.texi 259ebrowse.dvi: ebrowse.texi
262 $(ENVADD) $(TEXI2DVI) $(srcdir)/ebrowse.texi 260 $(ENVADD) $(TEXI2DVI) $(srcdir)/ebrowse.texi
263 261
264$(infodir)/woman$(INFO_EXT): woman.texi doclicense.texi 262$(infodir)/woman$(INFO_EXT): woman.texi $(emacsdir)/emacsver.texi
265 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ woman.texi 263 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ woman.texi
266woman.dvi: woman.texi doclicense.texi 264woman.dvi: woman.texi $(emacsdir)/emacsver.texi
267 $(ENVADD) $(TEXI2DVI) $(srcdir)/woman.texi 265 $(ENVADD) $(TEXI2DVI) $(srcdir)/woman.texi
268 266
269$(infodir)/speedbar$(INFO_EXT): speedbar.texi doclicense.texi 267$(infodir)/speedbar$(INFO_EXT): speedbar.texi
270 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ speedbar.texi 268 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ speedbar.texi
271speedbar.dvi: speedbar.texi doclicense.texi 269speedbar.dvi: speedbar.texi
272 $(ENVADD) $(TEXI2DVI) $(srcdir)/speedbar.texi 270 $(ENVADD) $(TEXI2DVI) $(srcdir)/speedbar.texi
273 271
274$(infodir)/tramp$(INFO_EXT): tramp.texi trampver.texi doclicense.texi 272$(infodir)/tramp$(INFO_EXT): tramp.texi trampver.texi
275 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ tramp.texi 273 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ tramp.texi
276tramp.dvi: tramp.texi trampver.texi doclicense.texi 274tramp.dvi: tramp.texi trampver.texi
277 $(ENVADD) $(TEXI2DVI) $(srcdir)/tramp.texi 275 $(ENVADD) $(TEXI2DVI) $(srcdir)/tramp.texi
278 276
279$(infodir)/ses$(INFO_EXT): ses.texi doclicense.texi 277$(infodir)/ses$(INFO_EXT): ses.texi
280 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ses.texi 278 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ses.texi
281ses.dvi: ses.texi doclicense.texi 279ses.dvi: ses.texi
282 $(ENVADD) $(TEXI2DVI) $(srcdir)/ses.texi 280 $(ENVADD) $(TEXI2DVI) $(srcdir)/ses.texi
283 281
284$(infodir)/smtpmail$(INFO_EXT): smtpmail.texi doclicense.texi 282$(infodir)/smtpmail$(INFO_EXT): smtpmail.texi
285 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ smtpmail.texi 283 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ smtpmail.texi
286smtpmail.dvi: smtpmail.texi doclicense.texi 284smtpmail.dvi: smtpmail.texi
287 $(ENVADD) $(TEXI2DVI) $(srcdir)/smtpmail.texi 285 $(ENVADD) $(TEXI2DVI) $(srcdir)/smtpmail.texi
288 286
289$(infodir)/org$(INFO_EXT): org.texi 287$(infodir)/org$(INFO_EXT): org.texi
@@ -291,14 +289,14 @@ $(infodir)/org$(INFO_EXT): org.texi
291org.dvi: org.texi 289org.dvi: org.texi
292 $(ENVADD) $(TEXI2DVI) $(srcdir)/org.texi 290 $(ENVADD) $(TEXI2DVI) $(srcdir)/org.texi
293 291
294$(infodir)/url$(INFO_EXT): url.texi doclicense.texi 292$(infodir)/url$(INFO_EXT): url.texi
295 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ url.texi 293 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ url.texi
296url.dvi: url.texi doclicense.texi 294url.dvi: url.texi
297 $(ENVADD) $(TEXI2DVI) $(srcdir)/url.texi 295 $(ENVADD) $(TEXI2DVI) $(srcdir)/url.texi
298 296
299$(infodir)/newsticker$(INFO_EXT): newsticker.texi doclicense.texi 297$(infodir)/newsticker$(INFO_EXT): newsticker.texi
300 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ newsticker.texi 298 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ newsticker.texi
301newsticker.dvi: newsticker.texi doclicense.texi 299newsticker.dvi: newsticker.texi
302 $(ENVADD) $(TEXI2DVI) $(srcdir)/newsticker.texi 300 $(ENVADD) $(TEXI2DVI) $(srcdir)/newsticker.texi
303 301
304$(infodir)/nxml-mode$(INFO_EXT): nxml-mode.texi 302$(infodir)/nxml-mode$(INFO_EXT): nxml-mode.texi
@@ -306,14 +304,14 @@ $(infodir)/nxml-mode$(INFO_EXT): nxml-mode.texi
306nxml-mod.dvi: nxml-mode.texi 304nxml-mod.dvi: nxml-mode.texi
307 $(ENVADD) $(TEXI2DVI) $(srcdir)/nxml-mode.texi 305 $(ENVADD) $(TEXI2DVI) $(srcdir)/nxml-mode.texi
308 306
309$(infodir)/rcirc$(INFO_EXT): rcirc.texi doclicense.texi 307$(infodir)/rcirc$(INFO_EXT): rcirc.texi
310 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ rcirc.texi 308 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ rcirc.texi
311rcirc.dvi: rcirc.texi doclicense.texi 309rcirc.dvi: rcirc.texi
312 $(ENVADD) $(TEXI2DVI) $(srcdir)/rcirc.texi 310 $(ENVADD) $(TEXI2DVI) $(srcdir)/rcirc.texi
313 311
314$(infodir)/erc$(INFO_EXT): erc.texi gpl.texi doclicense.texi 312$(infodir)/erc$(INFO_EXT): erc.texi
315 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ erc.texi 313 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ erc.texi
316erc.dvi: erc.texi gpl.texi doclicense.texi 314erc.dvi: erc.texi
317 $(ENVADD) $(TEXI2DVI) $(srcdir)/erc.texi 315 $(ENVADD) $(TEXI2DVI) $(srcdir)/erc.texi
318 316
319$(infodir)/ert$(INFO_EXT): ert.texi 317$(infodir)/ert$(INFO_EXT): ert.texi
@@ -346,36 +344,45 @@ $(infodir)/ede$(INFO_EXT): ede.texi
346ede.dvi: ede.texi 344ede.dvi: ede.texi
347 $(ENVADD) $(TEXI2DVI) $(srcdir)/ede.texi 345 $(ENVADD) $(TEXI2DVI) $(srcdir)/ede.texi
348 346
349$(infodir)/semantic$(INFO_EXT): semantic.texi sem-user.texi doclicense.texi 347$(infodir)/semantic$(INFO_EXT): semantic.texi sem-user.texi
350 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ semantic.texi 348 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ semantic.texi
351semantic.dvi: semantic.texi sem-user.texi doclicense.texi 349semantic.dvi: semantic.texi sem-user.texi
352 $(ENVADD) $(TEXI2DVI) $(srcdir)/semantic.texi 350 $(ENVADD) $(TEXI2DVI) $(srcdir)/semantic.texi
353 351
354$(infodir)/edt$(INFO_EXT): edt.texi doclicense.texi 352$(infodir)/edt$(INFO_EXT): edt.texi
355 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ edt.texi 353 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ edt.texi
356edt.dvi: edt.texi doclicense.texi 354edt.dvi: edt.texi
357 $(ENVADD) $(TEXI2DVI) $(srcdir)/edt.texi 355 $(ENVADD) $(TEXI2DVI) $(srcdir)/edt.texi
358 356
359$(infodir)/emacs-gnutls$(INFO_EXT): emacs-gnutls.texi doclicense.texi 357$(infodir)/emacs-gnutls$(INFO_EXT): emacs-gnutls.texi
360 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ emacs-gnutls.texi 358 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ emacs-gnutls.texi
361emacs-gnutls.dvi: emacs-gnutls.texi doclicense.texi 359emacs-gnutls.dvi: emacs-gnutls.texi
362 $(ENVADD) $(TEXI2DVI) $(srcdir)/emacs-gnutls.texi 360 $(ENVADD) $(TEXI2DVI) $(srcdir)/emacs-gnutls.texi
363 361
364$(infodir)/srecode$(INFO_EXT): srecode.texi doclicense.texi 362$(infodir)/srecode$(INFO_EXT): srecode.texi
365 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ srecode.texi 363 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ srecode.texi
366srecode.dvi: srecode.texi doclicense.texi 364srecode.dvi: srecode.texi
367 $(ENVADD) $(TEXI2DVI) $(srcdir)/srecode.texi 365 $(ENVADD) $(TEXI2DVI) $(srcdir)/srecode.texi
368 366
369$(infodir)/bovine$(INFO_EXT): bovine.texi doclicense.texi 367$(infodir)/bovine$(INFO_EXT): bovine.texi
370 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ bovine.texi 368 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ bovine.texi
371bovine.dvi: bovine.texi doclicense.texi 369bovine.dvi: bovine.texi
372 $(ENVADD) $(TEXI2DVI) $(srcdir)/bovine.texi 370 $(ENVADD) $(TEXI2DVI) $(srcdir)/bovine.texi
373 371
374$(infodir)/wisent$(INFO_EXT): wisent.texi doclicense.texi 372$(infodir)/wisent$(INFO_EXT): wisent.texi
375 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ wisent.texi 373 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ wisent.texi
376wisent.dvi: wisent.texi doclicense.texi 374wisent.dvi: wisent.texi
377 $(ENVADD) $(TEXI2DVI) $(srcdir)/wisent.texi 375 $(ENVADD) $(TEXI2DVI) $(srcdir)/wisent.texi
378 376
377$(infodir)/htmlfontify$(INFO_EXT): htmlfontify.texi
378 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ htmlfontify.texi
379htmlfontify.dvi: htmlfontify.texi
380 $(ENVADD) $(TEXI2DVI) $(srcdir)/htmlfontify.texi
381
382
383$(INFO_TARGETS): doclicense.texi
384$(DVI_TARGETS): doclicense.texi
385
379mostlyclean: 386mostlyclean:
380 - $(DEL) *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.* 387 - $(DEL) *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.*
381 388
@@ -405,7 +412,8 @@ clean: mostlyclean
405 $(infodir)/eieio* $(infodir)/ede* \ 412 $(infodir)/eieio* $(infodir)/ede* \
406 $(infodir)/semantic* $(infodir)edt* \ 413 $(infodir)/semantic* $(infodir)edt* \
407 $(infodir)/emacs-gnutls* $(infodir)/srecode* \ 414 $(infodir)/emacs-gnutls* $(infodir)/srecode* \
408 $(infodir)/bovine* $(infodir)/wisent* 415 $(infodir)/bovine* $(infodir)/wisent* \
416 $(infodir)/htmlfontify*
409 417
410distclean: clean 418distclean: clean
411 - $(DEL) makefile 419 - $(DEL) makefile
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index 68e14c9b253..0e0bd115bb2 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -10,7 +10,7 @@
10@copying 10@copying
11This file documents Message, the Emacs message composition mode. 11This file documents Message, the Emacs message composition mode.
12 12
13Copyright @copyright{} 1996-2012 Free Software Foundation, Inc. 13Copyright @copyright{} 1996--2013 Free Software Foundation, Inc.
14 14
15@quotation 15@quotation
16Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -21,8 +21,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
21is included in the section entitled ``GNU Free Documentation License''. 21is included in the section entitled ``GNU Free Documentation License''.
22 22
23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
24modify this GNU manual. Buying copies from the FSF supports it in 24modify this GNU manual.''
25developing GNU and promoting software freedom.''
26@end quotation 25@end quotation
27@end copying 26@end copying
28 27
@@ -477,7 +476,7 @@ You can use one or more of the above variables. All their values are
477Now you are all set. Just start composing a message as you normally do. 476Now you are all set. Just start composing a message as you normally do.
478And just send it; as always. Just before the message is sent out, Gnus' 477And just send it; as always. Just before the message is sent out, Gnus'
479MFT generation thingy kicks in and checks if the message already has a 478MFT generation thingy kicks in and checks if the message already has a
480MFT field. If there is one, it is left alone. (Except if it's empty - 479MFT field. If there is one, it is left alone. (Except if it's empty;
481in that case, the field is removed and is not replaced with an 480in that case, the field is removed and is not replaced with an
482automatically generated one. This lets you disable MFT generation on a 481automatically generated one. This lets you disable MFT generation on a
483per-message basis.) If there is none, then the list of recipient 482per-message basis.) If there is none, then the list of recipient
@@ -2207,12 +2206,12 @@ This function won't add the header if the header is already present.
2207 2206
2208@item message-send-mail-hook 2207@item message-send-mail-hook
2209@vindex message-send-mail-hook 2208@vindex message-send-mail-hook
2210Hook run before sending mail messages. This hook is run very late -- 2209Hook run before sending mail messages. This hook is run very late:
2211just before the message is actually sent as mail. 2210just before the message is actually sent as mail.
2212 2211
2213@item message-send-news-hook 2212@item message-send-news-hook
2214@vindex message-send-news-hook 2213@vindex message-send-news-hook
2215Hook run before sending news messages. This hook is run very late -- 2214Hook run before sending news messages. This hook is run very late:
2216just before the message is actually sent as news. 2215just before the message is actually sent as news.
2217 2216
2218@item message-sent-hook 2217@item message-sent-hook
diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi
index 06ab93f91c7..756d5d52996 100644
--- a/doc/misc/mh-e.texi
+++ b/doc/misc/mh-e.texi
@@ -24,7 +24,8 @@
24This is version @value{VERSION}@value{EDITION} of @cite{The MH-E 24This is version @value{VERSION}@value{EDITION} of @cite{The MH-E
25Manual}, last updated @value{UPDATED}. 25Manual}, last updated @value{UPDATED}.
26 26
27Copyright @copyright{} 1995, 2001-2003, 2005-2012 Free Software Foundation, Inc. 27Copyright @copyright{} 1995, 2001--2003, 2005--2013 Free Software
28Foundation, Inc.
28 29
29@c This dual license has been agreed upon by the FSF. 30@c This dual license has been agreed upon by the FSF.
30 31
@@ -41,8 +42,7 @@ Back-Cover Texts as in (a) below. A copy of the license is included in
41the section entitled ``GNU Free Documentation License.'' 42the section entitled ``GNU Free Documentation License.''
42 43
43(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 44(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
44modify this GNU manual. Buying copies from the FSF supports it in 45modify this GNU manual.''
45developing GNU and promoting software freedom.''
46 46
47@item 47@item
48the GNU General Public License as published by the Free Software 48the GNU General Public License as published by the Free Software
@@ -215,7 +215,7 @@ The MH-E package is distributed with Emacs@footnote{Version
215@value{VERSION} of MH-E appeared in Emacs 24.4. It is supported in GNU 215@value{VERSION} of MH-E appeared in Emacs 24.4. It is supported in GNU
216Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is 216Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is
217known not to work with GNU Emacs versions 20 and below, and XEmacs 217known not to work with GNU Emacs versions 20 and below, and XEmacs
218version 21.5.9 - 21.5.16. It is compatible with MH versions 6.8.4 and 218version 21.5.9--21.5.16. It is compatible with MH versions 6.8.4 and
219higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you 219higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you
220shouldn't have to do anything special to use it. Gnus is also 220shouldn't have to do anything special to use it. Gnus is also
221required; version 5.10 or higher is recommended. This manual covers 221required; version 5.10 or higher is recommended. This manual covers
@@ -5645,7 +5645,7 @@ The command @kbd{C-c C-w} (@code{mh-check-whom}) expands aliases so
5645you can check the actual address(es) in the alias. A new buffer named 5645you can check the actual address(es) in the alias. A new buffer named
5646@samp{*MH-E Recipients*} is created with the output of @command{whom} 5646@samp{*MH-E Recipients*} is created with the output of @command{whom}
5647(@pxref{Miscellaneous})@footnote{See the section 5647(@pxref{Miscellaneous})@footnote{See the section
5648@uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now? -- and the 5648@uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now?---and the
5649whatnow Program} in the MH book.}. 5649whatnow Program} in the MH book.}.
5650 5650
5651@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts 5651@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts
@@ -7763,7 +7763,7 @@ all of your interesting messages and add a couple of points to be
7763conservative. Add that many dots to the @samp{X-Spam-Level:} header 7763conservative. Add that many dots to the @samp{X-Spam-Level:} header
7764field above to send messages with that score down the drain. 7764field above to send messages with that score down the drain.
7765 7765
7766In the example above, messages with a score of 5-9 are set aside in 7766In the example above, messages with a score of 5--9 are set aside in
7767the @samp{+spam} folder for later review. The major weakness of 7767the @samp{+spam} folder for later review. The major weakness of
7768rules-based filters is a plethora of false positives so it is 7768rules-based filters is a plethora of false positives so it is
7769worthwhile to check. 7769worthwhile to check.
@@ -8665,7 +8665,7 @@ In order to send mail within Gnus using MH-E, set this option to
8665Since Gnus keeps track of which messages you have read, it would be 8665Since Gnus keeps track of which messages you have read, it would be
8666bad if Gnus expired the last message, for example, message 100, and 8666bad if Gnus expired the last message, for example, message 100, and
8667@command{rcvstore} gave the next new message number 1. Gnus would then 8667@command{rcvstore} gave the next new message number 1. Gnus would then
8668ignore it since it thinks that you've read messages 1-100. Turning on 8668ignore it since it thinks that you've read messages 1--100. Turning on
8669this option ensures that the last message is never removed thereby 8669this option ensures that the last message is never removed thereby
8670eliminating this problem. 8670eliminating this problem.
8671@end vtable 8671@end vtable
@@ -8882,7 +8882,7 @@ same structure as MH-E (i.e., invoked MH programs), though it was
8882simpler and the commands were slightly different. Unfortunately, I no 8882simpler and the commands were slightly different. Unfortunately, I no
8883longer have a copy so the differences are lost in the mists of time. 8883longer have a copy so the differences are lost in the mists of time.
8884 8884
8885In '82-83, I was working at BBN and wrote a lot of mlisp code in 8885In '82--83, I was working at BBN and wrote a lot of mlisp code in
8886Gosling Emacs to make it look more like Tennex Emacs. One of the 8886Gosling Emacs to make it look more like Tennex Emacs. One of the
8887packages that I picked up and improved was Reid's mail system. In '83, 8887packages that I picked up and improved was Reid's mail system. In '83,
8888I went back to Berkeley. About that time, Stallman's first version of 8888I went back to Berkeley. About that time, Stallman's first version of
diff --git a/doc/misc/newsticker.texi b/doc/misc/newsticker.texi
index 60510f41e71..8f37453524c 100644
--- a/doc/misc/newsticker.texi
+++ b/doc/misc/newsticker.texi
@@ -13,7 +13,7 @@
13This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}). 13This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}).
14 14
15@noindent 15@noindent
16Copyright @copyright{} 2004-2012 Free Software Foundation, Inc. 16Copyright @copyright{} 2004--2013 Free Software Foundation, Inc.
17 17
18@quotation 18@quotation
19Permission is granted to copy, distribute and/or modify this document 19Permission is granted to copy, distribute and/or modify this document
@@ -24,8 +24,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
24is included in the section entitled ``GNU Free Documentation License''. 24is included in the section entitled ``GNU Free Documentation License''.
25 25
26(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 26(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
27modify this GNU manual. Buying copies from the FSF supports it in 27modify this GNU manual.''
28developing GNU and promoting software freedom.''
29@end quotation 28@end quotation
30@end copying 29@end copying
31 30
@@ -35,7 +34,7 @@ developing GNU and promoting software freedom.''
35@end direntry 34@end direntry
36 35
37@titlepage 36@titlepage
38@title Newsticker -- a Newsticker for Emacs 37@title Newsticker---a Newsticker for Emacs
39@subtitle for version @value{VERSION}, @value{UPDATED} 38@subtitle for version @value{VERSION}, @value{UPDATED}
40@author Ulf Jasper 39@author Ulf Jasper
41@author @email{ulf.jasper@@web.de} 40@author @email{ulf.jasper@@web.de}
@@ -132,8 +131,8 @@ which contains @file{xml.el} for XEmacs.
132Newsticker retrieves headlines either via Emacs's built-in retrieval 131Newsticker retrieves headlines either via Emacs's built-in retrieval
133functions, by an arbitrary external program that retrieves files via 132functions, by an arbitrary external program that retrieves files via
134http and prints them to stdout (like 133http and prints them to stdout (like
135@uref{http://www.gnu.org/software/wget/wget.html, wget}, or -- on a 134@uref{http://www.gnu.org/software/wget/wget.html, wget}, or---on a
136per feed basis -- via an arbitrary Lisp command. 135per feed basis---via an arbitrary Lisp command.
137 136
138 137
139@node Installation 138@node Installation
diff --git a/doc/misc/nxml-mode.texi b/doc/misc/nxml-mode.texi
index a0e34b2cf5a..13e91d12819 100644
--- a/doc/misc/nxml-mode.texi
+++ b/doc/misc/nxml-mode.texi
@@ -8,25 +8,18 @@
8This manual documents nXML mode, an Emacs major mode for editing 8This manual documents nXML mode, an Emacs major mode for editing
9XML with RELAX NG support. 9XML with RELAX NG support.
10 10
11Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. 11Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
12 12
13@quotation 13@quotation
14Permission is granted to copy, distribute and/or modify this document 14Permission is granted to copy, distribute and/or modify this document
15under the terms of the GNU Free Documentation License, Version 1.3 or 15under the terms of the GNU Free Documentation License, Version 1.3 or
16any later version published by the Free Software Foundation; with no 16any later version published by the Free Software Foundation; with no
17Invariant Sections, with the Front-Cover texts being ``A GNU 17Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
18Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the 18and with the Back-Cover Texts as in (a) below. A copy of the license
19license is included in the section entitled ``GNU Free Documentation 19is included in the section entitled ``GNU Free Documentation License''.
20License'' in the Emacs manual.
21 20
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 22modify this GNU manual.''
24developing GNU and promoting software freedom.''
25
26This document is part of a collection distributed under the GNU Free
27Documentation License. If you want to distribute this document
28separately from the collection, you can do so by adding a copy of the
29license to the document, as described in section 6 of the license.
30@end quotation 23@end quotation
31@end copying 24@end copying
32 25
@@ -51,6 +44,7 @@ This manual is not yet complete.
51* Locating a schema:: 44* Locating a schema::
52* DTDs:: 45* DTDs::
53* Limitations:: 46* Limitations::
47* GNU Free Documentation License:: The license for this documentation.
54@end menu 48@end menu
55 49
56@node Introduction 50@node Introduction
@@ -899,4 +893,8 @@ The restrictions on RELAX NG schemas in section 7 of the RELAX NG
899specification are not enforced. 893specification are not enforced.
900@end itemize 894@end itemize
901 895
896@node GNU Free Documentation License
897@appendix GNU Free Documentation License
898@include doclicense.texi
899
902@bye 900@bye
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 4ff91976c37..bea130ccb43 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -262,7 +262,7 @@
262@copying 262@copying
263This manual is for Org version @value{VERSION}. 263This manual is for Org version @value{VERSION}.
264 264
265Copyright @copyright{} 2004-2012 Free Software Foundation, Inc. 265Copyright @copyright{} 2004--2013 Free Software Foundation, Inc.
266 266
267@quotation 267@quotation
268Permission is granted to copy, distribute and/or modify this document 268Permission is granted to copy, distribute and/or modify this document
@@ -273,13 +273,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
273is included in the section entitled ``GNU Free Documentation License.'' 273is included in the section entitled ``GNU Free Documentation License.''
274 274
275(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 275(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
276modify this GNU manual. Buying copies from the FSF supports it in 276modify this GNU manual.''
277developing GNU and promoting software freedom.''
278
279This document is part of a collection distributed under the GNU Free
280Documentation License. If you want to distribute this document
281separately from the collection, you can do so by adding a copy of the
282license to the document, as described in section 6 of the license.
283@end quotation 277@end quotation
284@end copying 278@end copying
285 279
@@ -305,6 +299,9 @@ with contributions by David O'Toole, Bastien Guerry, Philip Rooke, Dan Davison,
305@contents 299@contents
306 300
307@ifnottex 301@ifnottex
302@c FIXME These hand-written next,prev,up node pointers make editing a lot
303@c harder. There should be no need for them, makeinfo can do it
304@c automatically for any document with a normal structure.
308@node Top, Introduction, (dir), (dir) 305@node Top, Introduction, (dir), (dir)
309@top Org Mode Manual 306@top Org Mode Manual
310 307
@@ -330,6 +327,7 @@ with contributions by David O'Toole, Bastien Guerry, Philip Rooke, Dan Davison,
330* Hacking:: How to hack your way around 327* Hacking:: How to hack your way around
331* MobileOrg:: Viewing and capture on a mobile device 328* MobileOrg:: Viewing and capture on a mobile device
332* History and Acknowledgments:: How Org came into being 329* History and Acknowledgments:: How Org came into being
330* GNU Free Documentation License:: The license for this documentation.
333* Main Index:: An index of Org's concepts and features 331* Main Index:: An index of Org's concepts and features
334* Key Index:: Key bindings and where they are described 332* Key Index:: Key bindings and where they are described
335* Command and Function Index:: Command names and some internal functions 333* Command and Function Index:: Command names and some internal functions
@@ -986,7 +984,7 @@ default. If you are using an earlier version of Emacs, add this line to your
986(add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode)) 984(add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode))
987@end lisp 985@end lisp
988 986
989Org mode buffers need font-lock to be turned on - this is the default in 987Org mode buffers need font-lock to be turned on: this is the default in
990Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer 988Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer
991with @code{(add-hook 'org-mode-hook 'turn-on-font-lock)}}. 989with @code{(add-hook 'org-mode-hook 'turn-on-font-lock)}}.
992 990
@@ -2687,7 +2685,7 @@ computations in Lisp:
2687 '(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2)) 2685 '(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2))
2688@r{Add columns 1 and 2, equivalent to Calc's @code{$1+$2}} 2686@r{Add columns 1 and 2, equivalent to Calc's @code{$1+$2}}
2689 '(+ $1 $2);N 2687 '(+ $1 $2);N
2690@r{Compute the sum of columns 1-4, like Calc's @code{vsum($1..$4)}} 2688@r{Compute the sum of columns 1--4, like Calc's @code{vsum($1..$4)}}
2691 '(apply '+ '($1..$4));N 2689 '(apply '+ '($1..$4));N
2692@end example 2690@end example
2693 2691
@@ -3029,7 +3027,7 @@ lines will be left alone by this command.
3029Selects this line for global recalculation with @kbd{C-u C-c *}, but 3027Selects this line for global recalculation with @kbd{C-u C-c *}, but
3030not for automatic recalculation. Use this when automatic 3028not for automatic recalculation. Use this when automatic
3031recalculation slows down editing too much. 3029recalculation slows down editing too much.
3032@item 3030@item @
3033Unmarked lines are exempt from recalculation with @kbd{C-u C-c *}. 3031Unmarked lines are exempt from recalculation with @kbd{C-u C-c *}.
3034All lines that should be recalculated should be marked with @samp{#} 3032All lines that should be recalculated should be marked with @samp{#}
3035or @samp{*}. 3033or @samp{*}.
@@ -3376,7 +3374,7 @@ buffer:
3376For Org files, if there is a @samp{<<target>>} at the cursor, the link points 3374For Org files, if there is a @samp{<<target>>} at the cursor, the link points
3377to the target. Otherwise it points to the current headline, which will also 3375to the target. Otherwise it points to the current headline, which will also
3378be the description@footnote{If the headline contains a timestamp, it will be 3376be the description@footnote{If the headline contains a timestamp, it will be
3379removed from the link and result in a wrong link -- you should avoid putting 3377removed from the link and result in a wrong link---you should avoid putting
3380timestamp in the headline.}. 3378timestamp in the headline.}.
3381 3379
3382@vindex org-link-to-org-use-id 3380@vindex org-link-to-org-use-id
@@ -5052,7 +5050,7 @@ FILE @r{The filename the entry is located in.}
5052To create sparse trees and special lists with selection based on properties, 5050To create sparse trees and special lists with selection based on properties,
5053the same commands are used as for tag searches (@pxref{Tag searches}). 5051the same commands are used as for tag searches (@pxref{Tag searches}).
5054@table @kbd 5052@table @kbd
5055@orgcmdkkc{C-c / m,C-c \,org-match-sparse-tree} 5053@orgcmdkkc{C-c / m,C-c @backslashchar{},org-match-sparse-tree}
5056Create a sparse tree with all matching entries. With a 5054Create a sparse tree with all matching entries. With a
5057@kbd{C-u} prefix argument, ignore headlines that are not a TODO line. 5055@kbd{C-u} prefix argument, ignore headlines that are not a TODO line.
5058@orgcmd{C-c a m,org-tags-view} 5056@orgcmd{C-c a m,org-tags-view}
@@ -5238,8 +5236,8 @@ same summary information.
5238The @code{est+} summary type requires further explanation. It is used for 5236The @code{est+} summary type requires further explanation. It is used for
5239combining estimates, expressed as low-high ranges. For example, instead 5237combining estimates, expressed as low-high ranges. For example, instead
5240of estimating a particular task will take 5 days, you might estimate it as 5238of estimating a particular task will take 5 days, you might estimate it as
52415-6 days if you're fairly confident you know how much work is required, or 52395--6 days if you're fairly confident you know how much work is required, or
52421-10 days if you don't really know what needs to be done. Both ranges 52401--10 days if you don't really know what needs to be done. Both ranges
5243average at 5.5 days, but the first represents a more predictable delivery. 5241average at 5.5 days, but the first represents a more predictable delivery.
5244 5242
5245When combining a set of such estimates, simply adding the lows and highs 5243When combining a set of such estimates, simply adding the lows and highs
@@ -5249,7 +5247,7 @@ from the sum. For example, suppose you had ten tasks, each of which was
5249estimated at 0.5 to 2 days of work. Straight addition produces an estimate 5247estimated at 0.5 to 2 days of work. Straight addition produces an estimate
5250of 5 to 20 days, representing what to expect if everything goes either 5248of 5 to 20 days, representing what to expect if everything goes either
5251extremely well or extremely poorly. In contrast, @code{est+} estimates the 5249extremely well or extremely poorly. In contrast, @code{est+} estimates the
5252full job more realistically, at 10-15 days. 5250full job more realistically, at 10--15 days.
5253 5251
5254Here is an example for a complete columns definition, along with allowed 5252Here is an example for a complete columns definition, along with allowed
5255values. 5253values.
@@ -6541,7 +6539,7 @@ suggestion.} for capturing new material.
6541@table @kbd 6539@table @kbd
6542@orgcmd{C-c c,org-capture} 6540@orgcmd{C-c c,org-capture}
6543Call the command @code{org-capture}. Note that this keybinding is global and 6541Call the command @code{org-capture}. Note that this keybinding is global and
6544not active by default - you need to install it. If you have templates 6542not active by default; you need to install it. If you have templates
6545@cindex date tree 6543@cindex date tree
6546defined @pxref{Capture templates}, it will offer these templates for 6544defined @pxref{Capture templates}, it will offer these templates for
6547selection or use a new Org outline node as the default template. It will 6545selection or use a new Org outline node as the default template. It will
@@ -8119,7 +8117,7 @@ February 1st, @kbd{9 w} to ISO week number 9. When setting day, week, or
8119month view, a year may be encoded in the prefix argument as well. For 8117month view, a year may be encoded in the prefix argument as well. For
8120example, @kbd{200712 w} will jump to week 12 in 2007. If such a year 8118example, @kbd{200712 w} will jump to week 12 in 2007. If such a year
8121specification has only one or two digits, it will be mapped to the interval 8119specification has only one or two digits, it will be mapped to the interval
81221938-2037. @kbd{v @key{SPC}} will reset to what is set in 81201938--2037. @kbd{v @key{SPC}} will reset to what is set in
8123@code{org-agenda-span}. 8121@code{org-agenda-span}.
8124@c 8122@c
8125@orgcmd{f,org-agenda-later} 8123@orgcmd{f,org-agenda-later}
@@ -8278,7 +8276,7 @@ You can then filter for an effort by first typing an operator, one of
8278@kbd{<}, @kbd{>}, and @kbd{=}, and then the one-digit index of an effort 8276@kbd{<}, @kbd{>}, and @kbd{=}, and then the one-digit index of an effort
8279estimate in your array of allowed values, where @kbd{0} means the 10th value. 8277estimate in your array of allowed values, where @kbd{0} means the 10th value.
8280The filter will then restrict to entries with effort smaller-or-equal, equal, 8278The filter will then restrict to entries with effort smaller-or-equal, equal,
8281or larger-or-equal than the selected value. If the digits 0-9 are not used 8279or larger-or-equal than the selected value. If the digits 0--9 are not used
8282as fast access keys to tags, you can also simply press the index digit 8280as fast access keys to tags, you can also simply press the index digit
8283directly without an operator. In this case, @kbd{<} will be assumed. For 8281directly without an operator. In this case, @kbd{<} will be assumed. For
8284application of the operator, entries without a defined effort will be treated 8282application of the operator, entries without a defined effort will be treated
@@ -8336,7 +8334,7 @@ selected.
8336@tsubheading{Remote editing} 8334@tsubheading{Remote editing}
8337@cindex remote editing, from agenda 8335@cindex remote editing, from agenda
8338 8336
8339@item 0-9 8337@item 0--9
8340Digit argument. 8338Digit argument.
8341@c 8339@c
8342@cindex undoing remote-editing events 8340@cindex undoing remote-editing events
@@ -11150,7 +11148,7 @@ files directly, or generate the required styles using an application like
11150LibreOffice. The latter method is suitable for expert and non-expert 11148LibreOffice. The latter method is suitable for expert and non-expert
11151users alike, and is described here. 11149users alike, and is described here.
11152 11150
11153@subsubsection Applying custom styles - the easy way 11151@subsubsection Applying custom styles: the easy way
11154 11152
11155@enumerate 11153@enumerate
11156@item 11154@item
@@ -11163,8 +11161,8 @@ to ODT format.
11163 11161
11164@item 11162@item
11165Open the above @file{example.odt} using LibreOffice. Use the @file{Stylist} 11163Open the above @file{example.odt} using LibreOffice. Use the @file{Stylist}
11166to locate the target styles - these typically have the @samp{Org} prefix - 11164to locate the target styles---these typically have the @samp{Org} prefix---and
11167and modify those to your taste. Save the modified file either as an 11165modify those to your taste. Save the modified file either as an
11168OpenDocument Text (@file{.odt}) or OpenDocument Template (@file{.ott}) file. 11166OpenDocument Text (@file{.odt}) or OpenDocument Template (@file{.ott}) file.
11169 11167
11170@item 11168@item
@@ -11217,8 +11215,8 @@ with a cross-reference and sequence number of the labeled entity.
11217@cindex tables, in DocBook export 11215@cindex tables, in DocBook export
11218 11216
11219Export of native Org mode tables (@pxref{Tables}) and simple @file{table.el} 11217Export of native Org mode tables (@pxref{Tables}) and simple @file{table.el}
11220tables is supported. However, export of complex @file{table.el} tables - 11218tables is supported. However, export of complex @file{table.el} tables---tables
11221tables that have column or row spans - is not supported. Such tables are 11219that have column or row spans---is not supported. Such tables are
11222stripped from the exported document. 11220stripped from the exported document.
11223 11221
11224By default, a table is exported with top and bottom frames and with rules 11222By default, a table is exported with top and bottom frames and with rules
@@ -11350,7 +11348,7 @@ height:width ratio, do the following
11350@cindex #+ATTR_ODT 11348@cindex #+ATTR_ODT
11351You can control the manner in which an image is anchored by setting the 11349You can control the manner in which an image is anchored by setting the
11352@code{:anchor} property of it's @code{#+ATTR_ODT} line. You can specify one 11350@code{:anchor} property of it's @code{#+ATTR_ODT} line. You can specify one
11353of the the following three values for the @code{:anchor} property - 11351of the the following three values for the @code{:anchor} property:
11354@samp{"as-char"}, @samp{"paragraph"} and @samp{"page"}. 11352@samp{"as-char"}, @samp{"paragraph"} and @samp{"page"}.
11355 11353
11356To create an image that is anchored to a page, do the following: 11354To create an image that is anchored to a page, do the following:
@@ -11456,8 +11454,8 @@ or
11456@node Labels and captions in ODT export, Literal examples in ODT export, Math formatting in ODT export, OpenDocument Text export 11454@node Labels and captions in ODT export, Literal examples in ODT export, Math formatting in ODT export, OpenDocument Text export
11457@subsection Labels and captions in ODT export 11455@subsection Labels and captions in ODT export
11458 11456
11459You can label and caption various category of objects - an inline image, a 11457You can label and caption various category of objects---an inline image, a
11460table, a @LaTeX{} fragment or a Math formula - using @code{#+LABEL} and 11458table, a @LaTeX{} fragment or a Math formula---using @code{#+LABEL} and
11461@code{#+CAPTION} lines. @xref{Images and tables}. ODT exporter enumerates 11459@code{#+CAPTION} lines. @xref{Images and tables}. ODT exporter enumerates
11462each labeled or captioned object of a given category separately. As a 11460each labeled or captioned object of a given category separately. As a
11463result, each such object is assigned a sequence number based on order of it's 11461result, each such object is assigned a sequence number based on order of it's
@@ -11621,8 +11619,8 @@ the exporter.
11621 11619
11622@item 11620@item
11623It contains @samp{<text:sequence-decl>}@dots{}@samp{</text:sequence-decl>} 11621It contains @samp{<text:sequence-decl>}@dots{}@samp{</text:sequence-decl>}
11624elements that control how various entities - tables, images, equations etc - 11622elements that control how various entities---tables, images, equations,
11625are numbered. 11623etc.---are numbered.
11626@end enumerate 11624@end enumerate
11627@end itemize 11625@end itemize
11628 11626
@@ -11756,7 +11754,7 @@ OpenDocument-v1.2 Specification}}
11756 11754
11757 11755
11758 11756
11759@subsubheading Custom table styles - an illustration 11757@subsubheading Custom table styles: an illustration
11760 11758
11761To have a quick preview of this feature, install the below setting and export 11759To have a quick preview of this feature, install the below setting and export
11762the table that follows. 11760the table that follows.
@@ -11788,7 +11786,7 @@ Template} in @file{OrgOdtContentTemplate.xml}
11788(@pxref{x-orgodtcontenttemplate-xml,,Factory styles}). If you need 11786(@pxref{x-orgodtcontenttemplate-xml,,Factory styles}). If you need
11789additional templates you have to define these styles yourselves. 11787additional templates you have to define these styles yourselves.
11790 11788
11791@subsubheading Custom table styles - the nitty-gritty 11789@subsubheading Custom table styles: the nitty-gritty
11792To use this feature proceed as follows: 11790To use this feature proceed as follows:
11793 11791
11794@enumerate 11792@enumerate
@@ -14802,7 +14800,7 @@ These lines (several are allowed) specify link abbreviations.
14802@vindex org-lowest-priority 14800@vindex org-lowest-priority
14803@vindex org-default-priority 14801@vindex org-default-priority
14804This line sets the limits and the default for the priorities. All three 14802This line sets the limits and the default for the priorities. All three
14805must be either letters A-Z or numbers 0-9. The highest priority must 14803must be either letters A--Z or numbers 0--9. The highest priority must
14806have a lower ASCII number than the lowest priority. 14804have a lower ASCII number than the lowest priority.
14807@item #+PROPERTY: Property_Name Value 14805@item #+PROPERTY: Property_Name Value
14808This line sets a default inheritance value for entries in the current 14806This line sets a default inheritance value for entries in the current
@@ -14811,7 +14809,7 @@ buffer, most useful for specifying the allowed values of a property.
14811@item #+SETUPFILE: file 14809@item #+SETUPFILE: file
14812This line defines a file that holds more in-buffer setup. Normally this is 14810This line defines a file that holds more in-buffer setup. Normally this is
14813entirely ignored. Only when the buffer is parsed for option-setting lines 14811entirely ignored. Only when the buffer is parsed for option-setting lines
14814(i.e.@: when starting Org mode for a file, when pressing @kbd{C-c C-c} in a 14812(i.e., when starting Org mode for a file, when pressing @kbd{C-c C-c} in a
14815settings line, or when exporting), then the contents of this file are parsed 14813settings line, or when exporting), then the contents of this file are parsed
14816as if they had been included in the buffer. In particular, the file can be 14814as if they had been included in the buffer. In particular, the file can be
14817any other Org mode file with internal setup. You can visit the file the 14815any other Org mode file with internal setup. You can visit the file the
@@ -15106,7 +15104,7 @@ indentation shifts by two@footnote{See the variable
15106stars but the last one are made invisible using the @code{org-hide} 15104stars but the last one are made invisible using the @code{org-hide}
15107face@footnote{Turning on @code{org-indent-mode} sets 15105face@footnote{Turning on @code{org-indent-mode} sets
15108@code{org-hide-leading-stars} to @code{t} and @code{org-adapt-indentation} to 15106@code{org-hide-leading-stars} to @code{t} and @code{org-adapt-indentation} to
15109@code{nil}.} - see below under @samp{2.} for more information on how this 15107@code{nil}.}; see below under @samp{2.} for more information on how this
15110works. You can turn on @code{org-indent-mode} for all files by customizing 15108works. You can turn on @code{org-indent-mode} for all files by customizing
15111the variable @code{org-startup-indented}, or you can turn it on for 15109the variable @code{org-startup-indented}, or you can turn it on for
15112individual files using 15110individual files using
@@ -15173,7 +15171,7 @@ example using the color @code{grey90} on a white background.
15173Things become cleaner still if you skip all the even levels and use only odd 15171Things become cleaner still if you skip all the even levels and use only odd
15174levels 1, 3, 5..., effectively adding two stars to go from one outline level 15172levels 1, 3, 5..., effectively adding two stars to go from one outline level
15175to the next@footnote{When you need to specify a level for a property search 15173to the next@footnote{When you need to specify a level for a property search
15176or refile targets, @samp{LEVEL=2} will correspond to 3 stars, etc@.}. In this 15174or refile targets, @samp{LEVEL=2} will correspond to 3 stars, etc.}. In this
15177way we get the outline view shown at the beginning of this section. In order 15175way we get the outline view shown at the beginning of this section. In order
15178to make the structure editing and export commands handle this convention 15176to make the structure editing and export commands handle this convention
15179correctly, configure the variable @code{org-odd-levels-only}, or set this on 15177correctly, configure the variable @code{org-odd-levels-only}, or set this on
@@ -15264,7 +15262,7 @@ names for natural constants or units. Instead of defining your own
15264constants in the variable @code{org-table-formula-constants}, install 15262constants in the variable @code{org-table-formula-constants}, install
15265the @file{constants} package which defines a large number of constants 15263the @file{constants} package which defines a large number of constants
15266and units, and lets you use unit prefixes like @samp{M} for 15264and units, and lets you use unit prefixes like @samp{M} for
15267@samp{Mega}, etc@. You will need version 2.0 of this package, available 15265@samp{Mega}, etc. You will need version 2.0 of this package, available
15268at @url{http://www.astro.uva.nl/~dominik/Tools}. Org checks for 15266at @url{http://www.astro.uva.nl/~dominik/Tools}. Org checks for
15269the function @code{constants-get}, which has to be autoloaded in your 15267the function @code{constants-get}, which has to be autoloaded in your
15270setup. See the installation instructions in the file 15268setup. See the installation instructions in the file
@@ -16606,7 +16604,7 @@ last pull. This might include a file that is not currently in your list of
16606agenda files. If you later use @kbd{C-c a ?} to regenerate the view, only 16604agenda files. If you later use @kbd{C-c a ?} to regenerate the view, only
16607the current agenda files will be searched.} using @kbd{C-c a ?}. 16605the current agenda files will be searched.} using @kbd{C-c a ?}.
16608 16606
16609@node History and Acknowledgments, Main Index, MobileOrg, Top 16607@node History and Acknowledgments, GNU Free Documentation License, MobileOrg, Top
16610@appendix History and acknowledgments 16608@appendix History and acknowledgments
16611@cindex acknowledgments 16609@cindex acknowledgments
16612@cindex history 16610@cindex history
@@ -16715,7 +16713,7 @@ a great help, and the list would not be so active without him.
16715@end table 16713@end table
16716 16714
16717I received support from so many users that it is clearly impossible to be 16715I received support from so many users that it is clearly impossible to be
16718fair when shortlisting a few of them -- but Org's history would not be 16716fair when shortlisting a few of them, but Org's history would not be
16719complete if the ones above were not mentioned in this manual. 16717complete if the ones above were not mentioned in this manual.
16720 16718
16721@section List of contributions 16719@section List of contributions
@@ -16949,7 +16947,12 @@ and contributed various ideas and code snippets.
16949@end itemize 16947@end itemize
16950 16948
16951 16949
16952@node Main Index, Key Index, History and Acknowledgments, Top 16950@node GNU Free Documentation License, Main Index, History and Acknowledgments, Top
16951@appendix GNU Free Documentation License
16952@include doclicense.texi
16953
16954
16955@node Main Index, Key Index, GNU Free Documentation License, Top
16953@unnumbered Concept index 16956@unnumbered Concept index
16954 16957
16955@printindex cp 16958@printindex cp
diff --git a/doc/misc/pcl-cvs.texi b/doc/misc/pcl-cvs.texi
index 993ddc22d43..7c294591d0e 100644
--- a/doc/misc/pcl-cvs.texi
+++ b/doc/misc/pcl-cvs.texi
@@ -1,12 +1,12 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2@c %**start of header 2@c %**start of header
3@setfilename ../../info/pcl-cvs 3@setfilename ../../info/pcl-cvs
4@settitle PCL-CVS --- Emacs Front-End to CVS 4@settitle PCL-CVS---Emacs Front-End to CVS
5@syncodeindex vr fn 5@syncodeindex vr fn
6@c %**end of header 6@c %**end of header
7 7
8@copying 8@copying
9Copyright @copyright{} 1991-2012 Free Software Foundation, Inc. 9Copyright @copyright{} 1991--2013 Free Software Foundation, Inc.
10 10
11@quotation 11@quotation
12Permission is granted to copy, distribute and/or modify this document 12Permission is granted to copy, distribute and/or modify this document
@@ -17,8 +17,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
17is included in the section entitled ``GNU Free Documentation License''. 17is included in the section entitled ``GNU Free Documentation License''.
18 18
19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
20modify this GNU manual. Buying copies from the FSF supports it in 20modify this GNU manual.''
21developing GNU and promoting software freedom.''
22@end quotation 21@end quotation
23@end copying 22@end copying
24 23
@@ -32,10 +31,10 @@ developing GNU and promoting software freedom.''
32@sp 4 31@sp 4
33@c The title is printed in a large font. 32@c The title is printed in a large font.
34@center @titlefont{User's Guide} 33@center @titlefont{User's Guide}
35@sp 34@sp 1
36@center @titlefont{to} 35@center @titlefont{to}
37@sp 36@sp 1
38@center @titlefont{PCL-CVS --- The Emacs Front-End to CVS} 37@center @titlefont{PCL-CVS---The Emacs Front-End to CVS}
39@ignore 38@ignore
40@sp 2 39@sp 2
41@center release 2.9 40@center release 2.9
@@ -59,8 +58,8 @@ developing GNU and promoting software freedom.''
59@c The real text starts here 58@c The real text starts here
60@c ================================================================ 59@c ================================================================
61 60
62@node Top, About PCL-CVS, (dir), (dir)
63@ifnottex 61@ifnottex
62@node Top
64@top PCL-CVS 63@top PCL-CVS
65 64
66This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It 65This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It
@@ -128,7 +127,7 @@ Customization
128@end detailmenu 127@end detailmenu
129@end menu 128@end menu
130 129
131@node About PCL-CVS, Getting started, Top, Top 130@node About PCL-CVS
132@chapter About PCL-CVS 131@chapter About PCL-CVS
133@cindex About PCL-CVS 132@cindex About PCL-CVS
134 133
@@ -152,7 +151,7 @@ functionality and taking over the maintenance.
152* Contributors:: Contributors to PCL-CVS. 151* Contributors:: Contributors to PCL-CVS.
153@end menu 152@end menu
154 153
155@node Contributors,, About PCL-CVS, About PCL-CVS 154@node Contributors
156@section Contributors to PCL-CVS 155@section Contributors to PCL-CVS
157@cindex Contributors 156@cindex Contributors
158@cindex Authors 157@cindex Authors
@@ -229,7 +228,7 @@ requests, bug reports and encouragement. Thanks a lot! Without you
229there would be no new releases of PCL-CVS. 228there would be no new releases of PCL-CVS.
230 229
231 230
232@node Getting started, Buffer contents, About PCL-CVS, Top 231@node Getting started
233@chapter Getting started 232@chapter Getting started
234@cindex Introduction 233@cindex Introduction
235@cindex Example run 234@cindex Example run
@@ -297,7 +296,7 @@ press @kbd{l} to get the output from @samp{cvs log}. Many more such
297commands are available simply by pressing a key (@pxref{Getting info 296commands are available simply by pressing a key (@pxref{Getting info
298about files}). 297about files}).
299 298
300@node Buffer contents, Selected files, Getting started, Top 299@node Buffer contents
301@chapter Buffer contents 300@chapter Buffer contents
302@cindex Buffer contents 301@cindex Buffer contents
303@cindex @code{*cvs*} buffer contents 302@cindex @code{*cvs*} buffer contents
@@ -426,7 +425,7 @@ The file has been unexpectedly removed from your working directory
426although it has not been @samp{cvs remove}d. 425although it has not been @samp{cvs remove}d.
427@end table 426@end table
428 427
429@node Selected files, Commands, Buffer contents, Top 428@node Selected files
430@chapter Selected files 429@chapter Selected files
431@cindex Selected files 430@cindex Selected files
432@cindex Marked files 431@cindex Marked files
@@ -468,7 +467,7 @@ it, it is quite powerful.
468 467
469For commands to mark and unmark files, see @ref{Marking files}. 468For commands to mark and unmark files, see @ref{Marking files}.
470 469
471@node Commands, Log Edit Mode, Selected files, Top 470@node Commands
472@chapter Commands 471@chapter Commands
473 472
474@iftex 473@iftex
@@ -502,7 +501,7 @@ you can use in PCL-CVS@. They are grouped together by type.
502@end menu 501@end menu
503 502
504 503
505@node Entering PCL-CVS, Setting flags, Commands, Commands 504@node Entering PCL-CVS
506@section Entering PCL-CVS 505@section Entering PCL-CVS
507@findex cvs-update 506@findex cvs-update
508@findex cvs-examine 507@findex cvs-examine
@@ -562,7 +561,7 @@ argument to the command (e.g., by typing
562@kbd{C-u M-x cvs-update @key{RET} -l @key{RET}}). 561@kbd{C-u M-x cvs-update @key{RET} -l @key{RET}}).
563 562
564 563
565@node Setting flags, Updating the buffer, Entering PCL-CVS, Commands 564@node Setting flags
566@section Setting flags for CVS commands 565@section Setting flags for CVS commands
567@cindex Optional switches to CVS 566@cindex Optional switches to CVS
568@cindex Command-line options to CVS 567@cindex Command-line options to CVS
@@ -618,7 +617,7 @@ Forces the next command to apply to every selected file rather than only
618to the ones PCL-CVS thinks are relevant. 617to the ones PCL-CVS thinks are relevant.
619@end table 618@end table
620 619
621@node Updating the buffer, Movement commands, Setting flags, Commands 620@node Updating the buffer
622@section Updating the @samp{*cvs*} buffer 621@section Updating the @samp{*cvs*} buffer
623@findex cvs-update 622@findex cvs-update
624@findex cvs-examine 623@findex cvs-examine
@@ -663,7 +662,7 @@ put in @samp{cvs-status-mode}.@refill
663@end table 662@end table
664 663
665 664
666@node Movement commands, Marking files, Updating the buffer, Commands 665@node Movement commands
667@section Movement Commands 666@section Movement Commands
668@cindex Movement Commands 667@cindex Movement Commands
669@findex cvs-mode-next-line 668@findex cvs-mode-next-line
@@ -683,13 +682,13 @@ the fact that the buffer is a PCL-CVS buffer:
683These keys move the cursor one file forward, towards the end of the 682These keys move the cursor one file forward, towards the end of the
684buffer (@code{cvs-mode-next-line}).@refill 683buffer (@code{cvs-mode-next-line}).@refill
685 684
686@itemx p 685@item p
687This key moves one file backward, towards the beginning of the buffer 686This key moves one file backward, towards the beginning of the buffer
688(@code{cvs-mode-previous-line}). 687(@code{cvs-mode-previous-line}).
689@end table 688@end table
690 689
691 690
692@node Marking files, Committing changes, Movement commands, Commands 691@node Marking files
693@section Marking files 692@section Marking files
694@cindex Selecting files (commands to mark files) 693@cindex Selecting files (commands to mark files)
695@cindex Marking files 694@cindex Marking files
@@ -747,7 +746,7 @@ Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}).
747@end table 746@end table
748 747
749 748
750@node Committing changes, Editing files, Marking files, Commands 749@node Committing changes
751@section Committing changes 750@section Committing changes
752@cindex Committing changes 751@cindex Committing changes
753@findex cvs-mode-commit 752@findex cvs-mode-commit
@@ -806,7 +805,7 @@ your buffer, or if @samp{cvs-auto-revert} is set to
806@samp{nil}. 805@samp{nil}.
807 806
808 807
809@node Editing files, Getting info about files, Committing changes, Commands 808@node Editing files
810@section Editing files 809@section Editing files
811@cindex Editing files 810@cindex Editing files
812@cindex Finding files 811@cindex Finding files
@@ -843,7 +842,7 @@ directory (@code{cvs-mode-add-change-log-entry-other-window}).@refill
843@end table 842@end table
844 843
845 844
846@node Getting info about files, Adding and removing files, Editing files, Commands 845@node Getting info about files
847@section Getting info about files 846@section Getting info about files
848@cindex Status (cvs command) 847@cindex Status (cvs command)
849@cindex Log (RCS/cvs command) 848@cindex Log (RCS/cvs command)
@@ -868,7 +867,7 @@ all selected files, and show the result in a temporary buffer
868@end table 867@end table
869 868
870 869
871@node Adding and removing files, Undoing changes, Getting info about files, Commands 870@node Adding and removing files
872@section Adding and removing files 871@section Adding and removing files
873@cindex Adding files 872@cindex Adding files
874@cindex Removing files 873@cindex Removing files
@@ -909,7 +908,7 @@ The command that is run is @code{cvs-mode-remove-file}.
909@end table 908@end table
910 909
911 910
912@node Undoing changes, Removing handled entries, Adding and removing files, Commands 911@node Undoing changes
913@section Undoing changes 912@section Undoing changes
914@cindex Undo changes 913@cindex Undo changes
915@cindex Flush changes 914@cindex Flush changes
@@ -925,7 +924,7 @@ version from the repository (@code{cvs-mode-undo-local-changes}).
925@end table 924@end table
926 925
927 926
928@node Removing handled entries, Ignoring files, Undoing changes, Commands 927@node Removing handled entries
929@section Removing handled entries 928@section Removing handled entries
930@cindex Expunging uninteresting entries 929@cindex Expunging uninteresting entries
931@cindex Uninteresting entries, getting rid of them 930@cindex Uninteresting entries, getting rid of them
@@ -957,7 +956,7 @@ not delete, but that you want to delete (@code{cvs-mode-acknowledge}).
957@end table 956@end table
958 957
959 958
960@node Ignoring files, Viewing differences, Removing handled entries, Commands 959@node Ignoring files
961@section Ignoring files 960@section Ignoring files
962@cindex Ignoring files 961@cindex Ignoring files
963@kindex i@r{--ignoring files} 962@kindex i@r{--ignoring files}
@@ -975,7 +974,7 @@ but you could ignore it as well, if you like it better that way.
975This runs @code{cvs-mode-ignore}. 974This runs @code{cvs-mode-ignore}.
976@end table 975@end table
977 976
978@node Viewing differences, Invoking Ediff, Ignoring files, Commands 977@node Viewing differences
979@section Viewing differences 978@section Viewing differences
980@cindex Diff 979@cindex Diff
981@cindex Invoking @code{diff} 980@cindex Invoking @code{diff}
@@ -1038,7 +1037,7 @@ head revision in the repository
1038By default, @samp{diff} commands ignore the marks. This can be changed 1037By default, @samp{diff} commands ignore the marks. This can be changed
1039with @code{cvs-invert-ignore-marks}. 1038with @code{cvs-invert-ignore-marks}.
1040 1039
1041@node Invoking Ediff, Updating files, Viewing differences, Commands 1040@node Invoking Ediff
1042@section Running ediff 1041@section Running ediff
1043@cindex Ediff 1042@cindex Ediff
1044@cindex Invoking ediff 1043@cindex Invoking ediff
@@ -1070,7 +1069,7 @@ any way if you use this command. If you use the @kbd{q} command inside
1070created will be overwritten.@refill 1069created will be overwritten.@refill
1071@end table 1070@end table
1072 1071
1073@node Updating files, Tagging files, Invoking Ediff, Commands 1072@node Updating files
1074@section Updating files 1073@section Updating files
1075@findex cvs-mode-update 1074@findex cvs-mode-update
1076@cindex Updating files 1075@cindex Updating files
@@ -1083,7 +1082,7 @@ Update all selected files with status @samp{Need-update} by running
1083@end table 1082@end table
1084 1083
1085 1084
1086@node Tagging files, Miscellaneous commands, Updating files, Commands 1085@node Tagging files
1087@section Tagging files 1086@section Tagging files
1088@findex cvs-mode-tag 1087@findex cvs-mode-tag
1089@findex cvs-mode-untag 1088@findex cvs-mode-untag
@@ -1110,7 +1109,7 @@ only be applied to directories, see @code{cvs-force-dir-tag} if you want
1110to change this behavior. 1109to change this behavior.
1111 1110
1112 1111
1113@node Miscellaneous commands, , Tagging files, Commands 1112@node Miscellaneous commands
1114@section Miscellaneous commands 1113@section Miscellaneous commands
1115@findex cvs-mode-byte-compile-files 1114@findex cvs-mode-byte-compile-files
1116@cindex Recompiling elisp files 1115@cindex Recompiling elisp files
@@ -1155,7 +1154,7 @@ Bury the PCL-CVS buffer (@code{cvs-bury-buffer}).
1155Quit PCL-CVS, killing the @samp{*cvs*} buffer. 1154Quit PCL-CVS, killing the @samp{*cvs*} buffer.
1156@end table 1155@end table
1157 1156
1158@node Log Edit Mode, Log View Mode, Commands, Top 1157@node Log Edit Mode
1159@chapter Editing a Log Message 1158@chapter Editing a Log Message
1160 1159
1161@cindex Log Edit mode 1160@cindex Log Edit mode
@@ -1170,13 +1169,13 @@ kill the contents of the buffer with @kbd{C-w}.
1170 1169
1171@findex log-edit-insert-changelog 1170@findex log-edit-insert-changelog
1172If you work by writing entries in the @file{ChangeLog} 1171If you work by writing entries in the @file{ChangeLog}
1173(@pxref{(emacs)Change Log}) and then commit the change under revision 1172(@pxref{Change Log,,, emacs, The GNU Emacs Manual}) and then commit the change under revision
1174control, you can generate the Log Edit text from the ChangeLog using 1173control, you can generate the Log Edit text from the ChangeLog using
1175@kbd{C-c C-a} (@kbd{log-edit-insert-changelog}). This looks for 1174@kbd{C-c C-a} (@kbd{log-edit-insert-changelog}). This looks for
1176entries for the file(s) concerned in the top entry in the ChangeLog 1175entries for the file(s) concerned in the top entry in the ChangeLog
1177and uses those paragraphs as the log text. This text is only inserted 1176and uses those paragraphs as the log text. This text is only inserted
1178if the top entry was made under your user name on the current date. 1177if the top entry was made under your user name on the current date.
1179@xref{(emacs)Change Logs and VC}, for the opposite way of 1178@xref{Change Logs and VC,,, emacs, The GNU Emacs Manual}, for the opposite way of
1180working---generating ChangeLog entries from the revision control log. 1179working---generating ChangeLog entries from the revision control log.
1181 1180
1182In the Log Edit buffer, @kbd{C-c C-f} (@kbd{M-x log-edit-show-files}) 1181In the Log Edit buffer, @kbd{C-c C-f} (@kbd{M-x log-edit-show-files})
@@ -1188,7 +1187,7 @@ exit the buffer and commit the change.
1188 1187
1189@c Fixme: customization variables 1188@c Fixme: customization variables
1190 1189
1191@node Log View Mode, Customization, Log Edit Mode, Top 1190@node Log View Mode
1192@chapter Browsing a Log of Changes 1191@chapter Browsing a Log of Changes
1193 1192
1194@cindex Log View mode 1193@cindex Log View mode
@@ -1209,7 +1208,7 @@ argument, these commands move that many messages of files.
1209@c @node CVS Status Mode 1208@c @node CVS Status Mode
1210@c @chapter Viewing CVS' Status output 1209@c @chapter Viewing CVS' Status output
1211 1210
1212@node Customization, Bugs, Log View Mode, Top 1211@node Customization
1213@chapter Customization 1212@chapter Customization
1214@vindex log-edit-changelog-full-paragraphs@r{ (variable)} 1213@vindex log-edit-changelog-full-paragraphs@r{ (variable)}
1215@vindex cvs-auto-remove-handled@r{ (variable)} 1214@vindex cvs-auto-remove-handled@r{ (variable)}
@@ -1320,7 +1319,7 @@ default.
1320* Customizing Faces:: 1319* Customizing Faces::
1321@end menu 1320@end menu
1322 1321
1323@node Customizing Faces, , Customization, Customization 1322@node Customizing Faces
1324@section Customizing Faces 1323@section Customizing Faces
1325@vindex cvs-header (face) 1324@vindex cvs-header (face)
1326@vindex cvs-filename (face) 1325@vindex cvs-filename (face)
@@ -1359,7 +1358,7 @@ Used to highlight CVS messages.
1359@end table 1358@end table
1360 1359
1361 1360
1362@node Bugs, GNU Free Documentation License, Customization, Top 1361@node Bugs
1363@chapter Bugs (known and unknown) 1362@chapter Bugs (known and unknown)
1364@cindex Reporting bugs and ideas 1363@cindex Reporting bugs and ideas
1365@cindex Bugs, how to report them 1364@cindex Bugs, how to report them
@@ -1399,13 +1398,13 @@ output of the CVS process (which should be found in the @samp{ *cvs-tmp*}
1399buffer), and the versions of Emacs, PCL-CVS and CVS you are using. 1398buffer), and the versions of Emacs, PCL-CVS and CVS you are using.
1400@end table 1399@end table
1401 1400
1402@node GNU Free Documentation License, Function and Variable Index, Bugs, Top 1401@node GNU Free Documentation License
1403@appendix GNU Free Documentation License 1402@appendix GNU Free Documentation License
1404@include doclicense.texi 1403@include doclicense.texi
1405 1404
1406 1405
1407 1406
1408@node Function and Variable Index, Concept Index, GNU Free Documentation License, Top 1407@node Function and Variable Index
1409@unnumbered Function and Variable Index 1408@unnumbered Function and Variable Index
1410 1409
1411This is an index of all the functions and variables documented in this 1410This is an index of all the functions and variables documented in this
@@ -1413,14 +1412,14 @@ manual.
1413 1412
1414@printindex fn 1413@printindex fn
1415 1414
1416@node Concept Index, Key Index, Function and Variable Index, Top 1415@node Concept Index
1417@unnumbered Concept Index 1416@unnumbered Concept Index
1418 1417
1419This is an index of concepts discussed in this manual. 1418This is an index of concepts discussed in this manual.
1420 1419
1421@printindex cp 1420@printindex cp
1422 1421
1423@node Key Index, , Concept Index, Top 1422@node Key Index
1424@unnumbered Key Index 1423@unnumbered Key Index
1425 1424
1426This index includes an entry for each PCL-CVS key sequence documented in 1425This index includes an entry for each PCL-CVS key sequence documented in
diff --git a/doc/misc/pgg.texi b/doc/misc/pgg.texi
index 0ea0bbf84d1..bb40a9f541d 100644
--- a/doc/misc/pgg.texi
+++ b/doc/misc/pgg.texi
@@ -2,16 +2,16 @@
2 2
3@include gnus-overrides.texi 3@include gnus-overrides.texi
4 4
5@set VERSION 0.1
6
5@setfilename ../../info/pgg 7@setfilename ../../info/pgg
6@settitle PGG @value{VERSION} 8@settitle PGG @value{VERSION}
7 9
8@set VERSION 0.1
9
10@copying 10@copying
11This file describes PGG @value{VERSION}, an Emacs interface to various 11This file describes PGG @value{VERSION}, an Emacs interface to various
12PGP implementations. 12PGP implementations.
13 13
14Copyright @copyright{} 2001, 2003-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 2001, 2003--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License.'' 22is included in the section entitled ``GNU Free Documentation License.''
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
diff --git a/doc/misc/rcirc.texi b/doc/misc/rcirc.texi
index b72211111a7..3bce0c7c24b 100644
--- a/doc/misc/rcirc.texi
+++ b/doc/misc/rcirc.texi
@@ -5,8 +5,7 @@
5@c %**end of header 5@c %**end of header
6 6
7@copying 7@copying
8Copyright @copyright{} 2006-2012 8Copyright @copyright{} 2006--2013 Free Software Foundation, Inc.
9Free Software Foundation, Inc.
10 9
11@quotation 10@quotation
12Permission is granted to copy, distribute and/or modify this document 11Permission is granted to copy, distribute and/or modify this document
@@ -17,8 +16,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license is
17included in the section entitled ``GNU Free Documentation License''. 16included in the section entitled ``GNU Free Documentation License''.
18 17
19(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 18(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
20modify this GNU manual. Buying copies from the FSF supports it in 19modify this GNU manual.''
21developing GNU and promoting software freedom.''
22@end quotation 20@end quotation
23@end copying 21@end copying
24 22
@@ -37,7 +35,7 @@ developing GNU and promoting software freedom.''
37@contents 35@contents
38 36
39@ifnottex 37@ifnottex
40@node Top, Basics, (dir), (dir) 38@node Top
41@top rcirc Manual 39@top rcirc Manual
42 40
43@code{rcirc} is an Emacs IRC client. 41@code{rcirc} is an Emacs IRC client.
@@ -94,7 +92,7 @@ Hacking and Tweaking
94@end detailmenu 92@end detailmenu
95@end menu 93@end menu
96 94
97@node Basics, Reference, Top, Top 95@node Basics
98@chapter Basics 96@chapter Basics
99 97
100This chapter contains a brief introduction to IRC (Internet Relay Chat), 98This chapter contains a brief introduction to IRC (Internet Relay Chat),
@@ -105,7 +103,7 @@ and a quick tutorial on @code{rcirc}.
105* Getting started with rcirc:: 103* Getting started with rcirc::
106@end menu 104@end menu
107 105
108@node Internet Relay Chat, Getting started with rcirc, Basics, Basics 106@node Internet Relay Chat
109@section Internet Relay Chat 107@section Internet Relay Chat
110@cindex internet relay chat 108@cindex internet relay chat
111@cindex irc 109@cindex irc
@@ -158,7 +156,7 @@ deego: fsbot rules!
158@kindex TAB 156@kindex TAB
159Since this is so common, you can use @key{TAB} to do nick completion. 157Since this is so common, you can use @key{TAB} to do nick completion.
160 158
161@node Getting started with rcirc, , Internet Relay Chat, Basics 159@node Getting started with rcirc
162@section Getting started with rcirc 160@section Getting started with rcirc
163@cindex getting started 161@cindex getting started
164@cindex connecting to a server 162@cindex connecting to a server
@@ -247,7 +245,7 @@ To make this permanent, add the following to your init file:
247 245
248Use @kbd{C-c C-@key{SPC}} to switch to these buffers. 246Use @kbd{C-c C-@key{SPC}} to switch to these buffers.
249 247
250@node Reference, Fighting Information Overload, Basics, Top 248@node Reference
251@chapter Reference 249@chapter Reference
252@cindex reference 250@cindex reference
253 251
@@ -261,7 +259,7 @@ documentation.
261* Configuration:: 259* Configuration::
262@end menu 260@end menu
263 261
264@node rcirc commands, Useful IRC commands, Reference, Reference 262@node rcirc commands
265@section rcirc commands 263@section rcirc commands
266@cindex rcirc commands 264@cindex rcirc commands
267@cindex commands 265@cindex commands
@@ -404,7 +402,7 @@ buffer, you automatically quit the server and part all channels. (Also
404@code{/quit ZZZzzz...}.) 402@code{/quit ZZZzzz...}.)
405@end table 403@end table
406 404
407@node Useful IRC commands, Configuration, rcirc commands, Reference 405@node Useful IRC commands
408@section Useful IRC commands 406@section Useful IRC commands
409@cindex irc commands 407@cindex irc commands
410@cindex commands 408@cindex commands
@@ -432,7 +430,7 @@ about the fantastic world of IRC online at
432@uref{http://www.irchelp.org/, the Internet Relay Chat (IRC) help 430@uref{http://www.irchelp.org/, the Internet Relay Chat (IRC) help
433archive}. 431archive}.
434 432
435@node Configuration, , Useful IRC commands, Reference 433@node Configuration
436@section Configuration 434@section Configuration
437@cindex configuring rcirc 435@cindex configuring rcirc
438 436
@@ -596,7 +594,7 @@ confuse the Bitlbee account with all the other accounts.
596 594
597@end table 595@end table
598 596
599@node Fighting Information Overload, Hacking and Tweaking, Reference, Top 597@node Fighting Information Overload
600@chapter Fighting Information Overload 598@chapter Fighting Information Overload
601@cindex information overload 599@cindex information overload
602 600
@@ -612,7 +610,7 @@ daunting task. This chapters tells you how @code{rcirc} can help.
612* Notices:: 610* Notices::
613@end menu 611@end menu
614 612
615@node Channels, People, Fighting Information Overload, Fighting Information Overload 613@node Channels
616@section Channels 614@section Channels
617@cindex channels 615@cindex channels
618@cindex modeline 616@cindex modeline
@@ -670,7 +668,7 @@ If you prefer a channel to never show up in the modeline, then you
670have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current 668have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current
671channel. 669channel.
672 670
673@node People, Keywords, Channels, Fighting Information Overload 671@node People
674@section People 672@section People
675@cindex people, how to ignore 673@cindex people, how to ignore
676@cindex nicks, how to ignore 674@cindex nicks, how to ignore
@@ -728,7 +726,7 @@ messages by dimmed nicks will not register as activity. Example:
728@end table 726@end table
729 727
730 728
731@node Keywords, Notices, People, Fighting Information Overload 729@node Keywords
732@section Keywords 730@section Keywords
733@cindex keywords 731@cindex keywords
734 732
@@ -744,7 +742,7 @@ one. If you don't provide a keyword, the current keywords are
744listed. Example: @code{/keyword manual}. 742listed. Example: @code{/keyword manual}.
745@end table 743@end table
746 744
747@node Notices, , Keywords, Fighting Information Overload 745@node Notices
748@section Notices 746@section Notices
749@cindex part notices, how to omit 747@cindex part notices, how to omit
750@cindex join notices, how to omit 748@cindex join notices, how to omit
@@ -776,7 +774,7 @@ active and only omits a message if the nick has not been active. The
776window @code{rcirc} considers is controlled by the 774window @code{rcirc} considers is controlled by the
777@code{rcirc-omit-threshold} variable. 775@code{rcirc-omit-threshold} variable.
778 776
779@node Hacking and Tweaking, GNU Free Documentation License, Fighting Information Overload, Top 777@node Hacking and Tweaking
780@chapter Hacking and Tweaking 778@chapter Hacking and Tweaking
781@cindex hacking and tweaking 779@cindex hacking and tweaking
782 780
@@ -791,7 +789,7 @@ Here are some examples of stuff you can do to configure @code{rcirc}.
791* Reconnecting after you have lost the connection:: 789* Reconnecting after you have lost the connection::
792@end menu 790@end menu
793 791
794@node Skipping /away messages using handlers, Using fly spell mode, Hacking and Tweaking, Hacking and Tweaking 792@node Skipping /away messages using handlers
795@section Skipping @code{/away} messages using handlers 793@section Skipping @code{/away} messages using handlers
796@cindex /away messages 794@cindex /away messages
797 795
@@ -811,7 +809,7 @@ require @code{rcirc} before defining the handler:
811 "/away message handler.") 809 "/away message handler.")
812@end example 810@end example
813 811
814@node Using fly spell mode, Scrolling conservatively, Skipping /away messages using handlers, Hacking and Tweaking 812@node Using fly spell mode
815@section Using fly spell mode 813@section Using fly spell mode
816@cindex fly spell 814@cindex fly spell
817@cindex spelling 815@cindex spelling
@@ -830,7 +828,7 @@ for @code{rcirc} buffers:
830@xref{Spelling, , Flyspell mode, emacs, The GNU Emacs Manual}, 828@xref{Spelling, , Flyspell mode, emacs, The GNU Emacs Manual},
831for details. 829for details.
832 830
833@node Scrolling conservatively, Changing the time stamp format, Using fly spell mode, Hacking and Tweaking 831@node Scrolling conservatively
834@section Scrolling conservatively 832@section Scrolling conservatively
835@cindex input line 833@cindex input line
836@cindex scrolling 834@cindex scrolling
@@ -852,7 +850,7 @@ window when possible. The following snippet uses a local value for
852@xref{Scrolling, , Scrolling conservatively, emacs, The GNU Emacs 850@xref{Scrolling, , Scrolling conservatively, emacs, The GNU Emacs
853Manual}, for details. 851Manual}, for details.
854 852
855@node Changing the time stamp format, Defining a new command, Scrolling conservatively, Hacking and Tweaking 853@node Changing the time stamp format
856@section Changing the time stamp format 854@section Changing the time stamp format
857@cindex time stamp 855@cindex time stamp
858@cindex date time 856@cindex date time
@@ -866,7 +864,7 @@ how to include the date in the time stamp:
866(setq rcirc-time-format "%Y-%m-%d %H:%M ") 864(setq rcirc-time-format "%Y-%m-%d %H:%M ")
867@end example 865@end example
868 866
869@node Defining a new command, Reconnecting after you have lost the connection, Changing the time stamp format, Hacking and Tweaking 867@node Defining a new command
870@section Defining a new command 868@section Defining a new command
871@cindex defining commands 869@cindex defining commands
872@cindex commands, defining 870@cindex commands, defining
@@ -889,7 +887,7 @@ because @code{defun-rcirc-command} is not yet available, and without
889 (concat "I use " rcirc-id-string)))) 887 (concat "I use " rcirc-id-string))))
890@end smallexample 888@end smallexample
891 889
892@node Reconnecting after you have lost the connection, , Defining a new command, Hacking and Tweaking 890@node Reconnecting after you have lost the connection
893@section Reconnecting after you have lost the connection 891@section Reconnecting after you have lost the connection
894@cindex reconnecting 892@cindex reconnecting
895@cindex disconnecting servers, reconnecting 893@cindex disconnecting servers, reconnecting
@@ -900,7 +898,7 @@ client doesn't realize that it has been disconnected. It takes several
900minutes until the client decides that the connection has in fact been 898minutes until the client decides that the connection has in fact been
901lost. The simple solution is to use @kbd{M-x rcirc}. The problem is 899lost. The simple solution is to use @kbd{M-x rcirc}. The problem is
902that this opens an @emph{additional} connection, so you'll have two 900that this opens an @emph{additional} connection, so you'll have two
903copies of every channel buffer --- one dead and one live. 901copies of every channel buffer, one dead and one live.
904 902
905The real answer, therefore, is a @code{/reconnect} command: 903The real answer, therefore, is a @code{/reconnect} command:
906 904
@@ -930,20 +928,20 @@ The real answer, therefore, is a @code{/reconnect} command:
930 channels)))) 928 channels))))
931@end smallexample 929@end smallexample
932 930
933@node GNU Free Documentation License, Key Index, Hacking and Tweaking, Top 931@node GNU Free Documentation License
934@appendix GNU Free Documentation License 932@appendix GNU Free Documentation License
935@include doclicense.texi 933@include doclicense.texi
936 934
937 935
938@node Key Index, Variable Index, GNU Free Documentation License, Top 936@node Key Index
939@unnumbered Key Index 937@unnumbered Key Index
940@printindex ky 938@printindex ky
941 939
942@node Variable Index, Index, Key Index, Top 940@node Variable Index
943@unnumbered Variable Index 941@unnumbered Variable Index
944@printindex vr 942@printindex vr
945 943
946@node Index, , Variable Index, Top 944@node Index
947@unnumbered Index 945@unnumbered Index
948@printindex cp 946@printindex cp
949 947
diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi
index a6339e72de6..0ee206b1a4d 100644
--- a/doc/misc/reftex.texi
+++ b/doc/misc/reftex.texi
@@ -45,7 +45,7 @@ This manual documents @RefTeX{} (version @value{VERSION}), a package
45to do labels, references, citations and indices for LaTeX documents 45to do labels, references, citations and indices for LaTeX documents
46with Emacs. 46with Emacs.
47 47
48Copyright @copyright{} 1997-2012 Free Software Foundation, Inc. 48Copyright @copyright{} 1997--2013 Free Software Foundation, Inc.
49 49
50@quotation 50@quotation
51Permission is granted to copy, distribute and/or modify this document 51Permission is granted to copy, distribute and/or modify this document
@@ -56,8 +56,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
56is included in the section entitled ``GNU Free Documentation License''. 56is included in the section entitled ``GNU Free Documentation License''.
57 57
58(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 58(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
59modify this GNU manual. Buying copies from the FSF supports it in 59modify this GNU manual.''
60developing GNU and promoting software freedom.''
61@end quotation 60@end quotation
62@end copying 61@end copying
63 62
@@ -96,7 +95,7 @@ developing GNU and promoting software freedom.''
96@contents 95@contents
97 96
98@ifnottex 97@ifnottex
99@node Top,,,(dir) 98@node Top
100@top @RefTeX{} 99@top @RefTeX{}
101 100
102@RefTeX{} is a package for managing Labels, References, Citations and 101@RefTeX{} is a package for managing Labels, References, Citations and
@@ -124,14 +123,13 @@ other parts of this document when needed.
124* Multifile Documents:: Document spread over many files. 123* Multifile Documents:: Document spread over many files.
125* Language Support:: How to support other languages. 124* Language Support:: How to support other languages.
126* Finding Files:: Included @TeX{} files and @BibTeX{} .bib files. 125* Finding Files:: Included @TeX{} files and @BibTeX{} .bib files.
127* AUCTeX:: Cooperation with @AUCTeX{}.
128* Optimizations:: When RefTeX is too slow. 126* Optimizations:: When RefTeX is too slow.
127* AUCTeX:: Cooperation with @AUCTeX{}.
129* Problems and Work-Arounds:: First Aid. 128* Problems and Work-Arounds:: First Aid.
130* Imprint:: Author, Web-site, Thanks 129* Imprint:: Author, Web-site, Thanks
131 130
132* Commands:: Which are the available commands. 131* Commands:: Which are the available commands.
133* Options:: How to extend and configure RefTeX. 132* Options:: How to extend and configure RefTeX.
134* Keymaps and Hooks:: For customization.
135* Changes:: A List of recent changes to RefTeX. 133* Changes:: A List of recent changes to RefTeX.
136* GNU Free Documentation License:: The license for this documentation. 134* GNU Free Documentation License:: The license for this documentation.
137 135
@@ -215,7 +213,7 @@ Options, Keymaps, Hooks
215 213
216@end ifnottex 214@end ifnottex
217 215
218@node Introduction, Table of Contents, , Top 216@node Introduction
219@chapter Introduction 217@chapter Introduction
220@cindex Introduction 218@cindex Introduction
221 219
@@ -243,7 +241,7 @@ reports or suggestions.
243* RefTeX in a Nutshell:: A brief summary and quick guide. 241* RefTeX in a Nutshell:: A brief summary and quick guide.
244@end menu 242@end menu
245 243
246@node Installation, RefTeX in a Nutshell, , Introduction 244@node Installation
247@section Installation 245@section Installation
248@cindex Installation 246@cindex Installation
249 247
@@ -361,7 +359,7 @@ systems these variables do not contain the full search path. If
361@xref{Finding Files}. 359@xref{Finding Files}.
362 360
363@page 361@page
364@node RefTeX in a Nutshell, , Installation, Introduction 362@node RefTeX in a Nutshell
365@section @RefTeX{} in a Nutshell 363@section @RefTeX{} in a Nutshell
366@cindex Quick-Start 364@cindex Quick-Start
367@cindex Getting Started 365@cindex Getting Started
@@ -517,7 +515,7 @@ a tutorial way how to use and customize @RefTeX{}. The second
517part is a command and variable reference. 515part is a command and variable reference.
518@end enumerate 516@end enumerate
519 517
520@node Table of Contents, Labels and References, Introduction, Top 518@node Table of Contents
521@chapter Table of Contents 519@chapter Table of Contents
522@cindex @file{*toc*} buffer 520@cindex @file{*toc*} buffer
523@cindex Structure editing 521@cindex Structure editing
@@ -610,7 +608,7 @@ Promote the current section. This will convert @code{\section} to
610@code{\chapter}, @code{\subsection} to @code{\section} etc. If there is 608@code{\chapter}, @code{\subsection} to @code{\section} etc. If there is
611an active region, all sections in the region will be promoted, including 609an active region, all sections in the region will be promoted, including
612the one at point. To avoid mistakes, @RefTeX{} requires a fresh 610the one at point. To avoid mistakes, @RefTeX{} requires a fresh
613document scan before executing this command -- if necessary, it will 611document scan before executing this command; if necessary, it will
614automatically do this scan and ask the user to repeat the promotion 612automatically do this scan and ask the user to repeat the promotion
615command. 613command.
616 614
@@ -626,7 +624,7 @@ useful when a package like @file{fancyref} is used where the label
626prefix determines the wording of a reference. After a 624prefix determines the wording of a reference. After a
627promotion/demotion it may be necessary to change a few labels from 625promotion/demotion it may be necessary to change a few labels from
628@samp{sec:xyz} to @samp{cha:xyz} or vice versa. This command can be 626@samp{sec:xyz} to @samp{cha:xyz} or vice versa. This command can be
629used to do this - it launches a query replace to rename the definition 627used to do this; it launches a query replace to rename the definition
630and all references of a label. 628and all references of a label.
631 629
632@tablesubheading{Exiting} 630@tablesubheading{Exiting}
@@ -766,7 +764,7 @@ environments to the table of contents. This is probably only useful for
766theorem-like environments. @xref{Defining Label Environments}, for an 764theorem-like environments. @xref{Defining Label Environments}, for an
767example. 765example.
768 766
769@node Labels and References, Citations, Table of Contents, Top 767@node Labels and References
770@chapter Labels and References 768@chapter Labels and References
771@cindex Labels in LaTeX 769@cindex Labels in LaTeX
772@cindex References in LaTeX 770@cindex References in LaTeX
@@ -788,7 +786,7 @@ records the figure counter, not the section counter.
788 786
789Several different environments can share a common counter and therefore 787Several different environments can share a common counter and therefore
790a common label category. For example labels in both @code{equation} and 788a common label category. For example labels in both @code{equation} and
791@code{eqnarray} environments record the value of the same counter -- the 789@code{eqnarray} environments record the value of the same counter: the
792equation counter. 790equation counter.
793 791
794@menu 792@menu
@@ -801,7 +799,7 @@ equation counter.
801* xr (LaTeX package):: References to external documents. 799* xr (LaTeX package):: References to external documents.
802@end menu 800@end menu
803 801
804@node Creating Labels, Referencing Labels, , Labels and References 802@node Creating Labels
805@section Creating Labels 803@section Creating Labels
806@cindex Creating labels 804@cindex Creating labels
807@cindex Labels, creating 805@cindex Labels, creating
@@ -868,7 +866,7 @@ If you are using @AUCTeX{} to write your @LaTeX{} documents, you can
868set it up to delegate the creation of labels to 866set it up to delegate the creation of labels to
869@RefTeX{}. @xref{AUCTeX}, for more information. 867@RefTeX{}. @xref{AUCTeX}, for more information.
870 868
871@node Referencing Labels, Builtin Label Environments, Creating Labels, Labels and References 869@node Referencing Labels
872@section Referencing Labels 870@section Referencing Labels
873@cindex Referencing labels 871@cindex Referencing labels
874@cindex Labels, referencing 872@cindex Labels, referencing
@@ -1093,7 +1091,7 @@ package),,xr}).
1093In order to define additional commands for the selection process, the 1091In order to define additional commands for the selection process, the
1094keymap @code{reftex-select-label-map} may be used. 1092keymap @code{reftex-select-label-map} may be used.
1095 1093
1096@node Builtin Label Environments, Defining Label Environments, Referencing Labels, Labels and References 1094@node Builtin Label Environments
1097@section Builtin Label Environments 1095@section Builtin Label Environments
1098@cindex Builtin label environments 1096@cindex Builtin label environments
1099@cindex Label environments, builtin 1097@cindex Label environments, builtin
@@ -1198,7 +1196,7 @@ If you want to use other labeled environments, defined with
1198@code{\newtheorem}, @RefTeX{} needs to be configured to recognize 1196@code{\newtheorem}, @RefTeX{} needs to be configured to recognize
1199them (@pxref{Defining Label Environments}). 1197them (@pxref{Defining Label Environments}).
1200 1198
1201@node Defining Label Environments, Reference Info, Builtin Label Environments, Labels and References 1199@node Defining Label Environments
1202@section Defining Label Environments 1200@section Defining Label Environments
1203@cindex Label environments, defining 1201@cindex Label environments, defining
1204 1202
@@ -1231,7 +1229,7 @@ Environments}).
1231* Putting it Together:: How to combine many entries. 1229* Putting it Together:: How to combine many entries.
1232@end menu 1230@end menu
1233 1231
1234@node Theorem and Axiom, Quick Equation, , Defining Label Environments 1232@node Theorem and Axiom
1235@subsection Theorem and Axiom Environments 1233@subsection Theorem and Axiom Environments
1236@cindex @code{theorem}, newtheorem 1234@cindex @code{theorem}, newtheorem
1237@cindex @code{axiom}, newtheorem 1235@cindex @code{axiom}, newtheorem
@@ -1363,7 +1361,7 @@ and @code{reftex-label-menu-flags} (@pxref{Options (Referencing
1363Labels)}). 1361Labels)}).
1364 1362
1365 1363
1366@node Quick Equation, Figure Wrapper, Theorem and Axiom , Defining Label Environments 1364@node Quick Equation
1367@subsection Quick Equation Macro 1365@subsection Quick Equation Macro
1368@cindex Quick equation macro 1366@cindex Quick equation macro
1369@cindex Macros as environment wrappers 1367@cindex Macros as environment wrappers
@@ -1411,7 +1409,7 @@ Reftex Label Alist: [Hide]
1411 [ ] Make TOC entry : [Value Menu] No entry 1409 [ ] Make TOC entry : [Value Menu] No entry
1412@end example 1410@end example
1413 1411
1414@node Figure Wrapper, Adding Magic Words, Quick Equation, Defining Label Environments 1412@node Figure Wrapper
1415@subsection Figure Wrapping Macro 1413@subsection Figure Wrapping Macro
1416@cindex Macros as environment wrappers 1414@cindex Macros as environment wrappers
1417@cindex Figure wrapping macro 1415@cindex Figure wrapping macro
@@ -1449,8 +1447,8 @@ The empty pairs of brackets indicate the different arguments of the
1449indicates that this is a figure label which will be listed together with 1447indicates that this is a figure label which will be listed together with
1450labels from normal figure environments. The @code{nil} entries for 1448labels from normal figure environments. The @code{nil} entries for
1451prefix and reference format mean to use the defaults for figure labels. 1449prefix and reference format mean to use the defaults for figure labels.
1452The @samp{3} for the context method means to grab the third macro argument 1450The @samp{3} for the context method means to grab the third macro argument:
1453-- the caption. 1451the caption.
1454 1452
1455As a side effect of this configuration, @code{reftex-label} will now 1453As a side effect of this configuration, @code{reftex-label} will now
1456insert the required naked label (without the @code{\label} macro) when 1454insert the required naked label (without the @code{\label} macro) when
@@ -1471,7 +1469,7 @@ Again, here the configuration in the customization buffer:
1471 [ ] Make TOC entry : [Value Menu] No entry 1469 [ ] Make TOC entry : [Value Menu] No entry
1472@end example 1470@end example
1473 1471
1474@node Adding Magic Words, Using \eqref, Figure Wrapper, Defining Label Environments 1472@node Adding Magic Words
1475@subsection Adding Magic Words 1473@subsection Adding Magic Words
1476@cindex Magic words 1474@cindex Magic words
1477@cindex German magic words 1475@cindex German magic words
@@ -1495,7 +1493,7 @@ predefined label categories.
1495 (nil ?i nil nil nil ("Punkt")))) 1493 (nil ?i nil nil nil ("Punkt"))))
1496@end lisp 1494@end lisp
1497 1495
1498@node Using \eqref, Non-Standard Environments, Adding Magic Words, Defining Label Environments 1496@node Using \eqref
1499@subsection Using @code{\eqref} 1497@subsection Using @code{\eqref}
1500@cindex @code{\eqref}, AMS-LaTeX macro 1498@cindex @code{\eqref}, AMS-LaTeX macro
1501@cindex AMS-LaTeX 1499@cindex AMS-LaTeX
@@ -1519,10 +1517,10 @@ following is equivalent to the line above.
1519@end lisp 1517@end lisp
1520 1518
1521Note that this is automatically done by the @file{amsmath.el} style file 1519Note that this is automatically done by the @file{amsmath.el} style file
1522of @AUCTeX{} (@pxref{Style Files}) -- so if you use @AUCTeX{}, 1520of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{},
1523this configuration will not be necessary. 1521this configuration will not be necessary.
1524 1522
1525@node Non-Standard Environments, Putting it Together, Using \eqref, Defining Label Environments 1523@node Non-Standard Environments
1526@subsection Non-standard Environments 1524@subsection Non-standard Environments
1527@cindex Non-standard environments 1525@cindex Non-standard environments
1528@cindex Environments without @code{\begin} 1526@cindex Environments without @code{\begin}
@@ -1623,7 +1621,7 @@ for @RefTeX{}.
1623 (incf cnt)))))))) 1621 (incf cnt))))))))
1624@end lisp 1622@end lisp
1625 1623
1626@node Putting it Together, , Non-Standard Environments, Defining Label Environments 1624@node Putting it Together
1627@subsection Putting it all together 1625@subsection Putting it all together
1628 1626
1629When you have to put several entries into @code{reftex-label-alist}, just 1627When you have to put several entries into @code{reftex-label-alist}, just
@@ -1641,7 +1639,7 @@ the entries described above:
1641 (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex.")))) 1639 (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex."))))
1642@end lisp 1640@end lisp
1643 1641
1644@node Reference Info, Reference Styles, Defining Label Environments, Labels and References 1642@node Reference Info
1645@section Reference Info 1643@section Reference Info
1646@findex reftex-view-crossref 1644@findex reftex-view-crossref
1647@findex reftex-mouse-view-crossref 1645@findex reftex-mouse-view-crossref
@@ -1663,7 +1661,7 @@ message.
1663@code{\label} macro. @xref{Viewing Cross-References}, for more 1661@code{\label} macro. @xref{Viewing Cross-References}, for more
1664information. 1662information.
1665 1663
1666@node Reference Styles, xr (LaTeX package), Reference Info, Labels and References 1664@node Reference Styles
1667@section Reference Styles 1665@section Reference Styles
1668 1666
1669In case you defined your own macros for referencing or you are using 1667In case you defined your own macros for referencing or you are using
@@ -1744,14 +1742,14 @@ package where a macro call like @code{\fref@{@var{fig:map-of-germany}@}}
1744creates not only the number of the referenced counter but also the 1742creates not only the number of the referenced counter but also the
1745complete text around it, like @samp{Figure 3 on the preceding page}. In 1743complete text around it, like @samp{Figure 3 on the preceding page}. In
1746order to make it work you need to use label prefixes like @samp{fig:} 1744order to make it work you need to use label prefixes like @samp{fig:}
1747consistently -- something @RefTeX{} does automatically. For each of 1745consistently---something @RefTeX{} does automatically. For each of
1748these packages a variable could be configured to make its macros to take 1746these packages a variable could be configured to make its macros to take
1749precedence over @code{\ref}. Those were @code{reftex-vref-is-default} 1747precedence over @code{\ref}. Those were @code{reftex-vref-is-default}
1750and @code{reftex-fref-is-default} respectively. While still working, 1748and @code{reftex-fref-is-default} respectively. While still working,
1751these variables are deprecated now. Instead of setting them, the 1749these variables are deprecated now. Instead of setting them, the
1752variable @code{reftex-ref-style-default-list} should be adapted now. 1750variable @code{reftex-ref-style-default-list} should be adapted now.
1753 1751
1754@node xr (LaTeX package), , Reference Styles, Labels and References 1752@node xr (LaTeX package)
1755@section @code{xr}: Cross-Document References 1753@section @code{xr}: Cross-Document References
1756@cindex @code{xr}, LaTeX package 1754@cindex @code{xr}, LaTeX package
1757@cindex LaTeX packages, @code{xr} 1755@cindex LaTeX packages, @code{xr}
@@ -1786,7 +1784,7 @@ For this kind of inter-document cross-references, saving of parsing
1786information and the use of multiple selection buffers can mean a large 1784information and the use of multiple selection buffers can mean a large
1787speed-up (@pxref{Optimizations}). 1785speed-up (@pxref{Optimizations}).
1788 1786
1789@node Citations, Index Support, Labels and References, Top 1787@node Citations
1790@chapter Citations 1788@chapter Citations
1791@cindex Citations 1789@cindex Citations
1792@cindex @code{\cite} 1790@cindex @code{\cite}
@@ -1806,7 +1804,7 @@ support for citations helps to select the correct key quickly.
1806* BibTeX Database Subsets:: Extract parts of a big database. 1804* BibTeX Database Subsets:: Extract parts of a big database.
1807@end menu 1805@end menu
1808 1806
1809@node Creating Citations, Citation Styles, , Citations 1807@node Creating Citations
1810@section Creating Citations 1808@section Creating Citations
1811@cindex Creating citations 1809@cindex Creating citations
1812@cindex Citations, creating 1810@cindex Citations, creating
@@ -1956,7 +1954,7 @@ buffers by adding the following expression to your init file:
1956@end lisp 1954@end lisp
1957 1955
1958 1956
1959@node Citation Styles, Citation Info, Creating Citations, Citations 1957@node Citation Styles
1960@section Citation Styles 1958@section Citation Styles
1961@cindex Citation styles 1959@cindex Citation styles
1962@cindex Citation styles, @code{natbib} 1960@cindex Citation styles, @code{natbib}
@@ -2021,7 +2019,7 @@ citation style based on the @code{usepackage} commands in a given
2021document. @xref{Style Files}, for information on how to set up the style 2019document. @xref{Style Files}, for information on how to set up the style
2022files correctly. 2020files correctly.
2023 2021
2024@node Citation Info, Chapterbib and Bibunits, Citation Styles, Citations 2022@node Citation Info
2025@section Citation Info 2023@section Citation Info
2026@cindex Displaying citations 2024@cindex Displaying citations
2027@cindex Citations, displaying 2025@cindex Citations, displaying
@@ -2042,7 +2040,7 @@ entry corresponding to a @code{\cite} macro, or all citation locations
2042corresponding to a @code{\bibitem} or @BibTeX{} database entry. 2040corresponding to a @code{\bibitem} or @BibTeX{} database entry.
2043@xref{Viewing Cross-References}. 2041@xref{Viewing Cross-References}.
2044 2042
2045@node Chapterbib and Bibunits, Citations Outside LaTeX, Citation Info, Citations 2043@node Chapterbib and Bibunits
2046@section Chapterbib and Bibunits 2044@section Chapterbib and Bibunits
2047@cindex @code{chapterbib}, LaTeX package 2045@cindex @code{chapterbib}, LaTeX package
2048@cindex @code{bibunits}, LaTeX package 2046@cindex @code{bibunits}, LaTeX package
@@ -2057,7 +2055,7 @@ separate file (as it is required for @code{chapterbib} anyway). Then
2057you have multiple bibliographies within a @emph{single file}, this may 2055you have multiple bibliographies within a @emph{single file}, this may
2058or may not be the case. 2056or may not be the case.
2059 2057
2060@node Citations Outside LaTeX, BibTeX Database Subsets, Chapterbib and Bibunits, Citations 2058@node Citations Outside LaTeX
2061@section Citations outside @LaTeX{} 2059@section Citations outside @LaTeX{}
2062@cindex Citations outside LaTeX 2060@cindex Citations outside LaTeX
2063@vindex reftex-default-bibliography 2061@vindex reftex-default-bibliography
@@ -2082,7 +2080,7 @@ binding for @code{reftex-cite-format}.
2082 (reftex-citation)))))) 2080 (reftex-citation))))))
2083@end lisp 2081@end lisp
2084 2082
2085@node BibTeX Database Subsets, , Citations Outside LaTeX, Citations 2083@node BibTeX Database Subsets
2086@section Database Subsets 2084@section Database Subsets
2087@cindex BibTeX database subsets 2085@cindex BibTeX database subsets
2088@findex reftex-create-bibtex-file 2086@findex reftex-create-bibtex-file
@@ -2110,7 +2108,7 @@ entries in the selection buffer with the @kbd{m} key and then export
2110either the @i{marked} entries (with the @kbd{e} key) or the 2108either the @i{marked} entries (with the @kbd{e} key) or the
2111@i{unmarked} entries (with the @kbd{E} key). 2109@i{unmarked} entries (with the @kbd{E} key).
2112 2110
2113@node Index Support, Viewing Cross-References, Citations, Top 2111@node Index Support
2114@chapter Index Support 2112@chapter Index Support
2115@cindex Index Support 2113@cindex Index Support
2116@cindex @code{\index} 2114@cindex @code{\index}
@@ -2177,7 +2175,7 @@ Style}), or globally for all your documents with
2177* Defining Index Macros:: ... and macros it doesn't. 2175* Defining Index Macros:: ... and macros it doesn't.
2178@end menu 2176@end menu
2179 2177
2180@node Creating Index Entries, The Index Phrases File, , Index Support 2178@node Creating Index Entries
2181@section Creating Index Entries 2179@section Creating Index Entries
2182@cindex Creating index entries 2180@cindex Creating index entries
2183@cindex Index entries, creating 2181@cindex Index entries, creating
@@ -2208,7 +2206,7 @@ index tag is a string identifying one of multiple indices. With the
2208@file{multind} and @file{index} packages, this tag is the first argument 2206@file{multind} and @file{index} packages, this tag is the first argument
2209to the redefined @code{\index} macro. 2207to the redefined @code{\index} macro.
2210 2208
2211@node The Index Phrases File, Displaying and Editing the Index, Creating Index Entries, Index Support 2209@node The Index Phrases File
2212@section The Index Phrases File 2210@section The Index Phrases File
2213@cindex Index phrase file 2211@cindex Index phrase file
2214@cindex Phrase file 2212@cindex Phrase file
@@ -2256,7 +2254,7 @@ repeat @var{word} outside the macro.
2256* Global Indexing:: The interactive indexing process. 2254* Global Indexing:: The interactive indexing process.
2257@end menu 2255@end menu
2258 2256
2259@node Collecting Phrases, Consistency Checks, , The Index Phrases File 2257@node Collecting Phrases
2260@subsection Collecting Phrases 2258@subsection Collecting Phrases
2261@cindex Collecting index phrases 2259@cindex Collecting index phrases
2262@cindex Index phrases, collection 2260@cindex Index phrases, collection
@@ -2285,7 +2283,7 @@ format. A phrase line looks like this:
2285@code{<TABs>} stands for white space containing at least one @key{TAB}. 2283@code{<TABs>} stands for white space containing at least one @key{TAB}.
2286@var{key} must be at the start of the line and is the character 2284@var{key} must be at the start of the line and is the character
2287identifying one of the macros defined in the file header. It is 2285identifying one of the macros defined in the file header. It is
2288optional - when omitted, the first macro definition line in the file 2286optional; when omitted, the first macro definition line in the file
2289will be used for this phrase. The @var{phrase} is the phrase to be 2287will be used for this phrase. The @var{phrase} is the phrase to be
2290searched for when indexing. It may contain several words separated by 2288searched for when indexing. It may contain several words separated by
2291spaces. By default the search phrase is also the text entered as 2289spaces. By default the search phrase is also the text entered as
@@ -2322,7 +2320,7 @@ Finally, every occurrence of @samp{Pluto} will be indexed as
2322@samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto} 2320@samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto}
2323and will therefore create two different index entries. 2321and will therefore create two different index entries.
2324 2322
2325@node Consistency Checks, Global Indexing, Collecting Phrases, The Index Phrases File 2323@node Consistency Checks
2326@subsection Consistency Checks 2324@subsection Consistency Checks
2327@cindex Index phrases, consistency checks 2325@cindex Index phrases, consistency checks
2328@cindex Phrases, consistency checks 2326@cindex Phrases, consistency checks
@@ -2331,7 +2329,7 @@ and will therefore create two different index entries.
2331@kindex C-c C-s 2329@kindex C-c C-s
2332Before indexing the phrases in the phrases buffer, they should be 2330Before indexing the phrases in the phrases buffer, they should be
2333checked carefully for consistency. A first step is to sort the phrases 2331checked carefully for consistency. A first step is to sort the phrases
2334alphabetically - this is done with the command @kbd{C-c C-s} 2332alphabetically; this is done with the command @kbd{C-c C-s}
2335(@code{reftex-index-sort-phrases}). It will sort all phrases in the 2333(@code{reftex-index-sort-phrases}). It will sort all phrases in the
2336buffer alphabetically by search phrase. If you want to group certain 2334buffer alphabetically by search phrase. If you want to group certain
2337phrases and only sort within the groups, insert empty lines between the 2335phrases and only sort within the groups, insert empty lines between the
@@ -2355,7 +2353,7 @@ the buffer which is either duplicate or a subphrase of another phrase.
2355In order to check the whole buffer like this, start at the beginning and 2353In order to check the whole buffer like this, start at the beginning and
2356execute this command repeatedly. 2354execute this command repeatedly.
2357 2355
2358@node Global Indexing, , Consistency Checks, The Index Phrases File 2356@node Global Indexing
2359@subsection Global Indexing 2357@subsection Global Indexing
2360@cindex Global indexing 2358@cindex Global indexing
2361@cindex Indexing, global 2359@cindex Indexing, global
@@ -2436,7 +2434,7 @@ to the changed regions. The command
2436purpose. When called from a @LaTeX{} document with active region, it will 2434purpose. When called from a @LaTeX{} document with active region, it will
2437apply @code{reftex-index-all-phrases} to the current region. 2435apply @code{reftex-index-all-phrases} to the current region.
2438 2436
2439@node Displaying and Editing the Index, Builtin Index Macros, The Index Phrases File, Index Support 2437@node Displaying and Editing the Index
2440@section Displaying and Editing the Index 2438@section Displaying and Editing the Index
2441@cindex Displaying the Index 2439@cindex Displaying the Index
2442@cindex Editing the Index 2440@cindex Editing the Index
@@ -2617,7 +2615,7 @@ indices).
2617@end table 2615@end table
2618 2616
2619 2617
2620@node Builtin Index Macros, Defining Index Macros, Displaying and Editing the Index, Index Support 2618@node Builtin Index Macros
2621@section Builtin Index Macros 2619@section Builtin Index Macros
2622@cindex Builtin index macros 2620@cindex Builtin index macros
2623@cindex Index macros, builtin 2621@cindex Index macros, builtin
@@ -2635,7 +2633,7 @@ the different definitions of the @code{\index} macro are incompatible,
2635you will have to explicitly specify the index style used. 2633you will have to explicitly specify the index style used.
2636@xref{Creating Index Entries}, for information on how to do that. 2634@xref{Creating Index Entries}, for information on how to do that.
2637 2635
2638@node Defining Index Macros, , Builtin Index Macros, Index Support 2636@node Defining Index Macros
2639@section Defining Index Macros 2637@section Defining Index Macros
2640@cindex Defining Index Macros 2638@cindex Defining Index Macros
2641@cindex Index macros, defining 2639@cindex Index macros, defining
@@ -2679,7 +2677,7 @@ unique. @code{?i}, @code{?I}, and @code{?g} are reserved for the
2679respectively. 2677respectively.
2680 2678
2681The following string is empty unless your macro adds a superordinate 2679The following string is empty unless your macro adds a superordinate
2682entry to the index key - this is the case for the @code{\astobj} macro. 2680entry to the index key; this is the case for the @code{\astobj} macro.
2683 2681
2684The next entry can be a hook function to exclude certain matches, it 2682The next entry can be a hook function to exclude certain matches, it
2685almost always can be @code{nil}. 2683almost always can be @code{nil}.
@@ -2732,7 +2730,7 @@ which specifies that the macro identified with the character @code{?x} (the
2732in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}). 2730in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}).
2733The index tag is "idx". 2731The index tag is "idx".
2734 2732
2735@node Viewing Cross-References, RefTeXs Menu, Index Support, Top 2733@node Viewing Cross-References
2736@chapter Viewing Cross-References 2734@chapter Viewing Cross-References
2737@findex reftex-view-crossref 2735@findex reftex-view-crossref
2738@findex reftex-mouse-view-crossref 2736@findex reftex-mouse-view-crossref
@@ -2811,8 +2809,11 @@ in the variable @code{reftex-view-crossref-extra}.
2811@iftex 2809@iftex
2812@chapter All the Rest 2810@chapter All the Rest
2813@end iftex 2811@end iftex
2812@ifnottex
2813@raisesections
2814@end ifnottex
2814 2815
2815@node RefTeXs Menu, Key Bindings, Viewing Cross-References, Top 2816@node RefTeXs Menu
2816@section @RefTeX{}'s Menu 2817@section @RefTeX{}'s Menu
2817@cindex RefTeXs Menu 2818@cindex RefTeXs Menu
2818@cindex Menu, in the menu bar 2819@cindex Menu, in the menu bar
@@ -2823,7 +2824,7 @@ which support this. From this menu you can access all of
2823@code{Customize} submenu which can be used to access @RefTeX{}'s 2824@code{Customize} submenu which can be used to access @RefTeX{}'s
2824entire set of options. 2825entire set of options.
2825 2826
2826@node Key Bindings, Faces, RefTeXs Menu, Top 2827@node Key Bindings
2827@section Default Key Bindings 2828@section Default Key Bindings
2828@cindex Key Bindings, summary 2829@cindex Key Bindings, summary
2829 2830
@@ -2897,7 +2898,7 @@ Changing and adding to @RefTeX{}'s key bindings is best done in the hook
2897@code{reftex-load-hook}. For information on the keymaps 2898@code{reftex-load-hook}. For information on the keymaps
2898which should be used to add keys, see @ref{Keymaps and Hooks}. 2899which should be used to add keys, see @ref{Keymaps and Hooks}.
2899 2900
2900@node Faces, AUCTeX, Key Bindings, Top 2901@node Faces
2901@section Faces 2902@section Faces
2902@cindex Faces 2903@cindex Faces
2903 2904
@@ -2909,7 +2910,7 @@ reasonable because people who like faces will very likely have it
2909loaded. If you wish to turn off fontification or change the involved 2910loaded. If you wish to turn off fontification or change the involved
2910faces, see @ref{Options (Fontification)}. 2911faces, see @ref{Options (Fontification)}.
2911 2912
2912@node Multifile Documents, Language Support, AUCTeX, Top 2913@node Multifile Documents
2913@section Multifile Documents 2914@section Multifile Documents
2914@cindex Multifile documents 2915@cindex Multifile documents
2915@cindex Documents, spread over files 2916@cindex Documents, spread over files
@@ -2962,7 +2963,7 @@ outside the current file can still use that section title as
2962context. 2963context.
2963@end itemize 2964@end itemize
2964 2965
2965@node Language Support, Finding Files, Multifile Documents, Top 2966@node Language Support
2966@section Language Support 2967@section Language Support
2967@cindex Language support 2968@cindex Language support
2968 2969
@@ -3004,7 +3005,7 @@ dependent. See the variables @code{reftex-multiref-punctuation} and
3004@code{reftex-cite-punctuation}. 3005@code{reftex-cite-punctuation}.
3005@end itemize 3006@end itemize
3006 3007
3007@node Finding Files, Optimizations, Language Support, Top 3008@node Finding Files
3008@section Finding Files 3009@section Finding Files
3009@cindex Finding files 3010@cindex Finding files
3010 3011
@@ -3090,7 +3091,7 @@ the new extension must also be known to @AUCTeX{} via the variable
3090 '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo")) 3091 '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))
3091@end lisp 3092@end lisp
3092 3093
3093@node Optimizations, Problems and Work-Arounds, Finding Files, Top 3094@node Optimizations
3094@section Optimizations 3095@section Optimizations
3095@cindex Optimizations 3096@cindex Optimizations
3096 3097
@@ -3243,7 +3244,7 @@ with the @kbd{g} key. To get this behavior, use instead
3243@end group 3244@end group
3244@end lisp 3245@end lisp
3245 3246
3246@node AUCTeX, Multifile Documents, Faces, Top 3247@node AUCTeX
3247@section @AUCTeX{} 3248@section @AUCTeX{}
3248@cindex @code{AUCTeX}, Emacs package 3249@cindex @code{AUCTeX}, Emacs package
3249@cindex Emacs packages, @code{AUCTeX} 3250@cindex Emacs packages, @code{AUCTeX}
@@ -3260,7 +3261,7 @@ XEmacs package.} by FTP from the @value{AUCTEXSITE}.
3260* Bib-Cite:: Hypertext reading of a document 3261* Bib-Cite:: Hypertext reading of a document
3261@end menu 3262@end menu
3262 3263
3263@node AUCTeX-RefTeX Interface, Style Files, , AUCTeX 3264@node AUCTeX-RefTeX Interface
3264@subsection The @AUCTeX{}-@RefTeX{} Interface 3265@subsection The @AUCTeX{}-@RefTeX{} Interface
3265 3266
3266@RefTeX{} contains code to interface with @AUCTeX{}. When this 3267@RefTeX{} contains code to interface with @AUCTeX{}. When this
@@ -3344,7 +3345,7 @@ Labels}).
3344@RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list. 3345@RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list.
3345@end itemize 3346@end itemize
3346 3347
3347@node Style Files, Bib-Cite, AUCTeX-RefTeX Interface, AUCTeX 3348@node Style Files
3348@subsection Style Files 3349@subsection Style Files
3349@cindex Style files, AUCTeX 3350@cindex Style files, AUCTeX
3350@findex TeX-add-style-hook, @r{AUCTeX} 3351@findex TeX-add-style-hook, @r{AUCTeX}
@@ -3464,7 +3465,7 @@ is a style file @file{foils.el} that will inform @RefTeX{} about these:
3464 ("rotatefoilhead" . 3)))))) 3465 ("rotatefoilhead" . 3))))))
3465@end lisp 3466@end lisp
3466 3467
3467@node Bib-Cite, , Style Files, AUCTeX 3468@node Bib-Cite
3468@subsection Bib-Cite 3469@subsection Bib-Cite
3469@cindex @code{bib-cite}, Emacs package 3470@cindex @code{bib-cite}, Emacs package
3470@cindex Emacs packages, @code{bib-cite} 3471@cindex Emacs packages, @code{bib-cite}
@@ -3492,7 +3493,7 @@ make use of this feature, try
3492@end lisp 3493@end lisp
3493 3494
3494@page 3495@page
3495@node Problems and Work-Arounds, Imprint, Optimizations, Top 3496@node Problems and Work-Arounds
3496@section Problems and Work-arounds 3497@section Problems and Work-arounds
3497@cindex Problems and work-arounds 3498@cindex Problems and work-arounds
3498 3499
@@ -3628,7 +3629,7 @@ With @i{Viper} mode prior to Vipers version 3.01, you need to protect
3628@end itemize 3629@end itemize
3629 3630
3630@page 3631@page
3631@node Imprint, Commands, Problems and Work-Arounds, Top 3632@node Imprint
3632@section Imprint 3633@section Imprint
3633@cindex Imprint 3634@cindex Imprint
3634@cindex Maintainer 3635@cindex Maintainer
@@ -3675,7 +3676,12 @@ Finally thanks to @i{Uwe Bolick} who first got me interested in
3675supporting @LaTeX{} labels and references with an editor (which was 3676supporting @LaTeX{} labels and references with an editor (which was
3676MicroEmacs at the time). 3677MicroEmacs at the time).
3677 3678
3678@node Commands, Options, Imprint, Top 3679@c Turn off the raising that we turned on in ``All the rest''.
3680@ifnottex
3681@lowersections
3682@end ifnottex
3683
3684@node Commands
3679@chapter Commands 3685@chapter Commands
3680@cindex Commands, list of 3686@cindex Commands, list of
3681 3687
@@ -3741,8 +3747,8 @@ library which is part of @AUCTeX{}, the string is first processed with the
3741@deffn Command reftex-index-phrase-selection-or-word 3747@deffn Command reftex-index-phrase-selection-or-word
3742Add current selection or the word at point to the phrases buffer. 3748Add current selection or the word at point to the phrases buffer.
3743When you are in transient-mark-mode and the region is active, the 3749When you are in transient-mark-mode and the region is active, the
3744selection will be used - otherwise the word at point. 3750selection will be used; otherwise the word at point.
3745You get a chance to edit the entry in the phrases buffer - to save the 3751You get a chance to edit the entry in the phrases buffer; to save the
3746buffer and return to the @LaTeX{} document, finish with @kbd{C-c C-c}. 3752buffer and return to the @LaTeX{} document, finish with @kbd{C-c C-c}.
3747@end deffn 3753@end deffn
3748 3754
@@ -3877,12 +3883,12 @@ Enforce rebuilding of several internal lists and variables. Also
3877removes the parse file associated with the current document. 3883removes the parse file associated with the current document.
3878@end deffn 3884@end deffn
3879 3885
3880@node Options, Keymaps and Hooks, Commands, Top 3886@node Options
3881@chapter Options, Keymaps, Hooks 3887@chapter Options, Keymaps, Hooks
3882@cindex Options, list of 3888@cindex Options, list of
3883 3889
3884Here is a complete list of @RefTeX{}'s configuration variables. All 3890Here is a complete list of @RefTeX{}'s configuration variables. All
3885variables have customize support - so if you are not familiar with Emacs 3891variables have customize support, so if you are not familiar with Emacs
3886Lisp (and even if you are) you might find it more comfortable to use 3892Lisp (and even if you are) you might find it more comfortable to use
3887@code{customize} to look at and change these variables. @kbd{M-x 3893@code{customize} to look at and change these variables. @kbd{M-x
3888reftex-customize} will get you there. 3894reftex-customize} will get you there.
@@ -3899,9 +3905,10 @@ reftex-customize} will get you there.
3899* Options (Optimizations):: 3905* Options (Optimizations)::
3900* Options (Fontification):: 3906* Options (Fontification)::
3901* Options (Misc):: 3907* Options (Misc)::
3908* Keymaps and Hooks::
3902@end menu 3909@end menu
3903 3910
3904@node Options (Table of Contents), Options (Defining Label Environments), , Options 3911@node Options (Table of Contents)
3905@section Table of Contents 3912@section Table of Contents
3906@cindex Options, table of contents 3913@cindex Options, table of contents
3907@cindex Table of contents, options 3914@cindex Table of contents, options
@@ -4025,7 +4032,7 @@ The keymap which is active in the @file{*toc*} buffer.
4025(@pxref{Table of Contents}). 4032(@pxref{Table of Contents}).
4026@end deffn 4033@end deffn
4027 4034
4028@node Options (Defining Label Environments), Options (Creating Labels), Options (Table of Contents), Options 4035@node Options (Defining Label Environments)
4029@section Defining Label Environments 4036@section Defining Label Environments
4030@cindex Options, defining label environments 4037@cindex Options, defining label environments
4031@cindex Defining label environments, options 4038@cindex Defining label environments, options
@@ -4062,7 +4069,7 @@ Name of the environment (like @samp{table}) or macro (like
4062@samp{\myfig}). For macros, indicate the arguments, as in 4069@samp{\myfig}). For macros, indicate the arguments, as in
4063@samp{\myfig[]@{@}@{@}@{*@}@{@}}. Use square brackets for optional 4070@samp{\myfig[]@{@}@{@}@{*@}@{@}}. Use square brackets for optional
4064arguments, a star to mark the label argument, if any. The macro does 4071arguments, a star to mark the label argument, if any. The macro does
4065not have to have a label argument - you could also use 4072not have to have a label argument; you could also use
4066@samp{\label@{...@}} inside one of its arguments. 4073@samp{\label@{...@}} inside one of its arguments.
4067 4074
4068Special names: @code{section} for section labels, @code{any} to define a 4075Special names: @code{section} for section labels, @code{any} to define a
@@ -4216,7 +4223,7 @@ names like @samp{chapter}, integer section levels (as given in
4216@defopt reftex-default-context-regexps 4223@defopt reftex-default-context-regexps
4217Alist with default regular expressions for finding context. The emacs 4224Alist with default regular expressions for finding context. The emacs
4218lisp form @w{@code{(format regexp (regexp-quote environment))}} is used 4225lisp form @w{@code{(format regexp (regexp-quote environment))}} is used
4219to calculate the final regular expression - so @samp{%s} will be 4226to calculate the final regular expression, so @samp{%s} will be
4220replaced with the environment or macro. 4227replaced with the environment or macro.
4221@end defopt 4228@end defopt
4222 4229
@@ -4252,7 +4259,7 @@ labels fn:xxx, you may want to set this variable to the value "^fn:$" or
4252non-footnote labels. 4259non-footnote labels.
4253@end defopt 4260@end defopt
4254 4261
4255@node Options (Creating Labels), Options (Referencing Labels), Options (Defining Label Environments), Options 4262@node Options (Creating Labels)
4256@section Creating Labels 4263@section Creating Labels
4257@cindex Options, creating labels 4264@cindex Options, creating labels
4258@cindex Creating labels, options 4265@cindex Creating labels, options
@@ -4368,7 +4375,7 @@ Character class after abbrev point in word.
4368@end table 4375@end table
4369@end defopt 4376@end defopt
4370 4377
4371@node Options (Referencing Labels), Options (Creating Citations), Options (Creating Labels), Options 4378@node Options (Referencing Labels)
4372@section Referencing Labels 4379@section Referencing Labels
4373@cindex Options, referencing labels 4380@cindex Options, referencing labels
4374@cindex Referencing labels, options 4381@cindex Referencing labels, options
@@ -4405,7 +4412,7 @@ The available label types are: @code{s} (section), @code{f} (figure),
4405@code{t} (table), @code{i} (item), @code{e} (equation), @code{n} 4412@code{t} (table), @code{i} (item), @code{e} (equation), @code{n}
4406(footnote), plus any definitions in @code{reftex-label-alist}. 4413(footnote), plus any definitions in @code{reftex-label-alist}.
4407 4414
4408Most options can also be switched from the label menu itself - so if you 4415Most options can also be switched from the label menu itself, so if you
4409decide here to not have a table of contents in the label menu, you can 4416decide here to not have a table of contents in the label menu, you can
4410still get one interactively during selection from the label menu. 4417still get one interactively during selection from the label menu.
4411@end defopt 4418@end defopt
@@ -4463,7 +4470,7 @@ Non-@code{nil} means, @code{reftex-reference} will try to guess the
4463label type. To do that, @RefTeX{} will look at the word before the 4470label type. To do that, @RefTeX{} will look at the word before the
4464cursor and compare it with the magic words given in 4471cursor and compare it with the magic words given in
4465@code{reftex-label-alist}. When it finds a match, @RefTeX{} will 4472@code{reftex-label-alist}. When it finds a match, @RefTeX{} will
4466immediately offer the correct label menu - otherwise it will prompt you 4473immediately offer the correct label menu; otherwise it will prompt you
4467for a label type. If you set this variable to @code{nil}, @RefTeX{} 4474for a label type. If you set this variable to @code{nil}, @RefTeX{}
4468will always prompt for a label type. 4475will always prompt for a label type.
4469@end defopt 4476@end defopt
@@ -4490,7 +4497,7 @@ The keymap which is active in the labels selection process
4490(@pxref{Referencing Labels}). 4497(@pxref{Referencing Labels}).
4491@end deffn 4498@end deffn
4492 4499
4493@node Options (Creating Citations), Options (Index Support), Options (Referencing Labels), Options 4500@node Options (Creating Citations)
4494@section Creating Citations 4501@section Creating Citations
4495@cindex Options, creating citations 4502@cindex Options, creating citations
4496@cindex Creating citations, options 4503@cindex Creating citations, options
@@ -4604,7 +4611,8 @@ prompt for values. Possible values are:
4604@example 4611@example
4605nil @r{Never prompt for optional arguments} 4612nil @r{Never prompt for optional arguments}
4606t @r{Always prompt} 4613t @r{Always prompt}
4607maybe @r{Prompt only if @code{reftex-citation} was called with C-u prefix arg}@end example 4614maybe @r{Prompt only if @code{reftex-citation} was called with C-u prefix arg}
4615@end example
4608Unnecessary empty optional arguments are removed before insertion into 4616Unnecessary empty optional arguments are removed before insertion into
4609the buffer. See @code{reftex-cite-cleanup-optional-args}. 4617the buffer. See @code{reftex-cite-cleanup-optional-args}.
4610@end defopt 4618@end defopt
@@ -4668,7 +4676,7 @@ Footer to insert in BibTeX files generated by
4668@end defopt 4676@end defopt
4669 4677
4670 4678
4671@node Options (Index Support), Options (Viewing Cross-References), Options (Creating Citations), Options 4679@node Options (Index Support)
4672@section Index Support 4680@section Index Support
4673@cindex Options, Index support 4681@cindex Options, Index support
4674@cindex Index support, options 4682@cindex Index support, options
@@ -4727,11 +4735,11 @@ The final entry may also be a symbol. It must have an association in
4727the variable @code{reftex-index-macros-builtin} to specify the main 4735the variable @code{reftex-index-macros-builtin} to specify the main
4728indexing package you are using. Valid values are currently 4736indexing package you are using. Valid values are currently
4729@example 4737@example
4730default @r{The @LaTeX{} default - unnecessary to specify this one} 4738default @r{The @LaTeX{} default; unnecessary to specify this one}
4731multind @r{The multind.sty package} 4739multind @r{The multind.sty package}
4732index @r{The index.sty package} 4740index @r{The index.sty package}
4733index-shortcut @r{The index.sty packages with the ^ and _ shortcuts.} 4741index-shortcut @r{The index.sty packages with the ^ and _ shortcuts.}
4734 @r{Should not be used - only for old documents} 4742 @r{Should not be used; only for old documents}
4735@end example 4743@end example
4736Note that @AUCTeX{} sets these things internally for @RefTeX{} as well, 4744Note that @AUCTeX{} sets these things internally for @RefTeX{} as well,
4737so with a sufficiently new version of @AUCTeX{}, you should not set the 4745so with a sufficiently new version of @AUCTeX{}, you should not set the
@@ -4742,7 +4750,7 @@ package here.
4742The default index macro for @code{reftex-index-selection-or-word}. 4750The default index macro for @code{reftex-index-selection-or-word}.
4743This is a list with @code{(@var{macro-key} @var{default-tag})}. 4751This is a list with @code{(@var{macro-key} @var{default-tag})}.
4744 4752
4745@var{macro-key} is a character identifying an index macro - see 4753@var{macro-key} is a character identifying an index macro; see
4746@code{reftex-index-macros}. 4754@code{reftex-index-macros}.
4747 4755
4748@var{default-tag} is the tag to be used if the macro requires a 4756@var{default-tag} is the tag to be used if the macro requires a
@@ -4830,7 +4838,7 @@ case, that match will be ignored.
4830 4838
4831@defopt reftex-index-phrases-wrap-long-lines 4839@defopt reftex-index-phrases-wrap-long-lines
4832Non-@code{nil} means, when indexing from the phrases buffer, wrap lines. 4840Non-@code{nil} means, when indexing from the phrases buffer, wrap lines.
4833Inserting indexing commands in a line makes the line longer - often 4841Inserting indexing commands in a line makes the line longer, often
4834so long that it does not fit onto the screen. When this variable is 4842so long that it does not fit onto the screen. When this variable is
4835non-@code{nil}, newlines will be added as necessary before and/or after the 4843non-@code{nil}, newlines will be added as necessary before and/or after the
4836indexing command to keep lines short. However, the matched text 4844indexing command to keep lines short. However, the matched text
@@ -4888,7 +4896,7 @@ The keymap which is active in the @file{*Index*} buffer
4888(@pxref{Index Support}). 4896(@pxref{Index Support}).
4889@end deffn 4897@end deffn
4890 4898
4891@node Options (Viewing Cross-References), Options (Finding Files), Options (Index Support), Options 4899@node Options (Viewing Cross-References)
4892@section Viewing Cross-References 4900@section Viewing Cross-References
4893@cindex Options, viewing cross-references 4901@cindex Options, viewing cross-references
4894@cindex Viewing cross-references, options 4902@cindex Viewing cross-references, options
@@ -4947,7 +4955,7 @@ saved along with the parsing information. The cache survives document
4947scans. In order to clear it, use @kbd{M-x reftex-reset-mode}. 4955scans. In order to clear it, use @kbd{M-x reftex-reset-mode}.
4948@end defopt 4956@end defopt
4949 4957
4950@node Options (Finding Files), Options (Optimizations), Options (Viewing Cross-References), Options 4958@node Options (Finding Files)
4951@section Finding Files 4959@section Finding Files
4952@cindex Options, Finding Files 4960@cindex Options, Finding Files
4953@cindex Finding files, options 4961@cindex Finding files, options
@@ -5008,7 +5016,7 @@ Non-@code{nil} means, search all specified directories before trying
5008recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./}, 5016recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./},
5009then @samp{/tex/}, and then all subdirectories of @samp{./}. If this 5017then @samp{/tex/}, and then all subdirectories of @samp{./}. If this
5010option is @code{nil}, the subdirectories of @samp{./} are searched 5018option is @code{nil}, the subdirectories of @samp{./} are searched
5011before @samp{/tex/}. This is mainly for speed - most of the time the 5019before @samp{/tex/}. This is mainly for speed; most of the time the
5012recursive path is for the system files and not for the user files. Set 5020recursive path is for the system files and not for the user files. Set
5013this to @code{nil} if the default makes @RefTeX{} finding files with 5021this to @code{nil} if the default makes @RefTeX{} finding files with
5014equal names in wrong sequence. 5022equal names in wrong sequence.
@@ -5037,7 +5045,7 @@ non-@code{nil}.
5037@end defopt 5045@end defopt
5038 5046
5039@page 5047@page
5040@node Options (Optimizations), Options (Fontification), Options (Finding Files), Options 5048@node Options (Optimizations)
5041@section Optimizations 5049@section Optimizations
5042@cindex Options, optimizations 5050@cindex Options, optimizations
5043@cindex Optimizations, options 5051@cindex Optimizations, options
@@ -5129,7 +5137,7 @@ cannot be placed with certainty into the internal label list.
5129@defopt reftex-use-multiple-selection-buffers 5137@defopt reftex-use-multiple-selection-buffers
5130Non-@code{nil} means use a separate selection buffer for each label 5138Non-@code{nil} means use a separate selection buffer for each label
5131type. These buffers are kept from one selection to the next and need 5139type. These buffers are kept from one selection to the next and need
5132not to be created for each use - so the menu generally comes up faster. 5140not be created for each use, so the menu generally comes up faster.
5133The selection buffers will be erased (and therefore updated) 5141The selection buffers will be erased (and therefore updated)
5134automatically when new labels in its category are added. See the 5142automatically when new labels in its category are added. See the
5135variable @code{reftex-auto-update-selection-buffers}. 5143variable @code{reftex-auto-update-selection-buffers}.
@@ -5146,7 +5154,7 @@ effect when @code{reftex-use-multiple-selection-buffers} is
5146non-@code{nil}. 5154non-@code{nil}.
5147@end defopt 5155@end defopt
5148 5156
5149@node Options (Fontification), Options (Misc), Options (Optimizations), Options 5157@node Options (Fontification)
5150@section Fontification 5158@section Fontification
5151@cindex Options, fontification 5159@cindex Options, fontification
5152@cindex Fontification, options 5160@cindex Fontification, options
@@ -5244,7 +5252,7 @@ Face name for index names (for multiple indices).
5244Face name for index entries. 5252Face name for index entries.
5245@end defopt 5253@end defopt
5246 5254
5247@node Options (Misc), , Options (Fontification), Options 5255@node Options (Misc)
5248@section Miscellaneous 5256@section Miscellaneous
5249@cindex Options, misc 5257@cindex Options, misc
5250 5258
@@ -5289,7 +5297,7 @@ this will be the case even if @code{\bb} is defined with zero or one
5289argument. 5297argument.
5290@end defopt 5298@end defopt
5291 5299
5292@node Keymaps and Hooks, Changes, Options, Top 5300@node Keymaps and Hooks
5293@section Keymaps and Hooks 5301@section Keymaps and Hooks
5294@cindex Keymaps 5302@cindex Keymaps
5295 5303
@@ -5313,7 +5321,7 @@ their own keymaps and mode hooks. See the respective sections. There
5313are many more hooks which are described in the relevant sections about 5321are many more hooks which are described in the relevant sections about
5314options for a specific part of @RefTeX{}. 5322options for a specific part of @RefTeX{}.
5315 5323
5316@node Changes, GNU Free Documentation License, Keymaps and Hooks, Top 5324@node Changes
5317@chapter Changes 5325@chapter Changes
5318@cindex Changes 5326@cindex Changes
5319 5327
@@ -6078,11 +6086,11 @@ new labels.
6078released on 7 Jan 1997. 6086released on 7 Jan 1997.
6079@end itemize 6087@end itemize
6080 6088
6081@node GNU Free Documentation License, Index, Changes, Top 6089@node GNU Free Documentation License
6082@appendix GNU Free Documentation License 6090@appendix GNU Free Documentation License
6083@include doclicense.texi 6091@include doclicense.texi
6084 6092
6085@node Index, , GNU Free Documentation License, Top 6093@node Index
6086@unnumbered Index 6094@unnumbered Index
6087@printindex cp 6095@printindex cp
6088 6096
diff --git a/doc/misc/remember.texi b/doc/misc/remember.texi
index f97d835e50c..c70b6212268 100644
--- a/doc/misc/remember.texi
+++ b/doc/misc/remember.texi
@@ -8,7 +8,7 @@
8@copying 8@copying
9This manual is for Remember Mode, version 1.9 9This manual is for Remember Mode, version 1.9
10 10
11Copyright @copyright{} 2001, 2004-2005, 2007-2012 11Copyright @copyright{} 2001, 2004--2005, 2007--2013
12Free Software Foundation, Inc. 12Free Software Foundation, Inc.
13 13
14@quotation 14@quotation
@@ -20,8 +20,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License''. 20is included in the section entitled ``GNU Free Documentation License''.
21 21
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual. Buying copies from the FSF supports it in 23modify this GNU manual.''
24developing GNU and promoting software freedom.''
25@end quotation 24@end quotation
26@end copying 25@end copying
27 26
@@ -45,8 +44,7 @@ developing GNU and promoting software freedom.''
45@contents 44@contents
46 45
47@ifnottex 46@ifnottex
48@node Top, Preface, (dir), (dir) 47@node Top
49@comment node-name, next, previous, up
50@top Remember 48@top Remember
51 49
52@insertcopying 50@insertcopying
@@ -77,8 +75,7 @@ Backends
77@end detailmenu 75@end detailmenu
78@end menu 76@end menu
79 77
80@node Preface, Introduction, Top, Top 78@node Preface
81@comment node-name, next, previous, up
82@chapter Preface 79@chapter Preface
83 80
84This document describes remember-el, which was written by John Wiegley, 81This document describes remember-el, which was written by John Wiegley,
@@ -88,8 +85,7 @@ developers.
88This document is a work in progress, and your contribution will be 85This document is a work in progress, and your contribution will be
89greatly appreciated. 86greatly appreciated.
90 87
91@node Introduction, Installation, Preface, Top 88@node Introduction
92@comment node-name, next, previous, up
93@chapter Introduction 89@chapter Introduction
94 90
95Todo lists, schedules, phone databases... everything we use databases 91Todo lists, schedules, phone databases... everything we use databases
@@ -131,8 +127,7 @@ in order to record them---it would map much more closely to how the mind
131manual-ness which computers from the very beginning have been championed 127manual-ness which computers from the very beginning have been championed
132as being able to reduce. 128as being able to reduce.
133 129
134@node Installation, Implementation, Introduction, Top 130@node Installation
135@comment node-name, next, previous, up
136@chapter Installation 131@chapter Installation
137 132
138Installing Remember Mode is as simple as adding the following lines to 133Installing Remember Mode is as simple as adding the following lines to
@@ -144,8 +139,7 @@ your Emacs configuration file (usually @file{~/.emacs.d/init.el} or
144(require 'remember) 139(require 'remember)
145@end lisp 140@end lisp
146 141
147@node Implementation, Quick Start, Installation, Top 142@node Implementation
148@comment node-name, next, previous, up
149@chapter Implementation 143@chapter Implementation
150 144
151Hyperbole, as a data presentation tool, always struck me as being very 145Hyperbole, as a data presentation tool, always struck me as being very
@@ -186,8 +180,7 @@ rather than requiring a billion keystrokes to reorganize your
186hierarchy. Well, as the future arrives, hopefully experience and user 180hierarchy. Well, as the future arrives, hopefully experience and user
187feedback will help to make this as intuitive a tool as possible. 181feedback will help to make this as intuitive a tool as possible.
188 182
189@node Quick Start, Function Reference, Implementation, Top 183@node Quick Start
190@comment node-name, next, previous, up
191@chapter Quick Start 184@chapter Quick Start
192 185
193@itemize 186@itemize
@@ -258,8 +251,7 @@ remember-annotation-functions. For example:
258 (call-interactively 'remember))) 251 (call-interactively 'remember)))
259@end lisp 252@end lisp
260 253
261@node Function Reference, Keystrokes, Quick Start, Top 254@node Function Reference
262@comment node-name, next, previous, up
263@chapter Function Reference 255@chapter Function Reference
264 256
265@file{remember.el} defines the following interactive functions: 257@file{remember.el} defines the following interactive functions:
@@ -292,8 +284,7 @@ buffer is used to collect data that you want remember. Just hit
292the data for latter retrieval, and possible indexing. 284the data for latter retrieval, and possible indexing.
293@end defun 285@end defun
294 286
295@node Keystrokes, Backends, Function Reference, Top 287@node Keystrokes
296@comment node-name, next, previous, up
297@chapter Keystroke Reference 288@chapter Keystroke Reference
298 289
299@file{remember.el} defines the following keybindings by default: 290@file{remember.el} defines the following keybindings by default:
@@ -311,8 +302,7 @@ Remember the contents of the current buffer.
311 302
312@end table 303@end table
313 304
314@node Backends, GNU Free Documentation License, Keystrokes, Top 305@node Backends
315@comment node-name, next, previous, up
316@chapter Backends 306@chapter Backends
317 307
318You can save remembered notes to a variety of backends. 308You can save remembered notes to a variety of backends.
@@ -324,8 +314,7 @@ You can save remembered notes to a variety of backends.
324* Org:: Saving to an Org Mode file. 314* Org:: Saving to an Org Mode file.
325@end menu 315@end menu
326 316
327@node Text File, Diary, Backends, Backends 317@node Text File
328@comment node-name, next, previous, up
329@section Saving to a Text File 318@section Saving to a Text File
330@cindex text file, saving to 319@cindex text file, saving to
331 320
@@ -345,8 +334,7 @@ The file in which to store unprocessed data.
345The text used to begin each remember item. 334The text used to begin each remember item.
346@end defopt 335@end defopt
347 336
348@node Diary, Mailbox, Text File, Backends 337@node Diary
349@comment node-name, next, previous, up
350@section Saving to a Diary file 338@section Saving to a Diary file
351@cindex diary, integration 339@cindex diary, integration
352 340
@@ -363,8 +351,7 @@ File for extracted diary entries.
363If this is nil, then @code{diary-file} will be used instead." 351If this is nil, then @code{diary-file} will be used instead."
364@end defopt 352@end defopt
365 353
366@node Mailbox, Org, Diary, Backends 354@node Mailbox
367@comment node-name, next, previous, up
368@section Saving to a Mailbox 355@section Saving to a Mailbox
369@cindex mailbox, saving to 356@cindex mailbox, saving to
370 357
@@ -384,8 +371,7 @@ The file in which to store remember data as mail.
384The default priority for remembered mail messages. 371The default priority for remembered mail messages.
385@end defopt 372@end defopt
386 373
387@node Org, , Mailbox, Backends 374@node Org
388@comment node-name, next, previous, up
389@section Saving to an Org Mode file 375@section Saving to an Org Mode file
390@cindex org mode, integration 376@cindex org mode, integration
391 377
@@ -399,12 +385,11 @@ for org-remember at @url{http://orgmode.org/org-remember.pdf}.
399For instructions on how to integrate Remember with Org Mode, 385For instructions on how to integrate Remember with Org Mode,
400consult @ref{Capture, , , org}. 386consult @ref{Capture, , , org}.
401 387
402@node GNU Free Documentation License, Concept Index, Backends, Top 388@node GNU Free Documentation License
403@appendix GNU Free Documentation License 389@appendix GNU Free Documentation License
404@include doclicense.texi 390@include doclicense.texi
405 391
406@node Concept Index, , GNU Free Documentation License, Top 392@node Concept Index
407@comment node-name, next, previous, up
408@unnumbered Index 393@unnumbered Index
409 394
410@printindex cp 395@printindex cp
diff --git a/doc/misc/sasl.texi b/doc/misc/sasl.texi
index a31d9ca5e38..dcb25ec805a 100644
--- a/doc/misc/sasl.texi
+++ b/doc/misc/sasl.texi
@@ -10,8 +10,7 @@
10@copying 10@copying
11This file describes the Emacs SASL library, version @value{VERSION}. 11This file describes the Emacs SASL library, version @value{VERSION}.
12 12
13Copyright @copyright{} 2000, 2004-2012 13Copyright @copyright{} 2000, 2004--2013 Free Software Foundation, Inc.
14Free Software Foundation, Inc.
15 14
16@quotation 15@quotation
17Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -19,17 +18,10 @@ under the terms of the GNU Free Documentation License, Version 1.3 or
19any later version published by the Free Software Foundation; with no 18any later version published by the Free Software Foundation; with no
20Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 19Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
21and with the Back-Cover Texts as in (a) below. A copy of the license 20and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License'' 21is included in the section entitled ``GNU Free Documentation License''.
23in the Emacs manual.
24 22
25(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 23(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
26modify this GNU manual. Buying copies from the FSF supports it in 24modify this GNU manual.''
27developing GNU and promoting software freedom.''
28
29This document is part of a collection distributed under the GNU Free
30Documentation License. If you want to distribute this document
31separately from the collection, you can do so by adding a copy of the
32license to the document, as described in section 6 of the license.
33@end quotation 25@end quotation
34@end copying 26@end copying
35 27
@@ -62,17 +54,18 @@ SASL is a common interface to share several authentication mechanisms between
62applications using different protocols. 54applications using different protocols.
63 55
64@ifnottex 56@ifnottex
65@insertcopying 57@insertcopying
66@end ifnottex 58@end ifnottex
67 59
68@menu 60@menu
69* Overview:: What Emacs SASL library is. 61* Overview:: What Emacs SASL library is.
70* How to use:: Adding authentication support to your applications. 62* How to use:: Adding authentication support to your applications.
71* Data types:: 63* Data types::
72* Back end drivers:: Writing your own drivers. 64* Back end drivers:: Writing your own drivers.
73* Index:: 65* GNU Free Documentation License:: The license for this documentation.
74* Function Index:: 66* Index::
75* Variable Index:: 67* Function Index::
68* Variable Index::
76@end menu 69@end menu
77 70
78@node Overview 71@node Overview
@@ -113,9 +106,9 @@ security layer---a mechanism, a client parameter and an authentication
113step. 106step.
114 107
115@menu 108@menu
116* Mechanisms:: 109* Mechanisms::
117* Clients:: 110* Clients::
118* Steps:: 111* Steps::
119@end menu 112@end menu
120 113
121@node Mechanisms 114@node Mechanisms
@@ -258,16 +251,20 @@ At the first time @var{step} should be set to @code{nil}.
258 251
259(Not yet written). 252(Not yet written).
260 253
254@node GNU Free Documentation License
255@appendix GNU Free Documentation License
256@include doclicense.texi
257
261@node Index 258@node Index
262@chapter Index 259@unnumbered Index
263@printindex cp 260@printindex cp
264 261
265@node Function Index 262@node Function Index
266@chapter Function Index 263@unnumbered Function Index
267@printindex fn 264@printindex fn
268 265
269@node Variable Index 266@node Variable Index
270@chapter Variable Index 267@unnumbered Variable Index
271@printindex vr 268@printindex vr
272 269
273@summarycontents 270@summarycontents
diff --git a/doc/misc/sc.texi b/doc/misc/sc.texi
index d6d57421ec2..cfd040f0e82 100644
--- a/doc/misc/sc.texi
+++ b/doc/misc/sc.texi
@@ -14,7 +14,7 @@
14This document describes Supercite, an Emacs package for citing and 14This document describes Supercite, an Emacs package for citing and
15attributing replies to mail and news messages. 15attributing replies to mail and news messages.
16 16
17Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. 17Copyright @copyright{} 1993, 2001--2013 Free Software Foundation, Inc.
18 18
19@quotation 19@quotation
20Permission is granted to copy, distribute and/or modify this document 20Permission is granted to copy, distribute and/or modify this document
@@ -25,8 +25,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
25is included in the section entitled ``GNU Free Documentation License''. 25is included in the section entitled ``GNU Free Documentation License''.
26 26
27(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 27(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
28modify this GNU manual. Buying copies from the FSF supports it in 28modify this GNU manual.''
29developing GNU and promoting software freedom.''
30@end quotation 29@end quotation
31@end copying 30@end copying
32 31
@@ -1480,7 +1479,7 @@ recognizing specific alternative forms.
1480@vindex sc-cite-frame-alist 1479@vindex sc-cite-frame-alist
1481@vindex sc-uncite-frame-alist 1480@vindex sc-uncite-frame-alist
1482@vindex sc-recite-frame-alist 1481@vindex sc-recite-frame-alist
1483For each of the actions -- citing, unciting, and reciting -- an alist is 1482For each of the actions---citing, unciting, and reciting---an alist is
1484consulted to find the frame to use (@code{sc-cite-frame-alist}, 1483consulted to find the frame to use (@code{sc-cite-frame-alist},
1485@code{sc-uncite-frame-alist}, and @code{sc-recite-frame-alist} 1484@code{sc-uncite-frame-alist}, and @code{sc-recite-frame-alist}
1486respectively). These frames can contain alists of the form: 1485respectively). These frames can contain alists of the form:
diff --git a/doc/misc/sem-user.texi b/doc/misc/sem-user.texi
index f483c899bf2..82af6c8f494 100644
--- a/doc/misc/sem-user.texi
+++ b/doc/misc/sem-user.texi
@@ -1,13 +1,7 @@
1@c This file is included by semantic.texi 1@c This is part of the Semantic manual.
2 2@c Copyright (C) 1999-2005, 2007, 2009-2013 Free Software Foundation,
3@c Copyright (C) 1999-2005, 2007, 2009-2012 Free Software Foundation, Inc. 3@c Inc.
4 4@c See file semantic.texi for copying conditions.
5@c Permission is granted to copy, distribute and/or modify this
6@c document under the terms of the GNU Free Documentation License,
7@c Version 1.3 or any later version published by the Free Software
8@c Foundation; with no Invariant Sections, no Front-Cover Texts, and
9@c no Back-Cover Texts. A copy of the license is included in the
10@c section entitled ``GNU Free Documentation License''.
11 5
12You can begin using @semantic{} by enabling Semantic mode, a global 6You can begin using @semantic{} by enabling Semantic mode, a global
13minor mode: type @kbd{M-x semantic-mode}, or open the @samp{Tools} 7minor mode: type @kbd{M-x semantic-mode}, or open the @samp{Tools}
diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi
index ad8392c208b..de5019ee897 100644
--- a/doc/misc/semantic.texi
+++ b/doc/misc/semantic.texi
@@ -24,7 +24,8 @@
24@copying 24@copying
25This manual documents the Semantic library and utilities. 25This manual documents the Semantic library and utilities.
26 26
27Copyright @copyright{} 1999-2005, 2007, 2009-2012 Free Software Foundation, Inc. 27Copyright @copyright{} 1999--2005, 2007, 2009--2013 Free Software
28Foundation, Inc.
28 29
29@quotation 30@quotation
30Permission is granted to copy, distribute and/or modify this document 31Permission is granted to copy, distribute and/or modify this document
@@ -35,8 +36,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
35is included in the section entitled ``GNU Free Documentation License.'' 36is included in the section entitled ``GNU Free Documentation License.''
36 37
37(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 38(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
38modify this GNU manual. Buying copies from the FSF supports it in 39modify this GNU manual.''
39developing GNU and promoting software freedom.''
40@end quotation 40@end quotation
41@end copying 41@end copying
42 42
diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi
index fecba99952f..ce75f2ef91e 100644
--- a/doc/misc/ses.texi
+++ b/doc/misc/ses.texi
@@ -11,7 +11,7 @@
11@copying 11@copying
12This file documents @acronym{SES}: the Simple Emacs Spreadsheet. 12This file documents @acronym{SES}: the Simple Emacs Spreadsheet.
13 13
14Copyright @copyright{} 2002-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 2002--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License.'' 22is included in the section entitled ``GNU Free Documentation License.''
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
@@ -50,7 +49,7 @@ developing GNU and promoting software freedom.''
50@c =================================================================== 49@c ===================================================================
51 50
52@ifnottex 51@ifnottex
53@node Top, Sales Pitch, (dir), (dir) 52@node Top
54@comment node-name, next, previous, up 53@comment node-name, next, previous, up
55@top @acronym{SES}: Simple Emacs Spreadsheet 54@top @acronym{SES}: Simple Emacs Spreadsheet
56 55
@@ -77,7 +76,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}.
77 76
78@c =================================================================== 77@c ===================================================================
79 78
80@node Sales Pitch, The Basics, Top, Top 79@node Sales Pitch
81@comment node-name, next, previous, up 80@comment node-name, next, previous, up
82@chapter Sales Pitch 81@chapter Sales Pitch
83@cindex features 82@cindex features
@@ -99,7 +98,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}.
99 98
100@c =================================================================== 99@c ===================================================================
101 100
102@node The Basics, Advanced Features, Sales Pitch, Top 101@node The Basics
103@comment node-name, next, previous, up 102@comment node-name, next, previous, up
104@chapter The Basics 103@chapter The Basics
105@cindex basic commands 104@cindex basic commands
@@ -158,7 +157,7 @@ Highlight all cells (@code{mark-whole-buffer}).
158* Customizing @acronym{SES}:: 157* Customizing @acronym{SES}::
159@end menu 158@end menu
160 159
161@node Formulas, Resizing, The Basics, The Basics 160@node Formulas
162@section Cell formulas 161@section Cell formulas
163@cindex formulas 162@cindex formulas
164@cindex formulas, entering 163@cindex formulas, entering
@@ -211,7 +210,7 @@ Force recalculation of the current cell or range (@code{ses-recalculate-cell}).
211Recalculate the entire spreadsheet (@code{ses-recalculate-all}). 210Recalculate the entire spreadsheet (@code{ses-recalculate-all}).
212@end table 211@end table
213 212
214@node Resizing, Printer functions, Formulas, The Basics 213@node Resizing
215@section Resizing the spreadsheet 214@section Resizing the spreadsheet
216@cindex resizing spreadsheets 215@cindex resizing spreadsheets
217@findex ses-insert-row 216@findex ses-insert-row
@@ -267,7 +266,7 @@ Undo previous action (@code{(undo)}).
267@end table 266@end table
268 267
269 268
270@node Printer functions, Clearing cells, Resizing, The Basics 269@node Printer functions
271@section Printer functions 270@section Printer functions
272@cindex printer functions 271@cindex printer functions
273@findex ses-read-cell-printer 272@findex ses-read-cell-printer
@@ -332,7 +331,7 @@ Centering with tildes (~) and spill-over.
332@end table 331@end table
333 332
334 333
335@node Clearing cells, Copy/cut/paste, Printer functions, The Basics 334@node Clearing cells
336@section Clearing cells 335@section Clearing cells
337@cindex clearing commands 336@cindex clearing commands
338@findex ses-clear-cell-backward 337@findex ses-clear-cell-backward
@@ -349,7 +348,7 @@ Clear cell and move right (@code{ses-clear-cell-forward}).
349@end table 348@end table
350 349
351 350
352@node Copy/cut/paste, Customizing @acronym{SES}, Clearing cells, The Basics 351@node Copy/cut/paste
353@section Copy, cut, and paste 352@section Copy, cut, and paste
354@cindex copy 353@cindex copy
355@cindex cut 354@cindex cut
@@ -424,7 +423,7 @@ Emacs yank-pop, the @acronym{SES} version uses @code{undo} to delete the old
424yank. This doesn't make any difference? 423yank. This doesn't make any difference?
425@end table 424@end table
426 425
427@node Customizing @acronym{SES}, , Copy/cut/paste, The Basics 426@node Customizing @acronym{SES}
428@section Customizing @acronym{SES} 427@section Customizing @acronym{SES}
429@cindex customizing 428@cindex customizing
430@vindex enable-local-eval 429@vindex enable-local-eval
@@ -461,7 +460,7 @@ safety belts!
461 460
462@c =================================================================== 461@c ===================================================================
463 462
464@node Advanced Features, For Gurus, The Basics, Top 463@node Advanced Features
465@chapter Advanced Features 464@chapter Advanced Features
466@cindex advanced features 465@cindex advanced features
467@findex ses-read-header-row 466@findex ses-read-header-row
@@ -504,7 +503,7 @@ repair that use function @code{ses-repair-cell-reference-all}
504* Spreadsheets with details and summary:: 503* Spreadsheets with details and summary::
505@end menu 504@end menu
506 505
507@node The print area, Ranges in formulas, Advanced Features, Advanced Features 506@node The print area
508@section The print area 507@section The print area
509@cindex print area 508@cindex print area
510@findex widen 509@findex widen
@@ -530,7 +529,7 @@ Recreate print area by reevaluating printer functions for all cells
530(@code{ses-reprint-all}). 529(@code{ses-reprint-all}).
531@end table 530@end table
532 531
533@node Ranges in formulas, Sorting by column, The print area, Advanced Features 532@node Ranges in formulas
534@section Ranges in formulas 533@section Ranges in formulas
535@cindex ranges 534@cindex ranges
536@findex ses-insert-range-click 535@findex ses-insert-range-click
@@ -636,7 +635,7 @@ is only one row or column in the range, that is to say the
636corresponding matrix is flattened. 635corresponding matrix is flattened.
637@end table 636@end table
638 637
639@node Sorting by column, Standard formula functions, Ranges in formulas, Advanced Features 638@node Sorting by column
640@section Sorting by column 639@section Sorting by column
641@cindex sorting 640@cindex sorting
642@findex ses-sort-column 641@findex ses-sort-column
@@ -665,7 +664,7 @@ formulas that refer to other rows in the range or to cells outside the
665range. 664range.
666 665
667 666
668@node Standard formula functions, More on cell printing, Sorting by column, Advanced Features 667@node Standard formula functions
669@section Standard formula functions 668@section Standard formula functions
670@cindex standard formula functions 669@cindex standard formula functions
671@cindex *skip* 670@cindex *skip*
@@ -690,7 +689,7 @@ Average of non-blank elements in @var{list}. Here the list is passed
690as a single argument, since you'll probably use it with @code{ses-range}. 689as a single argument, since you'll probably use it with @code{ses-range}.
691@end table 690@end table
692 691
693@node More on cell printing, Import and export, Standard formula functions, Advanced Features 692@node More on cell printing
694@section More on cell printing 693@section More on cell printing
695@cindex cell printing, more 694@cindex cell printing, more
696@findex ses-truncate-cell 695@findex ses-truncate-cell
@@ -738,7 +737,7 @@ that are empty of contain strings will use the fallback printer.
738argument type''. 737argument type''.
739 738
740 739
741@node Import and export, Virus protection, More on cell printing, Advanced Features 740@node Import and export
742@section Import and export 741@section Import and export
743@cindex import and export 742@cindex import and export
744@cindex export, and import 743@cindex export, and import
@@ -752,13 +751,13 @@ Export a range of cells as tab-separated values (@code{ses-export-tsv}).
752Export a range of cells as tab-separated formulas (@code{ses-export-tsf}). 751Export a range of cells as tab-separated formulas (@code{ses-export-tsf}).
753@end table 752@end table
754 753
755The exported text goes to the kill ring --- you can paste it into 754The exported text goes to the kill ring; you can paste it into
756another buffer. Columns are separated by tabs, rows by newlines. 755another buffer. Columns are separated by tabs, rows by newlines.
757 756
758To import text, use any of the yank commands where the text to paste 757To import text, use any of the yank commands where the text to paste
759contains tabs and/or newlines. Imported formulas are not relocated. 758contains tabs and/or newlines. Imported formulas are not relocated.
760 759
761@node Virus protection, Spreadsheets with details and summary, Import and export, Advanced Features 760@node Virus protection
762@section Virus protection 761@section Virus protection
763@cindex virus protection 762@cindex virus protection
764 763
@@ -785,7 +784,7 @@ parts of the Emacs Lisp environment can be excluded without cramping
785your style as a formula-writer. See the documentation in @file{unsafep.el} 784your style as a formula-writer. See the documentation in @file{unsafep.el}
786for more info on how Lisp forms are classified as safe or unsafe. 785for more info on how Lisp forms are classified as safe or unsafe.
787 786
788@node Spreadsheets with details and summary, , Virus protection, Advanced Features 787@node Spreadsheets with details and summary
789@section Spreadsheets with details and summary 788@section Spreadsheets with details and summary
790@cindex details and summary 789@cindex details and summary
791@cindex summary, and details 790@cindex summary, and details
@@ -821,7 +820,7 @@ details-and-summary spreadsheet.
821 820
822@c =================================================================== 821@c ===================================================================
823 822
824@node For Gurus, Index, Advanced Features, Top 823@node For Gurus
825@chapter For Gurus 824@chapter For Gurus
826@cindex advanced features 825@cindex advanced features
827 826
@@ -833,7 +832,7 @@ details-and-summary spreadsheet.
833* Uses of defadvice in @acronym{SES}:: 832* Uses of defadvice in @acronym{SES}::
834@end menu 833@end menu
835 834
836@node Deferred updates, Nonrelocatable references, For Gurus, For Gurus 835@node Deferred updates
837@section Deferred updates 836@section Deferred updates
838@cindex deferred updates 837@cindex deferred updates
839@cindex updates, deferred 838@cindex updates, deferred
@@ -865,7 +864,7 @@ a momentary glitch after C-x C-v and certain scrolling commands. You
865can type ahead without worrying about the glitch. 864can type ahead without worrying about the glitch.
866 865
867 866
868@node Nonrelocatable references, The data area, Deferred updates, For Gurus 867@node Nonrelocatable references
869@section Nonrelocatable references 868@section Nonrelocatable references
870@cindex nonrelocatable references 869@cindex nonrelocatable references
871@cindex references, nonrelocatable 870@cindex references, nonrelocatable
@@ -893,7 +892,7 @@ to get the value from the leftmost column in the current row. This
893kind of dependency is also not recorded. 892kind of dependency is also not recorded.
894 893
895 894
896@node The data area, Buffer-local variables in spreadsheets, Nonrelocatable references, For Gurus 895@node The data area
897@section The data area 896@section The data area
898@cindex data area 897@cindex data area
899@findex ses-reconstruct-all 898@findex ses-reconstruct-all
@@ -925,7 +924,7 @@ data structures:
925@end table 924@end table
926 925
927 926
928@node Buffer-local variables in spreadsheets, Uses of defadvice in @acronym{SES}, The data area, For Gurus 927@node Buffer-local variables in spreadsheets
929@section Buffer-local variables in spreadsheets 928@section Buffer-local variables in spreadsheets
930@cindex buffer-local variables 929@cindex buffer-local variables
931@cindex variables, buffer-local 930@cindex variables, buffer-local
@@ -948,7 +947,7 @@ order to avoid a virus warning.
948You can define functions by making them values for the fake local 947You can define functions by making them values for the fake local
949variable @code{eval}. Such functions can then be used in your 948variable @code{eval}. Such functions can then be used in your
950formulas and printers, but usually each @code{eval} is presented to 949formulas and printers, but usually each @code{eval} is presented to
951the user during file loading as a potential virus --- this can get 950the user during file loading as a potential virus. This can get
952annoying. 951annoying.
953 952
954You can define functions in your @file{.emacs} file. Other people can 953You can define functions in your @file{.emacs} file. Other people can
@@ -959,7 +958,7 @@ avoid virus warnings, each function used in a formula needs
959(put 'your-function-name 'safe-function t) 958(put 'your-function-name 'safe-function t)
960@end lisp 959@end lisp
961 960
962@node Uses of defadvice in @acronym{SES}, , Buffer-local variables in spreadsheets, For Gurus 961@node Uses of defadvice in @acronym{SES}
963@section Uses of defadvice in @acronym{SES} 962@section Uses of defadvice in @acronym{SES}
964@cindex defadvice 963@cindex defadvice
965@cindex undo-more 964@cindex undo-more
@@ -986,15 +985,15 @@ cell.
986@end table 985@end table
987 986
988@c =================================================================== 987@c ===================================================================
989@node Index, Acknowledgments, For Gurus, Top 988@node Index
990@unnumbered Index 989@unnumbered Index
991 990
992@printindex cp 991@printindex cp
993 992
994@c =================================================================== 993@c ===================================================================
995 994
996@node Acknowledgments, GNU Free Documentation License, Index, Top 995@node Acknowledgments
997@chapter Acknowledgments 996@unnumbered Acknowledgments
998 997
999Coding by: 998Coding by:
1000@quotation 999@quotation
@@ -1035,7 +1034,7 @@ Jean-Philippe Theberge @email{jphil@@acs.pagesjaunes.fr}
1035 1034
1036@c =================================================================== 1035@c ===================================================================
1037 1036
1038@node GNU Free Documentation License, , Acknowledgments, Top 1037@node GNU Free Documentation License
1039@appendix GNU Free Documentation License 1038@appendix GNU Free Documentation License
1040@include doclicense.texi 1039@include doclicense.texi
1041 1040
diff --git a/doc/misc/sieve.texi b/doc/misc/sieve.texi
index d13f25c2a55..cbcd6a61f39 100644
--- a/doc/misc/sieve.texi
+++ b/doc/misc/sieve.texi
@@ -11,7 +11,7 @@
11@copying 11@copying
12This file documents the Emacs Sieve package, for server-side mail filtering. 12This file documents the Emacs Sieve package, for server-side mail filtering.
13 13
14Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 2001--2013 Free Software Foundation, Inc.
15 15
16@quotation 16@quotation
17Permission is granted to copy, distribute and/or modify this document 17Permission is granted to copy, distribute and/or modify this document
@@ -22,8 +22,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
22is included in the section entitled ``GNU Free Documentation License''. 22is included in the section entitled ``GNU Free Documentation License''.
23 23
24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 24(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25modify this GNU manual. Buying copies from the FSF supports it in 25modify this GNU manual.''
26developing GNU and promoting software freedom.''
27@end quotation 26@end quotation
28@end copying 27@end copying
29 28
@@ -213,7 +212,7 @@ Bury the Manage Sieve buffer without closing the connection.
213@kindex ? 212@kindex ?
214@kindex h 213@kindex h
215@findex sieve-help 214@findex sieve-help
216Displays help in the minibuffer. 215Displays help in the minibuffer.
217 216
218@end table 217@end table
219 218
diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi
index 67824afb898..dce90d06012 100644
--- a/doc/misc/smtpmail.texi
+++ b/doc/misc/smtpmail.texi
@@ -3,8 +3,7 @@
3@settitle Emacs SMTP Library 3@settitle Emacs SMTP Library
4@syncodeindex vr fn 4@syncodeindex vr fn
5@copying 5@copying
6Copyright @copyright{} 2003-2012 6Copyright @copyright{} 2003--2013 Free Software Foundation, Inc.
7Free Software Foundation, Inc.
8 7
9@quotation 8@quotation
10Permission is granted to copy, distribute and/or modify this document 9Permission is granted to copy, distribute and/or modify this document
@@ -15,8 +14,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
15is included in the section entitled ``GNU Free Documentation License''. 14is included in the section entitled ``GNU Free Documentation License''.
16 15
17(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 16(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
18modify this GNU manual. Buying copies from the FSF supports it in 17modify this GNU manual.''
19developing GNU and promoting software freedom.''
20@end quotation 18@end quotation
21@end copying 19@end copying
22 20
@@ -26,9 +24,9 @@ developing GNU and promoting software freedom.''
26@end direntry 24@end direntry
27 25
28@titlepage 26@titlepage
29@title{Emacs SMTP Library} 27@title Emacs SMTP Library
30@subtitle{An Emacs package for sending mail via SMTP} 28@subtitle An Emacs package for sending mail via SMTP
31@author{Simon Josefsson, Alex Schroeder} 29@author Simon Josefsson, Alex Schroeder
32@page 30@page
33@vskip 0pt plus 1filll 31@vskip 0pt plus 1filll
34@insertcopying 32@insertcopying
@@ -72,8 +70,8 @@ not necessarily involve SMTP, however. Here is short overview of what
72is involved. 70is involved.
73 71
74@cindex MUA 72@cindex MUA
75 The mail program --- also called a mail user agent (MUA) --- 73 The mail program---also called a mail user agent (MUA)---usually
76usually sends outgoing mail to a mail host. When your computer is 74sends outgoing mail to a mail host. When your computer is
77permanently connected to the internet, it might even be a mail host 75permanently connected to the internet, it might even be a mail host
78itself. In this case, the MUA will pipe mail to the 76itself. In this case, the MUA will pipe mail to the
79@file{/usr/lib/sendmail} application. It will take care of your mail 77@file{/usr/lib/sendmail} application. It will take care of your mail
@@ -285,8 +283,8 @@ The variable @code{smtpmail-stream-type} controls what form of
285connection the SMTP library uses. The default value is @code{nil}, 283connection the SMTP library uses. The default value is @code{nil},
286which means to use a plain connection, but try to switch to a STARTTLS 284which means to use a plain connection, but try to switch to a STARTTLS
287encrypted connection if the server supports it. Other possible values 285encrypted connection if the server supports it. Other possible values
288are: @code{starttls} - insist on STARTTLS; @code{ssl} - use TLS/SSL; 286are: @code{starttls} to insist on STARTTLS; @code{ssl} to use TLS/SSL;
289and @code{plain} - no encryption. 287and @code{plain} for encryption.
290 288
291Use of any form of TLS/SSL requires support in Emacs. You can either 289Use of any form of TLS/SSL requires support in Emacs. You can either
292use the built-in support (in Emacs 24.1 and later), or the 290use the built-in support (in Emacs 24.1 and later), or the
diff --git a/doc/misc/speedbar.texi b/doc/misc/speedbar.texi
index 6604dc5f0d0..c017490d4aa 100644
--- a/doc/misc/speedbar.texi
+++ b/doc/misc/speedbar.texi
@@ -4,7 +4,7 @@
4@syncodeindex fn cp 4@syncodeindex fn cp
5 5
6@copying 6@copying
7Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. 7Copyright @copyright{} 1999--2013 Free Software Foundation, Inc.
8 8
9@quotation 9@quotation
10Permission is granted to copy, distribute and/or modify this document 10Permission is granted to copy, distribute and/or modify this document
@@ -15,8 +15,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
15is included in the section entitled ``GNU Free Documentation License''. 15is included in the section entitled ``GNU Free Documentation License''.
16 16
17(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 17(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
18modify this GNU manual. Buying copies from the FSF supports it in 18modify this GNU manual.''
19developing GNU and promoting software freedom.''
20@end quotation 19@end quotation
21@end copying 20@end copying
22 21
@@ -38,8 +37,7 @@ developing GNU and promoting software freedom.''
38 37
39@contents 38@contents
40 39
41@node Top, , , (dir)Top 40@node Top
42@comment node-name, next, previous, up
43@top Speedbar 41@top Speedbar
44 42
45Speedbar is a program for Emacs which can be used to summarize 43Speedbar is a program for Emacs which can be used to summarize
@@ -69,7 +67,7 @@ an expanded summary of the entry the expansion button is
69on. @xref{Basic Navigation}. 67on. @xref{Basic Navigation}.
70 68
71@ifnottex 69@ifnottex
72@insertcopying 70@insertcopying
73@end ifnottex 71@end ifnottex
74 72
75@menu 73@menu
@@ -84,8 +82,7 @@ on. @xref{Basic Navigation}.
84* Index:: 82* Index::
85@end menu 83@end menu
86 84
87@node Introduction, Basic Navigation, , Top 85@node Introduction
88@comment node-name, next, previous, up
89@chapter Introduction 86@chapter Introduction
90@cindex introduction 87@cindex introduction
91 88
@@ -116,8 +113,7 @@ The function to use when switching between frames using the keyboard is
116@code{speedbar-get-focus}. This function will toggle between frames, and 113@code{speedbar-get-focus}. This function will toggle between frames, and
117it's useful to bind it to a key in terminal mode. @xref{Customizing}. 114it's useful to bind it to a key in terminal mode. @xref{Customizing}.
118 115
119@node Basic Navigation, File Mode, Introduction, Top 116@node Basic Navigation
120@comment node-name, next, previous, up
121@chapter Basic Navigation 117@chapter Basic Navigation
122 118
123Speedbar can display different types of data, and has several display 119Speedbar can display different types of data, and has several display
@@ -132,8 +128,7 @@ to use.
132* Displays Submenu:: 128* Displays Submenu::
133@end menu 129@end menu
134 130
135@node Basic Key Bindings, Basic Visuals, Basic Navigation, Basic Navigation 131@node Basic Key Bindings
136@comment node-name, next, previous, up
137@section Basic Key Bindings 132@section Basic Key Bindings
138@cindex key bindings 133@cindex key bindings
139 134
@@ -206,8 +201,7 @@ flushed. This is similar to a power click. @xref{Mouse Bindings}.
206Contract the current group, hiding sub items. 201Contract the current group, hiding sub items.
207@end table 202@end table
208 203
209@node Basic Visuals, Mouse Bindings, Basic Key Bindings, Basic Navigation 204@node Basic Visuals
210@comment node-name, next, previous, up
211@section Basic Visuals 205@section Basic Visuals
212@cindex visuals 206@cindex visuals
213 207
@@ -308,8 +302,7 @@ The face naming convention mirrors the File display mode. Modes which
308do not use files will attempt to use the same colors on analogous 302do not use files will attempt to use the same colors on analogous
309entries. 303entries.
310 304
311@node Mouse Bindings, Displays Submenu, Basic Visuals, Basic Navigation 305@node Mouse Bindings
312@comment node-name, next, previous, up
313@section Mouse Bindings 306@section Mouse Bindings
314@cindex mouse bindings 307@cindex mouse bindings
315 308
@@ -353,8 +346,7 @@ should be displayed in the minibuffer of the attached frame. Sometimes
353this can contain extra information such as file permissions, or tag 346this can contain extra information such as file permissions, or tag
354location. 347location.
355 348
356@node Displays Submenu, , Mouse Bindings, Basic Navigation 349@node Displays Submenu
357@comment node-name, next, previous, up
358@section Displays Submenu 350@section Displays Submenu
359@cindex displays submenu 351@cindex displays submenu
360 352
@@ -370,8 +362,7 @@ The contents are modes currently loaded into emacs. By default, this
370would include Files, Quick Buffers, and Buffers. Other major display 362would include Files, Quick Buffers, and Buffers. Other major display
371modes such as Info are loaded separately. 363modes such as Info are loaded separately.
372 364
373@node File Mode, Buffer Mode, Basic Navigation, Top 365@node File Mode
374@comment node-name, next, previous, up
375@chapter File Mode 366@chapter File Mode
376@cindex file mode 367@cindex file mode
377 368
@@ -388,8 +379,7 @@ Advanced behavior, like copying and renaming files, is also provided.
388* File Key Bindings:: Performing file operations. 379* File Key Bindings:: Performing file operations.
389@end menu 380@end menu
390 381
391@node Directory Display, Hidden Files, File Mode, File Mode 382@node Directory Display
392@comment node-name, next, previous, up
393@section Directory Display 383@section Directory Display
394@cindex directory display 384@cindex directory display
395 385
@@ -472,8 +462,7 @@ Some group names may say something like @samp{speedbar-t to speedbar-v},
472indicating that all symbols which alphabetically fall between those 462indicating that all symbols which alphabetically fall between those
473categories are included in that sub-group. @xref{Tag Hierarchy Methods}. 463categories are included in that sub-group. @xref{Tag Hierarchy Methods}.
474 464
475@node Hidden Files, File Key Bindings, Directory Display, File Mode 465@node Hidden Files
476@comment node-name, next, previous, up
477@section Hidden Files 466@section Hidden Files
478@cindex hidden files 467@cindex hidden files
479 468
@@ -499,8 +488,7 @@ Object files fall into the category of level 2 hidden files. You can
499determine their presence by the @samp{#} and @samp{!} file indicators. 488determine their presence by the @samp{#} and @samp{!} file indicators.
500@xref{Directory Display}. 489@xref{Directory Display}.
501 490
502@node File Key Bindings, , Hidden Files, File Mode 491@node File Key Bindings
503@comment node-name, next, previous, up
504@section File Key Bindings 492@section File Key Bindings
505@cindex file key bindings 493@cindex file key bindings
506 494
@@ -538,8 +526,7 @@ list, are shown. By showing all files, additional files such as text files are
538also displayed, but they are prefixed with the @samp{[?]} symbol. This 526also displayed, but they are prefixed with the @samp{[?]} symbol. This
539means that it is a file, but Emacs doesn't know how to expand it. 527means that it is a file, but Emacs doesn't know how to expand it.
540 528
541@node Buffer Mode, Minor Modes, File Mode, Top 529@node Buffer Mode
542@comment node-name, next, previous, up
543@chapter Buffer Mode 530@chapter Buffer Mode
544@cindex buffer mode 531@cindex buffer mode
545 532
@@ -570,8 +557,7 @@ Thus, if you are in File mode, and you need quick access to a buffer,
570press @kbd{b}, click on the buffer you want, and speedbar will revert 557press @kbd{b}, click on the buffer you want, and speedbar will revert
571back to File mode. 558back to File mode.
572 559
573@node Minor Modes, Customizing, Buffer Mode, Top 560@node Minor Modes
574@comment node-name, next, previous, up
575@chapter Minor Display Modes 561@chapter Minor Display Modes
576@cindex minor display modes 562@cindex minor display modes
577 563
@@ -593,8 +579,7 @@ key bindings and visuals, but will have specialized behaviors.
593 stack trace. 579 stack trace.
594@end menu 580@end menu
595 581
596@node RMAIL, Info, Minor Modes, Minor Modes 582@node RMAIL
597@comment node-name, next, previous, up
598@section RMAIL 583@section RMAIL
599@cindex RMAIL 584@cindex RMAIL
600 585
@@ -615,8 +600,7 @@ the current RMAIL folder into a different folder by clicking the
615In this way you can manage your existing RMAIL folders fairly easily 600In this way you can manage your existing RMAIL folders fairly easily
616using the mouse. 601using the mouse.
617 602
618@node Info, GDB, RMAIL, Minor Modes 603@node Info
619@comment node-name, next, previous, up
620@section Info 604@section Info
621@cindex Info 605@cindex Info
622 606
@@ -630,8 +614,7 @@ are available. Since these sub-topics are not examined until you click
630the @samp{[+]} button, sometimes a @samp{[?]} will appear when you click on 614the @samp{[+]} button, sometimes a @samp{[?]} will appear when you click on
631a @samp{[+]}, indicating that there are no sub-topics. 615a @samp{[+]}, indicating that there are no sub-topics.
632 616
633@node GDB, , Info, Minor Modes 617@node GDB
634@comment node-name, next, previous, up
635@section GDB 618@section GDB
636@cindex gdb 619@cindex gdb
637@cindex gud 620@cindex gud
@@ -653,8 +636,7 @@ You can click on any stack element and gdb will move to that stack
653level. You can then check variables local to that level at the GDB 636level. You can then check variables local to that level at the GDB
654prompt. 637prompt.
655 638
656@node Customizing, Extending, Minor Modes, Top 639@node Customizing
657@comment node-name, next, previous, up
658@chapter Customizing 640@chapter Customizing
659@cindex customizing 641@cindex customizing
660 642
@@ -681,8 +663,7 @@ Customize speedbar's many colors and fonts.
681* Hooks:: The many hooks you can use. 663* Hooks:: The many hooks you can use.
682@end menu 664@end menu
683 665
684@node Frames and Faces, Tag Hierarchy Methods, Customizing, Customizing 666@node Frames and Faces
685@comment node-name, next, previous, up
686@section Frames and Faces 667@section Frames and Faces
687@cindex faces 668@cindex faces
688@cindex frame parameters 669@cindex frame parameters
@@ -726,8 +707,7 @@ it.
726In XEmacs, change the plist @code{speedbar-frame-plist}. This is the 707In XEmacs, change the plist @code{speedbar-frame-plist}. This is the
727XEmacs way of doing the same thing. 708XEmacs way of doing the same thing.
728 709
729@node Tag Hierarchy Methods, Version Control, Frames and Faces, Customizing 710@node Tag Hierarchy Methods
730@comment node-name, next, previous, up
731@section Tag Hierarchy Methods 711@section Tag Hierarchy Methods
732@cindex tag hierarchy 712@cindex tag hierarchy
733@cindex tag groups 713@cindex tag groups
@@ -806,8 +786,7 @@ are next to each other, then they are combined until this number of
806items is reached. 786items is reached.
807@end table 787@end table
808 788
809@node Version Control, Hooks, Tag Hierarchy Methods, Customizing 789@node Version Control
810@comment node-name, next, previous, up
811@section Version Control 790@section Version Control
812@cindex version control 791@cindex version control
813@cindex vc extensions 792@cindex vc extensions
@@ -841,8 +820,7 @@ placed near this file.
841Lastly, you can change the VC indicator using the variable 820Lastly, you can change the VC indicator using the variable
842@code{speedbar-vc-indicator}, and specify a single character string. 821@code{speedbar-vc-indicator}, and specify a single character string.
843 822
844@node Hooks, , Version Control, Customizing 823@node Hooks
845@comment node-name, next, previous, up
846@section Hooks 824@section Hooks
847@cindex hooks 825@cindex hooks
848 826
@@ -884,8 +862,7 @@ Set this to implement your own scanning or rescan safe functions with
884state data. 862state data.
885@end table 863@end table
886 864
887@node Extending, GNU Free Documentation License, Customizing, Top 865@node Extending
888@comment node-name, next, previous, up
889@chapter Extending 866@chapter Extending
890@cindex extending 867@cindex extending
891 868
@@ -909,7 +886,7 @@ create specialized tagging functions.
909* Creating a display:: How to insert buttons and hierarchies. 886* Creating a display:: How to insert buttons and hierarchies.
910@end menu 887@end menu
911 888
912@node Minor Display Modes, Major Display Modes, Extending, Extending 889@node Minor Display Modes
913@section Minor Display Modes 890@section Minor Display Modes
914@cindex create minor display mode 891@cindex create minor display mode
915 892
@@ -967,7 +944,7 @@ want to do is execute a check to see if you need to re-create your
967display. If it needs to be cleared, you need to erase the speedbar 944display. If it needs to be cleared, you need to erase the speedbar
968buffer yourself, and start drawing buttons. @xref{Creating a display}. 945buffer yourself, and start drawing buttons. @xref{Creating a display}.
969 946
970@node Major Display Modes, Tagging Extensions, Minor Display Modes, Extending 947@node Major Display Modes
971@section Major Display Modes 948@section Major Display Modes
972@cindex create major display mode 949@cindex create major display mode
973 950
@@ -1098,7 +1075,7 @@ Your custom function might look like this:
1098Once you have done all this, speedbar will show an entry in the 1075Once you have done all this, speedbar will show an entry in the
1099@samp{Displays} menu declaring that your extension is available. 1076@samp{Displays} menu declaring that your extension is available.
1100 1077
1101@node Tagging Extensions, Creating a display, Major Display Modes, Extending 1078@node Tagging Extensions
1102@section Tagging Extensions 1079@section Tagging Extensions
1103 1080
1104It is possible to create new methods for tagging files in speedbar. 1081It is possible to create new methods for tagging files in speedbar.
@@ -1138,7 +1115,7 @@ If your parser is only good for a few types of files, make sure that it
1138is either a buffer local modification, or that the tag generator returns 1115is either a buffer local modification, or that the tag generator returns
1139@code{t} for non valid buffers. 1116@code{t} for non valid buffers.
1140 1117
1141@node Creating a display, , Tagging Extensions, Extending 1118@node Creating a display
1142@section Creating a display 1119@section Creating a display
1143@cindex creating a display 1120@cindex creating a display
1144 1121
@@ -1240,13 +1217,12 @@ Two good values are @code{nil} and @code{statictag}.
1240 1217
1241@end defun 1218@end defun
1242 1219
1243@node GNU Free Documentation License, Index, Extending, Top 1220@node GNU Free Documentation License
1244@appendix GNU Free Documentation License 1221@appendix GNU Free Documentation License
1245@include doclicense.texi 1222@include doclicense.texi
1246 1223
1247 1224
1248@node Index, , GNU Free Documentation License, Top 1225@node Index
1249@comment node-name, next, previous, up
1250@unnumbered Concept Index 1226@unnumbered Concept Index
1251@printindex cp 1227@printindex cp
1252 1228
diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi
index a6e4d73cc69..d76f9e09184 100644
--- a/doc/misc/srecode.texi
+++ b/doc/misc/srecode.texi
@@ -15,7 +15,7 @@
15@c %**end of header 15@c %**end of header
16 16
17@copying 17@copying
18Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. 18Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
19 19
20@quotation 20@quotation
21Permission is granted to copy, distribute and/or modify this document 21Permission is granted to copy, distribute and/or modify this document
@@ -26,8 +26,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
26is included in the section entitled ``GNU Free Documentation License''. 26is included in the section entitled ``GNU Free Documentation License''.
27 27
28(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 28(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
29modify this GNU manual. Buying copies from the FSF supports it in 29modify this GNU manual.''
30developing GNU and promoting software freedom.''
31@end quotation 30@end quotation
32@end copying 31@end copying
33 32
@@ -464,7 +463,7 @@ show NAME
464This will enable that section. 463This will enable that section.
465 464
466 465
467NOTE: May 11, 2008 - I haven't used this yet, so I don't know if it works. 466NOTE: May 11, 2008: I haven't used this yet, so I don't know if it works.
468 467
469 468
470@node Special Variables 469@node Special Variables
@@ -576,10 +575,10 @@ macros which will enable different @var{sections}. The automatic
576section variables are. 575section variables are.
577 576
578@itemize @bullet 577@itemize @bullet
579@item @var{first} - The first entry in the table. 578@item @var{first}---The first entry in the table.
580@item @var{notfirst} - Not the first entry in the table. 579@item @var{notfirst}---Not the first entry in the table.
581@item @var{last} - The last entry in the table 580@item @var{last}---The last entry in the table
582@item @var{notlast} - Not the last entry in the table. 581@item @var{notlast}---Not the last entry in the table.
583@end itemize 582@end itemize
584 583
585@node Compound Variable Values 584@node Compound Variable Values
@@ -1656,7 +1655,7 @@ This would be a field of the class being inserted into.
1656 1655
1657Inside a body of code, such as a function or method body. 1656Inside a body of code, such as a function or method body.
1658 1657
1659 - no conventions yet. 1658 ---no conventions yet.
1660 1659
1661@section Standard Dictionary Values 1660@section Standard Dictionary Values
1662 1661
@@ -1780,7 +1779,7 @@ all template files for that application will be loaded.
1780@end defun 1779@end defun
1781 1780
1782 1781
1783 todo - Add examples. Most core stuff is already described above. 1782 todo: Add examples. Most core stuff is already described above.
1784 1783
1785 1784
1786@node GNU Free Documentation License 1785@node GNU Free Documentation License
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex
index b5f31415771..d64f45bbee9 100644
--- a/doc/misc/texinfo.tex
+++ b/doc/misc/texinfo.tex
@@ -3,11 +3,11 @@
3% Load plain if necessary, i.e., if running under initex. 3% Load plain if necessary, i.e., if running under initex.
4\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi 4\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
5% 5%
6\def\texinfoversion{2012-11-08.11} 6\def\texinfoversion{2013-01-01.15}
7% 7%
8% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, 8% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
9% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 9% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
10% 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. 10% 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
11% 11%
12% This texinfo.tex file is free software: you can redistribute it and/or 12% This texinfo.tex file is free software: you can redistribute it and/or
13% modify it under the terms of the GNU General Public License as 13% modify it under the terms of the GNU General Public License as
@@ -24,7 +24,8 @@
24% 24%
25% As a special exception, when this file is read by TeX when processing 25% As a special exception, when this file is read by TeX when processing
26% a Texinfo source document, you may use the result without 26% a Texinfo source document, you may use the result without
27% restriction. (This has been our intent since Texinfo was invented.) 27% restriction. This Exception is an additional permission under section 7
28% of the GNU General Public License, version 3 ("GPLv3").
28% 29%
29% Please try the latest version of texinfo.tex before submitting bug 30% Please try the latest version of texinfo.tex before submitting bug
30% reports; you can get the latest version from: 31% reports; you can get the latest version from:
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 317d440c0d1..a683425868a 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -37,7 +37,7 @@
37@end macro 37@end macro
38 38
39@copying 39@copying
40Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. 40Copyright @copyright{} 1999--2013 Free Software Foundation, Inc.
41 41
42@quotation 42@quotation
43Permission is granted to copy, distribute and/or modify this document 43Permission is granted to copy, distribute and/or modify this document
@@ -48,8 +48,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
48is included in the section entitled ``GNU Free Documentation License''. 48is included in the section entitled ``GNU Free Documentation License''.
49 49
50(a) The FSF's Back-Cover Text is: ``You have the freedom to 50(a) The FSF's Back-Cover Text is: ``You have the freedom to
51copy and modify this GNU manual. Buying copies from the FSF 51copy and modify this GNU manual.''
52supports it in developing GNU and promoting software freedom.''
53@end quotation 52@end quotation
54@end copying 53@end copying
55 54
@@ -375,7 +374,7 @@ This release includes the full documentation and code for
375@value{tramp}, suitable for installation. But Emacs (22 or later) 374@value{tramp}, suitable for installation. But Emacs (22 or later)
376includes @value{tramp} already, and there is a @value{tramp} package 375includes @value{tramp} already, and there is a @value{tramp} package
377for XEmacs, as well. So maybe it is easier to just use those. But if 376for XEmacs, as well. So maybe it is easier to just use those. But if
378you want the bleeding edge, read on@dots{...} 377you want the bleeding edge, read on@dots{}
379 378
380For the especially brave, @value{tramp} is available from Git. The Git 379For the especially brave, @value{tramp} is available from Git. The Git
381version is the latest version of the code and may contain incomplete 380version is the latest version of the code and may contain incomplete
@@ -516,8 +515,8 @@ Method}.
516* Connection caching:: Reusing connection related information. 515* Connection caching:: Reusing connection related information.
517* Remote Programs:: How @value{tramp} finds and uses programs on the remote machine. 516* Remote Programs:: How @value{tramp} finds and uses programs on the remote machine.
518* Remote shell setup:: Remote shell setup hints. 517* Remote shell setup:: Remote shell setup hints.
519* Windows setup hints:: Issues with Cygwin ssh.
520* Auto-save and Backup:: Auto-save and Backup. 518* Auto-save and Backup:: Auto-save and Backup.
519* Windows setup hints:: Issues with Cygwin ssh.
521@end menu 520@end menu
522 521
523 522
@@ -763,7 +762,7 @@ transferred with the corresponding inline method. It should provide a
763fair trade-off between both approaches. 762fair trade-off between both approaches.
764 763
765@table @asis 764@table @asis
766@item @option{rcp} --- @command{rsh} and @command{rcp} 765@item @option{rcp}---@command{rsh} and @command{rcp}
767@cindex method rcp 766@cindex method rcp
768@cindex rcp method 767@cindex rcp method
769@cindex rcp (with rcp method) 768@cindex rcp (with rcp method)
@@ -778,7 +777,7 @@ The alternative method @option{remcp} uses the @command{remsh} and
778@command{remsh} is used instead of @command{rsh}. 777@command{remsh} is used instead of @command{rsh}.
779 778
780 779
781@item @option{scp} --- @command{ssh} and @command{scp} 780@item @option{scp}---@command{ssh} and @command{scp}
782@cindex method scp 781@cindex method scp
783@cindex scp method 782@cindex scp method
784@cindex scp (with scp method) 783@cindex scp (with scp method)
@@ -808,7 +807,7 @@ specify @samp{-p 42} in the argument list for @command{ssh}, and to
808specify @samp{-P 42} in the argument list for @command{scp}. 807specify @samp{-P 42} in the argument list for @command{scp}.
809 808
810 809
811@item @option{sftp} --- @command{ssh} and @command{sftp} 810@item @option{sftp}---@command{ssh} and @command{sftp}
812@cindex method sftp 811@cindex method sftp
813@cindex sftp method 812@cindex sftp method
814@cindex sftp (with sftp method) 813@cindex sftp (with sftp method)
@@ -824,7 +823,7 @@ within this session. Instead of, @command{ssh} is used for login.
824This method supports the @samp{-p} argument. 823This method supports the @samp{-p} argument.
825 824
826 825
827@item @option{rsync} --- @command{ssh} and @command{rsync} 826@item @option{rsync}---@command{ssh} and @command{rsync}
828@cindex method rsync 827@cindex method rsync
829@cindex rsync method 828@cindex rsync method
830@cindex rsync (with rsync method) 829@cindex rsync (with rsync method)
@@ -845,7 +844,7 @@ the corresponding buffer, visiting this file, is alive.
845This method supports the @samp{-p} argument. 844This method supports the @samp{-p} argument.
846 845
847 846
848@item @option{scpx} --- @command{ssh} and @command{scp} 847@item @option{scpx}---@command{ssh} and @command{scp}
849@cindex method scpx 848@cindex method scpx
850@cindex scpx method 849@cindex scpx method
851@cindex scp (with scpx method) 850@cindex scp (with scpx method)
@@ -868,7 +867,7 @@ to not print any shell prompt, which confuses @value{tramp} mightily.
868This method supports the @samp{-p} argument. 867This method supports the @samp{-p} argument.
869 868
870 869
871@item @option{scpc} --- @command{ssh} and @command{scp} 870@item @option{scpc}---@command{ssh} and @command{scp}
872@cindex method scpc 871@cindex method scpc
873@cindex scpc method 872@cindex scpc method
874@cindex scp (with scpc method) 873@cindex scp (with scpc method)
@@ -899,7 +898,7 @@ version, must be set to @option{no}.
899This method supports the @samp{-p} argument. 898This method supports the @samp{-p} argument.
900 899
901 900
902@item @option{rsyncc} --- @command{ssh} and @command{rsync} 901@item @option{rsyncc}---@command{ssh} and @command{rsync}
903@cindex method rsyncc 902@cindex method rsyncc
904@cindex rsyncc method 903@cindex rsyncc method
905@cindex rsync (with rsyncc method) 904@cindex rsync (with rsyncc method)
@@ -913,7 +912,7 @@ which increases performance.
913This method supports the @samp{-p} argument. 912This method supports the @samp{-p} argument.
914 913
915 914
916@item @option{pscp} --- @command{plink} and @command{pscp} 915@item @option{pscp}---@command{plink} and @command{pscp}
917@cindex method pscp 916@cindex method pscp
918@cindex pscp method 917@cindex pscp method
919@cindex pscp (with pscp method) 918@cindex pscp (with pscp method)
@@ -928,7 +927,7 @@ of PuTTY, an SSH implementation for Windows.
928This method supports the @samp{-P} argument. 927This method supports the @samp{-P} argument.
929 928
930 929
931@item @option{psftp} --- @command{plink} and @command{psftp} 930@item @option{psftp}---@command{plink} and @command{psftp}
932@cindex method psftp 931@cindex method psftp
933@cindex psftp method 932@cindex psftp method
934@cindex psftp (with psftp method) 933@cindex psftp (with psftp method)
@@ -943,7 +942,7 @@ part of PuTTY, an SSH implementation for Windows.
943This method supports the @samp{-P} argument. 942This method supports the @samp{-P} argument.
944 943
945 944
946@item @option{fcp} --- @command{fsh} and @command{fcp} 945@item @option{fcp}---@command{fsh} and @command{fcp}
947@cindex method fcp 946@cindex method fcp
948@cindex fcp method 947@cindex fcp method
949@cindex fsh (with fcp method) 948@cindex fsh (with fcp method)
@@ -982,7 +981,7 @@ This works only for unified filenames, see @ref{Issues}.
982@end ifset 981@end ifset
983 982
984 983
985@item @option{smb} --- @command{smbclient} 984@item @option{smb}---@command{smbclient}
986@cindex method smb 985@cindex method smb
987@cindex smb method 986@cindex smb method
988 987
@@ -1866,7 +1865,7 @@ but it is not at the end of the buffer.
1866This regular expression is used by @value{tramp} in the same way as 1865This regular expression is used by @value{tramp} in the same way as
1867@code{shell-prompt-pattern}, to match prompts from the remote shell. 1866@code{shell-prompt-pattern}, to match prompts from the remote shell.
1868This second variable exists because the prompt from the remote shell 1867This second variable exists because the prompt from the remote shell
1869might be different from the prompt from a local shell --- after all, 1868might be different from the prompt from a local shell---after all,
1870the whole point of @value{tramp} is to log in to remote hosts as a 1869the whole point of @value{tramp} is to log in to remote hosts as a
1871different user. The default value of 1870different user. The default value of
1872@code{tramp-shell-prompt-pattern} is the same as the default value of 1871@code{tramp-shell-prompt-pattern} is the same as the default value of
@@ -1900,7 +1899,7 @@ of your (local or remote) host, you might need to adapt this. Example:
1900 "passwort" "Passwort" 1899 "passwort" "Passwort"
1901 ;; Fran@,{c}ais 1900 ;; Fran@,{c}ais
1902 "mot de passe" "Mot de passe") t) 1901 "mot de passe" "Mot de passe") t)
1903 ".*: 1902 ".*:\0? *"))
1904@end lisp 1903@end lisp
1905 1904
1906In parallel, it might also be necessary to adapt 1905In parallel, it might also be necessary to adapt
@@ -2292,7 +2291,7 @@ This edits the same file, using the fully qualified domain name of
2292the machine. 2291the machine.
2293 2292
2294@item @trampfn{, , melancholia, ~/.emacs} 2293@item @trampfn{, , melancholia, ~/.emacs}
2295This also edits the same file --- the @file{~} is expanded to your 2294This also edits the same file; the @file{~} is expanded to your
2296home directory on the remote machine, just like it is locally. 2295home directory on the remote machine, just like it is locally.
2297 2296
2298@item @trampfn{, , melancholia, ~daniel/.emacs} 2297@item @trampfn{, , melancholia, ~daniel/.emacs}
@@ -2381,13 +2380,13 @@ For the time being, @code{tramp-syntax} can have the following values:
2381 2380
2382@itemize @w{} 2381@itemize @w{}
2383@ifset emacs 2382@ifset emacs
2384@item @code{ftp} -- That is the default syntax 2383@item @code{ftp}---That is the default syntax
2385@item @code{url} -- URL-like syntax 2384@item @code{url}---URL-like syntax
2386@end ifset 2385@end ifset
2387@ifset xemacs 2386@ifset xemacs
2388@item @code{sep} -- That is the default syntax 2387@item @code{sep}---That is the default syntax
2389@item @code{url} -- URL-like syntax 2388@item @code{url}---URL-like syntax
2390@item @code{ftp} -- EFS-like syntax 2389@item @code{ftp}---EFS-like syntax
2391@end ifset 2390@end ifset
2392@end itemize 2391@end itemize
2393 2392
diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi
index 96043a07300..6d5a8cb1c44 100644
--- a/doc/misc/trampver.texi
+++ b/doc/misc/trampver.texi
@@ -2,7 +2,7 @@
2@c texi/trampver.texi. Generated from trampver.texi.in by configure. 2@c texi/trampver.texi. Generated from trampver.texi.in by configure.
3 3
4@c This is part of the Emacs manual. 4@c This is part of the Emacs manual.
5@c Copyright (C) 2003-2012 Free Software Foundation, Inc. 5@c Copyright (C) 2003-2013 Free Software Foundation, Inc.
6@c See file doclicense.texi for copying conditions. 6@c See file doclicense.texi for copying conditions.
7 7
8@c In the Tramp CVS, the version number is auto-frobbed from 8@c In the Tramp CVS, the version number is auto-frobbed from
diff --git a/doc/misc/url.texi b/doc/misc/url.texi
index f42007348ee..9e9dbc0a77d 100644
--- a/doc/misc/url.texi
+++ b/doc/misc/url.texi
@@ -20,7 +20,8 @@
20@copying 20@copying
21This is the manual for the @code{url} Emacs Lisp library. 21This is the manual for the @code{url} Emacs Lisp library.
22 22
23Copyright @copyright{} 1993-1999, 2002, 2004-2012 Free Software Foundation, Inc. 23Copyright @copyright{} 1993--1999, 2002, 2004--2013 Free Software
24Foundation, Inc.
24 25
25@quotation 26@quotation
26Permission is granted to copy, distribute and/or modify this document 27Permission is granted to copy, distribute and/or modify this document
@@ -31,8 +32,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
31is included in the section entitled ``GNU Free Documentation License''. 32is included in the section entitled ``GNU Free Documentation License''.
32 33
33(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 34(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
34modify this GNU manual. Buying copies from the FSF supports it in 35modify this GNU manual.''
35developing GNU and promoting software freedom.''
36@end quotation 36@end quotation
37@end copying 37@end copying
38 38
diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi
index 4e85da70ca2..01048d43dbf 100644
--- a/doc/misc/vip.texi
+++ b/doc/misc/vip.texi
@@ -3,7 +3,7 @@
3@settitle VIP 3@settitle VIP
4 4
5@copying 5@copying
6Copyright @copyright{} 1987, 2001-2012 Free Software Foundation, Inc. 6Copyright @copyright{} 1987, 2001--2013 Free Software Foundation, Inc.
7 7
8@quotation 8@quotation
9Permission is granted to copy, distribute and/or modify this document 9Permission is granted to copy, distribute and/or modify this document
@@ -14,8 +14,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
14is included in the section entitled ``GNU Free Documentation License''. 14is included in the section entitled ``GNU Free Documentation License''.
15 15
16(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 16(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
17modify this GNU manual. Buying copies from the FSF supports it in 17modify this GNU manual.''
18developing GNU and promoting software freedom.''
19@end quotation 18@end quotation
20@end copying 19@end copying
21 20
@@ -41,7 +40,7 @@ developing GNU and promoting software freedom.''
41@end direntry 40@end direntry
42 41
43@ifnottex 42@ifnottex
44@node Top, Survey,, (DIR) 43@node Top
45@top VIP 44@top VIP
46 45
47VIP is a Vi emulating package written in Emacs Lisp. VIP implements most 46VIP is a Vi emulating package written in Emacs Lisp. VIP implements most
@@ -91,7 +90,7 @@ Comments and bug reports are welcome. Please send messages to
91@code{masahiko@@unsun.riec.tohoku.junet} if you are in Japan. 90@code{masahiko@@unsun.riec.tohoku.junet} if you are in Japan.
92@end iftex 91@end iftex
93 92
94@node Survey, Basic Concepts, Top, Top 93@node Survey
95@chapter A Survey of VIP 94@chapter A Survey of VIP
96 95
97In this chapter we describe basics of VIP with emphasis on the features not 96In this chapter we describe basics of VIP with emphasis on the features not
@@ -105,7 +104,7 @@ found in Vi and on how to use VIP under GNU Emacs.
105* Differences from Vi:: Differences of VIP from Vi is explained. 104* Differences from Vi:: Differences of VIP from Vi is explained.
106@end menu 105@end menu
107 106
108@node Basic Concepts, Loading VIP, Survey, Survey 107@node Basic Concepts
109@section Basic Concepts 108@section Basic Concepts
110 109
111We begin by explaining some basic concepts of Emacs. These concepts are 110We begin by explaining some basic concepts of Emacs. These concepts are
@@ -152,7 +151,7 @@ be executed when you type the key. If no function is bound to a key in the
152local map, however, the function bound to the key in the global map becomes 151local map, however, the function bound to the key in the global map becomes
153in effect.@refill 152in effect.@refill
154 153
155@node Loading VIP, Modes in VIP, Basic Concepts, Survey 154@node Loading VIP
156@section Loading VIP 155@section Loading VIP
157 156
158The recommended way to load VIP automatically is to include the line: 157The recommended way to load VIP automatically is to include the line:
@@ -178,7 +177,7 @@ M-x vip-mode
178@end example 177@end example
179@noindent 178@noindent
180 179
181@node Modes in VIP, Emacs Mode, Loading VIP, Survey 180@node Modes in VIP
182@section Modes in VIP 181@section Modes in VIP
183 182
184@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) 183@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi})
@@ -258,7 +257,7 @@ emacs mode vi mode insert mode
258 know enough Emacs commands. 257 know enough Emacs commands.
259@end menu 258@end menu
260 259
261@node Emacs Mode, Vi Mode, Modes in VIP, Modes in VIP 260@node Emacs Mode
262@subsection Emacs Mode 261@subsection Emacs Mode
263 262
264@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) 263@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi})
@@ -268,14 +267,14 @@ normal Emacs editing in this mode. Note that the key @kbd{C-z} is globally
268bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode 267bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode
269then you will be in vi mode.@refill 268then you will be in vi mode.@refill
270 269
271@node Vi Mode, Insert Mode, Emacs Mode, Modes in VIP 270@node Vi Mode
272@subsection Vi Mode 271@subsection Vi Mode
273 272
274This mode corresponds to Vi's command mode. Most Vi commands work as they 273This mode corresponds to Vi's command mode. Most Vi commands work as they
275do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can 274do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can
276enter insert mode, just as in Vi, by typing @kbd{i}, @kbd{a} etc. 275enter insert mode, just as in Vi, by typing @kbd{i}, @kbd{a} etc.
277 276
278@node Insert Mode, Differences from Vi, Vi Mode, Modes in VIP 277@node Insert Mode
279@subsection Insert Mode 278@subsection Insert Mode
280 279
281The key bindings in this mode is the same as in the emacs mode except for 280The key bindings in this mode is the same as in the emacs mode except for
@@ -299,7 +298,7 @@ Thus typing @kbd{C-z x} in insert mode will have the same effect as typing
299@kbd{ESC x} in emacs mode. 298@kbd{ESC x} in emacs mode.
300@end table 299@end table
301 300
302@node Differences from Vi, Undoing, Insert Mode, Survey 301@node Differences from Vi
303@section Differences from Vi 302@section Differences from Vi
304 303
305The major differences from Vi are explained below. 304The major differences from Vi are explained below.
@@ -324,7 +323,7 @@ The major differences from Vi are explained below.
324* Misc Commands:: Other useful commands. 323* Misc Commands:: Other useful commands.
325@end menu 324@end menu
326 325
327@node Undoing, Changing, Differences from Vi, Differences from Vi 326@node Undoing
328@subsection Undoing 327@subsection Undoing
329 328
330@kindex 165 @kbd{u} (@code{vip-undo}) 329@kindex 165 @kbd{u} (@code{vip-undo})
@@ -335,7 +334,7 @@ a single change, while @kbd{u .@: .@: .@:}, for instance, will undo 4 previous
335changes. Undo is undoable as in Vi. So the content of the buffer will 334changes. Undo is undoable as in Vi. So the content of the buffer will
336be the same before and after @kbd{u u}.@refill 335be the same before and after @kbd{u u}.@refill
337 336
338@node Changing, Searching, Undoing, Differences from Vi 337@node Changing
339@subsection Changing 338@subsection Changing
340 339
341Some commands which change a small number of characters are executed 340Some commands which change a small number of characters are executed
@@ -348,7 +347,7 @@ then VIP will prompt you for a new word in the minibuffer by the prompt
348@kindex 007 @kbd{C-g} (@code{vip-keyboard-quit}) 347@kindex 007 @kbd{C-g} (@code{vip-keyboard-quit})
349you can abort a partially formed command by typing @kbd{C-g}.@refill 348you can abort a partially formed command by typing @kbd{C-g}.@refill
350 349
351@node Searching, z Command, Changing, Differences from Vi 350@node Searching
352@subsection Searching 351@subsection Searching
353 352
354@kindex 057 @kbd{/} (@code{vip-search-forward}) 353@kindex 057 @kbd{/} (@code{vip-search-forward})
@@ -364,7 +363,7 @@ search string. (It is a limitation.) By default, search will wrap around
364the buffer as in Vi. You can change this by rebinding the variable 363the buffer as in Vi. You can change this by rebinding the variable
365@code{vip-search-wrap-around}. @xref{Customization}, for how to do this.@refill 364@code{vip-search-wrap-around}. @xref{Customization}, for how to do this.@refill
366 365
367@node z Command, Counts, Searching, Differences from Vi 366@node z Command
368@subsection z Command 367@subsection z Command
369 368
370@kindex 1723 @kbd{z H} (@code{vip-line-to-top}) 369@kindex 1723 @kbd{z H} (@code{vip-line-to-top})
@@ -379,7 +378,7 @@ For those of you who cannot remember which of @kbd{z} followed by @key{RET},
379@kbd{M} and @kbd{L} to place the current line in the Home (Middle, and 378@kbd{M} and @kbd{L} to place the current line in the Home (Middle, and
380Last) line of the window.@refill 379Last) line of the window.@refill
381 380
382@node Counts, Marking, z Command, Differences from Vi 381@node Counts
383@subsection Counts 382@subsection Counts
384 383
385Some Vi commands which do not accept a count now accept one 384Some Vi commands which do not accept a count now accept one
@@ -405,7 +404,7 @@ line.
405Given a count @var{n}, @var{n}-th occurrence will be searched. 404Given a count @var{n}, @var{n}-th occurrence will be searched.
406@end table 405@end table
407 406
408@node Marking, Region Commands, Counts, Differences from Vi 407@node Marking
409@subsection Marking 408@subsection Marking
410 409
411Typing an @kbd{m} followed by a lower-case character @var{ch} marks the 410Typing an @kbd{m} followed by a lower-case character @var{ch} marks the
@@ -425,7 +424,7 @@ Set mark at point (and push old mark on mark ring).
425Jump to mark (and pop mark off the mark ring). 424Jump to mark (and pop mark off the mark ring).
426@end table 425@end table
427 426
428@node Region Commands, New Commands, Marking, Differences from Vi 427@node Region Commands
429@subsection Region Commands 428@subsection Region Commands
430 429
431@cindex region 430@cindex region
@@ -439,7 +438,7 @@ of @kbd{r} the region will first be enlarged so that it will become the
439smallest region containing the original region and consisting of whole 438smallest region containing the original region and consisting of whole
440lines. Thus @kbd{m .@: d R} will have the same effect as @kbd{d d}.@refill 439lines. Thus @kbd{m .@: d R} will have the same effect as @kbd{d d}.@refill
441 440
442@node New Commands, New Bindings, Region Commands, Differences from Vi 441@node New Commands
443@subsection Some New Commands 442@subsection Some New Commands
444 443
445Note that the keys below (except for @kbd{R}) are not used in Vi. 444Note that the keys below (except for @kbd{R}) are not used in Vi.
@@ -531,7 +530,7 @@ Check spelling of words in the region (@code{spell-region}).
531Call last keyboard macro. 530Call last keyboard macro.
532@end table 531@end table
533 532
534@node New Bindings, Window Commands, New Commands, Differences from Vi 533@node New Bindings
535@subsection New Key Bindings 534@subsection New Key Bindings
536 535
537In VIP the meanings of some keys are entirely different from Vi. These key 536In VIP the meanings of some keys are entirely different from Vi. These key
@@ -591,7 +590,7 @@ In addition to these, @code{ctl-x-map} is slightly modified:
591This is equivalent to @kbd{C-x 1 C-x 2} (1 + 2 = 3). 590This is equivalent to @kbd{C-x 1 C-x 2} (1 + 2 = 3).
592@end table 591@end table
593 592
594@node Window Commands, Buffer Commands, New Bindings, Differences from Vi 593@node Window Commands
595@subsection Window Commands 594@subsection Window Commands
596 595
597In this and following subsections, we give a summary of key bindings for 596In this and following subsections, we give a summary of key bindings for
@@ -615,7 +614,7 @@ Split current window into two windows.
615Show current buffer in two windows. 614Show current buffer in two windows.
616@end table 615@end table
617 616
618@node Buffer Commands, File Commands, Window Commands, Differences from Vi 617@node Buffer Commands
619@subsection Buffer Commands 618@subsection Buffer Commands
620 619
621@table @kbd 620@table @kbd
@@ -636,7 +635,7 @@ Kill the current buffer if it is not modified.
636Save the current buffer in the file associated to the buffer. 635Save the current buffer in the file associated to the buffer.
637@end table 636@end table
638 637
639@node File Commands, Misc Commands, Buffer Commands, Differences from Vi 638@node File Commands
640@subsection File Commands 639@subsection File Commands
641 640
642@table @kbd 641@table @kbd
@@ -657,7 +656,7 @@ Write current buffer into the specified file.
657Insert specified file at point. 656Insert specified file at point.
658@end table 657@end table
659 658
660@node Misc Commands, Vi Commands, File Commands, Differences from Vi 659@node Misc Commands
661@subsection Miscellaneous Commands 660@subsection Miscellaneous Commands
662 661
663@table @kbd 662@table @kbd
@@ -678,13 +677,13 @@ Call last remembered keyboard macro.
678Suspend Emacs. 677Suspend Emacs.
679@item Z Z 678@item Z Z
680Exit Emacs. 679Exit Emacs.
681@itemx Q 680@item Q
682Query replace. 681Query replace.
683@itemx R 682@item R
684Replace. 683Replace.
685@end table 684@end table
686 685
687@node Vi Commands, Numeric Arguments, Misc Commands, Top 686@node Vi Commands
688@chapter Vi Commands 687@chapter Vi Commands
689 688
690This chapter describes Vi commands other than Ex commands implemented in 689This chapter describes Vi commands other than Ex commands implemented in
@@ -705,7 +704,7 @@ commands described in this chapter are to be used in vi mode.
705* Commands in Insert Mode:: Commands for entering insert mode. 704* Commands in Insert Mode:: Commands for entering insert mode.
706@end menu 705@end menu
707 706
708@node Numeric Arguments, Important Keys, Vi Commands, Vi Commands 707@node Numeric Arguments
709@section Numeric Arguments 708@section Numeric Arguments
710 709
711@cindex numeric arguments 710@cindex numeric arguments
@@ -726,7 +725,7 @@ In many cases, if a count is given, the command is executed that many times.
726For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a 725For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a
727line. In this manual the metavariable @var{n} will denote a count.@refill 726line. In this manual the metavariable @var{n} will denote a count.@refill
728 727
729@node Important Keys, Buffers and Windows, Numeric Arguments, Vi Commands 728@node Important Keys
730@section Important Keys 729@section Important Keys
731 730
732The keys @kbd{C-g} and @kbd{C-l} are unique in that their associated 731The keys @kbd{C-g} and @kbd{C-l} are unique in that their associated
@@ -776,7 +775,7 @@ typing @kbd{\}. Thus @kbd{5 \ +}, as well as @kbd{\ C-u 5 +}, will insert
776@samp{+++++} before point.@refill 775@samp{+++++} before point.@refill
777@end table 776@end table
778 777
779@node Buffers and Windows, Files, Important Keys, Vi Commands 778@node Buffers and Windows
780@section Buffers and Windows 779@section Buffers and Windows
781 780
782@cindex buffer 781@cindex buffer
@@ -843,7 +842,7 @@ by @key{RET}. The default buffer name to switch to will also be prompted,
843and you can select it by giving a simple @key{RET}. See GNU Emacs Manual 842and you can select it by giving a simple @key{RET}. See GNU Emacs Manual
844for details of completion. 843for details of completion.
845 844
846@node Files, Viewing the Buffer, Buffers and Windows, Vi Commands 845@node Files
847@section Files 846@section Files
848 847
849We have the following commands related to files. They are used to visit, 848We have the following commands related to files. They are used to visit,
@@ -924,7 +923,7 @@ case), you can just say @kbd{X S}. If you wish to save it in another file,
924you can type @kbd{X W}. You will then get a similar prompt as you get for 923you can type @kbd{X W}. You will then get a similar prompt as you get for
925@kbd{v}, to which you can enter the file name.@refill 924@kbd{v}, to which you can enter the file name.@refill
926 925
927@node Viewing the Buffer, Mark Commands, Files, Vi Commands 926@node Viewing the Buffer
928@section Viewing the Buffer 927@section Viewing the Buffer
929 928
930In this and next section we discuss commands for moving around in the 929In this and next section we discuss commands for moving around in the
@@ -945,11 +944,11 @@ Scroll text of current window upward almost full screen. You can go
945@kindex 002 @kbd{C-b} (@code{vip-scroll-back}) 944@kindex 002 @kbd{C-b} (@code{vip-scroll-back})
946Scroll text of current window downward almost full screen. You can go 945Scroll text of current window downward almost full screen. You can go
947@i{backward} in the buffer by this command (@code{vip-scroll-back}). 946@i{backward} in the buffer by this command (@code{vip-scroll-back}).
948@itemx C-d 947@item C-d
949@kindex 004 @kbd{C-d} (@code{vip-scroll-up}) 948@kindex 004 @kbd{C-d} (@code{vip-scroll-up})
950Scroll text of current window upward half screen. You can go 949Scroll text of current window upward half screen. You can go
951@i{down} in the buffer by this command (@code{vip-scroll-down}). 950@i{down} in the buffer by this command (@code{vip-scroll-down}).
952@itemx C-u 951@item C-u
953@kindex 025 @kbd{C-u} (@code{vip-scroll-down}) 952@kindex 025 @kbd{C-u} (@code{vip-scroll-down})
954Scroll text of current window downward half screen. You can go 953Scroll text of current window downward half screen. You can go
955@i{up} in the buffer by this command (@code{vip-scroll-up}). 954@i{up} in the buffer by this command (@code{vip-scroll-up}).
@@ -992,7 +991,7 @@ point will be placed in the @var{n}-th line from bottom
992Center point in window and redisplay screen (@code{recenter}). 991Center point in window and redisplay screen (@code{recenter}).
993@end table 992@end table
994 993
995@node Mark Commands, Motion Commands, Viewing the Buffer, Vi Commands 994@node Mark Commands
996@section Mark Commands 995@section Mark Commands
997 996
998The following commands are used to mark positions in the buffer. 997The following commands are used to mark positions in the buffer.
@@ -1020,7 +1019,7 @@ latest element of the mark ring (replacing the oldest one). By repeating
1020the command `@kbd{m ,}' you can visit older and older marked positions. You 1019the command `@kbd{m ,}' you can visit older and older marked positions. You
1021will eventually be in a loop as the mark ring is a ring. 1020will eventually be in a loop as the mark ring is a ring.
1022 1021
1023@node Motion Commands, Searching and Replacing, Mark Commands, Vi Commands 1022@node Motion Commands
1024@section Motion Commands 1023@section Motion Commands
1025 1024
1026Commands for moving around in the current buffer are collected here. These 1025Commands for moving around in the current buffer are collected here. These
@@ -1214,7 +1213,7 @@ Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command, in the
1214opposite direction (@code{vip-repeat-find-opposite}). 1213opposite direction (@code{vip-repeat-find-opposite}).
1215@end table 1214@end table
1216 1215
1217@node Searching and Replacing, Modifying Commands, Motion Commands, Vi Commands 1216@node Searching and Replacing
1218@section Searching and Replacing 1217@section Searching and Replacing
1219 1218
1220Following commands are available for searching and replacing. 1219Following commands are available for searching and replacing.
@@ -1278,7 +1277,7 @@ count, replace that many characters by @var{ch} (@code{vip-replace-char}).
1278The commands @kbd{/} and @kbd{?} mark point before move, so that you can 1277The commands @kbd{/} and @kbd{?} mark point before move, so that you can
1279return to the original point by @w{@kbd{` `}}. 1278return to the original point by @w{@kbd{` `}}.
1280 1279
1281@node Modifying Commands, Delete Commands, Searching and Replacing, Vi Commands 1280@node Modifying Commands
1282@section Modifying Commands 1281@section Modifying Commands
1283 1282
1284In this section, commands for modifying the content of a buffer are 1283In this section, commands for modifying the content of a buffer are
@@ -1316,7 +1315,7 @@ command.
1316* Change Commands:: Commands for changing text. 1315* Change Commands:: Commands for changing text.
1317* Repeating and Undoing Modifications:: 1316* Repeating and Undoing Modifications::
1318@end menu 1317@end menu
1319@node Delete Commands, Yank Commands, Modifying Commands, Modifying Commands 1318@node Delete Commands
1320@subsection Delete Commands 1319@subsection Delete Commands
1321 1320
1322@table @kbd 1321@table @kbd
@@ -1368,7 +1367,7 @@ Delete a character before point. Given @var{n}, delete @var{n} characters
1368(@code{vip-delete-backward-char}). 1367(@code{vip-delete-backward-char}).
1369@end table 1368@end table
1370 1369
1371@node Yank Commands, Put Back Commands, Delete Commands, Modifying Commands 1370@node Yank Commands
1372@subsection Yank Commands 1371@subsection Yank Commands
1373 1372
1374@cindex yank 1373@cindex yank
@@ -1404,7 +1403,7 @@ Yank current region.
1404Expand current region and yank it. 1403Expand current region and yank it.
1405@end table 1404@end table
1406 1405
1407@node Put Back Commands, Change Commands, Yank Commands, Modifying Commands 1406@node Put Back Commands
1408@subsection Put Back Commands 1407@subsection Put Back Commands
1409Deleted or yanked texts can be put back into the buffer by the command 1408Deleted or yanked texts can be put back into the buffer by the command
1410below. 1409below.
@@ -1435,7 +1434,7 @@ numeral between @kbd{1} and @kbd{9}. If the number register @var{n} is
1435specified, @var{n}-th previously deleted/yanked text will be put back. It 1434specified, @var{n}-th previously deleted/yanked text will be put back. It
1436is an error to specify a number register for the delete/yank commands. 1435is an error to specify a number register for the delete/yank commands.
1437 1436
1438@node Change Commands, Repeating and Undoing Modifications, Put Back Commands, Modifying Commands 1437@node Change Commands
1439@subsection Change Commands 1438@subsection Change Commands
1440 1439
1441Most commonly used change command takes the following form. 1440Most commonly used change command takes the following form.
@@ -1468,7 +1467,7 @@ Change current region.
1468Expand current region and change it. 1467Expand current region and change it.
1469@end table 1468@end table
1470 1469
1471@node Repeating and Undoing Modifications, Other Vi Commands, Change Commands, Modifying Commands 1470@node Repeating and Undoing Modifications
1472@subsection Repeating and Undoing Modifications 1471@subsection Repeating and Undoing Modifications
1473 1472
1474VIP records the previous modifying command, so that it is easy to repeat 1473VIP records the previous modifying command, so that it is easy to repeat
@@ -1488,7 +1487,7 @@ count for the repeated command. Otherwise, the count for the last
1488modifying command is used again (@code{vip-repeat}). 1487modifying command is used again (@code{vip-repeat}).
1489@end table 1488@end table
1490 1489
1491@node Other Vi Commands, Commands in Insert Mode, Repeating and Undoing Modifications, Vi Commands 1490@node Other Vi Commands
1492@section Other Vi Commands 1491@section Other Vi Commands
1493 1492
1494Miscellaneous Vi commands are collected here. 1493Miscellaneous Vi commands are collected here.
@@ -1609,7 +1608,7 @@ command @kbd{P} or @kbd{p} can retrieve it from kill ring
1609(@code{kill-region}). 1608(@code{kill-region}).
1610@end table 1609@end table
1611 1610
1612@node Commands in Insert Mode, Ex Commands, Other Vi Commands, Vi Commands 1611@node Commands in Insert Mode
1613@section Insert Mode 1612@section Insert Mode
1614 1613
1615You can enter insert mode by one of the following commands. In addition to 1614You can enter insert mode by one of the following commands. In addition to
@@ -1677,7 +1676,7 @@ start point is saved for later use by repeat command etc. Therefore, repeat
1677command will not really repeat insertion if you move point by emacs 1676command will not really repeat insertion if you move point by emacs
1678commands while in insert mode. 1677commands while in insert mode.
1679 1678
1680@node Ex Commands, Ex Command Reference, Commands in Insert Mode, Top 1679@node Ex Commands
1681@chapter Ex Commands 1680@chapter Ex Commands
1682 1681
1683@kindex 072 @kbd{:} (@code{vip-ex}) 1682@kindex 072 @kbd{:} (@code{vip-ex})
@@ -1714,7 +1713,7 @@ character @samp{|}.
1714@menu 1713@menu
1715* Ex Command Reference:: Explain all the Ex commands available in VIP. 1714* Ex Command Reference:: Explain all the Ex commands available in VIP.
1716@end menu 1715@end menu
1717@node Ex Command Reference, Customization, Ex Commands, Ex Commands 1716@node Ex Command Reference
1718@section Ex Command Reference 1717@section Ex Command Reference
1719In this section we briefly explain all the Ex commands supported by VIP@. 1718In this section we briefly explain all the Ex commands supported by VIP@.
1720Most Ex commands expect @var{address} as their argument, and they use 1719Most Ex commands expect @var{address} as their argument, and they use
@@ -1860,7 +1859,7 @@ The following Ex commands are available in Vi, but not implemented in VIP.
1860@kbd{unabbreviate}, @kbd{xit}, @kbd{z} 1859@kbd{unabbreviate}, @kbd{xit}, @kbd{z}
1861@end example 1860@end example
1862 1861
1863@node Customization, Customizing Constants, Ex Command Reference, Top 1862@node Customization
1864@chapter Customization 1863@chapter Customization
1865 1864
1866If you have a file called @file{.vip} in your home directory, then it 1865If you have a file called @file{.vip} in your home directory, then it
@@ -1872,7 +1871,7 @@ customizing VIP.
1872* Customizing Key Bindings:: How to change key bindings. 1871* Customizing Key Bindings:: How to change key bindings.
1873@end menu 1872@end menu
1874 1873
1875@node Customizing Constants, Customizing Key Bindings, Customization, Customization 1874@node Customizing Constants
1876@section Customizing Constants 1875@section Customizing Constants
1877An easy way to customize VIP is to change the values of constants used 1876An easy way to customize VIP is to change the values of constants used
1878in VIP@. Here is the list of the constants used in VIP and their default 1877in VIP@. Here is the list of the constants used in VIP and their default
@@ -1908,7 +1907,7 @@ can include a line like this in your @file{.vip} file:
1908(setq vip-case-fold-search t) 1907(setq vip-case-fold-search t)
1909@end example 1908@end example
1910 1909
1911@node Customizing Key Bindings,, Customizing Constants, Customization 1910@node Customizing Key Bindings
1912@section Customizing Key Bindings 1911@section Customizing Key Bindings
1913 1912
1914@cindex local keymap 1913@cindex local keymap
@@ -1932,7 +1931,7 @@ file.
1932(define-key vip-command-mode-map "X" 'vip-delete-backward-char) 1931(define-key vip-command-mode-map "X" 'vip-delete-backward-char)
1933@end example 1932@end example
1934 1933
1935@node GNU Free Documentation License,,, Top 1934@node GNU Free Documentation License
1936@appendix GNU Free Documentation License 1935@appendix GNU Free Documentation License
1937@include doclicense.texi 1936@include doclicense.texi
1938 1937
diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi
index 5fb1f92363a..9bcecf8e3de 100644
--- a/doc/misc/viper.texi
+++ b/doc/misc/viper.texi
@@ -7,7 +7,7 @@
7@setfilename ../../info/viper 7@setfilename ../../info/viper
8 8
9@copying 9@copying
10Copyright @copyright{} 1995-1997, 2001-2012 Free Software Foundation, Inc. 10Copyright @copyright{} 1995--1997, 2001--2013 Free Software Foundation, Inc.
11 11
12@quotation 12@quotation
13Permission is granted to copy, distribute and/or modify this document 13Permission is granted to copy, distribute and/or modify this document
@@ -18,8 +18,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
18is included in the section entitled ``GNU Free Documentation License''. 18is included in the section entitled ``GNU Free Documentation License''.
19 19
20(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 20(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
21modify this GNU manual. Buying copies from the FSF supports it in 21modify this GNU manual.''
22developing GNU and promoting software freedom.''
23@end quotation 22@end quotation
24@end copying 23@end copying
25 24
@@ -47,9 +46,8 @@ developing GNU and promoting software freedom.''
47@contents 46@contents
48 47
49@ifnottex 48@ifnottex
50@node Top, Overview,, (DIR) 49@node Top
51 50@top Viper
52@unnumbered Viper
53 51
54We believe that one or more of the following statements are adequate 52We believe that one or more of the following statements are adequate
55descriptions of Viper: 53descriptions of Viper:
@@ -76,7 +74,7 @@ Viper, formerly known as VIP-19, was written by Michael Kifer. It is based
76on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane. 74on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane.
77About 15% of the code still comes from those older packages. 75About 15% of the code still comes from those older packages.
78 76
79Viper is intended to be usable without reading this manual --- the defaults 77Viper is intended to be usable without reading this manual; the defaults
80are set to make Viper as close to Vi as possible. At startup, Viper will 78are set to make Viper as close to Vi as possible. At startup, Viper will
81try to set the most appropriate default environment for you, based on 79try to set the most appropriate default environment for you, based on
82your familiarity with Emacs. It will also tell you the basic GNU Emacs window 80your familiarity with Emacs. It will also tell you the basic GNU Emacs window
@@ -100,16 +98,13 @@ Please use the Ex command @kbd{:submitReport} for this purpose.@refill
100* Improvements over Vi:: New features, Improvements 98* Improvements over Vi:: New features, Improvements
101* Customization:: How to customize Viper 99* Customization:: How to customize Viper
102* Commands:: Vi and Ex Commands 100* Commands:: Vi and Ex Commands
103 101* GNU Free Documentation License:: The license for this documentation.
102* Acknowledgments::
104* Key Index:: Index of Vi and Ex Commands 103* Key Index:: Index of Vi and Ex Commands
105* Function Index:: Index of Viper Functions 104* Function Index:: Index of Viper Functions
106* Variable Index:: Index of Viper Variables 105* Variable Index:: Index of Viper Variables
107* Package Index:: Index of Packages Mentioned in this Document 106* Package Index:: Index of Packages Mentioned in this Document
108* Concept Index:: Vi, Ex and Emacs concepts 107* Concept Index:: Vi, Ex and Emacs concepts
109
110* Acknowledgments::
111* GNU Free Documentation License:: The license for this documentation.
112
113@end menu 108@end menu
114@iftex 109@iftex
115@unnumbered Introduction 110@unnumbered Introduction
@@ -134,8 +129,8 @@ Viper was written by Michael Kifer. It is based on VIP version 3.5 by
134Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code 129Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code
135still comes from those older packages. 130still comes from those older packages.
136 131
137Viper is intended to be usable out of the box, without reading this manual 132Viper is intended to be usable out of the box, without reading this manual;
138--- the defaults are set to make Viper as close to Vi as possible. At 133the defaults are set to make Viper as close to Vi as possible. At
139startup, Viper will attempt to set the most appropriate default environment 134startup, Viper will attempt to set the most appropriate default environment
140for you, based on your familiarity with Emacs. It will also tell you the 135for you, based on your familiarity with Emacs. It will also tell you the
141basic GNU Emacs window management commands to help you start immediately. 136basic GNU Emacs window management commands to help you start immediately.
@@ -156,7 +151,7 @@ Please use the Ex command @kbd{:submitReport} for this purpose.@refill
156 151
157@end iftex 152@end iftex
158 153
159@node Overview,Improvements over Vi,Top,Top 154@node Overview
160@chapter Overview of Viper 155@chapter Overview of Viper
161 156
162Viper is a Vi emulation on top of Emacs. At the same time, Viper provides a 157Viper is a Vi emulation on top of Emacs. At the same time, Viper provides a
@@ -186,7 +181,7 @@ included in your @file{~/.viper} file and are found at the following URL:
186* Unimplemented Features:: That are unlikely to be implemented. 181* Unimplemented Features:: That are unlikely to be implemented.
187@end menu 182@end menu
188 183
189@node Emacs Preliminaries, Loading Viper, Overview, Overview 184@node Emacs Preliminaries
190@section Emacs Preliminaries 185@section Emacs Preliminaries
191 186
192@cindex buffer 187@cindex buffer
@@ -314,7 +309,7 @@ Emacs is structured as a Lisp interpreter around a C core. Emacs keys
314cause Lisp functions to be called. It is possible to call these 309cause Lisp functions to be called. It is possible to call these
315functions directly, by typing @kbd{M-x function-name}. 310functions directly, by typing @kbd{M-x function-name}.
316 311
317@node Loading Viper, States in Viper, Emacs Preliminaries, Overview 312@node Loading Viper
318@section Loading Viper 313@section Loading Viper
319 314
320The most common way to load it automatically is to include the following 315The most common way to load it automatically is to include the following
@@ -369,7 +364,7 @@ copy of Emacs after Viper has been loaded, the command @kbd{M-x
369viper-go-away} will do it for you. The function @code{toggle-viper-mode} 364viper-go-away} will do it for you. The function @code{toggle-viper-mode}
370toggles Viperization of Emacs on and off. 365toggles Viperization of Emacs on and off.
371 366
372@node States in Viper, The Minibuffer, Loading Viper,Overview 367@node States in Viper
373@section States in Viper 368@section States in Viper
374 369
375@kindex @kbd{C-z} 370@kindex @kbd{C-z}
@@ -447,7 +442,7 @@ doing soon!), you should learn about the meaning of the various keys in
447those special modes (typing @kbd{C-h m} in a buffer provides 442those special modes (typing @kbd{C-h m} in a buffer provides
448help with key bindings for the major mode of that buffer). 443help with key bindings for the major mode of that buffer).
449 444
450If you switch to Vi in Dired or similar modes---no harm is done. It is just 445If you switch to Vi in Dired or similar modes, no harm is done. It is just
451that the special key bindings provided by those modes will be temporarily 446that the special key bindings provided by those modes will be temporarily
452overshadowed by Viper's bindings. Switching back to Viper's Emacs state 447overshadowed by Viper's bindings. Switching back to Viper's Emacs state
453will revive the environment provided by the current major mode. 448will revive the environment provided by the current major mode.
@@ -475,7 +470,7 @@ to allow Emacs keys in Insert state.
475 replacement commands, such as cw, C, R, etc. 470 replacement commands, such as cw, C, R, etc.
476@end menu 471@end menu
477 472
478@node Emacs State, Vi State, States in Viper, States in Viper 473@node Emacs State
479@subsection Emacs State 474@subsection Emacs State
480 475
481@kindex @kbd{C-z} 476@kindex @kbd{C-z}
@@ -507,7 +502,7 @@ from the Insert state: typing @kbd{C-z} will let you execute a
507single Vi command while staying in Viper's Insert state. 502single Vi command while staying in Viper's Insert state.
508 503
509 504
510@node Vi State, Insert State, Emacs State, States in Viper 505@node Vi State
511@subsection Vi State 506@subsection Vi State
512 507
513@cindex Vi state 508@cindex Vi state
@@ -667,7 +662,7 @@ Having found the appropriate command, it can be then executed by typing
667`@kbd{.}'. 662`@kbd{.}'.
668@xref{Improvements over Vi}, for more information. 663@xref{Improvements over Vi}, for more information.
669 664
670@node Insert State, Replace State, Vi State, States in Viper 665@node Insert State
671@subsection Insert State 666@subsection Insert State
672 667
673@cindex Insert state 668@cindex Insert state
@@ -727,7 +722,7 @@ the Insert state.
727 722
728When Viper is in Insert state, you will see <I> in the mode line. 723When Viper is in Insert state, you will see <I> in the mode line.
729 724
730@node Replace State,, Insert State, States in Viper 725@node Replace State
731@subsection Replace State 726@subsection Replace State
732 727
733@cindex Replace state 728@cindex Replace state
@@ -759,7 +754,7 @@ was still inside the replacement region. So, in the above situation, Viper
759would delete text between this position and the end of the replacement 754would delete text between this position and the end of the replacement
760region. 755region.
761 756
762@node The Minibuffer,Multiple Files in Viper, States in Viper, Overview 757@node The Minibuffer
763@section The Minibuffer 758@section The Minibuffer
764 759
765@cindex Minibuffer 760@cindex Minibuffer
@@ -809,7 +804,7 @@ has no mode line to tell which Vi state it is in.
809The appearance of the text in the minibuffer can be changed. 804The appearance of the text in the minibuffer can be changed.
810@xref{Viper Specials}, for more details. 805@xref{Viper Specials}, for more details.
811 806
812@node Multiple Files in Viper,Unimplemented Features,The Minibuffer,Overview 807@node Multiple Files in Viper
813@section Multiple Files in Viper 808@section Multiple Files in Viper
814 809
815@cindex multiple files 810@cindex multiple files
@@ -884,7 +879,7 @@ Currently undisplayed files can be listed using the @kbd{:ar} command. The
884command @kbd{:n} can be given counts from the @kbd{:ar} list to switch to 879command @kbd{:n} can be given counts from the @kbd{:ar} list to switch to
885other files. For example, use `:n3' to move to the third file in that list. 880other files. For example, use `:n3' to move to the third file in that list.
886 881
887@node Unimplemented Features,,Multiple Files in Viper,Overview 882@node Unimplemented Features
888@section Unimplemented Features 883@section Unimplemented Features
889 884
890Unimplemented features include: 885Unimplemented features include:
@@ -905,8 +900,7 @@ be used directly inside Emacs, since Emacs will obdurately change @samp{^I}
905back to normal tabs.@refill 900back to normal tabs.@refill
906@end itemize 901@end itemize
907 902
908@comment node-name, next, previous, up 903@node Improvements over Vi
909@node Improvements over Vi, Customization, Overview, Top
910@chapter Improvements over Vi 904@chapter Improvements over Vi
911 905
912Some common problems with Vi and Ex have been solved in Viper. This 906Some common problems with Vi and Ex have been solved in Viper. This
@@ -927,7 +921,7 @@ the facilities provided by Emacs.
927 you should know about. 921 you should know about.
928@end menu 922@end menu
929 923
930@node Basics, Undo and Backups, Improvements over Vi, Improvements over Vi 924@node Basics
931@section Basics 925@section Basics
932 926
933The Vi command set is based on the idea of combining motion commands 927The Vi command set is based on the idea of combining motion commands
@@ -998,7 +992,7 @@ buffers. These can be seen in the @kbd{:args} list and switched using
998specify @code{(setq ex-cycle-through-non-files t)} in your @file{.viper} 992specify @code{(setq ex-cycle-through-non-files t)} in your @file{.viper}
999file. @xref{Customization}, for details. 993file. @xref{Customization}, for details.
1000 994
1001@node Undo and Backups, History, Basics, Improvements over Vi 995@node Undo and Backups
1002@section Undo and Backups 996@section Undo and Backups
1003 997
1004@cindex undo 998@cindex undo
@@ -1034,7 +1028,7 @@ will show the text around the textmarker. @samp{register} and @samp{textmarker}
1034can be any letters from a through z. 1028can be any letters from a through z.
1035@comment ] balance parens 1029@comment ] balance parens
1036 1030
1037@node History, Macros and Registers, Undo and Backups,Improvements over Vi 1031@node History
1038@section History 1032@section History
1039 1033
1040@cindex history 1034@cindex history
@@ -1073,7 +1067,7 @@ Similarly, commands that have to do with switching buffers
1073have a buffer history, and commands that expect strings or regular 1067have a buffer history, and commands that expect strings or regular
1074expressions keep a history on those items. 1068expressions keep a history on those items.
1075 1069
1076@node Macros and Registers,Completion,History,Improvements over Vi 1070@node Macros and Registers
1077@section Macros and Registers 1071@section Macros and Registers
1078 1072
1079@cindex keyboard macros 1073@cindex keyboard macros
@@ -1120,7 +1114,7 @@ Keyboard Macro execution @kbd{@@@@} (the replace).
1120Viper also provides Vi-style macros. @xref{Vi Macros}, for details. 1114Viper also provides Vi-style macros. @xref{Vi Macros}, for details.
1121 1115
1122 1116
1123@node Completion, Improved Search, Macros and Registers, Improvements over Vi 1117@node Completion
1124@section Completion 1118@section Completion
1125 1119
1126@cindex completion 1120@cindex completion
@@ -1131,7 +1125,7 @@ no longer work for that file name. Remember that Emacs interprets a file name
1131of the form @kbd{/foo//bar} as @kbd{/bar} and @kbd{/foo/~/bar} as 1125of the form @kbd{/foo//bar} as @kbd{/bar} and @kbd{/foo/~/bar} as
1132@kbd{~/bar}. 1126@kbd{~/bar}.
1133 1127
1134@node Improved Search, Abbreviation Facilities, Completion, Improvements over Vi 1128@node Improved Search
1135@section Improved Search 1129@section Improved Search
1136 1130
1137@cindex buffer search 1131@cindex buffer search
@@ -1199,7 +1193,7 @@ faces are grouped together under Viper's
1199 1193
1200Try it: it is really simple! 1194Try it: it is really simple!
1201 1195
1202@node Abbreviation Facilities,Movement and Markers,Improved Search,Improvements over Vi 1196@node Abbreviation Facilities
1203@section Abbreviation Facilities 1197@section Abbreviation Facilities
1204 1198
1205@cindex abbrevs 1199@cindex abbrevs
@@ -1223,7 +1217,7 @@ keystroke, which appears earlier in the text. Emacs binds this to
1223@code{dabbrev-expand} to that key. 1217@code{dabbrev-expand} to that key.
1224Facilities like this make Vi's @kbd{:ab} command obsolete. 1218Facilities like this make Vi's @kbd{:ab} command obsolete.
1225 1219
1226@node Movement and Markers, New Commands, Abbreviation Facilities, Improvements over Vi 1220@node Movement and Markers
1227@section Movement and Markers 1221@section Movement and Markers
1228 1222
1229@cindex Ex style motion 1223@cindex Ex style motion
@@ -1299,7 +1293,7 @@ switch files by simply doing @kbd{'a}. If you set up a regimen for using
1299Textmarkers, this is very useful. Contents of textmarkers can be viewed 1293Textmarkers, this is very useful. Contents of textmarkers can be viewed
1300by @kbd{[marker}. (Contents of registers can be viewed by @kbd{]register}). 1294by @kbd{[marker}. (Contents of registers can be viewed by @kbd{]register}).
1301 1295
1302@node New Commands, Useful Packages, Movement and Markers, Improvements over Vi 1296@node New Commands
1303@section New Commands 1297@section New Commands
1304 1298
1305These commands have no Vi analogs. 1299These commands have no Vi analogs.
@@ -1488,7 +1482,7 @@ Apart from the new commands, many old commands have been enhanced. Most
1488notably, Vi style macros are much more powerful in Viper than in Vi. @xref{Vi 1482notably, Vi style macros are much more powerful in Viper than in Vi. @xref{Vi
1489Macros}, for details. 1483Macros}, for details.
1490 1484
1491@node Useful Packages, ,New Commands, Improvements over Vi 1485@node Useful Packages
1492@section Useful Packages 1486@section Useful Packages
1493 1487
1494Some Emacs packages are mentioned here as an aid to the new Viper user, to 1488Some Emacs packages are mentioned here as an aid to the new Viper user, to
@@ -1569,7 +1563,7 @@ Emacs Lisp archives exist on
1569and @samp{wuarchive.wustl.edu}@refill 1563and @samp{wuarchive.wustl.edu}@refill
1570 1564
1571 1565
1572@node Customization,Commands,Improvements over Vi,Top 1566@node Customization
1573@chapter Customization 1567@chapter Customization
1574 1568
1575@cindex customization 1569@cindex customization
@@ -1615,7 +1609,7 @@ cases, examples are provided that you can use directly.
1615* Vi Macros:: How to do Vi style macros. 1609* Vi Macros:: How to do Vi style macros.
1616@end menu 1610@end menu
1617 1611
1618@node Rudimentary Changes,Key Bindings,Customization,Customization 1612@node Rudimentary Changes
1619@section Rudimentary Changes 1613@section Rudimentary Changes
1620 1614
1621@cindex setting variables 1615@cindex setting variables
@@ -1715,7 +1709,7 @@ If not @code{nil}, search wraps around the end/beginning of buffer.
1715@item viper-search-scroll-threshold 2 1709@item viper-search-scroll-threshold 2
1716If search lands within this many lines of the window top or bottom, the 1710If search lands within this many lines of the window top or bottom, the
1717window will be scrolled up or down by about 1/7-th of its size, to reveal 1711window will be scrolled up or down by about 1/7-th of its size, to reveal
1718the context. If the value is negative---don't scroll. 1712the context. If the value is negative, don't scroll.
1719@item viper-tags-file-name "TAGS" 1713@item viper-tags-file-name "TAGS"
1720The name of the file used as the tag table. 1714The name of the file used as the tag table.
1721@item viper-re-query-replace nil 1715@item viper-re-query-replace nil
@@ -1839,10 +1833,10 @@ replacement regions, you can change @code{viper-replace-overlay-face} by
1839specifying a new face. (Emacs faces are described in the Emacs Lisp 1833specifying a new face. (Emacs faces are described in the Emacs Lisp
1840reference.) On a color display, the following customization method is 1834reference.) On a color display, the following customization method is
1841usually most effective: 1835usually most effective:
1842@example 1836@smallexample
1843(set-face-foreground viper-replace-overlay-face "DarkSlateBlue") 1837(set-face-foreground viper-replace-overlay-face "DarkSlateBlue")
1844(set-face-background viper-replace-overlay-face "yellow") 1838(set-face-background viper-replace-overlay-face "yellow")
1845@end example 1839@end smallexample
1846For a complete list of colors available to you, evaluate the expression 1840For a complete list of colors available to you, evaluate the expression
1847@code{(x-defined-colors)}. (Type it in the buffer @code{*scratch*} and then 1841@code{(x-defined-colors)}. (Type it in the buffer @code{*scratch*} and then
1848hit the @kbd{C-j} key. 1842hit the @kbd{C-j} key.
@@ -1956,7 +1950,7 @@ can include a line like this in your @file{.viper} file:
1956@vindex @code{viper-replace-state-hook} 1950@vindex @code{viper-replace-state-hook}
1957@vindex @code{viper-emacs-state-hook} 1951@vindex @code{viper-emacs-state-hook}
1958 1952
1959@node Key Bindings, Packages that Change Keymaps, Rudimentary Changes,Customization 1953@node Key Bindings
1960@section Key Bindings 1954@section Key Bindings
1961 1955
1962@cindex key bindings 1956@cindex key bindings
@@ -2045,7 +2039,8 @@ can write this:
2045@noindent 2039@noindent
2046To customize the binding for @kbd{C-h} in Insert state: 2040To customize the binding for @kbd{C-h} in Insert state:
2047@example 2041@example
2048(define-key viper-insert-global-user-map "\C-h" 'my-del-backwards-function) 2042(define-key viper-insert-global-user-map "\C-h"
2043 'my-del-backwards-function)
2049@end example 2044@end example
2050@noindent 2045@noindent
2051 2046
@@ -2094,7 +2089,8 @@ Dired functions, the trick can be accomplished via the following code:
2094(setq my-dired-vi-purist-map (make-sparse-keymap)) 2089(setq my-dired-vi-purist-map (make-sparse-keymap))
2095(define-key my-dired-vi-purist-map "k" 'viper-previous-line) 2090(define-key my-dired-vi-purist-map "k" 'viper-previous-line)
2096(define-key my-dired-vi-purist-map "l" 'viper-forward-char) 2091(define-key my-dired-vi-purist-map "l" 'viper-forward-char)
2097(viper-modify-major-mode 'dired-mode 'emacs-state my-dired-vi-purist-map) 2092(viper-modify-major-mode 'dired-mode
2093 'emacs-state my-dired-vi-purist-map)
2098@end example 2094@end example
2099 2095
2100Yet another way to customize key bindings in a major mode is to edit the 2096Yet another way to customize key bindings in a major mode is to edit the
@@ -2192,8 +2188,8 @@ bindings in Emacs.
2192@findex @code{viper-add-local-keys} 2188@findex @code{viper-add-local-keys}
2193@findex @code{viper-zap-local-keys} 2189@findex @code{viper-zap-local-keys}
2194 2190
2195@node Packages that Change Keymaps,Viper Specials,Key Bindings,Customization 2191@node Packages that Change Keymaps
2196@subsection Packages that Change Keymaps 2192@section Packages that Change Keymaps
2197@cindex C-c and Viper 2193@cindex C-c and Viper
2198@cindex Viper and C-c 2194@cindex Viper and C-c
2199 2195
@@ -2321,7 +2317,7 @@ compatible with Viper is to have the file @file{my-mode.el} include the followin
2321@findex @code{remove-hook} 2317@findex @code{remove-hook}
2322@findex @code{add-hook} 2318@findex @code{add-hook}
2323 2319
2324@node Viper Specials,Vi Macros,Packages that Change Keymaps,Customization 2320@node Viper Specials
2325@section Viper Specials 2321@section Viper Specials
2326 2322
2327Viper extends Vi with a number of useful features. This includes various 2323Viper extends Vi with a number of useful features. This includes various
@@ -2706,7 +2702,7 @@ you will then have to write such a function and make it known to your
2706Emacs. The function @code{viper-surrounding-word} in @file{viper.el} can be 2702Emacs. The function @code{viper-surrounding-word} in @file{viper.el} can be
2707used as a guiding example. 2703used as a guiding example.
2708 2704
2709@node Vi Macros, ,Viper Specials,Customization 2705@node Vi Macros
2710@section Vi Macros 2706@section Vi Macros
2711 2707
2712@cindex Vi macros 2708@cindex Vi macros
@@ -2786,7 +2782,7 @@ type @kbd{C-x q} (for confirmation) or @kbd{C-u C-x q} (for prompt).
2786For details, @pxref{Keyboard Macro Query,,Customization,emacs,The GNU Emacs 2782For details, @pxref{Keyboard Macro Query,,Customization,emacs,The GNU Emacs
2787Manual} @refill 2783Manual} @refill
2788 2784
2789When the user finishes defining a macro (which is done by typing @kbd{C-x)} --- 2785When the user finishes defining a macro (which is done by typing @kbd{C-x)},
2790a departure from Vi), you will be asked whether you want this 2786a departure from Vi), you will be asked whether you want this
2791macro to be global, mode-specific, or buffer-specific. You will also be 2787macro to be global, mode-specific, or buffer-specific. You will also be
2792given a chance to save the macro in your @file{~/.viper} file. 2788given a chance to save the macro in your @file{~/.viper} file.
@@ -2993,7 +2989,7 @@ Finally, Viper provides a function that conveniently displays all macros
2993currently defined. To see all macros along with their definitions, type 2989currently defined. To see all macros along with their definitions, type
2994@kbd{M-x viper-describe-kbd-macros}. 2990@kbd{M-x viper-describe-kbd-macros}.
2995 2991
2996@node Commands,,Customization,Top 2992@node Commands
2997@chapter Commands 2993@chapter Commands
2998 2994
2999This section is a semi-automatically bowdlerized version of the Vi 2995This section is a semi-automatically bowdlerized version of the Vi
@@ -3012,8 +3008,7 @@ found on the Vi archives. This reference has been adapted for Viper.@refill
3012* Mouse-bound Commands:: Search and insertion of text 3008* Mouse-bound Commands:: Search and insertion of text
3013@end menu 3009@end menu
3014 3010
3015@node Groundwork, Text Handling, Commands, Commands 3011@node Groundwork
3016@comment node-name, next, previous, up
3017@section Groundwork 3012@section Groundwork
3018 3013
3019The VI command set is based on the idea of combining motion commands 3014The VI command set is based on the idea of combining motion commands
@@ -3223,7 +3218,7 @@ ends at line 135. There is no need to type the line numbers, since Viper
3223inserts them automatically in front of the Ex command. 3218inserts them automatically in front of the Ex command.
3224@cindex Ex commands 3219@cindex Ex commands
3225 3220
3226@node Text Handling, Display, Groundwork, Commands 3221@node Text Handling
3227@section Text Handling 3222@section Text Handling
3228 3223
3229@menu 3224@menu
@@ -3238,7 +3233,7 @@ inserts them automatically in front of the Ex command.
3238* Undoing:: Multiple Undo, Backups 3233* Undoing:: Multiple Undo, Backups
3239@end menu 3234@end menu
3240 3235
3241@node Move Commands,Marking,,Text Handling 3236@node Move Commands
3242@subsection Move Commands 3237@subsection Move Commands
3243 3238
3244@cindex movement commands 3239@cindex movement commands
@@ -3265,7 +3260,7 @@ inserts them automatically in front of the Ex command.
3265@item <count> $ 3260@item <count> $
3266To the end of line <count> from the cursor. 3261To the end of line <count> from the cursor.
3267@item <count> ^ 3262@item <count> ^
3268To the first CHAR <count> - 1 lines lower. 3263To the first CHAR <count> @minus{} 1 lines lower.
3269@item <count> - 3264@item <count> -
3270To the first CHAR <count> lines higher. 3265To the first CHAR <count> lines higher.
3271@item <count> + <cr> 3266@item <count> + <cr>
@@ -3434,7 +3429,7 @@ in your @file{~/.viper} file.
3434@kindex @kbd{l} 3429@kindex @kbd{l}
3435@vindex @code{viper-parse-sexp-ignore-comments} 3430@vindex @code{viper-parse-sexp-ignore-comments}
3436 3431
3437@node Marking,Appending Text,Move Commands,Text Handling 3432@node Marking
3438@subsection Marking 3433@subsection Marking
3439 3434
3440Emacs mark is referred to in the region specifiers @kbd{r} and @kbd{R}. 3435Emacs mark is referred to in the region specifiers @kbd{r} and @kbd{R}.
@@ -3470,7 +3465,7 @@ Exchange point and mark.
3470Exchange point and mark and go to the first CHAR on line. 3465Exchange point and mark and go to the first CHAR on line.
3471@item '<a-z> 3466@item '<a-z>
3472Go to specified Viper mark. 3467Go to specified Viper mark.
3473@item 3468@item `<a-z>
3474Go to specified Viper mark and go to the first CHAR on line. 3469Go to specified Viper mark and go to the first CHAR on line.
3475@end table 3470@end table
3476@kindex @kbd{m<a-z>} 3471@kindex @kbd{m<a-z>}
@@ -3486,7 +3481,7 @@ Go to specified Viper mark and go to the first CHAR on line.
3486@kindex @kbd{`<a-z>} 3481@kindex @kbd{`<a-z>}
3487@kindex @kbd{'<a-z>} 3482@kindex @kbd{'<a-z>}
3488 3483
3489@node Appending Text, Editing in Insert State, Marking,Text Handling 3484@node Appending Text
3490@subsection Appending Text 3485@subsection Appending Text
3491 3486
3492@xref{Options}, to see how to change tab and shiftwidth size. See the GNU 3487@xref{Options}, to see how to change tab and shiftwidth size. See the GNU
@@ -3568,7 +3563,7 @@ functions doing the perusing can be bound to unused keyboard keys in the
3568@kindex @kbd{A} 3563@kindex @kbd{A}
3569@kindex @kbd{a} 3564@kindex @kbd{a}
3570 3565
3571@node Editing in Insert State, Deleting Text, Appending Text,Text Handling 3566@node Editing in Insert State
3572@subsection Editing in Insert State 3567@subsection Editing in Insert State
3573 3568
3574Minibuffer can be edited similarly to Insert state, and you can switch 3569Minibuffer can be edited similarly to Insert state, and you can switch
@@ -3594,7 +3589,7 @@ current line.
3594@kindex @kbd{C-w} 3589@kindex @kbd{C-w}
3595@kindex @kbd{C-v} 3590@kindex @kbd{C-v}
3596 3591
3597@node Deleting Text, Changing Text, Editing in Insert State, Text Handling 3592@node Deleting Text
3598@subsection Deleting Text 3593@subsection Deleting Text
3599 3594
3600 3595
@@ -3637,7 +3632,7 @@ Shift <count> lines one shiftwidth to the left.
3637@kindex @kbd{X} 3632@kindex @kbd{X}
3638@kindex @kbd{x} 3633@kindex @kbd{x}
3639 3634
3640@node Changing Text, Search and Replace, Deleting Text,Text Handling 3635@node Changing Text
3641@subsection Changing Text 3636@subsection Changing Text
3642 3637
3643@cindex joining lines 3638@cindex joining lines
@@ -3647,10 +3642,10 @@ Shift <count> lines one shiftwidth to the left.
3647 3642
3648@table @kbd 3643@table @kbd
3649@item <count> r<char> 3644@item <count> r<char>
3650Replace <count> chars by <char> - no <esc>. 3645Replace <count> chars by <char>; no <esc>.
3651@item <count> R 3646@item <count> R
3652Overwrite the rest of the line, 3647Overwrite the rest of the line,
3653appending change @var{count - 1} times. 3648appending change @var{count} @minus{} 1 times.
3654@item <count> s 3649@item <count> s
3655Substitute <count> chars. 3650Substitute <count> chars.
3656@item <count> S 3651@item <count> S
@@ -3660,7 +3655,7 @@ Change from begin to endpoint of <count><move>.
3660@item <count> cc 3655@item <count> cc
3661Change <count> lines. 3656Change <count> lines.
3662@item <count> C 3657@item <count> C
3663The rest of the line and <count> - 1 next lines. 3658The rest of the line and <count> @minus{} 1 next lines.
3664@item <count> =<move> 3659@item <count> =<move>
3665Reindent the region described by move. 3660Reindent the region described by move.
3666@item <count> ~ 3661@item <count> ~
@@ -3745,7 +3740,7 @@ destructive Vi commands.
3745@kindex @kbd{R} 3740@kindex @kbd{R}
3746@kindex @kbd{r<char>} 3741@kindex @kbd{r<char>}
3747 3742
3748@node Search and Replace, Yanking, Changing Text,Text Handling 3743@node Search and Replace
3749@subsection Search and Replace 3744@subsection Search and Replace
3750 3745
3751@xref{Groundwork}, for Ex address syntax. @xref{Options}, to see how to 3746@xref{Groundwork}, for Ex address syntax. @xref{Options}, to see how to
@@ -3828,7 +3823,7 @@ Execute <ex-command> on all lines that do not match <pattern>.
3828@kindex @kbd{?<string>} 3823@kindex @kbd{?<string>}
3829@kindex @kbd{/<string>} 3824@kindex @kbd{/<string>}
3830 3825
3831@node Yanking,Undoing,Search and Replace,Text Handling 3826@node Yanking
3832@subsection Yanking 3827@subsection Yanking
3833 3828
3834@cindex cut and paste 3829@cindex cut and paste
@@ -3875,7 +3870,7 @@ Put the contents of the (default undo) buffer
3875@kindex @kbd{yank} 3870@kindex @kbd{yank}
3876@findex @kbd{:yank} 3871@findex @kbd{:yank}
3877 3872
3878@node Undoing,, Yanking,Text Handling 3873@node Undoing
3879@subsection Undoing 3874@subsection Undoing
3880 3875
3881@cindex undo 3876@cindex undo
@@ -3901,7 +3896,7 @@ that have a @samp{~} appended to them.
3901@kindex @kbd{U} 3896@kindex @kbd{U}
3902@kindex @kbd{u} 3897@kindex @kbd{u}
3903 3898
3904@node Display, File and Buffer Handling, Text Handling, Commands 3899@node Display
3905@section Display 3900@section Display
3906 3901
3907@cindex scrolling 3902@cindex scrolling
@@ -3913,7 +3908,7 @@ give file name, status, current line number
3913and relative position.@* 3908and relative position.@*
3914At user levels 2 and higher, abort the current command. 3909At user levels 2 and higher, abort the current command.
3915@item C-c g 3910@item C-c g
3916Give file name, status, current line number and relative position -- all 3911Give file name, status, current line number and relative position---all
3917user levels. 3912user levels.
3918@item C-l 3913@item C-l
3919Refresh the screen. 3914Refresh the screen.
@@ -3960,7 +3955,7 @@ Put line <count> in the center of the window
3960@kindex @kbd{C-g} 3955@kindex @kbd{C-g}
3961 3956
3962 3957
3963@node File and Buffer Handling, Mapping, Display,Commands 3958@node File and Buffer Handling
3964@section File and Buffer Handling 3959@section File and Buffer Handling
3965 3960
3966@cindex multiple files 3961@cindex multiple files
@@ -4022,7 +4017,7 @@ Save and kill buffer.
4022@item :x!@: [<file>] 4017@item :x!@: [<file>]
4023@kbd{:w![<file>]} and @kbd{:q}. 4018@kbd{:w![<file>]} and @kbd{:q}.
4024@item :pre 4019@item :pre
4025Preserve the file -- autosave buffers. 4020Preserve the file---autosave buffers.
4026@item :rec 4021@item :rec
4027Recover file from autosave. 4022Recover file from autosave.
4028@item :f [<file>] 4023@item :f [<file>]
@@ -4112,7 +4107,7 @@ is typed in minibuffer. File completion and history are supported.
4112@findex @kbd{:cd [<dir>]} 4107@findex @kbd{:cd [<dir>]}
4113@findex @kbd{:pwd} 4108@findex @kbd{:pwd}
4114 4109
4115@node Mapping, Shell Commands, File and Buffer Handling, Commands 4110@node Mapping
4116@section Mapping 4111@section Mapping
4117 4112
4118@cindex key bindings 4113@cindex key bindings
@@ -4179,7 +4174,7 @@ Show contents of register.
4179@findex @kbd{:unmap!@: <char>} 4174@findex @kbd{:unmap!@: <char>}
4180@findex @kbd{:map!@: <char> <seq>} 4175@findex @kbd{:map!@: <char> <seq>}
4181 4176
4182@node Shell Commands, Options, Mapping, Commands 4177@node Shell Commands
4183@section Shell Commands 4178@section Shell Commands
4184 4179
4185@cindex % (Current file) 4180@cindex % (Current file)
@@ -4245,7 +4240,7 @@ Run the make command in the current directory.
4245@findex @kbd{:sh} 4240@findex @kbd{:sh}
4246@findex @kbd{:make} 4241@findex @kbd{:make}
4247 4242
4248@node Options,Emacs Related Commands,Shell Commands,Commands 4243@node Options
4249@section Options 4244@section Options
4250 4245
4251@cindex Vi options 4246@cindex Vi options
@@ -4254,7 +4249,7 @@ Run the make command in the current directory.
4254@item autoindent 4249@item autoindent
4255@itemx ai 4250@itemx ai
4256@cindex autoindent 4251@cindex autoindent
4257autoindent -- In append mode after a <cr> the 4252autoindent: In append mode after a <cr> the
4258cursor will move directly below the first 4253cursor will move directly below the first
4259character on the previous line. 4254character on the previous line.
4260This setting affects the current buffer only. 4255This setting affects the current buffer only.
@@ -4270,7 +4265,7 @@ Cancel autoindent-global.
4270@item ignorecase 4265@item ignorecase
4271@itemx ic 4266@itemx ic
4272@cindex case and searching 4267@cindex case and searching
4273ignorecase -- No distinction between upper and lower cases when searching. 4268ignorecase: No distinction between upper and lower cases when searching.
4274@item noignorecase 4269@item noignorecase
4275@itemx noic 4270@itemx noic
4276Cancel ignorecase. 4271Cancel ignorecase.
@@ -4284,7 +4279,7 @@ Cancel magic.
4284@item readonly 4279@item readonly
4285@itemx ro 4280@itemx ro
4286@cindex readonly files 4281@cindex readonly files
4287readonly -- The file is not to be changed. 4282readonly: The file is not to be changed.
4288If the user attempts to write to this file, confirmation will be requested. 4283If the user attempts to write to this file, confirmation will be requested.
4289@item noreadonly 4284@item noreadonly
4290@itemx noro 4285@itemx noro
@@ -4292,18 +4287,18 @@ Cancel readonly.
4292@item shell=<string> 4287@item shell=<string>
4293@itemx sh=<string> 4288@itemx sh=<string>
4294@cindex shell 4289@cindex shell
4295shell -- The program to be used for shell escapes 4290shell: The program to be used for shell escapes
4296(default @samp{$SHELL} (default @file{/bin/sh})). 4291(default @samp{$SHELL} (default @file{/bin/sh})).
4297@item shiftwidth=<count> 4292@item shiftwidth=<count>
4298@itemx sw=<count> 4293@itemx sw=<count>
4299@cindex layout 4294@cindex layout
4300@cindex shifting text 4295@cindex shifting text
4301shiftwidth -- Gives the shiftwidth (default 8 positions). 4296shiftwidth: Gives the shiftwidth (default 8 positions).
4302@item showmatch 4297@item showmatch
4303@itemx sm 4298@itemx sm
4304@cindex paren matching 4299@cindex paren matching
4305@cindex matching parens 4300@cindex matching parens
4306showmatch -- Whenever you append a @kbd{)}, Vi shows 4301showmatch: Whenever you append a @kbd{)}, Vi shows
4307its match if it's on the same page; also with 4302its match if it's on the same page; also with
4308@kbd{@{} and @kbd{@}}. If there's no match, Vi will beep. 4303@kbd{@{} and @kbd{@}}. If there's no match, Vi will beep.
4309@item noshowmatch 4304@item noshowmatch
@@ -4313,7 +4308,7 @@ Cancel showmatch.
4313@itemx ts=<count> 4308@itemx ts=<count>
4314@cindex changing tab width 4309@cindex changing tab width
4315@cindex tabbing 4310@cindex tabbing
4316tabstop -- The length of a <ht>; warning: this is 4311tabstop: The length of a <ht>; warning: this is
4317only IN the editor, outside of it <ht>s have 4312only IN the editor, outside of it <ht>s have
4318their normal length (default 8 positions). 4313their normal length (default 8 positions).
4319This setting affects the current buffer only. 4314This setting affects the current buffer only.
@@ -4324,13 +4319,13 @@ Same as `tabstop', but affects all buffers.
4324@itemx wm=<count> 4319@itemx wm=<count>
4325@cindex auto fill 4320@cindex auto fill
4326@cindex word wrap 4321@cindex word wrap
4327wrapmargin -- In append mode Vi automatically 4322wrapmargin: In append mode Vi automatically
4328puts a <lf> whenever there is a <sp> or <ht> 4323puts a <lf> whenever there is a <sp> or <ht>
4329within <wm> columns from the right margin. 4324within <wm> columns from the right margin.
4330@item wrapscan 4325@item wrapscan
4331@itemx ws 4326@itemx ws
4332@cindex searching 4327@cindex searching
4333wrapscan -- When searching, the end is 4328wrapscan: When searching, the end is
4334considered @samp{stuck} to the begin of the file. 4329considered @samp{stuck} to the begin of the file.
4335@item nowrapscan 4330@item nowrapscan
4336@itemx nows 4331@itemx nows
@@ -4366,7 +4361,7 @@ Set <option> to <value>.
4366@findex @kbd{:set ai} 4361@findex @kbd{:set ai}
4367@findex @kbd{:set autoindent} 4362@findex @kbd{:set autoindent}
4368 4363
4369@node Emacs Related Commands,,Options,Commands 4364@node Emacs Related Commands
4370@section Emacs Related Commands 4365@section Emacs Related Commands
4371 4366
4372@table @kbd 4367@table @kbd
@@ -4416,7 +4411,7 @@ you need.
4416@kindex @kbd{C-\} 4411@kindex @kbd{C-\}
4417@kindex @kbd{C-c\} 4412@kindex @kbd{C-c\}
4418 4413
4419@node Mouse-bound Commands,,,Commands 4414@node Mouse-bound Commands
4420@section Mouse-bound Commands 4415@section Mouse-bound Commands
4421 4416
4422The following two mouse actions are normally bound to special search and 4417The following two mouse actions are normally bound to special search and
@@ -4445,8 +4440,11 @@ already bound to something else.
4445@kindex @kbd{meta button1up} 4440@kindex @kbd{meta button1up}
4446@kindex @kbd{meta button2up} 4441@kindex @kbd{meta button2up}
4447 4442
4448@node Acknowledgments,,,Top 4443@node GNU Free Documentation License
4449@comment node-name, next, previous, up 4444@appendix GNU Free Documentation License
4445@include doclicense.texi
4446
4447@node Acknowledgments
4450@unnumbered Acknowledgments 4448@unnumbered Acknowledgments
4451 4449
4452Viper, formerly known as VIP-19, was written by Michael Kifer. Viper is 4450Viper, formerly known as VIP-19, was written by Michael Kifer. Viper is
@@ -4520,36 +4518,27 @@ whicken@@dragon.parasoft.com (Wendell Hicken),
4520zapman@@cc.gatech.edu (Jason Zapman II), 4518zapman@@cc.gatech.edu (Jason Zapman II),
4521@end example 4519@end example
4522 4520
4523@node GNU Free Documentation License,,, Top 4521@node Key Index
4524@appendix GNU Free Documentation License
4525@include doclicense.texi
4526
4527@node Key Index,Function Index,,Top
4528@comment node-name, next, previous, up
4529@unnumbered Key Index 4522@unnumbered Key Index
4530 4523
4531@printindex ky 4524@printindex ky
4532 4525
4533@node Function Index,Variable Index,Key Index,Top 4526@node Function Index
4534@comment node-name, next, previous, up
4535@unnumbered Function Index 4527@unnumbered Function Index
4536 4528
4537@printindex fn 4529@printindex fn
4538 4530
4539@node Variable Index,Package Index,Function Index,Top 4531@node Variable Index
4540@comment node-name, next, previous, up
4541@unnumbered Variable Index 4532@unnumbered Variable Index
4542 4533
4543@printindex vr 4534@printindex vr
4544 4535
4545@node Package Index,Concept Index,Variable Index,Top 4536@node Package Index
4546@comment node-name, next, previous, up
4547@unnumbered Package Index 4537@unnumbered Package Index
4548 4538
4549@printindex pg 4539@printindex pg
4550 4540
4551@node Concept Index,,Package Index,Top 4541@node Concept Index
4552@comment node-name, next, previous, up
4553@unnumbered Concept Index 4542@unnumbered Concept Index
4554 4543
4555@printindex cp 4544@printindex cp
diff --git a/doc/misc/widget.texi b/doc/misc/widget.texi
index 4152b52250c..f2c403a2c14 100644
--- a/doc/misc/widget.texi
+++ b/doc/misc/widget.texi
@@ -8,7 +8,7 @@
8@c %**end of header 8@c %**end of header
9 9
10@copying 10@copying
11Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. 11Copyright @copyright{} 2000--2013 Free Software Foundation, Inc.
12 12
13@quotation 13@quotation
14Permission is granted to copy, distribute and/or modify this document 14Permission is granted to copy, distribute and/or modify this document
@@ -19,8 +19,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
19is included in the section entitled ``GNU Free Documentation License''. 19is included in the section entitled ``GNU Free Documentation License''.
20 20
21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 21(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
22modify this GNU manual. Buying copies from the FSF supports it in 22modify this GNU manual.''
23developing GNU and promoting software freedom.''
24@end quotation 23@end quotation
25@end copying 24@end copying
26 25
@@ -32,8 +31,7 @@ developing GNU and promoting software freedom.''
32 31
33@contents 32@contents
34 33
35@node Top, Introduction, (dir), (dir) 34@node Top
36@comment node-name, next, previous, up
37@top The Emacs Widget Library 35@top The Emacs Widget Library
38 36
39@insertcopying 37@insertcopying
@@ -55,9 +53,8 @@ developing GNU and promoting software freedom.''
55* Index:: 53* Index::
56@end menu 54@end menu
57 55
58@node Introduction, User Interface, Top, Top 56@node Introduction
59@comment node-name, next, previous, up 57@chapter Introduction
60@section Introduction
61 58
62Most graphical user interface toolkits provide a number of standard 59Most graphical user interface toolkits provide a number of standard
63user interface controls (sometimes known as `widgets' or `gadgets'). 60user interface controls (sometimes known as `widgets' or `gadgets').
@@ -136,9 +133,8 @@ extended to use the GUI features. This means that your code using the
136widget library will also use the new graphic features automatically. 133widget library will also use the new graphic features automatically.
137@end enumerate 134@end enumerate
138 135
139@node User Interface, Programming Example, Introduction, Top 136@node User Interface
140@comment node-name, next, previous, up 137@chapter User Interface
141@section User Interface
142 138
143A form consists of read only text for documentation and some fields, 139A form consists of read only text for documentation and some fields,
144where each field contains two parts, a tag and a value. The tags are 140where each field contains two parts, a tag and a value. The tags are
@@ -184,7 +180,7 @@ The top level widgets in this example are tagged @samp{Name},
184within a form, namely editing the editable text fields and activating 180within a form, namely editing the editable text fields and activating
185the buttons. 181the buttons.
186 182
187@subsection Editable Text Fields 183@section Editable Text Fields
188 184
189In the example, the value for the @samp{Name} is most likely displayed 185In the example, the value for the @samp{Name} is most likely displayed
190in an editable text field, and so are values for each of the members of 186in an editable text field, and so are values for each of the members of
@@ -221,7 +217,7 @@ The editing text fields are highlighted with the
221Face used for other editing fields. 217Face used for other editing fields.
222@end deffn 218@end deffn
223 219
224@subsection Buttons 220@section Buttons
225 221
226@cindex widget buttons 222@cindex widget buttons
227@cindex button widgets 223@cindex button widgets
@@ -292,7 +288,7 @@ Face used for highlighting a button when the mouse pointer moves across
292it. 288it.
293@end defopt 289@end defopt
294 290
295@subsection Navigation 291@section Navigation
296 292
297You can use all the normal Emacs commands to move around in a form 293You can use all the normal Emacs commands to move around in a form
298buffer, plus you will have these additional commands: 294buffer, plus you will have these additional commands:
@@ -309,9 +305,8 @@ Move point @var{count} buttons or editing fields backward.
309@end deffn 305@end deffn
310@end table 306@end table
311 307
312@node Programming Example, Setting Up the Buffer, User Interface, Top 308@node Programming Example
313@comment node-name, next, previous, up 309@chapter Programming Example
314@section Programming Example
315 310
316@cindex widgets, programming example 311@cindex widgets, programming example
317@cindex example of using widgets 312@cindex example of using widgets
@@ -365,13 +360,14 @@ Interface}).
365 (setq widget-example-repeat 360 (setq widget-example-repeat
366 (widget-create 'editable-list 361 (widget-create 'editable-list
367 :entry-format "%i %d %v" 362 :entry-format "%i %d %v"
368 :notify (lambda (widget &rest ignore) 363 :notify
369 (let ((old (widget-get widget 364 (lambda (widget &rest ignore)
370 ':example-length)) 365 (let ((old (widget-get widget
371 (new (length (widget-value widget)))) 366 ':example-length))
372 (unless (eq old new) 367 (new (length (widget-value widget))))
373 (widget-put widget ':example-length new) 368 (unless (eq old new)
374 (message "You can count to %d." new)))) 369 (widget-put widget ':example-length new)
370 (message "You can count to %d." new))))
375 :value '("One" "Eh, two?" "Five!") 371 :value '("One" "Eh, two?" "Five!")
376 '(editable-field :value "three"))) 372 '(editable-field :value "three")))
377 (widget-insert "\n\nSelect multiple:\n\n") 373 (widget-insert "\n\nSelect multiple:\n\n")
@@ -388,11 +384,13 @@ Interface}).
388 :notify (lambda (widget &rest ignore) 384 :notify (lambda (widget &rest ignore)
389 (message "You selected %s" 385 (message "You selected %s"
390 (widget-value widget))) 386 (widget-value widget)))
391 '(item "One") '(item "Another One.") '(item "A Final One.")) 387 '(item "One") '(item "Another One.")
388 '(item "A Final One."))
392 (widget-insert "\n") 389 (widget-insert "\n")
393 (widget-create 'push-button 390 (widget-create 'push-button
394 :notify (lambda (&rest ignore) 391 :notify (lambda (&rest ignore)
395 (if (= (length (widget-value widget-example-repeat)) 392 (if (= (length
393 (widget-value widget-example-repeat))
396 3) 394 3)
397 (message "Congratulation!") 395 (message "Congratulation!")
398 (error "Three was the count!"))) 396 (error "Three was the count!")))
@@ -407,9 +405,8 @@ Interface}).
407 (widget-setup)) 405 (widget-setup))
408@end lisp 406@end lisp
409 407
410@node Setting Up the Buffer, Basic Types, Programming Example, Top 408@node Setting Up the Buffer
411@comment node-name, next, previous, up 409@chapter Setting Up the Buffer
412@section Setting Up the Buffer
413 410
414Widgets are created with @code{widget-create}, which returns a 411Widgets are created with @code{widget-create}, which returns a
415@dfn{widget} object. This object can be queried and manipulated by 412@dfn{widget} object. This object can be queried and manipulated by
@@ -461,9 +458,8 @@ Keymap used by @code{widget-button-press} and @code{widget-button-click}
461when not on a button. By default this is @code{global-map}. 458when not on a button. By default this is @code{global-map}.
462@end defvar 459@end defvar
463 460
464@node Basic Types, Sexp Types, Setting Up the Buffer, Top 461@node Basic Types
465@comment node-name, next, previous, up 462@chapter Basic Types
466@section Basic Types
467 463
468This is the general syntax of a type specification: 464This is the general syntax of a type specification:
469 465
@@ -704,9 +700,8 @@ If non-@code{nil}, allow glyphs to appear on displays where they are supported.
704* group:: 700* group::
705@end menu 701@end menu
706 702
707@node link, url-link, Basic Types, Basic Types 703@node link
708@comment node-name, next, previous, up 704@section The @code{link} Widget
709@subsection The @code{link} Widget
710@findex link@r{ widget} 705@findex link@r{ widget}
711 706
712Syntax: 707Syntax:
@@ -729,9 +724,8 @@ String to prefix links.
729String to suffix links. 724String to suffix links.
730@end defopt 725@end defopt
731 726
732@node url-link, info-link, link, Basic Types 727@node url-link
733@comment node-name, next, previous, up 728@section The @code{url-link} Widget
734@subsection The @code{url-link} Widget
735@findex url-link@r{ widget} 729@findex url-link@r{ widget}
736 730
737Syntax: 731Syntax:
@@ -744,9 +738,8 @@ Syntax:
744When this link is invoked, the @acronym{WWW} browser specified by 738When this link is invoked, the @acronym{WWW} browser specified by
745@code{browse-url-browser-function} will be called with @var{url}. 739@code{browse-url-browser-function} will be called with @var{url}.
746 740
747@node info-link, push-button, url-link, Basic Types 741@node info-link
748@comment node-name, next, previous, up 742@section The @code{info-link} Widget
749@subsection The @code{info-link} Widget
750@findex info-link@r{ widget} 743@findex info-link@r{ widget}
751 744
752Syntax: 745Syntax:
@@ -758,9 +751,8 @@ Syntax:
758When this link is invoked, the built-in Info reader is started on 751When this link is invoked, the built-in Info reader is started on
759@var{address}. 752@var{address}.
760 753
761@node push-button, editable-field, info-link, Basic Types 754@node push-button
762@comment node-name, next, previous, up 755@section The @code{push-button} Widget
763@subsection The @code{push-button} Widget
764@findex push-button@r{ widget} 756@findex push-button@r{ widget}
765 757
766Syntax: 758Syntax:
@@ -783,9 +775,8 @@ String to prefix push buttons.
783String to suffix push buttons. 775String to suffix push buttons.
784@end defopt 776@end defopt
785 777
786@node editable-field, text, push-button, Basic Types 778@node editable-field
787@comment node-name, next, previous, up 779@section The @code{editable-field} Widget
788@subsection The @code{editable-field} Widget
789@findex editable-field@r{ widget} 780@findex editable-field@r{ widget}
790 781
791Syntax: 782Syntax:
@@ -833,9 +824,8 @@ them. Pressing @key{RET} invokes the function specified by
833@code{:action}. 824@code{:action}.
834@end table 825@end table
835 826
836@node text, menu-choice, editable-field, Basic Types 827@node text
837@comment node-name, next, previous, up 828@section The @code{text} Widget
838@subsection The @code{text} Widget
839@findex text@r{ widget} 829@findex text@r{ widget}
840 830
841@vindex widget-text-keymap 831@vindex widget-text-keymap
@@ -843,9 +833,8 @@ This is just like @code{editable-field}, but intended for multiline text
843fields. The default @code{:keymap} is @code{widget-text-keymap}, which 833fields. The default @code{:keymap} is @code{widget-text-keymap}, which
844does not rebind the @key{RET} key. 834does not rebind the @key{RET} key.
845 835
846@node menu-choice, radio-button-choice, text, Basic Types 836@node menu-choice
847@comment node-name, next, previous, up 837@section The @code{menu-choice} Widget
848@subsection The @code{menu-choice} Widget
849@findex menu-choice@r{ widget} 838@findex menu-choice@r{ widget}
850 839
851Syntax: 840Syntax:
@@ -884,9 +873,8 @@ The current chosen type.
884The list of types. 873The list of types.
885@end table 874@end table
886 875
887@node radio-button-choice, item, menu-choice, Basic Types 876@node radio-button-choice
888@comment node-name, next, previous, up 877@section The @code{radio-button-choice} Widget
889@subsection The @code{radio-button-choice} Widget
890@findex radio-button-choice@r{ widget} 878@findex radio-button-choice@r{ widget}
891 879
892Syntax: 880Syntax:
@@ -951,9 +939,8 @@ Please note that such items added after the @code{radio-button-choice}
951widget has been created will @strong{not} be properly destructed when 939widget has been created will @strong{not} be properly destructed when
952you call @code{widget-delete}. 940you call @code{widget-delete}.
953 941
954@node item, choice-item, radio-button-choice, Basic Types 942@node item
955@comment node-name, next, previous, up 943@section The @code{item} Widget
956@subsection The @code{item} Widget
957@findex item@r{ widget} 944@findex item@r{ widget}
958 945
959Syntax: 946Syntax:
@@ -966,9 +953,8 @@ The @var{value}, if present, is used to initialize the @code{:value}
966property. The value should be a string, which will be inserted in the 953property. The value should be a string, which will be inserted in the
967buffer. This widget will only match the specified value. 954buffer. This widget will only match the specified value.
968 955
969@node choice-item, toggle, item, Basic Types 956@node choice-item
970@comment node-name, next, previous, up 957@section The @code{choice-item} Widget
971@subsection The @code{choice-item} Widget
972@findex choice-item@r{ widget} 958@findex choice-item@r{ widget}
973 959
974Syntax: 960Syntax:
@@ -983,9 +969,8 @@ buffer as a button. Activating the button of a @code{choice-item} is
983equivalent to activating the parent widget. This widget will only match 969equivalent to activating the parent widget. This widget will only match
984the specified value. 970the specified value.
985 971
986@node toggle, checkbox, choice-item, Basic Types 972@node toggle
987@comment node-name, next, previous, up 973@section The @code{toggle} Widget
988@subsection The @code{toggle} Widget
989@findex toggle@r{ widget} 974@findex toggle@r{ widget}
990 975
991Syntax: 976Syntax:
@@ -1016,9 +1001,8 @@ Name of a glyph to be used instead of the @samp{:off} text string, on
1016emacsen that supports this. 1001emacsen that supports this.
1017@end table 1002@end table
1018 1003
1019@node checkbox, checklist, toggle, Basic Types 1004@node checkbox
1020@comment node-name, next, previous, up 1005@section The @code{checkbox} Widget
1021@subsection The @code{checkbox} Widget
1022@findex checkbox@r{ widget} 1006@findex checkbox@r{ widget}
1023 1007
1024This widget has two possible states, @samp{selected} and 1008This widget has two possible states, @samp{selected} and
@@ -1030,9 +1014,8 @@ Syntax:
1030@var{type} ::= (checkbox [@var{keyword} @var{argument}]...) 1014@var{type} ::= (checkbox [@var{keyword} @var{argument}]...)
1031@end example 1015@end example
1032 1016
1033@node checklist, editable-list, checkbox, Basic Types 1017@node checklist
1034@comment node-name, next, previous, up 1018@section The @code{checklist} Widget
1035@subsection The @code{checklist} Widget
1036@findex checklist@r{ widget} 1019@findex checklist@r{ widget}
1037 1020
1038Syntax: 1021Syntax:
@@ -1088,9 +1071,8 @@ The widgets representing each type.
1088The list of types. 1071The list of types.
1089@end table 1072@end table
1090 1073
1091@node editable-list, group, checklist, Basic Types 1074@node editable-list
1092@comment node-name, next, previous, up 1075@section The @code{editable-list} Widget
1093@subsection The @code{editable-list} Widget
1094@findex editable-list@r{ widget} 1076@findex editable-list@r{ widget}
1095 1077
1096Syntax: 1078Syntax:
@@ -1146,9 +1128,8 @@ The widgets representing the elements of the list.
1146List whose @sc{car} is the type of the list elements. 1128List whose @sc{car} is the type of the list elements.
1147@end table 1129@end table
1148 1130
1149@node group, , editable-list, Basic Types 1131@node group
1150@comment node-name, next, previous, up 1132@section The @code{group} Widget
1151@subsection The @code{group} Widget
1152@findex group@r{ widget} 1133@findex group@r{ widget}
1153 1134
1154This widget simply group other widgets together. 1135This widget simply group other widgets together.
@@ -1161,9 +1142,8 @@ Syntax:
1161 1142
1162The value is a list, with one member for each @var{type}. 1143The value is a list, with one member for each @var{type}.
1163 1144
1164@node Sexp Types, Widget Properties, Basic Types, Top 1145@node Sexp Types
1165@comment 1146@chapter Sexp Types
1166@section Sexp Types
1167@cindex sexp types 1147@cindex sexp types
1168 1148
1169A number of widgets for editing @dfn{s-expressions} (Lisp types), sexp 1149A number of widgets for editing @dfn{s-expressions} (Lisp types), sexp
@@ -1177,9 +1157,8 @@ categories described in this section.
1177* composite:: 1157* composite::
1178@end menu 1158@end menu
1179 1159
1180@node constants, generic, Sexp Types, Sexp Types 1160@node constants
1181@comment node-name, next, previous, up 1161@section The Constant Widgets
1182@subsection The Constant Widgets
1183@cindex constant widgets 1162@cindex constant widgets
1184 1163
1185The @code{const} widget can contain any Lisp expression, but the user is 1164The @code{const} widget can contain any Lisp expression, but the user is
@@ -1214,9 +1193,8 @@ An immutable symbol that is bound as a variable.
1214An immutable symbol that is bound as a function. 1193An immutable symbol that is bound as a function.
1215@end deffn 1194@end deffn
1216 1195
1217@node generic, atoms, constants, Sexp Types 1196@node generic
1218@comment node-name, next, previous, up 1197@section Generic Sexp Widget
1219@subsection Generic Sexp Widget
1220@cindex generic sexp widget 1198@cindex generic sexp widget
1221 1199
1222The @code{sexp} widget can contain any Lisp expression, and allows the 1200The @code{sexp} widget can contain any Lisp expression, and allows the
@@ -1236,9 +1214,8 @@ The @code{sexp} widget takes the same keyword arguments as the
1236@code{editable-field} widget. @xref{editable-field}. 1214@code{editable-field} widget. @xref{editable-field}.
1237@end deffn 1215@end deffn
1238 1216
1239@node atoms, composite, generic, Sexp Types 1217@node atoms
1240@comment node-name, next, previous, up 1218@section Atomic Sexp Widgets
1241@subsection Atomic Sexp Widgets
1242@cindex atomic sexp widget 1219@cindex atomic sexp widget
1243 1220
1244The atoms are s-expressions that do not consist of other s-expressions. 1221The atoms are s-expressions that do not consist of other s-expressions.
@@ -1314,9 +1291,8 @@ either @code{nil} meaning false, or non-@code{nil} meaning true.
1314@end deffn 1291@end deffn
1315 1292
1316 1293
1317@node composite, , atoms, Sexp Types 1294@node composite
1318@comment node-name, next, previous, up 1295@section Composite Sexp Widgets
1319@subsection Composite Sexp Widgets
1320@cindex composite sexp widgets 1296@cindex composite sexp widgets
1321 1297
1322The syntax for the composite widget construct is: 1298The syntax for the composite widget construct is:
@@ -1416,9 +1392,8 @@ Specifies a list of any number of elements that fit a certain type.
1416@end example 1392@end example
1417@end deffn 1393@end deffn
1418 1394
1419@node Widget Properties, Defining New Widgets, Sexp Types, Top 1395@node Widget Properties
1420@comment node-name, next, previous, up 1396@chapter Properties
1421@section Properties
1422@cindex properties of widgets 1397@cindex properties of widgets
1423@cindex widget properties 1398@cindex widget properties
1424 1399
@@ -1511,9 +1486,8 @@ its ancestors have been deactivated. Do not attempt to set the
1511@code{:deactivate} keywords instead. 1486@code{:deactivate} keywords instead.
1512 1487
1513 1488
1514@node Defining New Widgets, Widget Browser, Widget Properties, Top 1489@node Defining New Widgets
1515@comment node-name, next, previous, up 1490@chapter Defining New Widgets
1516@section Defining New Widgets
1517@cindex new widgets 1491@cindex new widgets
1518@cindex defining new widgets 1492@cindex defining new widgets
1519 1493
@@ -1696,9 +1670,8 @@ It provides most of the functionality that is referred to as ``by
1696default'' in this text. 1670default'' in this text.
1697@end deffn 1671@end deffn
1698 1672
1699@node Widget Browser, Widget Minor Mode, Defining New Widgets, Top 1673@node Widget Browser
1700@comment node-name, next, previous, up 1674@chapter Widget Browser
1701@section Widget Browser
1702@cindex widget browser 1675@cindex widget browser
1703 1676
1704There is a separate package to browse widgets. This is intended to help 1677There is a separate package to browse widgets. This is intended to help
@@ -1721,9 +1694,8 @@ Create a widget browser for the widget at @var{pos}.
1721When called interactively, use the position of point. 1694When called interactively, use the position of point.
1722@end deffn 1695@end deffn
1723 1696
1724@node Widget Minor Mode, Utilities, Widget Browser, Top 1697@node Widget Minor Mode
1725@comment node-name, next, previous, up 1698@chapter Widget Minor Mode
1726@section Widget Minor Mode
1727@cindex widget minor mode 1699@cindex widget minor mode
1728 1700
1729There is a minor mode for manipulating widgets in major modes that 1701There is a minor mode for manipulating widgets in major modes that
@@ -1739,9 +1711,8 @@ With arg, turn widget mode on if and only if arg is positive.
1739Keymap used in @code{widget-minor-mode}. 1711Keymap used in @code{widget-minor-mode}.
1740@end defvar 1712@end defvar
1741 1713
1742@node Utilities, Widget Wishlist, Widget Minor Mode, Top 1714@node Utilities
1743@comment node-name, next, previous, up 1715@chapter Utilities
1744@section Utilities.
1745@cindex utility functions for widgets 1716@cindex utility functions for widgets
1746 1717
1747@defun widget-prompt-value widget prompt [ value unbound ] 1718@defun widget-prompt-value widget prompt [ value unbound ]
@@ -1755,9 +1726,8 @@ Get the item which @var{widget} is assumed to toggle.
1755This is only meaningful for radio buttons or checkboxes in a list. 1726This is only meaningful for radio buttons or checkboxes in a list.
1756@end defun 1727@end defun
1757 1728
1758@node Widget Wishlist, GNU Free Documentation License, Utilities, Top 1729@node Widget Wishlist
1759@comment node-name, next, previous, up 1730@chapter Wishlist
1760@section Wishlist
1761@cindex todo 1731@cindex todo
1762 1732
1763@itemize @bullet 1733@itemize @bullet
@@ -1814,12 +1784,11 @@ See @code{TeX-printer-list} for an explanation.
1814Add a @code{mailto} widget. 1784Add a @code{mailto} widget.
1815@end itemize 1785@end itemize
1816 1786
1817@node GNU Free Documentation License, Index, Widget Wishlist, Top 1787@node GNU Free Documentation License
1818@appendix GNU Free Documentation License 1788@appendix GNU Free Documentation License
1819@include doclicense.texi 1789@include doclicense.texi
1820 1790
1821@node Index, , GNU Free Documentation License, Top 1791@node Index
1822@comment node-name, next, previous, up
1823@unnumbered Index 1792@unnumbered Index
1824 1793
1825This is an alphabetical listing of all concepts, functions, commands, 1794This is an alphabetical listing of all concepts, functions, commands,
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi
index 5c04631e3c7..d8557b84a4f 100644
--- a/doc/misc/wisent.texi
+++ b/doc/misc/wisent.texi
@@ -23,7 +23,7 @@
23@c %**end of header 23@c %**end of header
24 24
25@copying 25@copying
26Copyright @copyright{} 1988-1993, 1995, 1998-2004, 2007, 2012 26Copyright @copyright{} 1988--1993, 1995, 1998--2004, 2007, 2012--2013
27Free Software Foundation, Inc. 27Free Software Foundation, Inc.
28 28
29@c Since we are both GNU manuals, we do not need to ack each other here. 29@c Since we are both GNU manuals, we do not need to ack each other here.
@@ -43,8 +43,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
43is included in the section entitled ``GNU Free Documentation License''. 43is included in the section entitled ``GNU Free Documentation License''.
44 44
45(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 45(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
46modify this GNU manual. Buying copies from the FSF supports it in 46modify this GNU manual.''
47developing GNU and promoting software freedom.''
48@end quotation 47@end quotation
49@end copying 48@end copying
50 49
@@ -113,7 +112,7 @@ of the GNU Compiler Compiler Bison. Its code is a port of the C code
113of GNU Bison 1.28 & 1.31. 112of GNU Bison 1.28 & 1.31.
114 113
115For more details on the basic concepts for understanding Wisent, it is 114For more details on the basic concepts for understanding Wisent, it is
116worthwhile to read the @ref{Top, Bison Manual, bison}. 115worthwhile to read the @ref{Top, Bison Manual, , bison}.
117@ifhtml 116@ifhtml
118@uref{http://www.gnu.org/manual/bison/html_node/index.html}. 117@uref{http://www.gnu.org/manual/bison/html_node/index.html}.
119@end ifhtml 118@end ifhtml
@@ -226,8 +225,7 @@ in between, can be combined into a larger grouping of type @samp{exp}.
226* Conflicts:: 225* Conflicts::
227@end menu 226@end menu
228 227
229@node Grammar format, Example, Wisent Grammar, Wisent Grammar 228@node Grammar format
230@comment node-name, next, previous, up
231@section Grammar format 229@section Grammar format
232 230
233@cindex grammar format 231@cindex grammar format
@@ -304,7 +302,7 @@ If @var{components} in a rule is @code{nil}, it means that the rule
304can match the empty string. For example, here is how to define a 302can match the empty string. For example, here is how to define a
305comma-separated sequence of zero or more @samp{exp} groupings: 303comma-separated sequence of zero or more @samp{exp} groupings:
306 304
307@example 305@smallexample
308@group 306@group
309(expseq (nil) ;; expseq: ;; empty 307(expseq (nil) ;; expseq: ;; empty
310 ((expseq1)) ;; | expseq1 308 ((expseq1)) ;; | expseq1
@@ -314,7 +312,7 @@ comma-separated sequence of zero or more @samp{exp} groupings:
314 ((expseq1 ?, exp)) ;; | expseq1 ',' exp 312 ((expseq1 ?, exp)) ;; | expseq1 ',' exp
315 ) ;; ; 313 ) ;; ;
316@end group 314@end group
317@end example 315@end smallexample
318 316
319@cindex precedence level 317@cindex precedence level
320@item precedence 318@item precedence
@@ -341,7 +339,7 @@ serves to stand for its precedence:
341 339
342Now the precedence of @code{UMINUS} can be used in specific rules: 340Now the precedence of @code{UMINUS} can be used in specific rules:
343 341
344@example 342@smallexample
345@group 343@group
346(exp @dots{} ;; exp: @dots{} 344(exp @dots{} ;; exp: @dots{}
347 ((exp ?- exp)) ;; | exp '-' exp 345 ((exp ?- exp)) ;; | exp '-' exp
@@ -350,7 +348,7 @@ Now the precedence of @code{UMINUS} can be used in specific rules:
350 @dots{} ;; @dots{} 348 @dots{} ;; @dots{}
351 ) ;; ; 349 ) ;; ;
352@end group 350@end group
353@end example 351@end smallexample
354 352
355If you forget to append @code{[UMINUS]} to the rule for unary minus, 353If you forget to append @code{[UMINUS]} to the rule for unary minus,
356Wisent silently assumes that minus has its usual precedence. This 354Wisent silently assumes that minus has its usual precedence. This
@@ -445,8 +443,7 @@ matching the empty string, for which the default action is to return
445@end table 443@end table
446@end table 444@end table
447 445
448@node Example, Compiling a grammar, Grammar format, Wisent Grammar 446@node Example
449@comment node-name, next, previous, up
450@section Example 447@section Example
451 448
452@cindex grammar example 449@cindex grammar example
@@ -561,8 +558,7 @@ exp:
561@end group 558@end group
562@end example 559@end example
563 560
564@node Compiling a grammar, Conflicts, Example, Wisent Grammar 561@node Compiling a grammar
565@comment node-name, next, previous, up
566@section Compiling a grammar 562@section Compiling a grammar
567 563
568@cindex automaton 564@cindex automaton
@@ -620,8 +616,7 @@ an Emacs Lisp function (lambda expression).
620@end table 616@end table
621@end defun 617@end defun
622 618
623@node Conflicts, , Compiling a grammar, Wisent Grammar 619@node Conflicts
624@comment node-name, next, previous, up
625@section Conflicts 620@section Conflicts
626 621
627Normally, a grammar should produce an automaton where at each state 622Normally, a grammar should produce an automaton where at each state
@@ -1034,7 +1029,6 @@ state 8
1034 $default reduce using rule 2 (exp) 1029 $default reduce using rule 2 (exp)
1035 1030
1036 1031
1037
1038state 9 1032state 9
1039 1033
1040 exp -> exp . '+' exp (rule 1) 1034 exp -> exp . '+' exp (rule 1)
@@ -1049,7 +1043,6 @@ state 9
1049 $default reduce using rule 3 (exp) 1043 $default reduce using rule 3 (exp)
1050 1044
1051 1045
1052
1053state 10 1046state 10
1054 1047
1055 exp -> exp . '+' exp (rule 1) 1048 exp -> exp . '+' exp (rule 1)
@@ -1610,7 +1603,7 @@ it can be worth a mix of the two styles!
1610* Useful functions:: 1603* Useful functions::
1611@end menu 1604@end menu
1612 1605
1613@node Iterative style, Bison style, Grammar styles, Grammar styles 1606@node Iterative style
1614@subsection Iterative style 1607@subsection Iterative style
1615 1608
1616@cindex grammar iterative style 1609@cindex grammar iterative style
diff --git a/doc/misc/woman.texi b/doc/misc/woman.texi
index 16fb83ad18f..3e4448ed1e0 100644
--- a/doc/misc/woman.texi
+++ b/doc/misc/woman.texi
@@ -2,11 +2,7 @@
2@c %**start of header 2@c %**start of header
3@setfilename ../../info/woman 3@setfilename ../../info/woman
4@settitle WoMan: Browse Unix Manual Pages ``W.O. (without) Man'' 4@settitle WoMan: Browse Unix Manual Pages ``W.O. (without) Man''
5@c FIXME 5@include emacsver.texi
6@c Manual last updated:
7@set UPDATED Time-stamp: <Thu 24-Jun-2010 00:06:54 gm on grasmoor>
8@c Software version:
9@set VERSION 0.54 (beta)
10@afourpaper 6@afourpaper
11@c With different size paper the printed page breaks will need attention! 7@c With different size paper the printed page breaks will need attention!
12@c Look for @page and @need commands. 8@c Look for @page and @need commands.
@@ -18,7 +14,7 @@
18This file documents WoMan: A program to browse Unix manual pages `W.O. 14This file documents WoMan: A program to browse Unix manual pages `W.O.
19(without) man'. 15(without) man'.
20 16
21Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. 17Copyright @copyright{} 2001--2013 Free Software Foundation, Inc.
22 18
23@quotation 19@quotation
24Permission is granted to copy, distribute and/or modify this document 20Permission is granted to copy, distribute and/or modify this document
@@ -29,8 +25,7 @@ and with the Back-Cover Texts as in (a) below. A copy of the license
29is included in the section entitled ``GNU Free Documentation License.'' 25is included in the section entitled ``GNU Free Documentation License.''
30 26
31(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and 27(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
32modify this GNU manual. Buying copies from the FSF supports it in 28modify this GNU manual.''
33developing GNU and promoting software freedom.''
34@end quotation 29@end quotation
35@end copying 30@end copying
36 31
@@ -44,7 +39,7 @@ developing GNU and promoting software freedom.''
44@titlepage 39@titlepage
45@title WoMan 40@title WoMan
46@subtitle Browse Unix Manual Pages ``W.O. (without) Man'' 41@subtitle Browse Unix Manual Pages ``W.O. (without) Man''
47@subtitle Software Version @value{VERSION} 42@subtitle as distributed with Emacs @value{EMACSVER}
48@author Francis J. Wright 43@author Francis J. Wright
49@sp 2 44@sp 2
50@author School of Mathematical Sciences 45@author School of Mathematical Sciences
@@ -54,8 +49,6 @@ developing GNU and promoting software freedom.''
54@author @email{F.J.Wright@@qmul.ac.uk} 49@author @email{F.J.Wright@@qmul.ac.uk}
55@author @uref{http://centaur.maths.qmw.ac.uk/} 50@author @uref{http://centaur.maths.qmw.ac.uk/}
56@c He no longer maintains this manual. 51@c He no longer maintains this manual.
57@sp 2
58@author Manual Last Updated @value{UPDATED}
59 52
60@comment The following two commands start the copyright page. 53@comment The following two commands start the copyright page.
61@page 54@page
@@ -68,13 +61,11 @@ developing GNU and promoting software freedom.''
68@c =================================================================== 61@c ===================================================================
69 62
70@ifnottex 63@ifnottex
71@node Top, Introduction, (dir), (dir) 64@node Top
72@comment node-name, next, previous, up
73@top WoMan: Browse Unix Manual Pages ``W.O. (without) Man'' 65@top WoMan: Browse Unix Manual Pages ``W.O. (without) Man''
74 66
75@display 67@display
76Software Version @value{VERSION} 68As distributed with Emacs @value{EMACSVER}.
77Manual Last Updated @value{UPDATED}
78 69
79@email{F.J.Wright@@qmw.ac.uk, Francis J. Wright} 70@email{F.J.Wright@@qmw.ac.uk, Francis J. Wright}
80@uref{http://centaur.maths.qmw.ac.uk/, School of Mathematical Sciences} 71@uref{http://centaur.maths.qmw.ac.uk/, School of Mathematical Sciences}
@@ -104,8 +95,7 @@ Mile End Road, London E1 4NS, UK
104 95
105@c =================================================================== 96@c ===================================================================
106 97
107@node Introduction, Background, Top, Top 98@node Introduction
108@comment node-name, next, previous, up
109@chapter Introduction 99@chapter Introduction
110@cindex introduction 100@cindex introduction
111 101
@@ -166,8 +156,7 @@ Reporting Bugs}.
166 156
167@c =================================================================== 157@c ===================================================================
168 158
169@node Background, Finding, Introduction, Top 159@node Background
170@comment node-name, next, previous, up
171@chapter Background 160@chapter Background
172@cindex background 161@cindex background
173 162
@@ -296,8 +285,7 @@ be possible to move WoMan from an emulation of @code{nroff} to an
296emulation of @code{troff} as GNU Emacs moves to providing bit-mapped 285emulation of @code{troff} as GNU Emacs moves to providing bit-mapped
297display facilities. 286display facilities.
298 287
299@node Finding, Browsing, Background, Top 288@node Finding
300@comment node-name, next, previous, up
301@chapter Finding and Formatting Man Pages 289@chapter Finding and Formatting Man Pages
302@cindex using, finding man pages 290@cindex using, finding man pages
303@cindex using, formatting man pages 291@cindex using, formatting man pages
@@ -353,8 +341,7 @@ setting WoMan file paths.
353* Automatic:: Automatic Interface 341* Automatic:: Automatic Interface
354@end menu 342@end menu
355 343
356@node Topic, Filename, Finding, Finding 344@node Topic
357@comment node-name, next, previous, up
358@section Topic Interface 345@section Topic Interface
359@cindex topic interface 346@cindex topic interface
360 347
@@ -435,8 +422,7 @@ slow. @xref{Cache, , The WoMan Topic Cache}, for further details.
435* Word at point:: Using the "Word at Point" as a Topic Suggestion 422* Word at point:: Using the "Word at Point" as a Topic Suggestion
436@end menu 423@end menu
437 424
438@node Cache, Word at point, Topic, Topic 425@node Cache
439@comment node-name, next, previous, up
440@subsection The WoMan Topic Cache 426@subsection The WoMan Topic Cache
441@cindex topic cache 427@cindex topic cache
442@cindex cache, topic 428@cindex cache, topic
@@ -470,8 +456,7 @@ automatically update its cache file on disc (if one is in use) the next
470time it is run in a new Emacs session. 456time it is run in a new Emacs session.
471 457
472 458
473@node Word at point, , Cache, Topic 459@node Word at point
474@comment node-name, next, previous, up
475@subsection Using the "Word at Point" as a Topic Suggestion 460@subsection Using the "Word at Point" as a Topic Suggestion
476@cindex word at point 461@cindex word at point
477@cindex point, word at 462@cindex point, word at
@@ -497,8 +482,7 @@ point without seeking confirmation:
497@end lisp 482@end lisp
498 483
499 484
500@node Filename, Automatic, Topic, Finding 485@node Filename
501@comment node-name, next, previous, up
502@section Filename Interface 486@section Filename Interface
503@cindex filename interface 487@cindex filename interface
504 488
@@ -547,8 +531,7 @@ the current buffer if it is visiting a man file, although it is
547primarily used internally by WoMan. 531primarily used internally by WoMan.
548 532
549 533
550@node Automatic, , Filename, Finding 534@node Automatic
551@comment node-name, next, previous, up
552@section Automatic Interface 535@section Automatic Interface
553@cindex automatic interface 536@cindex automatic interface
554 537
@@ -585,8 +568,7 @@ by automatic major mode selection.]
585 568
586@c =================================================================== 569@c ===================================================================
587 570
588@node Browsing, Customization, Finding, Top 571@node Browsing
589@comment node-name, next, previous, up
590@chapter Browsing Man Pages 572@chapter Browsing Man Pages
591@cindex using, browsing man pages 573@cindex using, browsing man pages
592@cindex browsing man pages 574@cindex browsing man pages
@@ -616,8 +598,7 @@ blank lines squeezed to a single blank line.
616* Imenu:: Imenu Support; Contents Menu 598* Imenu:: Imenu Support; Contents Menu
617@end menu 599@end menu
618 600
619@node Fonts, Navigation, Browsing, Browsing 601@node Fonts
620@comment node-name, next, previous, up
621@section Fonts and Faces 602@section Fonts and Faces
622@cindex fonts 603@cindex fonts
623@cindex faces 604@cindex faces
@@ -632,8 +613,7 @@ currently means the characters ^ and _ used to indicate super- and
632sub-scripts, which are not displayed well by WoMan. 613sub-scripts, which are not displayed well by WoMan.
633 614
634 615
635@node Navigation, References, Fonts, Browsing 616@node Navigation
636@comment node-name, next, previous, up
637@section Navigation 617@section Navigation
638@cindex navigation 618@cindex navigation
639 619
@@ -678,8 +658,7 @@ described by @code{Man-see-also-regexp}.
678@end table 658@end table
679 659
680 660
681@node References, Changing, Navigation, Browsing 661@node References
682@comment node-name, next, previous, up
683@section Following References 662@section Following References
684@cindex following references 663@cindex following references
685@cindex references 664@cindex references
@@ -722,8 +701,7 @@ default is based on word at point.
722@end table 701@end table
723 702
724 703
725@node Changing, Convenience, References, Browsing 704@node Changing
726@comment node-name, next, previous, up
727@section Changing the Current Man Page 705@section Changing the Current Man Page
728@cindex changing current man page 706@cindex changing current man page
729@cindex current man page, changing 707@cindex current man page, changing
@@ -790,8 +768,7 @@ Call WoMan to reformat the last man page formatted by WoMan
790@end table 768@end table
791 769
792 770
793@node Convenience, Imenu, Changing, Browsing 771@node Convenience
794@comment node-name, next, previous, up
795@section Convenience Key Bindings 772@section Convenience Key Bindings
796@cindex convenience key bindings 773@cindex convenience key bindings
797@cindex key bindings, convenience 774@cindex key bindings, convenience
@@ -832,8 +809,7 @@ followed by the minor modes, each on a separate page.
832@end table 809@end table
833 810
834 811
835@node Imenu, , Convenience, Browsing 812@node Imenu
836@comment node-name, next, previous, up
837@section Imenu Support; Contents Menu 813@section Imenu Support; Contents Menu
838@cindex imenu support 814@cindex imenu support
839@cindex contents menu 815@cindex contents menu
@@ -853,8 +829,7 @@ is distributed with GNU Emacs.
853 829
854@c =================================================================== 830@c ===================================================================
855 831
856@node Customization, Log, Browsing, Top 832@node Customization
857@comment node-name, next, previous, up
858@chapter Customization 833@chapter Customization
859@cindex customization 834@cindex customization
860 835
@@ -911,8 +886,7 @@ man page.
911* Special symbols:: 886* Special symbols::
912@end menu 887@end menu
913 888
914@node Interface Options, Formatting Options, Customization, Customization 889@node Interface Options
915@comment node-name, next, previous, up
916@section Interface Options 890@section Interface Options
917@cindex interface options 891@cindex interface options
918 892
@@ -1138,8 +1112,7 @@ default value is non-@code{nil}.
1138@end vtable 1112@end vtable
1139 1113
1140 1114
1141@node Formatting Options, Faces, Interface Options, Customization 1115@node Formatting Options
1142@comment node-name, next, previous, up
1143@section Formatting Options 1116@section Formatting Options
1144@cindex formatting options 1117@cindex formatting options
1145 1118
@@ -1182,8 +1155,7 @@ untested.
1182@end vtable 1155@end vtable
1183 1156
1184 1157
1185@node Faces, Special symbols, Formatting Options, Customization 1158@node Faces
1186@comment node-name, next, previous, up
1187@section Faces 1159@section Faces
1188@cindex faces 1160@cindex faces
1189 1161
@@ -1218,8 +1190,7 @@ Default: foreground orange.
1218@end vtable 1190@end vtable
1219 1191
1220 1192
1221@node Special symbols, , Faces, Customization 1193@node Special symbols
1222@comment node-name, next, previous, up
1223@section Special symbols 1194@section Special symbols
1224@cindex special symbols 1195@cindex special symbols
1225 1196
@@ -1256,8 +1227,7 @@ Under MS-Windows, the default is
1256 1227
1257@c =================================================================== 1228@c ===================================================================
1258 1229
1259@node Log, Technical, Customization, Top 1230@node Log
1260@comment node-name, next, previous, up
1261@chapter The *WoMan-Log* Buffer 1231@chapter The *WoMan-Log* Buffer
1262@cindex log buffer 1232@cindex log buffer
1263@cindex buffer, log 1233@cindex buffer, log
@@ -1281,8 +1251,7 @@ left in the formatted buffer to indicate precisely where they occurred.
1281 1251
1282@c =================================================================== 1252@c ===================================================================
1283 1253
1284@node Technical, Bugs, Log, Top 1254@node Technical
1285@comment node-name, next, previous, up
1286@chapter Technical Details 1255@chapter Technical Details
1287@cindex technical details 1256@cindex technical details
1288@cindex horizontal spacing 1257@cindex horizontal spacing
@@ -1306,8 +1275,7 @@ is output.
1306 1275
1307@c =================================================================== 1276@c ===================================================================
1308 1277
1309@node Bugs, Acknowledgments, Technical, Top 1278@node Bugs
1310@comment node-name, next, previous, up
1311@chapter Reporting Bugs 1279@chapter Reporting Bugs
1312@cindex reporting bugs 1280@cindex reporting bugs
1313@cindex bugs, reporting 1281@cindex bugs, reporting
@@ -1331,8 +1299,7 @@ man source file from, but do not send it unless asked to send it.
1331 1299
1332@c =================================================================== 1300@c ===================================================================
1333 1301
1334@node Acknowledgments, GNU Free Documentation License, Bugs, Top 1302@node Acknowledgments
1335@comment node-name, next, previous, up
1336@chapter Acknowledgments 1303@chapter Acknowledgments
1337@cindex acknowledgments 1304@cindex acknowledgments
1338 1305
@@ -1388,18 +1355,16 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il}
1388@page 1355@page
1389 1356
1390 1357
1391@node GNU Free Documentation License, Command Index, Acknowledgments, Top 1358@node GNU Free Documentation License
1392@appendix GNU Free Documentation License 1359@appendix GNU Free Documentation License
1393@include doclicense.texi 1360@include doclicense.texi
1394 1361
1395@node Command Index, Variable Index, GNU Free Documentation License, Top 1362@node Command Index
1396@comment node-name, next, previous, up
1397@unnumbered Command Index 1363@unnumbered Command Index
1398 1364
1399@printindex fn 1365@printindex fn
1400 1366
1401@node Variable Index, Keystroke Index, Command Index, Top 1367@node Variable Index
1402@comment node-name, next, previous, up
1403@unnumbered Variable Index 1368@unnumbered Variable Index
1404 1369
1405@printindex vr 1370@printindex vr
@@ -1410,8 +1375,7 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il}
1410 1375
1411@page 1376@page
1412 1377
1413@node Keystroke Index, Concept Index, Variable Index, Top 1378@node Keystroke Index
1414@comment node-name, next, previous, up
1415@unnumbered Keystroke Index 1379@unnumbered Keystroke Index
1416 1380
1417@printindex ky 1381@printindex ky
@@ -1422,8 +1386,7 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il}
1422 1386
1423@page 1387@page
1424 1388
1425@node Concept Index, , Keystroke Index, Top 1389@node Concept Index
1426@comment node-name, next, previous, up
1427@unnumbered Concept Index 1390@unnumbered Concept Index
1428 1391
1429@printindex cp 1392@printindex cp