diff options
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/ChangeLog | 81 | ||||
| -rw-r--r-- | doc/misc/auth.texi | 4 | ||||
| -rw-r--r-- | doc/misc/cl.texi | 12 | ||||
| -rw-r--r-- | doc/misc/dbus.texi | 51 | ||||
| -rw-r--r-- | doc/misc/doclicense.texi | 4 | ||||
| -rw-r--r-- | doc/misc/ediff.texi | 3 | ||||
| -rw-r--r-- | doc/misc/emacs-mime.texi | 6 | ||||
| -rw-r--r-- | doc/misc/gnus-coding.texi | 4 | ||||
| -rw-r--r-- | doc/misc/gnus-faq.texi | 4 | ||||
| -rw-r--r-- | doc/misc/gnus-news.el | 1 | ||||
| -rw-r--r-- | doc/misc/gnus-news.texi | 4 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 675 | ||||
| -rw-r--r-- | doc/misc/message.texi | 38 | ||||
| -rw-r--r-- | doc/misc/org.texi | 1001 | ||||
| -rw-r--r-- | doc/misc/pgg.texi | 4 | ||||
| -rw-r--r-- | doc/misc/sasl.texi | 4 | ||||
| -rw-r--r-- | doc/misc/sieve.texi | 4 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 8 | ||||
| -rw-r--r-- | doc/misc/trampver.texi | 4 |
19 files changed, 786 insertions, 1126 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 67de15fd2f8..29cf98e3330 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,84 @@ | |||
| 1 | 2010-09-09 Michael Albinus <michael.albinus@gmx.de> | ||
| 2 | |||
| 3 | * tramp.texi: Remove Japanese manual. Fix typo. | ||
| 4 | |||
| 5 | * trampver.texi: Update release number. Remove japanesemanual. | ||
| 6 | |||
| 7 | 2010-09-09 Glenn Morris <rgm@gnu.org> | ||
| 8 | |||
| 9 | * org.texi: Restore clobbered changes (copyright years, untabify). | ||
| 10 | |||
| 11 | 2010-09-04 Julien Danjou <julien@danjou.info> (tiny change) | ||
| 12 | |||
| 13 | * gnus.texi (Adaptive Scoring): Fix typo. | ||
| 14 | |||
| 15 | 2010-09-03 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 16 | |||
| 17 | * gnus.texi (Article Display): Document gnus-html-show-images. | ||
| 18 | |||
| 19 | 2010-09-02 Jan Djärv <jan.h.d@swipnet.se> | ||
| 20 | |||
| 21 | * cl.texi (Basic Setf): Remove x-get-cut-buffer and x-get-cutbuffer. | ||
| 22 | |||
| 23 | 2010-09-01 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 24 | |||
| 25 | * gnus.texi (HTML): Document gnus-max-image-proportion. | ||
| 26 | |||
| 27 | 2010-08-31 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 28 | |||
| 29 | * gnus.texi (HTML): Document gnus-blocked-images. | ||
| 30 | |||
| 31 | * message.texi (Wide Reply): Document message-prune-recipient-rules. | ||
| 32 | |||
| 33 | 2010-08-30 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 34 | |||
| 35 | * gnus.texi (Summary Mail Commands): Note that only the addresses from | ||
| 36 | the first message are used for wide replies. | ||
| 37 | (Changing Servers): Remove documentation on gnus-change-server and | ||
| 38 | friends, since it's been removed. | ||
| 39 | |||
| 40 | 2010-08-29 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 41 | |||
| 42 | * gnus.texi (Drafts): Mention B DEL. | ||
| 43 | |||
| 44 | 2010-08-29 Tim Landscheidt <tim@tim-landscheidt.de> (tiny change) | ||
| 45 | |||
| 46 | * gnus.texi (Delayed Articles): Mention that the Date header is the | ||
| 47 | original one, even if you delay. | ||
| 48 | |||
| 49 | 2010-08-29 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 50 | |||
| 51 | * gnus.texi (Asynchronous Fetching): Document | ||
| 52 | gnus-async-post-fetch-function. | ||
| 53 | (HTML): Made into its own section. | ||
| 54 | |||
| 55 | 2010-08-26 Michael Albinus <michael.albinus@gmx.de> | ||
| 56 | |||
| 57 | Sync with Tramp 2.1.19. | ||
| 58 | |||
| 59 | * tramp.texi (Inline methods, Default Method): Mention | ||
| 60 | `tramp-inline-compress-start-size'. Remove "kludgy" phrase. Remove | ||
| 61 | remark about doubled "-t" argument. | ||
| 62 | (Auto-save and Backup): Remove reference to Emacs 21. | ||
| 63 | (Filename Syntax): Describe port numbers. | ||
| 64 | (Frequently Asked Questions): Adapt supported (X)Emacs versions. Adapt | ||
| 65 | supported MS Windows versions. Remove obsolete URL. Recommend "sshx" | ||
| 66 | and "scpx" for echoing shells. Use the $() syntax, texi2dvi reports | ||
| 67 | errors with the backquotes. | ||
| 68 | (External packages): File attributes cache flushing for asynchronous | ||
| 69 | processes. | ||
| 70 | (Traces and Profiles): Describe verbose level 9. | ||
| 71 | |||
| 72 | * trampver.texi: Update release number. | ||
| 73 | |||
| 74 | 2010-08-23 Michael Albinus <michael.albinus@gmx.de> | ||
| 75 | |||
| 76 | * dbus.texi (Alternative Buses): New chapter. | ||
| 77 | |||
| 78 | 2010-08-12 Stefan Monnier <monnier@iro.umontreal.ca> | ||
| 79 | |||
| 80 | * cl.texi (Mapping over Sequences): Rename mapc => cl-mapc. | ||
| 81 | |||
| 1 | 2010-08-09 Jay Belanger <jay.p.belanger@gmail.com> | 82 | 2010-08-09 Jay Belanger <jay.p.belanger@gmail.com> |
| 2 | 83 | ||
| 3 | * calc.texi (Customizing Calc): Rearrange description of new | 84 | * calc.texi (Customizing Calc): Rearrange description of new |
diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi index 85e691d4b62..ed04d98ef92 100644 --- a/doc/misc/auth.texi +++ b/doc/misc/auth.texi | |||
| @@ -286,7 +286,3 @@ users' netrc files. | |||
| 286 | @bye | 286 | @bye |
| 287 | 287 | ||
| 288 | @c End: | 288 | @c End: |
| 289 | |||
| 290 | @ignore | ||
| 291 | arch-tag: 7b835fd3-473f-40fc-9776-1c4e49d26c94 | ||
| 292 | @end ignore | ||
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 755b2f3f1b7..de57ff7d095 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi | |||
| @@ -1043,10 +1043,10 @@ frame-visible-p window-hscroll | |||
| 1043 | frame-width window-point | 1043 | frame-width window-point |
| 1044 | get-register window-start | 1044 | get-register window-start |
| 1045 | getenv window-width | 1045 | getenv window-width |
| 1046 | global-key-binding x-get-cut-buffer | 1046 | global-key-binding x-get-secondary-selection |
| 1047 | keymap-parent x-get-cutbuffer | 1047 | keymap-parent x-get-selection |
| 1048 | local-key-binding x-get-secondary-selection | 1048 | local-key-binding |
| 1049 | mark x-get-selection | 1049 | mark |
| 1050 | mark-marker | 1050 | mark-marker |
| 1051 | @end smallexample | 1051 | @end smallexample |
| 1052 | 1052 | ||
| @@ -3763,10 +3763,10 @@ that it passes in the list pointers themselves rather than the | |||
| 3763 | @code{car}s of the advancing pointers. | 3763 | @code{car}s of the advancing pointers. |
| 3764 | @end defun | 3764 | @end defun |
| 3765 | 3765 | ||
| 3766 | @defun mapc function seq &rest more-seqs | 3766 | @defun cl-mapc function seq &rest more-seqs |
| 3767 | This function is like @code{mapcar*}, except that the values returned | 3767 | This function is like @code{mapcar*}, except that the values returned |
| 3768 | by @var{function} are ignored and thrown away rather than being | 3768 | by @var{function} are ignored and thrown away rather than being |
| 3769 | collected into a list. The return value of @code{mapc} is @var{seq}, | 3769 | collected into a list. The return value of @code{cl-mapc} is @var{seq}, |
| 3770 | the first sequence. This function is more general than the Emacs | 3770 | the first sequence. This function is more general than the Emacs |
| 3771 | primitive @code{mapc}. | 3771 | primitive @code{mapc}. |
| 3772 | @end defun | 3772 | @end defun |
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi index 248884532df..f4f96d55391 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi | |||
| @@ -53,6 +53,7 @@ another. An overview of D-Bus can be found at | |||
| 53 | * Asynchronous Methods:: Calling methods non-blocking. | 53 | * Asynchronous Methods:: Calling methods non-blocking. |
| 54 | * Receiving Method Calls:: Offering own methods. | 54 | * Receiving Method Calls:: Offering own methods. |
| 55 | * Signals:: Sending and receiving signals. | 55 | * Signals:: Sending and receiving signals. |
| 56 | * Alternative Buses:: Alternative buses. | ||
| 56 | * Errors and Events:: Errors and events. | 57 | * Errors and Events:: Errors and events. |
| 57 | * Index:: Index including concepts, functions, variables. | 58 | * Index:: Index including concepts, functions, variables. |
| 58 | 59 | ||
| @@ -1579,6 +1580,56 @@ which objects the GNU/Linux @code{hal} daemon adds. | |||
| 1579 | @end defun | 1580 | @end defun |
| 1580 | 1581 | ||
| 1581 | 1582 | ||
| 1583 | @node Alternative Buses | ||
| 1584 | @chapter Alternative buses. | ||
| 1585 | @cindex bus names | ||
| 1586 | @cindex UNIX domain socket | ||
| 1587 | |||
| 1588 | Until now, we have spoken about the system and the session buses, | ||
| 1589 | which are the default buses to be connected to. However, it is | ||
| 1590 | possible to connect to any bus, from which the address is known. This | ||
| 1591 | is a UNIX domain socket. Everywhere, where a @var{bus} is mentioned | ||
| 1592 | as argument of a function (the symbol @code{:system} or the symbol | ||
| 1593 | @code{:session}), this address can be used instead. The connection to | ||
| 1594 | this bus must be initialized first. | ||
| 1595 | |||
| 1596 | @defun dbus-init-bus bus | ||
| 1597 | Establish the connection to D-Bus @var{bus}. | ||
| 1598 | |||
| 1599 | @var{bus} can be either the symbol @code{:system} or the symbol | ||
| 1600 | @code{:session}, or it can be a string denoting the address of the | ||
| 1601 | corresponding bus. For the system and session busses, this function | ||
| 1602 | is called when loading @file{dbus.el}, there is no need to call it | ||
| 1603 | again. | ||
| 1604 | |||
| 1605 | Example: You open another session bus in a terminal window on your host: | ||
| 1606 | |||
| 1607 | @example | ||
| 1608 | # eval `dbus-launch --auto-syntax` | ||
| 1609 | # echo $DBUS_SESSION_BUS_ADDRESS | ||
| 1610 | |||
| 1611 | @print{} unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e | ||
| 1612 | @end example | ||
| 1613 | |||
| 1614 | In Emacs, you can access to this bus via its address: | ||
| 1615 | |||
| 1616 | @lisp | ||
| 1617 | (setq my-bus | ||
| 1618 | "unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e") | ||
| 1619 | |||
| 1620 | @result{} "unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e" | ||
| 1621 | |||
| 1622 | (dbus-init-bus my-bus) | ||
| 1623 | |||
| 1624 | @result{} nil | ||
| 1625 | |||
| 1626 | (dbus-get-unique-name my-bus) | ||
| 1627 | |||
| 1628 | @result{} ":1.0" | ||
| 1629 | @end lisp | ||
| 1630 | @end defun | ||
| 1631 | |||
| 1632 | |||
| 1582 | @node Errors and Events | 1633 | @node Errors and Events |
| 1583 | @chapter Errors and events. | 1634 | @chapter Errors and events. |
| 1584 | @cindex debugging | 1635 | @cindex debugging |
diff --git a/doc/misc/doclicense.texi b/doc/misc/doclicense.texi index d3ae2f92b20..a511ffcd5a8 100644 --- a/doc/misc/doclicense.texi +++ b/doc/misc/doclicense.texi | |||
| @@ -505,7 +505,3 @@ to permit their use in free software. | |||
| 505 | @c Local Variables: | 505 | @c Local Variables: |
| 506 | @c ispell-local-pdict: "ispell-dict" | 506 | @c ispell-local-pdict: "ispell-dict" |
| 507 | @c End: | 507 | @c End: |
| 508 | |||
| 509 | @ignore | ||
| 510 | arch-tag: c1679162-1d8a-4f02-bc52-2e71765f0165 | ||
| 511 | @end ignore | ||
diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi index 4259fccb390..451d6d0a5ff 100644 --- a/doc/misc/ediff.texi +++ b/doc/misc/ediff.texi | |||
| @@ -1986,8 +1986,7 @@ If it is @code{combined} then the region in buffer C will look like | |||
| 1986 | this: | 1986 | this: |
| 1987 | 1987 | ||
| 1988 | @comment Use @set to avoid triggering merge conflict detectors like CVS. | 1988 | @comment Use @set to avoid triggering merge conflict detectors like CVS. |
| 1989 | @set seven-left <<<<<<< | 1989 | @set seven-left |
| 1990 | @set seven-right >>>>>>> | ||
| 1991 | @example | 1990 | @example |
| 1992 | @value{seven-left} variant A | 1991 | @value{seven-left} variant A |
| 1993 | the difference region from buffer A | 1992 | the difference region from buffer A |
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi index 713a55c7cc7..3e996e945fb 100644 --- a/doc/misc/emacs-mime.texi +++ b/doc/misc/emacs-mime.texi | |||
| @@ -394,7 +394,7 @@ variable will cause @samp{text/html} parts to be treated as attachments. | |||
| 394 | @item mm-text-html-renderer | 394 | @item mm-text-html-renderer |
| 395 | @vindex mm-text-html-renderer | 395 | @vindex mm-text-html-renderer |
| 396 | This selects the function used to render @acronym{HTML}. The predefined | 396 | This selects the function used to render @acronym{HTML}. The predefined |
| 397 | renderers are selected by the symbols @code{w3}, | 397 | renderers are selected by the symbols @code{gnus-article-html}, @code{w3}, |
| 398 | @code{w3m}@footnote{See @uref{http://emacs-w3m.namazu.org/} for more | 398 | @code{w3m}@footnote{See @uref{http://emacs-w3m.namazu.org/} for more |
| 399 | information about emacs-w3m}, @code{links}, @code{lynx}, | 399 | information about emacs-w3m}, @code{links}, @code{lynx}, |
| 400 | @code{w3m-standalone} or @code{html2text}. If @code{nil} use an | 400 | @code{w3m-standalone} or @code{html2text}. If @code{nil} use an |
| @@ -1889,7 +1889,3 @@ Documentation of the text/plain format parameter for flowed text. | |||
| 1889 | @c mode: texinfo | 1889 | @c mode: texinfo |
| 1890 | @c coding: iso-8859-1 | 1890 | @c coding: iso-8859-1 |
| 1891 | @c End: | 1891 | @c End: |
| 1892 | |||
| 1893 | @ignore | ||
| 1894 | arch-tag: c7ef2fd0-a91c-4e10-aa52-c1a2b11b1a8d | ||
| 1895 | @end ignore | ||
diff --git a/doc/misc/gnus-coding.texi b/doc/misc/gnus-coding.texi index fd637ece6a8..22b74c900b0 100644 --- a/doc/misc/gnus-coding.texi +++ b/doc/misc/gnus-coding.texi | |||
| @@ -387,7 +387,3 @@ changed. | |||
| 387 | @c mode: texinfo | 387 | @c mode: texinfo |
| 388 | @c coding: iso-8859-1 | 388 | @c coding: iso-8859-1 |
| 389 | @c End: | 389 | @c End: |
| 390 | |||
| 391 | @ignore | ||
| 392 | arch-tag: ab15234c-2c8a-4cbd-8111-1811bcc6f931 | ||
| 393 | @end ignore | ||
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index 78a22740e32..ed74092eb0a 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi | |||
| @@ -2331,7 +2331,3 @@ NUA is an acronym for News User Agent, it's the program you | |||
| 2331 | use to read and write Usenet news. | 2331 | use to read and write Usenet news. |
| 2332 | 2332 | ||
| 2333 | @end table | 2333 | @end table |
| 2334 | |||
| 2335 | @ignore | ||
| 2336 | arch-tag: 64dc5692-edb4-4848-a965-7aa0181acbb8 | ||
| 2337 | @end ignore | ||
diff --git a/doc/misc/gnus-news.el b/doc/misc/gnus-news.el index 49a170800ac..e31cca9f37f 100644 --- a/doc/misc/gnus-news.el +++ b/doc/misc/gnus-news.el | |||
| @@ -113,5 +113,4 @@ paragraph-separate: \"[ ]*$\"\nend:\n") | |||
| 113 | (insert gnus-news-trailer) | 113 | (insert gnus-news-trailer) |
| 114 | (write-region (point-min) (point-max) outfile)))) | 114 | (write-region (point-min) (point-max) outfile)))) |
| 115 | 115 | ||
| 116 | ;; arch-tag: e23cdd27-eafd-4ba0-816f-98f5edb0dc29 | ||
| 117 | ;;; gnus-news.el ends here | 116 | ;;; gnus-news.el ends here |
diff --git a/doc/misc/gnus-news.texi b/doc/misc/gnus-news.texi index 29246313c84..e820ceae4a8 100644 --- a/doc/misc/gnus-news.texi +++ b/doc/misc/gnus-news.texi | |||
| @@ -325,7 +325,3 @@ moving articles to a group that has not turned auto-expire on. | |||
| 325 | @end itemize | 325 | @end itemize |
| 326 | 326 | ||
| 327 | @c gnus-news.texi ends here. | 327 | @c gnus-news.texi ends here. |
| 328 | |||
| 329 | @ignore | ||
| 330 | arch-tag: 872c7569-4340-4d73-9d1d-7826d9f94a51 | ||
| 331 | @end ignore | ||
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index c3a7058289d..7248897f05b 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -632,7 +632,7 @@ Select Methods | |||
| 632 | * Getting Mail:: Reading your personal mail with Gnus. | 632 | * Getting Mail:: Reading your personal mail with Gnus. |
| 633 | * Browsing the Web:: Getting messages from a plethora of Web sources. | 633 | * Browsing the Web:: Getting messages from a plethora of Web sources. |
| 634 | * IMAP:: Using Gnus as a @acronym{IMAP} client. | 634 | * IMAP:: Using Gnus as a @acronym{IMAP} client. |
| 635 | * Other Sources:: Reading directories, files, SOUP packets. | 635 | * Other Sources:: Reading directories, files. |
| 636 | * Combined Groups:: Combining groups into one group. | 636 | * Combined Groups:: Combining groups into one group. |
| 637 | * Email Based Diary:: Using mails to manage diary events in Gnus. | 637 | * Email Based Diary:: Using mails to manage diary events in Gnus. |
| 638 | * Gnus Unplugged:: Reading news and mail offline. | 638 | * Gnus Unplugged:: Reading news and mail offline. |
| @@ -695,9 +695,6 @@ Browsing the Web | |||
| 695 | 695 | ||
| 696 | * Archiving Mail:: | 696 | * Archiving Mail:: |
| 697 | * Web Searches:: Creating groups from articles that match a string. | 697 | * Web Searches:: Creating groups from articles that match a string. |
| 698 | * Slashdot:: Reading the Slashdot comments. | ||
| 699 | * Ultimate:: The Ultimate Bulletin Board systems. | ||
| 700 | * Web Archive:: Reading mailing list archived on web. | ||
| 701 | * RSS:: Reading RDF site summary. | 698 | * RSS:: Reading RDF site summary. |
| 702 | * Customizing W3:: Doing stuff to Emacs/W3 from Gnus. | 699 | * Customizing W3:: Doing stuff to Emacs/W3 from Gnus. |
| 703 | 700 | ||
| @@ -715,23 +712,15 @@ Other Sources | |||
| 715 | * Directory Groups:: You can read a directory as if it was a newsgroup. | 712 | * Directory Groups:: You can read a directory as if it was a newsgroup. |
| 716 | * Anything Groups:: Dired? Who needs dired? | 713 | * Anything Groups:: Dired? Who needs dired? |
| 717 | * Document Groups:: Single files can be the basis of a group. | 714 | * Document Groups:: Single files can be the basis of a group. |
| 718 | * SOUP:: Reading @sc{soup} packets ``offline''. | ||
| 719 | * Mail-To-News Gateways:: Posting articles via mail-to-news gateways. | 715 | * Mail-To-News Gateways:: Posting articles via mail-to-news gateways. |
| 720 | 716 | ||
| 721 | Document Groups | 717 | Document Groups |
| 722 | 718 | ||
| 723 | * Document Server Internals:: How to add your own document types. | 719 | * Document Server Internals:: How to add your own document types. |
| 724 | 720 | ||
| 725 | SOUP | ||
| 726 | |||
| 727 | * SOUP Commands:: Commands for creating and sending @sc{soup} packets | ||
| 728 | * SOUP Groups:: A back end for reading @sc{soup} packets. | ||
| 729 | * SOUP Replies:: How to enable @code{nnsoup} to take over mail and news. | ||
| 730 | |||
| 731 | Combined Groups | 721 | Combined Groups |
| 732 | 722 | ||
| 733 | * Virtual Groups:: Combining articles from many groups. | 723 | * Virtual Groups:: Combining articles from many groups. |
| 734 | * Kibozed Groups:: Looking through parts of the newsfeed for articles. | ||
| 735 | 724 | ||
| 736 | Email Based Diary | 725 | Email Based Diary |
| 737 | 726 | ||
| @@ -1295,7 +1284,7 @@ parameter (@pxref{Topic Parameters}). For instance, a @code{subscribe} | |||
| 1295 | topic parameter that looks like | 1284 | topic parameter that looks like |
| 1296 | 1285 | ||
| 1297 | @example | 1286 | @example |
| 1298 | "nnslashdot" | 1287 | "nnml" |
| 1299 | @end example | 1288 | @end example |
| 1300 | 1289 | ||
| 1301 | will mean that all groups that match that regex will be subscribed under | 1290 | will mean that all groups that match that regex will be subscribed under |
| @@ -1385,31 +1374,11 @@ you have read is by keeping track of article numbers. So when you | |||
| 1385 | change @code{gnus-select-method}, your @file{.newsrc} file becomes | 1374 | change @code{gnus-select-method}, your @file{.newsrc} file becomes |
| 1386 | worthless. | 1375 | worthless. |
| 1387 | 1376 | ||
| 1388 | Gnus provides a few functions to attempt to translate a @file{.newsrc} | ||
| 1389 | file from one server to another. They all have one thing in | ||
| 1390 | common---they take a looong time to run. You don't want to use these | ||
| 1391 | functions more than absolutely necessary. | ||
| 1392 | |||
| 1393 | @kindex M-x gnus-change-server | ||
| 1394 | @findex gnus-change-server | ||
| 1395 | If you have access to both servers, Gnus can request the headers for all | ||
| 1396 | the articles you have read and compare @code{Message-ID}s and map the | ||
| 1397 | article numbers of the read articles and article marks. The @kbd{M-x | ||
| 1398 | gnus-change-server} command will do this for all your native groups. It | ||
| 1399 | will prompt for the method you want to move to. | ||
| 1400 | |||
| 1401 | @kindex M-x gnus-group-move-group-to-server | ||
| 1402 | @findex gnus-group-move-group-to-server | ||
| 1403 | You can also move individual groups with the @kbd{M-x | ||
| 1404 | gnus-group-move-group-to-server} command. This is useful if you want to | ||
| 1405 | move a (foreign) group from one server to another. | ||
| 1406 | |||
| 1407 | @kindex M-x gnus-group-clear-data-on-native-groups | 1377 | @kindex M-x gnus-group-clear-data-on-native-groups |
| 1408 | @findex gnus-group-clear-data-on-native-groups | 1378 | @findex gnus-group-clear-data-on-native-groups |
| 1409 | If you don't have access to both the old and new server, all your marks | 1379 | You can use the @kbd{M-x gnus-group-clear-data-on-native-groups} |
| 1410 | and read ranges have become worthless. You can use the @kbd{M-x | 1380 | command to clear out all data that you have on your native groups. |
| 1411 | gnus-group-clear-data-on-native-groups} command to clear out all data | 1381 | Use with caution. |
| 1412 | that you have on your native groups. Use with caution. | ||
| 1413 | 1382 | ||
| 1414 | @kindex M-x gnus-group-clear-data | 1383 | @kindex M-x gnus-group-clear-data |
| 1415 | @findex gnus-group-clear-data | 1384 | @findex gnus-group-clear-data |
| @@ -2654,15 +2623,6 @@ default a group pointing to the most recent articles will be created | |||
| 2654 | (@code{gnus-group-recent-archive-directory}), but given a prefix, a full | 2623 | (@code{gnus-group-recent-archive-directory}), but given a prefix, a full |
| 2655 | group will be created from @code{gnus-group-archive-directory}. | 2624 | group will be created from @code{gnus-group-archive-directory}. |
| 2656 | 2625 | ||
| 2657 | @item G k | ||
| 2658 | @kindex G k (Group) | ||
| 2659 | @findex gnus-group-make-kiboze-group | ||
| 2660 | @cindex nnkiboze | ||
| 2661 | Make a kiboze group. You will be prompted for a name, for a regexp to | ||
| 2662 | match groups to be ``included'' in the kiboze group, and a series of | ||
| 2663 | strings to match on headers (@code{gnus-group-make-kiboze-group}). | ||
| 2664 | @xref{Kibozed Groups}. | ||
| 2665 | |||
| 2666 | @item G D | 2626 | @item G D |
| 2667 | @kindex G D (Group) | 2627 | @kindex G D (Group) |
| 2668 | @findex gnus-group-enter-directory | 2628 | @findex gnus-group-enter-directory |
| @@ -4450,8 +4410,7 @@ which point to the ``real'' message files (if mbox is used, copies are | |||
| 4450 | made). Since mairix already presents search results in such a virtual | 4410 | made). Since mairix already presents search results in such a virtual |
| 4451 | mail folder, it is very well suited for using it as an external program | 4411 | mail folder, it is very well suited for using it as an external program |
| 4452 | for creating @emph{smart} mail folders, which represent certain mail | 4412 | for creating @emph{smart} mail folders, which represent certain mail |
| 4453 | searches. This is similar to a Kiboze group (@pxref{Kibozed Groups}), | 4413 | searches. |
| 4454 | but much faster. | ||
| 4455 | 4414 | ||
| 4456 | @node nnmairix requirements | 4415 | @node nnmairix requirements |
| 4457 | @subsubsection nnmairix requirements | 4416 | @subsubsection nnmairix requirements |
| @@ -6043,6 +6002,11 @@ threads. | |||
| 6043 | This variable can also be a number. In that case, center the window at | 6002 | This variable can also be a number. In that case, center the window at |
| 6044 | the given number of lines from the top. | 6003 | the given number of lines from the top. |
| 6045 | 6004 | ||
| 6005 | @item gnus-summary-stop-at-end-of-message | ||
| 6006 | @vindex gnus-summary-stop-at-end-of-message | ||
| 6007 | If non-@code{nil}, don't go to the next article when hitting | ||
| 6008 | @kbd{SPC}, and you're at the end of the article. | ||
| 6009 | |||
| 6046 | @end table | 6010 | @end table |
| 6047 | 6011 | ||
| 6048 | 6012 | ||
| @@ -6350,7 +6314,8 @@ present, that's used instead. | |||
| 6350 | @findex gnus-summary-wide-reply-with-original | 6314 | @findex gnus-summary-wide-reply-with-original |
| 6351 | Mail a wide reply to the current article and include the original | 6315 | Mail a wide reply to the current article and include the original |
| 6352 | message (@code{gnus-summary-wide-reply-with-original}). This command uses | 6316 | message (@code{gnus-summary-wide-reply-with-original}). This command uses |
| 6353 | the process/prefix convention. | 6317 | the process/prefix convention, but only uses the headers from the |
| 6318 | first article to determine the recipients. | ||
| 6354 | 6319 | ||
| 6355 | @item S v | 6320 | @item S v |
| 6356 | @kindex S v (Summary) | 6321 | @kindex S v (Summary) |
| @@ -6414,8 +6379,6 @@ the posting style of the current group. If given a prefix, disable that. | |||
| 6414 | If the prefix is 1, prompt for a group name to find the posting style. | 6379 | If the prefix is 1, prompt for a group name to find the posting style. |
| 6415 | 6380 | ||
| 6416 | @item S i | 6381 | @item S i |
| 6417 | @itemx i | ||
| 6418 | @kindex i (Summary) | ||
| 6419 | @kindex S i (Summary) | 6382 | @kindex S i (Summary) |
| 6420 | @findex gnus-summary-news-other-window | 6383 | @findex gnus-summary-news-other-window |
| 6421 | Prepare a news (@code{gnus-summary-news-other-window}). By default, | 6384 | Prepare a news (@code{gnus-summary-news-other-window}). By default, |
| @@ -6753,6 +6716,12 @@ Presumably, you want to use the demon for sending due delayed articles. | |||
| 6753 | Just don't forget to set that up :-) | 6716 | Just don't forget to set that up :-) |
| 6754 | @end table | 6717 | @end table |
| 6755 | 6718 | ||
| 6719 | When delaying an article with @kbd{C-c C-j}, Message mode will | ||
| 6720 | automatically add a @code{"Date"} header with the current time. In | ||
| 6721 | many cases you probably want the @code{"Date"} header to reflect the | ||
| 6722 | time the message is sent instead. To do this, you have to delete | ||
| 6723 | @code{Date} from @code{message-draft-headers}. | ||
| 6724 | |||
| 6756 | 6725 | ||
| 6757 | @node Marking Articles | 6726 | @node Marking Articles |
| 6758 | @section Marking Articles | 6727 | @section Marking Articles |
| @@ -6861,10 +6830,6 @@ Marked as read by a catchup (@code{gnus-catchup-mark}). | |||
| 6861 | @vindex gnus-canceled-mark | 6830 | @vindex gnus-canceled-mark |
| 6862 | Canceled article (@code{gnus-canceled-mark}) | 6831 | Canceled article (@code{gnus-canceled-mark}) |
| 6863 | 6832 | ||
| 6864 | @item F | ||
| 6865 | @vindex gnus-souped-mark | ||
| 6866 | @sc{soup}ed article (@code{gnus-souped-mark}). @xref{SOUP}. | ||
| 6867 | |||
| 6868 | @item Q | 6833 | @item Q |
| 6869 | @vindex gnus-sparse-mark | 6834 | @vindex gnus-sparse-mark |
| 6870 | Sparsely reffed article (@code{gnus-sparse-mark}). @xref{Customizing | 6835 | Sparsely reffed article (@code{gnus-sparse-mark}). @xref{Customizing |
| @@ -7835,7 +7800,7 @@ This is a rather obscure variable that few will find useful. It's | |||
| 7835 | intended for those non-news newsgroups where the back end has to fetch | 7800 | intended for those non-news newsgroups where the back end has to fetch |
| 7836 | quite a lot to present the summary buffer, and where it's impossible to | 7801 | quite a lot to present the summary buffer, and where it's impossible to |
| 7837 | go back to parents of articles. This is mostly the case in the | 7802 | go back to parents of articles. This is mostly the case in the |
| 7838 | web-based groups, like the @code{nnultimate} groups. | 7803 | web-based groups. |
| 7839 | 7804 | ||
| 7840 | If you don't use those, then it's safe to leave this as the default | 7805 | If you don't use those, then it's safe to leave this as the default |
| 7841 | @code{nil}. If you want to use this variable, it should be a regexp | 7806 | @code{nil}. If you want to use this variable, it should be a regexp |
| @@ -8271,6 +8236,16 @@ These functions will be called many, many times, so they should | |||
| 8271 | preferably be short and sweet to avoid slowing down Gnus too much. | 8236 | preferably be short and sweet to avoid slowing down Gnus too much. |
| 8272 | It's probably a good idea to byte-compile things like this. | 8237 | It's probably a good idea to byte-compile things like this. |
| 8273 | 8238 | ||
| 8239 | @vindex gnus-async-post-fetch-function | ||
| 8240 | @findex gnus-html-prefetch-images | ||
| 8241 | After an article has been prefetched, this | ||
| 8242 | @code{gnus-async-post-fetch-function} will be called. The buffer will | ||
| 8243 | be narrowed to the region of the article that was fetched. A useful | ||
| 8244 | value would be @code{gnus-html-prefetch-images}, which will prefetch | ||
| 8245 | and store images referenced in the article, so that you don't have to | ||
| 8246 | wait for them to be fetched when you read the article. This is useful | ||
| 8247 | for @acronym{HTML} messages that have external images. | ||
| 8248 | |||
| 8274 | @vindex gnus-prefetched-article-deletion-strategy | 8249 | @vindex gnus-prefetched-article-deletion-strategy |
| 8275 | Articles have to be removed from the asynch buffer sooner or later. The | 8250 | Articles have to be removed from the asynch buffer sooner or later. The |
| 8276 | @code{gnus-prefetched-article-deletion-strategy} says when to remove | 8251 | @code{gnus-prefetched-article-deletion-strategy} says when to remove |
| @@ -10376,6 +10351,14 @@ Piconify all news headers (i. e., @code{Newsgroups} and | |||
| 10376 | Remove all images from the article buffer | 10351 | Remove all images from the article buffer |
| 10377 | (@code{gnus-article-remove-images}). | 10352 | (@code{gnus-article-remove-images}). |
| 10378 | 10353 | ||
| 10354 | @item W D W | ||
| 10355 | @kindex W D W (Summary) | ||
| 10356 | @findex gnus-html-show-images | ||
| 10357 | If you're reading an @acronym{HTML} article rendered with | ||
| 10358 | @code{gnus-article-html}, then you can insert any blocked images in | ||
| 10359 | the buffer with this command. | ||
| 10360 | (@code{gnus-html-show-images}). | ||
| 10361 | |||
| 10379 | @end table | 10362 | @end table |
| 10380 | 10363 | ||
| 10381 | 10364 | ||
| @@ -12186,6 +12169,7 @@ tell Gnus otherwise. | |||
| 12186 | @menu | 12169 | @menu |
| 12187 | * Hiding Headers:: Deciding what headers should be displayed. | 12170 | * Hiding Headers:: Deciding what headers should be displayed. |
| 12188 | * Using MIME:: Pushing articles through @acronym{MIME} before reading them. | 12171 | * Using MIME:: Pushing articles through @acronym{MIME} before reading them. |
| 12172 | * HTML:: Reading @acronym{HTML} messages. | ||
| 12189 | * Customizing Articles:: Tailoring the look of the articles. | 12173 | * Customizing Articles:: Tailoring the look of the articles. |
| 12190 | * Article Keymap:: Keystrokes available in the article buffer. | 12174 | * Article Keymap:: Keystrokes available in the article buffer. |
| 12191 | * Misc Article:: Other stuff. | 12175 | * Misc Article:: Other stuff. |
| @@ -12482,6 +12466,68 @@ Any similarity to real events and people is purely coincidental. Ahem. | |||
| 12482 | Also @pxref{MIME Commands}. | 12466 | Also @pxref{MIME Commands}. |
| 12483 | 12467 | ||
| 12484 | 12468 | ||
| 12469 | @node HTML | ||
| 12470 | @section @acronym{HTML} | ||
| 12471 | @cindex @acronym{HTML} | ||
| 12472 | |||
| 12473 | If you have @code{w3m} installed on your system, Gnus can display | ||
| 12474 | @acronym{HTML} articles in the article buffer. There are many Gnus | ||
| 12475 | add-ons for doing this, using various approaches, but there's one | ||
| 12476 | (sort of) built-in method that's used by default. | ||
| 12477 | |||
| 12478 | For a complete overview, consult @xref{Display Customization, | ||
| 12479 | ,Display Customization, emacs-mime, The Emacs MIME Manual}. This | ||
| 12480 | section only describes the default method. | ||
| 12481 | |||
| 12482 | @table @code | ||
| 12483 | @item mm-text-html-renderer | ||
| 12484 | @vindex mm-text-html-renderer | ||
| 12485 | If set to @code{gnus-article-html}, Gnus will use the built-in method, | ||
| 12486 | that's based on @code{curl} and @code{w3m}. | ||
| 12487 | |||
| 12488 | @item gnus-blocked-images | ||
| 12489 | @vindex gnus-blocked-images | ||
| 12490 | Images that have @acronym{URL}s that match this regexp won't be | ||
| 12491 | fetched and displayed. For instance, do block all @acronym{URL}s that | ||
| 12492 | have the string ``ads'' in them, do the following: | ||
| 12493 | |||
| 12494 | @lisp | ||
| 12495 | (setq gnus-blocked-images "ads") | ||
| 12496 | @end lisp | ||
| 12497 | |||
| 12498 | The default is to block all external images. | ||
| 12499 | |||
| 12500 | @item gnus-html-cache-directory | ||
| 12501 | @vindex gnus-html-cache-directory | ||
| 12502 | Gnus will download and cache images according to how | ||
| 12503 | @code{gnus-blocked-images} is set. These images will be stored in | ||
| 12504 | this directory. | ||
| 12505 | |||
| 12506 | @item gnus-html-cache-size | ||
| 12507 | @vindex gnus-html-cache-size | ||
| 12508 | When @code{gnus-html-cache-size} bytes have been used in that | ||
| 12509 | directory, the oldest files will be deleted. The default is 500MB. | ||
| 12510 | |||
| 12511 | @item gnus-html-frame-width | ||
| 12512 | @vindex gnus-html-frame-width | ||
| 12513 | The width to use when rendering HTML. The default is 70. | ||
| 12514 | |||
| 12515 | @item gnus-max-image-proportion | ||
| 12516 | @vindex gnus-max-image-proportion | ||
| 12517 | How big pictures displayed are in relation to the window they're in. | ||
| 12518 | A value of 0.7 (the default) means that they are allowed to take up | ||
| 12519 | 70% of the width and height of the window. If they are larger than | ||
| 12520 | this, and Emacs supports it, then the images will be rescaled down to | ||
| 12521 | fit these criteria. | ||
| 12522 | |||
| 12523 | @end table | ||
| 12524 | |||
| 12525 | To use this, make sure that you have @code{w3m} and @code{curl} | ||
| 12526 | installed. If you have, then Gnus should display @acronym{HTML} | ||
| 12527 | automatically. | ||
| 12528 | |||
| 12529 | |||
| 12530 | |||
| 12485 | @node Customizing Articles | 12531 | @node Customizing Articles |
| 12486 | @section Customizing Articles | 12532 | @section Customizing Articles |
| 12487 | @cindex article customization | 12533 | @cindex article customization |
| @@ -13559,6 +13605,9 @@ If you have some messages that you wish not to send, you can use the | |||
| 13559 | @kbd{D t} (@code{gnus-draft-toggle-sending}) command to mark the message | 13605 | @kbd{D t} (@code{gnus-draft-toggle-sending}) command to mark the message |
| 13560 | as unsendable. This is a toggling command. | 13606 | as unsendable. This is a toggling command. |
| 13561 | 13607 | ||
| 13608 | Finally, if you want to delete a draft, use the normal @kbd{B DEL} | ||
| 13609 | command (@pxref{Mail Group Commands}). | ||
| 13610 | |||
| 13562 | 13611 | ||
| 13563 | @node Rejected Articles | 13612 | @node Rejected Articles |
| 13564 | @section Rejected Articles | 13613 | @section Rejected Articles |
| @@ -13689,7 +13738,7 @@ The different methods all have their peculiarities, of course. | |||
| 13689 | * Getting Mail:: Reading your personal mail with Gnus. | 13738 | * Getting Mail:: Reading your personal mail with Gnus. |
| 13690 | * Browsing the Web:: Getting messages from a plethora of Web sources. | 13739 | * Browsing the Web:: Getting messages from a plethora of Web sources. |
| 13691 | * IMAP:: Using Gnus as a @acronym{IMAP} client. | 13740 | * IMAP:: Using Gnus as a @acronym{IMAP} client. |
| 13692 | * Other Sources:: Reading directories, files, SOUP packets. | 13741 | * Other Sources:: Reading directories, files. |
| 13693 | * Combined Groups:: Combining groups into one group. | 13742 | * Combined Groups:: Combining groups into one group. |
| 13694 | * Email Based Diary:: Using mails to manage diary events in Gnus. | 13743 | * Email Based Diary:: Using mails to manage diary events in Gnus. |
| 13695 | * Gnus Unplugged:: Reading news and mail offline. | 13744 | * Gnus Unplugged:: Reading news and mail offline. |
| @@ -17350,9 +17399,6 @@ interfaces to these sources. | |||
| 17350 | @menu | 17399 | @menu |
| 17351 | * Archiving Mail:: | 17400 | * Archiving Mail:: |
| 17352 | * Web Searches:: Creating groups from articles that match a string. | 17401 | * Web Searches:: Creating groups from articles that match a string. |
| 17353 | * Slashdot:: Reading the Slashdot comments. | ||
| 17354 | * Ultimate:: The Ultimate Bulletin Board systems. | ||
| 17355 | * Web Archive:: Reading mailing list archived on web. | ||
| 17356 | * RSS:: Reading RDF site summary. | 17402 | * RSS:: Reading RDF site summary. |
| 17357 | * Customizing W3:: Doing stuff to Emacs/W3 from Gnus. | 17403 | * Customizing W3:: Doing stuff to Emacs/W3 from Gnus. |
| 17358 | @end menu | 17404 | @end menu |
| @@ -17495,159 +17541,6 @@ Format string URL to fetch an article by @code{Message-ID}. | |||
| 17495 | @end table | 17541 | @end table |
| 17496 | 17542 | ||
| 17497 | 17543 | ||
| 17498 | @node Slashdot | ||
| 17499 | @subsection Slashdot | ||
| 17500 | @cindex Slashdot | ||
| 17501 | @cindex nnslashdot | ||
| 17502 | |||
| 17503 | @uref{http://slashdot.org/, Slashdot} is a popular news site, with | ||
| 17504 | lively discussion following the news articles. @code{nnslashdot} will | ||
| 17505 | let you read this forum in a convenient manner. | ||
| 17506 | |||
| 17507 | The easiest way to read this source is to put something like the | ||
| 17508 | following in your @file{~/.gnus.el} file: | ||
| 17509 | |||
| 17510 | @lisp | ||
| 17511 | (setq gnus-secondary-select-methods | ||
| 17512 | '((nnslashdot ""))) | ||
| 17513 | @end lisp | ||
| 17514 | |||
| 17515 | This will make Gnus query the @code{nnslashdot} back end for new comments | ||
| 17516 | and groups. The @kbd{F} command will subscribe each new news article as | ||
| 17517 | a new Gnus group, and you can read the comments by entering these | ||
| 17518 | groups. (Note that the default subscription method is to subscribe new | ||
| 17519 | groups as zombies. Other methods are available (@pxref{Subscription | ||
| 17520 | Methods}). | ||
| 17521 | |||
| 17522 | If you want to remove an old @code{nnslashdot} group, the @kbd{G DEL} | ||
| 17523 | command is the most handy tool (@pxref{Foreign Groups}). | ||
| 17524 | |||
| 17525 | When following up to @code{nnslashdot} comments (or posting new | ||
| 17526 | comments), some light @acronym{HTML}izations will be performed. In | ||
| 17527 | particular, text quoted with @samp{> } will be quoted with | ||
| 17528 | @samp{blockquote} instead, and signatures will have @samp{br} added to | ||
| 17529 | the end of each line. Other than that, you can just write @acronym{HTML} | ||
| 17530 | directly into the message buffer. Note that Slashdot filters out some | ||
| 17531 | @acronym{HTML} forms. | ||
| 17532 | |||
| 17533 | The following variables can be altered to change its behavior: | ||
| 17534 | |||
| 17535 | @table @code | ||
| 17536 | @item nnslashdot-threaded | ||
| 17537 | Whether @code{nnslashdot} should display threaded groups or not. The | ||
| 17538 | default is @code{t}. To be able to display threads, @code{nnslashdot} | ||
| 17539 | has to retrieve absolutely all comments in a group upon entry. If a | ||
| 17540 | threaded display is not required, @code{nnslashdot} will only retrieve | ||
| 17541 | the comments that are actually wanted by the user. Threading is nicer, | ||
| 17542 | but much, much slower than unthreaded. | ||
| 17543 | |||
| 17544 | @item nnslashdot-login-name | ||
| 17545 | @vindex nnslashdot-login-name | ||
| 17546 | The login name to use when posting. | ||
| 17547 | |||
| 17548 | @item nnslashdot-password | ||
| 17549 | @vindex nnslashdot-password | ||
| 17550 | The password to use when posting. | ||
| 17551 | |||
| 17552 | @item nnslashdot-directory | ||
| 17553 | @vindex nnslashdot-directory | ||
| 17554 | Where @code{nnslashdot} will store its files. The default is | ||
| 17555 | @file{~/News/slashdot/}. | ||
| 17556 | |||
| 17557 | @item nnslashdot-active-url | ||
| 17558 | @vindex nnslashdot-active-url | ||
| 17559 | The @acronym{URL} format string that will be used to fetch the | ||
| 17560 | information on news articles and comments. The default is@* | ||
| 17561 | @samp{http://slashdot.org/search.pl?section=&min=%d}. | ||
| 17562 | |||
| 17563 | @item nnslashdot-comments-url | ||
| 17564 | @vindex nnslashdot-comments-url | ||
| 17565 | The @acronym{URL} format string that will be used to fetch comments. | ||
| 17566 | |||
| 17567 | @item nnslashdot-article-url | ||
| 17568 | @vindex nnslashdot-article-url | ||
| 17569 | The @acronym{URL} format string that will be used to fetch the news | ||
| 17570 | article. The default is | ||
| 17571 | @samp{http://slashdot.org/article.pl?sid=%s&mode=nocomment}. | ||
| 17572 | |||
| 17573 | @item nnslashdot-threshold | ||
| 17574 | @vindex nnslashdot-threshold | ||
| 17575 | The score threshold. The default is -1. | ||
| 17576 | |||
| 17577 | @item nnslashdot-group-number | ||
| 17578 | @vindex nnslashdot-group-number | ||
| 17579 | The number of old groups, in addition to the ten latest, to keep | ||
| 17580 | updated. The default is 0. | ||
| 17581 | |||
| 17582 | @end table | ||
| 17583 | |||
| 17584 | |||
| 17585 | |||
| 17586 | @node Ultimate | ||
| 17587 | @subsection Ultimate | ||
| 17588 | @cindex nnultimate | ||
| 17589 | @cindex Ultimate Bulletin Board | ||
| 17590 | |||
| 17591 | @uref{http://www.ultimatebb.com/, The Ultimate Bulletin Board} is | ||
| 17592 | probably the most popular Web bulletin board system used. It has a | ||
| 17593 | quite regular and nice interface, and it's possible to get the | ||
| 17594 | information Gnus needs to keep groups updated. | ||
| 17595 | |||
| 17596 | The easiest way to get started with @code{nnultimate} is to say | ||
| 17597 | something like the following in the group buffer: @kbd{B nnultimate RET | ||
| 17598 | http://www.tcj.com/messboard/ubbcgi/ RET}. (Substitute the @acronym{URL} | ||
| 17599 | (not including @samp{Ultimate.cgi} or the like at the end) for a forum | ||
| 17600 | you're interested in; there's quite a list of them on the Ultimate web | ||
| 17601 | site.) Then subscribe to the groups you're interested in from the | ||
| 17602 | server buffer, and read them from the group buffer. | ||
| 17603 | |||
| 17604 | The following @code{nnultimate} variables can be altered: | ||
| 17605 | |||
| 17606 | @table @code | ||
| 17607 | @item nnultimate-directory | ||
| 17608 | @vindex nnultimate-directory | ||
| 17609 | The directory where @code{nnultimate} stores its files. The default is@* | ||
| 17610 | @file{~/News/ultimate/}. | ||
| 17611 | @end table | ||
| 17612 | |||
| 17613 | |||
| 17614 | @node Web Archive | ||
| 17615 | @subsection Web Archive | ||
| 17616 | @cindex nnwarchive | ||
| 17617 | @cindex Web Archive | ||
| 17618 | |||
| 17619 | Some mailing lists only have archives on Web servers, such as | ||
| 17620 | @uref{http://www.egroups.com/} and | ||
| 17621 | @uref{http://www.mail-archive.com/}. It has a quite regular and nice | ||
| 17622 | interface, and it's possible to get the information Gnus needs to keep | ||
| 17623 | groups updated. | ||
| 17624 | |||
| 17625 | @findex gnus-group-make-warchive-group | ||
| 17626 | The easiest way to get started with @code{nnwarchive} is to say | ||
| 17627 | something like the following in the group buffer: @kbd{M-x | ||
| 17628 | gnus-group-make-warchive-group RET @var{an_egroup} RET egroups RET | ||
| 17629 | www.egroups.com RET @var{your@@email.address} RET}. (Substitute the | ||
| 17630 | @var{an_egroup} with the mailing list you subscribed, the | ||
| 17631 | @var{your@@email.address} with your email address.), or to browse the | ||
| 17632 | back end by @kbd{B nnwarchive RET mail-archive RET}. | ||
| 17633 | |||
| 17634 | The following @code{nnwarchive} variables can be altered: | ||
| 17635 | |||
| 17636 | @table @code | ||
| 17637 | @item nnwarchive-directory | ||
| 17638 | @vindex nnwarchive-directory | ||
| 17639 | The directory where @code{nnwarchive} stores its files. The default is@* | ||
| 17640 | @file{~/News/warchive/}. | ||
| 17641 | |||
| 17642 | @item nnwarchive-login | ||
| 17643 | @vindex nnwarchive-login | ||
| 17644 | The account name on the web server. | ||
| 17645 | |||
| 17646 | @item nnwarchive-passwd | ||
| 17647 | @vindex nnwarchive-passwd | ||
| 17648 | The password for your account on the web server. | ||
| 17649 | @end table | ||
| 17650 | |||
| 17651 | @node RSS | 17544 | @node RSS |
| 17652 | @subsection RSS | 17545 | @subsection RSS |
| 17653 | @cindex nnrss | 17546 | @cindex nnrss |
| @@ -18584,7 +18477,6 @@ newsgroups. | |||
| 18584 | * Directory Groups:: You can read a directory as if it was a newsgroup. | 18477 | * Directory Groups:: You can read a directory as if it was a newsgroup. |
| 18585 | * Anything Groups:: Dired? Who needs dired? | 18478 | * Anything Groups:: Dired? Who needs dired? |
| 18586 | * Document Groups:: Single files can be the basis of a group. | 18479 | * Document Groups:: Single files can be the basis of a group. |
| 18587 | * SOUP:: Reading @sc{soup} packets ``offline''. | ||
| 18588 | * Mail-To-News Gateways:: Posting articles via mail-to-news gateways. | 18480 | * Mail-To-News Gateways:: Posting articles via mail-to-news gateways. |
| 18589 | @end menu | 18481 | @end menu |
| 18590 | 18482 | ||
| @@ -18952,289 +18844,6 @@ correct type. A high number means high probability; a low number | |||
| 18952 | means low probability with @samp{0} being the lowest valid number. | 18844 | means low probability with @samp{0} being the lowest valid number. |
| 18953 | 18845 | ||
| 18954 | 18846 | ||
| 18955 | @node SOUP | ||
| 18956 | @subsection SOUP | ||
| 18957 | @cindex SOUP | ||
| 18958 | @cindex offline | ||
| 18959 | |||
| 18960 | In the PC world people often talk about ``offline'' newsreaders. These | ||
| 18961 | are thingies that are combined reader/news transport monstrosities. | ||
| 18962 | With built-in modem programs. Yecchh! | ||
| 18963 | |||
| 18964 | Of course, us Unix Weenie types of human beans use things like | ||
| 18965 | @code{uucp} and, like, @code{nntpd} and set up proper news and mail | ||
| 18966 | transport things like Ghod intended. And then we just use normal | ||
| 18967 | newsreaders. | ||
| 18968 | |||
| 18969 | However, it can sometimes be convenient to do something that's a bit | ||
| 18970 | easier on the brain if you have a very slow modem, and you're not really | ||
| 18971 | that interested in doing things properly. | ||
| 18972 | |||
| 18973 | A file format called @sc{soup} has been developed for transporting news | ||
| 18974 | and mail from servers to home machines and back again. It can be a bit | ||
| 18975 | fiddly. | ||
| 18976 | |||
| 18977 | First some terminology: | ||
| 18978 | |||
| 18979 | @table @dfn | ||
| 18980 | |||
| 18981 | @item server | ||
| 18982 | This is the machine that is connected to the outside world and where you | ||
| 18983 | get news and/or mail from. | ||
| 18984 | |||
| 18985 | @item home machine | ||
| 18986 | This is the machine that you want to do the actual reading and responding | ||
| 18987 | on. It is typically not connected to the rest of the world in any way. | ||
| 18988 | |||
| 18989 | @item packet | ||
| 18990 | Something that contains messages and/or commands. There are two kinds | ||
| 18991 | of packets: | ||
| 18992 | |||
| 18993 | @table @dfn | ||
| 18994 | @item message packets | ||
| 18995 | These are packets made at the server, and typically contain lots of | ||
| 18996 | messages for you to read. These are called @file{SoupoutX.tgz} by | ||
| 18997 | default, where @var{x} is a number. | ||
| 18998 | |||
| 18999 | @item response packets | ||
| 19000 | These are packets made at the home machine, and typically contains | ||
| 19001 | replies that you've written. These are called @file{SoupinX.tgz} by | ||
| 19002 | default, where @var{x} is a number. | ||
| 19003 | |||
| 19004 | @end table | ||
| 19005 | |||
| 19006 | @end table | ||
| 19007 | |||
| 19008 | |||
| 19009 | @enumerate | ||
| 19010 | |||
| 19011 | @item | ||
| 19012 | You log in on the server and create a @sc{soup} packet. You can either | ||
| 19013 | use a dedicated @sc{soup} thingie (like the @code{awk} program), or you | ||
| 19014 | can use Gnus to create the packet with its @sc{soup} commands (@kbd{O | ||
| 19015 | s} and/or @kbd{G s b}; and then @kbd{G s p}) (@pxref{SOUP Commands}). | ||
| 19016 | |||
| 19017 | @item | ||
| 19018 | You transfer the packet home. Rail, boat, car or modem will do fine. | ||
| 19019 | |||
| 19020 | @item | ||
| 19021 | You put the packet in your home directory. | ||
| 19022 | |||
| 19023 | @item | ||
| 19024 | You fire up Gnus on your home machine using the @code{nnsoup} back end as | ||
| 19025 | the native or secondary server. | ||
| 19026 | |||
| 19027 | @item | ||
| 19028 | You read articles and mail and answer and followup to the things you | ||
| 19029 | want (@pxref{SOUP Replies}). | ||
| 19030 | |||
| 19031 | @item | ||
| 19032 | You do the @kbd{G s r} command to pack these replies into a @sc{soup} | ||
| 19033 | packet. | ||
| 19034 | |||
| 19035 | @item | ||
| 19036 | You transfer this packet to the server. | ||
| 19037 | |||
| 19038 | @item | ||
| 19039 | You use Gnus to mail this packet out with the @kbd{G s s} command. | ||
| 19040 | |||
| 19041 | @item | ||
| 19042 | You then repeat until you die. | ||
| 19043 | |||
| 19044 | @end enumerate | ||
| 19045 | |||
| 19046 | So you basically have a bipartite system---you use @code{nnsoup} for | ||
| 19047 | reading and Gnus for packing/sending these @sc{soup} packets. | ||
| 19048 | |||
| 19049 | @menu | ||
| 19050 | * SOUP Commands:: Commands for creating and sending @sc{soup} packets | ||
| 19051 | * SOUP Groups:: A back end for reading @sc{soup} packets. | ||
| 19052 | * SOUP Replies:: How to enable @code{nnsoup} to take over mail and news. | ||
| 19053 | @end menu | ||
| 19054 | |||
| 19055 | |||
| 19056 | @node SOUP Commands | ||
| 19057 | @subsubsection SOUP Commands | ||
| 19058 | |||
| 19059 | These are commands for creating and manipulating @sc{soup} packets. | ||
| 19060 | |||
| 19061 | @table @kbd | ||
| 19062 | @item G s b | ||
| 19063 | @kindex G s b (Group) | ||
| 19064 | @findex gnus-group-brew-soup | ||
| 19065 | Pack all unread articles in the current group | ||
| 19066 | (@code{gnus-group-brew-soup}). This command understands the | ||
| 19067 | process/prefix convention. | ||
| 19068 | |||
| 19069 | @item G s w | ||
| 19070 | @kindex G s w (Group) | ||
| 19071 | @findex gnus-soup-save-areas | ||
| 19072 | Save all @sc{soup} data files (@code{gnus-soup-save-areas}). | ||
| 19073 | |||
| 19074 | @item G s s | ||
| 19075 | @kindex G s s (Group) | ||
| 19076 | @findex gnus-soup-send-replies | ||
| 19077 | Send all replies from the replies packet | ||
| 19078 | (@code{gnus-soup-send-replies}). | ||
| 19079 | |||
| 19080 | @item G s p | ||
| 19081 | @kindex G s p (Group) | ||
| 19082 | @findex gnus-soup-pack-packet | ||
| 19083 | Pack all files into a @sc{soup} packet (@code{gnus-soup-pack-packet}). | ||
| 19084 | |||
| 19085 | @item G s r | ||
| 19086 | @kindex G s r (Group) | ||
| 19087 | @findex nnsoup-pack-replies | ||
| 19088 | Pack all replies into a replies packet (@code{nnsoup-pack-replies}). | ||
| 19089 | |||
| 19090 | @item O s | ||
| 19091 | @kindex O s (Summary) | ||
| 19092 | @findex gnus-soup-add-article | ||
| 19093 | This summary-mode command adds the current article to a @sc{soup} packet | ||
| 19094 | (@code{gnus-soup-add-article}). It understands the process/prefix | ||
| 19095 | convention (@pxref{Process/Prefix}). | ||
| 19096 | |||
| 19097 | @end table | ||
| 19098 | |||
| 19099 | |||
| 19100 | There are a few variables to customize where Gnus will put all these | ||
| 19101 | thingies: | ||
| 19102 | |||
| 19103 | @table @code | ||
| 19104 | |||
| 19105 | @item gnus-soup-directory | ||
| 19106 | @vindex gnus-soup-directory | ||
| 19107 | Directory where Gnus will save intermediate files while composing | ||
| 19108 | @sc{soup} packets. The default is @file{~/SoupBrew/}. | ||
| 19109 | |||
| 19110 | @item gnus-soup-replies-directory | ||
| 19111 | @vindex gnus-soup-replies-directory | ||
| 19112 | This is what Gnus will use as a temporary directory while sending our | ||
| 19113 | reply packets. @file{~/SoupBrew/SoupReplies/} is the default. | ||
| 19114 | |||
| 19115 | @item gnus-soup-prefix-file | ||
| 19116 | @vindex gnus-soup-prefix-file | ||
| 19117 | Name of the file where Gnus stores the last used prefix. The default is | ||
| 19118 | @samp{gnus-prefix}. | ||
| 19119 | |||
| 19120 | @item gnus-soup-packer | ||
| 19121 | @vindex gnus-soup-packer | ||
| 19122 | A format string command for packing a @sc{soup} packet. The default is | ||
| 19123 | @samp{tar cf - %s | gzip > $HOME/Soupout%d.tgz}. | ||
| 19124 | |||
| 19125 | @item gnus-soup-unpacker | ||
| 19126 | @vindex gnus-soup-unpacker | ||
| 19127 | Format string command for unpacking a @sc{soup} packet. The default is | ||
| 19128 | @samp{gunzip -c %s | tar xvf -}. | ||
| 19129 | |||
| 19130 | @item gnus-soup-packet-directory | ||
| 19131 | @vindex gnus-soup-packet-directory | ||
| 19132 | Where Gnus will look for reply packets. The default is @file{~/}. | ||
| 19133 | |||
| 19134 | @item gnus-soup-packet-regexp | ||
| 19135 | @vindex gnus-soup-packet-regexp | ||
| 19136 | Regular expression matching @sc{soup} reply packets in | ||
| 19137 | @code{gnus-soup-packet-directory}. | ||
| 19138 | |||
| 19139 | @end table | ||
| 19140 | |||
| 19141 | |||
| 19142 | @node SOUP Groups | ||
| 19143 | @subsubsection SOUP Groups | ||
| 19144 | @cindex nnsoup | ||
| 19145 | |||
| 19146 | @code{nnsoup} is the back end for reading @sc{soup} packets. It will | ||
| 19147 | read incoming packets, unpack them, and put them in a directory where | ||
| 19148 | you can read them at leisure. | ||
| 19149 | |||
| 19150 | These are the variables you can use to customize its behavior: | ||
| 19151 | |||
| 19152 | @table @code | ||
| 19153 | |||
| 19154 | @item nnsoup-tmp-directory | ||
| 19155 | @vindex nnsoup-tmp-directory | ||
| 19156 | When @code{nnsoup} unpacks a @sc{soup} packet, it does it in this | ||
| 19157 | directory. (@file{/tmp/} by default.) | ||
| 19158 | |||
| 19159 | @item nnsoup-directory | ||
| 19160 | @vindex nnsoup-directory | ||
| 19161 | @code{nnsoup} then moves each message and index file to this directory. | ||
| 19162 | The default is @file{~/SOUP/}. | ||
| 19163 | |||
| 19164 | @item nnsoup-replies-directory | ||
| 19165 | @vindex nnsoup-replies-directory | ||
| 19166 | All replies will be stored in this directory before being packed into a | ||
| 19167 | reply packet. The default is @file{~/SOUP/replies/}. | ||
| 19168 | |||
| 19169 | @item nnsoup-replies-format-type | ||
| 19170 | @vindex nnsoup-replies-format-type | ||
| 19171 | The @sc{soup} format of the replies packets. The default is @samp{?n} | ||
| 19172 | (rnews), and I don't think you should touch that variable. I probably | ||
| 19173 | shouldn't even have documented it. Drats! Too late! | ||
| 19174 | |||
| 19175 | @item nnsoup-replies-index-type | ||
| 19176 | @vindex nnsoup-replies-index-type | ||
| 19177 | The index type of the replies packet. The default is @samp{?n}, which | ||
| 19178 | means ``none''. Don't fiddle with this one either! | ||
| 19179 | |||
| 19180 | @item nnsoup-active-file | ||
| 19181 | @vindex nnsoup-active-file | ||
| 19182 | Where @code{nnsoup} stores lots of information. This is not an ``active | ||
| 19183 | file'' in the @code{nntp} sense; it's an Emacs Lisp file. If you lose | ||
| 19184 | this file or mess it up in any way, you're dead. The default is | ||
| 19185 | @file{~/SOUP/active}. | ||
| 19186 | |||
| 19187 | @item nnsoup-packer | ||
| 19188 | @vindex nnsoup-packer | ||
| 19189 | Format string command for packing a reply @sc{soup} packet. The default | ||
| 19190 | is @samp{tar cf - %s | gzip > $HOME/Soupin%d.tgz}. | ||
| 19191 | |||
| 19192 | @item nnsoup-unpacker | ||
| 19193 | @vindex nnsoup-unpacker | ||
| 19194 | Format string command for unpacking incoming @sc{soup} packets. The | ||
| 19195 | default is @samp{gunzip -c %s | tar xvf -}. | ||
| 19196 | |||
| 19197 | @item nnsoup-packet-directory | ||
| 19198 | @vindex nnsoup-packet-directory | ||
| 19199 | Where @code{nnsoup} will look for incoming packets. The default is | ||
| 19200 | @file{~/}. | ||
| 19201 | |||
| 19202 | @item nnsoup-packet-regexp | ||
| 19203 | @vindex nnsoup-packet-regexp | ||
| 19204 | Regular expression matching incoming @sc{soup} packets. The default is | ||
| 19205 | @samp{Soupout}. | ||
| 19206 | |||
| 19207 | @item nnsoup-always-save | ||
| 19208 | @vindex nnsoup-always-save | ||
| 19209 | If non-@code{nil}, save the replies buffer after each posted message. | ||
| 19210 | |||
| 19211 | @end table | ||
| 19212 | |||
| 19213 | |||
| 19214 | @node SOUP Replies | ||
| 19215 | @subsubsection SOUP Replies | ||
| 19216 | |||
| 19217 | Just using @code{nnsoup} won't mean that your postings and mailings end | ||
| 19218 | up in @sc{soup} reply packets automagically. You have to work a bit | ||
| 19219 | more for that to happen. | ||
| 19220 | |||
| 19221 | @findex nnsoup-set-variables | ||
| 19222 | The @code{nnsoup-set-variables} command will set the appropriate | ||
| 19223 | variables to ensure that all your followups and replies end up in the | ||
| 19224 | @sc{soup} system. | ||
| 19225 | |||
| 19226 | In specific, this is what it does: | ||
| 19227 | |||
| 19228 | @lisp | ||
| 19229 | (setq message-send-news-function 'nnsoup-request-post) | ||
| 19230 | (setq message-send-mail-function 'nnsoup-request-mail) | ||
| 19231 | @end lisp | ||
| 19232 | |||
| 19233 | And that's it, really. If you only want news to go into the @sc{soup} | ||
| 19234 | system you just use the first line. If you only want mail to be | ||
| 19235 | @sc{soup}ed you use the second. | ||
| 19236 | |||
| 19237 | |||
| 19238 | @node Mail-To-News Gateways | 18847 | @node Mail-To-News Gateways |
| 19239 | @subsection Mail-To-News Gateways | 18848 | @subsection Mail-To-News Gateways |
| 19240 | @cindex mail-to-news gateways | 18849 | @cindex mail-to-news gateways |
| @@ -19321,7 +18930,6 @@ groups. | |||
| 19321 | 18930 | ||
| 19322 | @menu | 18931 | @menu |
| 19323 | * Virtual Groups:: Combining articles from many groups. | 18932 | * Virtual Groups:: Combining articles from many groups. |
| 19324 | * Kibozed Groups:: Looking through parts of the newsfeed for articles. | ||
| 19325 | @end menu | 18933 | @end menu |
| 19326 | 18934 | ||
| 19327 | 18935 | ||
| @@ -19411,58 +19019,6 @@ from component groups---group parameters, for instance, are not | |||
| 19411 | inherited. | 19019 | inherited. |
| 19412 | 19020 | ||
| 19413 | 19021 | ||
| 19414 | @node Kibozed Groups | ||
| 19415 | @subsection Kibozed Groups | ||
| 19416 | @cindex nnkiboze | ||
| 19417 | @cindex kibozing | ||
| 19418 | |||
| 19419 | @dfn{Kibozing} is defined by the @acronym{OED} as ``grepping through | ||
| 19420 | (parts of) the news feed''. @code{nnkiboze} is a back end that will | ||
| 19421 | do this for you. Oh joy! Now you can grind any @acronym{NNTP} server | ||
| 19422 | down to a halt with useless requests! Oh happiness! | ||
| 19423 | |||
| 19424 | @kindex G k (Group) | ||
| 19425 | To create a kibozed group, use the @kbd{G k} command in the group | ||
| 19426 | buffer. | ||
| 19427 | |||
| 19428 | The address field of the @code{nnkiboze} method is, as with | ||
| 19429 | @code{nnvirtual}, a regexp to match groups to be ``included'' in the | ||
| 19430 | @code{nnkiboze} group. That's where most similarities between | ||
| 19431 | @code{nnkiboze} and @code{nnvirtual} end. | ||
| 19432 | |||
| 19433 | In addition to this regexp detailing component groups, an | ||
| 19434 | @code{nnkiboze} group must have a score file to say what articles are | ||
| 19435 | to be included in the group (@pxref{Scoring}). | ||
| 19436 | |||
| 19437 | @kindex M-x nnkiboze-generate-groups | ||
| 19438 | @findex nnkiboze-generate-groups | ||
| 19439 | You must run @kbd{M-x nnkiboze-generate-groups} after creating the | ||
| 19440 | @code{nnkiboze} groups you want to have. This command will take time. | ||
| 19441 | Lots of time. Oodles and oodles of time. Gnus has to fetch the | ||
| 19442 | headers from all the articles in all the component groups and run them | ||
| 19443 | through the scoring process to determine if there are any articles in | ||
| 19444 | the groups that are to be part of the @code{nnkiboze} groups. | ||
| 19445 | |||
| 19446 | Please limit the number of component groups by using restrictive | ||
| 19447 | regexps. Otherwise your sysadmin may become annoyed with you, and the | ||
| 19448 | @acronym{NNTP} site may throw you off and never let you back in again. | ||
| 19449 | Stranger things have happened. | ||
| 19450 | |||
| 19451 | @code{nnkiboze} component groups do not have to be alive---they can be dead, | ||
| 19452 | and they can be foreign. No restrictions. | ||
| 19453 | |||
| 19454 | @vindex nnkiboze-directory | ||
| 19455 | The generation of an @code{nnkiboze} group means writing two files in | ||
| 19456 | @code{nnkiboze-directory}, which is @file{~/News/kiboze/} by default. | ||
| 19457 | One contains the @acronym{NOV} header lines for all the articles in | ||
| 19458 | the group, and the other is an additional @file{.newsrc} file to store | ||
| 19459 | information on what groups have been searched through to find | ||
| 19460 | component articles. | ||
| 19461 | |||
| 19462 | Articles marked as read in the @code{nnkiboze} group will have | ||
| 19463 | their @acronym{NOV} lines removed from the @acronym{NOV} file. | ||
| 19464 | |||
| 19465 | |||
| 19466 | @node Email Based Diary | 19022 | @node Email Based Diary |
| 19467 | @section Email Based Diary | 19023 | @section Email Based Diary |
| 19468 | @cindex diary | 19024 | @cindex diary |
| @@ -22018,7 +21574,7 @@ is @file{ADAPT}. | |||
| 22018 | @vindex gnus-adaptive-pretty-print | 21574 | @vindex gnus-adaptive-pretty-print |
| 22019 | Adaptive score files can get huge and are not meant to be edited by | 21575 | Adaptive score files can get huge and are not meant to be edited by |
| 22020 | human hands. If @code{gnus-adaptive-pretty-print} is @code{nil} (the | 21576 | human hands. If @code{gnus-adaptive-pretty-print} is @code{nil} (the |
| 22021 | deafult) those files will not be written in a human readable way. | 21577 | default) those files will not be written in a human readable way. |
| 22022 | 21578 | ||
| 22023 | @vindex gnus-score-exact-adapt-limit | 21579 | @vindex gnus-score-exact-adapt-limit |
| 22024 | When doing adaptive scoring, substring or fuzzy matching would probably | 21580 | When doing adaptive scoring, substring or fuzzy matching would probably |
| @@ -27811,10 +27367,6 @@ You can set the process mark on both groups and articles and perform | |||
| 27811 | operations on all the marked items (@pxref{Process/Prefix}). | 27367 | operations on all the marked items (@pxref{Process/Prefix}). |
| 27812 | 27368 | ||
| 27813 | @item | 27369 | @item |
| 27814 | You can grep through a subset of groups and create a group from the | ||
| 27815 | results (@pxref{Kibozed Groups}). | ||
| 27816 | |||
| 27817 | @item | ||
| 27818 | You can list subsets of groups according to, well, anything | 27370 | You can list subsets of groups according to, well, anything |
| 27819 | (@pxref{Listing Groups}). | 27371 | (@pxref{Listing Groups}). |
| 27820 | 27372 | ||
| @@ -27959,8 +27511,7 @@ news batches, ClariNet briefs collections, and just about everything | |||
| 27959 | else (@pxref{Document Groups}). | 27511 | else (@pxref{Document Groups}). |
| 27960 | 27512 | ||
| 27961 | @item | 27513 | @item |
| 27962 | Gnus has a new back end (@code{nnsoup}) to create/read SOUP packets | 27514 | Gnus has a new back end (@code{nnsoup}) to create/read SOUP packets. |
| 27963 | (@pxref{SOUP}). | ||
| 27964 | 27515 | ||
| 27965 | @item | 27516 | @item |
| 27966 | The Gnus cache is much faster. | 27517 | The Gnus cache is much faster. |
| @@ -29521,11 +29072,9 @@ Gnus not to use @acronym{NOV}. | |||
| 29521 | As the variables for the other back ends, there are | 29072 | As the variables for the other back ends, there are |
| 29522 | @code{nndiary-nov-is-evil}, @code{nndir-nov-is-evil}, | 29073 | @code{nndiary-nov-is-evil}, @code{nndir-nov-is-evil}, |
| 29523 | @code{nnfolder-nov-is-evil}, @code{nnimap-nov-is-evil}, | 29074 | @code{nnfolder-nov-is-evil}, @code{nnimap-nov-is-evil}, |
| 29524 | @code{nnml-nov-is-evil}, @code{nnspool-nov-is-evil}, and | 29075 | @code{nnml-nov-is-evil}, and @code{nnspool-nov-is-evil}. Note that a |
| 29525 | @code{nnwarchive-nov-is-evil}. Note that a non-@code{nil} value for | 29076 | non-@code{nil} value for @code{gnus-nov-is-evil} overrides all those |
| 29526 | @code{gnus-nov-is-evil} overrides all those variables.@footnote{Although | 29077 | variables. |
| 29527 | the back ends @code{nnkiboze}, @code{nnslashdot}, @code{nnultimate}, and | ||
| 29528 | @code{nnwfm} don't have their own nn*-nov-is-evil.} | ||
| 29529 | @end table | 29078 | @end table |
| 29530 | 29079 | ||
| 29531 | 29080 | ||
| @@ -31356,7 +30905,3 @@ former). The manual is unambiguous, but it can be confusing. | |||
| 31356 | @c mode: texinfo | 30905 | @c mode: texinfo |
| 31357 | @c coding: iso-8859-1 | 30906 | @c coding: iso-8859-1 |
| 31358 | @c End: | 30907 | @c End: |
| 31359 | |||
| 31360 | @ignore | ||
| 31361 | arch-tag: c9fa47e7-78ca-4681-bda9-9fef45d1c819 | ||
| 31362 | @end ignore | ||
diff --git a/doc/misc/message.texi b/doc/misc/message.texi index 283d29c0de4..6b922476596 100644 --- a/doc/misc/message.texi +++ b/doc/misc/message.texi | |||
| @@ -182,6 +182,37 @@ Addresses that match the @code{message-dont-reply-to-names} regular | |||
| 182 | expression (or list of regular expressions) will be removed from the | 182 | expression (or list of regular expressions) will be removed from the |
| 183 | @code{Cc} header. A value of @code{nil} means exclude your name only. | 183 | @code{Cc} header. A value of @code{nil} means exclude your name only. |
| 184 | 184 | ||
| 185 | @vindex message-prune-recipient-rules | ||
| 186 | @code{message-prune-recipient-rules} is used to prune the addresses | ||
| 187 | used when doing a wide reply. It's meant to be used to remove | ||
| 188 | duplicate addresses and the like. It's a list of lists, where the | ||
| 189 | first element is a regexp to match the address to trigger the rule, | ||
| 190 | and the second is a regexp that will be expanded based on the first, | ||
| 191 | to match addresses to be pruned. | ||
| 192 | |||
| 193 | It's complicated to explain, but it's easy to use. | ||
| 194 | |||
| 195 | For instance, if you get an email from @samp{foo@@example.org}, but | ||
| 196 | @samp{foo@@zot.example.org} is also in the @code{Cc} list, then your | ||
| 197 | wide reply will go out to both these addresses, since they are unique. | ||
| 198 | |||
| 199 | To avoid this, do something like the following: | ||
| 200 | |||
| 201 | @lisp | ||
| 202 | (setq message-prune-recipient-rules | ||
| 203 | '(("^\\([^@@]+\\)@@\\(.*\\)" "\\1@@.*[.]\\2"))) | ||
| 204 | @end lisp | ||
| 205 | |||
| 206 | If, for instance, you want all wide replies that involve messages from | ||
| 207 | @samp{cvs@@example.org} to go to that address, and nowhere else (i.e., | ||
| 208 | remove all other recipients if @samp{cvs@@example.org} is in the | ||
| 209 | recipient list: | ||
| 210 | |||
| 211 | @lisp | ||
| 212 | (setq message-prune-recipient-rules | ||
| 213 | '(("cvs@@example.org" "."))) | ||
| 214 | @end lisp | ||
| 215 | |||
| 185 | @vindex message-wide-reply-confirm-recipients | 216 | @vindex message-wide-reply-confirm-recipients |
| 186 | If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you | 217 | If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you |
| 187 | will be asked to confirm that you want to reply to multiple | 218 | will be asked to confirm that you want to reply to multiple |
| @@ -1645,7 +1676,8 @@ the problem will actually occur. | |||
| 1645 | @cindex split large message | 1676 | @cindex split large message |
| 1646 | The limitation of messages sent as message/partial. The lower bound | 1677 | The limitation of messages sent as message/partial. The lower bound |
| 1647 | of message size in characters, beyond which the message should be sent | 1678 | of message size in characters, beyond which the message should be sent |
| 1648 | in several parts. If it is @code{nil}, the size is unlimited. | 1679 | in several parts. If it is @code{nil} (which is the default), the |
| 1680 | size is unlimited. | ||
| 1649 | 1681 | ||
| 1650 | @end table | 1682 | @end table |
| 1651 | 1683 | ||
| @@ -2441,7 +2473,3 @@ basis of the new @code{Cc} header, except if this header is | |||
| 2441 | @bye | 2473 | @bye |
| 2442 | 2474 | ||
| 2443 | @c End: | 2475 | @c End: |
| 2444 | |||
| 2445 | @ignore | ||
| 2446 | arch-tag: 16ab76af-a281-4e34-aed6-5624569f7601 | ||
| 2447 | @end ignore | ||
diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 9074f171e4b..97b8d3ebc03 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi | |||
| @@ -51,7 +51,8 @@ e.g., | |||
| 51 | @copying | 51 | @copying |
| 52 | This manual is for Org version @value{VERSION}. | 52 | This manual is for Org version @value{VERSION}. |
| 53 | 53 | ||
| 54 | Copyright @copyright{} 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation | 54 | Copyright @copyright{} 2004, 2005, 2006, 2007, 2008, 2009, 2010 |
| 55 | Free Software Foundation, Inc. | ||
| 55 | 56 | ||
| 56 | @quotation | 57 | @quotation |
| 57 | Permission is granted to copy, distribute and/or modify this document | 58 | Permission is granted to copy, distribute and/or modify this document |
| @@ -101,400 +102,400 @@ with contributions by David O'Toole, Bastien Guerry, Philip Rooke, Dan Davison, | |||
| 101 | @end ifnottex | 102 | @end ifnottex |
| 102 | 103 | ||
| 103 | @menu | 104 | @menu |
| 104 | * Introduction:: Getting started | 105 | * Introduction:: Getting started |
| 105 | * Document Structure:: A tree works like your brain | 106 | * Document Structure:: A tree works like your brain |
| 106 | * Tables:: Pure magic for quick formatting | 107 | * Tables:: Pure magic for quick formatting |
| 107 | * Hyperlinks:: Notes in context | 108 | * Hyperlinks:: Notes in context |
| 108 | * TODO Items:: Every tree branch can be a TODO item | 109 | * TODO Items:: Every tree branch can be a TODO item |
| 109 | * Tags:: Tagging headlines and matching sets of tags | 110 | * Tags:: Tagging headlines and matching sets of tags |
| 110 | * Properties and Columns:: Storing information about an entry | 111 | * Properties and Columns:: Storing information about an entry |
| 111 | * Dates and Times:: Making items useful for planning | 112 | * Dates and Times:: Making items useful for planning |
| 112 | * Capture - Refile - Archive:: The ins and outs for projects | 113 | * Capture - Refile - Archive:: The ins and outs for projects |
| 113 | * Agenda Views:: Collecting information into views | 114 | * Agenda Views:: Collecting information into views |
| 114 | * Markup:: Prepare text for rich export | 115 | * Markup:: Prepare text for rich export |
| 115 | * Exporting:: Sharing and publishing of notes | 116 | * Exporting:: Sharing and publishing of notes |
| 116 | * Publishing:: Create a web site of linked Org files | 117 | * Publishing:: Create a web site of linked Org files |
| 117 | * Working With Source Code:: Export, evaluate, and tangle code blocks | 118 | * Working With Source Code:: Export, evaluate, and tangle code blocks |
| 118 | * Miscellaneous:: All the rest which did not fit elsewhere | 119 | * Miscellaneous:: All the rest which did not fit elsewhere |
| 119 | * Hacking:: How to hack your way around | 120 | * Hacking:: How to hack your way around |
| 120 | * MobileOrg:: Viewing and capture on a mobile device | 121 | * MobileOrg:: Viewing and capture on a mobile device |
| 121 | * History and Acknowledgments:: How Org came into being | 122 | * History and Acknowledgments:: How Org came into being |
| 122 | * Main Index:: An index of Org's concepts and features | 123 | * Main Index:: An index of Org's concepts and features |
| 123 | * Key Index:: Key bindings and where they are described | 124 | * Key Index:: Key bindings and where they are described |
| 124 | * Variable Index:: Variables mentioned in the manual | 125 | * Variable Index:: Variables mentioned in the manual |
| 125 | 126 | ||
| 126 | @detailmenu | 127 | @detailmenu |
| 127 | --- The Detailed Node Listing --- | 128 | --- The Detailed Node Listing --- |
| 128 | 129 | ||
| 129 | Introduction | 130 | Introduction |
| 130 | 131 | ||
| 131 | * Summary:: Brief summary of what Org does | 132 | * Summary:: Brief summary of what Org does |
| 132 | * Installation:: How to install a downloaded version of Org | 133 | * Installation:: How to install a downloaded version of Org |
| 133 | * Activation:: How to activate Org for certain buffers | 134 | * Activation:: How to activate Org for certain buffers |
| 134 | * Feedback:: Bug reports, ideas, patches etc. | 135 | * Feedback:: Bug reports, ideas, patches etc. |
| 135 | * Conventions:: Type-setting conventions in the manual | 136 | * Conventions:: Type-setting conventions in the manual |
| 136 | 137 | ||
| 137 | Document structure | 138 | Document structure |
| 138 | 139 | ||
| 139 | * Outlines:: Org is based on Outline mode | 140 | * Outlines:: Org is based on Outline mode |
| 140 | * Headlines:: How to typeset Org tree headlines | 141 | * Headlines:: How to typeset Org tree headlines |
| 141 | * Visibility cycling:: Show and hide, much simplified | 142 | * Visibility cycling:: Show and hide, much simplified |
| 142 | * Motion:: Jumping to other headlines | 143 | * Motion:: Jumping to other headlines |
| 143 | * Structure editing:: Changing sequence and level of headlines | 144 | * Structure editing:: Changing sequence and level of headlines |
| 144 | * Sparse trees:: Matches embedded in context | 145 | * Sparse trees:: Matches embedded in context |
| 145 | * Plain lists:: Additional structure within an entry | 146 | * Plain lists:: Additional structure within an entry |
| 146 | * Drawers:: Tucking stuff away | 147 | * Drawers:: Tucking stuff away |
| 147 | * Blocks:: Folding blocks | 148 | * Blocks:: Folding blocks |
| 148 | * Footnotes:: How footnotes are defined in Org's syntax | 149 | * Footnotes:: How footnotes are defined in Org's syntax |
| 149 | * Orgstruct mode:: Structure editing outside Org | 150 | * Orgstruct mode:: Structure editing outside Org |
| 150 | 151 | ||
| 151 | Tables | 152 | Tables |
| 152 | 153 | ||
| 153 | * Built-in table editor:: Simple tables | 154 | * Built-in table editor:: Simple tables |
| 154 | * Column width and alignment:: Overrule the automatic settings | 155 | * Column width and alignment:: Overrule the automatic settings |
| 155 | * Column groups:: Grouping to trigger vertical lines | 156 | * Column groups:: Grouping to trigger vertical lines |
| 156 | * Orgtbl mode:: The table editor as minor mode | 157 | * Orgtbl mode:: The table editor as minor mode |
| 157 | * The spreadsheet:: The table editor has spreadsheet capabilities | 158 | * The spreadsheet:: The table editor has spreadsheet capabilities |
| 158 | * Org-Plot:: Plotting from org tables | 159 | * Org-Plot:: Plotting from org tables |
| 159 | 160 | ||
| 160 | The spreadsheet | 161 | The spreadsheet |
| 161 | 162 | ||
| 162 | * References:: How to refer to another field or range | 163 | * References:: How to refer to another field or range |
| 163 | * Formula syntax for Calc:: Using Calc to compute stuff | 164 | * Formula syntax for Calc:: Using Calc to compute stuff |
| 164 | * Formula syntax for Lisp:: Writing formulas in Emacs Lisp | 165 | * Formula syntax for Lisp:: Writing formulas in Emacs Lisp |
| 165 | * Field formulas:: Formulas valid for a single field | 166 | * Field formulas:: Formulas valid for a single field |
| 166 | * Column formulas:: Formulas valid for an entire column | 167 | * Column formulas:: Formulas valid for an entire column |
| 167 | * Editing and debugging formulas:: Fixing formulas | 168 | * Editing and debugging formulas:: Fixing formulas |
| 168 | * Updating the table:: Recomputing all dependent fields | 169 | * Updating the table:: Recomputing all dependent fields |
| 169 | * Advanced features:: Field names, parameters and automatic recalc | 170 | * Advanced features:: Field names, parameters and automatic recalc |
| 170 | 171 | ||
| 171 | Hyperlinks | 172 | Hyperlinks |
| 172 | 173 | ||
| 173 | * Link format:: How links in Org are formatted | 174 | * Link format:: How links in Org are formatted |
| 174 | * Internal links:: Links to other places in the current file | 175 | * Internal links:: Links to other places in the current file |
| 175 | * External links:: URL-like links to the world | 176 | * External links:: URL-like links to the world |
| 176 | * Handling links:: Creating, inserting and following | 177 | * Handling links:: Creating, inserting and following |
| 177 | * Using links outside Org:: Linking from my C source code? | 178 | * Using links outside Org:: Linking from my C source code? |
| 178 | * Link abbreviations:: Shortcuts for writing complex links | 179 | * Link abbreviations:: Shortcuts for writing complex links |
| 179 | * Search options:: Linking to a specific location | 180 | * Search options:: Linking to a specific location |
| 180 | * Custom searches:: When the default search is not enough | 181 | * Custom searches:: When the default search is not enough |
| 181 | 182 | ||
| 182 | Internal links | 183 | Internal links |
| 183 | 184 | ||
| 184 | * Radio targets:: Make targets trigger links in plain text | 185 | * Radio targets:: Make targets trigger links in plain text |
| 185 | 186 | ||
| 186 | TODO items | 187 | TODO items |
| 187 | 188 | ||
| 188 | * TODO basics:: Marking and displaying TODO entries | 189 | * TODO basics:: Marking and displaying TODO entries |
| 189 | * TODO extensions:: Workflow and assignments | 190 | * TODO extensions:: Workflow and assignments |
| 190 | * Progress logging:: Dates and notes for progress | 191 | * Progress logging:: Dates and notes for progress |
| 191 | * Priorities:: Some things are more important than others | 192 | * Priorities:: Some things are more important than others |
| 192 | * Breaking down tasks:: Splitting a task into manageable pieces | 193 | * Breaking down tasks:: Splitting a task into manageable pieces |
| 193 | * Checkboxes:: Tick-off lists | 194 | * Checkboxes:: Tick-off lists |
| 194 | 195 | ||
| 195 | Extended use of TODO keywords | 196 | Extended use of TODO keywords |
| 196 | 197 | ||
| 197 | * Workflow states:: From TODO to DONE in steps | 198 | * Workflow states:: From TODO to DONE in steps |
| 198 | * TODO types:: I do this, Fred does the rest | 199 | * TODO types:: I do this, Fred does the rest |
| 199 | * Multiple sets in one file:: Mixing it all, and still finding your way | 200 | * Multiple sets in one file:: Mixing it all, and still finding your way |
| 200 | * Fast access to TODO states:: Single letter selection of a state | 201 | * Fast access to TODO states:: Single letter selection of a state |
| 201 | * Per-file keywords:: Different files, different requirements | 202 | * Per-file keywords:: Different files, different requirements |
| 202 | * Faces for TODO keywords:: Highlighting states | 203 | * Faces for TODO keywords:: Highlighting states |
| 203 | * TODO dependencies:: When one task needs to wait for others | 204 | * TODO dependencies:: When one task needs to wait for others |
| 204 | 205 | ||
| 205 | Progress logging | 206 | Progress logging |
| 206 | 207 | ||
| 207 | * Closing items:: When was this entry marked DONE? | 208 | * Closing items:: When was this entry marked DONE? |
| 208 | * Tracking TODO state changes:: When did the status change? | 209 | * Tracking TODO state changes:: When did the status change? |
| 209 | * Tracking your habits:: How consistent have you been? | 210 | * Tracking your habits:: How consistent have you been? |
| 210 | 211 | ||
| 211 | Tags | 212 | Tags |
| 212 | 213 | ||
| 213 | * Tag inheritance:: Tags use the tree structure of the outline | 214 | * Tag inheritance:: Tags use the tree structure of the outline |
| 214 | * Setting tags:: How to assign tags to a headline | 215 | * Setting tags:: How to assign tags to a headline |
| 215 | * Tag searches:: Searching for combinations of tags | 216 | * Tag searches:: Searching for combinations of tags |
| 216 | 217 | ||
| 217 | Properties and columns | 218 | Properties and columns |
| 218 | 219 | ||
| 219 | * Property syntax:: How properties are spelled out | 220 | * Property syntax:: How properties are spelled out |
| 220 | * Special properties:: Access to other Org-mode features | 221 | * Special properties:: Access to other Org-mode features |
| 221 | * Property searches:: Matching property values | 222 | * Property searches:: Matching property values |
| 222 | * Property inheritance:: Passing values down the tree | 223 | * Property inheritance:: Passing values down the tree |
| 223 | * Column view:: Tabular viewing and editing | 224 | * Column view:: Tabular viewing and editing |
| 224 | * Property API:: Properties for Lisp programmers | 225 | * Property API:: Properties for Lisp programmers |
| 225 | 226 | ||
| 226 | Column view | 227 | Column view |
| 227 | 228 | ||
| 228 | * Defining columns:: The COLUMNS format property | 229 | * Defining columns:: The COLUMNS format property |
| 229 | * Using column view:: How to create and use column view | 230 | * Using column view:: How to create and use column view |
| 230 | * Capturing column view:: A dynamic block for column view | 231 | * Capturing column view:: A dynamic block for column view |
| 231 | 232 | ||
| 232 | Defining columns | 233 | Defining columns |
| 233 | 234 | ||
| 234 | * Scope of column definitions:: Where defined, where valid? | 235 | * Scope of column definitions:: Where defined, where valid? |
| 235 | * Column attributes:: Appearance and content of a column | 236 | * Column attributes:: Appearance and content of a column |
| 236 | 237 | ||
| 237 | Dates and times | 238 | Dates and times |
| 238 | 239 | ||
| 239 | * Timestamps:: Assigning a time to a tree entry | 240 | * Timestamps:: Assigning a time to a tree entry |
| 240 | * Creating timestamps:: Commands which insert timestamps | 241 | * Creating timestamps:: Commands which insert timestamps |
| 241 | * Deadlines and scheduling:: Planning your work | 242 | * Deadlines and scheduling:: Planning your work |
| 242 | * Clocking work time:: Tracking how long you spend on a task | 243 | * Clocking work time:: Tracking how long you spend on a task |
| 243 | * Resolving idle time:: Resolving time if you've been idle | 244 | * Resolving idle time:: Resolving time if you've been idle |
| 244 | * Effort estimates:: Planning work effort in advance | 245 | * Effort estimates:: Planning work effort in advance |
| 245 | * Relative timer:: Notes with a running timer | 246 | * Relative timer:: Notes with a running timer |
| 246 | 247 | ||
| 247 | Creating timestamps | 248 | Creating timestamps |
| 248 | 249 | ||
| 249 | * The date/time prompt:: How Org-mode helps you entering date and time | 250 | * The date/time prompt:: How Org-mode helps you entering date and time |
| 250 | * Custom time format:: Making dates look different | 251 | * Custom time format:: Making dates look different |
| 251 | 252 | ||
| 252 | Deadlines and scheduling | 253 | Deadlines and scheduling |
| 253 | 254 | ||
| 254 | * Inserting deadline/schedule:: Planning items | 255 | * Inserting deadline/schedule:: Planning items |
| 255 | * Repeated tasks:: Items that show up again and again | 256 | * Repeated tasks:: Items that show up again and again |
| 256 | 257 | ||
| 257 | Capture - Refile - Archive | 258 | Capture - Refile - Archive |
| 258 | 259 | ||
| 259 | * Capture:: Capturing new stuff | 260 | * Capture:: Capturing new stuff |
| 260 | * Attachments:: Add files to tasks | 261 | * Attachments:: Add files to tasks |
| 261 | * RSS Feeds:: Getting input from RSS feeds | 262 | * RSS Feeds:: Getting input from RSS feeds |
| 262 | * Protocols:: External (e.g. Browser) access to Emacs and Org | 263 | * Protocols:: External (e.g. Browser) access to Emacs and Org |
| 263 | * Refiling notes:: Moving a tree from one place to another | 264 | * Refiling notes:: Moving a tree from one place to another |
| 264 | * Archiving:: What to do with finished projects | 265 | * Archiving:: What to do with finished projects |
| 265 | 266 | ||
| 266 | Capture | 267 | Capture |
| 267 | 268 | ||
| 268 | * Setting up capture:: Where notes will be stored | 269 | * Setting up capture:: Where notes will be stored |
| 269 | * Using capture:: Commands to invoke and terminate capture | 270 | * Using capture:: Commands to invoke and terminate capture |
| 270 | * Capture templates:: Define the outline of different note types | 271 | * Capture templates:: Define the outline of different note types |
| 271 | 272 | ||
| 272 | Capture templates | 273 | Capture templates |
| 273 | 274 | ||
| 274 | * Template elements:: What is needed for a complete template entry | 275 | * Template elements:: What is needed for a complete template entry |
| 275 | * Template expansion:: Filling in information about time and context | 276 | * Template expansion:: Filling in information about time and context |
| 276 | 277 | ||
| 277 | Archiving | 278 | Archiving |
| 278 | 279 | ||
| 279 | * Moving subtrees:: Moving a tree to an archive file | 280 | * Moving subtrees:: Moving a tree to an archive file |
| 280 | * Internal archiving:: Switch off a tree but keep it in the file | 281 | * Internal archiving:: Switch off a tree but keep it in the file |
| 281 | 282 | ||
| 282 | Agenda views | 283 | Agenda views |
| 283 | 284 | ||
| 284 | * Agenda files:: Files being searched for agenda information | 285 | * Agenda files:: Files being searched for agenda information |
| 285 | * Agenda dispatcher:: Keyboard access to agenda views | 286 | * Agenda dispatcher:: Keyboard access to agenda views |
| 286 | * Built-in agenda views:: What is available out of the box? | 287 | * Built-in agenda views:: What is available out of the box? |
| 287 | * Presentation and sorting:: How agenda items are prepared for display | 288 | * Presentation and sorting:: How agenda items are prepared for display |
| 288 | * Agenda commands:: Remote editing of Org trees | 289 | * Agenda commands:: Remote editing of Org trees |
| 289 | * Custom agenda views:: Defining special searches and views | 290 | * Custom agenda views:: Defining special searches and views |
| 290 | * Exporting Agenda Views:: Writing a view to a file | 291 | * Exporting Agenda Views:: Writing a view to a file |
| 291 | * Agenda column view:: Using column view for collected entries | 292 | * Agenda column view:: Using column view for collected entries |
| 292 | 293 | ||
| 293 | The built-in agenda views | 294 | The built-in agenda views |
| 294 | 295 | ||
| 295 | * Weekly/daily agenda:: The calendar page with current tasks | 296 | * Weekly/daily agenda:: The calendar page with current tasks |
| 296 | * Global TODO list:: All unfinished action items | 297 | * Global TODO list:: All unfinished action items |
| 297 | * Matching tags and properties:: Structured information with fine-tuned search | 298 | * Matching tags and properties:: Structured information with fine-tuned search |
| 298 | * Timeline:: Time-sorted view for single file | 299 | * Timeline:: Time-sorted view for single file |
| 299 | * Search view:: Find entries by searching for text | 300 | * Search view:: Find entries by searching for text |
| 300 | * Stuck projects:: Find projects you need to review | 301 | * Stuck projects:: Find projects you need to review |
| 301 | 302 | ||
| 302 | Presentation and sorting | 303 | Presentation and sorting |
| 303 | 304 | ||
| 304 | * Categories:: Not all tasks are equal | 305 | * Categories:: Not all tasks are equal |
| 305 | * Time-of-day specifications:: How the agenda knows the time | 306 | * Time-of-day specifications:: How the agenda knows the time |
| 306 | * Sorting of agenda items:: The order of things | 307 | * Sorting of agenda items:: The order of things |
| 307 | 308 | ||
| 308 | Custom agenda views | 309 | Custom agenda views |
| 309 | 310 | ||
| 310 | * Storing searches:: Type once, use often | 311 | * Storing searches:: Type once, use often |
| 311 | * Block agenda:: All the stuff you need in a single buffer | 312 | * Block agenda:: All the stuff you need in a single buffer |
| 312 | * Setting Options:: Changing the rules | 313 | * Setting Options:: Changing the rules |
| 313 | 314 | ||
| 314 | Markup for rich export | 315 | Markup for rich export |
| 315 | 316 | ||
| 316 | * Structural markup elements:: The basic structure as seen by the exporter | 317 | * Structural markup elements:: The basic structure as seen by the exporter |
| 317 | * Images and tables:: Tables and Images will be included | 318 | * Images and tables:: Tables and Images will be included |
| 318 | * Literal examples:: Source code examples with special formatting | 319 | * Literal examples:: Source code examples with special formatting |
| 319 | * Include files:: Include additional files into a document | 320 | * Include files:: Include additional files into a document |
| 320 | * Index entries:: Making an index | 321 | * Index entries:: Making an index |
| 321 | * Macro replacement:: Use macros to create complex output | 322 | * Macro replacement:: Use macros to create complex output |
| 322 | * Embedded LaTeX:: LaTeX can be freely used inside Org documents | 323 | * Embedded LaTeX:: LaTeX can be freely used inside Org documents |
| 323 | 324 | ||
| 324 | Structural markup elements | 325 | Structural markup elements |
| 325 | 326 | ||
| 326 | * Document title:: Where the title is taken from | 327 | * Document title:: Where the title is taken from |
| 327 | * Headings and sections:: The document structure as seen by the exporter | 328 | * Headings and sections:: The document structure as seen by the exporter |
| 328 | * Table of contents:: The if and where of the table of contents | 329 | * Table of contents:: The if and where of the table of contents |
| 329 | * Initial text:: Text before the first heading? | 330 | * Initial text:: Text before the first heading? |
| 330 | * Lists:: Lists | 331 | * Lists:: Lists |
| 331 | * Paragraphs:: Paragraphs | 332 | * Paragraphs:: Paragraphs |
| 332 | * Footnote markup:: Footnotes | 333 | * Footnote markup:: Footnotes |
| 333 | * Emphasis and monospace:: Bold, italic, etc. | 334 | * Emphasis and monospace:: Bold, italic, etc. |
| 334 | * Horizontal rules:: Make a line | 335 | * Horizontal rules:: Make a line |
| 335 | * Comment lines:: What will *not* be exported | 336 | * Comment lines:: What will *not* be exported |
| 336 | 337 | ||
| 337 | Embedded La@TeX{} | 338 | Embedded La@TeX{} |
| 338 | 339 | ||
| 339 | * Special symbols:: Greek letters and other symbols | 340 | * Special symbols:: Greek letters and other symbols |
| 340 | * Subscripts and superscripts:: Simple syntax for raising/lowering text | 341 | * Subscripts and superscripts:: Simple syntax for raising/lowering text |
| 341 | * LaTeX fragments:: Complex formulas made easy | 342 | * LaTeX fragments:: Complex formulas made easy |
| 342 | * Previewing LaTeX fragments:: What will this snippet look like? | 343 | * Previewing LaTeX fragments:: What will this snippet look like? |
| 343 | * CDLaTeX mode:: Speed up entering of formulas | 344 | * CDLaTeX mode:: Speed up entering of formulas |
| 344 | 345 | ||
| 345 | Exporting | 346 | Exporting |
| 346 | 347 | ||
| 347 | * Selective export:: Using tags to select and exclude trees | 348 | * Selective export:: Using tags to select and exclude trees |
| 348 | * Export options:: Per-file export settings | 349 | * Export options:: Per-file export settings |
| 349 | * The export dispatcher:: How to access exporter commands | 350 | * The export dispatcher:: How to access exporter commands |
| 350 | * ASCII/Latin-1/UTF-8 export:: Exporting to flat files with encoding | 351 | * ASCII/Latin-1/UTF-8 export:: Exporting to flat files with encoding |
| 351 | * HTML export:: Exporting to HTML | 352 | * HTML export:: Exporting to HTML |
| 352 | * LaTeX and PDF export:: Exporting to La@TeX{}, and processing to PDF | 353 | * LaTeX and PDF export:: Exporting to La@TeX{}, and processing to PDF |
| 353 | * DocBook export:: Exporting to DocBook | 354 | * DocBook export:: Exporting to DocBook |
| 354 | * TaskJuggler export:: Exporting to TaskJuggler | 355 | * TaskJuggler export:: Exporting to TaskJuggler |
| 355 | * Freemind export:: Exporting to Freemind mind maps | 356 | * Freemind export:: Exporting to Freemind mind maps |
| 356 | * XOXO export:: Exporting to XOXO | 357 | * XOXO export:: Exporting to XOXO |
| 357 | * iCalendar export:: Exporting in iCalendar format | 358 | * iCalendar export:: Exporting in iCalendar format |
| 358 | 359 | ||
| 359 | HTML export | 360 | HTML export |
| 360 | 361 | ||
| 361 | * HTML Export commands:: How to invoke HTML export | 362 | * HTML Export commands:: How to invoke HTML export |
| 362 | * Quoting HTML tags:: Using direct HTML in Org-mode | 363 | * Quoting HTML tags:: Using direct HTML in Org-mode |
| 363 | * Links in HTML export:: How links will be interpreted and formatted | 364 | * Links in HTML export:: How links will be interpreted and formatted |
| 364 | * Tables in HTML export:: How to modify the formatting of tables | 365 | * Tables in HTML export:: How to modify the formatting of tables |
| 365 | * Images in HTML export:: How to insert figures into HTML output | 366 | * Images in HTML export:: How to insert figures into HTML output |
| 366 | * Text areas in HTML export:: An alternative way to show an example | 367 | * Text areas in HTML export:: An alternative way to show an example |
| 367 | * CSS support:: Changing the appearance of the output | 368 | * CSS support:: Changing the appearance of the output |
| 368 | * JavaScript support:: Info and Folding in a web browser | 369 | * JavaScript support:: Info and Folding in a web browser |
| 369 | 370 | ||
| 370 | La@TeX{} and PDF export | 371 | La@TeX{} and PDF export |
| 371 | 372 | ||
| 372 | * LaTeX/PDF export commands:: Which key invokes which commands | 373 | * LaTeX/PDF export commands:: Which key invokes which commands |
| 373 | * Header and sectioning:: Setting up the export file structure | 374 | * Header and sectioning:: Setting up the export file structure |
| 374 | * Quoting LaTeX code:: Incorporating literal La@TeX{} code | 375 | * Quoting LaTeX code:: Incorporating literal La@TeX{} code |
| 375 | * Tables in LaTeX export:: Options for exporting tables to La@TeX{} | 376 | * Tables in LaTeX export:: Options for exporting tables to La@TeX{} |
| 376 | * Images in LaTeX export:: How to insert figures into La@TeX{} output | 377 | * Images in LaTeX export:: How to insert figures into La@TeX{} output |
| 377 | * Beamer class export:: Turning the file into a presentation | 378 | * Beamer class export:: Turning the file into a presentation |
| 378 | 379 | ||
| 379 | DocBook export | 380 | DocBook export |
| 380 | 381 | ||
| 381 | * DocBook export commands:: How to invoke DocBook export | 382 | * DocBook export commands:: How to invoke DocBook export |
| 382 | * Quoting DocBook code:: Incorporating DocBook code in Org files | 383 | * Quoting DocBook code:: Incorporating DocBook code in Org files |
| 383 | * Recursive sections:: Recursive sections in DocBook | 384 | * Recursive sections:: Recursive sections in DocBook |
| 384 | * Tables in DocBook export:: Tables are exported as HTML tables | 385 | * Tables in DocBook export:: Tables are exported as HTML tables |
| 385 | * Images in DocBook export:: How to insert figures into DocBook output | 386 | * Images in DocBook export:: How to insert figures into DocBook output |
| 386 | * Special characters:: How to handle special characters | 387 | * Special characters:: How to handle special characters |
| 387 | 388 | ||
| 388 | Publishing | 389 | Publishing |
| 389 | 390 | ||
| 390 | * Configuration:: Defining projects | 391 | * Configuration:: Defining projects |
| 391 | * Uploading files:: How to get files up on the server | 392 | * Uploading files:: How to get files up on the server |
| 392 | * Sample configuration:: Example projects | 393 | * Sample configuration:: Example projects |
| 393 | * Triggering publication:: Publication commands | 394 | * Triggering publication:: Publication commands |
| 394 | 395 | ||
| 395 | Configuration | 396 | Configuration |
| 396 | 397 | ||
| 397 | * Project alist:: The central configuration variable | 398 | * Project alist:: The central configuration variable |
| 398 | * Sources and destinations:: From here to there | 399 | * Sources and destinations:: From here to there |
| 399 | * Selecting files:: What files are part of the project? | 400 | * Selecting files:: What files are part of the project? |
| 400 | * Publishing action:: Setting the function doing the publishing | 401 | * Publishing action:: Setting the function doing the publishing |
| 401 | * Publishing options:: Tweaking HTML export | 402 | * Publishing options:: Tweaking HTML export |
| 402 | * Publishing links:: Which links keep working after publishing? | 403 | * Publishing links:: Which links keep working after publishing? |
| 403 | * Sitemap:: Generating a list of all pages | 404 | * Sitemap:: Generating a list of all pages |
| 404 | * Generating an index:: An index that reaches across pages | 405 | * Generating an index:: An index that reaches across pages |
| 405 | 406 | ||
| 406 | Sample configuration | 407 | Sample configuration |
| 407 | 408 | ||
| 408 | * Simple example:: One-component publishing | 409 | * Simple example:: One-component publishing |
| 409 | * Complex example:: A multi-component publishing example | 410 | * Complex example:: A multi-component publishing example |
| 410 | 411 | ||
| 411 | Working with source code | 412 | Working with source code |
| 412 | 413 | ||
| 413 | * Structure of code blocks:: Code block syntax described | 414 | * Structure of code blocks:: Code block syntax described |
| 414 | * Editing source code:: Language major-mode editing | 415 | * Editing source code:: Language major-mode editing |
| 415 | * Exporting code blocks:: Export contents and/or results | 416 | * Exporting code blocks:: Export contents and/or results |
| 416 | * Extracting source code:: Create pure source code files | 417 | * Extracting source code:: Create pure source code files |
| 417 | * Evaluating code blocks:: Place results of evaluation in the Org-mode buffer | 418 | * Evaluating code blocks:: Place results of evaluation in the Org-mode buffer |
| 418 | * Library of Babel:: Use and contribute to a library of useful code blocks | 419 | * Library of Babel:: Use and contribute to a library of useful code blocks |
| 419 | * Languages:: List of supported code block languages | 420 | * Languages:: List of supported code block languages |
| 420 | * Header arguments:: Configure code block functionality | 421 | * Header arguments:: Configure code block functionality |
| 421 | * Results of evaluation:: How evaluation results are handled | 422 | * Results of evaluation:: How evaluation results are handled |
| 422 | * Noweb reference syntax:: Literate programming in Org-mode | 423 | * Noweb reference syntax:: Literate programming in Org-mode |
| 423 | * Key bindings and useful functions:: Work quickly with code blocks | 424 | * Key bindings and useful functions:: Work quickly with code blocks |
| 424 | * Batch execution:: Call functions from the command line | 425 | * Batch execution:: Call functions from the command line |
| 425 | 426 | ||
| 426 | Header arguments | 427 | Header arguments |
| 427 | 428 | ||
| 428 | * Using header arguments:: Different ways to set header arguments | 429 | * Using header arguments:: Different ways to set header arguments |
| 429 | * Specific header arguments:: List of header arguments | 430 | * Specific header arguments:: List of header arguments |
| 430 | 431 | ||
| 431 | Using header arguments | 432 | Using header arguments |
| 432 | 433 | ||
| 433 | * System-wide header arguments:: Set global default values | 434 | * System-wide header arguments:: Set global default values |
| 434 | * Language-specific header arguments:: Set default values by language | 435 | * Language-specific header arguments:: Set default values by language |
| 435 | * Buffer-wide header arguments:: Set default values for a specific buffer | 436 | * Buffer-wide header arguments:: Set default values for a specific buffer |
| 436 | * Header arguments in Org-mode properties:: Set default values for a buffer or heading | 437 | * Header arguments in Org-mode properties:: Set default values for a buffer or heading |
| 437 | * Code block specific header arguments:: The most common way to set values | 438 | * Code block specific header arguments:: The most common way to set values |
| 438 | 439 | ||
| 439 | Specific header arguments | 440 | Specific header arguments |
| 440 | 441 | ||
| 441 | * var:: Pass arguments to code blocks | 442 | * var:: Pass arguments to code blocks |
| 442 | * results:: Specify the type of results and how they will be collected and handled | 443 | * results:: Specify the type of results and how they will be collected and handled |
| 443 | * file:: Specify a path for file output | 444 | * file:: Specify a path for file output |
| 444 | * dir:: Specify the default directory for code block execution | 445 | * dir:: Specify the default directory for code block execution |
| 445 | * exports:: Export code and/or results | 446 | * exports:: Export code and/or results |
| 446 | * tangle:: Toggle tangling and specify file name | 447 | * tangle:: Toggle tangling and specify file name |
| 447 | * no-expand:: Turn off variable assignment and noweb expansion during tangling | 448 | * no-expand:: Turn off variable assignment and noweb expansion during tangling |
| 448 | * session:: Preserve the state of code evaluation | 449 | * session:: Preserve the state of code evaluation |
| 449 | * noweb:: Toggle expansion of noweb references | 450 | * noweb:: Toggle expansion of noweb references |
| 450 | * cache:: Avoid re-evaluating unchanged code blocks | 451 | * cache:: Avoid re-evaluating unchanged code blocks |
| 451 | * hlines:: Handle horizontal lines in tables | 452 | * hlines:: Handle horizontal lines in tables |
| 452 | * colnames:: Handle column names in tables | 453 | * colnames:: Handle column names in tables |
| 453 | * rownames:: Handle row names in tables | 454 | * rownames:: Handle row names in tables |
| 454 | * shebang:: Make tangled files executable | 455 | * shebang:: Make tangled files executable |
| 455 | 456 | ||
| 456 | Miscellaneous | 457 | Miscellaneous |
| 457 | 458 | ||
| 458 | * Completion:: M-TAB knows what you need | 459 | * Completion:: M-TAB knows what you need |
| 459 | * Speed keys:: Electric commands at the beginning of a headline | 460 | * Speed keys:: Electric commands at the beginning of a headline |
| 460 | * Code evaluation security:: Org mode files evaluate inline code | 461 | * Code evaluation security:: Org mode files evaluate inline code |
| 461 | * Customization:: Adapting Org to your taste | 462 | * Customization:: Adapting Org to your taste |
| 462 | * In-buffer settings:: Overview of the #+KEYWORDS | 463 | * In-buffer settings:: Overview of the #+KEYWORDS |
| 463 | * The very busy C-c C-c key:: When in doubt, press C-c C-c | 464 | * The very busy C-c C-c key:: When in doubt, press C-c C-c |
| 464 | * Clean view:: Getting rid of leading stars in the outline | 465 | * Clean view:: Getting rid of leading stars in the outline |
| 465 | * TTY keys:: Using Org on a tty | 466 | * TTY keys:: Using Org on a tty |
| 466 | * Interaction:: Other Emacs packages | 467 | * Interaction:: Other Emacs packages |
| 467 | 468 | ||
| 468 | Interaction with other packages | 469 | Interaction with other packages |
| 469 | 470 | ||
| 470 | * Cooperation:: Packages Org cooperates with | 471 | * Cooperation:: Packages Org cooperates with |
| 471 | * Conflicts:: Packages that lead to conflicts | 472 | * Conflicts:: Packages that lead to conflicts |
| 472 | 473 | ||
| 473 | Hacking | 474 | Hacking |
| 474 | 475 | ||
| 475 | * Hooks:: Who to reach into Org's internals | 476 | * Hooks:: Who to reach into Org's internals |
| 476 | * Add-on packages:: Available extensions | 477 | * Add-on packages:: Available extensions |
| 477 | * Adding hyperlink types:: New custom link types | 478 | * Adding hyperlink types:: New custom link types |
| 478 | * Context-sensitive commands:: How to add functionality to such commands | 479 | * Context-sensitive commands:: How to add functionality to such commands |
| 479 | * Tables in arbitrary syntax:: Orgtbl for La@TeX{} and other programs | 480 | * Tables in arbitrary syntax:: Orgtbl for La@TeX{} and other programs |
| 480 | * Dynamic blocks:: Automatically filled blocks | 481 | * Dynamic blocks:: Automatically filled blocks |
| 481 | * Special agenda views:: Customized views | 482 | * Special agenda views:: Customized views |
| 482 | * Extracting agenda information:: Postprocessing of agenda information | 483 | * Extracting agenda information:: Postprocessing of agenda information |
| 483 | * Using the property API:: Writing programs that use entry properties | 484 | * Using the property API:: Writing programs that use entry properties |
| 484 | * Using the mapping API:: Mapping over all or selected entries | 485 | * Using the mapping API:: Mapping over all or selected entries |
| 485 | 486 | ||
| 486 | Tables and lists in arbitrary syntax | 487 | Tables and lists in arbitrary syntax |
| 487 | 488 | ||
| 488 | * Radio tables:: Sending and receiving radio tables | 489 | * Radio tables:: Sending and receiving radio tables |
| 489 | * A LaTeX example:: Step by step, almost a tutorial | 490 | * A LaTeX example:: Step by step, almost a tutorial |
| 490 | * Translator functions:: Copy and modify | 491 | * Translator functions:: Copy and modify |
| 491 | * Radio lists:: Doing the same for lists | 492 | * Radio lists:: Doing the same for lists |
| 492 | 493 | ||
| 493 | MobileOrg | 494 | MobileOrg |
| 494 | 495 | ||
| 495 | * Setting up the staging area:: Where to interact with the mobile device | 496 | * Setting up the staging area:: Where to interact with the mobile device |
| 496 | * Pushing to MobileOrg:: Uploading Org files and agendas | 497 | * Pushing to MobileOrg:: Uploading Org files and agendas |
| 497 | * Pulling from MobileOrg:: Integrating captured and flagged items | 498 | * Pulling from MobileOrg:: Integrating captured and flagged items |
| 498 | 499 | ||
| 499 | @end detailmenu | 500 | @end detailmenu |
| 500 | @end menu | 501 | @end menu |
| @@ -504,11 +505,11 @@ MobileOrg | |||
| 504 | @cindex introduction | 505 | @cindex introduction |
| 505 | 506 | ||
| 506 | @menu | 507 | @menu |
| 507 | * Summary:: Brief summary of what Org does | 508 | * Summary:: Brief summary of what Org does |
| 508 | * Installation:: How to install a downloaded version of Org | 509 | * Installation:: How to install a downloaded version of Org |
| 509 | * Activation:: How to activate Org for certain buffers | 510 | * Activation:: How to activate Org for certain buffers |
| 510 | * Feedback:: Bug reports, ideas, patches etc. | 511 | * Feedback:: Bug reports, ideas, patches etc. |
| 511 | * Conventions:: Type-setting conventions in the manual | 512 | * Conventions:: Type-setting conventions in the manual |
| 512 | @end menu | 513 | @end menu |
| 513 | 514 | ||
| 514 | @node Summary, Installation, Introduction, Introduction | 515 | @node Summary, Installation, Introduction, Introduction |
| @@ -805,17 +806,17 @@ Org is based on Outline mode and provides flexible commands to | |||
| 805 | edit the structure of the document. | 806 | edit the structure of the document. |
| 806 | 807 | ||
| 807 | @menu | 808 | @menu |
| 808 | * Outlines:: Org is based on Outline mode | 809 | * Outlines:: Org is based on Outline mode |
| 809 | * Headlines:: How to typeset Org tree headlines | 810 | * Headlines:: How to typeset Org tree headlines |
| 810 | * Visibility cycling:: Show and hide, much simplified | 811 | * Visibility cycling:: Show and hide, much simplified |
| 811 | * Motion:: Jumping to other headlines | 812 | * Motion:: Jumping to other headlines |
| 812 | * Structure editing:: Changing sequence and level of headlines | 813 | * Structure editing:: Changing sequence and level of headlines |
| 813 | * Sparse trees:: Matches embedded in context | 814 | * Sparse trees:: Matches embedded in context |
| 814 | * Plain lists:: Additional structure within an entry | 815 | * Plain lists:: Additional structure within an entry |
| 815 | * Drawers:: Tucking stuff away | 816 | * Drawers:: Tucking stuff away |
| 816 | * Blocks:: Folding blocks | 817 | * Blocks:: Folding blocks |
| 817 | * Footnotes:: How footnotes are defined in Org's syntax | 818 | * Footnotes:: How footnotes are defined in Org's syntax |
| 818 | * Orgstruct mode:: Structure editing outside Org | 819 | * Orgstruct mode:: Structure editing outside Org |
| 819 | @end menu | 820 | @end menu |
| 820 | 821 | ||
| 821 | @node Outlines, Headlines, Document Structure, Document Structure | 822 | @node Outlines, Headlines, Document Structure, Document Structure |
| @@ -1640,12 +1641,12 @@ calculator). | |||
| 1640 | @end ifnotinfo | 1641 | @end ifnotinfo |
| 1641 | 1642 | ||
| 1642 | @menu | 1643 | @menu |
| 1643 | * Built-in table editor:: Simple tables | 1644 | * Built-in table editor:: Simple tables |
| 1644 | * Column width and alignment:: Overrule the automatic settings | 1645 | * Column width and alignment:: Overrule the automatic settings |
| 1645 | * Column groups:: Grouping to trigger vertical lines | 1646 | * Column groups:: Grouping to trigger vertical lines |
| 1646 | * Orgtbl mode:: The table editor as minor mode | 1647 | * Orgtbl mode:: The table editor as minor mode |
| 1647 | * The spreadsheet:: The table editor has spreadsheet capabilities | 1648 | * The spreadsheet:: The table editor has spreadsheet capabilities |
| 1648 | * Org-Plot:: Plotting from org tables | 1649 | * Org-Plot:: Plotting from org tables |
| 1649 | @end menu | 1650 | @end menu |
| 1650 | 1651 | ||
| 1651 | @node Built-in table editor, Column width and alignment, Tables, Tables | 1652 | @node Built-in table editor, Column width and alignment, Tables, Tables |
| @@ -2019,14 +2020,14 @@ fields in the table corresponding to the references at the point in the | |||
| 2019 | formula, moving these references by arrow keys | 2020 | formula, moving these references by arrow keys |
| 2020 | 2021 | ||
| 2021 | @menu | 2022 | @menu |
| 2022 | * References:: How to refer to another field or range | 2023 | * References:: How to refer to another field or range |
| 2023 | * Formula syntax for Calc:: Using Calc to compute stuff | 2024 | * Formula syntax for Calc:: Using Calc to compute stuff |
| 2024 | * Formula syntax for Lisp:: Writing formulas in Emacs Lisp | 2025 | * Formula syntax for Lisp:: Writing formulas in Emacs Lisp |
| 2025 | * Field formulas:: Formulas valid for a single field | 2026 | * Field formulas:: Formulas valid for a single field |
| 2026 | * Column formulas:: Formulas valid for an entire column | 2027 | * Column formulas:: Formulas valid for an entire column |
| 2027 | * Editing and debugging formulas:: Fixing formulas | 2028 | * Editing and debugging formulas:: Fixing formulas |
| 2028 | * Updating the table:: Recomputing all dependent fields | 2029 | * Updating the table:: Recomputing all dependent fields |
| 2029 | * Advanced features:: Field names, parameters and automatic recalc | 2030 | * Advanced features:: Field names, parameters and automatic recalc |
| 2030 | @end menu | 2031 | @end menu |
| 2031 | 2032 | ||
| 2032 | @node References, Formula syntax for Calc, The spreadsheet, The spreadsheet | 2033 | @node References, Formula syntax for Calc, The spreadsheet, The spreadsheet |
| @@ -2730,14 +2731,14 @@ Like HTML, Org provides links inside a file, external links to | |||
| 2730 | other files, Usenet articles, emails, and much more. | 2731 | other files, Usenet articles, emails, and much more. |
| 2731 | 2732 | ||
| 2732 | @menu | 2733 | @menu |
| 2733 | * Link format:: How links in Org are formatted | 2734 | * Link format:: How links in Org are formatted |
| 2734 | * Internal links:: Links to other places in the current file | 2735 | * Internal links:: Links to other places in the current file |
| 2735 | * External links:: URL-like links to the world | 2736 | * External links:: URL-like links to the world |
| 2736 | * Handling links:: Creating, inserting and following | 2737 | * Handling links:: Creating, inserting and following |
| 2737 | * Using links outside Org:: Linking from my C source code? | 2738 | * Using links outside Org:: Linking from my C source code? |
| 2738 | * Link abbreviations:: Shortcuts for writing complex links | 2739 | * Link abbreviations:: Shortcuts for writing complex links |
| 2739 | * Search options:: Linking to a specific location | 2740 | * Search options:: Linking to a specific location |
| 2740 | * Custom searches:: When the default search is not enough | 2741 | * Custom searches:: When the default search is not enough |
| 2741 | @end menu | 2742 | @end menu |
| 2742 | 2743 | ||
| 2743 | @node Link format, Internal links, Hyperlinks, Hyperlinks | 2744 | @node Link format, Internal links, Hyperlinks, Hyperlinks |
| @@ -2830,7 +2831,7 @@ several times in direct succession goes back to positions recorded | |||
| 2830 | earlier. | 2831 | earlier. |
| 2831 | 2832 | ||
| 2832 | @menu | 2833 | @menu |
| 2833 | * Radio targets:: Make targets trigger links in plain text | 2834 | * Radio targets:: Make targets trigger links in plain text |
| 2834 | @end menu | 2835 | @end menu |
| 2835 | 2836 | ||
| 2836 | @node Radio targets, , Internal links, Internal links | 2837 | @node Radio targets, , Internal links, Internal links |
| @@ -3285,12 +3286,12 @@ throughout your notes file. Org-mode compensates for this by providing | |||
| 3285 | methods to give you an overview of all the things that you have to do. | 3286 | methods to give you an overview of all the things that you have to do. |
| 3286 | 3287 | ||
| 3287 | @menu | 3288 | @menu |
| 3288 | * TODO basics:: Marking and displaying TODO entries | 3289 | * TODO basics:: Marking and displaying TODO entries |
| 3289 | * TODO extensions:: Workflow and assignments | 3290 | * TODO extensions:: Workflow and assignments |
| 3290 | * Progress logging:: Dates and notes for progress | 3291 | * Progress logging:: Dates and notes for progress |
| 3291 | * Priorities:: Some things are more important than others | 3292 | * Priorities:: Some things are more important than others |
| 3292 | * Breaking down tasks:: Splitting a task into manageable pieces | 3293 | * Breaking down tasks:: Splitting a task into manageable pieces |
| 3293 | * Checkboxes:: Tick-off lists | 3294 | * Checkboxes:: Tick-off lists |
| 3294 | @end menu | 3295 | @end menu |
| 3295 | 3296 | ||
| 3296 | @node TODO basics, TODO extensions, TODO Items, TODO Items | 3297 | @node TODO basics, TODO extensions, TODO Items, TODO Items |
| @@ -3382,13 +3383,13 @@ Note that @i{tags} are another way to classify headlines in general and | |||
| 3382 | TODO items in particular (@pxref{Tags}). | 3383 | TODO items in particular (@pxref{Tags}). |
| 3383 | 3384 | ||
| 3384 | @menu | 3385 | @menu |
| 3385 | * Workflow states:: From TODO to DONE in steps | 3386 | * Workflow states:: From TODO to DONE in steps |
| 3386 | * TODO types:: I do this, Fred does the rest | 3387 | * TODO types:: I do this, Fred does the rest |
| 3387 | * Multiple sets in one file:: Mixing it all, and still finding your way | 3388 | * Multiple sets in one file:: Mixing it all, and still finding your way |
| 3388 | * Fast access to TODO states:: Single letter selection of a state | 3389 | * Fast access to TODO states:: Single letter selection of a state |
| 3389 | * Per-file keywords:: Different files, different requirements | 3390 | * Per-file keywords:: Different files, different requirements |
| 3390 | * Faces for TODO keywords:: Highlighting states | 3391 | * Faces for TODO keywords:: Highlighting states |
| 3391 | * TODO dependencies:: When one task needs to wait for others | 3392 | * TODO dependencies:: When one task needs to wait for others |
| 3392 | @end menu | 3393 | @end menu |
| 3393 | 3394 | ||
| 3394 | @node Workflow states, TODO types, TODO extensions, TODO extensions | 3395 | @node Workflow states, TODO types, TODO extensions, TODO extensions |
| @@ -3679,9 +3680,9 @@ information on how to clock working time for a task, see @ref{Clocking | |||
| 3679 | work time}. | 3680 | work time}. |
| 3680 | 3681 | ||
| 3681 | @menu | 3682 | @menu |
| 3682 | * Closing items:: When was this entry marked DONE? | 3683 | * Closing items:: When was this entry marked DONE? |
| 3683 | * Tracking TODO state changes:: When did the status change? | 3684 | * Tracking TODO state changes:: When did the status change? |
| 3684 | * Tracking your habits:: How consistent have you been? | 3685 | * Tracking your habits:: How consistent have you been? |
| 3685 | @end menu | 3686 | @end menu |
| 3686 | 3687 | ||
| 3687 | @node Closing items, Tracking TODO state changes, Progress logging, Progress logging | 3688 | @node Closing items, Tracking TODO state changes, Progress logging, Progress logging |
| @@ -4143,9 +4144,9 @@ You may specify special faces for specific tags using the variable | |||
| 4143 | (@pxref{Faces for TODO keywords}). | 4144 | (@pxref{Faces for TODO keywords}). |
| 4144 | 4145 | ||
| 4145 | @menu | 4146 | @menu |
| 4146 | * Tag inheritance:: Tags use the tree structure of the outline | 4147 | * Tag inheritance:: Tags use the tree structure of the outline |
| 4147 | * Setting tags:: How to assign tags to a headline | 4148 | * Setting tags:: How to assign tags to a headline |
| 4148 | * Tag searches:: Searching for combinations of tags | 4149 | * Tag searches:: Searching for combinations of tags |
| 4149 | @end menu | 4150 | @end menu |
| 4150 | 4151 | ||
| 4151 | @node Tag inheritance, Setting tags, Tags, Tags | 4152 | @node Tag inheritance, Setting tags, Tags, Tags |
| @@ -4432,12 +4433,12 @@ Properties can be conveniently edited and viewed in column view | |||
| 4432 | (@pxref{Column view}). | 4433 | (@pxref{Column view}). |
| 4433 | 4434 | ||
| 4434 | @menu | 4435 | @menu |
| 4435 | * Property syntax:: How properties are spelled out | 4436 | * Property syntax:: How properties are spelled out |
| 4436 | * Special properties:: Access to other Org-mode features | 4437 | * Special properties:: Access to other Org-mode features |
| 4437 | * Property searches:: Matching property values | 4438 | * Property searches:: Matching property values |
| 4438 | * Property inheritance:: Passing values down the tree | 4439 | * Property inheritance:: Passing values down the tree |
| 4439 | * Column view:: Tabular viewing and editing | 4440 | * Column view:: Tabular viewing and editing |
| 4440 | * Property API:: Properties for Lisp programmers | 4441 | * Property API:: Properties for Lisp programmers |
| 4441 | @end menu | 4442 | @end menu |
| 4442 | 4443 | ||
| 4443 | @node Property syntax, Special properties, Properties and Columns, Properties and Columns | 4444 | @node Property syntax, Special properties, Properties and Columns, Properties and Columns |
| @@ -4673,9 +4674,9 @@ Column view also works in agenda buffers (@pxref{Agenda Views}) where | |||
| 4673 | queries have collected selected items, possibly from a number of files. | 4674 | queries have collected selected items, possibly from a number of files. |
| 4674 | 4675 | ||
| 4675 | @menu | 4676 | @menu |
| 4676 | * Defining columns:: The COLUMNS format property | 4677 | * Defining columns:: The COLUMNS format property |
| 4677 | * Using column view:: How to create and use column view | 4678 | * Using column view:: How to create and use column view |
| 4678 | * Capturing column view:: A dynamic block for column view | 4679 | * Capturing column view:: A dynamic block for column view |
| 4679 | @end menu | 4680 | @end menu |
| 4680 | 4681 | ||
| 4681 | @node Defining columns, Using column view, Column view, Column view | 4682 | @node Defining columns, Using column view, Column view, Column view |
| @@ -4687,8 +4688,8 @@ Setting up a column view first requires defining the columns. This is | |||
| 4687 | done by defining a column format line. | 4688 | done by defining a column format line. |
| 4688 | 4689 | ||
| 4689 | @menu | 4690 | @menu |
| 4690 | * Scope of column definitions:: Where defined, where valid? | 4691 | * Scope of column definitions:: Where defined, where valid? |
| 4691 | * Column attributes:: Appearance and content of a column | 4692 | * Column attributes:: Appearance and content of a column |
| 4692 | @end menu | 4693 | @end menu |
| 4693 | 4694 | ||
| 4694 | @node Scope of column definitions, Column attributes, Defining columns, Defining columns | 4695 | @node Scope of column definitions, Column attributes, Defining columns, Defining columns |
| @@ -4770,7 +4771,7 @@ values. | |||
| 4770 | 4771 | ||
| 4771 | @example | 4772 | @example |
| 4772 | :COLUMNS: %25ITEM %9Approved(Approved?)@{X@} %Owner %11Status \@footnote{Please note that the COLUMNS definition must be on a single line---it is wrapped here only because of formatting constraints.} | 4773 | :COLUMNS: %25ITEM %9Approved(Approved?)@{X@} %Owner %11Status \@footnote{Please note that the COLUMNS definition must be on a single line---it is wrapped here only because of formatting constraints.} |
| 4773 | %10Time_Estimate@{:@} %CLOCKSUM | 4774 | %10Time_Estimate@{:@} %CLOCKSUM |
| 4774 | :Owner_ALL: Tammy Mark Karl Lisa Don | 4775 | :Owner_ALL: Tammy Mark Karl Lisa Don |
| 4775 | :Status_ALL: "In progress" "Not started yet" "Finished" "" | 4776 | :Status_ALL: "In progress" "Not started yet" "Finished" "" |
| 4776 | :Approved_ALL: "[ ]" "[X]" | 4777 | :Approved_ALL: "[ ]" "[X]" |
| @@ -4970,13 +4971,13 @@ something was created or last changed. However, in Org-mode this term | |||
| 4970 | is used in a much wider sense. | 4971 | is used in a much wider sense. |
| 4971 | 4972 | ||
| 4972 | @menu | 4973 | @menu |
| 4973 | * Timestamps:: Assigning a time to a tree entry | 4974 | * Timestamps:: Assigning a time to a tree entry |
| 4974 | * Creating timestamps:: Commands which insert timestamps | 4975 | * Creating timestamps:: Commands which insert timestamps |
| 4975 | * Deadlines and scheduling:: Planning your work | 4976 | * Deadlines and scheduling:: Planning your work |
| 4976 | * Clocking work time:: Tracking how long you spend on a task | 4977 | * Clocking work time:: Tracking how long you spend on a task |
| 4977 | * Resolving idle time:: Resolving time if you've been idle | 4978 | * Resolving idle time:: Resolving time if you've been idle |
| 4978 | * Effort estimates:: Planning work effort in advance | 4979 | * Effort estimates:: Planning work effort in advance |
| 4979 | * Relative timer:: Notes with a running timer | 4980 | * Relative timer:: Notes with a running timer |
| 4980 | @end menu | 4981 | @end menu |
| 4981 | 4982 | ||
| 4982 | 4983 | ||
| @@ -5132,8 +5133,8 @@ the following column). | |||
| 5132 | 5133 | ||
| 5133 | 5134 | ||
| 5134 | @menu | 5135 | @menu |
| 5135 | * The date/time prompt:: How Org-mode helps you entering date and time | 5136 | * The date/time prompt:: How Org-mode helps you entering date and time |
| 5136 | * Custom time format:: Making dates look different | 5137 | * Custom time format:: Making dates look different |
| 5137 | @end menu | 5138 | @end menu |
| 5138 | 5139 | ||
| 5139 | @node The date/time prompt, Custom time format, Creating timestamps, Creating timestamps | 5140 | @node The date/time prompt, Custom time format, Creating timestamps, Creating timestamps |
| @@ -5365,8 +5366,8 @@ late warnings. However, it will show the item on each day where the | |||
| 5365 | sexp entry matches. | 5366 | sexp entry matches. |
| 5366 | 5367 | ||
| 5367 | @menu | 5368 | @menu |
| 5368 | * Inserting deadline/schedule:: Planning items | 5369 | * Inserting deadline/schedule:: Planning items |
| 5369 | * Repeated tasks:: Items that show up again and again | 5370 | * Repeated tasks:: Items that show up again and again |
| 5370 | @end menu | 5371 | @end menu |
| 5371 | 5372 | ||
| 5372 | @node Inserting deadline/schedule, Repeated tasks, Deadlines and scheduling, Deadlines and scheduling | 5373 | @node Inserting deadline/schedule, Repeated tasks, Deadlines and scheduling, Deadlines and scheduling |
| @@ -5888,12 +5889,12 @@ system, tasks and projects need to be moved around. Moving completed project | |||
| 5888 | trees to an archive file keeps the system compact and fast. | 5889 | trees to an archive file keeps the system compact and fast. |
| 5889 | 5890 | ||
| 5890 | @menu | 5891 | @menu |
| 5891 | * Capture:: Capturing new stuff | 5892 | * Capture:: Capturing new stuff |
| 5892 | * Attachments:: Add files to tasks | 5893 | * Attachments:: Add files to tasks |
| 5893 | * RSS Feeds:: Getting input from RSS feeds | 5894 | * RSS Feeds:: Getting input from RSS feeds |
| 5894 | * Protocols:: External (e.g. Browser) access to Emacs and Org | 5895 | * Protocols:: External (e.g. Browser) access to Emacs and Org |
| 5895 | * Refiling notes:: Moving a tree from one place to another | 5896 | * Refiling notes:: Moving a tree from one place to another |
| 5896 | * Archiving:: What to do with finished projects | 5897 | * Archiving:: What to do with finished projects |
| 5897 | @end menu | 5898 | @end menu |
| 5898 | 5899 | ||
| 5899 | @node Capture, Attachments, Capture - Refile - Archive, Capture - Refile - Archive | 5900 | @node Capture, Attachments, Capture - Refile - Archive, Capture - Refile - Archive |
| @@ -5921,9 +5922,9 @@ flow. The basic process of capturing is very similar to remember, but Org | |||
| 5921 | does enhance it with templates and more. | 5922 | does enhance it with templates and more. |
| 5922 | 5923 | ||
| 5923 | @menu | 5924 | @menu |
| 5924 | * Setting up capture:: Where notes will be stored | 5925 | * Setting up capture:: Where notes will be stored |
| 5925 | * Using capture:: Commands to invoke and terminate capture | 5926 | * Using capture:: Commands to invoke and terminate capture |
| 5926 | * Capture templates:: Define the outline of different note types | 5927 | * Capture templates:: Define the outline of different note types |
| 5927 | @end menu | 5928 | @end menu |
| 5928 | 5929 | ||
| 5929 | @node Setting up capture, Using capture, Capture, Capture | 5930 | @node Setting up capture, Using capture, Capture, Capture |
| @@ -6016,8 +6017,8 @@ place where you started the capture process. | |||
| 6016 | 6017 | ||
| 6017 | 6018 | ||
| 6018 | @menu | 6019 | @menu |
| 6019 | * Template elements:: What is needed for a complete template entry | 6020 | * Template elements:: What is needed for a complete template entry |
| 6020 | * Template expansion:: Filling in information about time and context | 6021 | * Template expansion:: Filling in information about time and context |
| 6021 | @end menu | 6022 | @end menu |
| 6022 | 6023 | ||
| 6023 | @node Template elements, Template expansion, Capture templates, Capture templates | 6024 | @node Template elements, Template expansion, Capture templates, Capture templates |
| @@ -6326,8 +6327,8 @@ information. Here is just an example: | |||
| 6326 | @example | 6327 | @example |
| 6327 | (setq org-feed-alist | 6328 | (setq org-feed-alist |
| 6328 | '(("Slashdot" | 6329 | '(("Slashdot" |
| 6329 | "http://rss.slashdot.org/Slashdot/slashdot" | 6330 | "http://rss.slashdot.org/Slashdot/slashdot" |
| 6330 | "~/txt/org/feeds.org" "Slashdot Entries"))) | 6331 | "~/txt/org/feeds.org" "Slashdot Entries"))) |
| 6331 | @end example | 6332 | @end example |
| 6332 | 6333 | ||
| 6333 | @noindent | 6334 | @noindent |
| @@ -6440,8 +6441,8 @@ Archive the current entry using the command specified in the variable | |||
| 6440 | @end table | 6441 | @end table |
| 6441 | 6442 | ||
| 6442 | @menu | 6443 | @menu |
| 6443 | * Moving subtrees:: Moving a tree to an archive file | 6444 | * Moving subtrees:: Moving a tree to an archive file |
| 6444 | * Internal archiving:: Switch off a tree but keep it in the file | 6445 | * Internal archiving:: Switch off a tree but keep it in the file |
| 6445 | @end menu | 6446 | @end menu |
| 6446 | 6447 | ||
| 6447 | @node Moving subtrees, Internal archiving, Archiving, Archiving | 6448 | @node Moving subtrees, Internal archiving, Archiving, Archiving |
| @@ -6618,14 +6619,14 @@ window configuration is restored when the agenda exits: | |||
| 6618 | @code{org-agenda-restore-windows-after-quit}. | 6619 | @code{org-agenda-restore-windows-after-quit}. |
| 6619 | 6620 | ||
| 6620 | @menu | 6621 | @menu |
| 6621 | * Agenda files:: Files being searched for agenda information | 6622 | * Agenda files:: Files being searched for agenda information |
| 6622 | * Agenda dispatcher:: Keyboard access to agenda views | 6623 | * Agenda dispatcher:: Keyboard access to agenda views |
| 6623 | * Built-in agenda views:: What is available out of the box? | 6624 | * Built-in agenda views:: What is available out of the box? |
| 6624 | * Presentation and sorting:: How agenda items are prepared for display | 6625 | * Presentation and sorting:: How agenda items are prepared for display |
| 6625 | * Agenda commands:: Remote editing of Org trees | 6626 | * Agenda commands:: Remote editing of Org trees |
| 6626 | * Custom agenda views:: Defining special searches and views | 6627 | * Custom agenda views:: Defining special searches and views |
| 6627 | * Exporting Agenda Views:: Writing a view to a file | 6628 | * Exporting Agenda Views:: Writing a view to a file |
| 6628 | * Agenda column view:: Using column view for collected entries | 6629 | * Agenda column view:: Using column view for collected entries |
| 6629 | @end menu | 6630 | @end menu |
| 6630 | 6631 | ||
| 6631 | @node Agenda files, Agenda dispatcher, Agenda Views, Agenda Views | 6632 | @node Agenda files, Agenda dispatcher, Agenda Views, Agenda Views |
| @@ -6767,12 +6768,12 @@ a number of special tags matches. @xref{Custom agenda views}. | |||
| 6767 | In this section we describe the built-in views. | 6768 | In this section we describe the built-in views. |
| 6768 | 6769 | ||
| 6769 | @menu | 6770 | @menu |
| 6770 | * Weekly/daily agenda:: The calendar page with current tasks | 6771 | * Weekly/daily agenda:: The calendar page with current tasks |
| 6771 | * Global TODO list:: All unfinished action items | 6772 | * Global TODO list:: All unfinished action items |
| 6772 | * Matching tags and properties:: Structured information with fine-tuned search | 6773 | * Matching tags and properties:: Structured information with fine-tuned search |
| 6773 | * Timeline:: Time-sorted view for single file | 6774 | * Timeline:: Time-sorted view for single file |
| 6774 | * Search view:: Find entries by searching for text | 6775 | * Search view:: Find entries by searching for text |
| 6775 | * Stuck projects:: Find projects you need to review | 6776 | * Stuck projects:: Find projects you need to review |
| 6776 | @end menu | 6777 | @end menu |
| 6777 | 6778 | ||
| 6778 | @node Weekly/daily agenda, Global TODO list, Built-in agenda views, Built-in agenda views | 6779 | @node Weekly/daily agenda, Global TODO list, Built-in agenda views, Built-in agenda views |
| @@ -7237,9 +7238,9 @@ The prefix is followed by a cleaned-up version of the outline headline | |||
| 7237 | associated with the item. | 7238 | associated with the item. |
| 7238 | 7239 | ||
| 7239 | @menu | 7240 | @menu |
| 7240 | * Categories:: Not all tasks are equal | 7241 | * Categories:: Not all tasks are equal |
| 7241 | * Time-of-day specifications:: How the agenda knows the time | 7242 | * Time-of-day specifications:: How the agenda knows the time |
| 7242 | * Sorting of agenda items:: The order of things | 7243 | * Sorting of agenda items:: The order of things |
| 7243 | @end menu | 7244 | @end menu |
| 7244 | 7245 | ||
| 7245 | @node Categories, Time-of-day specifications, Presentation and sorting, Presentation and sorting | 7246 | @node Categories, Time-of-day specifications, Presentation and sorting, Presentation and sorting |
| @@ -7628,12 +7629,12 @@ Internet, and outside of business hours, with something like this: | |||
| 7628 | @group | 7629 | @group |
| 7629 | (defun org-my-auto-exclude-function (tag) | 7630 | (defun org-my-auto-exclude-function (tag) |
| 7630 | (and (cond | 7631 | (and (cond |
| 7631 | ((string= tag "Net") | 7632 | ((string= tag "Net") |
| 7632 | (/= 0 (call-process "/sbin/ping" nil nil nil | 7633 | (/= 0 (call-process "/sbin/ping" nil nil nil |
| 7633 | "-c1" "-q" "-t1" "mail.gnu.org"))) | 7634 | "-c1" "-q" "-t1" "mail.gnu.org"))) |
| 7634 | ((or (string= tag "Errand") (string= tag "Call")) | 7635 | ((or (string= tag "Errand") (string= tag "Call")) |
| 7635 | (let ((hour (nth 2 (decode-time)))) | 7636 | (let ((hour (nth 2 (decode-time)))) |
| 7636 | (or (< hour 8) (> hour 21))))) | 7637 | (or (< hour 8) (> hour 21))))) |
| 7637 | (concat "-" tag))) | 7638 | (concat "-" tag))) |
| 7638 | 7639 | ||
| 7639 | (setq org-agenda-auto-exclude-function 'org-my-auto-exclude-function) | 7640 | (setq org-agenda-auto-exclude-function 'org-my-auto-exclude-function) |
| @@ -7963,9 +7964,9 @@ agenda buffers. Custom agenda commands will be accessible through the | |||
| 7963 | dispatcher (@pxref{Agenda dispatcher}), just like the default commands. | 7964 | dispatcher (@pxref{Agenda dispatcher}), just like the default commands. |
| 7964 | 7965 | ||
| 7965 | @menu | 7966 | @menu |
| 7966 | * Storing searches:: Type once, use often | 7967 | * Storing searches:: Type once, use often |
| 7967 | * Block agenda:: All the stuff you need in a single buffer | 7968 | * Block agenda:: All the stuff you need in a single buffer |
| 7968 | * Setting Options:: Changing the rules | 7969 | * Setting Options:: Changing the rules |
| 7969 | @end menu | 7970 | @end menu |
| 7970 | 7971 | ||
| 7971 | @node Storing searches, Block agenda, Custom agenda views, Custom agenda views | 7972 | @node Storing searches, Block agenda, Custom agenda views, Custom agenda views |
| @@ -8350,29 +8351,29 @@ Org-mode has rules on how to prepare text for rich export. This section | |||
| 8350 | summarizes the markup rules used in an Org-mode buffer. | 8351 | summarizes the markup rules used in an Org-mode buffer. |
| 8351 | 8352 | ||
| 8352 | @menu | 8353 | @menu |
| 8353 | * Structural markup elements:: The basic structure as seen by the exporter | 8354 | * Structural markup elements:: The basic structure as seen by the exporter |
| 8354 | * Images and tables:: Tables and Images will be included | 8355 | * Images and tables:: Tables and Images will be included |
| 8355 | * Literal examples:: Source code examples with special formatting | 8356 | * Literal examples:: Source code examples with special formatting |
| 8356 | * Include files:: Include additional files into a document | 8357 | * Include files:: Include additional files into a document |
| 8357 | * Index entries:: Making an index | 8358 | * Index entries:: Making an index |
| 8358 | * Macro replacement:: Use macros to create complex output | 8359 | * Macro replacement:: Use macros to create complex output |
| 8359 | * Embedded LaTeX:: LaTeX can be freely used inside Org documents | 8360 | * Embedded LaTeX:: LaTeX can be freely used inside Org documents |
| 8360 | @end menu | 8361 | @end menu |
| 8361 | 8362 | ||
| 8362 | @node Structural markup elements, Images and tables, Markup, Markup | 8363 | @node Structural markup elements, Images and tables, Markup, Markup |
| 8363 | @section Structural markup elements | 8364 | @section Structural markup elements |
| 8364 | 8365 | ||
| 8365 | @menu | 8366 | @menu |
| 8366 | * Document title:: Where the title is taken from | 8367 | * Document title:: Where the title is taken from |
| 8367 | * Headings and sections:: The document structure as seen by the exporter | 8368 | * Headings and sections:: The document structure as seen by the exporter |
| 8368 | * Table of contents:: The if and where of the table of contents | 8369 | * Table of contents:: The if and where of the table of contents |
| 8369 | * Initial text:: Text before the first heading? | 8370 | * Initial text:: Text before the first heading? |
| 8370 | * Lists:: Lists | 8371 | * Lists:: Lists |
| 8371 | * Paragraphs:: Paragraphs | 8372 | * Paragraphs:: Paragraphs |
| 8372 | * Footnote markup:: Footnotes | 8373 | * Footnote markup:: Footnotes |
| 8373 | * Emphasis and monospace:: Bold, italic, etc. | 8374 | * Emphasis and monospace:: Bold, italic, etc. |
| 8374 | * Horizontal rules:: Make a line | 8375 | * Horizontal rules:: Make a line |
| 8375 | * Comment lines:: What will *not* be exported | 8376 | * Comment lines:: What will *not* be exported |
| 8376 | @end menu | 8377 | @end menu |
| 8377 | 8378 | ||
| 8378 | @node Document title, Headings and sections, Structural markup elements, Structural markup elements | 8379 | @node Document title, Headings and sections, Structural markup elements, Structural markup elements |
| @@ -8801,11 +8802,11 @@ If you observe a few conventions, Org-mode knows how to find it and what | |||
| 8801 | to do with it. | 8802 | to do with it. |
| 8802 | 8803 | ||
| 8803 | @menu | 8804 | @menu |
| 8804 | * Special symbols:: Greek letters and other symbols | 8805 | * Special symbols:: Greek letters and other symbols |
| 8805 | * Subscripts and superscripts:: Simple syntax for raising/lowering text | 8806 | * Subscripts and superscripts:: Simple syntax for raising/lowering text |
| 8806 | * LaTeX fragments:: Complex formulas made easy | 8807 | * LaTeX fragments:: Complex formulas made easy |
| 8807 | * Previewing LaTeX fragments:: What will this snippet look like? | 8808 | * Previewing LaTeX fragments:: What will this snippet look like? |
| 8808 | * CDLaTeX mode:: Speed up entering of formulas | 8809 | * CDLaTeX mode:: Speed up entering of formulas |
| 8809 | @end menu | 8810 | @end menu |
| 8810 | 8811 | ||
| 8811 | @node Special symbols, Subscripts and superscripts, Embedded LaTeX, Embedded LaTeX | 8812 | @node Special symbols, Subscripts and superscripts, Embedded LaTeX, Embedded LaTeX |
| @@ -9064,17 +9065,17 @@ Org supports export of selected regions when @code{transient-mark-mode} is | |||
| 9064 | enabled (default in Emacs 23). | 9065 | enabled (default in Emacs 23). |
| 9065 | 9066 | ||
| 9066 | @menu | 9067 | @menu |
| 9067 | * Selective export:: Using tags to select and exclude trees | 9068 | * Selective export:: Using tags to select and exclude trees |
| 9068 | * Export options:: Per-file export settings | 9069 | * Export options:: Per-file export settings |
| 9069 | * The export dispatcher:: How to access exporter commands | 9070 | * The export dispatcher:: How to access exporter commands |
| 9070 | * ASCII/Latin-1/UTF-8 export:: Exporting to flat files with encoding | 9071 | * ASCII/Latin-1/UTF-8 export:: Exporting to flat files with encoding |
| 9071 | * HTML export:: Exporting to HTML | 9072 | * HTML export:: Exporting to HTML |
| 9072 | * LaTeX and PDF export:: Exporting to La@TeX{}, and processing to PDF | 9073 | * LaTeX and PDF export:: Exporting to La@TeX{}, and processing to PDF |
| 9073 | * DocBook export:: Exporting to DocBook | 9074 | * DocBook export:: Exporting to DocBook |
| 9074 | * TaskJuggler export:: Exporting to TaskJuggler | 9075 | * TaskJuggler export:: Exporting to TaskJuggler |
| 9075 | * Freemind export:: Exporting to Freemind mind maps | 9076 | * Freemind export:: Exporting to Freemind mind maps |
| 9076 | * XOXO export:: Exporting to XOXO | 9077 | * XOXO export:: Exporting to XOXO |
| 9077 | * iCalendar export:: Exporting in iCalendar format | 9078 | * iCalendar export:: Exporting in iCalendar format |
| 9078 | @end menu | 9079 | @end menu |
| 9079 | 9080 | ||
| 9080 | @node Selective export, Export options, Exporting, Exporting | 9081 | @node Selective export, Export options, Exporting, Exporting |
| @@ -9327,14 +9328,14 @@ HTML formatting, in ways similar to John Gruber's @emph{markdown} | |||
| 9327 | language, but with additional support for tables. | 9328 | language, but with additional support for tables. |
| 9328 | 9329 | ||
| 9329 | @menu | 9330 | @menu |
| 9330 | * HTML Export commands:: How to invoke HTML export | 9331 | * HTML Export commands:: How to invoke HTML export |
| 9331 | * Quoting HTML tags:: Using direct HTML in Org-mode | 9332 | * Quoting HTML tags:: Using direct HTML in Org-mode |
| 9332 | * Links in HTML export:: How links will be interpreted and formatted | 9333 | * Links in HTML export:: How links will be interpreted and formatted |
| 9333 | * Tables in HTML export:: How to modify the formatting of tables | 9334 | * Tables in HTML export:: How to modify the formatting of tables |
| 9334 | * Images in HTML export:: How to insert figures into HTML output | 9335 | * Images in HTML export:: How to insert figures into HTML output |
| 9335 | * Text areas in HTML export:: An alternative way to show an example | 9336 | * Text areas in HTML export:: An alternative way to show an example |
| 9336 | * CSS support:: Changing the appearance of the output | 9337 | * CSS support:: Changing the appearance of the output |
| 9337 | * JavaScript support:: Info and Folding in a web browser | 9338 | * JavaScript support:: Info and Folding in a web browser |
| 9338 | @end menu | 9339 | @end menu |
| 9339 | 9340 | ||
| 9340 | @node HTML Export commands, Quoting HTML tags, HTML export, HTML export | 9341 | @node HTML Export commands, Quoting HTML tags, HTML export, HTML export |
| @@ -9681,12 +9682,12 @@ implement links and cross references, the PDF output file will be fully | |||
| 9681 | linked. | 9682 | linked. |
| 9682 | 9683 | ||
| 9683 | @menu | 9684 | @menu |
| 9684 | * LaTeX/PDF export commands:: Which key invokes which commands | 9685 | * LaTeX/PDF export commands:: Which key invokes which commands |
| 9685 | * Header and sectioning:: Setting up the export file structure | 9686 | * Header and sectioning:: Setting up the export file structure |
| 9686 | * Quoting LaTeX code:: Incorporating literal La@TeX{} code | 9687 | * Quoting LaTeX code:: Incorporating literal La@TeX{} code |
| 9687 | * Tables in LaTeX export:: Options for exporting tables to La@TeX{} | 9688 | * Tables in LaTeX export:: Options for exporting tables to La@TeX{} |
| 9688 | * Images in LaTeX export:: How to insert figures into La@TeX{} output | 9689 | * Images in LaTeX export:: How to insert figures into La@TeX{} output |
| 9689 | * Beamer class export:: Turning the file into a presentation | 9690 | * Beamer class export:: Turning the file into a presentation |
| 9690 | @end menu | 9691 | @end menu |
| 9691 | 9692 | ||
| 9692 | @node LaTeX/PDF export commands, Header and sectioning, LaTeX and PDF export, LaTeX and PDF export | 9693 | @node LaTeX/PDF export commands, Header and sectioning, LaTeX and PDF export, LaTeX and PDF export |
| @@ -10011,12 +10012,12 @@ tools and stylesheets. | |||
| 10011 | Currently DocBook exporter only supports DocBook V5.0. | 10012 | Currently DocBook exporter only supports DocBook V5.0. |
| 10012 | 10013 | ||
| 10013 | @menu | 10014 | @menu |
| 10014 | * DocBook export commands:: How to invoke DocBook export | 10015 | * DocBook export commands:: How to invoke DocBook export |
| 10015 | * Quoting DocBook code:: Incorporating DocBook code in Org files | 10016 | * Quoting DocBook code:: Incorporating DocBook code in Org files |
| 10016 | * Recursive sections:: Recursive sections in DocBook | 10017 | * Recursive sections:: Recursive sections in DocBook |
| 10017 | * Tables in DocBook export:: Tables are exported as HTML tables | 10018 | * Tables in DocBook export:: Tables are exported as HTML tables |
| 10018 | * Images in DocBook export:: How to insert figures into DocBook output | 10019 | * Images in DocBook export:: How to insert figures into DocBook output |
| 10019 | * Special characters:: How to handle special characters | 10020 | * Special characters:: How to handle special characters |
| 10020 | @end menu | 10021 | @end menu |
| 10021 | 10022 | ||
| 10022 | @node DocBook export commands, Quoting DocBook code, DocBook export, DocBook export | 10023 | @node DocBook export commands, Quoting DocBook code, DocBook export, DocBook export |
| @@ -10442,10 +10443,10 @@ conversion so that files are available in both formats on the server. | |||
| 10442 | Publishing has been contributed to Org by David O'Toole. | 10443 | Publishing has been contributed to Org by David O'Toole. |
| 10443 | 10444 | ||
| 10444 | @menu | 10445 | @menu |
| 10445 | * Configuration:: Defining projects | 10446 | * Configuration:: Defining projects |
| 10446 | * Uploading files:: How to get files up on the server | 10447 | * Uploading files:: How to get files up on the server |
| 10447 | * Sample configuration:: Example projects | 10448 | * Sample configuration:: Example projects |
| 10448 | * Triggering publication:: Publication commands | 10449 | * Triggering publication:: Publication commands |
| 10449 | @end menu | 10450 | @end menu |
| 10450 | 10451 | ||
| 10451 | @node Configuration, Uploading files, Publishing, Publishing | 10452 | @node Configuration, Uploading files, Publishing, Publishing |
| @@ -10455,14 +10456,14 @@ Publishing needs significant configuration to specify files, destination | |||
| 10455 | and many other properties of a project. | 10456 | and many other properties of a project. |
| 10456 | 10457 | ||
| 10457 | @menu | 10458 | @menu |
| 10458 | * Project alist:: The central configuration variable | 10459 | * Project alist:: The central configuration variable |
| 10459 | * Sources and destinations:: From here to there | 10460 | * Sources and destinations:: From here to there |
| 10460 | * Selecting files:: What files are part of the project? | 10461 | * Selecting files:: What files are part of the project? |
| 10461 | * Publishing action:: Setting the function doing the publishing | 10462 | * Publishing action:: Setting the function doing the publishing |
| 10462 | * Publishing options:: Tweaking HTML export | 10463 | * Publishing options:: Tweaking HTML export |
| 10463 | * Publishing links:: Which links keep working after publishing? | 10464 | * Publishing links:: Which links keep working after publishing? |
| 10464 | * Sitemap:: Generating a list of all pages | 10465 | * Sitemap:: Generating a list of all pages |
| 10465 | * Generating an index:: An index that reaches across pages | 10466 | * Generating an index:: An index that reaches across pages |
| 10466 | @end menu | 10467 | @end menu |
| 10467 | 10468 | ||
| 10468 | @node Project alist, Sources and destinations, Configuration, Configuration | 10469 | @node Project alist, Sources and destinations, Configuration, Configuration |
| @@ -10836,8 +10837,8 @@ project publishing only a set of Org files. The second example is | |||
| 10836 | more complex, with a multi-component project. | 10837 | more complex, with a multi-component project. |
| 10837 | 10838 | ||
| 10838 | @menu | 10839 | @menu |
| 10839 | * Simple example:: One-component publishing | 10840 | * Simple example:: One-component publishing |
| 10840 | * Complex example:: A multi-component publishing example | 10841 | * Complex example:: A multi-component publishing example |
| 10841 | @end menu | 10842 | @end menu |
| 10842 | 10843 | ||
| 10843 | @node Simple example, Complex example, Sample configuration, Sample configuration | 10844 | @node Simple example, Complex example, Sample configuration, Sample configuration |
| @@ -10966,18 +10967,18 @@ Davison and Eric Schulte, and was originally named Org-babel. | |||
| 10966 | The following sections describe Org-mode's code block handling facilities. | 10967 | The following sections describe Org-mode's code block handling facilities. |
| 10967 | 10968 | ||
| 10968 | @menu | 10969 | @menu |
| 10969 | * Structure of code blocks:: Code block syntax described | 10970 | * Structure of code blocks:: Code block syntax described |
| 10970 | * Editing source code:: Language major-mode editing | 10971 | * Editing source code:: Language major-mode editing |
| 10971 | * Exporting code blocks:: Export contents and/or results | 10972 | * Exporting code blocks:: Export contents and/or results |
| 10972 | * Extracting source code:: Create pure source code files | 10973 | * Extracting source code:: Create pure source code files |
| 10973 | * Evaluating code blocks:: Place results of evaluation in the Org-mode buffer | 10974 | * Evaluating code blocks:: Place results of evaluation in the Org-mode buffer |
| 10974 | * Library of Babel:: Use and contribute to a library of useful code blocks | 10975 | * Library of Babel:: Use and contribute to a library of useful code blocks |
| 10975 | * Languages:: List of supported code block languages | 10976 | * Languages:: List of supported code block languages |
| 10976 | * Header arguments:: Configure code block functionality | 10977 | * Header arguments:: Configure code block functionality |
| 10977 | * Results of evaluation:: How evaluation results are handled | 10978 | * Results of evaluation:: How evaluation results are handled |
| 10978 | * Noweb reference syntax:: Literate programming in Org-mode | 10979 | * Noweb reference syntax:: Literate programming in Org-mode |
| 10979 | * Key bindings and useful functions:: Work quickly with code blocks | 10980 | * Key bindings and useful functions:: Work quickly with code blocks |
| 10980 | * Batch execution:: Call functions from the command line | 10981 | * Batch execution:: Call functions from the command line |
| 10981 | @end menu | 10982 | @end menu |
| 10982 | 10983 | ||
| 10983 | @comment node-name, next, previous, up | 10984 | @comment node-name, next, previous, up |
| @@ -11271,8 +11272,8 @@ section provides an overview of the use of header arguments, and then | |||
| 11271 | describes each header argument in detail. | 11272 | describes each header argument in detail. |
| 11272 | 11273 | ||
| 11273 | @menu | 11274 | @menu |
| 11274 | * Using header arguments:: Different ways to set header arguments | 11275 | * Using header arguments:: Different ways to set header arguments |
| 11275 | * Specific header arguments:: List of header arguments | 11276 | * Specific header arguments:: List of header arguments |
| 11276 | @end menu | 11277 | @end menu |
| 11277 | 11278 | ||
| 11278 | @node Using header arguments, Specific header arguments, Header arguments, Header arguments | 11279 | @node Using header arguments, Specific header arguments, Header arguments, Header arguments |
| @@ -11282,7 +11283,7 @@ The values of header arguments can be set in five different ways, each more | |||
| 11282 | specific (and having higher priority) than the last. | 11283 | specific (and having higher priority) than the last. |
| 11283 | @menu | 11284 | @menu |
| 11284 | * System-wide header arguments:: Set global default values | 11285 | * System-wide header arguments:: Set global default values |
| 11285 | * Language-specific header arguments:: Set default values by language | 11286 | * Language-specific header arguments:: Set default values by language |
| 11286 | * Buffer-wide header arguments:: Set default values for a specific buffer | 11287 | * Buffer-wide header arguments:: Set default values for a specific buffer |
| 11287 | * Header arguments in Org-mode properties:: Set default values for a buffer or heading | 11288 | * Header arguments in Org-mode properties:: Set default values for a buffer or heading |
| 11288 | * Code block specific header arguments:: The most common way to set values | 11289 | * Code block specific header arguments:: The most common way to set values |
| @@ -11419,25 +11420,25 @@ Header arguments for ``Library of Babel'' or function call lines can be set as s | |||
| 11419 | The following header arguments are defined: | 11420 | The following header arguments are defined: |
| 11420 | 11421 | ||
| 11421 | @menu | 11422 | @menu |
| 11422 | * var:: Pass arguments to code blocks | 11423 | * var:: Pass arguments to code blocks |
| 11423 | * results:: Specify the type of results and how they will | 11424 | * results:: Specify the type of results and how they will |
| 11424 | be collected and handled | 11425 | be collected and handled |
| 11425 | * file:: Specify a path for file output | 11426 | * file:: Specify a path for file output |
| 11426 | * dir:: Specify the default (possibly remote) | 11427 | * dir:: Specify the default (possibly remote) |
| 11427 | directory for code block execution | 11428 | directory for code block execution |
| 11428 | * exports:: Export code and/or results | 11429 | * exports:: Export code and/or results |
| 11429 | * tangle:: Toggle tangling and specify file name | 11430 | * tangle:: Toggle tangling and specify file name |
| 11430 | * no-expand:: Turn off variable assignment and noweb | 11431 | * no-expand:: Turn off variable assignment and noweb |
| 11431 | expansion during tangling | 11432 | expansion during tangling |
| 11432 | * comments:: Toggle insertion of comments in tangled | 11433 | * comments:: Toggle insertion of comments in tangled |
| 11433 | code files | 11434 | code files |
| 11434 | * session:: Preserve the state of code evaluation | 11435 | * session:: Preserve the state of code evaluation |
| 11435 | * noweb:: Toggle expansion of noweb references | 11436 | * noweb:: Toggle expansion of noweb references |
| 11436 | * cache:: Avoid re-evaluating unchanged code blocks | 11437 | * cache:: Avoid re-evaluating unchanged code blocks |
| 11437 | * hlines:: Handle horizontal lines in tables | 11438 | * hlines:: Handle horizontal lines in tables |
| 11438 | * colnames:: Handle column names in tables | 11439 | * colnames:: Handle column names in tables |
| 11439 | * rownames:: Handle row names in tables | 11440 | * rownames:: Handle row names in tables |
| 11440 | * shebang:: Make tangled files executable | 11441 | * shebang:: Make tangled files executable |
| 11441 | * eval:: Limit evaluation of specific code blocks | 11442 | * eval:: Limit evaluation of specific code blocks |
| 11442 | @end menu | 11443 | @end menu |
| 11443 | 11444 | ||
| @@ -12292,15 +12293,15 @@ emacsclient \ | |||
| 12292 | @chapter Miscellaneous | 12293 | @chapter Miscellaneous |
| 12293 | 12294 | ||
| 12294 | @menu | 12295 | @menu |
| 12295 | * Completion:: M-TAB knows what you need | 12296 | * Completion:: M-TAB knows what you need |
| 12296 | * Speed keys:: Electric commands at the beginning of a headline | 12297 | * Speed keys:: Electric commands at the beginning of a headline |
| 12297 | * Code evaluation security:: Org mode files evaluate inline code | 12298 | * Code evaluation security:: Org mode files evaluate inline code |
| 12298 | * Customization:: Adapting Org to your taste | 12299 | * Customization:: Adapting Org to your taste |
| 12299 | * In-buffer settings:: Overview of the #+KEYWORDS | 12300 | * In-buffer settings:: Overview of the #+KEYWORDS |
| 12300 | * The very busy C-c C-c key:: When in doubt, press C-c C-c | 12301 | * The very busy C-c C-c key:: When in doubt, press C-c C-c |
| 12301 | * Clean view:: Getting rid of leading stars in the outline | 12302 | * Clean view:: Getting rid of leading stars in the outline |
| 12302 | * TTY keys:: Using Org on a tty | 12303 | * TTY keys:: Using Org on a tty |
| 12303 | * Interaction:: Other Emacs packages | 12304 | * Interaction:: Other Emacs packages |
| 12304 | @end menu | 12305 | @end menu |
| 12305 | 12306 | ||
| 12306 | 12307 | ||
| @@ -12928,8 +12929,8 @@ Org lives in the world of GNU Emacs and interacts in various ways | |||
| 12928 | with other code out there. | 12929 | with other code out there. |
| 12929 | 12930 | ||
| 12930 | @menu | 12931 | @menu |
| 12931 | * Cooperation:: Packages Org cooperates with | 12932 | * Cooperation:: Packages Org cooperates with |
| 12932 | * Conflicts:: Packages that lead to conflicts | 12933 | * Conflicts:: Packages that lead to conflicts |
| 12933 | @end menu | 12934 | @end menu |
| 12934 | 12935 | ||
| 12935 | @node Cooperation, Conflicts, Interaction, Interaction | 12936 | @node Cooperation, Conflicts, Interaction, Interaction |
| @@ -13077,9 +13078,9 @@ fixed this problem: | |||
| 13077 | 13078 | ||
| 13078 | @lisp | 13079 | @lisp |
| 13079 | (add-hook 'org-mode-hook | 13080 | (add-hook 'org-mode-hook |
| 13080 | (lambda () | 13081 | (lambda () |
| 13081 | (org-set-local 'yas/trigger-key [tab]) | 13082 | (org-set-local 'yas/trigger-key [tab]) |
| 13082 | (define-key yas/keymap [tab] 'yas/next-field-group))) | 13083 | (define-key yas/keymap [tab] 'yas/next-field-group))) |
| 13083 | @end lisp | 13084 | @end lisp |
| 13084 | 13085 | ||
| 13085 | @item @file{windmove.el} by Hovav Shacham | 13086 | @item @file{windmove.el} by Hovav Shacham |
| @@ -13121,16 +13122,16 @@ This appendix covers some aspects where users can extend the functionality of | |||
| 13121 | Org. | 13122 | Org. |
| 13122 | 13123 | ||
| 13123 | @menu | 13124 | @menu |
| 13124 | * Hooks:: Who to reach into Org's internals | 13125 | * Hooks:: Who to reach into Org's internals |
| 13125 | * Add-on packages:: Available extensions | 13126 | * Add-on packages:: Available extensions |
| 13126 | * Adding hyperlink types:: New custom link types | 13127 | * Adding hyperlink types:: New custom link types |
| 13127 | * Context-sensitive commands:: How to add functionality to such commands | 13128 | * Context-sensitive commands:: How to add functionality to such commands |
| 13128 | * Tables in arbitrary syntax:: Orgtbl for La@TeX{} and other programs | 13129 | * Tables in arbitrary syntax:: Orgtbl for La@TeX{} and other programs |
| 13129 | * Dynamic blocks:: Automatically filled blocks | 13130 | * Dynamic blocks:: Automatically filled blocks |
| 13130 | * Special agenda views:: Customized views | 13131 | * Special agenda views:: Customized views |
| 13131 | * Extracting agenda information:: Postprocessing of agenda information | 13132 | * Extracting agenda information:: Postprocessing of agenda information |
| 13132 | * Using the property API:: Writing programs that use entry properties | 13133 | * Using the property API:: Writing programs that use entry properties |
| 13133 | * Using the mapping API:: Mapping over all or selected entries | 13134 | * Using the mapping API:: Mapping over all or selected entries |
| 13134 | @end menu | 13135 | @end menu |
| 13135 | 13136 | ||
| 13136 | @node Hooks, Add-on packages, Hacking, Hacking | 13137 | @node Hooks, Add-on packages, Hacking, Hacking |
| @@ -13322,10 +13323,10 @@ can use Org's facilities to edit and structure lists by turning | |||
| 13322 | 13323 | ||
| 13323 | 13324 | ||
| 13324 | @menu | 13325 | @menu |
| 13325 | * Radio tables:: Sending and receiving radio tables | 13326 | * Radio tables:: Sending and receiving radio tables |
| 13326 | * A LaTeX example:: Step by step, almost a tutorial | 13327 | * A LaTeX example:: Step by step, almost a tutorial |
| 13327 | * Translator functions:: Copy and modify | 13328 | * Translator functions:: Copy and modify |
| 13328 | * Radio lists:: Doing the same for lists | 13329 | * Radio lists:: Doing the same for lists |
| 13329 | @end menu | 13330 | @end menu |
| 13330 | 13331 | ||
| 13331 | @node Radio tables, A LaTeX example, Tables in arbitrary syntax, Tables in arbitrary syntax | 13332 | @node Radio tables, A LaTeX example, Tables in arbitrary syntax, Tables in arbitrary syntax |
| @@ -14098,9 +14099,9 @@ in-buffer settings, but it will understand the logistics of TODO state | |||
| 14098 | (@pxref{Setting tags}) only for those set in these variables. | 14099 | (@pxref{Setting tags}) only for those set in these variables. |
| 14099 | 14100 | ||
| 14100 | @menu | 14101 | @menu |
| 14101 | * Setting up the staging area:: Where to interact with the mobile device | 14102 | * Setting up the staging area:: Where to interact with the mobile device |
| 14102 | * Pushing to MobileOrg:: Uploading Org files and agendas | 14103 | * Pushing to MobileOrg:: Uploading Org files and agendas |
| 14103 | * Pulling from MobileOrg:: Integrating captured and flagged items | 14104 | * Pulling from MobileOrg:: Integrating captured and flagged items |
| 14104 | @end menu | 14105 | @end menu |
| 14105 | 14106 | ||
| 14106 | @node Setting up the staging area, Pushing to MobileOrg, MobileOrg, MobileOrg | 14107 | @node Setting up the staging area, Pushing to MobileOrg, MobileOrg, MobileOrg |
diff --git a/doc/misc/pgg.texi b/doc/misc/pgg.texi index 640dfd8f749..eefada00d9a 100644 --- a/doc/misc/pgg.texi +++ b/doc/misc/pgg.texi | |||
| @@ -497,7 +497,3 @@ If non-@code{nil}, don't check the checksum of the packets. | |||
| 497 | @bye | 497 | @bye |
| 498 | 498 | ||
| 499 | @c End: | 499 | @c End: |
| 500 | |||
| 501 | @ignore | ||
| 502 | arch-tag: 0c205838-34b9-41a5-b9d7-49ae57ccac85 | ||
| 503 | @end ignore | ||
diff --git a/doc/misc/sasl.texi b/doc/misc/sasl.texi index 8a8421b4870..80ea9bc45be 100644 --- a/doc/misc/sasl.texi +++ b/doc/misc/sasl.texi | |||
| @@ -267,7 +267,3 @@ At the first time @var{step} should be set to @code{nil}. | |||
| 267 | @bye | 267 | @bye |
| 268 | 268 | ||
| 269 | @c End: | 269 | @c End: |
| 270 | |||
| 271 | @ignore | ||
| 272 | arch-tag: dc9650be-a953-40bf-bc55-24fe5f19d875 | ||
| 273 | @end ignore | ||
diff --git a/doc/misc/sieve.texi b/doc/misc/sieve.texi index 9a1a0faf4c8..edf429aea77 100644 --- a/doc/misc/sieve.texi +++ b/doc/misc/sieve.texi | |||
| @@ -356,7 +356,3 @@ A Protocol for Remotely Managing Sieve Scripts | |||
| 356 | @bye | 356 | @bye |
| 357 | 357 | ||
| 358 | @c End: | 358 | @c End: |
| 359 | |||
| 360 | @ignore | ||
| 361 | arch-tag: 6e3ad0af-2eaf-4f35-a081-d40f4a683ec3 | ||
| 362 | @end ignore | ||
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index b9c83be457e..604130d2606 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -16,7 +16,7 @@ | |||
| 16 | 16 | ||
| 17 | @include trampver.texi | 17 | @include trampver.texi |
| 18 | 18 | ||
| 19 | @c Macro for formatting a filename according to the repective syntax. | 19 | @c Macro for formatting a filename according to the respective syntax. |
| 20 | @c xxx and yyy are auxiliary macros in order to omit leading and | 20 | @c xxx and yyy are auxiliary macros in order to omit leading and |
| 21 | @c trailing whitespace. Not very elegant, but I don't know it better. | 21 | @c trailing whitespace. Not very elegant, but I don't know it better. |
| 22 | 22 | ||
| @@ -105,11 +105,6 @@ If you're using the other Emacs flavor, you should read the | |||
| 105 | @end ifset | 105 | @end ifset |
| 106 | 106 | ||
| 107 | @ifhtml | 107 | @ifhtml |
| 108 | @ifset jamanual | ||
| 109 | This manual is also available as a @uref{@value{japanesemanual}, | ||
| 110 | Japanese translation}. | ||
| 111 | @end ifset | ||
| 112 | |||
| 113 | The latest release of @value{tramp} is available for | 108 | The latest release of @value{tramp} is available for |
| 114 | @uref{ftp://ftp.gnu.org/gnu/tramp/, download}, or you may see | 109 | @uref{ftp://ftp.gnu.org/gnu/tramp/, download}, or you may see |
| 115 | @ref{Obtaining Tramp} for more details, including the CVS server | 110 | @ref{Obtaining Tramp} for more details, including the CVS server |
| @@ -171,7 +166,6 @@ Installing @value{tramp} with your @value{emacsname} | |||
| 171 | 166 | ||
| 172 | * Installation parameters:: Parameters in order to control installation. | 167 | * Installation parameters:: Parameters in order to control installation. |
| 173 | * Load paths:: How to plug-in @value{tramp} into your environment. | 168 | * Load paths:: How to plug-in @value{tramp} into your environment. |
| 174 | * Japanese manual:: Japanese manual. | ||
| 175 | 169 | ||
| 176 | @end ifset | 170 | @end ifset |
| 177 | 171 | ||
diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi index d882baf9a86..107e4d70aa3 100644 --- a/doc/misc/trampver.texi +++ b/doc/misc/trampver.texi | |||
| @@ -9,7 +9,7 @@ | |||
| 9 | @c In the Tramp CVS, the version number is auto-frobbed from | 9 | @c In the Tramp CVS, the version number is auto-frobbed from |
| 10 | @c configure.ac, so you should edit that file and run | 10 | @c configure.ac, so you should edit that file and run |
| 11 | @c "autoconf && ./configure" to change the version number. | 11 | @c "autoconf && ./configure" to change the version number. |
| 12 | @set trampver 2.1.19-pre | 12 | @set trampver 2.2.0-pre |
| 13 | 13 | ||
| 14 | @c Other flags from configuration | 14 | @c Other flags from configuration |
| 15 | @set instprefix /usr/local | 15 | @set instprefix /usr/local |
| @@ -56,7 +56,6 @@ | |||
| 56 | @set emacsothername XEmacs | 56 | @set emacsothername XEmacs |
| 57 | @set emacsotherdir xemacs | 57 | @set emacsotherdir xemacs |
| 58 | @set emacsotherfilename tramp-xemacs.html | 58 | @set emacsotherfilename tramp-xemacs.html |
| 59 | @set japanesemanual tramp_ja-emacs.html | ||
| 60 | @end ifset | 59 | @end ifset |
| 61 | 60 | ||
| 62 | @c XEmacs counterparts. | 61 | @c XEmacs counterparts. |
| @@ -73,7 +72,6 @@ | |||
| 73 | @set emacsothername GNU Emacs | 72 | @set emacsothername GNU Emacs |
| 74 | @set emacsotherdir emacs | 73 | @set emacsotherdir emacs |
| 75 | @set emacsotherfilename tramp-emacs.html | 74 | @set emacsotherfilename tramp-emacs.html |
| 76 | @set japanesemanual tramp_ja-xemacs.html | ||
| 77 | @end ifset | 75 | @end ifset |
| 78 | 76 | ||
| 79 | @ignore | 77 | @ignore |