diff options
| -rw-r--r-- | doc/misc/org.texi | 64 |
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 |
| 41 | Permission is granted to copy, distribute and/or modify this document | 41 | Permission is granted to copy, distribute and/or modify this document |
| 42 | under the terms of the GNU Free Documentation License, Version 1.3 or | 42 | under the terms of the GNU Free Documentation License, Version 1.2 or |
| 43 | any later version published by the Free Software Foundation; with no | 43 | any later version published by the Free Software Foundation; with no |
| 44 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' | 44 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 45 | and with the Back-Cover Texts as in (a) below. A copy of the license | 45 | and 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 | |||
| 953 | yanked trees will be folded unless doing so would swallow text previously | 953 | yanked trees will be folded unless doing so would swallow text previously |
| 954 | visible. Any prefix argument to this command will force a normal @code{yank} | 954 | visible. Any prefix argument to this command will force a normal @code{yank} |
| 955 | to be executed, with the prefix passed along. A good way to force a normal | 955 | to be executed, with the prefix passed along. A good way to force a normal |
| 956 | yank is @kbd{C-u C-y}. | 956 | yank is @kbd{C-u C-y}. If you use @code{yank-pop} after a yank, it will yank |
| 957 | previous 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 |
| 959 | Refile entry or region to a different location. @xref{Refiling notes}. | 960 | Refile 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 | |||
| 1315 | first line already was a list item, any item markers will be removed from the | 1316 | first line already was a list item, any item markers will be removed from the |
| 1316 | list. Finally, even without an active region, a normal line will be | 1317 | list. Finally, even without an active region, a normal line will be |
| 1317 | converted into a list item. | 1318 | converted into a list item. |
| 1319 | @kindex S-@key{left} | ||
| 1320 | @kindex S-@key{right} | ||
| 1321 | @item S-@key{left}/@key{right} | ||
| 1322 | Also 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 |
| 2433 | named anchors for direct access through @samp{http} links@footnote{Note | 2438 | named anchors for direct access through @samp{http} links@footnote{Note that |
| 2434 | that text before the first headline is usually not exported, so the | 2439 | text before the first headline is usually not exported, so the first such |
| 2435 | first such target should be after the first headline.}. | 2440 | target should be after the first headline, or in the line directly before the |
| 2441 | first headline.}. | ||
| 2436 | 2442 | ||
| 2437 | If no dedicated target exists, Org will search for the words in the | 2443 | If no dedicated target exists, Org will search for the words in the |
| 2438 | link. In the above example the search would be for @samp{my target}. | 2444 | link. In the above example the search would be for @samp{my target}. |
| @@ -2522,10 +2528,11 @@ rmail:folder @r{RMAIL folder link} | |||
| 2522 | rmail:folder#id @r{RMAIL message link} | 2528 | rmail:folder#id @r{RMAIL message link} |
| 2523 | gnus:group @r{Gnus group link} | 2529 | gnus:group @r{Gnus group link} |
| 2524 | gnus:group#id @r{Gnus article link} | 2530 | gnus:group#id @r{Gnus article link} |
| 2525 | bbdb:Richard Stallman @r{BBDB link} | 2531 | bbdb:R.*Stallman @r{BBDB link (with regexp)} |
| 2526 | irc:/irc.com/#emacs/bob @r{IRC link} | 2532 | irc:/irc.com/#emacs/bob @r{IRC link} |
| 2527 | shell:ls *.org @r{A shell command} | 2533 | shell:ls *.org @r{A shell command} |
| 2528 | elisp:(find-file-other-frame "Elisp.org") @r{An elisp form to evaluate} | 2534 | elisp:org-agenda @r{Interactive elisp command} |
| 2535 | elisp:(find-file-other-frame "Elisp.org") @r{Elisp form to evaluate} | ||
| 2529 | @end example | 2536 | @end example |
| 2530 | 2537 | ||
| 2531 | A link should be enclosed in double brackets and may contain a | 2538 | A 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. | |||
| 3893 | If the comparison value is enclosed in double quotes @emph{and} angular | 3900 | If the comparison value is enclosed in double quotes @emph{and} angular |
| 3894 | brackets (like @samp{DEADLINE<="<2008-12-24 18:30>"}), both values are | 3901 | brackets (like @samp{DEADLINE<="<2008-12-24 18:30>"}), both values are |
| 3895 | assumed to be date/time specifications in the standard Org way@footnote{The | 3902 | assumed to be date/time specifications in the standard Org way@footnote{The |
| 3896 | only special values that will be recognized are @samp{"<now>"} for now, and | 3903 | only 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 |
| 3898 | the comparison will be done accordingly. | 3905 | @samp{<yesterday>} for these days at 0:00 hours, i.e. without a time |
| 3906 | specification.}, and the comparison will be done accordingly. | ||
| 3899 | @item | 3907 | @item |
| 3900 | If the comparison value is enclosed | 3908 | If the comparison value is enclosed |
| 3901 | in curly braces, a regexp match is performed, with @samp{=} meaning that the | 3909 | in 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 | |||
| 4985 | use two prefix arguments, Org jumps to the location where the last | 4993 | use two prefix arguments, Org jumps to the location where the last |
| 4986 | remember note was stored. | 4994 | remember note was stored. |
| 4987 | 4995 | ||
| 4996 | The remember buffer will actually use @code{org-mode} as its major mode, so | ||
| 4997 | that all editing features of Org-mode are available. In addition to this, a | ||
| 4998 | minor mode @code{org-remember-mode} is turned on, for the single purpose that | ||
| 4999 | you can use its keymap @code{org-remember-mode-map} to overwrite some of | ||
| 5000 | Org-mode's key bindings. | ||
| 5001 | |||
| 4988 | You can also call @code{org-remember} in a special way from the agenda, | 5002 | You can also call @code{org-remember} in a special way from the agenda, |
| 4989 | using the @kbd{k r} key combination. With this access, any time stamps | 5003 | using the @kbd{k r} key combination. With this access, any time stamps |
| 4990 | inserted by the selected remember template (see below) will default to | 5004 | inserted 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 | |||
| 6060 | turn off the filter and unhide any hidden entries. If the first key you | 6074 | turn off the filter and unhide any hidden entries. If the first key you |
| 6061 | press is either @kbd{+} or @kbd{-}, the previous filter will be narrowed by | 6075 | press is either @kbd{+} or @kbd{-}, the previous filter will be narrowed by |
| 6062 | requiring or forbidding the selected additional tag. Instead of pressing | 6076 | requiring 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{\} |
| 6078 | command. | ||
| 6064 | 6079 | ||
| 6065 | In order to filter for effort estimates, you should set-up allowed | 6080 | In order to filter for effort estimates, you should set-up allowed |
| 6066 | efforts globally, for example | 6081 | efforts globally, for example |
| @@ -7478,10 +7493,10 @@ the subtrees are exported. | |||
| 7478 | @item C-c C-e | 7493 | @item C-c C-e |
| 7479 | Dispatcher for export and publishing commands. Displays a help-window | 7494 | Dispatcher for export and publishing commands. Displays a help-window |
| 7480 | listing the additional key(s) needed to launch an export or publishing | 7495 | listing the additional key(s) needed to launch an export or publishing |
| 7481 | command. The prefix arg is passed through to the exporter. If the option | 7496 | command. 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 |
| 7483 | background if that seems useful for the specific command (i.e. commands that | 7498 | separate emacs process@footnote{To make this behavior the default, customize |
| 7484 | write to a file). | 7499 | the 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 |
| 7487 | Like @kbd{C-c C-e}, but only export the text that is currently visible | 7502 | Like @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 | ||
| 8966 | A number of extension are distributed with Org when you download it from its | ||
| 8967 | homepage. Please note that these extensions are @emph{not} distributed as | ||
| 8968 | part of Emacs, so if you use Org as delivered with Emacs, you still need to | ||
| 8969 | go 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 | ||
| 9958 | now 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 |
| 9937 | subtrees. | 9961 | subtrees. |
| 9938 | @item | 9962 | @item |