aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/ChangeLog81
-rw-r--r--doc/misc/auth.texi4
-rw-r--r--doc/misc/cl.texi12
-rw-r--r--doc/misc/dbus.texi51
-rw-r--r--doc/misc/doclicense.texi4
-rw-r--r--doc/misc/ediff.texi3
-rw-r--r--doc/misc/emacs-mime.texi6
-rw-r--r--doc/misc/gnus-coding.texi4
-rw-r--r--doc/misc/gnus-faq.texi4
-rw-r--r--doc/misc/gnus-news.el1
-rw-r--r--doc/misc/gnus-news.texi4
-rw-r--r--doc/misc/gnus.texi675
-rw-r--r--doc/misc/message.texi38
-rw-r--r--doc/misc/org.texi1001
-rw-r--r--doc/misc/pgg.texi4
-rw-r--r--doc/misc/sasl.texi4
-rw-r--r--doc/misc/sieve.texi4
-rw-r--r--doc/misc/tramp.texi8
-rw-r--r--doc/misc/trampver.texi4
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 @@
12010-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
72010-09-09 Glenn Morris <rgm@gnu.org>
8
9 * org.texi: Restore clobbered changes (copyright years, untabify).
10
112010-09-04 Julien Danjou <julien@danjou.info> (tiny change)
12
13 * gnus.texi (Adaptive Scoring): Fix typo.
14
152010-09-03 Lars Magne Ingebrigtsen <larsi@gnus.org>
16
17 * gnus.texi (Article Display): Document gnus-html-show-images.
18
192010-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
232010-09-01 Lars Magne Ingebrigtsen <larsi@gnus.org>
24
25 * gnus.texi (HTML): Document gnus-max-image-proportion.
26
272010-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
332010-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
402010-08-29 Lars Magne Ingebrigtsen <larsi@gnus.org>
41
42 * gnus.texi (Drafts): Mention B DEL.
43
442010-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
492010-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
552010-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
742010-08-23 Michael Albinus <michael.albinus@gmx.de>
75
76 * dbus.texi (Alternative Buses): New chapter.
77
782010-08-12 Stefan Monnier <monnier@iro.umontreal.ca>
79
80 * cl.texi (Mapping over Sequences): Rename mapc => cl-mapc.
81
12010-08-09 Jay Belanger <jay.p.belanger@gmail.com> 822010-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
1043frame-width window-point 1043frame-width window-point
1044get-register window-start 1044get-register window-start
1045getenv window-width 1045getenv window-width
1046global-key-binding x-get-cut-buffer 1046global-key-binding x-get-secondary-selection
1047keymap-parent x-get-cutbuffer 1047keymap-parent x-get-selection
1048local-key-binding x-get-secondary-selection 1048local-key-binding
1049mark x-get-selection 1049mark
1050mark-marker 1050mark-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
3767This function is like @code{mapcar*}, except that the values returned 3767This function is like @code{mapcar*}, except that the values returned
3768by @var{function} are ignored and thrown away rather than being 3768by @var{function} are ignored and thrown away rather than being
3769collected into a list. The return value of @code{mapc} is @var{seq}, 3769collected into a list. The return value of @code{cl-mapc} is @var{seq},
3770the first sequence. This function is more general than the Emacs 3770the first sequence. This function is more general than the Emacs
3771primitive @code{mapc}. 3771primitive @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
1588Until now, we have spoken about the system and the session buses,
1589which are the default buses to be connected to. However, it is
1590possible to connect to any bus, from which the address is known. This
1591is a UNIX domain socket. Everywhere, where a @var{bus} is mentioned
1592as argument of a function (the symbol @code{:system} or the symbol
1593@code{:session}), this address can be used instead. The connection to
1594this bus must be initialized first.
1595
1596@defun dbus-init-bus bus
1597Establish 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
1601corresponding bus. For the system and session busses, this function
1602is called when loading @file{dbus.el}, there is no need to call it
1603again.
1604
1605Example: 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
1614In 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
1986this: 1986this:
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
1993the difference region from buffer A 1992the 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
396This selects the function used to render @acronym{HTML}. The predefined 396This selects the function used to render @acronym{HTML}. The predefined
397renderers are selected by the symbols @code{w3}, 397renderers 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
399information about emacs-w3m}, @code{links}, @code{lynx}, 399information 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
2331use to read and write Usenet news. 2331use to read and write Usenet news.
2332 2332
2333@end table 2333@end table
2334
2335@ignore
2336arch-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
721Document Groups 717Document 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
725SOUP
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
731Combined Groups 721Combined 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
736Email Based Diary 725Email Based Diary
737 726
@@ -1295,7 +1284,7 @@ parameter (@pxref{Topic Parameters}). For instance, a @code{subscribe}
1295topic parameter that looks like 1284topic parameter that looks like
1296 1285
1297@example 1286@example
1298"nnslashdot" 1287"nnml"
1299@end example 1288@end example
1300 1289
1301will mean that all groups that match that regex will be subscribed under 1290will 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
1385change @code{gnus-select-method}, your @file{.newsrc} file becomes 1374change @code{gnus-select-method}, your @file{.newsrc} file becomes
1386worthless. 1375worthless.
1387 1376
1388Gnus provides a few functions to attempt to translate a @file{.newsrc}
1389file from one server to another. They all have one thing in
1390common---they take a looong time to run. You don't want to use these
1391functions more than absolutely necessary.
1392
1393@kindex M-x gnus-change-server
1394@findex gnus-change-server
1395If you have access to both servers, Gnus can request the headers for all
1396the articles you have read and compare @code{Message-ID}s and map the
1397article numbers of the read articles and article marks. The @kbd{M-x
1398gnus-change-server} command will do this for all your native groups. It
1399will 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
1403You can also move individual groups with the @kbd{M-x
1404gnus-group-move-group-to-server} command. This is useful if you want to
1405move 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
1409If you don't have access to both the old and new server, all your marks 1379You can use the @kbd{M-x gnus-group-clear-data-on-native-groups}
1410and read ranges have become worthless. You can use the @kbd{M-x 1380command to clear out all data that you have on your native groups.
1411gnus-group-clear-data-on-native-groups} command to clear out all data 1381Use with caution.
1412that 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
2655group will be created from @code{gnus-group-archive-directory}. 2624group 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
2661Make a kiboze group. You will be prompted for a name, for a regexp to
2662match groups to be ``included'' in the kiboze group, and a series of
2663strings 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
4450made). Since mairix already presents search results in such a virtual 4410made). Since mairix already presents search results in such a virtual
4451mail folder, it is very well suited for using it as an external program 4411mail folder, it is very well suited for using it as an external program
4452for creating @emph{smart} mail folders, which represent certain mail 4412for creating @emph{smart} mail folders, which represent certain mail
4453searches. This is similar to a Kiboze group (@pxref{Kibozed Groups}), 4413searches.
4454but 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.
6043This variable can also be a number. In that case, center the window at 6002This variable can also be a number. In that case, center the window at
6044the given number of lines from the top. 6003the 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
6007If 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
6351Mail a wide reply to the current article and include the original 6315Mail a wide reply to the current article and include the original
6352message (@code{gnus-summary-wide-reply-with-original}). This command uses 6316message (@code{gnus-summary-wide-reply-with-original}). This command uses
6353the process/prefix convention. 6317the process/prefix convention, but only uses the headers from the
6318first 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.
6414If the prefix is 1, prompt for a group name to find the posting style. 6379If 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
6421Prepare a news (@code{gnus-summary-news-other-window}). By default, 6384Prepare 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.
6753Just don't forget to set that up :-) 6716Just don't forget to set that up :-)
6754@end table 6717@end table
6755 6718
6719When delaying an article with @kbd{C-c C-j}, Message mode will
6720automatically add a @code{"Date"} header with the current time. In
6721many cases you probably want the @code{"Date"} header to reflect the
6722time 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
6862Canceled article (@code{gnus-canceled-mark}) 6831Canceled 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
6870Sparsely reffed article (@code{gnus-sparse-mark}). @xref{Customizing 6835Sparsely 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
7835intended for those non-news newsgroups where the back end has to fetch 7800intended for those non-news newsgroups where the back end has to fetch
7836quite a lot to present the summary buffer, and where it's impossible to 7801quite a lot to present the summary buffer, and where it's impossible to
7837go back to parents of articles. This is mostly the case in the 7802go back to parents of articles. This is mostly the case in the
7838web-based groups, like the @code{nnultimate} groups. 7803web-based groups.
7839 7804
7840If you don't use those, then it's safe to leave this as the default 7805If 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
8271preferably be short and sweet to avoid slowing down Gnus too much. 8236preferably be short and sweet to avoid slowing down Gnus too much.
8272It's probably a good idea to byte-compile things like this. 8237It'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
8241After an article has been prefetched, this
8242@code{gnus-async-post-fetch-function} will be called. The buffer will
8243be narrowed to the region of the article that was fetched. A useful
8244value would be @code{gnus-html-prefetch-images}, which will prefetch
8245and store images referenced in the article, so that you don't have to
8246wait for them to be fetched when you read the article. This is useful
8247for @acronym{HTML} messages that have external images.
8248
8274@vindex gnus-prefetched-article-deletion-strategy 8249@vindex gnus-prefetched-article-deletion-strategy
8275Articles have to be removed from the asynch buffer sooner or later. The 8250Articles 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
10376Remove all images from the article buffer 10351Remove 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
10357If you're reading an @acronym{HTML} article rendered with
10358@code{gnus-article-html}, then you can insert any blocked images in
10359the 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.
12482Also @pxref{MIME Commands}. 12466Also @pxref{MIME Commands}.
12483 12467
12484 12468
12469@node HTML
12470@section @acronym{HTML}
12471@cindex @acronym{HTML}
12472
12473If you have @code{w3m} installed on your system, Gnus can display
12474@acronym{HTML} articles in the article buffer. There are many Gnus
12475add-ons for doing this, using various approaches, but there's one
12476(sort of) built-in method that's used by default.
12477
12478For a complete overview, consult @xref{Display Customization,
12479,Display Customization, emacs-mime, The Emacs MIME Manual}. This
12480section only describes the default method.
12481
12482@table @code
12483@item mm-text-html-renderer
12484@vindex mm-text-html-renderer
12485If set to @code{gnus-article-html}, Gnus will use the built-in method,
12486that's based on @code{curl} and @code{w3m}.
12487
12488@item gnus-blocked-images
12489@vindex gnus-blocked-images
12490Images that have @acronym{URL}s that match this regexp won't be
12491fetched and displayed. For instance, do block all @acronym{URL}s that
12492have the string ``ads'' in them, do the following:
12493
12494@lisp
12495(setq gnus-blocked-images "ads")
12496@end lisp
12497
12498The default is to block all external images.
12499
12500@item gnus-html-cache-directory
12501@vindex gnus-html-cache-directory
12502Gnus will download and cache images according to how
12503@code{gnus-blocked-images} is set. These images will be stored in
12504this directory.
12505
12506@item gnus-html-cache-size
12507@vindex gnus-html-cache-size
12508When @code{gnus-html-cache-size} bytes have been used in that
12509directory, the oldest files will be deleted. The default is 500MB.
12510
12511@item gnus-html-frame-width
12512@vindex gnus-html-frame-width
12513The width to use when rendering HTML. The default is 70.
12514
12515@item gnus-max-image-proportion
12516@vindex gnus-max-image-proportion
12517How big pictures displayed are in relation to the window they're in.
12518A value of 0.7 (the default) means that they are allowed to take up
1251970% of the width and height of the window. If they are larger than
12520this, and Emacs supports it, then the images will be rescaled down to
12521fit these criteria.
12522
12523@end table
12524
12525To use this, make sure that you have @code{w3m} and @code{curl}
12526installed. If you have, then Gnus should display @acronym{HTML}
12527automatically.
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
13560as unsendable. This is a toggling command. 13606as unsendable. This is a toggling command.
13561 13607
13608Finally, if you want to delete a draft, use the normal @kbd{B DEL}
13609command (@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
17504lively discussion following the news articles. @code{nnslashdot} will
17505let you read this forum in a convenient manner.
17506
17507The easiest way to read this source is to put something like the
17508following in your @file{~/.gnus.el} file:
17509
17510@lisp
17511(setq gnus-secondary-select-methods
17512 '((nnslashdot "")))
17513@end lisp
17514
17515This will make Gnus query the @code{nnslashdot} back end for new comments
17516and groups. The @kbd{F} command will subscribe each new news article as
17517a new Gnus group, and you can read the comments by entering these
17518groups. (Note that the default subscription method is to subscribe new
17519groups as zombies. Other methods are available (@pxref{Subscription
17520Methods}).
17521
17522If you want to remove an old @code{nnslashdot} group, the @kbd{G DEL}
17523command is the most handy tool (@pxref{Foreign Groups}).
17524
17525When following up to @code{nnslashdot} comments (or posting new
17526comments), some light @acronym{HTML}izations will be performed. In
17527particular, text quoted with @samp{> } will be quoted with
17528@samp{blockquote} instead, and signatures will have @samp{br} added to
17529the end of each line. Other than that, you can just write @acronym{HTML}
17530directly into the message buffer. Note that Slashdot filters out some
17531@acronym{HTML} forms.
17532
17533The following variables can be altered to change its behavior:
17534
17535@table @code
17536@item nnslashdot-threaded
17537Whether @code{nnslashdot} should display threaded groups or not. The
17538default is @code{t}. To be able to display threads, @code{nnslashdot}
17539has to retrieve absolutely all comments in a group upon entry. If a
17540threaded display is not required, @code{nnslashdot} will only retrieve
17541the comments that are actually wanted by the user. Threading is nicer,
17542but much, much slower than unthreaded.
17543
17544@item nnslashdot-login-name
17545@vindex nnslashdot-login-name
17546The login name to use when posting.
17547
17548@item nnslashdot-password
17549@vindex nnslashdot-password
17550The password to use when posting.
17551
17552@item nnslashdot-directory
17553@vindex nnslashdot-directory
17554Where @code{nnslashdot} will store its files. The default is
17555@file{~/News/slashdot/}.
17556
17557@item nnslashdot-active-url
17558@vindex nnslashdot-active-url
17559The @acronym{URL} format string that will be used to fetch the
17560information 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
17565The @acronym{URL} format string that will be used to fetch comments.
17566
17567@item nnslashdot-article-url
17568@vindex nnslashdot-article-url
17569The @acronym{URL} format string that will be used to fetch the news
17570article. The default is
17571@samp{http://slashdot.org/article.pl?sid=%s&mode=nocomment}.
17572
17573@item nnslashdot-threshold
17574@vindex nnslashdot-threshold
17575The score threshold. The default is -1.
17576
17577@item nnslashdot-group-number
17578@vindex nnslashdot-group-number
17579The number of old groups, in addition to the ten latest, to keep
17580updated. 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
17592probably the most popular Web bulletin board system used. It has a
17593quite regular and nice interface, and it's possible to get the
17594information Gnus needs to keep groups updated.
17595
17596The easiest way to get started with @code{nnultimate} is to say
17597something like the following in the group buffer: @kbd{B nnultimate RET
17598http://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
17600you're interested in; there's quite a list of them on the Ultimate web
17601site.) Then subscribe to the groups you're interested in from the
17602server buffer, and read them from the group buffer.
17603
17604The following @code{nnultimate} variables can be altered:
17605
17606@table @code
17607@item nnultimate-directory
17608@vindex nnultimate-directory
17609The 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
17619Some 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
17622interface, and it's possible to get the information Gnus needs to keep
17623groups updated.
17624
17625@findex gnus-group-make-warchive-group
17626The easiest way to get started with @code{nnwarchive} is to say
17627something like the following in the group buffer: @kbd{M-x
17628gnus-group-make-warchive-group RET @var{an_egroup} RET egroups RET
17629www.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
17632back end by @kbd{B nnwarchive RET mail-archive RET}.
17633
17634The following @code{nnwarchive} variables can be altered:
17635
17636@table @code
17637@item nnwarchive-directory
17638@vindex nnwarchive-directory
17639The directory where @code{nnwarchive} stores its files. The default is@*
17640@file{~/News/warchive/}.
17641
17642@item nnwarchive-login
17643@vindex nnwarchive-login
17644The account name on the web server.
17645
17646@item nnwarchive-passwd
17647@vindex nnwarchive-passwd
17648The 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
18952means low probability with @samp{0} being the lowest valid number. 18844means 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
18960In the PC world people often talk about ``offline'' newsreaders. These
18961are thingies that are combined reader/news transport monstrosities.
18962With built-in modem programs. Yecchh!
18963
18964Of 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
18966transport things like Ghod intended. And then we just use normal
18967newsreaders.
18968
18969However, it can sometimes be convenient to do something that's a bit
18970easier on the brain if you have a very slow modem, and you're not really
18971that interested in doing things properly.
18972
18973A file format called @sc{soup} has been developed for transporting news
18974and mail from servers to home machines and back again. It can be a bit
18975fiddly.
18976
18977First some terminology:
18978
18979@table @dfn
18980
18981@item server
18982This is the machine that is connected to the outside world and where you
18983get news and/or mail from.
18984
18985@item home machine
18986This is the machine that you want to do the actual reading and responding
18987on. It is typically not connected to the rest of the world in any way.
18988
18989@item packet
18990Something that contains messages and/or commands. There are two kinds
18991of packets:
18992
18993@table @dfn
18994@item message packets
18995These are packets made at the server, and typically contain lots of
18996messages for you to read. These are called @file{SoupoutX.tgz} by
18997default, where @var{x} is a number.
18998
18999@item response packets
19000These are packets made at the home machine, and typically contains
19001replies that you've written. These are called @file{SoupinX.tgz} by
19002default, where @var{x} is a number.
19003
19004@end table
19005
19006@end table
19007
19008
19009@enumerate
19010
19011@item
19012You log in on the server and create a @sc{soup} packet. You can either
19013use a dedicated @sc{soup} thingie (like the @code{awk} program), or you
19014can use Gnus to create the packet with its @sc{soup} commands (@kbd{O
19015s} and/or @kbd{G s b}; and then @kbd{G s p}) (@pxref{SOUP Commands}).
19016
19017@item
19018You transfer the packet home. Rail, boat, car or modem will do fine.
19019
19020@item
19021You put the packet in your home directory.
19022
19023@item
19024You fire up Gnus on your home machine using the @code{nnsoup} back end as
19025the native or secondary server.
19026
19027@item
19028You read articles and mail and answer and followup to the things you
19029want (@pxref{SOUP Replies}).
19030
19031@item
19032You do the @kbd{G s r} command to pack these replies into a @sc{soup}
19033packet.
19034
19035@item
19036You transfer this packet to the server.
19037
19038@item
19039You use Gnus to mail this packet out with the @kbd{G s s} command.
19040
19041@item
19042You then repeat until you die.
19043
19044@end enumerate
19045
19046So you basically have a bipartite system---you use @code{nnsoup} for
19047reading 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
19059These 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
19065Pack all unread articles in the current group
19066(@code{gnus-group-brew-soup}). This command understands the
19067process/prefix convention.
19068
19069@item G s w
19070@kindex G s w (Group)
19071@findex gnus-soup-save-areas
19072Save 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
19077Send 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
19083Pack 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
19088Pack 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
19093This summary-mode command adds the current article to a @sc{soup} packet
19094(@code{gnus-soup-add-article}). It understands the process/prefix
19095convention (@pxref{Process/Prefix}).
19096
19097@end table
19098
19099
19100There are a few variables to customize where Gnus will put all these
19101thingies:
19102
19103@table @code
19104
19105@item gnus-soup-directory
19106@vindex gnus-soup-directory
19107Directory 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
19112This is what Gnus will use as a temporary directory while sending our
19113reply packets. @file{~/SoupBrew/SoupReplies/} is the default.
19114
19115@item gnus-soup-prefix-file
19116@vindex gnus-soup-prefix-file
19117Name 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
19122A 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
19127Format 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
19132Where Gnus will look for reply packets. The default is @file{~/}.
19133
19134@item gnus-soup-packet-regexp
19135@vindex gnus-soup-packet-regexp
19136Regular 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
19147read incoming packets, unpack them, and put them in a directory where
19148you can read them at leisure.
19149
19150These 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
19156When @code{nnsoup} unpacks a @sc{soup} packet, it does it in this
19157directory. (@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.
19162The default is @file{~/SOUP/}.
19163
19164@item nnsoup-replies-directory
19165@vindex nnsoup-replies-directory
19166All replies will be stored in this directory before being packed into a
19167reply packet. The default is @file{~/SOUP/replies/}.
19168
19169@item nnsoup-replies-format-type
19170@vindex nnsoup-replies-format-type
19171The @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
19173shouldn't even have documented it. Drats! Too late!
19174
19175@item nnsoup-replies-index-type
19176@vindex nnsoup-replies-index-type
19177The index type of the replies packet. The default is @samp{?n}, which
19178means ``none''. Don't fiddle with this one either!
19179
19180@item nnsoup-active-file
19181@vindex nnsoup-active-file
19182Where @code{nnsoup} stores lots of information. This is not an ``active
19183file'' in the @code{nntp} sense; it's an Emacs Lisp file. If you lose
19184this 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
19189Format string command for packing a reply @sc{soup} packet. The default
19190is @samp{tar cf - %s | gzip > $HOME/Soupin%d.tgz}.
19191
19192@item nnsoup-unpacker
19193@vindex nnsoup-unpacker
19194Format string command for unpacking incoming @sc{soup} packets. The
19195default is @samp{gunzip -c %s | tar xvf -}.
19196
19197@item nnsoup-packet-directory
19198@vindex nnsoup-packet-directory
19199Where @code{nnsoup} will look for incoming packets. The default is
19200@file{~/}.
19201
19202@item nnsoup-packet-regexp
19203@vindex nnsoup-packet-regexp
19204Regular expression matching incoming @sc{soup} packets. The default is
19205@samp{Soupout}.
19206
19207@item nnsoup-always-save
19208@vindex nnsoup-always-save
19209If 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
19217Just using @code{nnsoup} won't mean that your postings and mailings end
19218up in @sc{soup} reply packets automagically. You have to work a bit
19219more for that to happen.
19220
19221@findex nnsoup-set-variables
19222The @code{nnsoup-set-variables} command will set the appropriate
19223variables to ensure that all your followups and replies end up in the
19224@sc{soup} system.
19225
19226In 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
19233And that's it, really. If you only want news to go into the @sc{soup}
19234system 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
19411inherited. 19019inherited.
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
19421do this for you. Oh joy! Now you can grind any @acronym{NNTP} server
19422down to a halt with useless requests! Oh happiness!
19423
19424@kindex G k (Group)
19425To create a kibozed group, use the @kbd{G k} command in the group
19426buffer.
19427
19428The 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
19433In addition to this regexp detailing component groups, an
19434@code{nnkiboze} group must have a score file to say what articles are
19435to be included in the group (@pxref{Scoring}).
19436
19437@kindex M-x nnkiboze-generate-groups
19438@findex nnkiboze-generate-groups
19439You must run @kbd{M-x nnkiboze-generate-groups} after creating the
19440@code{nnkiboze} groups you want to have. This command will take time.
19441Lots of time. Oodles and oodles of time. Gnus has to fetch the
19442headers from all the articles in all the component groups and run them
19443through the scoring process to determine if there are any articles in
19444the groups that are to be part of the @code{nnkiboze} groups.
19445
19446Please limit the number of component groups by using restrictive
19447regexps. 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.
19449Stranger things have happened.
19450
19451@code{nnkiboze} component groups do not have to be alive---they can be dead,
19452and they can be foreign. No restrictions.
19453
19454@vindex nnkiboze-directory
19455The generation of an @code{nnkiboze} group means writing two files in
19456@code{nnkiboze-directory}, which is @file{~/News/kiboze/} by default.
19457One contains the @acronym{NOV} header lines for all the articles in
19458the group, and the other is an additional @file{.newsrc} file to store
19459information on what groups have been searched through to find
19460component articles.
19461
19462Articles marked as read in the @code{nnkiboze} group will have
19463their @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
22019Adaptive score files can get huge and are not meant to be edited by 21575Adaptive score files can get huge and are not meant to be edited by
22020human hands. If @code{gnus-adaptive-pretty-print} is @code{nil} (the 21576human hands. If @code{gnus-adaptive-pretty-print} is @code{nil} (the
22021deafult) those files will not be written in a human readable way. 21577default) 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
22024When doing adaptive scoring, substring or fuzzy matching would probably 21580When 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
27811operations on all the marked items (@pxref{Process/Prefix}). 27367operations on all the marked items (@pxref{Process/Prefix}).
27812 27368
27813@item 27369@item
27814You can grep through a subset of groups and create a group from the
27815results (@pxref{Kibozed Groups}).
27816
27817@item
27818You can list subsets of groups according to, well, anything 27370You 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
27959else (@pxref{Document Groups}). 27511else (@pxref{Document Groups}).
27960 27512
27961@item 27513@item
27962Gnus has a new back end (@code{nnsoup}) to create/read SOUP packets 27514Gnus has a new back end (@code{nnsoup}) to create/read SOUP packets.
27963(@pxref{SOUP}).
27964 27515
27965@item 27516@item
27966The Gnus cache is much faster. 27517The Gnus cache is much faster.
@@ -29521,11 +29072,9 @@ Gnus not to use @acronym{NOV}.
29521As the variables for the other back ends, there are 29072As 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 29076non-@code{nil} value for @code{gnus-nov-is-evil} overrides all those
29526@code{gnus-nov-is-evil} overrides all those variables.@footnote{Although 29077variables.
29527the 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
182expression (or list of regular expressions) will be removed from the 182expression (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
187used when doing a wide reply. It's meant to be used to remove
188duplicate addresses and the like. It's a list of lists, where the
189first element is a regexp to match the address to trigger the rule,
190and the second is a regexp that will be expanded based on the first,
191to match addresses to be pruned.
192
193It's complicated to explain, but it's easy to use.
194
195For 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
197wide reply will go out to both these addresses, since they are unique.
198
199To avoid this, do something like the following:
200
201@lisp
202(setq message-prune-recipient-rules
203 '(("^\\([^@@]+\\)@@\\(.*\\)" "\\1@@.*[.]\\2")))
204@end lisp
205
206If, 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.,
208remove all other recipients if @samp{cvs@@example.org} is in the
209recipient 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
186If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you 217If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you
187will be asked to confirm that you want to reply to multiple 218will 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
1646The limitation of messages sent as message/partial. The lower bound 1677The limitation of messages sent as message/partial. The lower bound
1647of message size in characters, beyond which the message should be sent 1678of message size in characters, beyond which the message should be sent
1648in several parts. If it is @code{nil}, the size is unlimited. 1679in several parts. If it is @code{nil} (which is the default), the
1680size 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
52This manual is for Org version @value{VERSION}. 52This manual is for Org version @value{VERSION}.
53 53
54Copyright @copyright{} 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation 54Copyright @copyright{} 2004, 2005, 2006, 2007, 2008, 2009, 2010
55Free Software Foundation, Inc.
55 56
56@quotation 57@quotation
57Permission is granted to copy, distribute and/or modify this document 58Permission 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
129Introduction 130Introduction
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
137Document structure 138Document 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
151Tables 152Tables
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
160The spreadsheet 161The 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
171Hyperlinks 172Hyperlinks
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
182Internal links 183Internal 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
186TODO items 187TODO 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
195Extended use of TODO keywords 196Extended 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
205Progress logging 206Progress 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
211Tags 212Tags
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
217Properties and columns 218Properties 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
226Column view 227Column 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
232Defining columns 233Defining 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
237Dates and times 238Dates 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
247Creating timestamps 248Creating 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
252Deadlines and scheduling 253Deadlines 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
257Capture - Refile - Archive 258Capture - 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
266Capture 267Capture
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
272Capture templates 273Capture 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
277Archiving 278Archiving
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
282Agenda views 283Agenda 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
293The built-in agenda views 294The 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
302Presentation and sorting 303Presentation 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
308Custom agenda views 309Custom 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
314Markup for rich export 315Markup 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
324Structural markup elements 325Structural 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
337Embedded La@TeX{} 338Embedded 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
345Exporting 346Exporting
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
359HTML export 360HTML 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
370La@TeX{} and PDF export 371La@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
379DocBook export 380DocBook 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
388Publishing 389Publishing
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
395Configuration 396Configuration
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
406Sample configuration 407Sample 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
411Working with source code 412Working 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
426Header arguments 427Header 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
431Using header arguments 432Using 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
439Specific header arguments 440Specific 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
456Miscellaneous 457Miscellaneous
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
468Interaction with other packages 469Interaction 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
473Hacking 474Hacking
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
486Tables and lists in arbitrary syntax 487Tables 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
493MobileOrg 494MobileOrg
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
805edit the structure of the document. 806edit 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
2019formula, moving these references by arrow keys 2020formula, 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
2730other files, Usenet articles, emails, and much more. 2731other 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
2830earlier. 2831earlier.
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
3285methods to give you an overview of all the things that you have to do. 3286methods 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
3382TODO items in particular (@pxref{Tags}). 3383TODO 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
3679work time}. 3680work 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
4673queries have collected selected items, possibly from a number of files. 4674queries 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
4687done by defining a column format line. 4688done 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
4970is used in a much wider sense. 4971is 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
5365sexp entry matches. 5366sexp 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
5888trees to an archive file keeps the system compact and fast. 5889trees 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
5921does enhance it with templates and more. 5922does 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}.
6767In this section we describe the built-in views. 6768In 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
7237associated with the item. 7238associated 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
7963dispatcher (@pxref{Agenda dispatcher}), just like the default commands. 7964dispatcher (@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
8350summarizes the markup rules used in an Org-mode buffer. 8351summarizes 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
8801to do with it. 8802to 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
9064enabled (default in Emacs 23). 9065enabled (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}
9327language, but with additional support for tables. 9328language, 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
9681linked. 9682linked.
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.
10011Currently DocBook exporter only supports DocBook V5.0. 10012Currently 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.
10442Publishing has been contributed to Org by David O'Toole. 10443Publishing 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
10455and many other properties of a project. 10456and 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
10836more complex, with a multi-component project. 10837more 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.
10966The following sections describe Org-mode's code block handling facilities. 10967The 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
11271describes each header argument in detail. 11272describes 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
11282specific (and having higher priority) than the last. 11283specific (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
11419The following header arguments are defined: 11420The 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
12928with other code out there. 12929with 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
13121Org. 13122Org.
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
109This manual is also available as a @uref{@value{japanesemanual},
110Japanese translation}.
111@end ifset
112
113The latest release of @value{tramp} is available for 108The 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