aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorKenichi Handa2014-01-11 22:00:54 +0900
committerKenichi Handa2014-01-11 22:00:54 +0900
commitaf05bef2d1985fb9bd8485f3084f3bfe282a911f (patch)
tree073c53ac52592c200d8b00e5458d4dc70c8647f4 /doc/misc
parent3923e7bde942018135c7362c75327ffddcbd81fc (diff)
parent02013850f638520bed0d6c3f77eb9c80e0f73983 (diff)
downloademacs-af05bef2d1985fb9bd8485f3084f3bfe282a911f.tar.gz
emacs-af05bef2d1985fb9bd8485f3084f3bfe282a911f.zip
merge trunk
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/ChangeLog121
-rw-r--r--doc/misc/Makefile.in14
-rw-r--r--doc/misc/autotype.texi2
-rw-r--r--doc/misc/calc.texi4
-rw-r--r--doc/misc/cl.texi9
-rw-r--r--doc/misc/eww.texi254
-rw-r--r--doc/misc/gnus.texi4
-rw-r--r--doc/misc/idlwave.texi2
-rw-r--r--doc/misc/texinfo.tex74
9 files changed, 379 insertions, 105 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 46fb672e28a..722d11c70f2 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,12 @@
12014-01-10 Stefan Monnier <monnier@iro.umontreal.ca>
2
3 * cl.texi (Function Bindings): Fix incorrect description of cl-let.
4
52014-01-09 RĂ¼diger Sonderfeld <ruediger@c-plusplus.de>
6
7 * Makefile.in: Add eww.texi.
8 * eww.texi: New file.
9
12014-01-07 Glenn Morris <rgm@gnu.org> 102014-01-07 Glenn Morris <rgm@gnu.org>
2 11
3 * efaq.texi (Problems with very large files): Fix superscript typo. 12 * efaq.texi (Problems with very large files): Fix superscript typo.
@@ -13,8 +22,8 @@
13 (Advanced configuration) 22 (Advanced configuration)
14 (Header arguments in Org mode properties): Spelling fixes. 23 (Header arguments in Org mode properties): Spelling fixes.
15 (Special blocks): Add #+BEGIN_ABSTRACT as another example. 24 (Special blocks): Add #+BEGIN_ABSTRACT as another example.
16 (@LaTeX{} specific attributes): New index entries. Use 25 (@LaTeX{} specific attributes): New index entries.
17 #+BEGIN_ABSTRACT in the example. 26 Use #+BEGIN_ABSTRACT in the example.
18 27
192013-01-07 Nicolas Goaziou <n.goaziou@gmail.com> 282013-01-07 Nicolas Goaziou <n.goaziou@gmail.com>
20 29
@@ -75,7 +84,7 @@
75 84
762014-01-02 Aidan Gauland <aidalgol@amuri.net> 852014-01-02 Aidan Gauland <aidalgol@amuri.net>
77 86
78 * eshell.texi (Command Basics): Removed `Command basics' chapter. 87 * eshell.texi (Command Basics): Remove `Command basics' chapter.
79 88
802014-01-02 Aidan Gauland <aidalgol@amuri.net> 892014-01-02 Aidan Gauland <aidalgol@amuri.net>
81 90
@@ -195,8 +204,8 @@
195 * org.texi (Orgstruct mode): Fix suggested setting of 204 * org.texi (Orgstruct mode): Fix suggested setting of
196 `orgstruct-heading-prefix-regexp'. 205 `orgstruct-heading-prefix-regexp'.
197 206
198 * org.texi (Export settings): Document 207 * org.texi (Export settings):
199 `org-export-allow-bind-keywords'. 208 Document `org-export-allow-bind-keywords'.
200 209
201 * org.texi (History and Acknowledgments): Small rephrasing. 210 * org.texi (History and Acknowledgments): Small rephrasing.
202 211
@@ -204,8 +213,8 @@
204 in a year datetree. 213 in a year datetree.
205 214
206 * org.texi (Beamer export, @LaTeX{} and PDF export) 215 * org.texi (Beamer export, @LaTeX{} and PDF export)
207 (Header and sectioning, @LaTeX{} specific attributes): Enhance 216 (Header and sectioning, @LaTeX{} specific attributes):
208 style. 217 Enhance style.
209 218
210 * org.texi (Agenda commands): Add a footnote about dragging agenda 219 * org.texi (Agenda commands): Add a footnote about dragging agenda
211 lines: it does not persist and it does not change the .org files. 220 lines: it does not persist and it does not change the .org files.
@@ -224,15 +233,15 @@
224 233
225 * org.texi (Other built-in back-ends): New section. 234 * org.texi (Other built-in back-ends): New section.
226 235
227 * org.texi (Editing source code): Document 236 * org.texi (Editing source code):
228 `org-edit-src-auto-save-idle-delay' and 237 Document `org-edit-src-auto-save-idle-delay' and
229 `org-edit-src-turn-on-auto-save'. 238 `org-edit-src-turn-on-auto-save'.
230 239
231 * org.texi (External links): Document contributed link types 240 * org.texi (External links): Document contributed link types
232 separately. 241 separately.
233 242
234 * org.texi (Closing items): Document 243 * org.texi (Closing items):
235 `org-closed-keep-when-no-todo'. 244 Document `org-closed-keep-when-no-todo'.
236 245
237 * org.texi (Export back-ends): Rename from "Export formats". 246 * org.texi (Export back-ends): Rename from "Export formats".
238 (The Export Dispatcher): Remove reference to 247 (The Export Dispatcher): Remove reference to
@@ -268,8 +277,8 @@
268 (Agenda commands): Move details about filtering commands to 277 (Agenda commands): Move details about filtering commands to
269 the new section, only include a summary here. 278 the new section, only include a summary here.
270 (Customizing tables in ODT export) 279 (Customizing tables in ODT export)
271 (System-wide header arguments, Conflicts, Dynamic blocks): Use 280 (System-wide header arguments, Conflicts, Dynamic blocks):
272 spaces for indentation. 281 Use spaces for indentation.
273 282
274 * org.texi (Emphasis and monospace): Mention `org-emphasis-alist'. 283 * org.texi (Emphasis and monospace): Mention `org-emphasis-alist'.
275 284
@@ -326,8 +335,8 @@
326 (In-buffer settings): Update to reflect changes from the new 335 (In-buffer settings): Update to reflect changes from the new
327 export engine. 336 export engine.
328 337
329 * org.texi (Matching tags and properties): More examples. Explain 338 * org.texi (Matching tags and properties): More examples.
330 group tags expansion as regular expressions. 339 Explain group tags expansion as regular expressions.
331 340
332 * org.texi (Tag groups): New section. 341 * org.texi (Tag groups): New section.
333 342
@@ -352,8 +361,8 @@
352 361
353 * org.texi (Org syntax): New section. 362 * org.texi (Org syntax): New section.
354 363
355 * org.texi (Orgstruct mode): Document 364 * org.texi (Orgstruct mode):
356 `orgstruct-heading-prefix-regexp'. 365 Document `orgstruct-heading-prefix-regexp'.
357 366
358 * org.texi (Speeding up your agendas): New section. 367 * org.texi (Speeding up your agendas): New section.
359 368
@@ -377,8 +386,8 @@
377 * org.texi: Update the list contributions. 386 * org.texi: Update the list contributions.
378 387
379 * org.texi (Agenda commands): Exporting the agenda to an .org file 388 * org.texi (Agenda commands): Exporting the agenda to an .org file
380 will not copy the subtrees and the inherited tags. Document 389 will not copy the subtrees and the inherited tags.
381 `org-agenda-filter-by-regexp'. 390 Document `org-agenda-filter-by-regexp'.
382 391
383 * org.texi (Publishing action, Complex example): Fix names of 392 * org.texi (Publishing action, Complex example): Fix names of
384 publishing functions. 393 publishing functions.
@@ -392,8 +401,8 @@
392 * org.texi (Capture): Mention that org-remember.el is not 401 * org.texi (Capture): Mention that org-remember.el is not
393 supported anymore. 402 supported anymore.
394 403
395 * org.texi (Top, Exporting, Beamer class export): Delete 404 * org.texi (Top, Exporting, Beamer class export):
396 references to the TaskJuggler export. 405 Delete references to the TaskJuggler export.
397 (History and Acknowledgments): Mention that the TaskJuggler has 406 (History and Acknowledgments): Mention that the TaskJuggler has
398 been rewritten by Nicolas and now lives in the contrib/ directory 407 been rewritten by Nicolas and now lives in the contrib/ directory
399 of Org's distribution. Mention that Jambunathan rewrote the HTML 408 of Org's distribution. Mention that Jambunathan rewrote the HTML
@@ -410,16 +419,16 @@
410 (@LaTeX{} and PDF export, Header and sectioning) 419 (@LaTeX{} and PDF export, Header and sectioning)
411 (Publishing options): Fix LaTeX options names. 420 (Publishing options): Fix LaTeX options names.
412 421
413 * org.texi (Export options, CSS support, In-buffer settings): Fix 422 * org.texi (Export options, CSS support, In-buffer settings):
414 references to HTML_LINK_* and HTML_STYLE keywords. 423 Fix references to HTML_LINK_* and HTML_STYLE keywords.
415 424
416 * org.texi (Export options, In-buffer settings): Fix references to 425 * org.texi (Export options, In-buffer settings): Fix references to
417 #+SELECT_TAGS and #+EXCLUDE_TAGS and remove reference to #+XSLT. 426 #+SELECT_TAGS and #+EXCLUDE_TAGS and remove reference to #+XSLT.
418 427
419 * org.texi (Top, Markup, Initial text, Images and tables) 428 * org.texi (Top, Markup, Initial text, Images and tables)
420 (@LaTeX{} fragments, @LaTeX{} fragments, Exporting) 429 (@LaTeX{} fragments, @LaTeX{} fragments, Exporting)
421 (Export options, JavaScript support, Beamer class export): Remove 430 (Export options, JavaScript support, Beamer class export):
422 references to the DocBook export, which has been deleted. 431 Remove references to the DocBook export, which has been deleted.
423 (History and Acknowledgments): Mention that DocBook has been 432 (History and Acknowledgments): Mention that DocBook has been
424 deleted, suggest to use the Texinfo exporter instead, then to 433 deleted, suggest to use the Texinfo exporter instead, then to
425 convert the .texi to DocBook with makeinfo. 434 convert the .texi to DocBook with makeinfo.
@@ -428,8 +437,8 @@
428 * org.texi (Deadlines and scheduling): Add a variable to the 437 * org.texi (Deadlines and scheduling): Add a variable to the
429 index. Add documentation about delays for scheduled tasks. 438 index. Add documentation about delays for scheduled tasks.
430 439
431 * org.texi (Emphasis and monospace): Mention 440 * org.texi (Emphasis and monospace):
432 `org-fontify-emphasized-text' and 441 Mention `org-fontify-emphasized-text' and
433 `org-emphasis-regexp-components'. 442 `org-emphasis-regexp-components'.
434 443
435 * org.texi (References): Small enhancement. 444 * org.texi (References): Small enhancement.
@@ -486,7 +495,7 @@
486 495
487 * org.texi (Extracting source code): Mention the prefix argument 496 * org.texi (Extracting source code): Mention the prefix argument
488 to org-babel-tangle. 497 to org-babel-tangle.
489 (noweb): Removed erroneous negative. 498 (noweb): Remove erroneous negative.
490 (Specific header arguments): Document new header arguments. 499 (Specific header arguments): Document new header arguments.
491 Documentation for new tangle-mode header argument. 500 Documentation for new tangle-mode header argument.
492 (Top): Documentation for new tangle-mode header argument. 501 (Top): Documentation for new tangle-mode header argument.
@@ -590,8 +599,8 @@
590 * org.texi (Header and sectioning): Add a footnote about the 599 * org.texi (Header and sectioning): Add a footnote about the
591 different between LATEX_HEADER_EXTRA and LATEX_HEADER. 600 different between LATEX_HEADER_EXTRA and LATEX_HEADER.
592 601
593 * org.texi (The Export Dispatcher): Document 602 * org.texi (The Export Dispatcher):
594 `org-export-in-background'. 603 Document `org-export-in-background'.
595 604
596 * org.texi (Footnotes): Export back-ends do not use 605 * org.texi (Footnotes): Export back-ends do not use
597 `org-footnote-normalize' anymore. 606 `org-footnote-normalize' anymore.
@@ -613,19 +622,19 @@
613 * org.texi (Include files): Remove reference to :prefix1 622 * org.texi (Include files): Remove reference to :prefix1
614 and :prefix. Give more details for :minlevel. 623 and :prefix. Give more details for :minlevel.
615 624
616 * org.texi (Macro replacement): Fix macro name. Update 625 * org.texi (Macro replacement): Fix macro name.
617 documentation about possible locations and escaping mechanism. 626 Update documentation about possible locations and escaping mechanism.
618 627
619 * org.texi (Table of contents): Update documentation. Document 628 * org.texi (Table of contents): Update documentation.
620 lists of listings and lists of tables. Add documentation for 629 Document lists of listings and lists of tables. Add documentation for
621 optional title and #+TOC: keyword. 630 optional title and #+TOC: keyword.
622 631
6232013-11-12 Rick Frankel <rick@rickster.com> 6322013-11-12 Rick Frankel <rick@rickster.com>
624 633
625 * org.texi (results): Add Format section, broken out of Type 634 * org.texi (results): Add Format section, broken out of Type
626 section to match code. 635 section to match code.
627 (hlines, colnames): Remove incorrect Emacs Lisp exception. Note 636 (hlines, colnames): Remove incorrect Emacs Lisp exception.
628 that the actual default handling (at least for python and 637 Note that the actual default handling (at least for python and
629 emacs-lisp) does not seem to match the description. 638 emacs-lisp) does not seem to match the description.
630 639
6312013-11-12 Sacha Chua <sacha@sachachua.com> (tiny change) 6402013-11-12 Sacha Chua <sacha@sachachua.com> (tiny change)
@@ -635,8 +644,8 @@
635 644
6362013-11-12 Yasushi Shoji <yashi@atmark-techno.com> 6452013-11-12 Yasushi Shoji <yashi@atmark-techno.com>
637 646
638 * org.texi (Resolving idle time): Document 647 * org.texi (Resolving idle time):
639 `org-clock-x11idle-program-name'. 648 Document `org-clock-x11idle-program-name'.
640 649
6412013-10-24 Michael Albinus <michael.albinus@gmx.de> 6502013-10-24 Michael Albinus <michael.albinus@gmx.de>
642 651
@@ -655,7 +664,7 @@
655 664
6562013-10-17 Jay Belanger <jay.p.belanger@gmail.com> 6652013-10-17 Jay Belanger <jay.p.belanger@gmail.com>
657 666
658 * calc.el (Data Type Formats): Don't specify the size at 667 * calc.texi (Data Type Formats): Don't specify the size at
659 which integers begin to be represented by lists. 668 which integers begin to be represented by lists.
660 669
6612013-10-14 Xue Fuqiao <xfq.free@gmail.com> 6702013-10-14 Xue Fuqiao <xfq.free@gmail.com>
@@ -877,8 +886,8 @@
877 886
8782013-07-29 Michael Albinus <michael.albinus@gmx.de> 8872013-07-29 Michael Albinus <michael.albinus@gmx.de>
879 888
880 * tramp.texi (Frequently Asked Questions): Mention 889 * tramp.texi (Frequently Asked Questions):
881 `tramp-use-ssh-controlmaster-options'. 890 Mention `tramp-use-ssh-controlmaster-options'.
882 891
8832013-07-26 Tassilo Horn <tsdh@gnu.org> 8922013-07-26 Tassilo Horn <tsdh@gnu.org>
884 893
@@ -922,8 +931,8 @@
9222013-07-08 Tassilo Horn <tsdh@gnu.org> 9312013-07-08 Tassilo Horn <tsdh@gnu.org>
923 932
924 * gnus.texi (lines): Correct description of 933 * gnus.texi (lines): Correct description of
925 `gnus-registry-track-extra's default value. Mention 934 `gnus-registry-track-extra's default value.
926 `gnus-registry-remove-extra-data'. 935 Mention `gnus-registry-remove-extra-data'.
927 936
9282013-07-06 Lars Ingebrigtsen <larsi@gnus.org> 9372013-07-06 Lars Ingebrigtsen <larsi@gnus.org>
929 938
@@ -6284,6 +6293,12 @@
6284 6293
6285 * org.texi: Massive changes, in many parts of the file. 6294 * org.texi: Massive changes, in many parts of the file.
6286 6295
62962008-04-27 Jason Riedy <jason@acm.org>
6297
6298 * org.texi (A LaTeX example): Note that fmt may be a
6299 one-argument function, and efmt may be a two-argument function.
6300 (Radio tables): Document multiple destinations.
6301
62872008-04-13 Reiner Steib <Reiner.Steib@gmx.de> 63022008-04-13 Reiner Steib <Reiner.Steib@gmx.de>
6288 6303
6289 * gnus.texi (Oort Gnus): Add message-fill-column. 6304 * gnus.texi (Oort Gnus): Add message-fill-column.
@@ -6516,6 +6531,10 @@
6516 6531
6517 * tramp.texi (Remote processes): Add `shell-command'. 6532 * tramp.texi (Remote processes): Add `shell-command'.
6518 6533
65342008-02-02 Michael Albinus <michael.albinus@gmx.de>
6535
6536 * tramp.texi: Use new FSF's Back-Cover Text.
6537
65192008-01-28 Michael Sperber <sperber@deinprogramm.de> 65382008-01-28 Michael Sperber <sperber@deinprogramm.de>
6520 6539
6521 * gnus.texi (Mail Source Specifiers): Document `group' specifier. 6540 * gnus.texi (Mail Source Specifiers): Document `group' specifier.
@@ -6616,7 +6635,7 @@
6616 6635
66172007-12-29 Jay Belanger <jay.p.belanger@gmail.com> 66362007-12-29 Jay Belanger <jay.p.belanger@gmail.com>
6618 6637
6619 * calc.tex (Yacas Language, Maxima Language, Giac Language): 6638 * calc.texi (Yacas Language, Maxima Language, Giac Language):
6620 New sections. 6639 New sections.
6621 6640
66222007-12-29 Reiner Steib <Reiner.Steib@gmx.de> 66412007-12-29 Reiner Steib <Reiner.Steib@gmx.de>
@@ -6634,6 +6653,10 @@
6634 6653
6635 * trampver.texi: Update release number. 6654 * trampver.texi: Update release number.
6636 6655
66562007-12-22 Richard Stallman <rms@gnu.org>
6657
6658 * cc-mode.texi (Getting Started): Change @ref to @pxref.
6659
66372007-12-22 Michael Albinus <michael.albinus@gmx.de> 66602007-12-22 Michael Albinus <michael.albinus@gmx.de>
6638 6661
6639 * dbus.texi (Type Conversion): Correct input parameters mapping. 6662 * dbus.texi (Type Conversion): Correct input parameters mapping.
@@ -7895,11 +7918,6 @@
7895 * gnus.texi (Batching Agents): Fix example. Reported by Tassilo Horn 7918 * gnus.texi (Batching Agents): Fix example. Reported by Tassilo Horn
7896 <tassilo@member.fsf.org>. 7919 <tassilo@member.fsf.org>.
7897 7920
78982007-01-27 Eli Zaretskii <eliz@gnu.org>
7899
7900 * msdog.texi (ls in Lisp): Document ls-lisp-format-time-list and
7901 ls-lisp-use-localized-time-format.
7902
79032007-01-20 Markus Triska <markus.triska@gmx.at> 79212007-01-20 Markus Triska <markus.triska@gmx.at>
7904 7922
7905 * flymake.texi (Flymake mode): find-file-hook instead of ...-hooks. 7923 * flymake.texi (Flymake mode): find-file-hook instead of ...-hooks.
@@ -8195,7 +8213,6 @@
8195 * faq.texi (Escape sequences in shell output): EMACS is now set 8213 * faq.texi (Escape sequences in shell output): EMACS is now set
8196 to Emacs's absolute file name, not to "t". 8214 to Emacs's absolute file name, not to "t".
8197 (^M in the shell buffer): Likewise. 8215 (^M in the shell buffer): Likewise.
8198 * misc.texi (Interactive Shell): Likewise.
8199 8216
82002006-09-11 Reiner Steib <Reiner.Steib@gmx.de> 82172006-09-11 Reiner Steib <Reiner.Steib@gmx.de>
8201 8218
@@ -8213,6 +8230,10 @@
8213 8230
8214 * smtpmail.texi (Authentication): Mention SSL. 8231 * smtpmail.texi (Authentication): Mention SSL.
8215 8232
82332006-09-03 Diane Murray <disumu@x3y2z1.net>
8234
8235 * erc.texi (Getting Started, Connecting): Change erc-select to erc.
8236
82162006-09-01 Eli Zaretskii <eliz@gnu.org> 82372006-09-01 Eli Zaretskii <eliz@gnu.org>
8217 8238
8218 * rcirc.texi (Internet Relay Chat, Useful IRC commands): 8239 * rcirc.texi (Internet Relay Chat, Useful IRC commands):
diff --git a/doc/misc/Makefile.in b/doc/misc/Makefile.in
index 8b8d8a606c9..b3318ddd183 100644
--- a/doc/misc/Makefile.in
+++ b/doc/misc/Makefile.in
@@ -65,7 +65,7 @@ DOCMISC_W32 = @DOCMISC_W32@
65## Info files to build and install on all platforms. 65## Info files to build and install on all platforms.
66INFO_COMMON = ada-mode auth autotype bovine calc ccmode cl \ 66INFO_COMMON = ada-mode auth autotype bovine calc ccmode cl \
67 dbus dired-x ebrowse ede ediff edt eieio \ 67 dbus dired-x ebrowse ede ediff edt eieio \
68 emacs-mime epa erc ert eshell eudc efaq \ 68 emacs-mime epa erc ert eshell eudc efaq eww \
69 flymake forms gnus emacs-gnutls htmlfontify idlwave ido info.info \ 69 flymake forms gnus emacs-gnutls htmlfontify idlwave ido info.info \
70 mairix-el message mh-e newsticker nxml-mode octave-mode \ 70 mairix-el message mh-e newsticker nxml-mode octave-mode \
71 org pcl-cvs pgg rcirc remember reftex sasl \ 71 org pcl-cvs pgg rcirc remember reftex sasl \
@@ -410,6 +410,18 @@ eudc.pdf: $(eudc_deps)
410eudc.html: $(eudc_deps) 410eudc.html: $(eudc_deps)
411 $(MAKEINFO) $(MAKEINFO_OPTS) $(HTML_OPTS) -o $@ ${srcdir}/eudc.texi 411 $(MAKEINFO) $(MAKEINFO_OPTS) $(HTML_OPTS) -o $@ ${srcdir}/eudc.texi
412 412
413eww_deps = ${srcdir}/eww.texi $(emacsdir)/emacsver.texi ${gfdl}
414eww : $(buildinfodir)/eww$(INFO_EXT)
415$(buildinfodir)/eww$(INFO_EXT): $(eww_deps)
416 $(mkinfodir)
417 $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/eww.texi
418eww.dvi: $(eww_deps)
419 $(ENVADD) $(TEXI2DVI) ${srcdir}/eww.texi
420eww.pdf: $(eww_deps)
421 $(ENVADD) $(TEXI2PDF) ${srcdir}/eww.texi
422eww.html: $(eww_deps)
423 $(MAKEINFO) $(MAKEINFO_OPTS) $(HTML_OPTS) -o $@ ${srcdir}/eww.texi
424
413flymake_deps = ${srcdir}/flymake.texi ${gfdl} 425flymake_deps = ${srcdir}/flymake.texi ${gfdl}
414flymake : $(buildinfodir)/flymake$(INFO_EXT) 426flymake : $(buildinfodir)/flymake$(INFO_EXT)
415$(buildinfodir)/flymake$(INFO_EXT): $(flymake_deps) 427$(buildinfodir)/flymake$(INFO_EXT): $(flymake_deps)
diff --git a/doc/misc/autotype.texi b/doc/misc/autotype.texi
index aacf4fad83e..7ca860486c2 100644
--- a/doc/misc/autotype.texi
+++ b/doc/misc/autotype.texi
@@ -302,7 +302,7 @@ of the same name as the command and can thus be overridden from your
302 Various characters usually appear in pairs. When, for example, you insert 302 Various characters usually appear in pairs. When, for example, you insert
303an open parenthesis, no matter whether you are programming or writing prose, 303an open parenthesis, no matter whether you are programming or writing prose,
304you will surely enter a closing one later. By entering both at the same time 304you will surely enter a closing one later. By entering both at the same time
305and leaving the cursor inbetween, Emacs can guarantee you that such 305and leaving the cursor in between, Emacs can guarantee you that such
306parentheses are always balanced. And if you have a non-qwerty keyboard, where 306parentheses are always balanced. And if you have a non-qwerty keyboard, where
307typing some of the stranger programming language symbols makes you bend your 307typing some of the stranger programming language symbols makes you bend your
308fingers backwards, this can be quite relieving too. 308fingers backwards, this can be quite relieving too.
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index 10c863a9513..1700aee9dc1 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -28053,8 +28053,8 @@ radiation related to the cesium-133 atom. The only SI unit that is not
28053based on a fundamental physical process (although there are efforts to 28053based on a fundamental physical process (although there are efforts to
28054change this) is the kilogram, which was originally defined as the mass 28054change this) is the kilogram, which was originally defined as the mass
28055of one liter of water, but is now defined as the mass of the 28055of one liter of water, but is now defined as the mass of the
28056International Prototype Kilogram (IPK), a cylinder of platinum-iridium 28056international prototype of the kilogram (IPK), a cylinder of platinum-iridium
28057kept at the Bureau International des Poids et Mesures in S@`evres, 28057kept at the Bureau international des poids et mesures in S@`evres,
28058France. (There are several copies of the IPK throughout the world.) 28058France. (There are several copies of the IPK throughout the world.)
28059The British imperial units, once defined in terms of physical objects, 28059The British imperial units, once defined in terms of physical objects,
28060were redefined in 1963 in terms of SI units. The US customary units, 28060were redefined in 1963 in terms of SI units. The US customary units,
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index 08f9610e594..0490cf639ac 100644
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -1282,13 +1282,8 @@ cells of symbols rather than on the value cells. Each @var{binding}
1282must be a list of the form @samp{(@var{name} @var{arglist} 1282must be a list of the form @samp{(@var{name} @var{arglist}
1283@var{forms}@dots{})}, which defines a function exactly as if 1283@var{forms}@dots{})}, which defines a function exactly as if
1284it were a @code{cl-defun} form. The function @var{name} is defined 1284it were a @code{cl-defun} form. The function @var{name} is defined
1285accordingly for the duration of the body of the @code{cl-flet}; then 1285accordingly but only within the body of the @code{cl-flet}, hiding any external
1286the old function definition, or lack thereof, is restored. 1286definition if applicable.
1287
1288You can use @code{cl-flet} to disable or modify the behavior of
1289functions (including Emacs primitives) in a temporary, localized fashion.
1290(Compare this with the idea of advising functions.
1291@xref{Advising Functions,,,elisp,GNU Emacs Lisp Reference Manual}.)
1292 1287
1293The bindings are lexical in scope. This means that all references to 1288The bindings are lexical in scope. This means that all references to
1294the named functions must appear physically within the body of the 1289the named functions must appear physically within the body of the
diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi
new file mode 100644
index 00000000000..b84de7509da
--- /dev/null
+++ b/doc/misc/eww.texi
@@ -0,0 +1,254 @@
1\input texinfo @c -*-texinfo-*-
2@c %**start of header
3@setfilename ../../info/eww
4@settitle Emacs Web Wowser
5@documentencoding UTF-8
6@c @include emacsver.texi
7@c %**end of header
8
9@copying
10This file documents the GNU Emacs Web Wowser (EWW) package.
11
12Copyright @copyright{} 2014 Free Software Foundation, Inc.
13
14@quotation
15Permission is granted to copy, distribute and/or modify this document
16under the terms of the GNU Free Documentation License, Version 1.3 or
17any later version published by the Free Software Foundation; with no
18Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
19and with the Back-Cover Texts as in (a) below. A copy of the license
20is included in the section entitled ``GNU Free Documentation License.''
21
22(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23modify this GNU manual.''
24@end quotation
25@end copying
26
27@dircategory Emacs misc features
28@direntry
29* EWW: (eww). Emacs Web Wowser
30@end direntry
31
32@finalout
33
34@titlepage
35@title Emacs Web Wowser (EWW)
36@subtitle A web browser for GNU Emacs.
37
38@page
39@vskip 0pt plus 1filll
40@insertcopying
41@end titlepage
42
43@contents
44
45@ifnottex
46@node Top
47@top EWW
48
49@insertcopying
50@end ifnottex
51
52@menu
53* Overview::
54* Basics::
55* Advanced::
56
57Appendices
58* History and Acknowledgments::
59* GNU Free Documentation License:: The license for this documentation.
60
61Indices
62* Key Index::
63* Variable Index::
64* Lisp Function Index::
65* Concept Index::
66@end menu
67
68@node Overview
69@chapter Overview
70@dfn{EWW}, the Emacs Web Wowser, is a web browser for GNU Emacs. It
71can load, parse, and display various web pages using @dfn{shr.el}.
72However a GNU Emacs with @code{libxml2} support is required.
73
74@node Basics
75@chapter Basic Usage
76
77@findex eww
78@findex eww-open-file
79@vindex eww-search-prefix
80@cindex eww
81@cindex Web Browsing
82 You can open a URL or search the web with the command @kbd{M-x eww}.
83If the input doesn't look like a URL or domain name the web will be
84searched via @code{eww-search-prefix}. The default search engine is
85@url{https://duckduckgo.com, DuckDuckGo}. If you want to open a file
86either prefix the path with @code{file://} or use the command @kbd{M-x
87eww-open-file}.
88
89@findex eww-quit
90@findex eww-reload
91@findex eww-copy-page-url
92@kindex q
93@kindex w
94@kindex g
95 If loading the URL was successful the buffer @code{*eww*} is opened
96and the web page is rendered in it. You can leave EWW by pressing
97@kbd{q} or exit the browser by calling @kbd{eww-quit}. To reload the
98web page hit @kbd{g} (@code{eww-reload}). Pressing @kbd{w}
99(@code{eww-copy-page-url}) will copy the current URL to the kill ring.
100
101@findex eww-download
102@vindex eww-download-path
103@kindex d
104@cindex Download
105 A URL under the point can be downloaded with @kbd{d}
106(@code{eww-download}). The file will be written to the directory
107specified in @code{eww-download-path} (Default: @file{~/Downloads/}).
108
109@findex eww-back-url
110@findex eww-forward-url
111@findex eww-list-histories
112@kindex r
113@kindex l
114@kindex H
115@cindex History
116 EWW remembers the URLs you have visited to allow you to go back and
117forth between them. By pressing @kbd{l} (@code{eww-back-url}) you go
118to the previous URL. You can go forward again with @kbd{r}
119(@code{eww-forward-url}). If you want an overview of your browsing
120history press @kbd{H} (@code{eww-list-histories}) to open the history
121buffer @code{*eww history*}. The history is lost when EWW is quit.
122If you want to remember websites you can use bookmarks.
123
124@findex eww-add-bookmark
125@findex eww-list-bookmarks
126@kindex b
127@kindex B
128@cindex Bookmarks
129 EWW allows you to @dfn{bookmark} URLs. Simply hit @kbd{b}
130(@code{eww-add-bookmark}) to store a bookmark for the current website.
131You can view stored bookmarks with @kbd{B}
132(@code{eww-list-bookmarks}). This will open the bookmark buffer
133@code{*eww bookmarks*}.
134
135@findex eww-browse-with-external-browser
136@vindex shr-external-browser
137@vindex eww-use-external-browser-for-content-type
138@kindex &
139@cindex External Browser
140 Although EWW and shr.el do their best to render webpages in GNU
141Emacs some websites use features which can not be properly represented
142or are not implemented (E.g., JavaScript). If you have trouble
143viewing a website with EWW then hit @kbd{&}
144(@code{eww-browse-with-external-browser}) inside the EWW buffer to
145open the website in the external browser specified by
146@code{shr-external-browser}. Some content types, such as video or
147audio content, do not make sense to display in GNU Emacs at all. You
148can tell EWW to open specific content automatically in an external
149browser by customizing
150@code{eww-use-external-browser-for-content-type}.
151
152@node Advanced
153@chapter Advanced
154
155@findex eww-view-source
156@kindex v
157@cindex Viewing Source
158 You can view the source of a website with @kbd{v}
159(@code{eww-view-source}). This will open a new buffer
160@code{*eww-source*} and insert the source. The buffer will be set to
161@code{html-mode} if available.
162
163@findex url-cookie-list
164@kindex C
165@cindex Cookies
166 EWW handles cookies through the @ref{Top, url package, ,url}.
167You can list existing cookies with @kbd{C} (@code{url-cookie-list}).
168For details about the Cookie handling @xref{Cookies,,,url}.
169
170@vindex eww-header-line-format
171@cindex Header
172 The header line of the EWW buffer can be changed by customizing
173@code{eww-header-line-format}. The format replaces @code{%t} with the
174title of the website and @code{%u} with the URL.
175
176@c @vindex shr-bullet
177@c @vindex shr-hr-line
178@c @vindex eww-form-checkbox-selected-symbol
179@c @vindex eww-form-checkbox-symbol
180@c EWW and the rendering engine shr.el use ASCII characters to
181@c represent some graphical elements, such as bullet points
182@c (@code{shr-bullet}), check boxes
183@c (@code{eww-form-checkbox-selected-symbol} and
184@c @code{eww-form-checkbox-symbol}), and horizontal rules
185@c @code{shr-hr-line}). Depending on your fonts these characters can be
186@c replaced by Unicode glyphs to achieve better looking results.
187
188@vindex shr-max-image-proportion
189@vindex shr-blocked-images
190@cindex Image Display
191 Loading random images from the web can be problematic due to their
192size or content. By customizing @code{shr-max-image-proportion} you
193can set the maximal image proportion in relation to the window they
194are displayed in. E.g., 0.7 means an image is allowed to take up 70%
195of the width and height. If Emacs supports image scaling (ImageMagick
196support required) then larger images are scaled down. You can block
197specific images completely by customizing @code{shr-blocked-images}.
198
199@node History and Acknowledgments
200@appendix History and Acknowledgments
201
202EWW was originally written by Lars Ingebrigtsen, known for his work on
203Gnus. He started writing an Emacs HTML rendering library,
204@code{shr.el}, to read blogs in Gnus. He eventually added a web
205browser front end and HTML form support. Which resulted in EWW, the
206Emacs Web Wowser. EWW was announced on 16 June 2013:
207@url{http://lars.ingebrigtsen.no/2013/06/16/eww/}.
208
209EWW was then moved from the Gnus repository to GNU Emacs and several
210developers started contributing to it as well. A list of contributors
211at the time of writing this manual:
212
213@itemize @bullet
214@item Daniel Hackney
215@item Eli Zaretskii
216@item Glenn Morris
217@item Ivan Kanis
218@item Juri Linkov
219@item Katsumi Yamaoka
220@item Kenjiro NAKAYAMA
221@item Lars Magne Ingebrigtsen
222@item Leo Liu
223@item Paul Eggert
224@item RĂ¼diger Sonderfeld
225@item Stefan Monnier
226@item Ted Zlatanov
227@end itemize
228
229@node GNU Free Documentation License
230@chapter GNU Free Documentation License
231@include doclicense.texi
232
233@node Key Index
234@unnumbered Key Index
235
236@printindex ky
237
238@node Variable Index
239@unnumbered Variable Index
240
241@printindex vr
242
243@node Lisp Function Index
244@unnumbered Function Index
245
246@printindex fn
247
248@node Concept Index
249@unnumbered Concept Index
250
251@printindex cp
252
253
254@bye
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 376d2a0ad26..6ad0c26f9ac 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -10229,8 +10229,8 @@ summary buffer, point will just move to this article.
10229If given a positive numerical prefix, fetch that many articles back into 10229If given a positive numerical prefix, fetch that many articles back into
10230the ancestry. If given a negative numerical prefix, fetch just that 10230the ancestry. If given a negative numerical prefix, fetch just that
10231ancestor. So if you say @kbd{3 ^}, Gnus will fetch the parent, the 10231ancestor. So if you say @kbd{3 ^}, Gnus will fetch the parent, the
10232grandparent and the grandgrandparent of the current article. If you say 10232grandparent and the great-grandparent of the current article. If you say
10233@kbd{-3 ^}, Gnus will only fetch the grandgrandparent of the current 10233@kbd{-3 ^}, Gnus will only fetch the great-grandparent of the current
10234article. 10234article.
10235 10235
10236@item A R (Summary) 10236@item A R (Summary)
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index a6940781ca7..c4719dcd039 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -591,7 +591,7 @@ slightly from the margin and use only 3 spaces as indentation between
591 591
592Restart Emacs, and re-indent the program we developed in the first part 592Restart Emacs, and re-indent the program we developed in the first part
593of this tutorial with @kbd{C-c h} and @kbd{C-M-\}. You may want to keep 593of this tutorial with @kbd{C-c h} and @kbd{C-M-\}. You may want to keep
594these lines in @file{.emacs}, with values adjusted to your likings. If 594these lines in @file{.emacs}, with values adjusted to your liking. If
595you want to get more information about any of these variables, type, 595you want to get more information about any of these variables, type,
596e.g., @kbd{C-h v idlwave-main-block-indent @key{RET}}. To find which 596e.g., @kbd{C-h v idlwave-main-block-indent @key{RET}}. To find which
597variables can be customized, look for items marked @samp{User Option:} 597variables can be customized, look for items marked @samp{User Option:}
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex
index bfd765dd211..d92fb8a55e0 100644
--- a/doc/misc/texinfo.tex
+++ b/doc/misc/texinfo.tex
@@ -3,7 +3,7 @@
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{2013-09-11.11} 6\def\texinfoversion{2014-01-06.16}
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,
@@ -1138,10 +1138,12 @@ output) for that.)}
1138 1138
1139\ifpdf 1139\ifpdf
1140 % 1140 %
1141 % Color manipulation macros based on pdfcolor.tex, 1141 % Color manipulation macros using ideas from pdfcolor.tex,
1142 % except using rgb instead of cmyk; the latter is said to render as a 1142 % except using rgb instead of cmyk; the latter is said to render as a
1143 % very dark gray on-screen and a very dark halftone in print, instead 1143 % very dark gray on-screen and a very dark halftone in print, instead
1144 % of actual black. 1144 % of actual black. The dark red here is dark enough to print on paper as
1145 % nearly black, but still distinguishable for online viewing. We use
1146 % black by default, though.
1145 \def\rgbDarkRed{0.50 0.09 0.12} 1147 \def\rgbDarkRed{0.50 0.09 0.12}
1146 \def\rgbBlack{0 0 0} 1148 \def\rgbBlack{0 0 0}
1147 % 1149 %
@@ -1251,10 +1253,9 @@ output) for that.)}
1251 % used to mark target names; must be expandable. 1253 % used to mark target names; must be expandable.
1252 \def\pdfmkpgn#1{#1} 1254 \def\pdfmkpgn#1{#1}
1253 % 1255 %
1254 % by default, use a color that is dark enough to print on paper as 1256 % by default, use black for everything.
1255 % nearly black, but still distinguishable for online viewing. 1257 \def\urlcolor{\rgbBlack}
1256 \def\urlcolor{\rgbDarkRed} 1258 \def\linkcolor{\rgbBlack}
1257 \def\linkcolor{\rgbDarkRed}
1258 \def\endlink{\setcolor{\maincolor}\pdfendlink} 1259 \def\endlink{\setcolor{\maincolor}\pdfendlink}
1259 % 1260 %
1260 % Adding outlines to PDF; macros for calculating structure of outlines 1261 % Adding outlines to PDF; macros for calculating structure of outlines
@@ -2574,37 +2575,21 @@ end
2574\let\file=\code 2575\let\file=\code
2575\let\option=\code 2576\let\option=\code
2576 2577
2577% @uref (abbreviation for `urlref') takes an optional (comma-separated) 2578% @uref (abbreviation for `urlref') aka @url takes an optional
2578% second argument specifying the text to display and an optional third 2579% (comma-separated) second argument specifying the text to display and
2579% arg as text to display instead of (rather than in addition to) the url 2580% an optional third arg as text to display instead of (rather than in
2580% itself. First (mandatory) arg is the url. 2581% addition to) the url itself. First (mandatory) arg is the url.
2581% (This \urefnobreak definition isn't used now, leaving it for a while 2582
2582% for comparison.) 2583% TeX-only option to allow changing PDF output to show only the second
2583\def\urefnobreak#1{\dourefnobreak #1,,,\finish} 2584% arg (if given), and not the url (which is then just the link target).
2584\def\dourefnobreak#1,#2,#3,#4\finish{\begingroup 2585\newif\ifurefurlonlylink
2585 \unsepspaces
2586 \pdfurl{#1}%
2587 \setbox0 = \hbox{\ignorespaces #3}%
2588 \ifdim\wd0 > 0pt
2589 \unhbox0 % third arg given, show only that
2590 \else
2591 \setbox0 = \hbox{\ignorespaces #2}%
2592 \ifdim\wd0 > 0pt
2593 \ifpdf
2594 \unhbox0 % PDF: 2nd arg given, show only it
2595 \else
2596 \unhbox0\ (\code{#1})% DVI: 2nd arg given, show both it and url
2597 \fi
2598 \else
2599 \code{#1}% only url given, so show it
2600 \fi
2601 \fi
2602 \endlink
2603\endgroup}
2604 2586
2605% This \urefbreak definition is the active one. 2587% The main macro is \urefbreak, which allows breaking at expected
2588% places within the url. (There used to be another version, which
2589% didn't support automatic breaking.)
2606\def\urefbreak{\begingroup \urefcatcodes \dourefbreak} 2590\def\urefbreak{\begingroup \urefcatcodes \dourefbreak}
2607\let\uref=\urefbreak 2591\let\uref=\urefbreak
2592%
2608\def\dourefbreak#1{\urefbreakfinish #1,,,\finish} 2593\def\dourefbreak#1{\urefbreakfinish #1,,,\finish}
2609\def\urefbreakfinish#1,#2,#3,#4\finish{% doesn't work in @example 2594\def\urefbreakfinish#1,#2,#3,#4\finish{% doesn't work in @example
2610 \unsepspaces 2595 \unsepspaces
@@ -2613,12 +2598,19 @@ end
2613 \ifdim\wd0 > 0pt 2598 \ifdim\wd0 > 0pt
2614 \unhbox0 % third arg given, show only that 2599 \unhbox0 % third arg given, show only that
2615 \else 2600 \else
2616 \setbox0 = \hbox{\ignorespaces #2}% 2601 \setbox0 = \hbox{\ignorespaces #2}% look for second arg
2617 \ifdim\wd0 > 0pt 2602 \ifdim\wd0 > 0pt
2618 \ifpdf 2603 \ifpdf
2619 \unhbox0 % PDF: 2nd arg given, show only it 2604 \ifurefurlonlylink
2605 % PDF plus option to not display url, show just arg
2606 \unhbox0
2607 \else
2608 % PDF, normally display both arg and url for consistency,
2609 % visibility, if the pdf is eventually used to print, etc.
2610 \unhbox0\ (\urefcode{#1})%
2611 \fi
2620 \else 2612 \else
2621 \unhbox0\ (\urefcode{#1})% DVI: 2nd arg given, show both it and url 2613 \unhbox0\ (\urefcode{#1})% DVI, always show arg and url
2622 \fi 2614 \fi
2623 \else 2615 \else
2624 \urefcode{#1}% only url given, so show it 2616 \urefcode{#1}% only url given, so show it
@@ -3691,7 +3683,7 @@ end
3691 \parskip=\smallskipamount 3683 \parskip=\smallskipamount
3692 \ifdim\parskip=0pt \parskip=2pt \fi 3684 \ifdim\parskip=0pt \parskip=2pt \fi
3693 % 3685 %
3694 % Try typesetting the item mark that if the document erroneously says 3686 % Try typesetting the item mark so that if the document erroneously says
3695 % something like @itemize @samp (intending @table), there's an error 3687 % something like @itemize @samp (intending @table), there's an error
3696 % right away at the @itemize. It's not the best error message in the 3688 % right away at the @itemize. It's not the best error message in the
3697 % world, but it's better than leaving it to the @item. This means if 3689 % world, but it's better than leaving it to the @item. This means if
@@ -8342,8 +8334,8 @@ end
8342% 8334%
8343% Auto-number footnotes. Otherwise like plain. 8335% Auto-number footnotes. Otherwise like plain.
8344\gdef\footnote{% 8336\gdef\footnote{%
8345 \let\indent=\ptexindent 8337 %\let\indent=\ptexindent
8346 \let\noindent=\ptexnoindent 8338 %\let\noindent=\ptexnoindent
8347 \global\advance\footnoteno by \@ne 8339 \global\advance\footnoteno by \@ne
8348 \edef\thisfootno{$^{\the\footnoteno}$}% 8340 \edef\thisfootno{$^{\the\footnoteno}$}%
8349 % 8341 %