diff options
| author | Tom Tromey | 2013-01-05 19:36:45 -0700 |
|---|---|---|
| committer | Tom Tromey | 2013-01-05 19:36:45 -0700 |
| commit | e078a23febca14bc919c5806670479c395e3253e (patch) | |
| tree | e9e4ed91feef744d525264c31974c3ed00146bcd /doc/misc | |
| parent | 63d535c829a930207b64fe733228f15a554644b1 (diff) | |
| parent | 7a2657fa3bedbd977f4e11fe030cb4a210c04ab4 (diff) | |
| download | emacs-e078a23febca14bc919c5806670479c395e3253e.tar.gz emacs-e078a23febca14bc919c5806670479c395e3253e.zip | |
merge from trunk
Diffstat (limited to 'doc/misc')
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 @@ | |||
| 1 | 2013-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 | |||
| 26 | 2013-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 | |||
| 38 | 2013-01-04 Vivek Dasmohapatra <vivek@etla.org> | ||
| 39 | |||
| 40 | * htmlfontify.texi: New file. | ||
| 41 | |||
| 42 | 2013-01-02 Jay Belanger <jay.p.belanger@gmail.com> | ||
| 43 | |||
| 44 | * calc.texi (Free-Form Dates): Expand on the date reading | ||
| 45 | algorithm. | ||
| 46 | |||
| 47 | 2012-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 | |||
| 72 | 2012-12-25 Lars Ingebrigtsen <larsi@gnus.org> | ||
| 73 | |||
| 74 | * gnus.texi (Customizing the IMAP Connection): Mention the other | ||
| 75 | authenticators. | ||
| 76 | |||
| 77 | 2012-12-24 Lars Ingebrigtsen <larsi@gnus.org> | ||
| 78 | |||
| 79 | * gnus.texi (Browse Foreign Server): Document | ||
| 80 | `gnus-browse-delete-group'. | ||
| 81 | |||
| 82 | 2012-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 | |||
| 92 | 2012-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 | |||
| 101 | 2012-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 | |||
| 133 | 2012-12-21 Bastien Guerry <bzg@gnu.org> | ||
| 134 | |||
| 135 | * org.texi: Fix typos. | ||
| 136 | |||
| 137 | 2012-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 | |||
| 1 | 2012-12-16 Jay Belanger <jay.p.belanger@gmail.com> | 142 | 2012-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 | ||
| 438 | 2012-09-30 Bastien Guerry <bzg@altern.org> | 579 | 2012-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 | ||
| 1044 | 2012-04-01 Bastien Guerry <bzg@altern.org> | 1185 | 2012-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. |
| 28 | buildinfodir = $(srcdir)/../../info | 28 | buildinfodir = $(srcdir)/../../info |
| 29 | ## Directory with emacsver.texi. | 29 | ## Directory with emacsver.texi. |
| 30 | ## Currently only used by efaq and calc. | ||
| 31 | emacsdir = $(srcdir)/../emacs | 30 | emacsdir = $(srcdir)/../emacs |
| 32 | 31 | ||
| 33 | MKDIR_P = @MKDIR_P@ | 32 | MKDIR_P = @MKDIR_P@ |
| @@ -44,7 +43,7 @@ MAKEINFO_OPTS = --force -I$(emacsdir) | |||
| 44 | INFO_TARGETS = ada-mode auth autotype bovine calc ccmode cl \ | 43 | INFO_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 | ||
| 171 | mkinfodir = @${MKDIR_P} ${buildinfodir} | 172 | mkinfodir = @${MKDIR_P} ${buildinfodir} |
| 172 | 173 | ||
| 174 | gfdl = ${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 | ||
| 200 | ada-mode : $(buildinfodir)/ada-mode$(INFO_EXT) | 203 | ada-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 |
| 204 | ada-mode.dvi: ${srcdir}/ada-mode.texi | 207 | ada-mode.dvi: ${srcdir}/ada-mode.texi ${gfdl} |
| 205 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ada-mode.texi | 208 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ada-mode.texi |
| 206 | ada-mode.pdf: ${srcdir}/ada-mode.texi | 209 | ada-mode.pdf: ${srcdir}/ada-mode.texi ${gfdl} |
| 207 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ada-mode.texi | 210 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ada-mode.texi |
| 208 | 211 | ||
| 209 | auth : $(buildinfodir)/auth$(INFO_EXT) | 212 | auth : $(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 |
| 213 | auth.dvi: ${srcdir}/auth.texi | 216 | auth.dvi: ${srcdir}/auth.texi ${gfdl} |
| 214 | $(ENVADD) $(TEXI2DVI) ${srcdir}/auth.texi | 217 | $(ENVADD) $(TEXI2DVI) ${srcdir}/auth.texi |
| 215 | auth.pdf: ${srcdir}/auth.texi | 218 | auth.pdf: ${srcdir}/auth.texi ${gfdl} |
| 216 | $(ENVADD) $(TEXI2PDF) ${srcdir}/auth.texi | 219 | $(ENVADD) $(TEXI2PDF) ${srcdir}/auth.texi |
| 217 | 220 | ||
| 218 | autotype : $(buildinfodir)/autotype$(INFO_EXT) | 221 | autotype : $(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 |
| 222 | autotype.dvi: ${srcdir}/autotype.texi | 225 | autotype.dvi: ${srcdir}/autotype.texi ${gfdl} |
| 223 | $(ENVADD) $(TEXI2DVI) ${srcdir}/autotype.texi | 226 | $(ENVADD) $(TEXI2DVI) ${srcdir}/autotype.texi |
| 224 | autotype.pdf: ${srcdir}/autotype.texi | 227 | autotype.pdf: ${srcdir}/autotype.texi ${gfdl} |
| 225 | $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi | 228 | $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi |
| 226 | 229 | ||
| 227 | bovine : $(buildinfodir)/bovine$(INFO_EXT) | 230 | bovine : $(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 |
| 231 | bovine.dvi: ${srcdir}/bovine.texi | 234 | bovine.dvi: ${srcdir}/bovine.texi ${gfdl} |
| 232 | $(ENVADD) $(TEXI2DVI) ${srcdir}/bovine.texi | 235 | $(ENVADD) $(TEXI2DVI) ${srcdir}/bovine.texi |
| 233 | bovine.pdf: ${srcdir}/bovine.texi | 236 | bovine.pdf: ${srcdir}/bovine.texi ${gfdl} |
| 234 | $(ENVADD) $(TEXI2PDF) ${srcdir}/bovine.texi | 237 | $(ENVADD) $(TEXI2PDF) ${srcdir}/bovine.texi |
| 235 | 238 | ||
| 236 | calc : $(buildinfodir)/calc$(INFO_EXT) | 239 | calc : $(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 |
| 240 | calc.dvi: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi | 243 | calc.dvi: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 241 | $(ENVADD) $(TEXI2DVI) ${srcdir}/calc.texi | 244 | $(ENVADD) $(TEXI2DVI) ${srcdir}/calc.texi |
| 242 | calc.pdf: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi | 245 | calc.pdf: ${srcdir}/calc.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 243 | $(ENVADD) $(TEXI2PDF) ${srcdir}/calc.texi | 246 | $(ENVADD) $(TEXI2PDF) ${srcdir}/calc.texi |
| 244 | 247 | ||
| 245 | ccmode : $(buildinfodir)/ccmode$(INFO_EXT) | 248 | ccmode : $(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 |
| 249 | cc-mode.dvi: ${srcdir}/cc-mode.texi | 252 | cc-mode.dvi: ${srcdir}/cc-mode.texi ${gfdl} |
| 250 | $(ENVADD) $(TEXI2DVI) ${srcdir}/cc-mode.texi | 253 | $(ENVADD) $(TEXI2DVI) ${srcdir}/cc-mode.texi |
| 251 | cc-mode.pdf: ${srcdir}/cc-mode.texi | 254 | cc-mode.pdf: ${srcdir}/cc-mode.texi ${gfdl} |
| 252 | $(ENVADD) $(TEXI2PDF) ${srcdir}/cc-mode.texi | 255 | $(ENVADD) $(TEXI2PDF) ${srcdir}/cc-mode.texi |
| 253 | 256 | ||
| 254 | cl : $(buildinfodir)/cl$(INFO_EXT) | 257 | cl : $(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 |
| 258 | cl.dvi: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi | 261 | cl.dvi: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 259 | $(ENVADD) $(TEXI2DVI) ${srcdir}/cl.texi | 262 | $(ENVADD) $(TEXI2DVI) ${srcdir}/cl.texi |
| 260 | cl.pdf: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi | 263 | cl.pdf: ${srcdir}/cl.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 261 | $(ENVADD) $(TEXI2PDF) ${srcdir}/cl.texi | 264 | $(ENVADD) $(TEXI2PDF) ${srcdir}/cl.texi |
| 262 | 265 | ||
| 263 | dbus : $(buildinfodir)/dbus$(INFO_EXT) | 266 | dbus : $(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 |
| 267 | dbus.dvi: ${srcdir}/dbus.texi | 270 | dbus.dvi: ${srcdir}/dbus.texi ${gfdl} |
| 268 | $(ENVADD) $(TEXI2DVI) ${srcdir}/dbus.texi | 271 | $(ENVADD) $(TEXI2DVI) ${srcdir}/dbus.texi |
| 269 | dbus.pdf: ${srcdir}/dbus.texi | 272 | dbus.pdf: ${srcdir}/dbus.texi ${gfdl} |
| 270 | $(ENVADD) $(TEXI2PDF) ${srcdir}/dbus.texi | 273 | $(ENVADD) $(TEXI2PDF) ${srcdir}/dbus.texi |
| 271 | 274 | ||
| 272 | dired-x : $(buildinfodir)/dired-x$(INFO_EXT) | 275 | dired-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 |
| 276 | dired-x.dvi: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi | 279 | dired-x.dvi: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 277 | $(ENVADD) $(TEXI2DVI) ${srcdir}/dired-x.texi | 280 | $(ENVADD) $(TEXI2DVI) ${srcdir}/dired-x.texi |
| 278 | dired-x.pdf: ${srcdir}/dired-x.texi $(emacsdir)/emacsver.texi | 281 | dired-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 | ||
| 281 | ebrowse : $(buildinfodir)/ebrowse$(INFO_EXT) | 284 | ebrowse : $(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 |
| 285 | ebrowse.dvi: ${srcdir}/ebrowse.texi | 288 | ebrowse.dvi: ${srcdir}/ebrowse.texi ${gfdl} |
| 286 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ebrowse.texi | 289 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ebrowse.texi |
| 287 | ebrowse.pdf: ${srcdir}/ebrowse.texi | 290 | ebrowse.pdf: ${srcdir}/ebrowse.texi ${gfdl} |
| 288 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ebrowse.texi | 291 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ebrowse.texi |
| 289 | 292 | ||
| 290 | ede : $(buildinfodir)/ede$(INFO_EXT) | 293 | ede : $(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 |
| 294 | ede.dvi: ${srcdir}/ede.texi | 297 | ede.dvi: ${srcdir}/ede.texi ${gfdl} |
| 295 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ede.texi | 298 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ede.texi |
| 296 | ede.pdf: ${srcdir}/ede.texi | 299 | ede.pdf: ${srcdir}/ede.texi ${gfdl} |
| 297 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ede.texi | 300 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ede.texi |
| 298 | 301 | ||
| 299 | ediff : $(buildinfodir)/ediff$(INFO_EXT) | 302 | ediff : $(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 |
| 303 | ediff.dvi: ${srcdir}/ediff.texi | 306 | ediff.dvi: ${srcdir}/ediff.texi ${gfdl} |
| 304 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ediff.texi | 307 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ediff.texi |
| 305 | ediff.pdf: ${srcdir}/ediff.texi | 308 | ediff.pdf: ${srcdir}/ediff.texi ${gfdl} |
| 306 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ediff.texi | 309 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ediff.texi |
| 307 | 310 | ||
| 308 | edt : $(buildinfodir)/edt$(INFO_EXT) | 311 | edt : $(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 |
| 312 | edt.dvi: ${srcdir}/edt.texi | 315 | edt.dvi: ${srcdir}/edt.texi ${gfdl} |
| 313 | $(ENVADD) $(TEXI2DVI) ${srcdir}/edt.texi | 316 | $(ENVADD) $(TEXI2DVI) ${srcdir}/edt.texi |
| 314 | edt.pdf: ${srcdir}/edt.texi | 317 | edt.pdf: ${srcdir}/edt.texi ${gfdl} |
| 315 | $(ENVADD) $(TEXI2PDF) ${srcdir}/edt.texi | 318 | $(ENVADD) $(TEXI2PDF) ${srcdir}/edt.texi |
| 316 | 319 | ||
| 317 | eieio : $(buildinfodir)/eieio$(INFO_EXT) | 320 | eieio : $(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 |
| 321 | eieio.dvi: ${srcdir}/eieio.texi | 324 | eieio.dvi: ${srcdir}/eieio.texi ${gfdl} |
| 322 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eieio.texi | 325 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eieio.texi |
| 323 | eieio.pdf: ${srcdir}/eieio.texi | 326 | eieio.pdf: ${srcdir}/eieio.texi ${gfdl} |
| 324 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eieio.texi | 327 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eieio.texi |
| 325 | 328 | ||
| 326 | emacs-gnutls : $(buildinfodir)/emacs-gnutls$(INFO_EXT) | 329 | emacs-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 |
| 330 | emacs-gnutls.dvi: ${srcdir}/emacs-gnutls.texi | 333 | emacs-gnutls.dvi: ${srcdir}/emacs-gnutls.texi ${gfdl} |
| 331 | $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-gnutls.texi | 334 | $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-gnutls.texi |
| 332 | emacs-gnutls.pdf: ${srcdir}/emacs-gnutls.texi | 335 | emacs-gnutls.pdf: ${srcdir}/emacs-gnutls.texi ${gfdl} |
| 333 | $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-gnutls.texi | 336 | $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-gnutls.texi |
| 334 | 337 | ||
| 335 | emacs-mime : $(buildinfodir)/emacs-mime$(INFO_EXT) | 338 | emacs-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 |
| 339 | emacs-mime.dvi: ${srcdir}/emacs-mime.texi | 342 | emacs-mime.dvi: ${srcdir}/emacs-mime.texi ${gfdl} |
| 340 | $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi | 343 | $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi |
| 341 | emacs-mime.pdf: ${srcdir}/emacs-mime.texi | 344 | emacs-mime.pdf: ${srcdir}/emacs-mime.texi ${gfdl} |
| 342 | $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-mime.texi | 345 | $(ENVADD) $(TEXI2PDF) ${srcdir}/emacs-mime.texi |
| 343 | 346 | ||
| 344 | epa : $(buildinfodir)/epa$(INFO_EXT) | 347 | epa : $(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 |
| 348 | epa.dvi: ${srcdir}/epa.texi | 351 | epa.dvi: ${srcdir}/epa.texi ${gfdl} |
| 349 | $(ENVADD) $(TEXI2DVI) ${srcdir}/epa.texi | 352 | $(ENVADD) $(TEXI2DVI) ${srcdir}/epa.texi |
| 350 | epa.pdf: ${srcdir}/epa.texi | 353 | epa.pdf: ${srcdir}/epa.texi ${gfdl} |
| 351 | $(ENVADD) $(TEXI2PDF) ${srcdir}/epa.texi | 354 | $(ENVADD) $(TEXI2PDF) ${srcdir}/epa.texi |
| 352 | 355 | ||
| 353 | erc : $(buildinfodir)/erc$(INFO_EXT) | 356 | erc : $(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 |
| 357 | erc.dvi: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi | 360 | erc.dvi: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 358 | $(ENVADD) $(TEXI2DVI) ${srcdir}/erc.texi | 361 | $(ENVADD) $(TEXI2DVI) ${srcdir}/erc.texi |
| 359 | erc.pdf: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi | 362 | erc.pdf: ${srcdir}/erc.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 360 | $(ENVADD) $(TEXI2PDF) ${srcdir}/erc.texi | 363 | $(ENVADD) $(TEXI2PDF) ${srcdir}/erc.texi |
| 361 | 364 | ||
| 362 | ert : $(buildinfodir)/ert$(INFO_EXT) | 365 | ert : $(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 |
| 366 | ert.dvi: ${srcdir}/ert.texi | 369 | ert.dvi: ${srcdir}/ert.texi ${gfdl} |
| 367 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ert.texi | 370 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ert.texi |
| 368 | ert.pdf: ${srcdir}/ert.texi | 371 | ert.pdf: ${srcdir}/ert.texi ${gfdl} |
| 369 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ert.texi | 372 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ert.texi |
| 370 | 373 | ||
| 371 | eshell : $(buildinfodir)/eshell$(INFO_EXT) | 374 | eshell : $(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 |
| 375 | eshell.dvi: ${srcdir}/eshell.texi | 378 | eshell.dvi: ${srcdir}/eshell.texi ${gfdl} |
| 376 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eshell.texi | 379 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eshell.texi |
| 377 | eshell.pdf: ${srcdir}/eshell.texi | 380 | eshell.pdf: ${srcdir}/eshell.texi ${gfdl} |
| 378 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eshell.texi | 381 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eshell.texi |
| 379 | 382 | ||
| 380 | eudc : $(buildinfodir)/eudc$(INFO_EXT) | 383 | eudc : $(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 |
| 384 | eudc.dvi: ${srcdir}/eudc.texi | 387 | eudc.dvi: ${srcdir}/eudc.texi ${gfdl} |
| 385 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eudc.texi | 388 | $(ENVADD) $(TEXI2DVI) ${srcdir}/eudc.texi |
| 386 | eudc.pdf: ${srcdir}/eudc.texi | 389 | eudc.pdf: ${srcdir}/eudc.texi ${gfdl} |
| 387 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eudc.texi | 390 | $(ENVADD) $(TEXI2PDF) ${srcdir}/eudc.texi |
| 388 | 391 | ||
| 392 | ## No gfdl dependency. | ||
| 389 | efaq : $(buildinfodir)/efaq$(INFO_EXT) | 393 | efaq : $(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 | ||
| 407 | flymake : $(buildinfodir)/flymake$(INFO_EXT) | 411 | flymake : $(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 |
| 411 | flymake.dvi: ${srcdir}/flymake.texi | 415 | flymake.dvi: ${srcdir}/flymake.texi ${gfdl} |
| 412 | $(ENVADD) $(TEXI2DVI) ${srcdir}/flymake.texi | 416 | $(ENVADD) $(TEXI2DVI) ${srcdir}/flymake.texi |
| 413 | flymake.pdf: ${srcdir}/flymake.texi | 417 | flymake.pdf: ${srcdir}/flymake.texi ${gfdl} |
| 414 | $(ENVADD) $(TEXI2PDF) ${srcdir}/flymake.texi | 418 | $(ENVADD) $(TEXI2PDF) ${srcdir}/flymake.texi |
| 415 | 419 | ||
| 416 | forms : $(buildinfodir)/forms$(INFO_EXT) | 420 | forms : $(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 |
| 420 | forms.dvi: ${srcdir}/forms.texi | 424 | forms.dvi: ${srcdir}/forms.texi ${gfdl} |
| 421 | $(ENVADD) $(TEXI2DVI) ${srcdir}/forms.texi | 425 | $(ENVADD) $(TEXI2DVI) ${srcdir}/forms.texi |
| 422 | forms.pdf: ${srcdir}/forms.texi | 426 | forms.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: |
| 426 | gnus : $(buildinfodir)/gnus$(INFO_EXT) | 430 | gnus : $(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 |
| 430 | gnus.dvi: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi | 434 | gnus.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.* |
| 435 | gnus.pdf: ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi | 439 | gnus.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 | ||
| 445 | htmlfontify : $(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 | ||
| 449 | htmlfontify.dvi: ${srcdir}/htmlfontify.texi ${gfdl} | ||
| 450 | $(ENVADD) $(TEXI2DVI) ${srcdir}/htmlfontify.texi | ||
| 451 | htmlfontify.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. |
| 442 | idlwave : $(buildinfodir)/idlwave$(INFO_EXT) | 455 | idlwave : $(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 |
| 446 | idlwave.dvi: ${srcdir}/idlwave.texi | 459 | idlwave.dvi: ${srcdir}/idlwave.texi ${gfdl} |
| 447 | $(ENVADD) $(TEXI2DVI) ${srcdir}/idlwave.texi | 460 | $(ENVADD) $(TEXI2DVI) ${srcdir}/idlwave.texi |
| 448 | idlwave.pdf: ${srcdir}/idlwave.texi | 461 | idlwave.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. |
| 453 | info.info : $(buildinfodir)/info$(INFO_EXT) | 466 | info.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 |
| 457 | info.dvi: ${srcdir}/info.texi | 470 | info.dvi: ${srcdir}/info.texi ${gfdl} |
| 458 | $(ENVADD) $(TEXI2DVI) ${srcdir}/info.texi | 471 | $(ENVADD) $(TEXI2DVI) ${srcdir}/info.texi |
| 459 | info.pdf: ${srcdir}/info.texi | 472 | info.pdf: ${srcdir}/info.texi ${gfdl} |
| 460 | $(ENVADD) $(TEXI2PDF) ${srcdir}/info.texi | 473 | $(ENVADD) $(TEXI2PDF) ${srcdir}/info.texi |
| 461 | 474 | ||
| 462 | mairix-el : $(buildinfodir)/mairix-el$(INFO_EXT) | 475 | mairix-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 |
| 466 | mairix-el.dvi: ${srcdir}/mairix-el.texi | 479 | mairix-el.dvi: ${srcdir}/mairix-el.texi ${gfdl} |
| 467 | $(ENVADD) $(TEXI2DVI) ${srcdir}/mairix-el.texi | 480 | $(ENVADD) $(TEXI2DVI) ${srcdir}/mairix-el.texi |
| 468 | mairix-el.pdf: ${srcdir}/mairix-el.texi | 481 | mairix-el.pdf: ${srcdir}/mairix-el.texi ${gfdl} |
| 469 | $(ENVADD) $(TEXI2PDF) ${srcdir}/mairix-el.texi | 482 | $(ENVADD) $(TEXI2PDF) ${srcdir}/mairix-el.texi |
| 470 | 483 | ||
| 471 | message : $(buildinfodir)/message$(INFO_EXT) | 484 | message : $(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 |
| 475 | message.dvi: ${srcdir}/message.texi | 488 | message.dvi: ${srcdir}/message.texi ${gfdl} |
| 476 | $(ENVADD) $(TEXI2DVI) ${srcdir}/message.texi | 489 | $(ENVADD) $(TEXI2DVI) ${srcdir}/message.texi |
| 477 | message.pdf: ${srcdir}/message.texi | 490 | message.pdf: ${srcdir}/message.texi ${gfdl} |
| 478 | $(ENVADD) $(TEXI2PDF) ${srcdir}/message.texi | 491 | $(ENVADD) $(TEXI2PDF) ${srcdir}/message.texi |
| 479 | 492 | ||
| 480 | mh-e : $(buildinfodir)/mh-e$(INFO_EXT) | 493 | mh-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 |
| 484 | mh-e.dvi: ${srcdir}/mh-e.texi | 497 | mh-e.dvi: ${srcdir}/mh-e.texi ${gfdl} |
| 485 | $(ENVADD) $(TEXI2DVI) ${srcdir}/mh-e.texi | 498 | $(ENVADD) $(TEXI2DVI) ${srcdir}/mh-e.texi |
| 486 | mh-e.pdf: ${srcdir}/mh-e.texi | 499 | mh-e.pdf: ${srcdir}/mh-e.texi ${gfdl} |
| 487 | $(ENVADD) $(TEXI2PDF) ${srcdir}/mh-e.texi | 500 | $(ENVADD) $(TEXI2PDF) ${srcdir}/mh-e.texi |
| 488 | 501 | ||
| 489 | newsticker : $(buildinfodir)/newsticker$(INFO_EXT) | 502 | newsticker : $(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 |
| 493 | newsticker.dvi: ${srcdir}/newsticker.texi | 506 | newsticker.dvi: ${srcdir}/newsticker.texi ${gfdl} |
| 494 | $(ENVADD) $(TEXI2DVI) ${srcdir}/newsticker.texi | 507 | $(ENVADD) $(TEXI2DVI) ${srcdir}/newsticker.texi |
| 495 | newsticker.pdf: ${srcdir}/newsticker.texi | 508 | newsticker.pdf: ${srcdir}/newsticker.texi ${gfdl} |
| 496 | $(ENVADD) $(TEXI2PDF) ${srcdir}/newsticker.texi | 509 | $(ENVADD) $(TEXI2PDF) ${srcdir}/newsticker.texi |
| 497 | 510 | ||
| 498 | nxml-mode : $(buildinfodir)/nxml-mode$(INFO_EXT) | 511 | nxml-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 |
| 502 | nxml-mode.dvi: ${srcdir}/nxml-mode.texi | 515 | nxml-mode.dvi: ${srcdir}/nxml-mode.texi ${gfdl} |
| 503 | $(ENVADD) $(TEXI2DVI) ${srcdir}/nxml-mode.texi | 516 | $(ENVADD) $(TEXI2DVI) ${srcdir}/nxml-mode.texi |
| 504 | nxml-mode.pdf: ${srcdir}/nxml-mode.texi | 517 | nxml-mode.pdf: ${srcdir}/nxml-mode.texi ${gfdl} |
| 505 | $(ENVADD) $(TEXI2PDF) ${srcdir}/nxml-mode.texi | 518 | $(ENVADD) $(TEXI2PDF) ${srcdir}/nxml-mode.texi |
| 506 | 519 | ||
| 507 | org : $(buildinfodir)/org$(INFO_EXT) | 520 | org : $(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 |
| 511 | org.dvi: ${srcdir}/org.texi | 524 | org.dvi: ${srcdir}/org.texi ${gfdl} |
| 512 | $(ENVADD) $(TEXI2DVI) ${srcdir}/org.texi | 525 | $(ENVADD) $(TEXI2DVI) ${srcdir}/org.texi |
| 513 | org.pdf: ${srcdir}/org.texi | 526 | org.pdf: ${srcdir}/org.texi ${gfdl} |
| 514 | $(ENVADD) $(TEXI2PDF) ${srcdir}/org.texi | 527 | $(ENVADD) $(TEXI2PDF) ${srcdir}/org.texi |
| 515 | 528 | ||
| 516 | pcl-cvs : $(buildinfodir)/pcl-cvs$(INFO_EXT) | 529 | pcl-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 |
| 520 | pcl-cvs.dvi: ${srcdir}/pcl-cvs.texi | 533 | pcl-cvs.dvi: ${srcdir}/pcl-cvs.texi ${gfdl} |
| 521 | $(ENVADD) $(TEXI2DVI) ${srcdir}/pcl-cvs.texi | 534 | $(ENVADD) $(TEXI2DVI) ${srcdir}/pcl-cvs.texi |
| 522 | pcl-cvs.pdf: ${srcdir}/pcl-cvs.texi | 535 | pcl-cvs.pdf: ${srcdir}/pcl-cvs.texi ${gfdl} |
| 523 | $(ENVADD) $(TEXI2PDF) ${srcdir}/pcl-cvs.texi | 536 | $(ENVADD) $(TEXI2PDF) ${srcdir}/pcl-cvs.texi |
| 524 | 537 | ||
| 525 | pgg : $(buildinfodir)/pgg$(INFO_EXT) | 538 | pgg : $(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 |
| 529 | pgg.dvi: ${srcdir}/pgg.texi | 542 | pgg.dvi: ${srcdir}/pgg.texi ${gfdl} |
| 530 | $(ENVADD) $(TEXI2DVI) ${srcdir}/pgg.texi | 543 | $(ENVADD) $(TEXI2DVI) ${srcdir}/pgg.texi |
| 531 | pgg.pdf: ${srcdir}/pgg.texi | 544 | pgg.pdf: ${srcdir}/pgg.texi ${gfdl} |
| 532 | $(ENVADD) $(TEXI2PDF) ${srcdir}/pgg.texi | 545 | $(ENVADD) $(TEXI2PDF) ${srcdir}/pgg.texi |
| 533 | 546 | ||
| 534 | rcirc : $(buildinfodir)/rcirc$(INFO_EXT) | 547 | rcirc : $(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 |
| 538 | rcirc.dvi: ${srcdir}/rcirc.texi | 551 | rcirc.dvi: ${srcdir}/rcirc.texi ${gfdl} |
| 539 | $(ENVADD) $(TEXI2DVI) ${srcdir}/rcirc.texi | 552 | $(ENVADD) $(TEXI2DVI) ${srcdir}/rcirc.texi |
| 540 | rcirc.pdf: ${srcdir}/rcirc.texi | 553 | rcirc.pdf: ${srcdir}/rcirc.texi ${gfdl} |
| 541 | $(ENVADD) $(TEXI2PDF) ${srcdir}/rcirc.texi | 554 | $(ENVADD) $(TEXI2PDF) ${srcdir}/rcirc.texi |
| 542 | 555 | ||
| 543 | reftex : $(buildinfodir)/reftex$(INFO_EXT) | 556 | reftex : $(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 |
| 547 | reftex.dvi: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi | 560 | reftex.dvi: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 548 | $(ENVADD) $(TEXI2DVI) ${srcdir}/reftex.texi | 561 | $(ENVADD) $(TEXI2DVI) ${srcdir}/reftex.texi |
| 549 | reftex.pdf: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi | 562 | reftex.pdf: ${srcdir}/reftex.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 550 | $(ENVADD) $(TEXI2PDF) ${srcdir}/reftex.texi | 563 | $(ENVADD) $(TEXI2PDF) ${srcdir}/reftex.texi |
| 551 | 564 | ||
| 552 | remember : $(buildinfodir)/remember$(INFO_EXT) | 565 | remember : $(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 |
| 556 | remember.dvi: ${srcdir}/remember.texi | 569 | remember.dvi: ${srcdir}/remember.texi ${gfdl} |
| 557 | $(ENVADD) $(TEXI2DVI) ${srcdir}/remember.texi | 570 | $(ENVADD) $(TEXI2DVI) ${srcdir}/remember.texi |
| 558 | remember.pdf: ${srcdir}/remember.texi | 571 | remember.pdf: ${srcdir}/remember.texi ${gfdl} |
| 559 | $(ENVADD) $(TEXI2PDF) ${srcdir}/remember.texi | 572 | $(ENVADD) $(TEXI2PDF) ${srcdir}/remember.texi |
| 560 | 573 | ||
| 561 | sasl : $(buildinfodir)/sasl$(INFO_EXT) | 574 | sasl : $(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 |
| 565 | sasl.dvi: ${srcdir}/sasl.texi | 578 | sasl.dvi: ${srcdir}/sasl.texi ${gfdl} |
| 566 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sasl.texi | 579 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sasl.texi |
| 567 | sasl.pdf: ${srcdir}/sasl.texi | 580 | sasl.pdf: ${srcdir}/sasl.texi ${gfdl} |
| 568 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sasl.texi | 581 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sasl.texi |
| 569 | 582 | ||
| 570 | sc : $(buildinfodir)/sc$(INFO_EXT) | 583 | sc : $(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 |
| 574 | sc.dvi: ${srcdir}/sc.texi | 587 | sc.dvi: ${srcdir}/sc.texi ${gfdl} |
| 575 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sc.texi | 588 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sc.texi |
| 576 | sc.pdf: ${srcdir}/sc.texi | 589 | sc.pdf: ${srcdir}/sc.texi ${gfdl} |
| 577 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sc.texi | 590 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sc.texi |
| 578 | 591 | ||
| 579 | semantic : $(buildinfodir)/semantic$(INFO_EXT) | 592 | semantic : $(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 |
| 583 | semantic.dvi: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi | 596 | semantic.dvi: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi ${gfdl} |
| 584 | $(ENVADD) $(TEXI2DVI) ${srcdir}/semantic.texi | 597 | $(ENVADD) $(TEXI2DVI) ${srcdir}/semantic.texi |
| 585 | semantic.pdf: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi | 598 | semantic.pdf: ${srcdir}/semantic.texi ${srcdir}/sem-user.texi ${gfdl} |
| 586 | $(ENVADD) $(TEXI2PDF) ${srcdir}/semantic.texi | 599 | $(ENVADD) $(TEXI2PDF) ${srcdir}/semantic.texi |
| 587 | 600 | ||
| 588 | ses : $(buildinfodir)/ses$(INFO_EXT) | 601 | ses : $(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 |
| 592 | ses.dvi: ${srcdir}/ses.texi | 605 | ses.dvi: ${srcdir}/ses.texi ${gfdl} |
| 593 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ses.texi | 606 | $(ENVADD) $(TEXI2DVI) ${srcdir}/ses.texi |
| 594 | ses.pdf: ${srcdir}/ses.texi | 607 | ses.pdf: ${srcdir}/ses.texi ${gfdl} |
| 595 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ses.texi | 608 | $(ENVADD) $(TEXI2PDF) ${srcdir}/ses.texi |
| 596 | 609 | ||
| 597 | sieve : $(buildinfodir)/sieve$(INFO_EXT) | 610 | sieve : $(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 |
| 601 | sieve.dvi: ${srcdir}/sieve.texi | 614 | sieve.dvi: ${srcdir}/sieve.texi ${gfdl} |
| 602 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sieve.texi | 615 | $(ENVADD) $(TEXI2DVI) ${srcdir}/sieve.texi |
| 603 | sieve.pdf: ${srcdir}/sieve.texi | 616 | sieve.pdf: ${srcdir}/sieve.texi ${gfdl} |
| 604 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sieve.texi | 617 | $(ENVADD) $(TEXI2PDF) ${srcdir}/sieve.texi |
| 605 | 618 | ||
| 606 | smtpmail : $(buildinfodir)/smtpmail$(INFO_EXT) | 619 | smtpmail : $(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 |
| 610 | smtpmail.dvi: ${srcdir}/smtpmail.texi | 623 | smtpmail.dvi: ${srcdir}/smtpmail.texi ${gfdl} |
| 611 | $(ENVADD) $(TEXI2DVI) ${srcdir}/smtpmail.texi | 624 | $(ENVADD) $(TEXI2DVI) ${srcdir}/smtpmail.texi |
| 612 | smtpmail.pdf: ${srcdir}/smtpmail.texi | 625 | smtpmail.pdf: ${srcdir}/smtpmail.texi ${gfdl} |
| 613 | $(ENVADD) $(TEXI2PDF) ${srcdir}/smtpmail.texi | 626 | $(ENVADD) $(TEXI2PDF) ${srcdir}/smtpmail.texi |
| 614 | 627 | ||
| 615 | speedbar : $(buildinfodir)/speedbar$(INFO_EXT) | 628 | speedbar : $(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 |
| 619 | speedbar.dvi: ${srcdir}/speedbar.texi | 632 | speedbar.dvi: ${srcdir}/speedbar.texi ${gfdl} |
| 620 | $(ENVADD) $(TEXI2DVI) ${srcdir}/speedbar.texi | 633 | $(ENVADD) $(TEXI2DVI) ${srcdir}/speedbar.texi |
| 621 | speedbar.pdf: ${srcdir}/speedbar.texi | 634 | speedbar.pdf: ${srcdir}/speedbar.texi ${gfdl} |
| 622 | $(ENVADD) $(TEXI2PDF) ${srcdir}/speedbar.texi | 635 | $(ENVADD) $(TEXI2PDF) ${srcdir}/speedbar.texi |
| 623 | 636 | ||
| 624 | srecode : $(buildinfodir)/srecode$(INFO_EXT) | 637 | srecode : $(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 |
| 628 | srecode.dvi: ${srcdir}/srecode.texi | 641 | srecode.dvi: ${srcdir}/srecode.texi ${gfdl} |
| 629 | $(ENVADD) $(TEXI2DVI) ${srcdir}/srecode.texi | 642 | $(ENVADD) $(TEXI2DVI) ${srcdir}/srecode.texi |
| 630 | srecode.pdf: ${srcdir}/srecode.texi | 643 | srecode.pdf: ${srcdir}/srecode.texi ${gfdl} |
| 631 | $(ENVADD) $(TEXI2PDF) ${srcdir}/srecode.texi | 644 | $(ENVADD) $(TEXI2PDF) ${srcdir}/srecode.texi |
| 632 | 645 | ||
| 633 | tramp : $(buildinfodir)/tramp$(INFO_EXT) | 646 | tramp : $(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 |
| 637 | tramp.dvi: ${srcdir}/tramp.texi ${srcdir}/trampver.texi | 650 | tramp.dvi: ${srcdir}/tramp.texi ${srcdir}/trampver.texi ${gfdl} |
| 638 | $(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi | 651 | $(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi |
| 639 | tramp.pdf: ${srcdir}/tramp.texi ${srcdir}/trampver.texi | 652 | tramp.pdf: ${srcdir}/tramp.texi ${srcdir}/trampver.texi ${gfdl} |
| 640 | $(ENVADD) $(TEXI2PDF) ${srcdir}/tramp.texi | 653 | $(ENVADD) $(TEXI2PDF) ${srcdir}/tramp.texi |
| 641 | 654 | ||
| 642 | url : $(buildinfodir)/url$(INFO_EXT) | 655 | url : $(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 |
| 646 | url.dvi: ${srcdir}/url.texi | 659 | url.dvi: ${srcdir}/url.texi ${gfdl} |
| 647 | $(ENVADD) $(TEXI2DVI) ${srcdir}/url.texi | 660 | $(ENVADD) $(TEXI2DVI) ${srcdir}/url.texi |
| 648 | url.pdf: ${srcdir}/url.texi | 661 | url.pdf: ${srcdir}/url.texi ${gfdl} |
| 649 | $(ENVADD) $(TEXI2PDF) ${srcdir}/url.texi | 662 | $(ENVADD) $(TEXI2PDF) ${srcdir}/url.texi |
| 650 | 663 | ||
| 651 | vip : $(buildinfodir)/vip$(INFO_EXT) | 664 | vip : $(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 |
| 655 | vip.dvi: ${srcdir}/vip.texi | 668 | vip.dvi: ${srcdir}/vip.texi ${gfdl} |
| 656 | $(ENVADD) $(TEXI2DVI) ${srcdir}/vip.texi | 669 | $(ENVADD) $(TEXI2DVI) ${srcdir}/vip.texi |
| 657 | vip.pdf: ${srcdir}/vip.texi | 670 | vip.pdf: ${srcdir}/vip.texi ${gfdl} |
| 658 | $(ENVADD) $(TEXI2PDF) ${srcdir}/vip.texi | 671 | $(ENVADD) $(TEXI2PDF) ${srcdir}/vip.texi |
| 659 | 672 | ||
| 660 | viper : $(buildinfodir)/viper$(INFO_EXT) | 673 | viper : $(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 |
| 664 | viper.dvi: ${srcdir}/viper.texi | 677 | viper.dvi: ${srcdir}/viper.texi ${gfdl} |
| 665 | $(ENVADD) $(TEXI2DVI) ${srcdir}/viper.texi | 678 | $(ENVADD) $(TEXI2DVI) ${srcdir}/viper.texi |
| 666 | viper.pdf: ${srcdir}/viper.texi | 679 | viper.pdf: ${srcdir}/viper.texi ${gfdl} |
| 667 | $(ENVADD) $(TEXI2PDF) ${srcdir}/viper.texi | 680 | $(ENVADD) $(TEXI2PDF) ${srcdir}/viper.texi |
| 668 | 681 | ||
| 669 | widget : $(buildinfodir)/widget$(INFO_EXT) | 682 | widget : $(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 |
| 673 | widget.dvi: ${srcdir}/widget.texi | 686 | widget.dvi: ${srcdir}/widget.texi ${gfdl} |
| 674 | $(ENVADD) $(TEXI2DVI) ${srcdir}/widget.texi | 687 | $(ENVADD) $(TEXI2DVI) ${srcdir}/widget.texi |
| 675 | widget.pdf: ${srcdir}/widget.texi | 688 | widget.pdf: ${srcdir}/widget.texi ${gfdl} |
| 676 | $(ENVADD) $(TEXI2PDF) ${srcdir}/widget.texi | 689 | $(ENVADD) $(TEXI2PDF) ${srcdir}/widget.texi |
| 677 | 690 | ||
| 678 | wisent : $(buildinfodir)/wisent$(INFO_EXT) | 691 | wisent : $(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 |
| 682 | wisent.dvi: ${srcdir}/wisent.texi | 695 | wisent.dvi: ${srcdir}/wisent.texi ${gfdl} |
| 683 | $(ENVADD) $(TEXI2DVI) ${srcdir}/wisent.texi | 696 | $(ENVADD) $(TEXI2DVI) ${srcdir}/wisent.texi |
| 684 | wisent.pdf: ${srcdir}/wisent.texi | 697 | wisent.pdf: ${srcdir}/wisent.texi ${gfdl} |
| 685 | $(ENVADD) $(TEXI2PDF) ${srcdir}/wisent.texi | 698 | $(ENVADD) $(TEXI2PDF) ${srcdir}/wisent.texi |
| 686 | 699 | ||
| 687 | woman : $(buildinfodir)/woman$(INFO_EXT) | 700 | woman : $(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 |
| 691 | woman.dvi: ${srcdir}/woman.texi | 704 | woman.dvi: ${srcdir}/woman.texi $(emacsdir)/emacsver.texi ${gfdl} |
| 692 | $(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi | 705 | $(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi |
| 693 | woman.pdf: ${srcdir}/woman.texi | 706 | woman.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 |
| 6 | Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. | 6 | Copyright @copyright{} 1999--2013 Free Software Foundation, Inc. |
| 7 | 7 | ||
| 8 | @quotation | 8 | @quotation |
| 9 | Permission is granted to copy, distribute and/or modify this document | 9 | Permission 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 | |||
| 14 | is included in the section entitled ``GNU Free Documentation License''. | 14 | is 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 |
| 17 | modify this GNU manual. Buying copies from the FSF supports it in | 17 | modify this GNU manual.'' |
| 18 | developing 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 | ||
| 71 | The Emacs mode for programming in Ada helps the user in understanding | 70 | The Emacs mode for programming in Ada helps the user in understanding |
| @@ -97,7 +96,7 @@ and other GNAT commands. | |||
| 97 | See the Emacs info manual, section 'Running Debuggers Under Emacs', | 96 | See the Emacs info manual, section 'Running Debuggers Under Emacs', |
| 98 | for general information on debugging. | 97 | for general information on debugging. |
| 99 | 98 | ||
| 100 | @node Installation, Customization, Overview, Top | 99 | @node Installation |
| 101 | @chapter Installation | 100 | @chapter Installation |
| 102 | 101 | ||
| 103 | Ada mode is part of the standard Emacs distribution; if you use that, | 102 | Ada 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 | ||
| 143 | Here we assume you are familiar with setting variables in Emacs, | 142 | Here 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 | ||
| 182 | By default, Ada mode is configured to use the GNAT file naming | 181 | By 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 | |||
| 218 | is beyond the scope of this manual; see the current definitions in | 217 | is 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 | ||
| 224 | By default, Ada mode is configured to use the Gnu Ada compiler GNAT. | 223 | By 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 | |||
| 228 | Ada mode project files. See @ref{Project file variables} for the list | 227 | Ada mode project files. See @ref{Project file variables} for the list |
| 229 | of project variables, and the corresponding lisp variables. | 228 | of 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 | ||
| 234 | All user-settable Ada mode variables can be set via the menu | 233 | All 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 | ||
| 252 | Ada projects can be compiled, linked, and executed using commands on | 251 | Ada 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 | ||
| 270 | Here are the commands for building and using an Ada project, as | 269 | Here 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 | ||
| 353 | The @code{Check file}, @code{Compile file}, and @code{Build} commands | 352 | The @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 | |||
| 367 | references are also clickable in the same way, or put point after the | 366 | references are also clickable in the same way, or put point after the |
| 368 | line number and press @key{RET}. | 367 | line 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 | ||
| 373 | An Emacs Ada mode project file specifies what directories hold sources | 372 | An 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 | ||
| 392 | Project files have a simple syntax; they may be edited directly. Each | 391 | Project 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 | |||
| 451 | project file. Any other extension is treated as an Emacs Ada mode | 450 | project file. Any other extension is treated as an Emacs Ada mode |
| 452 | project file. | 451 | project 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 | ||
| 457 | The project file editor is invoked with the menu @samp{Ada | Projects | 456 | The 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 | |||
| 462 | buffer, or the @kbd{C-x C-s} binding. To cancel your modifications, | 461 | buffer, or the @kbd{C-x C-s} binding. To cancel your modifications, |
| 463 | kill the buffer or click on the @samp{[cancel]} button. | 462 | kill 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 | ||
| 468 | The following variables can be defined in a project file; some can | 467 | The following variables can be defined in a project file; some can |
| @@ -522,8 +521,8 @@ ada_project_path_sep=: | |||
| 522 | ada_project_path=$GDS_ROOT/makerules | 521 | ada_project_path=$GDS_ROOT/makerules |
| 523 | ada_project_path=../opentoken | 522 | ada_project_path=../opentoken |
| 524 | @end example | 523 | @end example |
| 525 | the environment variable @code{ADA_PROJECT_PATH} will be set to | 524 | then as a result the environment variable @code{ADA_PROJECT_PATH} will |
| 526 | @code{"/home/shared/makerules:/home/opentoken/"}. | 525 | be set to @code{"/home/shared/makerules:/home/opentoken/"}. |
| 527 | 526 | ||
| 528 | The default value is not the current value of this environment | 527 | The default value is not the current value of this environment |
| 529 | variable, because that will typically have been set by another | 528 | variable, 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 | ||
| 655 | We present several small projects, and walk thru the process of | 654 | We 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 |
| 676 | This example uses no project files. | 675 | This example uses no project files. |
| 677 | 676 | ||
| @@ -731,7 +730,7 @@ In buffer @file{hello.adb}, invoke @samp{Ada | Check file}. You should | |||
| 731 | get a @code{*compilation*} buffer containing something like (the | 730 | get a @code{*compilation*} buffer containing something like (the |
| 732 | directory paths will be different): | 731 | directory paths will be different): |
| 733 | 732 | ||
| 734 | @example | 733 | @smallexample |
| 735 | cd c:/Examples/Example_1/ | 734 | cd c:/Examples/Example_1/ |
| 736 | gnatmake -u -c -gnatc -g c:/Examples/Example_1/hello.adb -cargs -gnatq -gnatQ | 735 | gnatmake -u -c -gnatc -g c:/Examples/Example_1/hello.adb -cargs -gnatq -gnatQ |
| 737 | gcc -c -Ic:/Examples/Example_1/ -gnatc -g -gnatq -gnatQ -I- c:/Examples/Example_1/hello.adb | 736 | gcc -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 | |||
| 739 | hello.adb:4:04: non-visible declaration at a-textio.ads:264 | 738 | hello.adb:4:04: non-visible declaration at a-textio.ads:264 |
| 740 | hello.adb:4:04: non-visible declaration at a-textio.ads:260 | 739 | hello.adb:4:04: non-visible declaration at a-textio.ads:260 |
| 741 | gnatmake: "c:/Examples/Example_1/hello.adb" compilation error | 740 | gnatmake: "c:/Examples/Example_1/hello.adb" compilation error |
| 742 | @end example | 741 | @end smallexample |
| 743 | 742 | ||
| 744 | If you have enabled font-lock, the lines with actual errors (starting | 743 | If you have enabled font-lock, the lines with actual errors (starting |
| 745 | with @file{hello.adb}) are highlighted, with the file name in red. | 744 | with @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 | ||
| 843 | This example illustrates using an Emacs Ada mode project file to set a | 842 | This example illustrates using an Emacs Ada mode project file to set a |
| @@ -899,7 +898,7 @@ used to set the compiler options. | |||
| 899 | Fixing the error, linking and running the code proceed as in @ref{No | 898 | Fixing the error, linking and running the code proceed as in @ref{No |
| 900 | project files}. | 899 | project 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 | ||
| 905 | In this example, we show how to deal with files in more than one | 904 | In this example, we show how to deal with files in more than one |
| @@ -983,7 +982,7 @@ compiler error message. | |||
| 983 | Fixing the error, linking and running the code proceed as in @ref{No | 982 | Fixing the error, linking and running the code proceed as in @ref{No |
| 984 | project files}. | 983 | project 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 | ||
| 989 | In this example, we show how to use a GNAT project file, with no Ada | 988 | In 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 | |||
| 1046 | Build}. You should get a @code{*compilation*} buffer containing | 1045 | Build}. You should get a @code{*compilation*} buffer containing |
| 1047 | something like (the directory paths will be different): | 1046 | something like (the directory paths will be different): |
| 1048 | 1047 | ||
| 1049 | @example | 1048 | @smallexample |
| 1050 | cd c:/Examples/Example_4/Gnat_Project/ | 1049 | cd c:/Examples/Example_4/Gnat_Project/ |
| 1051 | gnatmake -o hello_4 hello_4 -Phello_4.gpr -cargs -gnatq -gnatQ -bargs -largs | 1050 | gnatmake -o hello_4 hello_4 -Phello_4.gpr -cargs -gnatq -gnatQ -bargs -largs |
| 1052 | gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\Gnat_Project\hello_4.adb | 1051 | gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\Gnat_Project\hello_4.adb |
| 1053 | gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb | 1052 | gcc -c -g -gnatyt -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb |
| 1054 | hello_pkg.adb:2:08: keyword "body" expected here [see file name] | 1053 | hello_pkg.adb:2:08: keyword "body" expected here [see file name] |
| 1055 | gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error | 1054 | gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error |
| 1056 | @end example | 1055 | @end smallexample |
| 1057 | 1056 | ||
| 1058 | Compare the @code{gcc} options to the compiler output in @ref{Set | 1057 | Compare the @code{gcc} options to the compiler output in @ref{Set |
| 1059 | compiler options}; this shows that @file{hello_4.gpr} is being used to | 1058 | compiler options}; this shows that @file{hello_4.gpr} is being used to |
| @@ -1062,7 +1061,7 @@ set the compiler options. | |||
| 1062 | Fixing the error, linking and running the code proceed as in @ref{No | 1061 | Fixing the error, linking and running the code proceed as in @ref{No |
| 1063 | project files}. | 1062 | project 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 | ||
| 1068 | In this example, we show how to use multiple GNAT project files, | 1067 | In 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 | |||
| 1113 | Build}. You should get a @code{*compilation*} buffer containing | 1112 | Build}. You should get a @code{*compilation*} buffer containing |
| 1114 | something like (the directory paths will be different): | 1113 | something like (the directory paths will be different): |
| 1115 | 1114 | ||
| 1116 | @example | 1115 | @smallexample |
| 1117 | cd c:/Examples/Example_5/ | 1116 | cd c:/Examples/Example_5/ |
| 1118 | gnatmake -o hello_5 hello_5 -Phello_5.gpr -g -cargs -gnatq -gnatQ -bargs -largs | 1117 | gnatmake -o hello_5 hello_5 -Phello_5.gpr -g -cargs -gnatq -gnatQ -bargs -largs |
| 1119 | gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_5\hello_5.adb | 1118 | gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_5\hello_5.adb |
| 1120 | gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb | 1119 | gcc -c -g -gnatyt -g -gnatq -gnatQ -I- -gnatA c:\Examples\Example_4\hello_pkg.adb |
| 1121 | hello_pkg.adb:2:08: keyword "body" expected here [see file name] | 1120 | hello_pkg.adb:2:08: keyword "body" expected here [see file name] |
| 1122 | gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error | 1121 | gnatmake: "c:\examples\example_4\hello_pkg.adb" compilation error |
| 1123 | @end example | 1122 | @end smallexample |
| 1124 | 1123 | ||
| 1125 | Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown, | 1124 | Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown, |
| 1126 | demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being | 1125 | demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being |
| 1127 | used to set the compilation search path. | 1126 | used 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 | ||
| 1132 | There are several easy to use commands to navigate through Ada code. All | 1131 | There 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 | |||
| 1180 | will try to run GNAT for you whenever cross-reference information is | 1179 | will try to run GNAT for you whenever cross-reference information is |
| 1181 | needed, and is older than the current source file. | 1180 | needed, 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 | ||
| 1186 | Emacs and Ada mode provide two general ways for the completion of | 1185 | Emacs and Ada mode provide two general ways for the completion of |
| @@ -1225,7 +1224,7 @@ Complete current identifier using cross-reference information. | |||
| 1225 | Complete identifier using buffer information (not Ada-specific). | 1224 | Complete 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 | ||
| 1231 | Ada mode comes with a full set of rules for automatic indentation. You | 1230 | Ada 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 | |||
| 1302 | indentation. | 1301 | indentation. |
| 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 | |||
| 1315 | argument names and argument types, and aligns the @code{in}, | 1314 | argument 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 | ||
| 1321 | Casing of identifiers, attributes and keywords is automatically | 1320 | Casing 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 | ||
| 1410 | Templates are defined for most Ada statements, using the Emacs | 1409 | Templates are defined for most Ada statements, using the Emacs |
| @@ -1495,7 +1494,7 @@ exception (@code{ada-exception}). | |||
| 1495 | type (@code{ada-type}). | 1494 | type (@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 | ||
| 1501 | By default, comment lines get indented like Ada code. There are a few | 1500 | By 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 |
| 1508 | Continue comment on next line. | 1507 | Continue comment on next line. |
| 1509 | @item C-c ; | 1508 | @item C-c ; |
| 1510 | Comment the selected region (add -- at the beginning of lines). | 1509 | Comment the selected region (add @samp{--} at the beginning of lines). |
| 1511 | @item C-c : | 1510 | @item C-c : |
| 1512 | Uncomment the selected region | 1511 | Uncomment the selected region |
| 1513 | @item M-q | 1512 | @item M-q |
| 1514 | autofill the current comment. | 1513 | autofill 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 |
| 11 | This file describes the Emacs auth-source library. | 11 | This file describes the Emacs auth-source library. |
| 12 | 12 | ||
| 13 | Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. | 13 | Copyright @copyright{} 2008--2013 Free Software Foundation, Inc. |
| 14 | 14 | ||
| 15 | @quotation | 15 | @quotation |
| 16 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 | |||
| 18 | any later version published by the Free Software Foundation; with no | 18 | any later version published by the Free Software Foundation; with no |
| 19 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 19 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 20 | and with the Back-Cover Texts as in (a) below. A copy of the license | 20 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 21 | is included in the section entitled ``GNU Free Documentation License'' | 21 | is included in the section entitled ``GNU Free Documentation License''. |
| 22 | in 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 24 | modify this GNU manual.'' |
| 26 | developing GNU and promoting software freedom.'' | ||
| 27 | |||
| 28 | This document is part of a collection distributed under the GNU Free | ||
| 29 | Documentation License. If you want to distribute this document | ||
| 30 | separately from the collection, you can do so by adding a copy of the | ||
| 31 | license 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). | |||
| 173 | Here's a mixed example using two sources: | 168 | Here'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 | |||
| 522 | To set up elisp passphrase cache, set | 518 | To 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 |
| 13 | Copyright @copyright{} 1994-1995, 1999, 2001-2012 Free Software Foundation, Inc. | 13 | Copyright @copyright{} 1994--1995, 1999, 2001--2013 |
| 14 | Free Software Foundation, Inc. | ||
| 14 | 15 | ||
| 15 | @quotation | 16 | @quotation |
| 16 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 21 | is included in the section entitled ``GNU Free Documentation License''. | 22 | is 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 |
| 24 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 25 | developing 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 | |||
| 58 | language constructs. Project-specific header comments, flow-control | 58 | language constructs. Project-specific header comments, flow-control |
| 59 | constructs or magic numbers are essentially the same every time. Emacs has | 59 | constructs or magic numbers are essentially the same every time. Emacs has |
| 60 | various features for doing tedious and repetitive typing chores for you | 60 | various features for doing tedious and repetitive typing chores for you |
| 61 | in addition to the Abbrev features (@pxref{(emacs)Abbrevs}). | 61 | in 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 |
| 64 | insert, and how to do it. Various programming language modes offer some | 64 | insert, and how to do it. Various programming language modes offer some |
| @@ -113,7 +113,7 @@ completions and expansions of text at point. | |||
| 113 | programming language you are using, skeletons are a means of accomplishing | 113 | programming language you are using, skeletons are a means of accomplishing |
| 114 | this. Normally skeletons each have a command of their own, that, when called, | 114 | this. Normally skeletons each have a command of their own, that, when called, |
| 115 | will insert the skeleton. These commands can be issued in the usual ways | 115 | will 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 |
| 117 | bind these to key-sequences on the @kbd{C-c} prefix, as well as having | 117 | bind these to key-sequences on the @kbd{C-c} prefix, as well as having |
| 118 | an @cite{Insert} menu and maybe even predefined abbrevs for them | 118 | an @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, | |||
| 146 | reindent the wrapped code for you. | 146 | reindent 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 |
| 150 | on whether the prefix is positive, i.e., forwards oriented, or negative, | 150 | on whether the prefix is positive, i.e., forwards oriented, or negative, |
| 151 | i.e., backwards oriented. | 151 | i.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 |
| 154 | following words. This is accomplished by putting the words there where | 154 | following words. This is accomplished by putting the words there where |
| 155 | the point is normally left after that skeleton is inserted (@pxref{Using | 155 | the point is normally left after that skeleton is inserted (@pxref{Using |
| 156 | Skeletons}). The point (@pxref{(emacs)Point}) is left at the next | 156 | Skeletons}). The point (@pxref{Point,,, emacs, The GNU Emacs Manual}) is left at the next |
| 157 | interesting spot in the skeleton instead. | 157 | interesting 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 |
| 160 | marked interregions (@pxref{(emacs)Mark}). In the simplest case, if you type | 160 | marked 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 |
| 162 | skeleton around the current region, just like a positive argument would have | 162 | skeleton around the current region, just like a positive argument would have |
| 163 | wrapped it around a number of words. | 163 | wrapped 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 |
| 192 | define an abbreviation (@pxref{(emacs)Defining Abbrevs}) that will expand | 192 | define 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 |
| 196 | statement. You will tell Emacs that @samp{ifst} expands to the empty string | 196 | statement. 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 | |||
| 290 | documentation string, and the rest is an interactor and any number of skeleton | 290 | documentation string, and the rest is an interactor and any number of skeleton |
| 291 | elements together forming a skeleton. This skeleton is assigned to a variable | 291 | elements together forming a skeleton. This skeleton is assigned to a variable |
| 292 | of the same name as the command and can thus be overridden from your | 292 | of 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 |
| 313 | the pair to @code{skeleton-pair-insert-maybe} instead of | 313 | the 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 |
| 315 | this at-first surprising behavior is initially turned off. To enable | 315 | this at-first surprising behavior is initially turned off. To enable |
| 316 | it, you must set @code{skeleton-pair} to some non-@code{nil} value. | 316 | it, you must set @code{skeleton-pair} to some non-@code{nil} value. |
| 317 | And even then, a positive argument (@pxref{(emacs)Arguments}) will | 317 | And even then, a positive argument (@pxref{Arguments,,, emacs, The GNU Emacs Manual}) will |
| 318 | make this key behave like a self-inserting key | 318 | make 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, | |||
| 354 | is to have it be called automatically every time an empty, and only an | 354 | is to have it be called automatically every time an empty, and only an |
| 355 | empty file is visited. This is accomplished by putting @code{(add-hook | 355 | empty 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 | |||
| 392 | environment variable @env{$ORGANIZATION} or else the FSF, and prompt | 392 | environment variable @env{$ORGANIZATION} or else the FSF, and prompt |
| 393 | for valid keywords describing the contents. Files in a @file{bin} | 393 | for valid keywords describing the contents. Files in a @file{bin} |
| 394 | directory for which Emacs could determine no specialized mode | 394 | directory 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 |
| 401 | define-auto-insert}. | 401 | define-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 |
| 439 | notice at the point. The ``by'' part is taken from your environment variable | 439 | notice 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 |
| 441 | buffer has a comment syntax (@pxref{(emacs)Comments}), this is inserted as a comment. | 441 | buffer 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. | |||
| 450 | If a dash-separated year list up to last year is found, that is extended to | 450 | If a dash-separated year list up to last year is found, that is extended to |
| 451 | current year, else the year is added separated by a comma. Or it replaces | 451 | current year, else the year is added separated by a comma. Or it replaces |
| 452 | them when this is called with a prefix argument. If a header referring to a | 452 | them when this is called with a prefix argument. If a header referring to a |
| 453 | wrong version of the GNU General Public License (@pxref{(emacs)Copying}) is found, | 453 | wrong version of the GNU General Public License (@pxref{Copying,,, emacs, The GNU Emacs Manual}) is found, |
| 454 | that is updated too. | 454 | that 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 |
| 457 | automatically every time a file is saved. This is accomplished by | 457 | automatically every time a file is saved. This is accomplished by |
| 458 | putting @code{(add-hook 'before-save-hook 'copyright-update)} into | 458 | putting @code{(add-hook 'before-save-hook 'copyright-update)} into |
| 459 | your @file{~/.emacs} file (@pxref{(emacs)Init File}). Alternative, | 459 | your @file{~/.emacs} file (@pxref{Init File,,, emacs, The GNU Emacs Manual}). Alternative, |
| 460 | you can do @kbd{M-x customize-variable @key{RET} before-save-hook | 460 | you 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 |
| 462 | option in the customization buffer. | 462 | option 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 |
| 26 | Copyright @copyright{} 1999-2004, 2012 Free Software Foundation, Inc. | 26 | Copyright @copyright{} 1999--2004, 2012--2013 Free Software Foundation, Inc. |
| 27 | 27 | ||
| 28 | @quotation | 28 | @quotation |
| 29 | Permission is granted to copy, distribute and/or modify this document | 29 | Permission 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 | |||
| 34 | is included in the section entitled ``GNU Free Documentation License''. | 34 | is 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 |
| 37 | modify this GNU manual. Buying copies from the FSF supports it in | 37 | modify this GNU manual.'' |
| 38 | developing 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. | |||
| 139 | In bison, each time an element of @var{components} is found, it is | 138 | In 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.) |
| 141 | When all @var{components}' elements have been matched, it is | 140 | When 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 | ||
| 144 | A particular @var{result} written into your grammar becomes | 143 | A particular @var{result} written into your grammar becomes |
| 145 | the parser's goal. It is designated by a @code{%start} statement | 144 | the 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 |
| 372 | Is an optional set of labeled values such as @w{@code{:constant-flag t :parent | 371 | Is 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 | |||
| 94 | GNU Emacs @value{EMACSVER}. | 94 | GNU Emacs @value{EMACSVER}. |
| 95 | @end ifnotinfo | 95 | @end ifnotinfo |
| 96 | 96 | ||
| 97 | Copyright @copyright{} 1990-1991, 2001-2012 Free Software Foundation, Inc. | 97 | Copyright @copyright{} 1990--1991, 2001--2013 Free Software Foundation, Inc. |
| 98 | 98 | ||
| 99 | @quotation | 99 | @quotation |
| 100 | Permission is granted to copy, distribute and/or modify this document | 100 | Permission 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 | |||
| 106 | entitled ``GNU Free Documentation License.'' | 106 | entitled ``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 |
| 109 | modify this GNU manual. Buying copies from the FSF supports it in | 109 | modify this GNU manual.'' |
| 110 | developing 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 | |||
| 13417 | functions, your date formats should avoid using the @samp{#} character. | 13416 | functions, 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 |
| 13431 | The same date can be written down in different formats and Calc tries | 13430 | The same date can be written down in different formats and Calc tries |
| 13432 | to allow you to choose your preferred format. Some common formats are | 13431 | to allow you to choose your preferred format. Some common formats are |
| 13433 | ambiguous, however; for example, 10/11/2012 means October 11, | 13432 | ambiguous, however; for example, 10/11/2012 means October 11, |
| 13434 | 2012 in the United States but it means November 10, 2012 in | 13433 | 2012 in the United States but it means November 10, 2012 in |
| 13435 | Europe. To help avoid such ambiguities, the International Organization | 13434 | Europe. To help avoid such ambiguities, the International Organization |
| 13436 | for Standardization (ISO) provides the ISO-8601 standard, which | 13435 | for Standardization (ISO) provides the ISO 8601 standard, which |
| 13437 | provides three different but easily distinguishable and unambiguous | 13436 | provides three different but easily distinguishable and unambiguous |
| 13438 | ways to represent a date. | 13437 | ways to represent a date. |
| 13439 | 13438 | ||
| 13440 | The ISO-8601 calendar date representation is | 13439 | The 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 | |||
| 13452 | least four digits, is the Gregorian year, except that the year before | 13451 | least four digits, is the Gregorian year, except that the year before |
| 13453 | 0001 (1 AD) is the year 0000 (1 BC). The date October 11, 2012 is | 13452 | 0001 (1 AD) is the year 0000 (1 BC). The date October 11, 2012 is |
| 13454 | written 2012-10-11 in this representation and November 10, 2012 is | 13453 | written 2012-10-11 in this representation and November 10, 2012 is |
| 13455 | written 2012-11-10. | 13454 | written 2012-11-10. |
| 13456 | 13455 | ||
| 13457 | The ISO-8601 ordinal date representation is | 13456 | The 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 |
| 13464 | where @var{YYYY} is the year, as above, and @var{DDD} is the day of the year. | 13463 | where @var{YYYY} is the year, as above, and @var{DDD} is the day of the year. |
| 13465 | The date December 31, 2011 is written 2011-365 in this representation | 13464 | The date December 31, 2011 is written 2011-365 in this representation |
| 13466 | and January 1, 2012 is written 2012-001. | 13465 | and January 1, 2012 is written 2012-001. |
| 13467 | 13466 | ||
| 13468 | The ISO-8601 week date representation is | 13467 | The 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 | |||
| 13476 | digit week number (preceded by a literal ``W''), and @var{D} is the day | 13475 | digit week number (preceded by a literal ``W''), and @var{D} is the day |
| 13477 | of the week (1 for Monday through 7 for Sunday). The ISO week-numbering | 13476 | of the week (1 for Monday through 7 for Sunday). The ISO week-numbering |
| 13478 | year is based on the Gregorian year but can differ slightly. The first | 13477 | year is based on the Gregorian year but can differ slightly. The first |
| 13479 | week of an ISO week-numbering year is the week with the Gregorian year's | 13478 | week of an ISO week-numbering year is the week with the Gregorian year's |
| 13480 | first Thursday in it (equivalently, the week containing January 4); | 13479 | first Thursday in it (equivalently, the week containing January 4); |
| 13481 | any day of that week (Monday through Sunday) is part of the same ISO | 13480 | any day of that week (Monday through Sunday) is part of the same ISO |
| 13482 | week-numbering year, any day from the previous week is part of the | 13481 | week-numbering year, any day from the previous week is part of the |
| 13483 | previous year. For example, January 4, 2013 is on a Friday, and so | 13482 | previous year. For example, January 4, 2013 is on a Friday, and so |
| 13484 | the first week for the ISO week-numbering year 2013 starts on | 13483 | the first week for the ISO week-numbering year 2013 starts on |
| 13485 | Monday, December 31, 2012. The day December 31, 2012 is then part of the | 13484 | Monday, December 31, 2012. The day December 31, 2012 is then part of the |
| 13486 | Gregorian year 2012 but ISO week-numbering year 2013. In the week | 13485 | Gregorian year 2012 but ISO week-numbering year 2013. In the week |
| 13487 | date representation, this week goes from 2013-W01-1 (December 31, | 13486 | date representation, this week goes from 2013-W01-1 (December 31, |
| 13488 | 2012) to 2013-W01-7 (January 6, 2013). | 13487 | 2012) to 2013-W01-7 (January 6, 2013). |
| 13489 | 13488 | ||
| 13490 | All three ISO-8601 representations arrange the numbers from most | 13489 | All three ISO 8601 representations arrange the numbers from most |
| 13491 | significant to least significant; as well as being unambiguous | 13490 | significant to least significant; as well as being unambiguous |
| 13492 | representations, they are easy to sort since chronological order in | 13491 | representations, they are easy to sort since chronological order in |
| 13493 | this formats corresponds to lexicographical order. The hyphens are | 13492 | this formats corresponds to lexicographical order. The hyphens are |
| 13494 | sometimes omitted. | 13493 | sometimes omitted. |
| 13495 | 13494 | ||
| 13496 | The ISO-8601 standard uses a 24 hour clock; a particular time is | 13495 | The ISO 8601 standard uses a 24 hour clock; a particular time is |
| 13497 | represented by @var{hh}:@var{mm}:@var{ss} where @var{hh} is the | 13496 | represented by @var{hh}:@var{mm}:@var{ss} where @var{hh} is the |
| 13498 | two-digit hour (from 00 to 24), @var{mm} is the two-digit minute (from | 13497 | two-digit hour (from 00 to 24), @var{mm} is the two-digit minute (from |
| 13499 | 00 to 59) and @var{ss} is the two-digit second. The seconds or minutes | 13498 | 00 to 59) and @var{ss} is the two-digit second. The seconds or minutes |
| 13500 | and seconds can be omitted, and decimals can be added. If a date with a | 13499 | and seconds can be omitted, and decimals can be added. If a date with a |
| 13501 | time is represented, they should be separated by a literal ``T'', so noon | 13500 | time is represented, they should be separated by a literal ``T'', so noon |
| 13502 | on December 13, 2012 can be represented as 2012-12-13T12:00 | 13501 | on 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 |
| 13544 | Year: ``1991'' for 1991, ``+23'' for 23 AD. | 13543 | Year: ``1991'' for 1991, ``+23'' for 23 AD. |
| 13545 | @item ZYYY | 13544 | @item ZYYY |
| 13546 | Year: ``1991'' for 1991, ``0023'' for 23 AD., ``0000'' for 1 BC. | 13545 | Year: ``1991'' for 1991, ``0023'' for 23 AD, ``0000'' for 1 BC. |
| 13547 | @item IYYY | 13546 | @item IYYY |
| 13548 | Year: ISO-8601 week-numbering year. | 13547 | Year: ISO 8601 week-numbering year. |
| 13549 | @item aa | 13548 | @item aa |
| 13550 | Year: ``ad'' or blank. | 13549 | Year: ``ad'' or blank. |
| 13551 | @item AA | 13550 | @item AA |
| @@ -13607,7 +13606,7 @@ Weekday: ``SUNDAY'' for Sunday. | |||
| 13607 | @item Wwww | 13606 | @item Wwww |
| 13608 | Weekday: ``Sunday'' for Sunday. | 13607 | Weekday: ``Sunday'' for Sunday. |
| 13609 | @item Iww | 13608 | @item Iww |
| 13610 | Week number: ISO-8601 week number, ``W01'' for week 1. | 13609 | Week number: ISO 8601 week number, ``W01'' for week 1. |
| 13611 | @item d | 13610 | @item d |
| 13612 | Day of year: ``34'' for Feb. 3. | 13611 | Day 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. |
| 13720 | The words @samp{noon}, @samp{mid}, and @samp{midnight} are also | 13719 | The words @samp{noon}, @samp{mid}, and @samp{midnight} are also |
| 13721 | recognized with no number attached. | 13720 | recognized with no number attached. Midnight will represent the |
| 13721 | beginning of a day. | ||
| 13722 | 13722 | ||
| 13723 | If there is no AM/PM indicator, the time is interpreted in 24-hour | 13723 | If there is no AM/PM indicator, the time is interpreted in 24-hour |
| 13724 | format. | 13724 | format. |
| 13725 | 13725 | ||
| 13726 | To read the date portion, all words and numbers are isolated | 13726 | When reading the date portion, Calc first checks to see if it is an |
| 13727 | from the string; other characters are ignored. All words must | 13727 | ISO 8601 week-numbering date; if the string contains an integer |
| 13728 | be either month names or day-of-week names (the latter of which | 13728 | representing the year, a ``W'' followed by two digits for the week |
| 13729 | are ignored). Names can be written in full or as three-letter | 13729 | number, and an integer from 1 to 7 representing the weekday (in that |
| 13730 | order), then all other characters are ignored and this information | ||
| 13731 | determines the date. Otherwise, all words and numbers are isolated | ||
| 13732 | from the string; other characters are ignored. All words must be | ||
| 13733 | either month names or day-of-week names (the latter of which are | ||
| 13734 | ignored). Names can be written in full or as three-letter | ||
| 13730 | abbreviations. | 13735 | abbreviations. |
| 13731 | 13736 | ||
| 13732 | Large numbers, or numbers with @samp{+} or @samp{-} signs, | 13737 | Large 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 | |||
| 17436 | the user-level @code{pwday} function described in the previous | 17441 | the user-level @code{pwday} function described in the previous |
| 17437 | section. It takes four arguments: The floating-point date value, | 17442 | section. It takes four arguments: The floating-point date value, |
| 17438 | the corresponding six-element date list, the day-of-month number, | 17443 | the corresponding six-element date list, the day-of-month number, |
| 17439 | and the weekday number (0-6). | 17444 | and the weekday number (0--6). |
| 17440 | 17445 | ||
| 17441 | The default daylight saving hook ignores the time zone name, but a | 17446 | The default daylight saving hook ignores the time zone name, but a |
| 17442 | more sophisticated hook could use different algorithms for different | 17447 | more 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 |
| 36752 | A prefix argument specifies a day number (0-6, 0-31, or 0-366). | 36757 | A 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 |
| 157 | This manual is for CC Mode in Emacs. | 157 | This manual is for CC Mode in Emacs. |
| 158 | 158 | ||
| 159 | Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. | 159 | Copyright @copyright{} 1995--2013 Free Software Foundation, Inc. |
| 160 | 160 | ||
| 161 | @quotation | 161 | @quotation |
| 162 | Permission is granted to copy, distribute and/or modify this document | 162 | Permission 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 | |||
| 167 | is included in the section entitled ``GNU Free Documentation License''. | 167 | is 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 |
| 170 | modify this GNU manual. Buying copies from the FSF supports it in | 170 | modify this GNU manual.'' |
| 171 | developing 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 | |||
| 220 | and AWK code. It provides syntax-based indentation, font locking, and | 219 | and AWK code. It provides syntax-based indentation, font locking, and |
| 221 | has several handy commands and some minor modes to make the editing | 220 | has several handy commands and some minor modes to make the editing |
| 222 | easier. It does not provide tools to look up and navigate between | 221 | easier. It does not provide tools to look up and navigate between |
| 223 | functions, classes etc - there are other packages for that. | 222 | functions, 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{} | |||
| 370 | Maintainers Team, and implemented the Pike support. In 2000 Martin | 369 | Maintainers Team, and implemented the Pike support. In 2000 Martin |
| 371 | took over as the sole maintainer. In 2001 Alan Mackenzie joined the | 370 | took over as the sole maintainer. In 2001 Alan Mackenzie joined the |
| 372 | team, implementing AWK support in version 5.30. @ccmode{} did not | 371 | team, implementing AWK support in version 5.30. @ccmode{} did not |
| 373 | originally contain the font lock support for its languages --- that | 372 | originally contain the font lock support for its languages; that |
| 374 | was added in version 5.30. | 373 | was added in version 5.30. |
| 375 | 374 | ||
| 376 | This manual describes @ccmode{} | 375 | This manual describes @ccmode{} |
| @@ -442,7 +441,7 @@ increasing detail. | |||
| 442 | @itemize @bullet | 441 | @itemize @bullet |
| 443 | @item | 442 | @item |
| 444 | The chapter ``Configuration Basics'' tells you @emph{how} to write | 443 | The chapter ``Configuration Basics'' tells you @emph{how} to write |
| 445 | customizations - whether in hooks, in styles, in both, or in neither, | 444 | customizations: whether in hooks, in styles, in both, or in neither, |
| 446 | depending on your needs. It describes the @ccmode{} style system and | 445 | depending on your needs. It describes the @ccmode{} style system and |
| 447 | lists the standard styles that @ccmode{} supplies. | 446 | lists 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 |
| 471 | The next two chapters tell you how to get in touch with the @ccmode{} | 470 | The next two chapters tell you how to get in touch with the @ccmode{} |
| 472 | project - whether for updating @ccmode{} or submitting bug reports. | 471 | project: 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. | |||
| 716 | When it is @code{nil}, @key{TAB} (re)indents the line only if point is | 715 | When it is @code{nil}, @key{TAB} (re)indents the line only if point is |
| 717 | to the left of the first non-whitespace character on the line. | 716 | to the left of the first non-whitespace character on the line. |
| 718 | Otherwise it inserts some whitespace (a tab or an equivalent number of | 717 | Otherwise it inserts some whitespace (a tab or an equivalent number of |
| 719 | spaces - see below) at point. | 718 | spaces; see below) at point. |
| 720 | @item | 719 | @item |
| 721 | With some other value, the line is reindented. Additionally, if point | 720 | With some other value, the line is reindented. Additionally, if point |
| 722 | is within a string or comment, some whitespace is inserted. | 721 | is 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 |
| 823 | This command comments out the lines that start in the region. With a | 822 | This command comments out the lines that start in the region. With a |
| 824 | negative argument, it does the opposite - it deletes the comment | 823 | negative argument, it does the opposite: it deletes the comment |
| 825 | delimiters from these lines. @xref{Multi-Line Comments,,, emacs, GNU | 824 | delimiters from these lines. @xref{Multi-Line Comments,,, emacs, GNU |
| 826 | Emacs Manual}, for fuller details. @code{comment-region} isn't | 825 | Emacs Manual}, for fuller details. @code{comment-region} isn't |
| 827 | actually part of @ccmode{} - it is given a @ccmode{} binding for | 826 | actually part of @ccmode{}; it is given a @ccmode{} binding for |
| 828 | convenience. | 827 | convenience. |
| 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 | |||
| 1148 | when electric mode is disabled. | 1147 | when electric mode is disabled. |
| 1149 | @item hungry-delete mode | 1148 | @item hungry-delete mode |
| 1150 | This lets you delete a contiguous block of whitespace with a single | 1149 | This lets you delete a contiguous block of whitespace with a single |
| 1151 | key - for example, the newline and indentation just inserted by | 1150 | key: for example, the newline and indentation just inserted by |
| 1152 | auto-newline when you want to back up and write a comment after the | 1151 | auto-newline when you want to back up and write a comment after the |
| 1153 | last statement. | 1152 | last 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 |
| 1179 | modes on the modeline by appending letters to the major mode's name, | 1178 | modes on the modeline by appending letters to the major mode's name, |
| 1180 | one letter for each enabled minor mode - @samp{l} for electric mode, | 1179 | one 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 | ||
| 1238 | Most punctuation keys provide @dfn{electric} behavior - as well as | 1237 | Most punctuation keys provide @dfn{electric} behavior: as well as |
| 1239 | inserting themselves they perform some other action, such as | 1238 | inserting themselves they perform some other action, such as |
| 1240 | reindenting the line. This reindentation saves you from having to | 1239 | reindenting the line. This reindentation saves you from having to |
| 1241 | reindent a line manually after typing, say, a @samp{@}}. A few | 1240 | reindent 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 | ||
| 2104 | If you add support for another doc comment style, please consider | 2103 | If you add support for another doc comment style, please consider |
| 2105 | contributing it - send a note to @email{bug-cc-mode@@gnu.org}. | 2104 | contributing 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. | |||
| 2250 | An Emacs @dfn{hook} is a place to put Lisp functions that you want | 2249 | An Emacs @dfn{hook} is a place to put Lisp functions that you want |
| 2251 | Emacs to execute later in specific circumstances. | 2250 | Emacs to execute later in specific circumstances. |
| 2252 | @xref{Hooks,,,@lispref{}, @lispreftitle{}}. @ccmode{} supplies a main | 2251 | @xref{Hooks,,,@lispref{}, @lispreftitle{}}. @ccmode{} supplies a main |
| 2253 | hook and a language-specific hook for each language it supports - any | 2252 | hook and a language-specific hook for each language it supports; any |
| 2254 | functions you put onto these hooks get executed as the last part of a | 2253 | functions you put onto these hooks get executed as the last part of a |
| 2255 | buffer's initialization. Typically you put most of your customization | 2254 | buffer's initialization. Typically you put most of your customization |
| 2256 | within the main hook, and use the language-specific hooks to vary the | 2255 | within the main hook, and use the language-specific hooks to vary the |
| @@ -2684,7 +2683,7 @@ string. | |||
| 2684 | If none of the built-in styles is appropriate, you'll probably want to | 2683 | If none of the built-in styles is appropriate, you'll probably want to |
| 2685 | create a new @dfn{style definition}, possibly based on an existing | 2684 | create a new @dfn{style definition}, possibly based on an existing |
| 2686 | style. To do this, put the new style's settings into a list with the | 2685 | style. To do this, put the new style's settings into a list with the |
| 2687 | following format - the list can then be passed as an argument to the | 2686 | following format; the list can then be passed as an argument to the |
| 2688 | function @code{c-add-style}. You can see an example of a style | 2687 | function @code{c-add-style}. You can see an example of a style |
| 2689 | definition in @ref{Sample .emacs File}. | 2688 | definition 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 |
| 3170 | an alist. This element specifies where to put newlines - this is any | 3169 | an alist. This element specifies where to put newlines: this is any |
| 3171 | combination of before and after the brace or colon. If no alist | 3170 | combination of before and after the brace or colon. If no alist |
| 3172 | element is found, newlines are inserted both before and after a brace, | 3171 | element is found, newlines are inserted both before and after a brace, |
| 3173 | but none are inserted around a colon. See @ref{Hanging Braces} and | 3172 | but 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, | |||
| 3268 | or a function. | 3267 | or a function. |
| 3269 | 3268 | ||
| 3270 | @table @asis | 3269 | @table @asis |
| 3271 | @item The Key - the syntactic symbol | 3270 | @item The Key: the syntactic symbol |
| 3272 | The syntactic symbols that are useful as keys in this list are | 3271 | The 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 | |||
| 3291 | purposes. It's currently not possible to set automatic newlines on | 3290 | purposes. It's currently not possible to set automatic newlines on |
| 3292 | these constructs. | 3291 | these constructs. |
| 3293 | 3292 | ||
| 3294 | @item The associated value - the ``ACTION'' list or function | 3293 | @item The associated value: the ``ACTION'' list or function |
| 3295 | The value associated with each syntactic symbol in this association | 3294 | The value associated with each syntactic symbol in this association |
| 3296 | list is called an @var{action}, which can be either a list or a | 3295 | list is called an @var{action}, which can be either a list or a |
| 3297 | function which returns a list. @xref{Custom Braces}, for how to use | 3296 | function 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 | ||
| 3462 | Using a mechanism similar to brace hanging (@pxref{Hanging Braces}), | 3461 | Using a mechanism similar to brace hanging (@pxref{Hanging Braces}), |
| 3463 | colons can also be made to hang using the style variable | 3462 | colons 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 |
| 3465 | determines its syntactic context, looks this up in the alist | 3464 | determines 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 |
| 3467 | accordingly. Here, however, If @ccmode fails to find an entry for a | 3466 | accordingly. 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 |
| 3476 | The syntactic symbols appropriate as keys in this association list | 3475 | The syntactic symbols appropriate as keys in this association list |
| 3477 | are: @code{case-label}, @code{label}, @code{access-label}, | 3476 | are: @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 |
| 3479 | Symbols}. Elements with any other value as a key get ignored. | 3478 | Symbols}. 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 |
| 3482 | The @var{action} here is simply a list containing a combination of the | 3481 | The @var{action} here is simply a list containing a combination of the |
| 3483 | symbols @code{before} and @code{after}. Unlike in | 3482 | symbols @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 |
| 3485 | supported - there doesn't seem to be any need for them. | 3484 | supported; 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}, |
| 3915 | for a complete list of currently recognized syntactic symbols and | 3914 | for a complete list of currently recognized syntactic symbols and |
| 3916 | their semantics. The remaining entries are various data associated | 3915 | their semantics. The remaining entries are various data associated |
| 3917 | with the recognized construct - there might be zero or more. | 3916 | with the recognized construct; there might be zero or more. |
| 3918 | 3917 | ||
| 3919 | @cindex anchor position | 3918 | @cindex anchor position |
| 3920 | Conceptually, a line of code is always indented relative to some | 3919 | Conceptually, a line of code is always indented relative to some |
| @@ -4571,7 +4570,7 @@ example: | |||
| 4571 | Here, lines 4, 7, and 10 are all assigned @code{case-label} syntax, | 4570 | Here, lines 4, 7, and 10 are all assigned @code{case-label} syntax, |
| 4572 | while lines 5 and 8 are assigned @code{statement-case-intro}. Line 11 | 4571 | while lines 5 and 8 are assigned @code{statement-case-intro}. Line 11 |
| 4573 | is treated slightly differently since it contains a brace that opens a | 4572 | is treated slightly differently since it contains a brace that opens a |
| 4574 | block --- it is given @code{statement-case-open} syntax. | 4573 | block; 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 |
| 4800 | Line 4 is assigned both @code{defun-block-intro} @emph{and} | 4799 | Line 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 |
| 4803 | by another syntactic element which does have one. | 4802 | by 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 | |||
| 5333 | elements of the list don't get evaluated. | 5332 | elements of the list don't get evaluated. |
| 5334 | @item min | 5333 | @item min |
| 5335 | Use the minimum of all the offsets. All must be either relative or | 5334 | Use the minimum of all the offsets. All must be either relative or |
| 5336 | absolute - they can't be mixed. | 5335 | absolute; they can't be mixed. |
| 5337 | @item max | 5336 | @item max |
| 5338 | Use the maximum of all the offsets. All must be either relative or | 5337 | Use the maximum of all the offsets. All must be either relative or |
| 5339 | absolute - they can't be mixed. | 5338 | absolute; they can't be mixed. |
| 5340 | @item add | 5339 | @item add |
| 5341 | Add all the evaluated offsets together. Exactly one of them may be | 5340 | Add all the evaluated offsets together. Exactly one of them may be |
| 5342 | absolute, in which case the result is absolute. Any relative offsets | 5341 | absolute, in which case the result is absolute. Any relative offsets |
| @@ -5494,7 +5493,7 @@ any problems writing custom line-up functions for AWK mode. | |||
| 5494 | The calling convention for line-up functions is described fully in | 5493 | The 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 |
| 5496 | offset itself (such as @code{+} or @code{[0]}) or it's @code{nil}, | 5495 | offset itself (such as @code{+} or @code{[0]}) or it's @code{nil}, |
| 5497 | meaning ``this function is inappropriate in this case - try a | 5496 | meaning ``this function is inappropriate in this case; try a |
| 5498 | different one''. @xref{c-offsets-alist}. | 5497 | different one''. @xref{c-offsets-alist}. |
| 5499 | 5498 | ||
| 5500 | The subsections below describe all the standard line-up functions, | 5499 | The 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-) |
| 6517 | Some syntactic symbols, e.g., @code{arglist-cont-nonempty}, have more | 6516 | Some syntactic symbols, e.g., @code{arglist-cont-nonempty}, have more |
| 6518 | info in the syntactic element - typically other positions that can be | 6517 | info in the syntactic element: typically other positions that can be |
| 6519 | interesting besides the anchor position. That info can't be accessed | 6518 | interesting besides the anchor position. That info can't be accessed |
| 6520 | through the passed argument, which is a cons cell. Instead, you can | 6519 | through the passed argument, which is a cons cell. Instead, you can |
| 6521 | get this information from the variable @code{c-syntactic-element}, | 6520 | get this information from the variable @code{c-syntactic-element}, |
| 6522 | which is dynamically bound to the complete syntactic element. The | 6521 | which is dynamically bound to the complete syntactic element. The |
| 6523 | variable @code{c-syntactic-context} might also be useful - it gets | 6522 | variable @code{c-syntactic-context} might also be useful: it gets |
| 6524 | dynamically bound to the complete syntactic context. @xref{Custom | 6523 | dynamically bound to the complete syntactic context. @xref{Custom |
| 6525 | Braces}. | 6524 | Braces}. |
| 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 |
| 7 | This file documents the GNU Emacs Common Lisp emulation package. | 7 | This file documents the GNU Emacs Common Lisp emulation package. |
| 8 | 8 | ||
| 9 | Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. | 9 | Copyright @copyright{} 1993, 2001--2013 Free Software Foundation, Inc. |
| 10 | 10 | ||
| 11 | @quotation | 11 | @quotation |
| 12 | Permission is granted to copy, distribute and/or modify this document | 12 | Permission 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 | |||
| 17 | is included in the section entitled ``GNU Free Documentation License''. | 17 | is 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 |
| 20 | modify this GNU manual. Buying copies from the FSF supports it in | 20 | modify this GNU manual.'' |
| 21 | developing 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 |
| 12 | Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. | 12 | Copyright @copyright{} 2007--2013 Free Software Foundation, Inc. |
| 13 | 13 | ||
| 14 | @quotation | 14 | @quotation |
| 15 | Permission is granted to copy, distribute and/or modify this document | 15 | Permission 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 | |||
| 20 | is included in the section entitled ``GNU Free Documentation License''. | 20 | is 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 23 | modify this GNU manual.'' |
| 24 | developing 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 |
| 22 | Copyright @copyright{} 1994-1995, 1999, 2001-2012 | 22 | Copyright @copyright{} 1994--1995, 1999, 2001--2013 |
| 23 | Free Software Foundation, Inc. | 23 | Free 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 | |||
| 31 | is included in the section entitled ``GNU Free Documentation License''. | 31 | is 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 |
| 34 | modify this GNU manual. Buying copies from the FSF supports it in | 34 | modify this GNU manual.'' |
| 35 | developing 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 |
| 11 | This file documents Ebrowse, a C++ class browser for GNU Emacs. | 11 | This file documents Ebrowse, a C++ class browser for GNU Emacs. |
| 12 | 12 | ||
| 13 | Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. | 13 | Copyright @copyright{} 2000--2013 Free Software Foundation, Inc. |
| 14 | 14 | ||
| 15 | @quotation | 15 | @quotation |
| 16 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 | |||
| 21 | is included in the section entitled ``GNU Free Documentation License''. | 21 | is 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 |
| 24 | modify this GNU manual. Buying copies from the FSF supports it in | 24 | modify this GNU manual.'' |
| 25 | developing 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 | ||
| 51 | You can browse C++ class hierarchies from within Emacs by using | 50 | You 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 | ||
| 74 | When working in software projects using C++, I frequently missed | 73 | When 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 | ||
| 1242 | Ebrowse provides tags functions similar to those of the standard | 1212 | Ebrowse 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 | |||
| 1441 | in on with the command @kbd{C-c C-m m}. | 1405 | in 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 |
| 6 | This file describes EDE, the Emacs Development Environment. | 6 | This file describes EDE, the Emacs Development Environment. |
| 7 | 7 | ||
| 8 | Copyright @copyright{} 1998-2001, 2004-2005, 2008-2012 Free Software Foundation, Inc. | 8 | Copyright @copyright{} 1998--2001, 2004--2005, 2008--2013 |
| 9 | Free Software Foundation, Inc. | ||
| 9 | 10 | ||
| 10 | @quotation | 11 | @quotation |
| 11 | Permission is granted to copy, distribute and/or modify this document | 12 | Permission 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 | |||
| 16 | is included in the section entitled ``GNU Free Documentation License.'' | 17 | is 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 |
| 19 | modify this GNU manual. Buying copies from the FSF supports it in | 20 | modify this GNU manual.'' |
| 20 | developing 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 | |||
| 125 | documentation or interface files. @ede{} can provide this | 126 | documentation or interface files. @ede{} can provide this |
| 126 | information. | 127 | information. |
| 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{} | |||
| 142 | commands. These menu items, and their corresponding keybindings, are | 143 | commands. These menu items, and their corresponding keybindings, are |
| 143 | independent of the type of project you are actually working on. | 144 | independent 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 | ||
| 148 | Once you have @ede{} enabled, you can create a project. This chapter | 149 | Once you have @ede{} enabled, you can create a project. This chapter |
| @@ -438,7 +439,7 @@ C-c . R RET RET | |||
| 438 | If your program takes command line arguments, you can type them in | 439 | If your program takes command line arguments, you can type them in |
| 439 | when it offers the command line you want to use to run your program. | 440 | when 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 | ||
| 444 | To create a new project, first visit a file that you want to include | 445 | To 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 | |||
| 496 | the toplevel project handles subprojects in the build process is | 497 | the toplevel project handles subprojects in the build process is |
| 497 | dependent on that project's type. | 498 | dependent 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 | ||
| 502 | In this chapter, we describe the generic features for manipulating | 503 | In this chapter, we describe the generic features for manipulating |
| @@ -677,7 +678,7 @@ block for ``configurations''. Add a new named configuration here. | |||
| 677 | To switch between different active configurations, modify the | 678 | To 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 | ||
| 697 | These commands are also available from the @samp{Development} menu. | 698 | These 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 | ||
| 702 | If you opt to go in and edit @ede{} project files directly---for | 703 | If 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 | |||
| 1092 | methods. See the code in @file{ede-locate.el} for GNU Global as a | 1093 | methods. See the code in @file{ede-locate.el} for GNU Global as a |
| 1093 | simple example. | 1094 | simple 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 | ||
| 1098 | This chapter is intended for users who want to write new parts or fix | 1099 | This 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 | |||
| 1109 | is saved, or how a target is compiled can be customized by a project | 1110 | is saved, or how a target is compiled can be customized by a project |
| 1110 | author in detail. @ede{} communicates to these project objects via an | 1111 | author in detail. @ede{} communicates to these project objects via an |
| 1111 | API using methods. The commands you use in @ede{} mode are high-level | 1112 | API using methods. The commands you use in @ede{} mode are high-level |
| 1112 | functional wrappers over these methods. @xref{(eieio)Top}. For | 1113 | functional wrappers over these methods. @xref{Top,,, eieio, EIEIO manual}. For |
| 1113 | details on using @eieio{} to extending classes, and writing methods. | 1114 | details on using @eieio{} to extending classes, and writing methods. |
| 1114 | 1115 | ||
| 1115 | If you intend to extend @ede{}, it is most likely that a new target type is | 1116 | If 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 | |||
| 1360 | override this unless you keep auxiliary files. | 1361 | override this unless you keep auxiliary files. |
| 1361 | @end table | 1362 | @end table |
| 1362 | 1363 | ||
| 1363 | These methods are used by the semantic package extensions @xref{(semantic)Top}. | 1364 | These 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 @@ | |||
| 25 | This file documents Ediff, a comprehensive visual interface to Unix diff | 25 | This file documents Ediff, a comprehensive visual interface to Unix diff |
| 26 | and patch utilities. | 26 | and patch utilities. |
| 27 | 27 | ||
| 28 | Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. | 28 | Copyright @copyright{} 1995--2013 Free Software Foundation, Inc. |
| 29 | 29 | ||
| 30 | @quotation | 30 | @quotation |
| 31 | Permission is granted to copy, distribute and/or modify this document | 31 | Permission 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 | |||
| 36 | is included in the section entitled ``GNU Free Documentation License''. | 36 | is 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 |
| 39 | modify this GNU manual. Buying copies from the FSF supports it in | 39 | modify this GNU manual.'' |
| 40 | developing 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 | |||
| 128 | extends Emerge, much of the functionality in Ediff is influenced by Emerge. | 127 | extends Emerge, much of the functionality in Ediff is influenced by Emerge. |
| 129 | The architecture and the interface are, of course, drastically different. | 128 | The 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 | ||
| 134 | When Ediff starts up, it displays a small control window, which accepts the | 133 | When Ediff starts up, it displays a small control window, which accepts the |
| @@ -398,7 +397,7 @@ Moreover, the functions @code{ediff-directory-revisions}, | |||
| 398 | related Ediff sessions by taking a directory and comparing (or merging) | 397 | related Ediff sessions by taking a directory and comparing (or merging) |
| 399 | versions of files in that directory. | 398 | versions 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 | ||
| 404 | All Ediff commands are displayed in a Quick Help window, unless you type | 403 | All 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. | |||
| 557 | Makes the very first difference region current. | 556 | Makes 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' |
| 560 | makes the difference region N current. Typing -N (a negative number) then | 559 | makes 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 | ||
| 918 | The following commands can be invoked from within any Ediff session, | 917 | The 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 |
| 956 | The use of the toolbar can also be specified via the variable | 955 | The 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 |
| 958 | only in @file{.emacs} --- do @strong{not} change it interactively. Use the | 957 | only in @file{.emacs}: do @strong{not} change it interactively. Use the |
| 959 | function @code{ediff-toggle-use-toolbar} instead. | 958 | function @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 | |||
| 978 | profiling of ediff commands. | 977 | profiling 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 | ||
| 984 | Ediff maintains a registry of all its invocations that are | 983 | Ediff 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, | |||
| 1009 | but you don't need to memorize them, since they are listed at the top of | 1008 | but you don't need to memorize them, since they are listed at the top of |
| 1010 | the registry buffer. | 1009 | the 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 | ||
| 1015 | Several major entries of Ediff perform comparison and merging on | 1014 | Several 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 | ||
| 1134 | Ediff works with remote, compressed, and encrypted files. Ediff | 1133 | Ediff 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 | |||
| 1151 | of the patch is placed into the file source-name (@file{_orig} is used | 1150 | of the patch is placed into the file source-name (@file{_orig} is used |
| 1152 | on systems like DOS, etc.) | 1151 | on 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 | ||
| 1157 | Ediff has a rather self-explanatory interface, and in most cases you | 1156 | Ediff 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 | ||
| 1193 | The bulk of customization can be done via the following hooks: | 1192 | The 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 |
| 1330 | Hooks run just after setting up the @code{ediff-meta-buffer-map} --- the | 1329 | Hooks run just after setting up the @code{ediff-meta-buffer-map}, the |
| 1331 | map that controls key bindings in the meta buffer. Since | 1330 | map 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 |
| 1333 | bindings for different kinds of meta buffers. | 1332 | bindings 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 | |||
| 1357 | the variable @code{ediff-help-message}, which is local to | 1356 | the 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 | ||
| 1363 | On a non-windowing display, Ediff sets things up in one frame, splitting | 1362 | On 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 | |||
| 1494 | to another control panel. (Different control panel buffers are | 1493 | to another control panel. (Different control panel buffers are |
| 1495 | distinguished by a numerical suffix, e.g., @samp{Ediff Control Panel<3>}.) | 1494 | distinguished 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 | ||
| 1500 | Sometimes it is convenient to be able to step through only some difference | 1499 | Sometimes 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 | |||
| 1609 | When case sensitivity is toggled, all difference | 1608 | When case sensitivity is toggled, all difference |
| 1610 | regions are recomputed. | 1609 | regions 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 | ||
| 1615 | The following variables control the way Ediff highlights difference | 1614 | The following variables control the way Ediff highlights difference |
| @@ -1736,7 +1735,7 @@ faces, you can modify them when Ediff is being loaded using | |||
| 1736 | or @code{set/make-face-@dots{}} as shown above. Emacs's low-level | 1735 | or @code{set/make-face-@dots{}} as shown above. Emacs's low-level |
| 1737 | face-manipulation functions should be avoided. | 1736 | face-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 | ||
| 1742 | If buffers being compared are narrowed at the time of invocation of | 1741 | If 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 | |||
| 1768 | that existed before the current invocation. | 1767 | that 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 | ||
| 1774 | Ediff has variables to control the way fine differences are | 1773 | Ediff has variables to control the way fine differences are |
| @@ -1840,7 +1839,7 @@ command @kbd{@@}. Repeated typing of this key cycles through three | |||
| 1840 | different states: auto-refining, no-auto-refining, and no-highlighting | 1839 | different states: auto-refining, no-auto-refining, and no-highlighting |
| 1841 | of fine differences. | 1840 | of 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 | ||
| 1846 | This section describes variables that specify the programs to be used for | 1845 | This 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 | ||
| 1955 | Ediff supports three-way comparison via the functions @code{ediff-files3} and | 1954 | Ediff supports three-way comparison via the functions @code{ediff-files3} and |
| @@ -2153,7 +2152,7 @@ When merge buffers are saved automatically as directed by | |||
| 2153 | specified by the variable @code{ediff-merge-filename-prefix}. The default | 2152 | specified by the variable @code{ediff-merge-filename-prefix}. The default |
| 2154 | is @code{merge_}, but this can be changed by the user. | 2153 | is @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 |
| 2199 | function. | 2198 | function. |
| 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 | ||
| 2204 | When Ediff is running, the mode line of @samp{Ediff Control Panel} | 2203 | When 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 | ||
| 2223 | Here are a few other variables for customizing Ediff: | 2222 | Here 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 | ||
| 2340 | Some users need to customize Ediff in rather sophisticated ways, which | 2339 | Some 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 | |||
| 2403 | the control buffer is in its own frame. | 2402 | the 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 | ||
| 2409 | Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired | 2408 | Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired |
| @@ -2521,12 +2520,12 @@ Ilya Zakharevich (ilya at math.ohio-state.edu), | |||
| 2521 | Eli Zaretskii (eliz at is.elta.co.il) | 2520 | Eli 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 |
| 6 | This file documents the EDT emulation package for Emacs. | 6 | This file documents the EDT emulation package for Emacs. |
| 7 | 7 | ||
| 8 | Copyright @copyright{} 1986, 1992, 1994-1995, 1999-2012 | 8 | Copyright @copyright{} 1986, 1992, 1994--1995, 1999--2013 |
| 9 | Free Software Foundation, Inc. | 9 | Free 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 | |||
| 17 | is included in the section entitled ``GNU Free Documentation License''. | 17 | is 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 |
| 20 | modify this GNU manual. Buying copies from the FSF supports it in | 20 | modify this GNU manual.'' |
| 21 | developing 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 |
| 125 | without built-in support. | 124 | without 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 |
| 12 | This manual documents EIEIO, an object framework for Emacs Lisp. | 12 | This manual documents EIEIO, an object framework for Emacs Lisp. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 2007--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License.'' | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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 |
| 448 | An unquoted type specifier used to validate data set into this slot. | 448 | An unquoted type specifier used to validate data set into this slot. |
| 449 | @xref{(cl)Type Predicates}. | 449 | @xref{Type Predicates,,,cl,Common Lisp Extensions}. |
| 450 | Here are some examples: | 450 | Here 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 | ||
| 1572 | Each class will be indexed using the texinfo labeled index | 1572 | Each 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 | ||
| 1576 | To use this command, the texinfo macro | 1576 | To 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 |
| 1876 | Specifier uses the @code{typep} function from the @file{cl} | 1876 | Specifier uses the @code{typep} function from the @file{cl} |
| 1877 | package. @xref{(cl)Type Predicates}. It therefore has the same issues as | 1877 | package. @xref{Type Predicates,,,cl,Common Lisp Extensions}. |
| 1878 | that package. Extensions include the ability to provide object names. | 1878 | It therefore has the same issues as that package. Extensions include |
| 1879 | the ability to provide object names. | ||
| 1879 | @end table | 1880 | @end table |
| 1880 | 1881 | ||
| 1881 | Defclass also supports class options, but does not currently use values | 1882 | Defclass also supports class options, but does not currently use values |
| @@ -1950,6 +1951,10 @@ buffers. | |||
| 1950 | Allow method overloading of method-like functions in Emacs. | 1951 | Allow 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 |
| 9 | This file describes the Emacs GnuTLS integration. | 9 | This file describes the Emacs GnuTLS integration. |
| 10 | 10 | ||
| 11 | Copyright @copyright{} 2012 Free Software Foundation, Inc. | 11 | Copyright @copyright{} 2012--2013 Free Software Foundation, Inc. |
| 12 | 12 | ||
| 13 | @quotation | 13 | @quotation |
| 14 | Permission is granted to copy, distribute and/or modify this document | 14 | Permission 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 | |||
| 16 | any later version published by the Free Software Foundation; with no | 16 | any later version published by the Free Software Foundation; with no |
| 17 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 17 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 18 | and with the Back-Cover Texts as in (a) below. A copy of the license | 18 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 19 | is included in the section entitled ``GNU Free Documentation License'' | 19 | is included in the section entitled ``GNU Free Documentation License''. |
| 20 | 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 22 | modify this GNU manual.'' |
| 24 | developing GNU and promoting software freedom.'' | ||
| 25 | |||
| 26 | This document is part of a collection distributed under the GNU Free | ||
| 27 | Documentation License. If you want to distribute this document | ||
| 28 | separately from the collection, you can do so by adding a copy of the | ||
| 29 | license 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, | |||
| 185 | but do not rely on this function's interface if possible. | 179 | but 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 |
| 12 | This file documents the Emacs MIME interface functionality. | 12 | This file documents the Emacs MIME interface functionality. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 1998-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 1998--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License''. | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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 | |||
| 1856 | Languages, and Continuations | 1855 | Languages, and Continuations |
| 1857 | 1856 | ||
| 1858 | @item RFC1843 | 1857 | @item RFC1843 |
| 1859 | HZ - A Data Format for Exchanging Files of Arbitrarily Mixed Chinese and | 1858 | HZ---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 |
| 10 | This file describes EasyPG Assistant @value{VERSION}. | 10 | This file describes EasyPG Assistant @value{VERSION}. |
| 11 | 11 | ||
| 12 | Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. | 12 | Copyright @copyright{} 2007--2013 Free Software Foundation, Inc. |
| 13 | 13 | ||
| 14 | @quotation | 14 | @quotation |
| 15 | Permission is granted to copy, distribute and/or modify this document | 15 | Permission 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 | |||
| 17 | any later version published by the Free Software Foundation; with no | 17 | any later version published by the Free Software Foundation; with no |
| 18 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 18 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 19 | and with the Back-Cover Texts as in (a) below. A copy of the license | 19 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 20 | is included in the section entitled ``GNU Free Documentation License'' | 20 | is included in the section entitled ``GNU Free Documentation License''. |
| 21 | in 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 |
| 24 | modify this GNU manual. Buying copies from the FSF supports it in | 23 | modify this GNU manual.'' |
| 25 | developing GNU and promoting software freedom.'' | ||
| 26 | |||
| 27 | This document is part of a collection distributed under the GNU Free | ||
| 28 | Documentation License. If you want to distribute this document | ||
| 29 | separately from the collection, you can do so by adding a copy of the | ||
| 30 | license 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 | |||
| 493 | of the @samp{ *epg-debug*} buffer. Note that the first letter of the | 487 | of the @samp{ *epg-debug*} buffer. Note that the first letter of the |
| 494 | buffer name is a whitespace. | 488 | buffer 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 |
| 10 | This manual is for ERC as distributed with Emacs @value{EMACSVER}. | 10 | This manual is for ERC as distributed with Emacs @value{EMACSVER}. |
| 11 | 11 | ||
| 12 | Copyright @copyright{} 2005-2012 Free Software Foundation, Inc. | 12 | Copyright @copyright{} 2005--2013 Free Software Foundation, Inc. |
| 13 | 13 | ||
| 14 | @quotation | 14 | @quotation |
| 15 | Permission is granted to copy, distribute and/or modify this document | 15 | Permission 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 | |||
| 20 | is included in the section entitled ``GNU Free Documentation License''. | 20 | is 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 23 | modify this GNU manual.'' |
| 24 | developing GNU and promoting software freedom.'' | ||
| 25 | 24 | ||
| 26 | All Emacs Lisp code contained in this document may be used, distributed, | 25 | All Emacs Lisp code contained in this document may be used, distributed, |
| 27 | and modified without restriction. | 26 | and 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 |
| 13 | Copyright @copyright{} 2008, 2010-2012 Free Software Foundation, Inc. | 13 | Copyright @copyright{} 2008, 2010--2013 Free Software Foundation, Inc. |
| 14 | 14 | ||
| 15 | @quotation | 15 | @quotation |
| 16 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 | |||
| 18 | any later version published by the Free Software Foundation; with no | 18 | any later version published by the Free Software Foundation; with no |
| 19 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 19 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 20 | and with the Back-Cover Texts as in (a) below. A copy of the license | 20 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 21 | is included in the section entitled ``GNU Free Documentation License'' | 21 | is included in the section entitled ``GNU Free Documentation License''. |
| 22 | in 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 24 | modify this GNU manual.'' |
| 26 | developing GNU and promoting software freedom.'' | ||
| 27 | |||
| 28 | This document is part of a collection distributed under the GNU Free | ||
| 29 | Documentation License. If you want to distribute this document | ||
| 30 | separately from the collection, you can do so by adding a copy of the | ||
| 31 | license 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 | ||
| 38 | ERT is a tool for automated testing in Emacs Lisp. Its main features | 31 | ERT 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 | ||
| 82 | Appendix | ||
| 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 | ||
| 94 | ERT allows you to define @emph{tests} in addition to functions, | 92 | ERT allows you to define @emph{tests} in addition to functions, |
| 95 | macros, variables, and the other usual Lisp constructs. Tests are | 93 | macros, variables, and the other usual Lisp constructs. Tests are |
| 96 | simply Lisp code --- code that invokes other code and checks whether | 94 | simply Lisp code: code that invokes other code and checks whether |
| 97 | it behaves as expected. | 95 | it behaves as expected. |
| 98 | 96 | ||
| 99 | ERT keeps track of the tests that are defined and provides convenient | 97 | ERT 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 | |||
| 134 | better error reporting. @xref{The @code{should} Macro}. | 132 | better error reporting. @xref{The @code{should} Macro}. |
| 135 | 133 | ||
| 136 | Each test should have a name that describes what functionality it tests. | 134 | Each test should have a name that describes what functionality it tests. |
| 137 | Test names can be chosen arbitrarily --- they are in a | 135 | Test names can be chosen arbitrarily---they are in a |
| 138 | namespace separate from functions and variables --- but should follow | 136 | namespace separate from functions and variables---but should follow |
| 139 | the usual Emacs Lisp convention of having a prefix that indicates | 137 | the usual Emacs Lisp convention of having a prefix that indicates |
| 140 | which package they belong to. Test names are displayed by ERT when | 138 | which package they belong to. Test names are displayed by ERT when |
| 141 | reporting failures and can be used when selecting which tests to run. | 139 | reporting 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 | |||
| 156 | Environment}. | 154 | Environment}. |
| 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 | ||
| 162 | You can run tests either in the Emacs you are working in, or on the | 160 | You 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 | ||
| 180 | You can run the tests that are currently defined in your Emacs with | 178 | You 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 | |||
| 253 | of the expression. | 251 | of 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 | ||
| 259 | ERT supports automated invocations from the command line or from | 257 | ERT 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 | |||
| 277 | files that it requires are on your @code{load-path}. | 275 | files 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 | ||
| 283 | Functions like @code{ert} accept a @emph{test selector}, a Lisp | 281 | Functions 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 | ||
| 322 | ERT lets you define tests in the same way you define functions. You | 320 | ERT 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 | ||
| 342 | Test bodies can include arbitrary code; but to be useful, they need to | 340 | Test 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 | ||
| 406 | Some bugs are complicated to fix, or not very important, and are left as | 404 | Some 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 | ||
| 459 | The outcome of running a test should not depend on the current state | 457 | The 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 | |||
| 504 | Instead, it is better to use lower-level mechanisms with simple and | 502 | Instead, it is better to use lower-level mechanisms with simple and |
| 505 | predictable semantics like @code{with-temp-buffer}, @code{insert} or | 503 | predictable 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 |
| 507 | by calling the corresponding function directly --- after binding the | 505 | by calling the corresponding function directly, after binding the |
| 508 | hook variables to nil. This avoids the above problems. | 506 | hook 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 | ||
| 514 | Testing simple functions that have no side effects and no dependencies | 512 | Testing simple functions that have no side effects and no dependencies |
| @@ -561,9 +559,9 @@ could be used instead. | |||
| 561 | The reason why this test only checks the first line of the backtrace | 559 | The reason why this test only checks the first line of the backtrace |
| 562 | is that the remainder of the backtrace is dependent on ERT's internals | 560 | is that the remainder of the backtrace is dependent on ERT's internals |
| 563 | as well as whether the code is running interpreted or compiled. By | 561 | as well as whether the code is running interpreted or compiled. By |
| 564 | looking only at the first line, the test checks a useful property | 562 | looking only at the first line, the test checks a useful property---that |
| 565 | --- that the backtrace correctly captures the call to @code{signal} that | 563 | the backtrace correctly captures the call to @code{signal} that |
| 566 | results from the call to @code{ert-fail} --- without being brittle. | 564 | results from the call to @code{ert-fail}---without being brittle. |
| 567 | 565 | ||
| 568 | This example also shows that writing tests is much easier if the code | 566 | This example also shows that writing tests is much easier if the code |
| 569 | under test was structured with testing in mind. | 567 | under test was structured with testing in mind. |
| @@ -589,7 +587,7 @@ for testing. Usually, this makes the interfaces easier to use as | |||
| 589 | well. | 587 | well. |
| 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 | ||
| 595 | This section describes how to use ERT's features to understand why | 593 | This 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 | ||
| 608 | Failed @code{should} forms are reported like this: | 606 | Failed @code{should} forms are reported like this: |
| @@ -669,7 +667,7 @@ ERT only provides explanations for predicates that have an explanation | |||
| 669 | function registered. @xref{Defining Explanation Functions}. | 667 | function 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 | ||
| 675 | Debugging failed tests essentially works the same way as debugging any | 673 | Debugging failed tests essentially works the same way as debugging any |
| @@ -701,12 +699,12 @@ strips them out, so it is more convenient. | |||
| 701 | failed. This can be useful to figure out how far it got. | 699 | failed. 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 |
| 705 | type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and | 703 | type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and |
| 706 | re-run the test with @kbd{r} or @kbd{d}. | 704 | re-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 |
| 709 | ERT remembers an old test that you have since renamed or removed --- | 707 | ERT remembers an old test that you have since renamed or removed: |
| 710 | renamings or removals of definitions in the source code leave around a | 708 | renamings or removals of definitions in the source code leave around a |
| 711 | stray definition under the old name in the running process (this is a | 709 | stray definition under the old name in the running process (this is a |
| 712 | common problem in Lisp). In such a situation, hit @kbd{D} to let ERT | 710 | common 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 | ||
| 720 | There are several ways to add functionality to ERT. | 718 | There 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 | ||
| 731 | The explanation function for a predicate is a function that takes the | 729 | The 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 | |||
| 743 | explanation function. | 741 | explanation 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 | ||
| 749 | Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} | 747 | Both @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. | |||
| 759 | Contributions to ERT are welcome. | 757 | Contributions 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 | ||
| 765 | For information on mocks, stubs, fixtures, or test suites, see below. | 763 | For 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 | ||
| 776 | Stubbing out functions or using so-called @emph{mocks} can make it | 774 | Stubbing 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 | |||
| 783 | offers mocks for Emacs Lisp and can be used in conjunction with ERT. | 781 | offers 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 | ||
| 789 | In many ways, ERT is similar to frameworks for other languages like | 787 | In 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 | |||
| 842 | often. This can be achieved with the @code{:tag} argument to | 840 | often. 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 |
| 9 | This manual is for Eshell, the Emacs shell. | 9 | This manual is for Eshell, the Emacs shell. |
| 10 | 10 | ||
| 11 | Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. | 11 | Copyright @copyright{} 1999--2013 Free Software Foundation, Inc. |
| 12 | 12 | ||
| 13 | @quotation | 13 | @quotation |
| 14 | Permission is granted to copy, distribute and/or modify this document | 14 | Permission 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 | |||
| 19 | is included in the section entitled ``GNU Free Documentation License''. | 19 | is 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 |
| 22 | modify this GNU manual. Buying copies from the FSF supports it in | 22 | modify this GNU manual.'' |
| 23 | developing 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 | ||
| 64 | Eshell is a shell-like command interpreter | 63 | Eshell 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 | |||
| 12 | directory servers using various protocols such as LDAP or the CCSO white | 12 | directory servers using various protocols such as LDAP or the CCSO white |
| 13 | pages directory system (PH/QI) | 13 | pages directory system (PH/QI) |
| 14 | 14 | ||
| 15 | Copyright @copyright{} 1998, 2000-2012 Free Software Foundation, Inc. | 15 | Copyright @copyright{} 1998, 2000--2013 Free Software Foundation, Inc. |
| 16 | 16 | ||
| 17 | @quotation | 17 | @quotation |
| 18 | Permission is granted to copy, distribute and/or modify this document | 18 | Permission 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 | |||
| 23 | is included in the section entitled ``GNU Free Documentation License''. | 23 | is 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 |
| 26 | modify this GNU manual. Buying copies from the FSF supports it in | 26 | modify this GNU manual.'' |
| 27 | developing 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 | ||
| 77 | EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user | 74 | EUDC, 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 | ||
| 123 | LDAP, @dfn{the Lightweight Directory Access Protocol}, is a communication | 119 | LDAP, @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 | ||
| 150 | The Central Computing Services Office (CCSO) of the University of | 145 | The 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 | |||
| 165 | EUDC. | 160 | EUDC. |
| 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 | ||
| 172 | BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs | 166 | BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs |
| @@ -188,8 +182,7 @@ performing queries on multiple servers. | |||
| 188 | EUDC also offers a means to insert results from directory queries into | 182 | EUDC also offers a means to insert results from directory queries into |
| 189 | your own local BBDB (@pxref{Creating BBDB Records}) | 183 | your 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 | ||
| 195 | Add the following to your @file{.emacs} init file: | 188 | Add 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 | ||
| 226 | LDAP support is added by means of @file{ldap.el}, which is part of Emacs. | 218 | LDAP 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 | ||
| 236 | This chapter describes the usage of EUDC@. Most functions and | 227 | This 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 | ||
| 256 | EUDC's basic functionality is to let you query a directory server and | 246 | EUDC'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 | ||
| 270 | Before doing any query you will need to set the directory server. You | 260 | Before 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 | |||
| 303 | new directory server and protocol. | 293 | new 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 | ||
| 309 | Directory servers may be configured to return a default set of | 299 | Directory 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 | |||
| 327 | attributes are ignored. Default is @code{t}. | 317 | attributes 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 | ||
| 333 | Directory standards may authorize different instances of the same | 323 | Directory 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 | ||
| 389 | The simplest way to query your directory server is to use the query | 378 | The 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 | |||
| 437 | names defined in @code{eudc-user-attribute-names-alist}. | 426 | names 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 | ||
| 444 | Upon successful completion of a form query, EUDC will display a buffer | 432 | Upon 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 | ||
| 522 | Inline query expansion is a powerful method to get completion from your | 509 | Inline 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 | ||
| 623 | EUDC lets you maintain a list of frequently used servers so that you | 609 | EUDC 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 | ||
| 662 | The hotlist edit buffer offers a means to manage a list of frequently | 647 | The 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 | ||
| 699 | When using inline query expansion (@pxref{Inline Query Expansion}), EUDC | 683 | When 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 | |||
| 840 | actually be inserted as part of the newly created BBDB record. | 823 | actually 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 | ||
| 847 | EUDC can be customized independently for each server or directory | 829 | EUDC 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 | ||
| 860 | EUDC offers functions that let you set and query variables on a per | 841 | EUDC 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 | ||
| 938 | EUDC was written by Oscar Figueiredo based on @file{ph.el} by the | 918 | EUDC was written by Oscar Figueiredo based on @file{ph.el} by the |
| @@ -941,18 +921,16 @@ same author. | |||
| 941 | Thanks to Soren Dayton for his suggestions, his enthusiasm and his help | 921 | Thanks to Soren Dayton for his suggestions, his enthusiasm and his help |
| 942 | in testing and proofreading the code and docs of @file{ph.el}. | 922 | in 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 |
| 14 | Copyright @copyright{} 2001-2012 Free Software Foundation, Inc.@* | 14 | Copyright @copyright{} 2001--2013 Free Software Foundation, Inc.@* |
| 15 | Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000 | 15 | Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000 |
| 16 | Reuven M. Lerner@* | 16 | Reuven M. Lerner@* |
| 17 | Copyright @copyright{} 1992, 1993 Steven Byrnes@* | 17 | Copyright @copyright{} 1992, 1993 Steven Byrnes@* |
| @@ -2738,7 +2738,7 @@ type @kbd{C-h C-p} to read it. | |||
| 2738 | 2738 | ||
| 2739 | Old versions (i.e., anything before 19.29) of Emacs had problems editing | 2739 | Old versions (i.e., anything before 19.29) of Emacs had problems editing |
| 2740 | files larger than 8 megabytes. In versions 19.29 and later, the maximum | 2740 | files larger than 8 megabytes. In versions 19.29 and later, the maximum |
| 2741 | buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. | 2741 | buffer size is at least 2^27@minus{}1, or 134,217,727 bytes, or 132 MBytes. |
| 2742 | The maximum buffer size on 32-bit machines increased to 256 MBytes in | 2742 | The maximum buffer size on 32-bit machines increased to 256 MBytes in |
| 2743 | Emacs 22, and again to 512 MBytes in Emacs 23.2. | 2743 | Emacs 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 @@ | |||
| 11 | This manual is for GNU Flymake (version @value{VERSION}, @value{UPDATED}), | 11 | This manual is for GNU Flymake (version @value{VERSION}, @value{UPDATED}), |
| 12 | which is a universal on-the-fly syntax checker for GNU Emacs. | 12 | which is a universal on-the-fly syntax checker for GNU Emacs. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 2004-2012 | 14 | Copyright @copyright{} 2004--2013 Free Software Foundation, Inc. |
| 15 | Free Software Foundation, Inc. | ||
| 16 | 15 | ||
| 17 | @quotation | 16 | @quotation |
| 18 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 23 | is included in the section entitled ``GNU Free Documentation License''. | 22 | is 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 |
| 26 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 27 | developing 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 | ||
| 364 | Syntax check tools are configured using the | 362 | Syntax check tools are configured using the |
| @@ -408,8 +406,8 @@ the @code{flymake-err-line-patterns} list. | |||
| 408 | The following sections contain some examples of configuring Flymake | 406 | The following sections contain some examples of configuring Flymake |
| 409 | support for various syntax check tools. | 407 | support 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 | ||
| 415 | In this example, we will add support for @code{perl} as a syntax check | 413 | In 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 | ||
| 464 | In this example we will add support for C files syntax checked by | 462 | In this example we will add support for C files syntax checked by |
| @@ -530,7 +528,7 @@ check-syntax: | |||
| 530 | Syntax check is started by calling @code{flymake-start-syntax-check-for-current-buffer}. | 528 | Syntax check is started by calling @code{flymake-start-syntax-check-for-current-buffer}. |
| 531 | Flymake first determines whether it is able to do syntax | 529 | Flymake first determines whether it is able to do syntax |
| 532 | check. It then saves a copy of the buffer in a temporary file in the | 530 | check. It then saves a copy of the buffer in a temporary file in the |
| 533 | buffer's directory (or in the system temp directory -- for java | 531 | buffer's directory (or in the system temp directory, for java |
| 534 | files), creates a syntax check command and launches a process with | 532 | files), creates a syntax check command and launches a process with |
| 535 | this command. The output is parsed using a list of error message patterns, | 533 | this command. The output is parsed using a list of error message patterns, |
| 536 | and error information (file name, line number, type and text) is | 534 | and 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 |
| 19 | This file documents Forms mode, a form-editing major mode for GNU Emacs. | 19 | This file documents Forms mode, a form-editing major mode for GNU Emacs. |
| 20 | 20 | ||
| 21 | Copyright @copyright{} 1989, 1997, 2001-2012 Free Software Foundation, Inc. | 21 | Copyright @copyright{} 1989, 1997, 2001--2013 Free Software Foundation, Inc. |
| 22 | 22 | ||
| 23 | @quotation | 23 | @quotation |
| 24 | Permission is granted to copy, distribute and/or modify this document | 24 | Permission 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 | |||
| 29 | is included in the section entitled ``GNU Free Documentation License''. | 29 | is 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 |
| 32 | modify this GNU manual. Buying copies from the FSF supports it in | 32 | modify this GNU manual.'' |
| 33 | developing 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 |
| 10 | Copyright @copyright{} 2004-2005, 2007-2012 Free Software | 10 | Copyright @copyright{} 2004--2005, 2007--2013 Free Software |
| 11 | Foundation, Inc. | 11 | Foundation, Inc. |
| 12 | 12 | ||
| 13 | @quotation | 13 | @quotation |
| 14 | Permission is granted to copy, distribute and/or modify this document | 14 | Permission is granted to copy, distribute and/or modify this document |
| 15 | under the terms of the GNU Free Documentation License, Version 1.3 or | 15 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| 16 | any later version published by the Free Software Foundation; with no | 16 | any later version published by the Free Software Foundation; with no |
| 17 | Invariant Sections, with the Front-Cover texts being ``A GNU | 17 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', |
| 18 | Manual'', and with the Back-Cover Texts as in (a) below. A copy of the | 18 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 19 | license is included in the section entitled ``GNU Free Documentation | 19 | is included in the section entitled ``GNU Free Documentation License''. |
| 20 | License'' 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 22 | modify this GNU manual.'' |
| 24 | developing GNU and promoting software freedom.'' | ||
| 25 | |||
| 26 | This document is part of a collection distributed under the GNU Free | ||
| 27 | Documentation License. If you want to distribute this document | ||
| 28 | separately from the collection, you can do so by adding a copy of the | ||
| 29 | license 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). |
| 308 | Because of this, when the next major version of Gnus will be included in | 302 | Because of this, when the next major version of Gnus will be included in |
| 309 | Emacs, it should be very easy -- just plonk in the files from the Gnus | 303 | Emacs, it should be very easy---just plonk in the files from the Gnus |
| 310 | trunk without worrying about lost changes from the Emacs tree. | 304 | trunk without worrying about lost changes from the Emacs tree. |
| 311 | 305 | ||
| 312 | The effect of this is that as hacker, you should generally only have to | 306 | The 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 | ||
| 321 | If you don't have Emacs bzr access (or it's inconvenient), you can | 315 | If you don't have Emacs bzr access (or it's inconvenient), you can |
| 322 | change such a file in the v5-10 branch, and it should propagate to Emacs | 316 | change such a file in the v5-10 branch, and it should propagate to Emacs |
| 323 | bzr -- however, it will get some extra scrutiny (by Miles) to see if the | 317 | bzr---however, it will get some extra scrutiny (by Miles) to see if the |
| 324 | changes are possibly controversial and need discussion on the mailing | 318 | changes are possibly controversial and need discussion on the mailing |
| 325 | list. Many changes are obvious bug-fixes however, so often there won't | 319 | list. Many changes are obvious bug-fixes however, so often there won't |
| 326 | be any problem. | 320 | be any problem. |
| @@ -335,7 +329,7 @@ including improvements on the documentation. | |||
| 335 | If you know that there will be conflicts (perhaps because the affected | 329 | If you know that there will be conflicts (perhaps because the affected |
| 336 | source code is different in v5-10 and the Gnus git trunk), then you can | 330 | source code is different in v5-10 and the Gnus git trunk), then you can |
| 337 | install your change in both places, and when I try to sync them, there | 331 | install your change in both places, and when I try to sync them, there |
| 338 | will be a conflict -- however, since in most such cases there would be a | 332 | will be a conflict---however, since in most such cases there would be a |
| 339 | conflict @emph{anyway}, it's often easier for me to resolve it simply if | 333 | conflict @emph{anyway}, it's often easier for me to resolve it simply if |
| 340 | I see two @samp{identical} changes, and can just choose the proper one, | 334 | I see two @samp{identical} changes, and can just choose the proper one, |
| 341 | rather than having to actually fix the code. | 335 | rather 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}. | |||
| 387 | The same applies for customizable variables when its default value was | 381 | The same applies for customizable variables when its default value was |
| 388 | changed. | 382 | changed. |
| 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 | ||
| 81 | This FAQ was maintained by Justin Sheehy until March 2002. He | 81 | This FAQ was maintained by Justin Sheehy until March 2002. He |
| 82 | would like to thank Steve Baur and Per Abrahamsen for doing a wonderful | 82 | would like to thank Steve Baur and Per Abrahamsen for doing a wonderful |
| 83 | job with this FAQ before him. We would like to do the same - thanks, | 83 | job with this FAQ before him. We would like to do the same: thanks, |
| 84 | Justin! | 84 | Justin! |
| 85 | 85 | ||
| 86 | This version is much nicer than the unofficial hypertext | 86 | This version is much nicer than the unofficial hypertext |
| @@ -1038,7 +1038,7 @@ mail groups. Is this a bug? | |||
| 1038 | 1038 | ||
| 1039 | No, that's a matter of design of Gnus, fixing this would | 1039 | No, that's a matter of design of Gnus, fixing this would |
| 1040 | mean reimplementation of major parts of Gnus' | 1040 | mean reimplementation of major parts of Gnus' |
| 1041 | back ends. Gnus thinks "highest-article-number - | 1041 | back ends. Gnus thinks "highest-article-number @minus{} |
| 1042 | lowest-article-number = total-number-of-articles". This | 1042 | lowest-article-number = total-number-of-articles". This |
| 1043 | works OK for Usenet groups, but if you delete and move | 1043 | works OK for Usenet groups, but if you delete and move |
| 1044 | many messages in mail groups, this fails. To cure the | 1044 | many 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 | ||
| 29 | Copyright (C) 1999-2012 Free Software Foundation, Inc. | 29 | Copyright (C) 1999-2013 Free Software Foundation, Inc. |
| 30 | See the end of the file for license conditions. | 30 | See the end of the file for license conditions. |
| 31 | 31 | ||
| 32 | Please send Gnus bug reports to bugs@gnus.org. | 32 | Please 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 |
| 14 | Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 1995--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License''. | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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. | |||
| 1297 | variable defaults to @code{gnus-subscribe-alphabetically}. | 1296 | variable defaults to @code{gnus-subscribe-alphabetically}. |
| 1298 | 1297 | ||
| 1299 | The ``options -n'' format is very simplistic. The syntax above is all | 1298 | The ``options -n'' format is very simplistic. The syntax above is all |
| 1300 | that is supports -- you can force-subscribe hierarchies, or you can | 1299 | that is supports: you can force-subscribe hierarchies, or you can |
| 1301 | deny hierarchies, and that's it. | 1300 | deny 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 | |||
| 2144 | very old articles that will never be expired and the recent ones. In | 2143 | very old articles that will never be expired and the recent ones. In |
| 2145 | such a case, the server will return the data like @code{(1 . 30000000)} | 2144 | such a case, the server will return the data like @code{(1 . 30000000)} |
| 2146 | for the @code{LIST ACTIVE group} command, for example. Even if there | 2145 | for the @code{LIST ACTIVE group} command, for example. Even if there |
| 2147 | are actually only the articles 1-10 and 29999900-30000000, Gnus doesn't | 2146 | are actually only the articles 1--10 and 29999900--30000000, Gnus doesn't |
| 2148 | know it at first and prepares for getting 30000000 articles. However, | 2147 | know it at first and prepares for getting 30000000 articles. However, |
| 2149 | it will consume hundreds megabytes of memories and might make Emacs get | 2148 | it will consume hundreds megabytes of memories and might make Emacs get |
| 2150 | stuck as the case may be. If you use such news servers, set the | 2149 | stuck as the case may be. If you use such news servers, set the |
| 2151 | variable @code{gnus-newsgroup-maximum-articles} to a positive number. | 2150 | variable @code{gnus-newsgroup-maximum-articles} to a positive number. |
| 2152 | The value means that Gnus ignores articles other than this number of the | 2151 | The value means that Gnus ignores articles other than this number of the |
| 2153 | latest ones in every group. For instance, the value 10000 makes Gnus | 2152 | latest ones in every group. For instance, the value 10000 makes Gnus |
| 2154 | get only the articles 29990001-30000000 (if the latest article number is | 2153 | get only the articles 29990001--30000000 (if the latest article number is |
| 2155 | 30000000 in a group). Note that setting this variable to a number might | 2154 | 30000000 in a group). Note that setting this variable to a number might |
| 2156 | prevent you from reading very old articles. The default value of the | 2155 | prevent you from reading very old articles. The default value of the |
| 2157 | variable @code{gnus-newsgroup-maximum-articles} is @code{nil}, which | 2156 | variable @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 |
| 3647 | Describe browse mode briefly (well, there's not much to describe, is | 3646 | Describe browse mode briefly (well, there's not much to describe, is |
| 3648 | there) (@code{gnus-browse-describe-briefly}). | 3647 | there) (@code{gnus-browse-describe-briefly}). |
| 3648 | |||
| 3649 | @item DEL | ||
| 3650 | @kindex DEL (Browse) | ||
| 3651 | @findex gnus-browse-delete-group | ||
| 3652 | This function will delete the current group | ||
| 3653 | (@code{gnus-browse-delete-group}). If given a prefix, this function | ||
| 3654 | will actually delete all the articles in the group, and forcibly | ||
| 3655 | remove the group itself from the face of the Earth. Use a prefix only | ||
| 3656 | if 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, |
| 3825 | move the cursor to the beginning of the buffer (just below the ``Gnus'' | 3833 | move the cursor to the beginning of the buffer (just below the ``Gnus'' |
| 3826 | topic) and hit @kbd{C-y}. This is like the ``paste'' part of cut and | 3834 | topic) and hit @kbd{C-y}. This is like the ``paste'' part of cut and |
| 3827 | paste. Like I said -- E-Z. | 3835 | paste. Like I said---E-Z. |
| 3828 | 3836 | ||
| 3829 | You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics. So | 3837 | You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics. So |
| 3830 | you can move topics around as well as groups. | 3838 | you 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 |
| 13668 | the server. The server responds with one huge list of lines. However, | 13676 | the server. The server responds with one huge list of lines. However, |
| 13669 | if you have read articles 2-5000 in the group, and only want to read | 13677 | if you have read articles 2--5000 in the group, and only want to read |
| 13670 | article 1 and 5001, that means that @code{nntp} will fetch 4999 @acronym{NOV} | 13678 | article 1 and 5001, that means that @code{nntp} will fetch 4999 @acronym{NOV} |
| 13671 | lines that you will not need. This variable says how | 13679 | lines that you will not need. This variable says how |
| 13672 | big a gap between two consecutive articles is allowed to be before the | 13680 | big 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 |
| 14202 | Some @acronym{IMAP} servers allow anonymous logins. In that case, | 14210 | Some @acronym{IMAP} servers allow anonymous logins. In that case, |
| 14203 | this should be set to @code{anonymous}. | 14211 | this should be set to @code{anonymous}. If this variable isn't set, |
| 14212 | the normal login methods will be used. If you wish to specify a | ||
| 14213 | specific 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 |
| 14206 | If non-@code{nil}, expunge articles after deleting them. This is always done | 14218 | If non-@code{nil}, expunge articles after deleting them. This is always done |
| @@ -15962,7 +15974,7 @@ Decode Quoted Readable encoding. | |||
| 15962 | If you are a member of a couple of mailing lists, you will sometimes | 15974 | If you are a member of a couple of mailing lists, you will sometimes |
| 15963 | receive two copies of the same mail. This can be quite annoying, so | 15975 | receive 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 |
| 15965 | this, it keeps a cache of old @code{Message-ID}s--- | 15977 | this, 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 |
| 15967 | default. The approximate maximum number of @code{Message-ID}s stored | 15979 | default. The approximate maximum number of @code{Message-ID}s stored |
| 15968 | there is controlled by the @code{nnmail-message-id-cache-length} | 15980 | there 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 | ||
| 16629 | UNIX systems have historically had a single, very common, and well- | 16641 | UNIX systems have historically had a single, very common, and well-defined |
| 16630 | defined format. All messages arrive in a single @dfn{spool file}, and | 16642 | format. All messages arrive in a single @dfn{spool file}, and |
| 16631 | they are delineated by a line whose regular expression matches | 16643 | they 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, |
| 16633 | to make it clear in this instance that this is not the RFC-specified | 16645 | to 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): | |||
| 21174 | AND, OR, and NOT are supported, and parentheses can be used to control | 21186 | AND, OR, and NOT are supported, and parentheses can be used to control |
| 21175 | operator precedence, e.g., (emacs OR xemacs) AND linux. Note that | 21187 | operator precedence, e.g., (emacs OR xemacs) AND linux. Note that |
| 21176 | operators must be written with all capital letters to be | 21188 | operators must be written with all capital letters to be |
| 21177 | recognized. Also preceding a term with a - sign is equivalent to NOT | 21189 | recognized. Also preceding a term with a @minus{} sign is equivalent to NOT |
| 21178 | term. | 21190 | term. |
| 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 | |||
| 21222 | recognized. | 21234 | recognized. |
| 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 |
| 21228 | The search engine converts all text to utf-8, so searching should work | 21241 | The 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 |
| 21362 | Alist of server backend - search engine pairs. The default associations | 21375 | Alist of pairs of server backends and search engines. The default associations |
| 21363 | are | 21376 | are |
| 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 | |||
| 22574 | possible names is listed below. | 22587 | possible names is listed below. |
| 22575 | 22588 | ||
| 22576 | The @dfn{value} (i.e., the @dfn{split}) says how much space each buffer | 22589 | The @dfn{value} (i.e., the @dfn{split}) says how much space each buffer |
| 22577 | should occupy. To take the @code{article} split as an example - | 22590 | should 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 | ||
| 26352 | On the January 31th 2012, Ma Gnus was begun. | 26365 | On the January 31th 2012, Ma Gnus was begun. |
| 26353 | 26366 | ||
| 26354 | If you happen upon a version of Gnus that has a prefixed name -- | 26367 | If you happen upon a version of Gnus that has a prefixed name---``(ding) |
| 26355 | ``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'', | 26368 | Gnus'', ``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 |
| 26357 | panic. Don't let it know that you're frightened. Back away. Slowly. | 26370 | panic. Don't let it know that you're frightened. Back away. Slowly. |
| 26358 | Whatever you do, don't run. Walk away, calmly, until you're out of | 26371 | Whatever you do, don't run. Walk away, calmly, until you're out of |
| 26359 | its reach. Find a proper released version of Gnus and snuggle up to | 26372 | its 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 | |||
| 26500 | various changes to the format of news articles. The Gnus towers will | 26513 | various changes to the format of news articles. The Gnus towers will |
| 26501 | look into implementing the changes when the draft is accepted as an RFC. | 26514 | look 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} |
| 26505 | All the various @acronym{MIME} RFCs are supported. | 26518 | All the various @acronym{MIME} RFCs are supported. |
| 26506 | 26519 | ||
| 26507 | @item Disposition Notifications - RFC 2298 | 26520 | @item Disposition Notifications---RFC 2298 |
| 26508 | Message Mode is able to request notifications from the receiver. | 26521 | Message 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 |
| 26513 | RFC 1991 is the original @acronym{PGP} message specification, | 26526 | RFC 1991 is the original @acronym{PGP} message specification, |
| @@ -26517,15 +26530,15 @@ non-@acronym{MIME} aware @acronym{PGP} format. Gnus supports both | |||
| 26517 | encoding (signing and encryption) and decoding (verification and | 26530 | encoding (signing and encryption) and decoding (verification and |
| 26518 | decryption). | 26531 | decryption). |
| 26519 | 26532 | ||
| 26520 | @item PGP/MIME - RFC 2015/3156 | 26533 | @item PGP/MIME---RFC 2015/3156 |
| 26521 | RFC 2015 (superseded by 3156 which references RFC 2440 instead of RFC | 26534 | RFC 2015 (superseded by 3156 which references RFC 2440 instead of RFC |
| 26522 | 1991) describes the @acronym{MIME}-wrapping around the RFC 1991/2440 format. | 26535 | 1991) describes the @acronym{MIME}-wrapping around the RFC 1991/2440 format. |
| 26523 | Gnus supports both encoding and decoding. | 26536 | Gnus supports both encoding and decoding. |
| 26524 | 26537 | ||
| 26525 | @item S/MIME - RFC 2633 | 26538 | @item S/MIME---RFC 2633 |
| 26526 | RFC 2633 describes the @acronym{S/MIME} format. | 26539 | RFC 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 |
| 26529 | RFC 1730 is @acronym{IMAP} version 4, updated somewhat by RFC 2060 | 26542 | RFC 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 |
| 26531 | authentication for @acronym{IMAP}. RFC 2086 describes access control | 26544 | authentication for @acronym{IMAP}. RFC 2086 describes access control |
| @@ -26580,7 +26593,7 @@ circles) @dfn{snapshots}. During this phase, Gnus is assumed to be | |||
| 26580 | unstable and should not be used by casual users. Gnus alpha releases | 26593 | unstable and should not be used by casual users. Gnus alpha releases |
| 26581 | have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}. | 26594 | have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}. |
| 26582 | 26595 | ||
| 26583 | After futzing around for 10-100 alpha releases, Gnus is declared | 26596 | After 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, |
| 26585 | and is called things like ``Gnus 5.10.1'' instead. Normal people are | 26598 | and is called things like ``Gnus 5.10.1'' instead. Normal people are |
| 26586 | supposed to be able to use these, and these are mostly discussed on the | 26599 | supposed 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 |
| 28169 | Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC | 28182 | Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC |
| 28170 | 2015/3156) and @acronym{S/MIME} (RFC 2630-2633). | 28183 | 2015/3156) and @acronym{S/MIME} (RFC 2630--2633). |
| 28171 | 28184 | ||
| 28172 | It needs an external @acronym{S/MIME} and OpenPGP implementation, but no | 28185 | It needs an external @acronym{S/MIME} and OpenPGP implementation, but no |
| 28173 | additional Lisp libraries. This add several menu items to the | 28186 | additional 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 |
| 28589 | Each group is subscribed at some @dfn{level} or other (1-9). The ones | 28602 | Each group is subscribed at some @dfn{level} or other (1--9). The ones |
| 28590 | that have a lower level are ``more'' subscribed than the groups with a | 28603 | that have a lower level are ``more'' subscribed than the groups with a |
| 28591 | higher level. In fact, groups on levels 1-5 are considered | 28604 | higher 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 |
| 28593 | are @dfn{killed}. Commands for listing groups and scanning for new | 28606 | are @dfn{killed}. Commands for listing groups and scanning for new |
| 28594 | articles will all use the numeric prefix as @dfn{working level}. | 28607 | articles will all use the numeric prefix as @dfn{working level}. |
| 28595 | 28608 | ||
| @@ -29165,8 +29178,8 @@ return value. | |||
| 29165 | 29178 | ||
| 29166 | Some back ends could be said to be @dfn{server-forming} back ends, and | 29179 | Some back ends could be said to be @dfn{server-forming} back ends, and |
| 29167 | some might be said not to be. The latter are back ends that generally | 29180 | some might be said not to be. The latter are back ends that generally |
| 29168 | only operate on one group at a time, and have no concept of ``server'' | 29181 | only 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 | 29182 | they have a group, and they deliver info on that group and nothing |
| 29170 | more. | 29183 | more. |
| 29171 | 29184 | ||
| 29172 | Gnus identifies each message by way of group name and article number. A | 29185 | Gnus 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 | ||
| 9 | This manual documents Htmlfontify, a source code -> crosslinked + | ||
| 10 | formatted + syntax colorised html transformer. | ||
| 11 | |||
| 12 | Copyright @copyright{} 2002, 2003, 2013 Free Software Foundation, Inc. | ||
| 13 | |||
| 14 | @quotation | ||
| 15 | Permission is granted to copy, distribute and/or modify this document | ||
| 16 | under the terms of the GNU Free Documentation License, Version 1.3 or | ||
| 17 | any later version published by the Free Software Foundation; with no | ||
| 18 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | ||
| 19 | and with the Back-Cover Texts as in (a) below. A copy of the license | ||
| 20 | is 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 | ||
| 23 | modify 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 | |||
| 69 | Htmlfontify provides a means of converting individual Emacs buffers, | ||
| 70 | source files, or entire source trees to html, preserving formatting | ||
| 71 | and Emacs colorisation / syntax highlighting as much as possible | ||
| 72 | through careful application of CSS stylesheets and html tags. | ||
| 73 | |||
| 74 | It can also turn instances of functions, methods and (for some | ||
| 75 | languages) variables and other constructs and items into links | ||
| 76 | to their definitions, and create an index file (or files) of | ||
| 77 | all such symbols, also linked to their points of definition. | ||
| 78 | |||
| 79 | Htmlfontify also provides several customisation items, which should | ||
| 80 | allow it to mesh more-or-less seamlessly with various templating or | ||
| 81 | publishing systems (in the event, for instance, that you don't want | ||
| 82 | to produce the html pages directly). | ||
| 83 | |||
| 84 | @node Usage & Examples | ||
| 85 | @chapter Usage & Examples | ||
| 86 | @cindex Usage & Examples | ||
| 87 | |||
| 88 | Htmlfontify can be used both interactively and as part of another | ||
| 89 | elisp function. If you're running it in a modern Emacs, it will also | ||
| 90 | run when attached to a terminal (i.e., without X) or even when in | ||
| 91 | batch 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 | |||
| 106 | Htmlfontify 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 | |||
| 118 | Create a new buffer, named for the current buffer + a .html extension, | ||
| 119 | containing an inline CSS-stylesheet and formatted CSS-markup html that | ||
| 120 | reproduces the look of the current Emacs buffer as closely as possible. | ||
| 121 | |||
| 122 | ``Dangerous'' characters in the existing buffer are turned into html | ||
| 123 | entities, so you should even be able to do html-within-html fontified | ||
| 124 | display. | ||
| 125 | |||
| 126 | You should, however, note that random control or eight-bit characters | ||
| 127 | such as ^L (\x0c) or ¤ (\xa4) won't get mapped yet. | ||
| 128 | |||
| 129 | If the @var{srcdir} and @var{file} arguments are set, lookup etags | ||
| 130 | derived entries in the @ref{hfy-tags-cache} and add html anchors | ||
| 131 | and 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 | |||
| 142 | Load 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 | |||
| 153 | Trawl @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 | |||
| 157 | You 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 | |||
| 168 | Load an X11 style rgb.txt file (search @code{hfy-rgb-load-path} if | ||
| 169 | @var{file} is not specified). | ||
| 170 | |||
| 171 | Note 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 | ||
| 173 | a copy built in, for use when it cannot contact an X server. | ||
| 174 | |||
| 175 | Loads 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 | |||
| 187 | Unload 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 | |||
| 195 | In addition to the aforementioned interactive methods, Htmlfontify | ||
| 196 | provides 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 | |||
| 210 | Take @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}) | ||
| 212 | and return a @ref{hfy-style-assoc}. | ||
| 213 | |||
| 214 | See 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 | |||
| 225 | Use a fallback method for obtaining the rgb values for a color. | ||
| 226 | If @ref{htmlfontify-load-rgb-file} has been called, it uses the | ||
| 227 | color 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 | |||
| 238 | Return 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 | |||
| 242 | See 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 | |||
| 253 | Return a regex that matches @var{string} as the first @code{match-string}, | ||
| 254 | with non word characters on either side (vaguely emulating the perl @code{\b} | ||
| 255 | regex 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 | |||
| 266 | Emacs's fontification is designed for interactive use. As such, it sometimes | ||
| 267 | does things like deferring fontification until a section of the buffer is | ||
| 268 | exposed and rendered, or until Emacs is idle for a while. Sometimes, in | ||
| 269 | non-interactive circumstances, or if it can't see X, it doesn't bother | ||
| 270 | with some of the harder stuff. While this is all great from the perspective | ||
| 271 | of a user waiting for Emacs to load a 20000 line file and colorise it, | ||
| 272 | it's a pain from the point of view from non-interactive code. This function | ||
| 273 | lies, cheats, steals and generally bullies Emacs into fontifying a buffer | ||
| 274 | from start to finish, with all the extra frills, whether it thinks it nneds | ||
| 275 | to 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 | |||
| 286 | Replace the end of a CSS style declaration @var{style-string} with the contents | ||
| 287 | of the variable @ref{hfy-src-doc-link-style}, removing text matching the | ||
| 288 | regex @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 | |||
| 300 | Prepare a tags index buffer for @var{srcdir}. | ||
| 301 | @ref{hfy-tags-cache} must already have an entry for @var{srcdir} for | ||
| 302 | this 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 | |||
| 305 | If @var{stub} is set, prepare an (appropriately named) index buffer | ||
| 306 | specifically for entries beginning with @var{stub}. | ||
| 307 | |||
| 308 | If @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 | |||
| 319 | Trawl 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 | |||
| 330 | Strip some of the boring bits from a font-name and return a CSS style | ||
| 331 | name. If @var{fn} is a @code{defface} attribute list, either construct | ||
| 332 | a name for it, store it in the cache, and return it, or just fetch it | ||
| 333 | from 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 | |||
| 344 | Approximate 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 | |||
| 355 | Takes a color name (string) and return a CSS rgb(R, G, B) triplet string. | ||
| 356 | Uses the definition of ``white'' to map the numbers to the 0-255 range, so | ||
| 357 | if you've redefined white, (especially if you've redefined it to have | ||
| 358 | a triplet member lower than that of the color you are processing, | ||
| 359 | strange 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 | |||
| 370 | Default 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 | |||
| 381 | Return a list of files under @var{directory}. | ||
| 382 | Strips 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 | |||
| 393 | Where @var{color} is a color name or #XXXXXX style triplet, return a list of | ||
| 394 | 3 (16 bit) rgb values for said color. If a window system is unavailable, | ||
| 395 | calls @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 | |||
| 406 | Return an href stub for a tag href: if @var{def-files} (list of files | ||
| 407 | containing definitions for the tag in question) contains only one entry, | ||
| 408 | the href should link straight to that file. Otherwise, the link should | ||
| 409 | be to the index file. | ||
| 410 | |||
| 411 | We are not yet concerned with the file extensions/tag line number and | ||
| 412 | so on at this point. | ||
| 413 | |||
| 414 | If @ref{hfy-split-index} is set, and the href will be to an index file | ||
| 415 | rather 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 | |||
| 418 | See 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 | |||
| 429 | Returns 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 | |||
| 440 | Where @var{face-map} is a @ref{hfy-facemap-assoc} for the current buffer, | ||
| 441 | this function merges adjacent style blocks which are of the same value | ||
| 442 | and 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 | |||
| 450 | Returns 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 | |||
| 461 | Mark 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 | |||
| 473 | Derive 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 | |||
| 484 | Derive a CSS font-size specifier from an Emacs font @code{:height} attribute. | ||
| 485 | Does not cope with the case where height is a function to be applied to | ||
| 486 | the 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 | |||
| 497 | Default 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 | |||
| 508 | Derives 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 | |||
| 519 | Mark href start points with the @code{hfy-link} property (value: href string). | ||
| 520 | |||
| 521 | Mark href end points with the @code{hfy-endl} property (value @code{t}). | ||
| 522 | |||
| 523 | Avoid overlapping links, and mark links in descending length of | ||
| 524 | tag name in order to prevent subtags from usurping supertags; | ||
| 525 | e.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 | |||
| 536 | Derive 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 | |||
| 547 | Convert a complex @code{:box} Emacs font attribute set to a list of | ||
| 548 | CSS 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 | |||
| 560 | Mark dangerous @samp{["<>]} characters with the @code{hfy-quoteme} property. | ||
| 561 | |||
| 562 | See 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 | |||
| 573 | Generate and return an Htmlfontify html output buffer for the current | ||
| 574 | buffer. 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 | ||
| 586 | batch mode, but we want to know if we should fontify or raw copy, so in | ||
| 587 | batch 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 | |||
| 599 | Where @var{style} is a @ref{hfy-sheet-assoc} and @var{face} is an Emacs face, | ||
| 600 | return 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 | |||
| 611 | Implement 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 | |||
| 622 | Convert 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 | |||
| 633 | Take @var{style} (see @ref{hfy-face-to-style-i}, @ref{hfy-face-to-style}) | ||
| 634 | and merge any multiple attributes appropriately. Currently only font-size is | ||
| 635 | merged down to a single occurrence---others may need special handling, but I | ||
| 636 | haven'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 | |||
| 647 | Convert @var{spec}, a CSS font-size specifier, back to an Emacs | ||
| 648 | @code{:height} attribute value. Used while merging multiple font-size | ||
| 649 | attributes. | ||
| 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 | |||
| 660 | Generates a header, via @ref{hfy-page-header}, for @var{file}, containing the | ||
| 661 | stylesheet derived from @var{css}, which is a @ref{hfy-sheet-assoc}. Returns a | ||
| 662 | string 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 | |||
| 673 | Return a @samp{../} stub of the appropriate length for the current source | ||
| 674 | tree 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 | |||
| 685 | Compile 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 | |||
| 696 | Return as list of index buffer(s), as determined by @ref{hfy-split-index}. | ||
| 697 | Uses @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 | |||
| 708 | Prepare the counterpart(s) to the index buffer(s)---a list of buffers with | ||
| 709 | the same structure, but listing (and linking to) instances of tags (as | ||
| 710 | opposed to their definitions). | ||
| 711 | |||
| 712 | See 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 | |||
| 723 | Internal function---strips definitions of tags from the instance map. | ||
| 724 | See: @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 | |||
| 735 | The guts of @ref{hfy-face-to-style}. @var{fn} should be a @code{defface} | ||
| 736 | font specification, as returned by @code{face-attr-construct} or | ||
| 737 | @ref{hfy-face-attr-for-class}. Note that this function does not get | ||
| 738 | font-sizes right if they are based on inherited modifiers (via the | ||
| 739 | :inherit) attribute, and any other modifiers that are cumulative if they | ||
| 740 | appear multiple times need to be merged by the user---@ref{hfy-flatten-style} | ||
| 741 | should 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 | |||
| 752 | Take @var{fn}, a font or @code{defface} specification (c.f. | ||
| 753 | @code{face-attr-construct}) and return a CSS style specification. | ||
| 754 | |||
| 755 | See 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 | |||
| 766 | Map 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 | |||
| 778 | Convert the CSS style spec @var{style-string} to its equivalent | ||
| 779 | hyperlink style. | ||
| 780 | |||
| 781 | See: @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 | |||
| 792 | Given @var{props}, a list of text-properties, return the value of the | ||
| 793 | face 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 | |||
| 804 | Helper 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 | |||
| 815 | Return the face attributes for @var{face}. If @var{class} is set, it | ||
| 816 | must be a @code{defface} alist key [see below]. Prior to version 0.18, | ||
| 817 | the first face specification returned by @ref{hfy-combined-face-spec} | ||
| 818 | which @emph{didn't} clash with @var{class} was returned. In versions | ||
| 819 | from 0.18 onwards, each font attribute list is scored, and the | ||
| 820 | non-conflicting list with the highest score is returned. (A specification | ||
| 821 | with a class of @code{t} is considered to match any class you specify. | ||
| 822 | This matches Emacs's behaviour when deciding on which face attributes to | ||
| 823 | use, to the best of my understanding ). | ||
| 824 | |||
| 825 | If @var{class} is nil, then you just get get whatever | ||
| 826 | @code{face-attr-construct} returns; i.e., the current specification in | ||
| 827 | effect for @var{face}. | ||
| 828 | |||
| 829 | See @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 | |||
| 840 | Find 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 | ||
| 842 | list 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 | |||
| 853 | As 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 | |||
| 864 | cperl mode does its damndest not to do some of its fontification when not | ||
| 865 | in 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 | |||
| 876 | Return 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 | |||
| 894 | Returns a best guess at a Bourne compatible shell to use: If the current | ||
| 895 | shell 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 | |||
| 906 | Run @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 | |||
| 917 | Parse 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 | |||
| 929 | Return 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 | |||
| 940 | Is @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 | |||
| 951 | Is @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 | |||
| 962 | Return everything preceding the last @samp{/} from a relative filename, | ||
| 963 | on the assumption that this will produce a relative directory name. Hardly | ||
| 964 | bombproof, 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 | |||
| 975 | Transform all dangerous characters marked with the @code{hfy-quoteme} property | ||
| 976 | using @ref{hfy-html-quote} | ||
| 977 | |||
| 978 | See 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 | |||
| 989 | Open @var{file} in @var{srcdir}---if fontified, write a fontified copy to @var{dstdir} | ||
| 990 | adding 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 | |||
| 1002 | Derive 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 | |||
| 1013 | Derive a font-style CSS specifier from the Emacs :slant | ||
| 1014 | attribute---CSS does not define the reverse-* styles, so just maps | ||
| 1015 | those 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 | |||
| 1026 | List of etags tags that have definitions in this @var{file}. Looks up | ||
| 1027 | the 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 | |||
| 1038 | Convert 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 | |||
| 1047 | Important 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 | |||
| 1055 | This 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 | |||
| 1061 | Each 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 | |||
| 1067 | i.e., an alist mapping (relative) file paths to line and character offsets. | ||
| 1068 | |||
| 1069 | See @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 | |||
| 1081 | Where tag-rmap-hash has entries of the form: | ||
| 1082 | |||
| 1083 | @example | ||
| 1084 | "tag_string" => ( "file/name.ext" line char ) | ||
| 1085 | @end example | ||
| 1086 | |||
| 1087 | Unlike @ref{hfy-tags-cache} these are the locations of occurrences of | ||
| 1088 | tagged 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 | |||
| 1100 | Where the tags are stored in descending order of length. | ||
| 1101 | |||
| 1102 | See: @ref{hfy-load-tags-cache}. | ||
| 1103 | |||
| 1104 | @end table | ||
| 1105 | |||
| 1106 | @node Data Structures | ||
| 1107 | @section Data Structures | ||
| 1108 | @cindex Data Structures | ||
| 1109 | |||
| 1110 | Some 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 | |||
| 1118 | An assoc representing/describing an Emacs face. Properties may be repeated, | ||
| 1119 | in which case later properties should be treated as if they were inherited | ||
| 1120 | from a ``parent'' font. (For some properties, only the first encountered value | ||
| 1121 | is of any importance, for others the values might be cumulative, and for | ||
| 1122 | others they might be cumulative in a complex way.) | ||
| 1123 | |||
| 1124 | Some 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 | |||
| 1150 | An assoc with elements of the form @samp{(face-name style-name . style-string)}. | ||
| 1151 | The 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 | |||
| 1162 | An 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 | ||
| 1165 | file's end to its beginning). The map is in reverse order because | ||
| 1166 | inserting a @samp{<style>} tag (or any other string) at @var{point} | ||
| 1167 | invalidates the map for all entries with a greater value of point. By | ||
| 1168 | traversing the map from greatest to least @var{point}, we still | ||
| 1169 | invalidate the map as we go, but only those points we have already | ||
| 1170 | dealt with (and therefore no longer care about) will be invalid at any | ||
| 1171 | time. | ||
| 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 | |||
| 1200 | The following is a lump of code I use to fontify source code on my | ||
| 1201 | site, @url{http://rtfm.etla.org/} (which was the reason, incidentally, | ||
| 1202 | that 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 | ||
| 1213 | html-css-url := /css/red+black.css | ||
| 1214 | title := rtfm.etla.org ( %s / src/%s ) | ||
| 1215 | bodytag := | ||
| 1216 | head <=STYLESHEET;\n | ||
| 1217 | %s | ||
| 1218 | STYLESHEET | ||
| 1219 | main-title := rtfm / %s / src/%s\n | ||
| 1220 | main-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 | |||
| 1259 | Htmlfontify 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 | |||
| 1268 | Set 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 | ||
| 1270 | its argument, altered so as to make any changes you want made for text which | ||
| 1271 | is a hyperlink, in addition to being in the class to which that style would | ||
| 1272 | normally be applied. | ||
| 1273 | |||
| 1274 | @item hfy-html-quote-regex | ||
| 1275 | @vindex hfy-html-quote-regex | ||
| 1276 | @anchor{hfy-html-quote-regex} | ||
| 1277 | |||
| 1278 | Regex to match (with a single back-reference per match) strings in HTML | ||
| 1279 | which 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 | |||
| 1286 | As @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 | |||
| 1293 | Display class to use to determine which display class to use when | ||
| 1294 | calculating a face's attributes. This is useful when, for example, you | ||
| 1295 | are running Emacs on a tty or in batch mode, and want Htmlfontify to have | ||
| 1296 | access to the face spec you would use if you were connected to an X display. | ||
| 1297 | |||
| 1298 | Some 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 | |||
| 1311 | Multiple values for a tag may be combined, to indicate that any one or more | ||
| 1312 | of 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 | ||
| 1323 | and so on. | ||
| 1324 | |||
| 1325 | @item hfy-page-header | ||
| 1326 | @vindex hfy-page-header | ||
| 1327 | @anchor{hfy-page-header} | ||
| 1328 | |||
| 1329 | Function called with two arguments (the filename relative to the top | ||
| 1330 | level source directory being etag'd and fontified), and a string containing | ||
| 1331 | the @samp{<style>@dots{}</style>} text to embed in the document---the string | ||
| 1332 | returned will be used as the header for the htmlfontified version of | ||
| 1333 | the source file. | ||
| 1334 | |||
| 1335 | See 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 | |||
| 1341 | String 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 | |||
| 1347 | Minimum size of a buffer for cached fontification. | ||
| 1348 | This value is temporarily assigned to @code{fast-lock-minimum-size} during | ||
| 1349 | html-fontification. | ||
| 1350 | |||
| 1351 | Only buffers more than this can have associated Font Lock cache files saved. | ||
| 1352 | |||
| 1353 | If nil, means cache files are never created. | ||
| 1354 | |||
| 1355 | If a list, each element should be a cons pair of the form | ||
| 1356 | @code{(@var{major-mode} . @var{size})}, where @var{major-mode} | ||
| 1357 | is 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 | |||
| 1365 | means that the minimum size is 25K for buffers in C or C++ modes, one megabyte | ||
| 1366 | for 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 | |||
| 1372 | Whether or not to split the index @ref{hfy-index-file} alphabetically | ||
| 1373 | on the first letter of each tag. Useful when the index would otherwise | ||
| 1374 | be 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 | |||
| 1386 | File 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 | |||
| 1392 | Fallback @code{defface} specification for the face @code{default}, used | ||
| 1393 | when @ref{hfy-display-class} has been set (the normal Htmlfontify way of | ||
| 1394 | extracting potentially non-current face information doesn't necessarily | ||
| 1395 | work for @code{default}). | ||
| 1396 | |||
| 1397 | For 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 | |||
| 1407 | List of functions to call when starting htmlfontify-buffer to do any | ||
| 1408 | kludging necessary to get highlighting modes to bahave as you want, even | ||
| 1409 | when 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 | |||
| 1415 | Should be set to a Bourne compatible shell, which will be invoked | ||
| 1416 | for the more complex shell interactions needed by Htmlfontify. | ||
| 1417 | Currently 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 | |||
| 1424 | Optimisations to turn on. So far, the following have been implemented: | ||
| 1425 | |||
| 1426 | @table @option | ||
| 1427 | @item merge-adjacent-tags | ||
| 1428 | If two (or more) span tags are adjacent, identical and separated by nothing | ||
| 1429 | more than whitespace, they will be merged into one span. | ||
| 1430 | |||
| 1431 | @item zap-comment-links | ||
| 1432 | Suppress hyperlinking of tags found in comments. | ||
| 1433 | |||
| 1434 | @item zap-string-links | ||
| 1435 | Suppress hyperlinking of tags found in strings. | ||
| 1436 | |||
| 1437 | @item div-wrapper | ||
| 1438 | Add @samp{<div class="default"> </div>} tags around the fontified body. | ||
| 1439 | (Some people like this because they cut and paste the html into | ||
| 1440 | a page with different colors than the fontified code.) | ||
| 1441 | |||
| 1442 | @item keep-overlays | ||
| 1443 | Preserve overlay highlighting (c.f. @code{ediff} or @code{goo-font-lock}) | ||
| 1444 | as well as basic faces. Can result in extremely verbose highlighting | ||
| 1445 | if there are many overlays (as is the case with @code{goo-font-lock}). | ||
| 1446 | |||
| 1447 | @end table | ||
| 1448 | |||
| 1449 | And the following are planned but not yet available: | ||
| 1450 | |||
| 1451 | @table @option | ||
| 1452 | @item kill-context-leak | ||
| 1453 | Suppress hyperlinking between files highlighted by different modes. | ||
| 1454 | |||
| 1455 | @end table | ||
| 1456 | |||
| 1457 | Note: like compiler optimisations, these optimise the _output_ of the code, | ||
| 1458 | not the processing of the source itself, and are therefore likely to slow | ||
| 1459 | Htmlfontify down, at least a little. Except for skip-refontification, | ||
| 1460 | which 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 | |||
| 1466 | Regex 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 | |||
| 1472 | File extension used for href links---useful where the Htmlfontify | ||
| 1473 | output files are going to be processed again, with a rersulting change | ||
| 1474 | in file extension. If @code{nil}, then any code using this should fall back | ||
| 1475 | to @ref{hfy-extn}. | ||
| 1476 | |||
| 1477 | @item hfy-istext-command | ||
| 1478 | @vindex hfy-istext-command | ||
| 1479 | @anchor{hfy-istext-command} | ||
| 1480 | |||
| 1481 | Command to run with the name of a file, to see whether it is a text file | ||
| 1482 | or not. The command should emit a string containing the word @samp{text} if | ||
| 1483 | the 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 | |||
| 1489 | An alist of possible shell commands that will generate etags output that | ||
| 1490 | Htmlfontify 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 | |||
| 1496 | The location of the etags binary (we begin by assuming it's in your path). | ||
| 1497 | |||
| 1498 | Note that if etags is not in your path, you will need to alter the shell | ||
| 1499 | commands 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 | |||
| 1508 | An etags shell command to run in the source directory to generate a tags | ||
| 1509 | file for the whole source tree from there on down. The command should emit | ||
| 1510 | the etags output on standard output. | ||
| 1511 | |||
| 1512 | Two canned commands are provided---they drive Emacs's etags and | ||
| 1513 | exuberant-ctags's etags respectively. | ||
| 1514 | |||
| 1515 | @item hfy-etag-regex | ||
| 1516 | @vindex hfy-etag-regex | ||
| 1517 | @anchor{hfy-etag-regex} | ||
| 1518 | |||
| 1519 | Regex used to parse an etags entry: must have 3 subexps, corresponding, | ||
| 1520 | in order, to: | ||
| 1521 | |||
| 1522 | @enumerate | ||
| 1523 | @item | ||
| 1524 | The tag | ||
| 1525 | @item | ||
| 1526 | The line | ||
| 1527 | @item | ||
| 1528 | The 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 | |||
| 1535 | Name (sans extension) of the index file produced during | ||
| 1536 | fontification-and-hyperlinking. | ||
| 1537 | |||
| 1538 | @item hfy-instance-file | ||
| 1539 | @vindex hfy-instance-file | ||
| 1540 | @anchor{hfy-instance-file} | ||
| 1541 | |||
| 1542 | Name (sans extension) of the tag usage index file produced during | ||
| 1543 | fontification-and-hyperlinking. | ||
| 1544 | |||
| 1545 | @item hfy-html-quote-map | ||
| 1546 | @vindex hfy-html-quote-map | ||
| 1547 | @anchor{hfy-html-quote-map} | ||
| 1548 | |||
| 1549 | An 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 | |||
| 1558 | Htmlfontify has a couple of external requirements: | ||
| 1559 | |||
| 1560 | @itemize @bullet | ||
| 1561 | |||
| 1562 | @item | ||
| 1563 | GNU Emacs 20.7+ or 21.1+ | ||
| 1564 | |||
| 1565 | Other versions may work---these have been used successfully by the | ||
| 1566 | author. If you intend to use Htmlfontify in batch mode, 21.1+ is | ||
| 1567 | pretty much required. The author does not know if XEmacs, NTemacs, | ||
| 1568 | or J.Random Emacs will run Htmlfontify, but reports/patches/bags of | ||
| 1569 | money are always welcome. | ||
| 1570 | |||
| 1571 | @item | ||
| 1572 | A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts | ||
| 1573 | to autodetect the version you have and customise itself accordingly, | ||
| 1574 | but you should be able to override this. | ||
| 1575 | |||
| 1576 | See: @ref{Customisation} | ||
| 1577 | |||
| 1578 | @item | ||
| 1579 | A copy of find (e.g., GNU find) that provides the @code{-path} predicate. | ||
| 1580 | |||
| 1581 | You may be able to work around this with a suitable clever shell | ||
| 1582 | command and the customisation entry: @ref{hfy-find-cmd} | ||
| 1583 | |||
| 1584 | @item | ||
| 1585 | A copy of sed (e.g., GNU sed). | ||
| 1586 | |||
| 1587 | @item | ||
| 1588 | A 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. | |||
| 22 | This is edition @value{EDITION} of the IDLWAVE User Manual for IDLWAVE | 22 | This is edition @value{EDITION} of the IDLWAVE User Manual for IDLWAVE |
| 23 | @value{VERSION}. | 23 | @value{VERSION}. |
| 24 | 24 | ||
| 25 | Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. | 25 | Copyright @copyright{} 1999--2013 Free Software Foundation, Inc. |
| 26 | 26 | ||
| 27 | @quotation | 27 | @quotation |
| 28 | Permission is granted to copy, distribute and/or modify this document | 28 | Permission 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 | |||
| 33 | is included in the section entitled ``GNU Free Documentation License''. | 33 | is 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 |
| 36 | modify this GNU manual. Buying copies from the FSF supports it in | 36 | modify this GNU manual.'' |
| 37 | developing 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 | ||
| 62 | IDLWAVE is a package which supports editing source code written in the | 61 | IDLWAVE 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 | ||
| 86 | Getting Started (Tutorial) | 85 | Getting 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 | ||
| 92 | The IDLWAVE Major Mode | 91 | The 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 | ||
| 266 | In this manual, each section ends with a list of related user options. | 265 | In this manual, each section ends with a list of related user options. |
| 267 | Don't be confused by the sheer number of options available --- in most | 266 | Don't be confused by the sheer number of options available: in most |
| 268 | cases the default settings are just fine. The variables are listed here | 267 | cases the default settings are just fine. The variables are listed here |
| 269 | to make sure you know where to look if you want to change anything. For | 268 | to make sure you know where to look if you want to change anything. For |
| 270 | a full description of what a particular variable does and how to | 269 | a 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 | |||
| 272 | with @kbd{C-h v}). Some configuration examples are also given in the | 271 | with @kbd{C-h v}). Some configuration examples are also given in the |
| 273 | appendix. | 272 | appendix. |
| 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 | ||
| 384 | The purpose of this tutorial is to guide you through a very basic | 383 | The 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 |
| 450 | changes the generic @code{end} to the specific @code{endfor} | 449 | changes the generic @code{end} to the specific @code{endfor} |
| 451 | automatically (as long as the variable @code{idlwave-expand-generic-end} | 450 | automatically (as long as the variable @code{idlwave-expand-generic-end} |
| 452 | is turned on --- @pxref{Lesson II -- Customization}). Now place the | 451 | is turned on; @pxref{Lesson II---Customization}). Now place the |
| 453 | cursor in any line you would like to split and press @kbd{M-@key{RET}}. | 452 | cursor in any line you would like to split and press @kbd{M-@key{RET}}. |
| 454 | The line is split at the cursor position, with the continuation @samp{$} | 453 | The line is split at the cursor position, with the continuation @samp{$} |
| 455 | and indentation all taken care of. Use @kbd{C-/} to undo the last | 454 | and 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 |
| 506 | and execute again. | 505 | and execute again. |
| 507 | 506 | ||
| 508 | This time we get a plot, but it is pretty ugly --- the points are all | 507 | This time we get a plot, but it is pretty ugly: the points are all |
| 509 | connected with a line. Hmm, isn't there a way for @code{plot} to use | 508 | connected with a line. Hmm, isn't there a way for @code{plot} to use |
| 510 | symbols instead? What was that keyword? Position the cursor on the | 509 | symbols instead? What was that keyword? Position the cursor on the |
| 511 | plot line after a comma (where you'd normally type a keyword), and hit | 510 | plot 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, | |||
| 521 | you know what to do: @kbd{C-c C-s}) and execute again. Now things | 520 | you know what to do: @kbd{C-c C-s}) and execute again. Now things |
| 522 | look pretty good. | 521 | look pretty good. |
| 523 | 522 | ||
| 524 | Let's try a different day --- how about April fool's day? | 523 | Let's try a different day. How about April fool's day? |
| 525 | 524 | ||
| 526 | @example | 525 | @example |
| 527 | plot_wday,1,4 | 526 | plot_wday,1,4 |
| @@ -552,14 +551,14 @@ command. Everything should now work fine. How about those leap years? | |||
| 552 | Change the code to plot 100 years and see that every 28 years, the | 551 | Change the code to plot 100 years and see that every 28 years, the |
| 553 | sequence of weekdays repeats. | 552 | sequence 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 | ||
| 558 | Emacs is probably the most customizable piece of software ever written, | 557 | Emacs is probably the most customizable piece of software ever written, |
| 559 | and it would be a shame if you did not make use of this to adapt IDLWAVE | 558 | and it would be a shame if you did not make use of this to adapt IDLWAVE |
| 560 | to your own preferences. Customizing Emacs or IDLWAVE is accomplished | 559 | to your own preferences. Customizing Emacs or IDLWAVE is accomplished |
| 561 | by setting Lisp variables in the @file{.emacs} file in your home | 560 | by setting Lisp variables in the @file{.emacs} file in your home |
| 562 | directory --- but do not be dismayed; for the most part, you can just | 561 | directory---but do not be dismayed; for the most part, you can just |
| 563 | copy and work from the examples given here. | 562 | copy and work from the examples given here. |
| 564 | 563 | ||
| 565 | Let's first use a boolean variable. These are variables which you turn | 564 | Let'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 |
| 639 | unused key on your keyboard --- consult your system documentation. | 638 | unused key on your keyboard; consult your system documentation. |
| 640 | 639 | ||
| 641 | You can also assign specific commands to keys. This you must do in the | 640 | You 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 | ||
| 668 | We have already used the routine info display in the first part of this | 667 | We 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, | |||
| 685 | start the shell first with @kbd{C-c C-s} (@pxref{Starting the Shell}). | 684 | start the shell first with @kbd{C-c C-s} (@pxref{Starting the Shell}). |
| 686 | IDLWAVE will find out about the IDL @code{!PATH} variable and offer a | 685 | IDLWAVE will find out about the IDL @code{!PATH} variable and offer a |
| 687 | list of directories on the path. Simply select them all (or whichever | 686 | list of directories on the path. Simply select them all (or whichever |
| 688 | you want --- directories with existing library catalogs will not be | 687 | you want; directories with existing library catalogs will not be |
| 689 | selected by default) and click on the @samp{Scan&Save} button. Then | 688 | selected by default) and click on the @samp{Scan&Save} button. Then |
| 690 | go for a cup of coffee while IDLWAVE collects information for each and | 689 | go for a cup of coffee while IDLWAVE collects information for each and |
| 691 | every IDL routine on your search path. All this information is | 690 | every 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 |
| 723 | remaining questions on the newsgroup @code{comp.lang.idl-pvwave}. | 722 | remaining 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 | |||
| 774 | rely on it to help keep your code neat and organized. | 773 | rely 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 | |||
| 814 | BEGIN lines. | 813 | BEGIN 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 | |||
| 925 | IDL code. | 924 | IDL 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 | |||
| 1029 | 2. | 1028 | 2. |
| 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 |
| 1060 | consistent with the notation for hexadecimal numbers, e.g., @code{'C5'XB}. | 1059 | consistent 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@. | |||
| 1252 | IDLWAVE can access the HTML version of this documentation very quickly | 1251 | IDLWAVE can access the HTML version of this documentation very quickly |
| 1253 | and accurately, based on the local context. This can be @emph{much} | 1252 | and accurately, based on the local context. This can be @emph{much} |
| 1254 | faster than using the IDL online help application, because IDLWAVE | 1253 | faster than using the IDL online help application, because IDLWAVE |
| 1255 | usually gets you to the right place in the documentation directly --- | 1254 | usually gets you to the right place in the documentation directly---e.g., |
| 1256 | e.g., a specific keyword of a routine --- without any additional browsing | 1255 | a specific keyword of a routine---without any additional browsing |
| 1257 | and scrolling. | 1256 | and scrolling. |
| 1258 | 1257 | ||
| 1259 | For this online help to work, an HTML version of the IDL documentation | 1258 | For 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". | |||
| 1423 | The face for links to IDLWAVE online help. | 1422 | The 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, | |||
| 1526 | system variables, system variable tags, class structure tags, regular | 1525 | system variables, system variable tags, class structure tags, regular |
| 1527 | structure tags and file names. As in many programming modes, completion | 1526 | structure tags and file names. As in many programming modes, completion |
| 1528 | is bound to @kbd{M-@key{TAB}} (or simply @kbd{@key{TAB}} in the IDLWAVE | 1527 | is bound to @kbd{M-@key{TAB}} (or simply @kbd{@key{TAB}} in the IDLWAVE |
| 1529 | Shell --- @pxref{Using the Shell}). Completion uses exactly the same | 1528 | Shell; @pxref{Using the Shell}). Completion uses exactly the same |
| 1530 | internal information as routine info, so when necessary (rarely) it can | 1529 | internal information as routine info, so when necessary (rarely) it can |
| 1531 | be updated with @kbd{C-c C-i} (@code{idlwave-update-routine-info}). | 1530 | be 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 |
| 1585 | Completion is not a blocking operation --- you are free to continue | 1584 | Completion is not a blocking operation; you are free to continue |
| 1586 | editing, enter commands, or simply ignore the @file{*Completions*} | 1585 | editing, enter commands, or simply ignore the @file{*Completions*} |
| 1587 | buffer during a completion operation. If, however, the most recent | 1586 | buffer during a completion operation. If, however, the most recent |
| 1588 | command was a completion, @kbd{C-g} will remove the buffer and restore | 1587 | command 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 | |||
| 1655 | completion. | 1654 | completion. |
| 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 | |||
| 1718 | class text property. | 1717 | class 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 |
| 1724 | In the IDLWAVE Shell (@pxref{The IDLWAVE Shell}), objects on which | 1723 | In the IDLWAVE Shell (@pxref{The IDLWAVE Shell}), objects on which |
| @@ -1731,7 +1730,7 @@ class found will be used to select appropriate completions, routine | |||
| 1731 | info, or help. If unsuccessful, information from all known classes will | 1730 | info, or help. If unsuccessful, information from all known classes will |
| 1732 | be used (as in the buffer). | 1731 | be 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 | |||
| 1777 | class-driven keyword inheritance will be used for Completion. | 1776 | class-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 |
| 1846 | these buffers. | 1845 | these 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 |
| 1867 | collects data about routines, and how to update this information. | 1866 | collects 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: | |||
| 1888 | All code templates are also available as abbreviations | 1887 | All 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), | |||
| 1899 | or, optionally, any other character set in | 1898 | or, 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 |
| 1901 | only expanded where they should be (i.e., not in a string or comment), | 1900 | only expanded where they should be (i.e., not in a string or comment), |
| 1902 | and permits the point to be moved after an abbreviation expansion --- | 1901 | and permits the point to be moved after an abbreviation expansion: |
| 1903 | very useful for positioning the mark inside of parentheses, etc. | 1902 | very useful for positioning the mark inside of parentheses, etc. |
| 1904 | 1903 | ||
| 1905 | Special abbreviations are pre-defined for code templates and other | 1904 | Special 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 | |||
| 2074 | between the parentheses of a function call. | 2073 | between 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. | |||
| 2155 | Non-@code{nil} means re-indent line after END was typed. | 2154 | Non-@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}. | |||
| 2204 | Non-@code{nil} means space-pad the @samp{=} in keyword assignments. | 2203 | Non-@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. | |||
| 2290 | Regexp matching the start of a document library header. | 2289 | Regexp 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}. | |||
| 2361 | Normal hook. Executed when @file{idlwave.el} is loaded. | 2360 | Normal 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 | |||
| 2378 | debug these programs. The IDLWAVE shell is built on @file{comint}, an | 2377 | debug these programs. The IDLWAVE shell is built on @file{comint}, an |
| 2379 | Emacs packages which handles the communication with the IDL program. | 2378 | Emacs packages which handles the communication with the IDL program. |
| 2380 | Unfortunately, IDL for Windows does not have command-prompt versions and | 2379 | Unfortunately, IDL for Windows does not have command-prompt versions and |
| 2381 | thus do not allow the interaction with Emacs --- so the IDLWAVE shell | 2380 | thus do not allow the interaction with Emacs, so the IDLWAVE shell |
| 2382 | currently only works under Unix and MacOSX. | 2381 | currently 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. | |||
| 2500 | Hook for customizing @code{idlwave-shell-mode}. | 2499 | Hook 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 | |||
| 2627 | modes. | 2626 | modes. |
| 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 | |||
| 2726 | prevented from activating automatically by customizing the variable | 2725 | prevented 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 | |||
| 2736 | done with @kbd{C-c C-d C-b}, and compiling a source file with @kbd{C-c | 2735 | done with @kbd{C-c C-d C-b}, and compiling a source file with @kbd{C-c |
| 2737 | C-d C-c}. You can also easily configure IDLWAVE to use one or more | 2736 | C-d C-c}. You can also easily configure IDLWAVE to use one or more |
| 2738 | modifier keys not in use by other commands, in lieu of the prefix | 2737 | modifier 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 | 2739 | see @code{idlwave-shell-activate-prefix-keybindings}). For |
| 2741 | example, if you include in @file{.emacs}: | 2740 | example, 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}, | |||
| 2750 | etc. In the remainder of this chapter we will assume that the | 2749 | etc. 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 |
| 2752 | have an equivalent shortcut if modifiers are given in the | 2751 | have 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 |
| 2754 | Customization}). A much simpler and faster form of debugging for | 2753 | II---Customization}). A much simpler and faster form of debugging for |
| 2755 | running code is also available by default --- see @ref{Electric Debug | 2754 | running code is also available by default; see @ref{Electric Debug |
| 2756 | Mode}. | 2755 | Mode}. |
| 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 | |||
| 2788 | With a numeric prefix greater than one (e.g., @kbd{C-4 C-c C-d C-b}), | 2787 | With a numeric prefix greater than one (e.g., @kbd{C-4 C-c C-d C-b}), |
| 2789 | the breakpoint will only be active the @code{nth} time it is hit. | 2788 | the breakpoint will only be active the @code{nth} time it is hit. |
| 2790 | With a single non-numeric prefix (i.e., @kbd{C-u C-c C-d C-b}), prompt | 2789 | With a single non-numeric prefix (i.e., @kbd{C-u C-c C-d C-b}), prompt |
| 2791 | for a condition --- an IDL expression to be evaluated and trigger the | 2790 | for a condition: an IDL expression to be evaluated and trigger the |
| 2792 | breakpoint only if true. To clear the breakpoint in the current line, | 2791 | breakpoint only if true. To clear the breakpoint in the current line, |
| 2793 | use @kbd{C-c C-d C-d} (@code{idlwave-clear-current-bp}). When | 2792 | use @kbd{C-c C-d C-d} (@code{idlwave-clear-current-bp}). When |
| 2794 | executed from the shell window, the breakpoint where IDL is currently | 2793 | executed 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 | |||
| 2937 | very useful. A temporary file is created holding the contents of the | 2936 | very useful. A temporary file is created holding the contents of the |
| 2938 | current region (with @code{END} appended), and run from the shell. | 2937 | current 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 | |||
| 3119 | execution is stopped in a buffer due to a triggered breakpoint or error, | 3118 | execution is stopped in a buffer due to a triggered breakpoint or error, |
| 3120 | or while composing a long command in the IDLWAVE shell. In the latter | 3119 | or while composing a long command in the IDLWAVE shell. In the latter |
| 3121 | case, the command is sent to the shell and its output is visible, but | 3120 | case, the command is sent to the shell and its output is visible, but |
| 3122 | point remains unmoved in the command being composed --- you can inspect | 3121 | point remains unmoved in the command being composed: you can inspect |
| 3123 | the constituents of a command you're building without interrupting the | 3122 | the constituents of a command you're building without interrupting the |
| 3124 | process of building it! You can even print arbitrary expressions from | 3123 | process of building it! You can even print arbitrary expressions from |
| 3125 | older input or output further up in the shell window --- any expression, | 3124 | older input or output further up in the shell window; any expression, |
| 3126 | variable, number, or function you see can be examined. | 3125 | variable, number, or function you see can be examined. |
| 3127 | 3126 | ||
| 3128 | If the variable @code{idlwave-shell-separate-examine-output} is | 3127 | If the variable @code{idlwave-shell-separate-examine-output} is |
| @@ -3203,7 +3202,7 @@ The maximum number of leading array entries to print, when examining | |||
| 3203 | array expressions. | 3202 | array 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 |
| 3353 | Thanks to everyone! | 3352 | Thanks 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, | |||
| 3405 | except by querying the Shell for calling information (DLMs only). | 3404 | except 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 | |||
| 3506 | with IDLWAVE@. The traditional @emph{user catalog} and the newer | 3505 | with 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 |
| 3508 | library catalogs are more flexible, and preferred. There are few | 3507 | library catalogs are more flexible, and preferred. There are few |
| 3509 | occasions when a user catalog might be preferred --- read below. Both | 3508 | occasions when a user catalog might be preferred---read below. Both |
| 3510 | types of catalogs can coexist without causing problems. | 3509 | types of catalogs can coexist without causing problems. |
| 3511 | 3510 | ||
| 3512 | To facilitate the catalog systems, IDLWAVE stores information it gathers | 3511 | To 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 | |||
| 3564 | in directories containing @code{.pro} routine files. They are | 3563 | in directories containing @code{.pro} routine files. They are |
| 3565 | discovered on the IDL search path and loaded automatically when routine | 3564 | discovered on the IDL search path and loaded automatically when routine |
| 3566 | information is read. Each catalog file documents the routines found in | 3565 | information is read. Each catalog file documents the routines found in |
| 3567 | that directory --- one catalog per directory. Every catalog has a | 3566 | that directory---one catalog per directory. Every catalog has a |
| 3568 | library name associated with it (e.g., @emph{AstroLib}). This name will | 3567 | library name associated with it (e.g., @emph{AstroLib}). This name will |
| 3569 | be shown briefly when the catalog is found, and in the routine info of | 3568 | be shown briefly when the catalog is found, and in the routine info of |
| 3570 | routines it documents. | 3569 | routines it documents. |
| @@ -3618,7 +3617,7 @@ Whether to search for and load library catalogs. Disable if load | |||
| 3618 | performance is a problem and/or the catalogs are not needed. | 3617 | performance 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 | |||
| 3691 | labeling in routine-info display. | 3690 | labeling 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. | |||
| 3751 | Another way to find out if a specific routine has multiple definitions | 3750 | Another way to find out if a specific routine has multiple definitions |
| 3752 | on the load path is routine info display (@pxref{Routine Info}). | 3751 | on 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. | |||
| 3784 | Instructions on how to use @file{get_html_rinfo} are in the program | 3783 | Instructions on how to use @file{get_html_rinfo} are in the program |
| 3785 | itself. | 3784 | itself. |
| 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 |
| 4066 | sure you check the following things: | 4065 | sure 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 |
| 4070 | file under the names @file{idlwave.tar.gz}. | 4069 | file 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 |
| 4072 | instead. | 4071 | instead. |
| 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 @@ | |||
| 14 | This file describes how to use Info, the on-line, menu-driven GNU | 14 | This file describes how to use Info, the on-line, menu-driven GNU |
| 15 | documentation system. | 15 | documentation system. |
| 16 | 16 | ||
| 17 | Copyright @copyright{} 1989, 1992, 1996-2012 Free Software Foundation, Inc. | 17 | Copyright @copyright{} 1989, 1992, 1996--2013 Free Software Foundation, Inc. |
| 18 | 18 | ||
| 19 | @quotation | 19 | @quotation |
| 20 | Permission is granted to copy, distribute and/or modify this document | 20 | Permission is granted to copy, distribute and/or modify this document |
| 21 | under the terms of the GNU Free Documentation License, Version 1.3 or | 21 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| 22 | any later version published by the Free Software Foundation; with no | 22 | any later version published by the Free Software Foundation; with no |
| 23 | Invariant Sections, with the Front-Cover texts being ``A GNU | 23 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 24 | Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the | 24 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 25 | license is included in the section entitled ``GNU Free Documentation | 25 | is included in the section entitled ``GNU Free Documentation License''. |
| 26 | License'' 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 |
| 29 | modify this GNU manual. Buying copies from the FSF supports it in | 28 | modify this GNU manual.'' |
| 30 | developing GNU and promoting software freedom.'' | ||
| 31 | |||
| 32 | This document is part of a collection distributed under the GNU Free | ||
| 33 | Documentation License. If you want to distribute this document | ||
| 34 | separately from the collection, you can do so by adding a copy of the | ||
| 35 | license 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. | |||
| 1504 | To check an Info file, do @kbd{M-x Info-validate} while looking at any | 1498 | To check an Info file, do @kbd{M-x Info-validate} while looking at any |
| 1505 | node of the file with Emacs Info mode. | 1499 | node 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 |
| 9 | Copyright @copyright{} 2008-2012 Free Software Foundation, Inc. | 9 | Copyright @copyright{} 2008--2013 Free Software Foundation, Inc. |
| 10 | 10 | ||
| 11 | @quotation | 11 | @quotation |
| 12 | Permission is granted to copy, distribute and/or modify this document | 12 | Permission 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 | |||
| 17 | is included in the section entitled ``GNU Free Documentation License''. | 17 | is 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 |
| 20 | modify this GNU manual. Buying copies from the FSF supports it in | 20 | modify this GNU manual.'' |
| 21 | developing 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 | ||
| 44 | Mairix is a tool for indexing and searching words in locally stored | 43 | Mairix is a tool for indexing and searching words in locally stored |
| 45 | mail. It was written by Richard Curnow and is licensed under the | 44 | mail. 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 | ||
| 347 | And that's it! | 347 | And 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) |
| 60 | DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \ | 60 | DVI_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 |
| 72 | INFOSOURCES = info.texi | 72 | INFOSOURCES = 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 |
| 111 | cc-mode.dvi: cc-mode.texi doclicense.texi | 111 | cc-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 |
| 116 | ada-mode.dvi: ada-mode.texi doclicense.texi | 116 | ada-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 |
| 121 | pcl-cvs.dvi: pcl-cvs.texi doclicense.texi | 121 | pcl-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 |
| 126 | eshell.dvi: eshell.texi doclicense.texi | 126 | eshell.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 |
| 131 | cl.dvi: cl.texi doclicense.texi | 131 | cl.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 |
| 136 | dbus.dvi: dbus.texi doclicense.texi | 136 | dbus.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 |
| 141 | dired-x.dvi: dired-x.texi $(emacsdir)/emacsver.texi doclicense.texi | 141 | dired-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 |
| 146 | ediff.dvi: ediff.texi doclicense.texi | 146 | ediff.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 |
| 151 | flymake.dvi: flymake.texi doclicense.texi | 151 | flymake.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 |
| 156 | forms.dvi: forms.texi doclicense.texi | 156 | forms.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 |
| 164 | gnus.dvi: gnus.texi gnus-overrides.texi message.texi emacs-mime.texi \ | 163 | gnus.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 |
| 174 | message.dvi: message.texi gnus-overrides.texi doclicense.texi | 172 | message.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 |
| 179 | emacs-mime.dvi: emacs-mime.texi gnus-overrides.texi doclicense.texi | 177 | emacs-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 |
| 184 | sieve.dvi: sieve.texi gnus-overrides.texi doclicense.texi | 182 | sieve.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 |
| 189 | pgg.dvi: pgg.texi gnus-overrides.texi doclicense.texi | 187 | pgg.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 |
| 194 | mh-e.dvi: mh-e.texi doclicense.texi gpl.texi | 192 | mh-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 |
| 199 | reftex.dvi: reftex.texi doclicense.texi | 197 | reftex.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 |
| 204 | remember.dvi: remember.texi doclicense.texix | 202 | remember.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 | |||
| 209 | sasl.dvi: sasl.texi gnus-overrides.texi | 207 | sasl.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 |
| 214 | sc.dvi: sc.texi doclicense.texi | 212 | sc.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 |
| 219 | vip.dvi: vip.texi doclicense.texi | 217 | vip.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 |
| 224 | viper.dvi: viper.texi doclicense.texi | 222 | viper.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 |
| 229 | widget.dvi: widget.texi doclicense.texi | 227 | widget.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 | |||
| 234 | faq.dvi: faq.texi $(emacsdir)/emacsver.texi | 232 | faq.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 |
| 239 | autotype.dvi: autotype.texi doclicense.texi | 237 | autotype.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 |
| 244 | calc.dvi: calc.texi $(emacsdir)/emacsver.texi gpl.texi doclicense.texi | 242 | calc.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 |
| 251 | idlwave.dvi: idlwave.texi doclicense.texi | 249 | idlwave.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 |
| 256 | eudc.dvi: eudc.texi doclicense.texi | 254 | eudc.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 |
| 261 | ebrowse.dvi: ebrowse.texi doclicense.texi | 259 | ebrowse.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 |
| 266 | woman.dvi: woman.texi doclicense.texi | 264 | woman.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 |
| 271 | speedbar.dvi: speedbar.texi doclicense.texi | 269 | speedbar.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 |
| 276 | tramp.dvi: tramp.texi trampver.texi doclicense.texi | 274 | tramp.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 |
| 281 | ses.dvi: ses.texi doclicense.texi | 279 | ses.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 |
| 286 | smtpmail.dvi: smtpmail.texi doclicense.texi | 284 | smtpmail.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 | |||
| 291 | org.dvi: org.texi | 289 | org.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 |
| 296 | url.dvi: url.texi doclicense.texi | 294 | url.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 |
| 301 | newsticker.dvi: newsticker.texi doclicense.texi | 299 | newsticker.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 | |||
| 306 | nxml-mod.dvi: nxml-mode.texi | 304 | nxml-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 |
| 311 | rcirc.dvi: rcirc.texi doclicense.texi | 309 | rcirc.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 |
| 316 | erc.dvi: erc.texi gpl.texi doclicense.texi | 314 | erc.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 | |||
| 346 | ede.dvi: ede.texi | 344 | ede.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 |
| 351 | semantic.dvi: semantic.texi sem-user.texi doclicense.texi | 349 | semantic.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 |
| 356 | edt.dvi: edt.texi doclicense.texi | 354 | edt.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 |
| 361 | emacs-gnutls.dvi: emacs-gnutls.texi doclicense.texi | 359 | emacs-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 |
| 366 | srecode.dvi: srecode.texi doclicense.texi | 364 | srecode.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 |
| 371 | bovine.dvi: bovine.texi doclicense.texi | 369 | bovine.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 |
| 376 | wisent.dvi: wisent.texi doclicense.texi | 374 | wisent.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 | ||
| 379 | htmlfontify.dvi: htmlfontify.texi | ||
| 380 | $(ENVADD) $(TEXI2DVI) $(srcdir)/htmlfontify.texi | ||
| 381 | |||
| 382 | |||
| 383 | $(INFO_TARGETS): doclicense.texi | ||
| 384 | $(DVI_TARGETS): doclicense.texi | ||
| 385 | |||
| 379 | mostlyclean: | 386 | mostlyclean: |
| 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 | ||
| 410 | distclean: clean | 418 | distclean: 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 |
| 11 | This file documents Message, the Emacs message composition mode. | 11 | This file documents Message, the Emacs message composition mode. |
| 12 | 12 | ||
| 13 | Copyright @copyright{} 1996-2012 Free Software Foundation, Inc. | 13 | Copyright @copyright{} 1996--2013 Free Software Foundation, Inc. |
| 14 | 14 | ||
| 15 | @quotation | 15 | @quotation |
| 16 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 | |||
| 21 | is included in the section entitled ``GNU Free Documentation License''. | 21 | is 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 |
| 24 | modify this GNU manual. Buying copies from the FSF supports it in | 24 | modify this GNU manual.'' |
| 25 | developing 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 | |||
| 477 | Now you are all set. Just start composing a message as you normally do. | 476 | Now you are all set. Just start composing a message as you normally do. |
| 478 | And just send it; as always. Just before the message is sent out, Gnus' | 477 | And just send it; as always. Just before the message is sent out, Gnus' |
| 479 | MFT generation thingy kicks in and checks if the message already has a | 478 | MFT generation thingy kicks in and checks if the message already has a |
| 480 | MFT field. If there is one, it is left alone. (Except if it's empty - | 479 | MFT field. If there is one, it is left alone. (Except if it's empty; |
| 481 | in that case, the field is removed and is not replaced with an | 480 | in that case, the field is removed and is not replaced with an |
| 482 | automatically generated one. This lets you disable MFT generation on a | 481 | automatically generated one. This lets you disable MFT generation on a |
| 483 | per-message basis.) If there is none, then the list of recipient | 482 | per-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 |
| 2210 | Hook run before sending mail messages. This hook is run very late -- | 2209 | Hook run before sending mail messages. This hook is run very late: |
| 2211 | just before the message is actually sent as mail. | 2210 | just 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 |
| 2215 | Hook run before sending news messages. This hook is run very late -- | 2214 | Hook run before sending news messages. This hook is run very late: |
| 2216 | just before the message is actually sent as news. | 2215 | just 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 @@ | |||
| 24 | This is version @value{VERSION}@value{EDITION} of @cite{The MH-E | 24 | This is version @value{VERSION}@value{EDITION} of @cite{The MH-E |
| 25 | Manual}, last updated @value{UPDATED}. | 25 | Manual}, last updated @value{UPDATED}. |
| 26 | 26 | ||
| 27 | Copyright @copyright{} 1995, 2001-2003, 2005-2012 Free Software Foundation, Inc. | 27 | Copyright @copyright{} 1995, 2001--2003, 2005--2013 Free Software |
| 28 | Foundation, 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 | |||
| 41 | the section entitled ``GNU Free Documentation License.'' | 42 | the 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 |
| 44 | modify this GNU manual. Buying copies from the FSF supports it in | 45 | modify this GNU manual.'' |
| 45 | developing GNU and promoting software freedom.'' | ||
| 46 | 46 | ||
| 47 | @item | 47 | @item |
| 48 | the GNU General Public License as published by the Free Software | 48 | the 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 |
| 216 | Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is | 216 | Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is |
| 217 | known not to work with GNU Emacs versions 20 and below, and XEmacs | 217 | known not to work with GNU Emacs versions 20 and below, and XEmacs |
| 218 | version 21.5.9 - 21.5.16. It is compatible with MH versions 6.8.4 and | 218 | version 21.5.9--21.5.16. It is compatible with MH versions 6.8.4 and |
| 219 | higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you | 219 | higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you |
| 220 | shouldn't have to do anything special to use it. Gnus is also | 220 | shouldn't have to do anything special to use it. Gnus is also |
| 221 | required; version 5.10 or higher is recommended. This manual covers | 221 | required; 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 | |||
| 5645 | you can check the actual address(es) in the alias. A new buffer named | 5645 | you 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 |
| 5649 | whatnow Program} in the MH book.}. | 5649 | whatnow 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 | |||
| 7763 | conservative. Add that many dots to the @samp{X-Spam-Level:} header | 7763 | conservative. Add that many dots to the @samp{X-Spam-Level:} header |
| 7764 | field above to send messages with that score down the drain. | 7764 | field above to send messages with that score down the drain. |
| 7765 | 7765 | ||
| 7766 | In the example above, messages with a score of 5-9 are set aside in | 7766 | In the example above, messages with a score of 5--9 are set aside in |
| 7767 | the @samp{+spam} folder for later review. The major weakness of | 7767 | the @samp{+spam} folder for later review. The major weakness of |
| 7768 | rules-based filters is a plethora of false positives so it is | 7768 | rules-based filters is a plethora of false positives so it is |
| 7769 | worthwhile to check. | 7769 | worthwhile to check. |
| @@ -8665,7 +8665,7 @@ In order to send mail within Gnus using MH-E, set this option to | |||
| 8665 | Since Gnus keeps track of which messages you have read, it would be | 8665 | Since Gnus keeps track of which messages you have read, it would be |
| 8666 | bad if Gnus expired the last message, for example, message 100, and | 8666 | bad 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 |
| 8668 | ignore it since it thinks that you've read messages 1-100. Turning on | 8668 | ignore it since it thinks that you've read messages 1--100. Turning on |
| 8669 | this option ensures that the last message is never removed thereby | 8669 | this option ensures that the last message is never removed thereby |
| 8670 | eliminating this problem. | 8670 | eliminating 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 | |||
| 8882 | simpler and the commands were slightly different. Unfortunately, I no | 8882 | simpler and the commands were slightly different. Unfortunately, I no |
| 8883 | longer have a copy so the differences are lost in the mists of time. | 8883 | longer have a copy so the differences are lost in the mists of time. |
| 8884 | 8884 | ||
| 8885 | In '82-83, I was working at BBN and wrote a lot of mlisp code in | 8885 | In '82--83, I was working at BBN and wrote a lot of mlisp code in |
| 8886 | Gosling Emacs to make it look more like Tennex Emacs. One of the | 8886 | Gosling Emacs to make it look more like Tennex Emacs. One of the |
| 8887 | packages that I picked up and improved was Reid's mail system. In '83, | 8887 | packages that I picked up and improved was Reid's mail system. In '83, |
| 8888 | I went back to Berkeley. About that time, Stallman's first version of | 8888 | I 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 @@ | |||
| 13 | This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}). | 13 | This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}). |
| 14 | 14 | ||
| 15 | @noindent | 15 | @noindent |
| 16 | Copyright @copyright{} 2004-2012 Free Software Foundation, Inc. | 16 | Copyright @copyright{} 2004--2013 Free Software Foundation, Inc. |
| 17 | 17 | ||
| 18 | @quotation | 18 | @quotation |
| 19 | Permission is granted to copy, distribute and/or modify this document | 19 | Permission 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 | |||
| 24 | is included in the section entitled ``GNU Free Documentation License''. | 24 | is 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 |
| 27 | modify this GNU manual. Buying copies from the FSF supports it in | 27 | modify this GNU manual.'' |
| 28 | developing 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. | |||
| 132 | Newsticker retrieves headlines either via Emacs's built-in retrieval | 131 | Newsticker retrieves headlines either via Emacs's built-in retrieval |
| 133 | functions, by an arbitrary external program that retrieves files via | 132 | functions, by an arbitrary external program that retrieves files via |
| 134 | http and prints them to stdout (like | 133 | http 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 |
| 136 | per feed basis -- via an arbitrary Lisp command. | 135 | per 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 @@ | |||
| 8 | This manual documents nXML mode, an Emacs major mode for editing | 8 | This manual documents nXML mode, an Emacs major mode for editing |
| 9 | XML with RELAX NG support. | 9 | XML with RELAX NG support. |
| 10 | 10 | ||
| 11 | Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. | 11 | Copyright @copyright{} 2007--2013 Free Software Foundation, Inc. |
| 12 | 12 | ||
| 13 | @quotation | 13 | @quotation |
| 14 | Permission is granted to copy, distribute and/or modify this document | 14 | Permission is granted to copy, distribute and/or modify this document |
| 15 | under the terms of the GNU Free Documentation License, Version 1.3 or | 15 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| 16 | any later version published by the Free Software Foundation; with no | 16 | any later version published by the Free Software Foundation; with no |
| 17 | Invariant Sections, with the Front-Cover texts being ``A GNU | 17 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 18 | Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the | 18 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 19 | license is included in the section entitled ``GNU Free Documentation | 19 | is included in the section entitled ``GNU Free Documentation License''. |
| 20 | License'' 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 22 | modify this GNU manual.'' |
| 24 | developing GNU and promoting software freedom.'' | ||
| 25 | |||
| 26 | This document is part of a collection distributed under the GNU Free | ||
| 27 | Documentation License. If you want to distribute this document | ||
| 28 | separately from the collection, you can do so by adding a copy of the | ||
| 29 | license 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 | |||
| 899 | specification are not enforced. | 893 | specification 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 |
| 263 | This manual is for Org version @value{VERSION}. | 263 | This manual is for Org version @value{VERSION}. |
| 264 | 264 | ||
| 265 | Copyright @copyright{} 2004-2012 Free Software Foundation, Inc. | 265 | Copyright @copyright{} 2004--2013 Free Software Foundation, Inc. |
| 266 | 266 | ||
| 267 | @quotation | 267 | @quotation |
| 268 | Permission is granted to copy, distribute and/or modify this document | 268 | Permission 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 | |||
| 273 | is included in the section entitled ``GNU Free Documentation License.'' | 273 | is 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 |
| 276 | modify this GNU manual. Buying copies from the FSF supports it in | 276 | modify this GNU manual.'' |
| 277 | developing GNU and promoting software freedom.'' | ||
| 278 | |||
| 279 | This document is part of a collection distributed under the GNU Free | ||
| 280 | Documentation License. If you want to distribute this document | ||
| 281 | separately from the collection, you can do so by adding a copy of the | ||
| 282 | license 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 | ||
| 989 | Org mode buffers need font-lock to be turned on - this is the default in | 987 | Org mode buffers need font-lock to be turned on: this is the default in |
| 990 | Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer | 988 | Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer |
| 991 | with @code{(add-hook 'org-mode-hook 'turn-on-font-lock)}}. | 989 | with @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. | |||
| 3029 | Selects this line for global recalculation with @kbd{C-u C-c *}, but | 3027 | Selects this line for global recalculation with @kbd{C-u C-c *}, but |
| 3030 | not for automatic recalculation. Use this when automatic | 3028 | not for automatic recalculation. Use this when automatic |
| 3031 | recalculation slows down editing too much. | 3029 | recalculation slows down editing too much. |
| 3032 | @item | 3030 | @item @ |
| 3033 | Unmarked lines are exempt from recalculation with @kbd{C-u C-c *}. | 3031 | Unmarked lines are exempt from recalculation with @kbd{C-u C-c *}. |
| 3034 | All lines that should be recalculated should be marked with @samp{#} | 3032 | All lines that should be recalculated should be marked with @samp{#} |
| 3035 | or @samp{*}. | 3033 | or @samp{*}. |
| @@ -3376,7 +3374,7 @@ buffer: | |||
| 3376 | For Org files, if there is a @samp{<<target>>} at the cursor, the link points | 3374 | For Org files, if there is a @samp{<<target>>} at the cursor, the link points |
| 3377 | to the target. Otherwise it points to the current headline, which will also | 3375 | to the target. Otherwise it points to the current headline, which will also |
| 3378 | be the description@footnote{If the headline contains a timestamp, it will be | 3376 | be the description@footnote{If the headline contains a timestamp, it will be |
| 3379 | removed from the link and result in a wrong link -- you should avoid putting | 3377 | removed from the link and result in a wrong link---you should avoid putting |
| 3380 | timestamp in the headline.}. | 3378 | timestamp 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.} | |||
| 5052 | To create sparse trees and special lists with selection based on properties, | 5050 | To create sparse trees and special lists with selection based on properties, |
| 5053 | the same commands are used as for tag searches (@pxref{Tag searches}). | 5051 | the 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} |
| 5056 | Create a sparse tree with all matching entries. With a | 5054 | Create 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. | |||
| 5238 | The @code{est+} summary type requires further explanation. It is used for | 5236 | The @code{est+} summary type requires further explanation. It is used for |
| 5239 | combining estimates, expressed as low-high ranges. For example, instead | 5237 | combining estimates, expressed as low-high ranges. For example, instead |
| 5240 | of estimating a particular task will take 5 days, you might estimate it as | 5238 | of estimating a particular task will take 5 days, you might estimate it as |
| 5241 | 5-6 days if you're fairly confident you know how much work is required, or | 5239 | 5--6 days if you're fairly confident you know how much work is required, or |
| 5242 | 1-10 days if you don't really know what needs to be done. Both ranges | 5240 | 1--10 days if you don't really know what needs to be done. Both ranges |
| 5243 | average at 5.5 days, but the first represents a more predictable delivery. | 5241 | average at 5.5 days, but the first represents a more predictable delivery. |
| 5244 | 5242 | ||
| 5245 | When combining a set of such estimates, simply adding the lows and highs | 5243 | When 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 | |||
| 5249 | estimated at 0.5 to 2 days of work. Straight addition produces an estimate | 5247 | estimated at 0.5 to 2 days of work. Straight addition produces an estimate |
| 5250 | of 5 to 20 days, representing what to expect if everything goes either | 5248 | of 5 to 20 days, representing what to expect if everything goes either |
| 5251 | extremely well or extremely poorly. In contrast, @code{est+} estimates the | 5249 | extremely well or extremely poorly. In contrast, @code{est+} estimates the |
| 5252 | full job more realistically, at 10-15 days. | 5250 | full job more realistically, at 10--15 days. |
| 5253 | 5251 | ||
| 5254 | Here is an example for a complete columns definition, along with allowed | 5252 | Here is an example for a complete columns definition, along with allowed |
| 5255 | values. | 5253 | values. |
| @@ -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} |
| 6543 | Call the command @code{org-capture}. Note that this keybinding is global and | 6541 | Call the command @code{org-capture}. Note that this keybinding is global and |
| 6544 | not active by default - you need to install it. If you have templates | 6542 | not active by default; you need to install it. If you have templates |
| 6545 | @cindex date tree | 6543 | @cindex date tree |
| 6546 | defined @pxref{Capture templates}, it will offer these templates for | 6544 | defined @pxref{Capture templates}, it will offer these templates for |
| 6547 | selection or use a new Org outline node as the default template. It will | 6545 | selection 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 | |||
| 8119 | month view, a year may be encoded in the prefix argument as well. For | 8117 | month view, a year may be encoded in the prefix argument as well. For |
| 8120 | example, @kbd{200712 w} will jump to week 12 in 2007. If such a year | 8118 | example, @kbd{200712 w} will jump to week 12 in 2007. If such a year |
| 8121 | specification has only one or two digits, it will be mapped to the interval | 8119 | specification has only one or two digits, it will be mapped to the interval |
| 8122 | 1938-2037. @kbd{v @key{SPC}} will reset to what is set in | 8120 | 1938--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 |
| 8279 | estimate in your array of allowed values, where @kbd{0} means the 10th value. | 8277 | estimate in your array of allowed values, where @kbd{0} means the 10th value. |
| 8280 | The filter will then restrict to entries with effort smaller-or-equal, equal, | 8278 | The filter will then restrict to entries with effort smaller-or-equal, equal, |
| 8281 | or larger-or-equal than the selected value. If the digits 0-9 are not used | 8279 | or larger-or-equal than the selected value. If the digits 0--9 are not used |
| 8282 | as fast access keys to tags, you can also simply press the index digit | 8280 | as fast access keys to tags, you can also simply press the index digit |
| 8283 | directly without an operator. In this case, @kbd{<} will be assumed. For | 8281 | directly without an operator. In this case, @kbd{<} will be assumed. For |
| 8284 | application of the operator, entries without a defined effort will be treated | 8282 | application 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 |
| 8340 | Digit argument. | 8338 | Digit 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 | |||
| 11150 | LibreOffice. The latter method is suitable for expert and non-expert | 11148 | LibreOffice. The latter method is suitable for expert and non-expert |
| 11151 | users alike, and is described here. | 11149 | users 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 |
| 11165 | Open the above @file{example.odt} using LibreOffice. Use the @file{Stylist} | 11163 | Open the above @file{example.odt} using LibreOffice. Use the @file{Stylist} |
| 11166 | to locate the target styles - these typically have the @samp{Org} prefix - | 11164 | to locate the target styles---these typically have the @samp{Org} prefix---and |
| 11167 | and modify those to your taste. Save the modified file either as an | 11165 | modify those to your taste. Save the modified file either as an |
| 11168 | OpenDocument Text (@file{.odt}) or OpenDocument Template (@file{.ott}) file. | 11166 | OpenDocument 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 | ||
| 11219 | Export of native Org mode tables (@pxref{Tables}) and simple @file{table.el} | 11217 | Export of native Org mode tables (@pxref{Tables}) and simple @file{table.el} |
| 11220 | tables is supported. However, export of complex @file{table.el} tables - | 11218 | tables is supported. However, export of complex @file{table.el} tables---tables |
| 11221 | tables that have column or row spans - is not supported. Such tables are | 11219 | that have column or row spans---is not supported. Such tables are |
| 11222 | stripped from the exported document. | 11220 | stripped from the exported document. |
| 11223 | 11221 | ||
| 11224 | By default, a table is exported with top and bottom frames and with rules | 11222 | By 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 |
| 11351 | You can control the manner in which an image is anchored by setting the | 11349 | You 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 |
| 11353 | of the the following three values for the @code{:anchor} property - | 11351 | of 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 | ||
| 11356 | To create an image that is anchored to a page, do the following: | 11354 | To 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 | ||
| 11459 | You can label and caption various category of objects - an inline image, a | 11457 | You can label and caption various category of objects---an inline image, a |
| 11460 | table, a @LaTeX{} fragment or a Math formula - using @code{#+LABEL} and | 11458 | table, 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 |
| 11462 | each labeled or captioned object of a given category separately. As a | 11460 | each labeled or captioned object of a given category separately. As a |
| 11463 | result, each such object is assigned a sequence number based on order of it's | 11461 | result, 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 |
| 11623 | It contains @samp{<text:sequence-decl>}@dots{}@samp{</text:sequence-decl>} | 11621 | It contains @samp{<text:sequence-decl>}@dots{}@samp{</text:sequence-decl>} |
| 11624 | elements that control how various entities - tables, images, equations etc - | 11622 | elements that control how various entities---tables, images, equations, |
| 11625 | are numbered. | 11623 | etc.---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 | ||
| 11761 | To have a quick preview of this feature, install the below setting and export | 11759 | To have a quick preview of this feature, install the below setting and export |
| 11762 | the table that follows. | 11760 | the 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 |
| 11789 | additional templates you have to define these styles yourselves. | 11787 | additional 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 |
| 11792 | To use this feature proceed as follows: | 11790 | To 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 |
| 14804 | This line sets the limits and the default for the priorities. All three | 14802 | This line sets the limits and the default for the priorities. All three |
| 14805 | must be either letters A-Z or numbers 0-9. The highest priority must | 14803 | must be either letters A--Z or numbers 0--9. The highest priority must |
| 14806 | have a lower ASCII number than the lowest priority. | 14804 | have a lower ASCII number than the lowest priority. |
| 14807 | @item #+PROPERTY: Property_Name Value | 14805 | @item #+PROPERTY: Property_Name Value |
| 14808 | This line sets a default inheritance value for entries in the current | 14806 | This 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 |
| 14812 | This line defines a file that holds more in-buffer setup. Normally this is | 14810 | This line defines a file that holds more in-buffer setup. Normally this is |
| 14813 | entirely ignored. Only when the buffer is parsed for option-setting lines | 14811 | entirely 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 |
| 14815 | settings line, or when exporting), then the contents of this file are parsed | 14813 | settings line, or when exporting), then the contents of this file are parsed |
| 14816 | as if they had been included in the buffer. In particular, the file can be | 14814 | as if they had been included in the buffer. In particular, the file can be |
| 14817 | any other Org mode file with internal setup. You can visit the file the | 14815 | any 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 | |||
| 15106 | stars but the last one are made invisible using the @code{org-hide} | 15104 | stars but the last one are made invisible using the @code{org-hide} |
| 15107 | face@footnote{Turning on @code{org-indent-mode} sets | 15105 | face@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 |
| 15110 | works. You can turn on @code{org-indent-mode} for all files by customizing | 15108 | works. You can turn on @code{org-indent-mode} for all files by customizing |
| 15111 | the variable @code{org-startup-indented}, or you can turn it on for | 15109 | the variable @code{org-startup-indented}, or you can turn it on for |
| 15112 | individual files using | 15110 | individual files using |
| @@ -15173,7 +15171,7 @@ example using the color @code{grey90} on a white background. | |||
| 15173 | Things become cleaner still if you skip all the even levels and use only odd | 15171 | Things become cleaner still if you skip all the even levels and use only odd |
| 15174 | levels 1, 3, 5..., effectively adding two stars to go from one outline level | 15172 | levels 1, 3, 5..., effectively adding two stars to go from one outline level |
| 15175 | to the next@footnote{When you need to specify a level for a property search | 15173 | to the next@footnote{When you need to specify a level for a property search |
| 15176 | or refile targets, @samp{LEVEL=2} will correspond to 3 stars, etc@.}. In this | 15174 | or refile targets, @samp{LEVEL=2} will correspond to 3 stars, etc.}. In this |
| 15177 | way we get the outline view shown at the beginning of this section. In order | 15175 | way we get the outline view shown at the beginning of this section. In order |
| 15178 | to make the structure editing and export commands handle this convention | 15176 | to make the structure editing and export commands handle this convention |
| 15179 | correctly, configure the variable @code{org-odd-levels-only}, or set this on | 15177 | correctly, 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 | |||
| 15264 | constants in the variable @code{org-table-formula-constants}, install | 15262 | constants in the variable @code{org-table-formula-constants}, install |
| 15265 | the @file{constants} package which defines a large number of constants | 15263 | the @file{constants} package which defines a large number of constants |
| 15266 | and units, and lets you use unit prefixes like @samp{M} for | 15264 | and 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 |
| 15268 | at @url{http://www.astro.uva.nl/~dominik/Tools}. Org checks for | 15266 | at @url{http://www.astro.uva.nl/~dominik/Tools}. Org checks for |
| 15269 | the function @code{constants-get}, which has to be autoloaded in your | 15267 | the function @code{constants-get}, which has to be autoloaded in your |
| 15270 | setup. See the installation instructions in the file | 15268 | setup. 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 | |||
| 16606 | agenda files. If you later use @kbd{C-c a ?} to regenerate the view, only | 16604 | agenda files. If you later use @kbd{C-c a ?} to regenerate the view, only |
| 16607 | the current agenda files will be searched.} using @kbd{C-c a ?}. | 16605 | the 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 | ||
| 16717 | I received support from so many users that it is clearly impossible to be | 16715 | I received support from so many users that it is clearly impossible to be |
| 16718 | fair when shortlisting a few of them -- but Org's history would not be | 16716 | fair when shortlisting a few of them, but Org's history would not be |
| 16719 | complete if the ones above were not mentioned in this manual. | 16717 | complete 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 |
| 9 | Copyright @copyright{} 1991-2012 Free Software Foundation, Inc. | 9 | Copyright @copyright{} 1991--2013 Free Software Foundation, Inc. |
| 10 | 10 | ||
| 11 | @quotation | 11 | @quotation |
| 12 | Permission is granted to copy, distribute and/or modify this document | 12 | Permission 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 | |||
| 17 | is included in the section entitled ``GNU Free Documentation License''. | 17 | is 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 |
| 20 | modify this GNU manual. Buying copies from the FSF supports it in | 20 | modify this GNU manual.'' |
| 21 | developing 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 | ||
| 66 | This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It | 65 | This 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 | |||
| 229 | there would be no new releases of PCL-CVS. | 228 | there 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 | |||
| 297 | commands are available simply by pressing a key (@pxref{Getting info | 296 | commands are available simply by pressing a key (@pxref{Getting info |
| 298 | about files}). | 297 | about 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 | |||
| 426 | although it has not been @samp{cvs remove}d. | 425 | although 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 | ||
| 469 | For commands to mark and unmark files, see @ref{Marking files}. | 468 | For 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 | |||
| 618 | to the ones PCL-CVS thinks are relevant. | 617 | to 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: | |||
| 683 | These keys move the cursor one file forward, towards the end of the | 682 | These keys move the cursor one file forward, towards the end of the |
| 684 | buffer (@code{cvs-mode-next-line}).@refill | 683 | buffer (@code{cvs-mode-next-line}).@refill |
| 685 | 684 | ||
| 686 | @itemx p | 685 | @item p |
| 687 | This key moves one file backward, towards the beginning of the buffer | 686 | This 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. | |||
| 975 | This runs @code{cvs-mode-ignore}. | 974 | This 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 | |||
| 1038 | By default, @samp{diff} commands ignore the marks. This can be changed | 1037 | By default, @samp{diff} commands ignore the marks. This can be changed |
| 1039 | with @code{cvs-invert-ignore-marks}. | 1038 | with @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 | |||
| 1070 | created will be overwritten.@refill | 1069 | created 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 | |||
| 1110 | to change this behavior. | 1109 | to 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}). | |||
| 1155 | Quit PCL-CVS, killing the @samp{*cvs*} buffer. | 1154 | Quit 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 |
| 1172 | If you work by writing entries in the @file{ChangeLog} | 1171 | If 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 |
| 1174 | control, you can generate the Log Edit text from the ChangeLog using | 1173 | control, 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 |
| 1176 | entries for the file(s) concerned in the top entry in the ChangeLog | 1175 | entries for the file(s) concerned in the top entry in the ChangeLog |
| 1177 | and uses those paragraphs as the log text. This text is only inserted | 1176 | and uses those paragraphs as the log text. This text is only inserted |
| 1178 | if the top entry was made under your user name on the current date. | 1177 | if 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 |
| 1180 | working---generating ChangeLog entries from the revision control log. | 1179 | working---generating ChangeLog entries from the revision control log. |
| 1181 | 1180 | ||
| 1182 | In the Log Edit buffer, @kbd{C-c C-f} (@kbd{M-x log-edit-show-files}) | 1181 | In 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*} | |||
| 1399 | buffer), and the versions of Emacs, PCL-CVS and CVS you are using. | 1398 | buffer), 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 | ||
| 1411 | This is an index of all the functions and variables documented in this | 1410 | This 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 | ||
| 1419 | This is an index of concepts discussed in this manual. | 1418 | This 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 | ||
| 1426 | This index includes an entry for each PCL-CVS key sequence documented in | 1425 | This 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 |
| 11 | This file describes PGG @value{VERSION}, an Emacs interface to various | 11 | This file describes PGG @value{VERSION}, an Emacs interface to various |
| 12 | PGP implementations. | 12 | PGP implementations. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 2001, 2003-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 2001, 2003--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License.'' | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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 |
| 8 | Copyright @copyright{} 2006-2012 | 8 | Copyright @copyright{} 2006--2013 Free Software Foundation, Inc. |
| 9 | Free Software Foundation, Inc. | ||
| 10 | 9 | ||
| 11 | @quotation | 10 | @quotation |
| 12 | Permission is granted to copy, distribute and/or modify this document | 11 | Permission 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 | |||
| 17 | included in the section entitled ``GNU Free Documentation License''. | 16 | included 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 |
| 20 | modify this GNU manual. Buying copies from the FSF supports it in | 19 | modify this GNU manual.'' |
| 21 | developing 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 | ||
| 100 | This chapter contains a brief introduction to IRC (Internet Relay Chat), | 98 | This 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 |
| 159 | Since this is so common, you can use @key{TAB} to do nick completion. | 157 | Since 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 | ||
| 248 | Use @kbd{C-c C-@key{SPC}} to switch to these buffers. | 246 | Use @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 |
| 433 | archive}. | 431 | archive}. |
| 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 | |||
| 670 | have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current | 668 | have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current |
| 671 | channel. | 669 | channel. |
| 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 | |||
| 744 | listed. Example: @code{/keyword manual}. | 742 | listed. 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 | |||
| 776 | window @code{rcirc} considers is controlled by the | 774 | window @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}, |
| 831 | for details. | 829 | for 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 |
| 853 | Manual}, for details. | 851 | Manual}, 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 | |||
| 900 | minutes until the client decides that the connection has in fact been | 898 | minutes until the client decides that the connection has in fact been |
| 901 | lost. The simple solution is to use @kbd{M-x rcirc}. The problem is | 899 | lost. The simple solution is to use @kbd{M-x rcirc}. The problem is |
| 902 | that this opens an @emph{additional} connection, so you'll have two | 900 | that this opens an @emph{additional} connection, so you'll have two |
| 903 | copies of every channel buffer --- one dead and one live. | 901 | copies of every channel buffer, one dead and one live. |
| 904 | 902 | ||
| 905 | The real answer, therefore, is a @code{/reconnect} command: | 903 | The 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 | |||
| 45 | to do labels, references, citations and indices for LaTeX documents | 45 | to do labels, references, citations and indices for LaTeX documents |
| 46 | with Emacs. | 46 | with Emacs. |
| 47 | 47 | ||
| 48 | Copyright @copyright{} 1997-2012 Free Software Foundation, Inc. | 48 | Copyright @copyright{} 1997--2013 Free Software Foundation, Inc. |
| 49 | 49 | ||
| 50 | @quotation | 50 | @quotation |
| 51 | Permission is granted to copy, distribute and/or modify this document | 51 | Permission 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 | |||
| 56 | is included in the section entitled ``GNU Free Documentation License''. | 56 | is 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 |
| 59 | modify this GNU manual. Buying copies from the FSF supports it in | 59 | modify this GNU manual.'' |
| 60 | developing 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 | |||
| 517 | part is a command and variable reference. | 515 | part 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 |
| 611 | an active region, all sections in the region will be promoted, including | 609 | an active region, all sections in the region will be promoted, including |
| 612 | the one at point. To avoid mistakes, @RefTeX{} requires a fresh | 610 | the one at point. To avoid mistakes, @RefTeX{} requires a fresh |
| 613 | document scan before executing this command -- if necessary, it will | 611 | document scan before executing this command; if necessary, it will |
| 614 | automatically do this scan and ask the user to repeat the promotion | 612 | automatically do this scan and ask the user to repeat the promotion |
| 615 | command. | 613 | command. |
| 616 | 614 | ||
| @@ -626,7 +624,7 @@ useful when a package like @file{fancyref} is used where the label | |||
| 626 | prefix determines the wording of a reference. After a | 624 | prefix determines the wording of a reference. After a |
| 627 | promotion/demotion it may be necessary to change a few labels from | 625 | promotion/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 |
| 629 | used to do this - it launches a query replace to rename the definition | 627 | used to do this; it launches a query replace to rename the definition |
| 630 | and all references of a label. | 628 | and 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 | |||
| 766 | theorem-like environments. @xref{Defining Label Environments}, for an | 764 | theorem-like environments. @xref{Defining Label Environments}, for an |
| 767 | example. | 765 | example. |
| 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 | ||
| 789 | Several different environments can share a common counter and therefore | 787 | Several different environments can share a common counter and therefore |
| 790 | a common label category. For example labels in both @code{equation} and | 788 | a 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 |
| 792 | equation counter. | 790 | equation 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 | |||
| 868 | set it up to delegate the creation of labels to | 866 | set 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}). | |||
| 1093 | In order to define additional commands for the selection process, the | 1091 | In order to define additional commands for the selection process, the |
| 1094 | keymap @code{reftex-select-label-map} may be used. | 1092 | keymap @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 |
| 1199 | them (@pxref{Defining Label Environments}). | 1197 | them (@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 | |||
| 1363 | Labels)}). | 1361 | Labels)}). |
| 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 | |||
| 1449 | indicates that this is a figure label which will be listed together with | 1447 | indicates that this is a figure label which will be listed together with |
| 1450 | labels from normal figure environments. The @code{nil} entries for | 1448 | labels from normal figure environments. The @code{nil} entries for |
| 1451 | prefix and reference format mean to use the defaults for figure labels. | 1449 | prefix and reference format mean to use the defaults for figure labels. |
| 1452 | The @samp{3} for the context method means to grab the third macro argument | 1450 | The @samp{3} for the context method means to grab the third macro argument: |
| 1453 | -- the caption. | 1451 | the caption. |
| 1454 | 1452 | ||
| 1455 | As a side effect of this configuration, @code{reftex-label} will now | 1453 | As a side effect of this configuration, @code{reftex-label} will now |
| 1456 | insert the required naked label (without the @code{\label} macro) when | 1454 | insert 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 | ||
| 1521 | Note that this is automatically done by the @file{amsmath.el} style file | 1519 | Note that this is automatically done by the @file{amsmath.el} style file |
| 1522 | of @AUCTeX{} (@pxref{Style Files}) -- so if you use @AUCTeX{}, | 1520 | of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{}, |
| 1523 | this configuration will not be necessary. | 1521 | this 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 | ||
| 1629 | When you have to put several entries into @code{reftex-label-alist}, just | 1627 | When 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 |
| 1664 | information. | 1662 | information. |
| 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 | ||
| 1669 | In case you defined your own macros for referencing or you are using | 1667 | In 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}@}} | |||
| 1744 | creates not only the number of the referenced counter but also the | 1742 | creates not only the number of the referenced counter but also the |
| 1745 | complete text around it, like @samp{Figure 3 on the preceding page}. In | 1743 | complete text around it, like @samp{Figure 3 on the preceding page}. In |
| 1746 | order to make it work you need to use label prefixes like @samp{fig:} | 1744 | order to make it work you need to use label prefixes like @samp{fig:} |
| 1747 | consistently -- something @RefTeX{} does automatically. For each of | 1745 | consistently---something @RefTeX{} does automatically. For each of |
| 1748 | these packages a variable could be configured to make its macros to take | 1746 | these packages a variable could be configured to make its macros to take |
| 1749 | precedence over @code{\ref}. Those were @code{reftex-vref-is-default} | 1747 | precedence over @code{\ref}. Those were @code{reftex-vref-is-default} |
| 1750 | and @code{reftex-fref-is-default} respectively. While still working, | 1748 | and @code{reftex-fref-is-default} respectively. While still working, |
| 1751 | these variables are deprecated now. Instead of setting them, the | 1749 | these variables are deprecated now. Instead of setting them, the |
| 1752 | variable @code{reftex-ref-style-default-list} should be adapted now. | 1750 | variable @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 | |||
| 1786 | information and the use of multiple selection buffers can mean a large | 1784 | information and the use of multiple selection buffers can mean a large |
| 1787 | speed-up (@pxref{Optimizations}). | 1785 | speed-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 | |||
| 2021 | document. @xref{Style Files}, for information on how to set up the style | 2019 | document. @xref{Style Files}, for information on how to set up the style |
| 2022 | files correctly. | 2020 | files 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 | |||
| 2042 | corresponding to a @code{\bibitem} or @BibTeX{} database entry. | 2040 | corresponding 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 | |||
| 2057 | you have multiple bibliographies within a @emph{single file}, this may | 2055 | you have multiple bibliographies within a @emph{single file}, this may |
| 2058 | or may not be the case. | 2056 | or 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 | |||
| 2110 | either the @i{marked} entries (with the @kbd{e} key) or the | 2108 | either 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 |
| 2209 | to the redefined @code{\index} macro. | 2207 | to 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 |
| 2287 | identifying one of the macros defined in the file header. It is | 2285 | identifying one of the macros defined in the file header. It is |
| 2288 | optional - when omitted, the first macro definition line in the file | 2286 | optional; when omitted, the first macro definition line in the file |
| 2289 | will be used for this phrase. The @var{phrase} is the phrase to be | 2287 | will be used for this phrase. The @var{phrase} is the phrase to be |
| 2290 | searched for when indexing. It may contain several words separated by | 2288 | searched for when indexing. It may contain several words separated by |
| 2291 | spaces. By default the search phrase is also the text entered as | 2289 | spaces. 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} |
| 2323 | and will therefore create two different index entries. | 2321 | and 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 |
| 2332 | Before indexing the phrases in the phrases buffer, they should be | 2330 | Before indexing the phrases in the phrases buffer, they should be |
| 2333 | checked carefully for consistency. A first step is to sort the phrases | 2331 | checked carefully for consistency. A first step is to sort the phrases |
| 2334 | alphabetically - this is done with the command @kbd{C-c C-s} | 2332 | alphabetically; 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 |
| 2336 | buffer alphabetically by search phrase. If you want to group certain | 2334 | buffer alphabetically by search phrase. If you want to group certain |
| 2337 | phrases and only sort within the groups, insert empty lines between the | 2335 | phrases 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. | |||
| 2355 | In order to check the whole buffer like this, start at the beginning and | 2353 | In order to check the whole buffer like this, start at the beginning and |
| 2356 | execute this command repeatedly. | 2354 | execute 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 | |||
| 2436 | purpose. When called from a @LaTeX{} document with active region, it will | 2434 | purpose. When called from a @LaTeX{} document with active region, it will |
| 2437 | apply @code{reftex-index-all-phrases} to the current region. | 2435 | apply @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, | |||
| 2635 | you will have to explicitly specify the index style used. | 2633 | you 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 | |||
| 2679 | respectively. | 2677 | respectively. |
| 2680 | 2678 | ||
| 2681 | The following string is empty unless your macro adds a superordinate | 2679 | The following string is empty unless your macro adds a superordinate |
| 2682 | entry to the index key - this is the case for the @code{\astobj} macro. | 2680 | entry to the index key; this is the case for the @code{\astobj} macro. |
| 2683 | 2681 | ||
| 2684 | The next entry can be a hook function to exclude certain matches, it | 2682 | The next entry can be a hook function to exclude certain matches, it |
| 2685 | almost always can be @code{nil}. | 2683 | almost always can be @code{nil}. |
| @@ -2732,7 +2730,7 @@ which specifies that the macro identified with the character @code{?x} (the | |||
| 2732 | in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}). | 2730 | in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}). |
| 2733 | The index tag is "idx". | 2731 | The 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 |
| 2824 | entire set of options. | 2825 | entire 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 |
| 2898 | which should be used to add keys, see @ref{Keymaps and Hooks}. | 2899 | which 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 | |||
| 2909 | loaded. If you wish to turn off fontification or change the involved | 2910 | loaded. If you wish to turn off fontification or change the involved |
| 2910 | faces, see @ref{Options (Fontification)}. | 2911 | faces, 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 | |||
| 2962 | context. | 2963 | context. |
| 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 | |||
| 3675 | supporting @LaTeX{} labels and references with an editor (which was | 3676 | supporting @LaTeX{} labels and references with an editor (which was |
| 3676 | MicroEmacs at the time). | 3677 | MicroEmacs 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 |
| 3742 | Add current selection or the word at point to the phrases buffer. | 3748 | Add current selection or the word at point to the phrases buffer. |
| 3743 | When you are in transient-mark-mode and the region is active, the | 3749 | When you are in transient-mark-mode and the region is active, the |
| 3744 | selection will be used - otherwise the word at point. | 3750 | selection will be used; otherwise the word at point. |
| 3745 | You get a chance to edit the entry in the phrases buffer - to save the | 3751 | You get a chance to edit the entry in the phrases buffer; to save the |
| 3746 | buffer and return to the @LaTeX{} document, finish with @kbd{C-c C-c}. | 3752 | buffer 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 | |||
| 3877 | removes the parse file associated with the current document. | 3883 | removes 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 | ||
| 3884 | Here is a complete list of @RefTeX{}'s configuration variables. All | 3890 | Here is a complete list of @RefTeX{}'s configuration variables. All |
| 3885 | variables have customize support - so if you are not familiar with Emacs | 3891 | variables have customize support, so if you are not familiar with Emacs |
| 3886 | Lisp (and even if you are) you might find it more comfortable to use | 3892 | Lisp (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 |
| 3888 | reftex-customize} will get you there. | 3894 | reftex-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 |
| 4064 | arguments, a star to mark the label argument, if any. The macro does | 4071 | arguments, a star to mark the label argument, if any. The macro does |
| 4065 | not have to have a label argument - you could also use | 4072 | not 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 | ||
| 4068 | Special names: @code{section} for section labels, @code{any} to define a | 4075 | Special 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 |
| 4217 | Alist with default regular expressions for finding context. The emacs | 4224 | Alist with default regular expressions for finding context. The emacs |
| 4218 | lisp form @w{@code{(format regexp (regexp-quote environment))}} is used | 4225 | lisp form @w{@code{(format regexp (regexp-quote environment))}} is used |
| 4219 | to calculate the final regular expression - so @samp{%s} will be | 4226 | to calculate the final regular expression, so @samp{%s} will be |
| 4220 | replaced with the environment or macro. | 4227 | replaced 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 | |||
| 4252 | non-footnote labels. | 4259 | non-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 | ||
| 4408 | Most options can also be switched from the label menu itself - so if you | 4415 | Most options can also be switched from the label menu itself, so if you |
| 4409 | decide here to not have a table of contents in the label menu, you can | 4416 | decide here to not have a table of contents in the label menu, you can |
| 4410 | still get one interactively during selection from the label menu. | 4417 | still 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 | |||
| 4463 | label type. To do that, @RefTeX{} will look at the word before the | 4470 | label type. To do that, @RefTeX{} will look at the word before the |
| 4464 | cursor and compare it with the magic words given in | 4471 | cursor 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 |
| 4466 | immediately offer the correct label menu - otherwise it will prompt you | 4473 | immediately offer the correct label menu; otherwise it will prompt you |
| 4467 | for a label type. If you set this variable to @code{nil}, @RefTeX{} | 4474 | for a label type. If you set this variable to @code{nil}, @RefTeX{} |
| 4468 | will always prompt for a label type. | 4475 | will 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 |
| 4605 | nil @r{Never prompt for optional arguments} | 4612 | nil @r{Never prompt for optional arguments} |
| 4606 | t @r{Always prompt} | 4613 | t @r{Always prompt} |
| 4607 | maybe @r{Prompt only if @code{reftex-citation} was called with C-u prefix arg}@end example | 4614 | maybe @r{Prompt only if @code{reftex-citation} was called with C-u prefix arg} |
| 4615 | @end example | ||
| 4608 | Unnecessary empty optional arguments are removed before insertion into | 4616 | Unnecessary empty optional arguments are removed before insertion into |
| 4609 | the buffer. See @code{reftex-cite-cleanup-optional-args}. | 4617 | the 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 | |||
| 4727 | the variable @code{reftex-index-macros-builtin} to specify the main | 4735 | the variable @code{reftex-index-macros-builtin} to specify the main |
| 4728 | indexing package you are using. Valid values are currently | 4736 | indexing package you are using. Valid values are currently |
| 4729 | @example | 4737 | @example |
| 4730 | default @r{The @LaTeX{} default - unnecessary to specify this one} | 4738 | default @r{The @LaTeX{} default; unnecessary to specify this one} |
| 4731 | multind @r{The multind.sty package} | 4739 | multind @r{The multind.sty package} |
| 4732 | index @r{The index.sty package} | 4740 | index @r{The index.sty package} |
| 4733 | index-shortcut @r{The index.sty packages with the ^ and _ shortcuts.} | 4741 | index-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 |
| 4736 | Note that @AUCTeX{} sets these things internally for @RefTeX{} as well, | 4744 | Note that @AUCTeX{} sets these things internally for @RefTeX{} as well, |
| 4737 | so with a sufficiently new version of @AUCTeX{}, you should not set the | 4745 | so with a sufficiently new version of @AUCTeX{}, you should not set the |
| @@ -4742,7 +4750,7 @@ package here. | |||
| 4742 | The default index macro for @code{reftex-index-selection-or-word}. | 4750 | The default index macro for @code{reftex-index-selection-or-word}. |
| 4743 | This is a list with @code{(@var{macro-key} @var{default-tag})}. | 4751 | This 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 |
| 4832 | Non-@code{nil} means, when indexing from the phrases buffer, wrap lines. | 4840 | Non-@code{nil} means, when indexing from the phrases buffer, wrap lines. |
| 4833 | Inserting indexing commands in a line makes the line longer - often | 4841 | Inserting indexing commands in a line makes the line longer, often |
| 4834 | so long that it does not fit onto the screen. When this variable is | 4842 | so long that it does not fit onto the screen. When this variable is |
| 4835 | non-@code{nil}, newlines will be added as necessary before and/or after the | 4843 | non-@code{nil}, newlines will be added as necessary before and/or after the |
| 4836 | indexing command to keep lines short. However, the matched text | 4844 | indexing 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 | |||
| 4947 | scans. In order to clear it, use @kbd{M-x reftex-reset-mode}. | 4955 | scans. 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 | |||
| 5008 | recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./}, | 5016 | recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./}, |
| 5009 | then @samp{/tex/}, and then all subdirectories of @samp{./}. If this | 5017 | then @samp{/tex/}, and then all subdirectories of @samp{./}. If this |
| 5010 | option is @code{nil}, the subdirectories of @samp{./} are searched | 5018 | option is @code{nil}, the subdirectories of @samp{./} are searched |
| 5011 | before @samp{/tex/}. This is mainly for speed - most of the time the | 5019 | before @samp{/tex/}. This is mainly for speed; most of the time the |
| 5012 | recursive path is for the system files and not for the user files. Set | 5020 | recursive path is for the system files and not for the user files. Set |
| 5013 | this to @code{nil} if the default makes @RefTeX{} finding files with | 5021 | this to @code{nil} if the default makes @RefTeX{} finding files with |
| 5014 | equal names in wrong sequence. | 5022 | equal 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 |
| 5130 | Non-@code{nil} means use a separate selection buffer for each label | 5138 | Non-@code{nil} means use a separate selection buffer for each label |
| 5131 | type. These buffers are kept from one selection to the next and need | 5139 | type. These buffers are kept from one selection to the next and need |
| 5132 | not to be created for each use - so the menu generally comes up faster. | 5140 | not be created for each use, so the menu generally comes up faster. |
| 5133 | The selection buffers will be erased (and therefore updated) | 5141 | The selection buffers will be erased (and therefore updated) |
| 5134 | automatically when new labels in its category are added. See the | 5142 | automatically when new labels in its category are added. See the |
| 5135 | variable @code{reftex-auto-update-selection-buffers}. | 5143 | variable @code{reftex-auto-update-selection-buffers}. |
| @@ -5146,7 +5154,7 @@ effect when @code{reftex-use-multiple-selection-buffers} is | |||
| 5146 | non-@code{nil}. | 5154 | non-@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). | |||
| 5244 | Face name for index entries. | 5252 | Face 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 | |||
| 5289 | argument. | 5297 | argument. |
| 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 | |||
| 5313 | are many more hooks which are described in the relevant sections about | 5321 | are many more hooks which are described in the relevant sections about |
| 5314 | options for a specific part of @RefTeX{}. | 5322 | options 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. | |||
| 6078 | released on 7 Jan 1997. | 6086 | released 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 |
| 9 | This manual is for Remember Mode, version 1.9 | 9 | This manual is for Remember Mode, version 1.9 |
| 10 | 10 | ||
| 11 | Copyright @copyright{} 2001, 2004-2005, 2007-2012 | 11 | Copyright @copyright{} 2001, 2004--2005, 2007--2013 |
| 12 | Free Software Foundation, Inc. | 12 | Free 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 | |||
| 20 | is included in the section entitled ``GNU Free Documentation License''. | 20 | is 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 |
| 23 | modify this GNU manual. Buying copies from the FSF supports it in | 23 | modify this GNU manual.'' |
| 24 | developing 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 | ||
| 84 | This document describes remember-el, which was written by John Wiegley, | 81 | This document describes remember-el, which was written by John Wiegley, |
| @@ -88,8 +85,7 @@ developers. | |||
| 88 | This document is a work in progress, and your contribution will be | 85 | This document is a work in progress, and your contribution will be |
| 89 | greatly appreciated. | 86 | greatly 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 | ||
| 95 | Todo lists, schedules, phone databases... everything we use databases | 91 | Todo 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 | |||
| 131 | manual-ness which computers from the very beginning have been championed | 127 | manual-ness which computers from the very beginning have been championed |
| 132 | as being able to reduce. | 128 | as 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 | ||
| 138 | Installing Remember Mode is as simple as adding the following lines to | 133 | Installing 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 | ||
| 151 | Hyperbole, as a data presentation tool, always struck me as being very | 145 | Hyperbole, as a data presentation tool, always struck me as being very |
| @@ -186,8 +180,7 @@ rather than requiring a billion keystrokes to reorganize your | |||
| 186 | hierarchy. Well, as the future arrives, hopefully experience and user | 180 | hierarchy. Well, as the future arrives, hopefully experience and user |
| 187 | feedback will help to make this as intuitive a tool as possible. | 181 | feedback 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 | |||
| 292 | the data for latter retrieval, and possible indexing. | 284 | the 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 | ||
| 318 | You can save remembered notes to a variety of backends. | 308 | You 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. | |||
| 345 | The text used to begin each remember item. | 334 | The 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. | |||
| 363 | If this is nil, then @code{diary-file} will be used instead." | 351 | If 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. | |||
| 384 | The default priority for remembered mail messages. | 371 | The 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}. | |||
| 399 | For instructions on how to integrate Remember with Org Mode, | 385 | For instructions on how to integrate Remember with Org Mode, |
| 400 | consult @ref{Capture, , , org}. | 386 | consult @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 |
| 11 | This file describes the Emacs SASL library, version @value{VERSION}. | 11 | This file describes the Emacs SASL library, version @value{VERSION}. |
| 12 | 12 | ||
| 13 | Copyright @copyright{} 2000, 2004-2012 | 13 | Copyright @copyright{} 2000, 2004--2013 Free Software Foundation, Inc. |
| 14 | Free Software Foundation, Inc. | ||
| 15 | 14 | ||
| 16 | @quotation | 15 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 | |||
| 19 | any later version published by the Free Software Foundation; with no | 18 | any later version published by the Free Software Foundation; with no |
| 20 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 19 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 21 | and with the Back-Cover Texts as in (a) below. A copy of the license | 20 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 22 | is included in the section entitled ``GNU Free Documentation License'' | 21 | is included in the section entitled ``GNU Free Documentation License''. |
| 23 | in 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 |
| 26 | modify this GNU manual. Buying copies from the FSF supports it in | 24 | modify this GNU manual.'' |
| 27 | developing GNU and promoting software freedom.'' | ||
| 28 | |||
| 29 | This document is part of a collection distributed under the GNU Free | ||
| 30 | Documentation License. If you want to distribute this document | ||
| 31 | separately from the collection, you can do so by adding a copy of the | ||
| 32 | license 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 | |||
| 62 | applications using different protocols. | 54 | applications 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 | |||
| 113 | step. | 106 | step. |
| 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 @@ | |||
| 14 | This document describes Supercite, an Emacs package for citing and | 14 | This document describes Supercite, an Emacs package for citing and |
| 15 | attributing replies to mail and news messages. | 15 | attributing replies to mail and news messages. |
| 16 | 16 | ||
| 17 | Copyright @copyright{} 1993, 2001-2012 Free Software Foundation, Inc. | 17 | Copyright @copyright{} 1993, 2001--2013 Free Software Foundation, Inc. |
| 18 | 18 | ||
| 19 | @quotation | 19 | @quotation |
| 20 | Permission is granted to copy, distribute and/or modify this document | 20 | Permission 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 | |||
| 25 | is included in the section entitled ``GNU Free Documentation License''. | 25 | is 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 |
| 28 | modify this GNU manual. Buying copies from the FSF supports it in | 28 | modify this GNU manual.'' |
| 29 | developing 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 |
| 1483 | For each of the actions -- citing, unciting, and reciting -- an alist is | 1482 | For each of the actions---citing, unciting, and reciting---an alist is |
| 1484 | consulted to find the frame to use (@code{sc-cite-frame-alist}, | 1483 | consulted 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} |
| 1486 | respectively). These frames can contain alists of the form: | 1485 | respectively). 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 | ||
| 12 | You can begin using @semantic{} by enabling Semantic mode, a global | 6 | You can begin using @semantic{} by enabling Semantic mode, a global |
| 13 | minor mode: type @kbd{M-x semantic-mode}, or open the @samp{Tools} | 7 | minor 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 |
| 25 | This manual documents the Semantic library and utilities. | 25 | This manual documents the Semantic library and utilities. |
| 26 | 26 | ||
| 27 | Copyright @copyright{} 1999-2005, 2007, 2009-2012 Free Software Foundation, Inc. | 27 | Copyright @copyright{} 1999--2005, 2007, 2009--2013 Free Software |
| 28 | Foundation, Inc. | ||
| 28 | 29 | ||
| 29 | @quotation | 30 | @quotation |
| 30 | Permission is granted to copy, distribute and/or modify this document | 31 | Permission 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 | |||
| 35 | is included in the section entitled ``GNU Free Documentation License.'' | 36 | is 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 |
| 38 | modify this GNU manual. Buying copies from the FSF supports it in | 39 | modify this GNU manual.'' |
| 39 | developing 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 |
| 12 | This file documents @acronym{SES}: the Simple Emacs Spreadsheet. | 12 | This file documents @acronym{SES}: the Simple Emacs Spreadsheet. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 2002-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 2002--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License.'' | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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}). | |||
| 211 | Recalculate the entire spreadsheet (@code{ses-recalculate-all}). | 210 | Recalculate 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 | |||
| 424 | yank. This doesn't make any difference? | 423 | yank. 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 | |||
| 636 | corresponding matrix is flattened. | 635 | corresponding 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 | |||
| 665 | range. | 664 | range. |
| 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 | |||
| 690 | as a single argument, since you'll probably use it with @code{ses-range}. | 689 | as 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. | |||
| 738 | argument type''. | 737 | argument 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}). | |||
| 752 | Export a range of cells as tab-separated formulas (@code{ses-export-tsf}). | 751 | Export a range of cells as tab-separated formulas (@code{ses-export-tsf}). |
| 753 | @end table | 752 | @end table |
| 754 | 753 | ||
| 755 | The exported text goes to the kill ring --- you can paste it into | 754 | The exported text goes to the kill ring; you can paste it into |
| 756 | another buffer. Columns are separated by tabs, rows by newlines. | 755 | another buffer. Columns are separated by tabs, rows by newlines. |
| 757 | 756 | ||
| 758 | To import text, use any of the yank commands where the text to paste | 757 | To import text, use any of the yank commands where the text to paste |
| 759 | contains tabs and/or newlines. Imported formulas are not relocated. | 758 | contains 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 | |||
| 785 | your style as a formula-writer. See the documentation in @file{unsafep.el} | 784 | your style as a formula-writer. See the documentation in @file{unsafep.el} |
| 786 | for more info on how Lisp forms are classified as safe or unsafe. | 785 | for 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 | |||
| 865 | can type ahead without worrying about the glitch. | 864 | can 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 | |||
| 893 | kind of dependency is also not recorded. | 892 | kind 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. | |||
| 948 | You can define functions by making them values for the fake local | 947 | You can define functions by making them values for the fake local |
| 949 | variable @code{eval}. Such functions can then be used in your | 948 | variable @code{eval}. Such functions can then be used in your |
| 950 | formulas and printers, but usually each @code{eval} is presented to | 949 | formulas and printers, but usually each @code{eval} is presented to |
| 951 | the user during file loading as a potential virus --- this can get | 950 | the user during file loading as a potential virus. This can get |
| 952 | annoying. | 951 | annoying. |
| 953 | 952 | ||
| 954 | You can define functions in your @file{.emacs} file. Other people can | 953 | You 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 | ||
| 999 | Coding by: | 998 | Coding 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 |
| 12 | This file documents the Emacs Sieve package, for server-side mail filtering. | 12 | This file documents the Emacs Sieve package, for server-side mail filtering. |
| 13 | 13 | ||
| 14 | Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. | 14 | Copyright @copyright{} 2001--2013 Free Software Foundation, Inc. |
| 15 | 15 | ||
| 16 | @quotation | 16 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 17 | Permission 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 | |||
| 22 | is included in the section entitled ``GNU Free Documentation License''. | 22 | is 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 |
| 25 | modify this GNU manual. Buying copies from the FSF supports it in | 25 | modify this GNU manual.'' |
| 26 | developing 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 |
| 216 | Displays help in the minibuffer. | 215 | Displays 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 |
| 6 | Copyright @copyright{} 2003-2012 | 6 | Copyright @copyright{} 2003--2013 Free Software Foundation, Inc. |
| 7 | Free Software Foundation, Inc. | ||
| 8 | 7 | ||
| 9 | @quotation | 8 | @quotation |
| 10 | Permission is granted to copy, distribute and/or modify this document | 9 | Permission 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 | |||
| 15 | is included in the section entitled ``GNU Free Documentation License''. | 14 | is 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 |
| 18 | modify this GNU manual. Buying copies from the FSF supports it in | 17 | modify this GNU manual.'' |
| 19 | developing 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 | |||
| 72 | is involved. | 70 | is 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 |
| 76 | usually sends outgoing mail to a mail host. When your computer is | 74 | sends outgoing mail to a mail host. When your computer is |
| 77 | permanently connected to the internet, it might even be a mail host | 75 | permanently connected to the internet, it might even be a mail host |
| 78 | itself. In this case, the MUA will pipe mail to the | 76 | itself. 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 | |||
| 285 | connection the SMTP library uses. The default value is @code{nil}, | 283 | connection the SMTP library uses. The default value is @code{nil}, |
| 286 | which means to use a plain connection, but try to switch to a STARTTLS | 284 | which means to use a plain connection, but try to switch to a STARTTLS |
| 287 | encrypted connection if the server supports it. Other possible values | 285 | encrypted connection if the server supports it. Other possible values |
| 288 | are: @code{starttls} - insist on STARTTLS; @code{ssl} - use TLS/SSL; | 286 | are: @code{starttls} to insist on STARTTLS; @code{ssl} to use TLS/SSL; |
| 289 | and @code{plain} - no encryption. | 287 | and @code{plain} for encryption. |
| 290 | 288 | ||
| 291 | Use of any form of TLS/SSL requires support in Emacs. You can either | 289 | Use of any form of TLS/SSL requires support in Emacs. You can either |
| 292 | use the built-in support (in Emacs 24.1 and later), or the | 290 | use 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 |
| 7 | Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. | 7 | Copyright @copyright{} 1999--2013 Free Software Foundation, Inc. |
| 8 | 8 | ||
| 9 | @quotation | 9 | @quotation |
| 10 | Permission is granted to copy, distribute and/or modify this document | 10 | Permission 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 | |||
| 15 | is included in the section entitled ``GNU Free Documentation License''. | 15 | is 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 |
| 18 | modify this GNU manual. Buying copies from the FSF supports it in | 18 | modify this GNU manual.'' |
| 19 | developing 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 | ||
| 45 | Speedbar is a program for Emacs which can be used to summarize | 43 | Speedbar 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 | |||
| 69 | on. @xref{Basic Navigation}. | 67 | on. @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 |
| 117 | it's useful to bind it to a key in terminal mode. @xref{Customizing}. | 114 | it'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 | ||
| 123 | Speedbar can display different types of data, and has several display | 119 | Speedbar 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}. | |||
| 206 | Contract the current group, hiding sub items. | 201 | Contract 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 | |||
| 308 | do not use files will attempt to use the same colors on analogous | 302 | do not use files will attempt to use the same colors on analogous |
| 309 | entries. | 303 | entries. |
| 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 | |||
| 353 | this can contain extra information such as file permissions, or tag | 346 | this can contain extra information such as file permissions, or tag |
| 354 | location. | 347 | location. |
| 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 | |||
| 370 | would include Files, Quick Buffers, and Buffers. Other major display | 362 | would include Files, Quick Buffers, and Buffers. Other major display |
| 371 | modes such as Info are loaded separately. | 363 | modes 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}, | |||
| 472 | indicating that all symbols which alphabetically fall between those | 462 | indicating that all symbols which alphabetically fall between those |
| 473 | categories are included in that sub-group. @xref{Tag Hierarchy Methods}. | 463 | categories 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 | |||
| 499 | determine their presence by the @samp{#} and @samp{!} file indicators. | 488 | determine 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 | |||
| 538 | also displayed, but they are prefixed with the @samp{[?]} symbol. This | 526 | also displayed, but they are prefixed with the @samp{[?]} symbol. This |
| 539 | means that it is a file, but Emacs doesn't know how to expand it. | 527 | means 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, | |||
| 570 | press @kbd{b}, click on the buffer you want, and speedbar will revert | 557 | press @kbd{b}, click on the buffer you want, and speedbar will revert |
| 571 | back to File mode. | 558 | back 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 | |||
| 615 | In this way you can manage your existing RMAIL folders fairly easily | 600 | In this way you can manage your existing RMAIL folders fairly easily |
| 616 | using the mouse. | 601 | using 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 | |||
| 630 | the @samp{[+]} button, sometimes a @samp{[?]} will appear when you click on | 614 | the @samp{[+]} button, sometimes a @samp{[?]} will appear when you click on |
| 631 | a @samp{[+]}, indicating that there are no sub-topics. | 615 | a @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 | |||
| 653 | level. You can then check variables local to that level at the GDB | 636 | level. You can then check variables local to that level at the GDB |
| 654 | prompt. | 637 | prompt. |
| 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. | |||
| 726 | In XEmacs, change the plist @code{speedbar-frame-plist}. This is the | 707 | In XEmacs, change the plist @code{speedbar-frame-plist}. This is the |
| 727 | XEmacs way of doing the same thing. | 708 | XEmacs 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 | |||
| 806 | items is reached. | 786 | items 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. | |||
| 841 | Lastly, you can change the VC indicator using the variable | 820 | Lastly, 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 | |||
| 884 | state data. | 862 | state 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 | |||
| 967 | display. If it needs to be cleared, you need to erase the speedbar | 944 | display. If it needs to be cleared, you need to erase the speedbar |
| 968 | buffer yourself, and start drawing buttons. @xref{Creating a display}. | 945 | buffer 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: | |||
| 1098 | Once you have done all this, speedbar will show an entry in the | 1075 | Once 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 | ||
| 1104 | It is possible to create new methods for tagging files in speedbar. | 1081 | It 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 | |||
| 1138 | is either a buffer local modification, or that the tag generator returns | 1115 | is 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 |
| 18 | Copyright @copyright{} 2007-2012 Free Software Foundation, Inc. | 18 | Copyright @copyright{} 2007--2013 Free Software Foundation, Inc. |
| 19 | 19 | ||
| 20 | @quotation | 20 | @quotation |
| 21 | Permission is granted to copy, distribute and/or modify this document | 21 | Permission 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 | |||
| 26 | is included in the section entitled ``GNU Free Documentation License''. | 26 | is 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 |
| 29 | modify this GNU manual. Buying copies from the FSF supports it in | 29 | modify this GNU manual.'' |
| 30 | developing 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 | |||
| 464 | This will enable that section. | 463 | This will enable that section. |
| 465 | 464 | ||
| 466 | 465 | ||
| 467 | NOTE: May 11, 2008 - I haven't used this yet, so I don't know if it works. | 466 | NOTE: 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 | |||
| 576 | section variables are. | 575 | section 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 | ||
| 1657 | Inside a body of code, such as a function or method body. | 1656 | Inside 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 |
| 40 | Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. | 40 | Copyright @copyright{} 1999--2013 Free Software Foundation, Inc. |
| 41 | 41 | ||
| 42 | @quotation | 42 | @quotation |
| 43 | Permission is granted to copy, distribute and/or modify this document | 43 | Permission 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 | |||
| 48 | is included in the section entitled ``GNU Free Documentation License''. | 48 | is 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 |
| 51 | copy and modify this GNU manual. Buying copies from the FSF | 51 | copy and modify this GNU manual.'' |
| 52 | supports 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) |
| 376 | includes @value{tramp} already, and there is a @value{tramp} package | 375 | includes @value{tramp} already, and there is a @value{tramp} package |
| 377 | for XEmacs, as well. So maybe it is easier to just use those. But if | 376 | for XEmacs, as well. So maybe it is easier to just use those. But if |
| 378 | you want the bleeding edge, read on@dots{...} | 377 | you want the bleeding edge, read on@dots{} |
| 379 | 378 | ||
| 380 | For the especially brave, @value{tramp} is available from Git. The Git | 379 | For the especially brave, @value{tramp} is available from Git. The Git |
| 381 | version is the latest version of the code and may contain incomplete | 380 | version 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 | |||
| 763 | fair trade-off between both approaches. | 762 | fair 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 | |||
| 808 | specify @samp{-P 42} in the argument list for @command{scp}. | 807 | specify @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. | |||
| 824 | This method supports the @samp{-p} argument. | 823 | This 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. | |||
| 845 | This method supports the @samp{-p} argument. | 844 | This 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. | |||
| 868 | This method supports the @samp{-p} argument. | 867 | This 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}. | |||
| 899 | This method supports the @samp{-p} argument. | 898 | This 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. | |||
| 913 | This method supports the @samp{-p} argument. | 912 | This 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. | |||
| 928 | This method supports the @samp{-P} argument. | 927 | This 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. | |||
| 943 | This method supports the @samp{-P} argument. | 942 | This 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. | |||
| 1866 | This regular expression is used by @value{tramp} in the same way as | 1865 | This 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. |
| 1868 | This second variable exists because the prompt from the remote shell | 1867 | This second variable exists because the prompt from the remote shell |
| 1869 | might be different from the prompt from a local shell --- after all, | 1868 | might be different from the prompt from a local shell---after all, |
| 1870 | the whole point of @value{tramp} is to log in to remote hosts as a | 1869 | the whole point of @value{tramp} is to log in to remote hosts as a |
| 1871 | different user. The default value of | 1870 | different 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 | ||
| 1906 | In parallel, it might also be necessary to adapt | 1905 | In parallel, it might also be necessary to adapt |
| @@ -2292,7 +2291,7 @@ This edits the same file, using the fully qualified domain name of | |||
| 2292 | the machine. | 2291 | the machine. |
| 2293 | 2292 | ||
| 2294 | @item @trampfn{, , melancholia, ~/.emacs} | 2293 | @item @trampfn{, , melancholia, ~/.emacs} |
| 2295 | This also edits the same file --- the @file{~} is expanded to your | 2294 | This also edits the same file; the @file{~} is expanded to your |
| 2296 | home directory on the remote machine, just like it is locally. | 2295 | home 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 |
| 21 | This is the manual for the @code{url} Emacs Lisp library. | 21 | This is the manual for the @code{url} Emacs Lisp library. |
| 22 | 22 | ||
| 23 | Copyright @copyright{} 1993-1999, 2002, 2004-2012 Free Software Foundation, Inc. | 23 | Copyright @copyright{} 1993--1999, 2002, 2004--2013 Free Software |
| 24 | Foundation, Inc. | ||
| 24 | 25 | ||
| 25 | @quotation | 26 | @quotation |
| 26 | Permission is granted to copy, distribute and/or modify this document | 27 | Permission 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 | |||
| 31 | is included in the section entitled ``GNU Free Documentation License''. | 32 | is 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 |
| 34 | modify this GNU manual. Buying copies from the FSF supports it in | 35 | modify this GNU manual.'' |
| 35 | developing 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 |
| 6 | Copyright @copyright{} 1987, 2001-2012 Free Software Foundation, Inc. | 6 | Copyright @copyright{} 1987, 2001--2013 Free Software Foundation, Inc. |
| 7 | 7 | ||
| 8 | @quotation | 8 | @quotation |
| 9 | Permission is granted to copy, distribute and/or modify this document | 9 | Permission 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 | |||
| 14 | is included in the section entitled ``GNU Free Documentation License''. | 14 | is 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 |
| 17 | modify this GNU manual. Buying copies from the FSF supports it in | 17 | modify this GNU manual.'' |
| 18 | developing 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 | ||
| 47 | VIP is a Vi emulating package written in Emacs Lisp. VIP implements most | 46 | VIP 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 | ||
| 97 | In this chapter we describe basics of VIP with emphasis on the features not | 96 | In 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 | ||
| 111 | We begin by explaining some basic concepts of Emacs. These concepts are | 110 | We 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 | |||
| 152 | local map, however, the function bound to the key in the global map becomes | 151 | local map, however, the function bound to the key in the global map becomes |
| 153 | in effect.@refill | 152 | in 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 | ||
| 158 | The recommended way to load VIP automatically is to include the line: | 157 | The 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 | |||
| 268 | bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode | 267 | bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode |
| 269 | then you will be in vi mode.@refill | 268 | then 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 | ||
| 274 | This mode corresponds to Vi's command mode. Most Vi commands work as they | 273 | This mode corresponds to Vi's command mode. Most Vi commands work as they |
| 275 | do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can | 274 | do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can |
| 276 | enter insert mode, just as in Vi, by typing @kbd{i}, @kbd{a} etc. | 275 | enter 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 | ||
| 281 | The key bindings in this mode is the same as in the emacs mode except for | 280 | The 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 | ||
| 305 | The major differences from Vi are explained below. | 304 | The 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 | |||
| 335 | changes. Undo is undoable as in Vi. So the content of the buffer will | 334 | changes. Undo is undoable as in Vi. So the content of the buffer will |
| 336 | be the same before and after @kbd{u u}.@refill | 335 | be 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 | ||
| 341 | Some commands which change a small number of characters are executed | 340 | Some 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}) |
| 349 | you can abort a partially formed command by typing @kbd{C-g}.@refill | 348 | you 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 | |||
| 364 | the buffer as in Vi. You can change this by rebinding the variable | 363 | the 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 |
| 380 | Last) line of the window.@refill | 379 | Last) 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 | ||
| 385 | Some Vi commands which do not accept a count now accept one | 384 | Some Vi commands which do not accept a count now accept one |
| @@ -405,7 +404,7 @@ line. | |||
| 405 | Given a count @var{n}, @var{n}-th occurrence will be searched. | 404 | Given 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 | ||
| 411 | Typing an @kbd{m} followed by a lower-case character @var{ch} marks the | 410 | Typing 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). | |||
| 425 | Jump to mark (and pop mark off the mark ring). | 424 | Jump 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 | |||
| 439 | smallest region containing the original region and consisting of whole | 438 | smallest region containing the original region and consisting of whole |
| 440 | lines. Thus @kbd{m .@: d R} will have the same effect as @kbd{d d}.@refill | 439 | lines. 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 | ||
| 445 | Note that the keys below (except for @kbd{R}) are not used in Vi. | 444 | Note 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}). | |||
| 531 | Call last keyboard macro. | 530 | Call 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 | ||
| 537 | In VIP the meanings of some keys are entirely different from Vi. These key | 536 | In 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: | |||
| 591 | This is equivalent to @kbd{C-x 1 C-x 2} (1 + 2 = 3). | 590 | This 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 | ||
| 597 | In this and following subsections, we give a summary of key bindings for | 596 | In this and following subsections, we give a summary of key bindings for |
| @@ -615,7 +614,7 @@ Split current window into two windows. | |||
| 615 | Show current buffer in two windows. | 614 | Show 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. | |||
| 636 | Save the current buffer in the file associated to the buffer. | 635 | Save 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. | |||
| 657 | Insert specified file at point. | 656 | Insert 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. | |||
| 678 | Suspend Emacs. | 677 | Suspend Emacs. |
| 679 | @item Z Z | 678 | @item Z Z |
| 680 | Exit Emacs. | 679 | Exit Emacs. |
| 681 | @itemx Q | 680 | @item Q |
| 682 | Query replace. | 681 | Query replace. |
| 683 | @itemx R | 682 | @item R |
| 684 | Replace. | 683 | Replace. |
| 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 | ||
| 690 | This chapter describes Vi commands other than Ex commands implemented in | 689 | This 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. | |||
| 726 | For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a | 725 | For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a |
| 727 | line. In this manual the metavariable @var{n} will denote a count.@refill | 726 | line. 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 | ||
| 732 | The keys @kbd{C-g} and @kbd{C-l} are unique in that their associated | 731 | The 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, | |||
| 843 | and you can select it by giving a simple @key{RET}. See GNU Emacs Manual | 842 | and you can select it by giving a simple @key{RET}. See GNU Emacs Manual |
| 844 | for details of completion. | 843 | for 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 | ||
| 849 | We have the following commands related to files. They are used to visit, | 848 | We 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, | |||
| 924 | you can type @kbd{X W}. You will then get a similar prompt as you get for | 923 | you 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 | ||
| 930 | In this and next section we discuss commands for moving around in the | 929 | In 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}) |
| 946 | Scroll text of current window downward almost full screen. You can go | 945 | Scroll 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}) |
| 950 | Scroll text of current window upward half screen. You can go | 949 | Scroll 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}) |
| 954 | Scroll text of current window downward half screen. You can go | 953 | Scroll 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 | |||
| 992 | Center point in window and redisplay screen (@code{recenter}). | 991 | Center 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 | ||
| 998 | The following commands are used to mark positions in the buffer. | 997 | The 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 | |||
| 1020 | the command `@kbd{m ,}' you can visit older and older marked positions. You | 1019 | the command `@kbd{m ,}' you can visit older and older marked positions. You |
| 1021 | will eventually be in a loop as the mark ring is a ring. | 1020 | will 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 | ||
| 1026 | Commands for moving around in the current buffer are collected here. These | 1025 | Commands 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 | |||
| 1214 | opposite direction (@code{vip-repeat-find-opposite}). | 1213 | opposite 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 | ||
| 1220 | Following commands are available for searching and replacing. | 1219 | Following commands are available for searching and replacing. |
| @@ -1278,7 +1277,7 @@ count, replace that many characters by @var{ch} (@code{vip-replace-char}). | |||
| 1278 | The commands @kbd{/} and @kbd{?} mark point before move, so that you can | 1277 | The commands @kbd{/} and @kbd{?} mark point before move, so that you can |
| 1279 | return to the original point by @w{@kbd{` `}}. | 1278 | return 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 | ||
| 1284 | In this section, commands for modifying the content of a buffer are | 1283 | In 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. | |||
| 1404 | Expand current region and yank it. | 1403 | Expand 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 |
| 1409 | Deleted or yanked texts can be put back into the buffer by the command | 1408 | Deleted or yanked texts can be put back into the buffer by the command |
| 1410 | below. | 1409 | below. |
| @@ -1435,7 +1434,7 @@ numeral between @kbd{1} and @kbd{9}. If the number register @var{n} is | |||
| 1435 | specified, @var{n}-th previously deleted/yanked text will be put back. It | 1434 | specified, @var{n}-th previously deleted/yanked text will be put back. It |
| 1436 | is an error to specify a number register for the delete/yank commands. | 1435 | is 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 | ||
| 1441 | Most commonly used change command takes the following form. | 1440 | Most commonly used change command takes the following form. |
| @@ -1468,7 +1467,7 @@ Change current region. | |||
| 1468 | Expand current region and change it. | 1467 | Expand 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 | ||
| 1474 | VIP records the previous modifying command, so that it is easy to repeat | 1473 | VIP 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 | |||
| 1488 | modifying command is used again (@code{vip-repeat}). | 1487 | modifying 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 | ||
| 1494 | Miscellaneous Vi commands are collected here. | 1493 | Miscellaneous 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 | ||
| 1615 | You can enter insert mode by one of the following commands. In addition to | 1614 | You 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 | |||
| 1677 | command will not really repeat insertion if you move point by emacs | 1676 | command will not really repeat insertion if you move point by emacs |
| 1678 | commands while in insert mode. | 1677 | commands 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 |
| 1719 | In this section we briefly explain all the Ex commands supported by VIP@. | 1718 | In this section we briefly explain all the Ex commands supported by VIP@. |
| 1720 | Most Ex commands expect @var{address} as their argument, and they use | 1719 | Most 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 | ||
| 1866 | If you have a file called @file{.vip} in your home directory, then it | 1865 | If 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 |
| 1877 | An easy way to customize VIP is to change the values of constants used | 1876 | An easy way to customize VIP is to change the values of constants used |
| 1878 | in VIP@. Here is the list of the constants used in VIP and their default | 1877 | in 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 |
| 10 | Copyright @copyright{} 1995-1997, 2001-2012 Free Software Foundation, Inc. | 10 | Copyright @copyright{} 1995--1997, 2001--2013 Free Software Foundation, Inc. |
| 11 | 11 | ||
| 12 | @quotation | 12 | @quotation |
| 13 | Permission is granted to copy, distribute and/or modify this document | 13 | Permission 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 | |||
| 18 | is included in the section entitled ``GNU Free Documentation License''. | 18 | is 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 |
| 21 | modify this GNU manual. Buying copies from the FSF supports it in | 21 | modify this GNU manual.'' |
| 22 | developing 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 | ||
| 54 | We believe that one or more of the following statements are adequate | 52 | We believe that one or more of the following statements are adequate |
| 55 | descriptions of Viper: | 53 | descriptions of Viper: |
| @@ -76,7 +74,7 @@ Viper, formerly known as VIP-19, was written by Michael Kifer. It is based | |||
| 76 | on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane. | 74 | on VIP version 3.5 by Masahiko Sato and VIP version 4.4 by Aamod Sane. |
| 77 | About 15% of the code still comes from those older packages. | 75 | About 15% of the code still comes from those older packages. |
| 78 | 76 | ||
| 79 | Viper is intended to be usable without reading this manual --- the defaults | 77 | Viper is intended to be usable without reading this manual; the defaults |
| 80 | are set to make Viper as close to Vi as possible. At startup, Viper will | 78 | are set to make Viper as close to Vi as possible. At startup, Viper will |
| 81 | try to set the most appropriate default environment for you, based on | 79 | try to set the most appropriate default environment for you, based on |
| 82 | your familiarity with Emacs. It will also tell you the basic GNU Emacs window | 80 | your 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 | |||
| 134 | Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code | 129 | Masahiko Sato and VIP version 4.4 by Aamod Sane. About 15% of the code |
| 135 | still comes from those older packages. | 130 | still comes from those older packages. |
| 136 | 131 | ||
| 137 | Viper is intended to be usable out of the box, without reading this manual | 132 | Viper 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 | 133 | the defaults are set to make Viper as close to Vi as possible. At |
| 139 | startup, Viper will attempt to set the most appropriate default environment | 134 | startup, Viper will attempt to set the most appropriate default environment |
| 140 | for you, based on your familiarity with Emacs. It will also tell you the | 135 | for you, based on your familiarity with Emacs. It will also tell you the |
| 141 | basic GNU Emacs window management commands to help you start immediately. | 136 | basic 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 | ||
| 162 | Viper is a Vi emulation on top of Emacs. At the same time, Viper provides a | 157 | Viper 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 | |||
| 314 | cause Lisp functions to be called. It is possible to call these | 309 | cause Lisp functions to be called. It is possible to call these |
| 315 | functions directly, by typing @kbd{M-x function-name}. | 310 | functions 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 | ||
| 320 | The most common way to load it automatically is to include the following | 315 | The 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 | |||
| 369 | viper-go-away} will do it for you. The function @code{toggle-viper-mode} | 364 | viper-go-away} will do it for you. The function @code{toggle-viper-mode} |
| 370 | toggles Viperization of Emacs on and off. | 365 | toggles 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 | |||
| 447 | those special modes (typing @kbd{C-h m} in a buffer provides | 442 | those special modes (typing @kbd{C-h m} in a buffer provides |
| 448 | help with key bindings for the major mode of that buffer). | 443 | help with key bindings for the major mode of that buffer). |
| 449 | 444 | ||
| 450 | If you switch to Vi in Dired or similar modes---no harm is done. It is just | 445 | If you switch to Vi in Dired or similar modes, no harm is done. It is just |
| 451 | that the special key bindings provided by those modes will be temporarily | 446 | that the special key bindings provided by those modes will be temporarily |
| 452 | overshadowed by Viper's bindings. Switching back to Viper's Emacs state | 447 | overshadowed by Viper's bindings. Switching back to Viper's Emacs state |
| 453 | will revive the environment provided by the current major mode. | 448 | will 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 | |||
| 507 | single Vi command while staying in Viper's Insert state. | 502 | single 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 | ||
| 728 | When Viper is in Insert state, you will see <I> in the mode line. | 723 | When 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 | |||
| 759 | would delete text between this position and the end of the replacement | 754 | would delete text between this position and the end of the replacement |
| 760 | region. | 755 | region. |
| 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. | |||
| 809 | The appearance of the text in the minibuffer can be changed. | 804 | The 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 | |||
| 884 | command @kbd{:n} can be given counts from the @kbd{:ar} list to switch to | 879 | command @kbd{:n} can be given counts from the @kbd{:ar} list to switch to |
| 885 | other files. For example, use `:n3' to move to the third file in that list. | 880 | other 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 | ||
| 890 | Unimplemented features include: | 885 | Unimplemented features include: |
| @@ -905,8 +900,7 @@ be used directly inside Emacs, since Emacs will obdurately change @samp{^I} | |||
| 905 | back to normal tabs.@refill | 900 | back 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 | ||
| 912 | Some common problems with Vi and Ex have been solved in Viper. This | 906 | Some 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 | ||
| 933 | The Vi command set is based on the idea of combining motion commands | 927 | The 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 | |||
| 998 | specify @code{(setq ex-cycle-through-non-files t)} in your @file{.viper} | 992 | specify @code{(setq ex-cycle-through-non-files t)} in your @file{.viper} |
| 999 | file. @xref{Customization}, for details. | 993 | file. @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} | |||
| 1034 | can be any letters from a through z. | 1028 | can 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 | |||
| 1073 | have a buffer history, and commands that expect strings or regular | 1067 | have a buffer history, and commands that expect strings or regular |
| 1074 | expressions keep a history on those items. | 1068 | expressions 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). | |||
| 1120 | Viper also provides Vi-style macros. @xref{Vi Macros}, for details. | 1114 | Viper 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 | |||
| 1131 | of the form @kbd{/foo//bar} as @kbd{/bar} and @kbd{/foo/~/bar} as | 1125 | of 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 | ||
| 1200 | Try it: it is really simple! | 1194 | Try 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. |
| 1224 | Facilities like this make Vi's @kbd{:ab} command obsolete. | 1218 | Facilities 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 | |||
| 1299 | Textmarkers, this is very useful. Contents of textmarkers can be viewed | 1293 | Textmarkers, this is very useful. Contents of textmarkers can be viewed |
| 1300 | by @kbd{[marker}. (Contents of registers can be viewed by @kbd{]register}). | 1294 | by @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 | ||
| 1305 | These commands have no Vi analogs. | 1299 | These commands have no Vi analogs. |
| @@ -1488,7 +1482,7 @@ Apart from the new commands, many old commands have been enhanced. Most | |||
| 1488 | notably, Vi style macros are much more powerful in Viper than in Vi. @xref{Vi | 1482 | notably, Vi style macros are much more powerful in Viper than in Vi. @xref{Vi |
| 1489 | Macros}, for details. | 1483 | Macros}, 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 | ||
| 1494 | Some Emacs packages are mentioned here as an aid to the new Viper user, to | 1488 | Some Emacs packages are mentioned here as an aid to the new Viper user, to |
| @@ -1569,7 +1563,7 @@ Emacs Lisp archives exist on | |||
| 1569 | and @samp{wuarchive.wustl.edu}@refill | 1563 | and @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 |
| 1716 | If search lands within this many lines of the window top or bottom, the | 1710 | If search lands within this many lines of the window top or bottom, the |
| 1717 | window will be scrolled up or down by about 1/7-th of its size, to reveal | 1711 | window will be scrolled up or down by about 1/7-th of its size, to reveal |
| 1718 | the context. If the value is negative---don't scroll. | 1712 | the context. If the value is negative, don't scroll. |
| 1719 | @item viper-tags-file-name "TAGS" | 1713 | @item viper-tags-file-name "TAGS" |
| 1720 | The name of the file used as the tag table. | 1714 | The 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 | |||
| 1839 | specifying a new face. (Emacs faces are described in the Emacs Lisp | 1833 | specifying a new face. (Emacs faces are described in the Emacs Lisp |
| 1840 | reference.) On a color display, the following customization method is | 1834 | reference.) On a color display, the following customization method is |
| 1841 | usually most effective: | 1835 | usually 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 |
| 1846 | For a complete list of colors available to you, evaluate the expression | 1840 | For 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 |
| 1848 | hit the @kbd{C-j} key. | 1842 | hit 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 |
| 2046 | To customize the binding for @kbd{C-h} in Insert state: | 2040 | To 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 | ||
| 2100 | Yet another way to customize key bindings in a major mode is to edit the | 2096 | Yet 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 | ||
| 2327 | Viper extends Vi with a number of useful features. This includes various | 2323 | Viper 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 | |||
| 2706 | Emacs. The function @code{viper-surrounding-word} in @file{viper.el} can be | 2702 | Emacs. The function @code{viper-surrounding-word} in @file{viper.el} can be |
| 2707 | used as a guiding example. | 2703 | used 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). | |||
| 2786 | For details, @pxref{Keyboard Macro Query,,Customization,emacs,The GNU Emacs | 2782 | For details, @pxref{Keyboard Macro Query,,Customization,emacs,The GNU Emacs |
| 2787 | Manual} @refill | 2783 | Manual} @refill |
| 2788 | 2784 | ||
| 2789 | When the user finishes defining a macro (which is done by typing @kbd{C-x)} --- | 2785 | When the user finishes defining a macro (which is done by typing @kbd{C-x)}, |
| 2790 | a departure from Vi), you will be asked whether you want this | 2786 | a departure from Vi), you will be asked whether you want this |
| 2791 | macro to be global, mode-specific, or buffer-specific. You will also be | 2787 | macro to be global, mode-specific, or buffer-specific. You will also be |
| 2792 | given a chance to save the macro in your @file{~/.viper} file. | 2788 | given 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 | |||
| 2993 | currently defined. To see all macros along with their definitions, type | 2989 | currently 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 | ||
| 2999 | This section is a semi-automatically bowdlerized version of the Vi | 2995 | This 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 | ||
| 3019 | The VI command set is based on the idea of combining motion commands | 3014 | The 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 | |||
| 3223 | inserts them automatically in front of the Ex command. | 3218 | inserts 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> $ |
| 3266 | To the end of line <count> from the cursor. | 3261 | To the end of line <count> from the cursor. |
| 3267 | @item <count> ^ | 3262 | @item <count> ^ |
| 3268 | To the first CHAR <count> - 1 lines lower. | 3263 | To the first CHAR <count> @minus{} 1 lines lower. |
| 3269 | @item <count> - | 3264 | @item <count> - |
| 3270 | To the first CHAR <count> lines higher. | 3265 | To 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 | ||
| 3440 | Emacs mark is referred to in the region specifiers @kbd{r} and @kbd{R}. | 3435 | Emacs mark is referred to in the region specifiers @kbd{r} and @kbd{R}. |
| @@ -3470,7 +3465,7 @@ Exchange point and mark. | |||
| 3470 | Exchange point and mark and go to the first CHAR on line. | 3465 | Exchange point and mark and go to the first CHAR on line. |
| 3471 | @item '<a-z> | 3466 | @item '<a-z> |
| 3472 | Go to specified Viper mark. | 3467 | Go to specified Viper mark. |
| 3473 | @item | 3468 | @item `<a-z> |
| 3474 | Go to specified Viper mark and go to the first CHAR on line. | 3469 | Go 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 | ||
| 3574 | Minibuffer can be edited similarly to Insert state, and you can switch | 3569 | Minibuffer 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> |
| 3650 | Replace <count> chars by <char> - no <esc>. | 3645 | Replace <count> chars by <char>; no <esc>. |
| 3651 | @item <count> R | 3646 | @item <count> R |
| 3652 | Overwrite the rest of the line, | 3647 | Overwrite the rest of the line, |
| 3653 | appending change @var{count - 1} times. | 3648 | appending change @var{count} @minus{} 1 times. |
| 3654 | @item <count> s | 3649 | @item <count> s |
| 3655 | Substitute <count> chars. | 3650 | Substitute <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 |
| 3661 | Change <count> lines. | 3656 | Change <count> lines. |
| 3662 | @item <count> C | 3657 | @item <count> C |
| 3663 | The rest of the line and <count> - 1 next lines. | 3658 | The rest of the line and <count> @minus{} 1 next lines. |
| 3664 | @item <count> =<move> | 3659 | @item <count> =<move> |
| 3665 | Reindent the region described by move. | 3660 | Reindent 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 | |||
| 3913 | and relative position.@* | 3908 | and relative position.@* |
| 3914 | At user levels 2 and higher, abort the current command. | 3909 | At user levels 2 and higher, abort the current command. |
| 3915 | @item C-c g | 3910 | @item C-c g |
| 3916 | Give file name, status, current line number and relative position -- all | 3911 | Give file name, status, current line number and relative position---all |
| 3917 | user levels. | 3912 | user levels. |
| 3918 | @item C-l | 3913 | @item C-l |
| 3919 | Refresh the screen. | 3914 | Refresh 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 |
| 4025 | Preserve the file -- autosave buffers. | 4020 | Preserve the file---autosave buffers. |
| 4026 | @item :rec | 4021 | @item :rec |
| 4027 | Recover file from autosave. | 4022 | Recover 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 |
| 4257 | autoindent -- In append mode after a <cr> the | 4252 | autoindent: In append mode after a <cr> the |
| 4258 | cursor will move directly below the first | 4253 | cursor will move directly below the first |
| 4259 | character on the previous line. | 4254 | character on the previous line. |
| 4260 | This setting affects the current buffer only. | 4255 | This 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 |
| 4273 | ignorecase -- No distinction between upper and lower cases when searching. | 4268 | ignorecase: No distinction between upper and lower cases when searching. |
| 4274 | @item noignorecase | 4269 | @item noignorecase |
| 4275 | @itemx noic | 4270 | @itemx noic |
| 4276 | Cancel ignorecase. | 4271 | Cancel 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 |
| 4287 | readonly -- The file is not to be changed. | 4282 | readonly: The file is not to be changed. |
| 4288 | If the user attempts to write to this file, confirmation will be requested. | 4283 | If 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 |
| 4295 | shell -- The program to be used for shell escapes | 4290 | shell: 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 |
| 4301 | shiftwidth -- Gives the shiftwidth (default 8 positions). | 4296 | shiftwidth: 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 |
| 4306 | showmatch -- Whenever you append a @kbd{)}, Vi shows | 4301 | showmatch: Whenever you append a @kbd{)}, Vi shows |
| 4307 | its match if it's on the same page; also with | 4302 | its 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 |
| 4316 | tabstop -- The length of a <ht>; warning: this is | 4311 | tabstop: The length of a <ht>; warning: this is |
| 4317 | only IN the editor, outside of it <ht>s have | 4312 | only IN the editor, outside of it <ht>s have |
| 4318 | their normal length (default 8 positions). | 4313 | their normal length (default 8 positions). |
| 4319 | This setting affects the current buffer only. | 4314 | This 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 |
| 4327 | wrapmargin -- In append mode Vi automatically | 4322 | wrapmargin: In append mode Vi automatically |
| 4328 | puts a <lf> whenever there is a <sp> or <ht> | 4323 | puts a <lf> whenever there is a <sp> or <ht> |
| 4329 | within <wm> columns from the right margin. | 4324 | within <wm> columns from the right margin. |
| 4330 | @item wrapscan | 4325 | @item wrapscan |
| 4331 | @itemx ws | 4326 | @itemx ws |
| 4332 | @cindex searching | 4327 | @cindex searching |
| 4333 | wrapscan -- When searching, the end is | 4328 | wrapscan: When searching, the end is |
| 4334 | considered @samp{stuck} to the begin of the file. | 4329 | considered @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 | ||
| 4422 | The following two mouse actions are normally bound to special search and | 4417 | The 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 | ||
| 4452 | Viper, formerly known as VIP-19, was written by Michael Kifer. Viper is | 4450 | Viper, formerly known as VIP-19, was written by Michael Kifer. Viper is |
| @@ -4520,36 +4518,27 @@ whicken@@dragon.parasoft.com (Wendell Hicken), | |||
| 4520 | zapman@@cc.gatech.edu (Jason Zapman II), | 4518 | zapman@@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 |
| 11 | Copyright @copyright{} 2000-2012 Free Software Foundation, Inc. | 11 | Copyright @copyright{} 2000--2013 Free Software Foundation, Inc. |
| 12 | 12 | ||
| 13 | @quotation | 13 | @quotation |
| 14 | Permission is granted to copy, distribute and/or modify this document | 14 | Permission 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 | |||
| 19 | is included in the section entitled ``GNU Free Documentation License''. | 19 | is 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 |
| 22 | modify this GNU manual. Buying copies from the FSF supports it in | 22 | modify this GNU manual.'' |
| 23 | developing 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 | ||
| 62 | Most graphical user interface toolkits provide a number of standard | 59 | Most graphical user interface toolkits provide a number of standard |
| 63 | user interface controls (sometimes known as `widgets' or `gadgets'). | 60 | user 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 | |||
| 136 | widget library will also use the new graphic features automatically. | 133 | widget 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 | ||
| 143 | A form consists of read only text for documentation and some fields, | 139 | A form consists of read only text for documentation and some fields, |
| 144 | where each field contains two parts, a tag and a value. The tags are | 140 | where 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}, | |||
| 184 | within a form, namely editing the editable text fields and activating | 180 | within a form, namely editing the editable text fields and activating |
| 185 | the buttons. | 181 | the buttons. |
| 186 | 182 | ||
| 187 | @subsection Editable Text Fields | 183 | @section Editable Text Fields |
| 188 | 184 | ||
| 189 | In the example, the value for the @samp{Name} is most likely displayed | 185 | In the example, the value for the @samp{Name} is most likely displayed |
| 190 | in an editable text field, and so are values for each of the members of | 186 | in 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 | |||
| 221 | Face used for other editing fields. | 217 | Face 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 | |||
| 292 | it. | 288 | it. |
| 293 | @end defopt | 289 | @end defopt |
| 294 | 290 | ||
| 295 | @subsection Navigation | 291 | @section Navigation |
| 296 | 292 | ||
| 297 | You can use all the normal Emacs commands to move around in a form | 293 | You can use all the normal Emacs commands to move around in a form |
| 298 | buffer, plus you will have these additional commands: | 294 | buffer, 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 | ||
| 414 | Widgets are created with @code{widget-create}, which returns a | 411 | Widgets 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} | |||
| 461 | when not on a button. By default this is @code{global-map}. | 458 | when 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 | ||
| 468 | This is the general syntax of a type specification: | 464 | This 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 | ||
| 712 | Syntax: | 707 | Syntax: |
| @@ -729,9 +724,8 @@ String to prefix links. | |||
| 729 | String to suffix links. | 724 | String 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 | ||
| 737 | Syntax: | 731 | Syntax: |
| @@ -744,9 +738,8 @@ Syntax: | |||
| 744 | When this link is invoked, the @acronym{WWW} browser specified by | 738 | When 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 | ||
| 752 | Syntax: | 745 | Syntax: |
| @@ -758,9 +751,8 @@ Syntax: | |||
| 758 | When this link is invoked, the built-in Info reader is started on | 751 | When 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 | ||
| 766 | Syntax: | 758 | Syntax: |
| @@ -783,9 +775,8 @@ String to prefix push buttons. | |||
| 783 | String to suffix push buttons. | 775 | String 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 | ||
| 791 | Syntax: | 782 | Syntax: |
| @@ -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 | |||
| 843 | fields. The default @code{:keymap} is @code{widget-text-keymap}, which | 833 | fields. The default @code{:keymap} is @code{widget-text-keymap}, which |
| 844 | does not rebind the @key{RET} key. | 834 | does 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 | ||
| 851 | Syntax: | 840 | Syntax: |
| @@ -884,9 +873,8 @@ The current chosen type. | |||
| 884 | The list of types. | 873 | The 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 | ||
| 892 | Syntax: | 880 | Syntax: |
| @@ -951,9 +939,8 @@ Please note that such items added after the @code{radio-button-choice} | |||
| 951 | widget has been created will @strong{not} be properly destructed when | 939 | widget has been created will @strong{not} be properly destructed when |
| 952 | you call @code{widget-delete}. | 940 | you 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 | ||
| 959 | Syntax: | 946 | Syntax: |
| @@ -966,9 +953,8 @@ The @var{value}, if present, is used to initialize the @code{:value} | |||
| 966 | property. The value should be a string, which will be inserted in the | 953 | property. The value should be a string, which will be inserted in the |
| 967 | buffer. This widget will only match the specified value. | 954 | buffer. 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 | ||
| 974 | Syntax: | 960 | Syntax: |
| @@ -983,9 +969,8 @@ buffer as a button. Activating the button of a @code{choice-item} is | |||
| 983 | equivalent to activating the parent widget. This widget will only match | 969 | equivalent to activating the parent widget. This widget will only match |
| 984 | the specified value. | 970 | the 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 | ||
| 991 | Syntax: | 976 | Syntax: |
| @@ -1016,9 +1001,8 @@ Name of a glyph to be used instead of the @samp{:off} text string, on | |||
| 1016 | emacsen that supports this. | 1001 | emacsen 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 | ||
| 1024 | This widget has two possible states, @samp{selected} and | 1008 | This 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 | ||
| 1038 | Syntax: | 1021 | Syntax: |
| @@ -1088,9 +1071,8 @@ The widgets representing each type. | |||
| 1088 | The list of types. | 1071 | The 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 | ||
| 1096 | Syntax: | 1078 | Syntax: |
| @@ -1146,9 +1128,8 @@ The widgets representing the elements of the list. | |||
| 1146 | List whose @sc{car} is the type of the list elements. | 1128 | List 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 | ||
| 1154 | This widget simply group other widgets together. | 1135 | This widget simply group other widgets together. |
| @@ -1161,9 +1142,8 @@ Syntax: | |||
| 1161 | 1142 | ||
| 1162 | The value is a list, with one member for each @var{type}. | 1143 | The 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 | ||
| 1169 | A number of widgets for editing @dfn{s-expressions} (Lisp types), sexp | 1149 | A 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 | ||
| 1185 | The @code{const} widget can contain any Lisp expression, but the user is | 1164 | The @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. | |||
| 1214 | An immutable symbol that is bound as a function. | 1193 | An 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 | ||
| 1222 | The @code{sexp} widget can contain any Lisp expression, and allows the | 1200 | The @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 | ||
| 1244 | The atoms are s-expressions that do not consist of other s-expressions. | 1221 | The 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 | ||
| 1322 | The syntax for the composite widget construct is: | 1298 | The 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 | |||
| 1696 | default'' in this text. | 1670 | default'' 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 | ||
| 1704 | There is a separate package to browse widgets. This is intended to help | 1677 | There 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}. | |||
| 1721 | When called interactively, use the position of point. | 1694 | When 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 | ||
| 1729 | There is a minor mode for manipulating widgets in major modes that | 1701 | There 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. | |||
| 1739 | Keymap used in @code{widget-minor-mode}. | 1711 | Keymap 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. | |||
| 1755 | This is only meaningful for radio buttons or checkboxes in a list. | 1726 | This 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. | |||
| 1814 | Add a @code{mailto} widget. | 1784 | Add 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 | ||
| 1825 | This is an alphabetical listing of all concepts, functions, commands, | 1794 | This 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 |
| 26 | Copyright @copyright{} 1988-1993, 1995, 1998-2004, 2007, 2012 | 26 | Copyright @copyright{} 1988--1993, 1995, 1998--2004, 2007, 2012--2013 |
| 27 | Free Software Foundation, Inc. | 27 | Free 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 | |||
| 43 | is included in the section entitled ``GNU Free Documentation License''. | 43 | is 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 |
| 46 | modify this GNU manual. Buying copies from the FSF supports it in | 46 | modify this GNU manual.'' |
| 47 | developing 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 | |||
| 113 | of GNU Bison 1.28 & 1.31. | 112 | of GNU Bison 1.28 & 1.31. |
| 114 | 113 | ||
| 115 | For more details on the basic concepts for understanding Wisent, it is | 114 | For more details on the basic concepts for understanding Wisent, it is |
| 116 | worthwhile to read the @ref{Top, Bison Manual, bison}. | 115 | worthwhile 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 | |||
| 304 | can match the empty string. For example, here is how to define a | 302 | can match the empty string. For example, here is how to define a |
| 305 | comma-separated sequence of zero or more @samp{exp} groupings: | 303 | comma-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 | ||
| 342 | Now the precedence of @code{UMINUS} can be used in specific rules: | 340 | Now 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 | ||
| 355 | If you forget to append @code{[UMINUS]} to the rule for unary minus, | 353 | If you forget to append @code{[UMINUS]} to the rule for unary minus, |
| 356 | Wisent silently assumes that minus has its usual precedence. This | 354 | Wisent 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 | ||
| 627 | Normally, a grammar should produce an automaton where at each state | 622 | Normally, 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 | |||
| 1038 | state 9 | 1032 | state 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 | |||
| 1053 | state 10 | 1046 | state 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 @@ | |||
| 18 | This file documents WoMan: A program to browse Unix manual pages `W.O. | 14 | This file documents WoMan: A program to browse Unix manual pages `W.O. |
| 19 | (without) man'. | 15 | (without) man'. |
| 20 | 16 | ||
| 21 | Copyright @copyright{} 2001-2012 Free Software Foundation, Inc. | 17 | Copyright @copyright{} 2001--2013 Free Software Foundation, Inc. |
| 22 | 18 | ||
| 23 | @quotation | 19 | @quotation |
| 24 | Permission is granted to copy, distribute and/or modify this document | 20 | Permission 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 | |||
| 29 | is included in the section entitled ``GNU Free Documentation License.'' | 25 | is 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 |
| 32 | modify this GNU manual. Buying copies from the FSF supports it in | 28 | modify this GNU manual.'' |
| 33 | developing 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 |
| 76 | Software Version @value{VERSION} | 68 | As distributed with Emacs @value{EMACSVER}. |
| 77 | Manual 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 | |||
| 296 | emulation of @code{troff} as GNU Emacs moves to providing bit-mapped | 285 | emulation of @code{troff} as GNU Emacs moves to providing bit-mapped |
| 297 | display facilities. | 286 | display 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 | |||
| 470 | time it is run in a new Emacs session. | 456 | time 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 | |||
| 547 | primarily used internally by WoMan. | 531 | primarily 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 | |||
| 632 | sub-scripts, which are not displayed well by WoMan. | 613 | sub-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 |