@setfilename ../../info/org
@settitle The Org Manual
-@set VERSION 6.12a
+@set VERSION 6.13
@set DATE November 2008
@dircategory Emacs
@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
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}.
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
@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}.
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
* CD collection
:PROPERTIES:
:NDisks_ALL: 1 2 3 4
- :Publisher_ALL: "Deutsche Grammophon" Phillips EMI
+ :Publisher_ALL: "Deutsche Grammophon" Philips EMI
:END:
@end example
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
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
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
@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
@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
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}
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.
be found on the Worg pages.
@end table
-
@node Other extensions, , Extensions in the contrib directory, Extensions
@section Other extensions
@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
projects / emacs.git / commitdiff