aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/misc/org.texi64
1 files changed, 44 insertions, 20 deletions
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 3f1c69e0b14..faac6b95331 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -3,7 +3,7 @@
3@setfilename ../../info/org 3@setfilename ../../info/org
4@settitle The Org Manual 4@settitle The Org Manual
5 5
6@set VERSION 6.12a 6@set VERSION 6.13
7@set DATE November 2008 7@set DATE November 2008
8 8
9@dircategory Emacs 9@dircategory Emacs
@@ -39,7 +39,7 @@ Copyright @copyright{} 2004, 2005, 2006, 2007, 2008 Free Software Foundation
39 39
40@quotation 40@quotation
41Permission is granted to copy, distribute and/or modify this document 41Permission is granted to copy, distribute and/or modify this document
42under the terms of the GNU Free Documentation License, Version 1.3 or 42under the terms of the GNU Free Documentation License, Version 1.2 or
43any later version published by the Free Software Foundation; with no 43any later version published by the Free Software Foundation; with no
44Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' 44Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
45and with the Back-Cover Texts as in (a) below. A copy of the license 45and with the Back-Cover Texts as in (a) below. A copy of the license
@@ -953,7 +953,8 @@ C-x C-y}. With the default settings, level adjustment will take place and
953yanked trees will be folded unless doing so would swallow text previously 953yanked trees will be folded unless doing so would swallow text previously
954visible. Any prefix argument to this command will force a normal @code{yank} 954visible. Any prefix argument to this command will force a normal @code{yank}
955to be executed, with the prefix passed along. A good way to force a normal 955to be executed, with the prefix passed along. A good way to force a normal
956yank is @kbd{C-u C-y}. 956yank is @kbd{C-u C-y}. If you use @code{yank-pop} after a yank, it will yank
957previous kill items plainly, without adjustment and folding.
957@kindex C-c C-w 958@kindex C-c C-w
958@item C-c C-w 959@item C-c C-w
959Refile entry or region to a different location. @xref{Refiling notes}. 960Refile entry or region to a different location. @xref{Refiling notes}.
@@ -1315,6 +1316,10 @@ region when calling this, all lines will be converted to list items. If the
1315first line already was a list item, any item markers will be removed from the 1316first line already was a list item, any item markers will be removed from the
1316list. Finally, even without an active region, a normal line will be 1317list. Finally, even without an active region, a normal line will be
1317converted into a list item. 1318converted into a list item.
1319@kindex S-@key{left}
1320@kindex S-@key{right}
1321@item S-@key{left}/@key{right}
1322Also cycle bullet styles when in the first line of an item.
1318@end table 1323@end table
1319 1324
1320@node Drawers, Orgstruct mode, Plain lists, Document Structure 1325@node Drawers, Orgstruct mode, Plain lists, Document Structure
@@ -2430,9 +2435,10 @@ convenient to put them into a comment line. For example
2430@end example 2435@end example
2431 2436
2432@noindent In HTML export (@pxref{HTML export}), such targets will become 2437@noindent In HTML export (@pxref{HTML export}), such targets will become
2433named anchors for direct access through @samp{http} links@footnote{Note 2438named anchors for direct access through @samp{http} links@footnote{Note that
2434that text before the first headline is usually not exported, so the 2439text before the first headline is usually not exported, so the first such
2435first such target should be after the first headline.}. 2440target should be after the first headline, or in the line directly before the
2441first headline.}.
2436 2442
2437If no dedicated target exists, Org will search for the words in the 2443If no dedicated target exists, Org will search for the words in the
2438link. In the above example the search would be for @samp{my target}. 2444link. In the above example the search would be for @samp{my target}.
@@ -2522,10 +2528,11 @@ rmail:folder @r{RMAIL folder link}
2522rmail:folder#id @r{RMAIL message link} 2528rmail:folder#id @r{RMAIL message link}
2523gnus:group @r{Gnus group link} 2529gnus:group @r{Gnus group link}
2524gnus:group#id @r{Gnus article link} 2530gnus:group#id @r{Gnus article link}
2525bbdb:Richard Stallman @r{BBDB link} 2531bbdb:R.*Stallman @r{BBDB link (with regexp)}
2526irc:/irc.com/#emacs/bob @r{IRC link} 2532irc:/irc.com/#emacs/bob @r{IRC link}
2527shell:ls *.org @r{A shell command} 2533shell:ls *.org @r{A shell command}
2528elisp:(find-file-other-frame "Elisp.org") @r{An elisp form to evaluate} 2534elisp:org-agenda @r{Interactive elisp command}
2535elisp:(find-file-other-frame "Elisp.org") @r{Elisp form to evaluate}
2529@end example 2536@end example
2530 2537
2531A link should be enclosed in double brackets and may contain a 2538A link should be enclosed in double brackets and may contain a
@@ -3791,7 +3798,7 @@ publishers and the number of disks in a box like this:
3791* CD collection 3798* CD collection
3792 :PROPERTIES: 3799 :PROPERTIES:
3793 :NDisks_ALL: 1 2 3 4 3800 :NDisks_ALL: 1 2 3 4
3794 :Publisher_ALL: "Deutsche Grammophon" Phillips EMI 3801 :Publisher_ALL: "Deutsche Grammophon" Philips EMI
3795 :END: 3802 :END:
3796@end example 3803@end example
3797 3804
@@ -3893,9 +3900,10 @@ quotes, a string comparison is done, and the same operators are allowed.
3893If the comparison value is enclosed in double quotes @emph{and} angular 3900If the comparison value is enclosed in double quotes @emph{and} angular
3894brackets (like @samp{DEADLINE<="<2008-12-24 18:30>"}), both values are 3901brackets (like @samp{DEADLINE<="<2008-12-24 18:30>"}), both values are
3895assumed to be date/time specifications in the standard Org way@footnote{The 3902assumed to be date/time specifications in the standard Org way@footnote{The
3896only special values that will be recognized are @samp{"<now>"} for now, and 3903only special values that will be recognized are @samp{"<now>"} for now
3897@samp{"<today>"} today at 0:00 hours, i.e. without a time specification.}, and 3904(including time), and @samp{"<today>"}, @samp{<tomorrow>}, and
3898the comparison will be done accordingly. 3905@samp{<yesterday>} for these days at 0:00 hours, i.e. without a time
3906specification.}, and the comparison will be done accordingly.
3899@item 3907@item
3900If the comparison value is enclosed 3908If the comparison value is enclosed
3901in curly braces, a regexp match is performed, with @samp{=} meaning that the 3909in curly braces, a regexp match is performed, with @samp{=} meaning that the
@@ -4985,6 +4993,12 @@ stored: Just call @code{org-remember} with a prefix argument. If you
4985use two prefix arguments, Org jumps to the location where the last 4993use two prefix arguments, Org jumps to the location where the last
4986remember note was stored. 4994remember note was stored.
4987 4995
4996The remember buffer will actually use @code{org-mode} as its major mode, so
4997that all editing features of Org-mode are available. In addition to this, a
4998minor mode @code{org-remember-mode} is turned on, for the single purpose that
4999you can use its keymap @code{org-remember-mode-map} to overwrite some of
5000Org-mode's key bindings.
5001
4988You can also call @code{org-remember} in a special way from the agenda, 5002You can also call @code{org-remember} in a special way from the agenda,
4989using the @kbd{k r} key combination. With this access, any time stamps 5003using the @kbd{k r} key combination. With this access, any time stamps
4990inserted by the selected remember template (see below) will default to 5004inserted by the selected remember template (see below) will default to
@@ -6060,7 +6074,8 @@ entries that @emph{do} have the tag. A second @kbd{/} at the prompt will
6060turn off the filter and unhide any hidden entries. If the first key you 6074turn off the filter and unhide any hidden entries. If the first key you
6061press is either @kbd{+} or @kbd{-}, the previous filter will be narrowed by 6075press is either @kbd{+} or @kbd{-}, the previous filter will be narrowed by
6062requiring or forbidding the selected additional tag. Instead of pressing 6076requiring or forbidding the selected additional tag. Instead of pressing
6063@kbd{+} or @kbd{-}, you can also use the @kbd{\} command. 6077@kbd{+} or @kbd{-} after @kbd{/}, you can also immediately use the @kbd{\}
6078command.
6064 6079
6065In order to filter for effort estimates, you should set-up allowed 6080In order to filter for effort estimates, you should set-up allowed
6066efforts globally, for example 6081efforts globally, for example
@@ -7478,10 +7493,10 @@ the subtrees are exported.
7478@item C-c C-e 7493@item C-c C-e
7479Dispatcher for export and publishing commands. Displays a help-window 7494Dispatcher for export and publishing commands. Displays a help-window
7480listing the additional key(s) needed to launch an export or publishing 7495listing the additional key(s) needed to launch an export or publishing
7481command. The prefix arg is passed through to the exporter. If the option 7496command. The prefix arg is passed through to the exporter. A double prefix
7482@code{org-export-run-in-background} is set, Org will run the command in the 7497@kbd{C-u C-u} causes most commands to be executed in the background, in a
7483background if that seems useful for the specific command (i.e. commands that 7498separate emacs process@footnote{To make this behavior the default, customize
7484write to a file). 7499the variable @code{org-export-run-in-background}.}.
7485@kindex C-c C-e v 7500@kindex C-c C-e v
7486@item C-c C-e v 7501@item C-c C-e v
7487Like @kbd{C-c C-e}, but only export the text that is currently visible 7502Like @kbd{C-c C-e}, but only export the text that is currently visible
@@ -8948,6 +8963,11 @@ distribution, others are available somewhere on the web.
8948@node Extensions in the contrib directory, Other extensions, Extensions, Extensions 8963@node Extensions in the contrib directory, Other extensions, Extensions, Extensions
8949@section Extensions in the @file{contrib} directory 8964@section Extensions in the @file{contrib} directory
8950 8965
8966A number of extension are distributed with Org when you download it from its
8967homepage. Please note that these extensions are @emph{not} distributed as
8968part of Emacs, so if you use Org as delivered with Emacs, you still need to
8969go to @url{http://orgmode.org} to get access to these modules.
8970
8951@table @asis 8971@table @asis
8952@item @file{org-annotate-file.el} by @i{Philip Jackson} 8972@item @file{org-annotate-file.el} by @i{Philip Jackson}
8953 Annotate a file with org syntax, in a separate file, with links back to 8973 Annotate a file with org syntax, in a separate file, with links back to
@@ -8973,6 +8993,10 @@ distribution, others are available somewhere on the web.
8973 to include text in a document that is the result of evaluating some 8993 to include text in a document that is the result of evaluating some
8974 code. Other scripting languages like @code{perl} can be supported with 8994 code. Other scripting languages like @code{perl} can be supported with
8975 this package as well. 8995 this package as well.
8996@item @file{org-eval-light.el} by @i{Eric Schulte}
8997 User-controlled evaluation of code in an Org buffer.
8998@item @file{org-exp-blocks.el} by @i{Eric Schulte}
8999 Preprocess user-defined blocks for export.
8976@item @file{org-expiry.el} by @i{Bastien Guerry} 9000@item @file{org-expiry.el} by @i{Bastien Guerry}
8977 Expiry mechanism for Org entries. 9001 Expiry mechanism for Org entries.
8978@item @file{org-indent.el} by @i{Carsten Dominik} 9002@item @file{org-indent.el} by @i{Carsten Dominik}
@@ -8994,8 +9018,6 @@ distribution, others are available somewhere on the web.
8994 to publish the same file using either org-publish or Muse. 9018 to publish the same file using either org-publish or Muse.
8995@item @file{org-panel.el} by @i{Lennard Borgman} 9019@item @file{org-panel.el} by @i{Lennard Borgman}
8996 Simplified and display-aided access to some Org commands. 9020 Simplified and display-aided access to some Org commands.
8997@c @item @file{org-plot.el} by @i{Eric Schulte}
8998@c Plotting Org tables with Gnuplot.
8999@item @file{org-registry.el} by @i{Bastien Guerry} 9021@item @file{org-registry.el} by @i{Bastien Guerry}
9000 A registry for Org links, to find out from where links point to a given 9022 A registry for Org links, to find out from where links point to a given
9001 file or location. 9023 file or location.
@@ -9011,7 +9033,6 @@ distribution, others are available somewhere on the web.
9011 be found on the Worg pages. 9033 be found on the Worg pages.
9012@end table 9034@end table
9013 9035
9014
9015@node Other extensions, , Extensions in the contrib directory, Extensions 9036@node Other extensions, , Extensions in the contrib directory, Extensions
9016@section Other extensions 9037@section Other extensions
9017 9038
@@ -9933,6 +9954,9 @@ Linking to VM/BBDB/Gnus was first inspired by @i{Tom Shannon}'s
9933@item 9954@item
9934@i{Ilya Shlyakhter} proposed the Archive Sibling. 9955@i{Ilya Shlyakhter} proposed the Archive Sibling.
9935@item 9956@item
9957@i{Stathis Sideris} wrote the @file{ditaa.jar} ASCII to PNG converter that is
9958now packaged into Org's @file{contrib} directory.
9959@item
9936@i{Daniel Sinder} came up with the idea of internal archiving by locking 9960@i{Daniel Sinder} came up with the idea of internal archiving by locking
9937subtrees. 9961subtrees.
9938@item 9962@item