Mercurial > emacs

--- a/doc/misc/org.texi	Sun Nov 23 13:39:49 2008 +0000
+++ b/doc/misc/org.texi	Sun Nov 23 13:40:03 2008 +0000
@@ -3,7 +3,7 @@
 @setfilename ../../info/org
 @settitle The Org Manual

-@set VERSION 6.12a
+@set VERSION 6.13
 @set DATE November 2008

 @dircategory Emacs
@@ -39,7 +39,7 @@

 @quotation
 Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.3 or
+under the terms of the GNU Free Documentation License, Version 1.2 or
 any later version published by the Free Software Foundation; with no
 Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
 and with the Back-Cover Texts as in (a) below.  A copy of the license
@@ -953,7 +953,8 @@
 yanked trees will be folded unless doing so would swallow text previously
 visible.  Any prefix argument to this command will force a normal @code{yank}
 to be executed, with the prefix passed along.  A good way to force a normal
-yank is @kbd{C-u C-y}.
+yank is @kbd{C-u C-y}.  If you use @code{yank-pop} after a yank, it will yank
+previous kill items plainly, without adjustment and folding.
 @kindex C-c C-w
 @item C-c C-w
 Refile entry or region to a different location.  @xref{Refiling notes}.
@@ -1315,6 +1316,10 @@
 first line already was a list item, any item markers will be removed from the
 list.  Finally, even without an active region, a normal line will be
 converted into a list item.
+@kindex S-@key{left}
+@kindex S-@key{right}
+@item S-@key{left}/@key{right}
+Also cycle bullet styles when in the first line of an item.
 @end table

 @node Drawers, Orgstruct mode, Plain lists, Document Structure
@@ -2430,9 +2435,10 @@
 @end example

 @noindent In HTML export (@pxref{HTML export}), such targets will become
-named anchors for direct access through @samp{http} links@footnote{Note
-that text before the first headline is usually not exported, so the
-first such target should be after the first headline.}.
+named anchors for direct access through @samp{http} links@footnote{Note that
+text before the first headline is usually not exported, so the first such
+target should be after the first headline, or in the line directly before the
+first headline.}.

 If no dedicated target exists, Org will search for the words in the
 link.  In the above example the search would be for @samp{my target}.
@@ -2522,10 +2528,11 @@
 rmail:folder#id                           @r{RMAIL message link}
 gnus:group                                @r{Gnus group link}
 gnus:group#id                             @r{Gnus article link}
-bbdb:Richard Stallman                     @r{BBDB link}
+bbdb:R.*Stallman                          @r{BBDB link (with regexp)}
 irc:/irc.com/#emacs/bob                   @r{IRC link}
 shell:ls *.org                            @r{A shell command}
-elisp:(find-file-other-frame "Elisp.org") @r{An elisp form to evaluate}
+elisp:org-agenda                          @r{Interactive elisp command}
+elisp:(find-file-other-frame "Elisp.org") @r{Elisp form to evaluate}
 @end example

 A link should be enclosed in double brackets and may contain a
@@ -3791,7 +3798,7 @@
 * CD collection
   :PROPERTIES:
   :NDisks_ALL:  1 2 3 4
-  :Publisher_ALL: "Deutsche Grammophon" Phillips EMI
+  :Publisher_ALL: "Deutsche Grammophon" Philips EMI
   :END:
 @end example

@@ -3893,9 +3900,10 @@
 If the comparison value is enclosed in double quotes @emph{and} angular
 brackets (like @samp{DEADLINE<="<2008-12-24 18:30>"}), both values are
 assumed to be date/time specifications in the standard Org way@footnote{The
-only special values that will be recognized are @samp{"<now>"} for now, and
-@samp{"<today>"} today at 0:00 hours, i.e. without a time specification.}, and
-the comparison will be done accordingly.
+only special values that will be recognized are @samp{"<now>"} for now
+(including time), and @samp{"<today>"}, @samp{<tomorrow>}, and
+@samp{<yesterday>} for these days at 0:00 hours, i.e. without a time
+specification.}, and the comparison will be done accordingly.
 @item
 If the comparison value is enclosed
 in curly braces, a regexp match is performed, with @samp{=} meaning that the
@@ -4985,6 +4993,12 @@
 use two prefix arguments, Org jumps to the location where the last
 remember note was stored.

+The remember buffer will actually use @code{org-mode} as its major mode, so
+that all editing features of Org-mode are available.  In addition to this, a
+minor mode @code{org-remember-mode} is turned on, for the single purpose that
+you can use its keymap @code{org-remember-mode-map} to overwrite some of
+Org-mode's key bindings.
+
 You can also call @code{org-remember} in a special way from the agenda,
 using the @kbd{k r} key combination.  With this access, any time stamps
 inserted by the selected remember template (see below) will default to
@@ -6060,7 +6074,8 @@
 turn off the filter and unhide any hidden entries.  If the first key you
 press is either @kbd{+} or @kbd{-}, the previous filter will be narrowed by
 requiring or forbidding the selected additional tag.  Instead of pressing
-@kbd{+} or @kbd{-}, you can also use the @kbd{\} command.
+@kbd{+} or @kbd{-} after @kbd{/}, you can also immediately use the @kbd{\}
+command.

 In order to filter for effort estimates, you should set-up allowed
 efforts globally, for example
@@ -7478,10 +7493,10 @@
 @item C-c C-e
 Dispatcher for export and publishing commands.  Displays a help-window
 listing the additional key(s) needed to launch an export or publishing
-command.  The prefix arg is passed through to the exporter.  If the option
-@code{org-export-run-in-background} is set, Org will run the command in the
-background if that seems useful for the specific command (i.e. commands that
-write to a file).
+command.  The prefix arg is passed through to the exporter.  A double prefix
+@kbd{C-u C-u} causes most commands to be executed in the background, in a
+separate emacs process@footnote{To make this behavior the default, customize
+the variable @code{org-export-run-in-background}.}.
 @kindex C-c C-e v
 @item C-c C-e v
 Like @kbd{C-c C-e}, but only export the text that is currently visible
@@ -8948,6 +8963,11 @@
 @node Extensions in the contrib directory, Other extensions, Extensions, Extensions
 @section Extensions in the @file{contrib} directory

+A number of extension are distributed with Org when you download it from its
+homepage.  Please note that these extensions are @emph{not} distributed as
+part of Emacs, so if you use Org as delivered with Emacs, you still need to
+go to @url{http://orgmode.org} to get access to these modules.
+
 @table @asis
 @item @file{org-annotate-file.el} by @i{Philip Jackson}
       Annotate a file with org syntax, in a separate file, with links back to
@@ -8973,6 +8993,10 @@
       to include text in a document that is the result of evaluating some
       code.  Other scripting languages like @code{perl} can be supported with
       this package as well.
+@item @file{org-eval-light.el} by @i{Eric Schulte}
+      User-controlled evaluation of code in an Org buffer.
+@item @file{org-exp-blocks.el} by @i{Eric Schulte}
+      Preprocess user-defined blocks for export.
 @item @file{org-expiry.el} by @i{Bastien Guerry}
       Expiry mechanism for Org entries.
 @item @file{org-indent.el} by @i{Carsten Dominik}
@@ -8994,8 +9018,6 @@
       to publish the same file using either org-publish or Muse.
 @item @file{org-panel.el} by @i{Lennard Borgman}
       Simplified and display-aided access to some Org commands.
-@c @item @file{org-plot.el} by @i{Eric Schulte}
-@c      Plotting Org tables with Gnuplot.
 @item @file{org-registry.el} by @i{Bastien Guerry}
       A registry for Org links, to find out from where links point to a given
       file or location.
@@ -9011,7 +9033,6 @@
       be found on the Worg pages.
 @end table

-
 @node Other extensions,  , Extensions in the contrib directory, Extensions
 @section Other extensions

@@ -9933,6 +9954,9 @@
 @item
 @i{Ilya Shlyakhter} proposed the Archive Sibling.
 @item
+@i{Stathis Sideris} wrote the @file{ditaa.jar} ASCII to PNG converter that is
+now packaged into Org's @file{contrib} directory.
+@item
 @i{Daniel Sinder} came up with the idea of internal archiving by locking
 subtrees.
 @item