comparison man/org.texi @ 67344:22aa7225124f

(TODO basics): Document the global todo list. (TODO items): Documents sparse tree for specific TODO keywords.

67343:69e43e82cd0a

@c %**start of header
@c @setfilename org
@setfilename ../info/org
@settitle Org Mode Manual

@set VERSION 3.21
@set DATE December 2005

@dircategory Emacs
@direntry
* Org Mode: (org).	Outline-based notes management and organizer

* Editing/debugging formulas::  Changing a stored formula
* Appetizer::                   Taste the power of calc

Hyperlinks

* Links::                       URL-like links to the world
* Remember::                    Org-trees store quick notes

TODO items

* TODO basics::                 Marking and displaying TODO entries

@cindex global keybindings
@cindex keybindings, global

If Org-mode is part of the Emacs distribution or an XEmacs package,
you only need to copy the following lines to your @file{.emacs} file.
The last two lines define @emph{global} keys for the commands
@command{org-store-link} and @command{org-agenda} - please choose
suitable keys yourself.

@lisp
;; The following lines are always needed.  Choose your own keys.
(add-to-list 'auto-mode-alist '("\\.org$" . org-mode))
(define-key global-map "\C-cl" 'org-store-link)
(define-key global-map "\C-ca" 'org-agenda)
@end lisp

If you have downloaded Org-mode from the Web, you must byte-compile
@file{org.el} and put it on your load path.  In addition to the Emacs
Lisp lines above, you also need to add the following lines to

@lisp
;; These lines only if org-mode is not part of the X/Emacs distribution.
(autoload 'org-mode "org" "Org mode" t)
(autoload 'org-diary "org" "Diary entries from Org mode")
(autoload 'org-agenda "org" "Multi-file agenda from Org mode" t)
(autoload 'org-store-link "org" "Store a link to the current location" t)
(autoload 'orgtbl-mode "org" "Org tables as a minor mode" t)
(autoload 'turn-on-orgtbl "org" "Org tables as a minor mode")
@end lisp

Occur.  Prompts for a regexp and shows a sparse tree with all matches.
If the match is in a headline, the headline is made visible.  If the
match is in the body of an entry, headline and body are made visible.
In order to provide minimal context, also the full hierarchy of
headlines above the match is shown, as well as the headline following
the match.
@end table

Other commands are using this feature as well.  For example @kbd{C-c
C-v} creates a sparse TODO tree (@pxref{TODO basics}).

@node Plain Lists,  , Sparse trees, Document Structure
@section Plain Lists
@cindex plain lists
@cindex lists, plain

Headlines define the entire structure of the Org-mode file, and also
lists (for example TODO items (@pxref{TODO items}) should be created
using headline levels.  However, when taking notes, the plain text is
sometimes easier to read with hand-formatted lists.  Org-mode supports
editing such lists, and the HTML exporter (@pxref{Exporting}) does
parse and format them.

Org-mode knows ordered and unordered lists.  Unordered list items

that is indented like the bullet/number, or less.  For example:

@example
** Lord of the Rings
My favorite scenes are (in this order)
1. Eowyns fight with the witch-king
   + this was already my favorite scene in the book
   + I really like Miranda Otto.
2. The attack of the Rohirrim
3. Peter Jackson being shot by Legolas
    - on DVD only  
   He makes a really funny face when it happens.
@end example

Org-mode supports these lists by tuning filling and wrapping commands
to correctly deal with them.  Futhermore, the following commands act
on items when the cursor is in the first line of an item (the line
with the bullet or number).

@table @kbd
@kindex M-S-@key{up}
@kindex M-S-@key{down}
@item M-S-@key{up}
@itemx M-S-@key{down}
Move the item including subitems up/down (swap with previous/next item

@kindex C-c ^
@item C-c ^
Sort the table lines in the region.  Point and mark must be in the first
and last line to be included, and must be in the column that should be
used for sorting.  The command prompts for numerical versus
alphnumerical sorting.

@tsubheading{Regions}
@kindex C-c C-x M-w
@item C-c C-x M-w
Copy a rectangular region from a table to a special clipboard.  Point

@node Hyperlinks, TODO items, Tables, Top
@chapter Hyperlinks
@cindex hyperlinks

Just like HMTL, Org-mode provides links to other files, Usenet
articles, emails and much more.

@menu
* Links::                       URL-like links to the world
* Remember::                    Org-trees store quick notes
@end menu

@node Links, Remember, Hyperlinks, Hyperlinks
@section Links
@cindex links
@cindex GNUS links
@cindex BBDB links
@cindex URL links
@cindex file links
@cindex VM links

@example
<http://www.astro.uva.nl/~dominik>         @r{on the web}
<file:/home/dominik/images/jupiter.jpg>    @r{file, absolute path}
<file:papers/last.pdf>                     @r{file, relative path}
<file:~/code/main.c:255>                   @r{file, with line number}
<news:comp.emacs>                          @r{Usenet link}
<mailto:adent@@galaxy.net>                  @r{Mail link}
<vm:folder>                                @r{VM folder link}
<vm:folder#id>                             @r{VM message link}
<vm://myself@@some.where.org/folder#id>     @r{VM on remote machine}

the end of a line.  In tables, the end of a table field also terminates
a link.  Angle brackets around a link are not required, but are
recommended to avoid problems with punctuation and other text following
the link.  See also the variable @code{org-allow-space-in-links}.

@cindex storing links
@table @kbd
@kindex C-c l
@item C-c l
Store a link to the current location.  This is a @emph{global} command
which can be used in any buffer to create a link.  The link will be
stored for later insertion into an Org-mode buffer (see below).  For VM,
RMAIL, WANDERLUST, GNUS and BBDB buffers, the link will point to the
current article/entry.  For W3 and W3M buffer, the link goes to the
current URL.  For any other files, the link will just point to the file.
The key binding @kbd{C-c l} is only a suggestion - see
@ref{Installation and Activation}.

@kindex C-c C-l
@cindex completion, of links
@cindex completion, of file names
@item C-c C-l

@kindex mouse-3
@item mouse-3
Like @kbd{mouse-2}, but force file links to be opened with Emacs.
@end table

@node Remember,  , Links, Hyperlinks
@section Remember
@cindex @file{remember.el}

Another way to create org entries with links to other files is through
the @emph{Remember} package by John Wiegley.  @emph{Remember} lets you

information.  The notes produced by @emph{Remember} can be stored in
different ways, and Org-mode files are a good target.  Org-mode allows
to file away notes either to a default file, or directly to the
correct location in your Org-mode outline tree.  The following
customization@footnote{The two autoload forms are only necessary if
@file{org.el} is not part of the Emacs distribution or and XEmacs
package.} will tell @emph{Remember} to use org files as target, and to
create annotations compatible with Org-mode links.

@example
(autoload 'org-remember-annotation "org")

@kindex C-c C-v
@cindex sparse tree, for TODO
@item C-c C-v
View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}).  Folds
the entire buffer, but shows all TODO items and the headings hierarchy
above them.  With prefix arg, show also the DONE entries.
@item C-u C-c a
A @kbd{C-u} argument to the @code{org-agenda command} (@pxref{Agenda})
collects all unfinished TODO items into a single place.
@end table

@node TODO extensions, Priorities, TODO basics, TODO items
@section Extended use of TODO keywords
@cindex extended TODO keywords

@cindex names as TODO keywords
@cindex types as TODO keywords

The second possibility is to use TODO keywords to indicate different
types of action items.  For example, you might want to indicate that
items are for ``work'' or ``home''.  Or, when you work with several
people on a single project, you might want to assign action items
directly to persons, by using their names as TODO keywords.  This
would be set up like this:

@lisp
(setq org-todo-keywords '("Fred" "Sara" "Lucy" "Mike" "DONE")
      org-todo-interpretation 'type)
@end lisp

rather different types.  So it is normally not useful to change from
one type to another.  Therefore, in this case the behavior of the
command @kbd{C-c C-t} is changed slightly@footnote{This is also true
for the @kbd{t} command in the timeline and agenda buffers.}.  When
used several times in succession, it will still cycle through all
names.  But when you return to the item after some time and
execute @kbd{C-c C-t} again, it will switch from each name directly to
DONE.  Use prefix arguments or completion to quickly select a specific
name.

@node Per file keywords,  , TODO types, TODO extensions
@subsection Setting up TODO keywords for individual files
@cindex keyword options
@cindex per file keywords

Increase/decrease priority of current item.  Note that these keys are
also used to modify time stamps (@pxref{Creating timestamps}).
Furthermore, these keys are also used by CUA-mode
(@pxref{Interaction}).
@end table



@node Timestamps, Timeline and Agenda, TODO items, Top
@chapter Timestamps

Items can be labeled with timestamps to make them useful for project

which is derived from the file name.  The category can also be set
with a special line anywhere in the buffer, looking like this:
@example
#+CATEGORY: Thesis
@end example
@noindent
After changing this line, press @kbd{C-c C-c} with the cursor still in
the line, to make the changes known to org-mode.  Otherwise, the
change will only be active the next time you visit this file with
Emacs.

The display in the agenda buffer looks best if the category is not
longer than 10 characters.

@subsection Time-of-Day Specifications

Org-mode checks each agenda item for a time-of-day specification.  The
time can be part of the time stamp that triggered inclusion into the

@kindex r
@item r
Recreate the agenda buffer, for example to reflect the changes
after modification of the time stamps of items with S-@key{left} and
S-@key{right}.

@kindex @key{right}
@item @key{right}
Display the following @code{org-agenda-ndays} days.  For example, if
the display covers a week, switch to the following week.  With prefix

@example
@kbd{C-1 C-c C-x a org-export-as-ascii}
@end example
@noindent
creates only top level headlines and does the rest as items.  Lines
starting with @samp{#} and subtree starting with the word @samp{COMMENT}
will not be exported.

@node HTML export, iCalendar export, ASCII export, Exporting
@section HTML export
@cindex HTML export

Create a single large iCalendar file from all files in
@code{org-agenda-files} and write it to the file given by
@code{org-combined-agenda-icalendar-file}.
@end table

How this calendar is best read and updated, depends on the on the
application you are using.  For example, when using iCal under Apple
MacOS X, you could create a new calendar @samp{OrgMode} (the default
name for the calendar created by @kbd{C-c C-x c}, see the variables
@code{org-icalendar-combined-name} and
@code{org-combined-agenda-icalendar-file}).  Then set Org-mode to
overwrite the corresponding file
@file{~/Library/Calendars/OrgMode.ics}.  You may even use AppleScript
to make iCal re-read the calendar files each time a new version of

@section Completion
@cindex completion, of @TeX{} symbols
@cindex completion, of TODO keywords
@cindex completion, of dictionary words
@cindex completion, of option keywords

Org-mode supports in-buffer completion.  This type of completion does
not make use of the minibuffer.  You simply type a few letters into
the buffer and use the key to complete text right there.

@itemize @bullet
@item
At the beginning of a headline, complete TODO keywords.
@item
After @samp{\}, complete @TeX{} symbols supported by the exporter.
@item
After @samp{#+}, complete the special keywords like @samp{TYP_TODO} or
@samp{OPTIONS} which set file-specific options for Org-mode.  When the
option keyword is already complete, pressing @kbd{M-@key{TAB}} again
will insert example settings for this keyword.

Kai Grossjohann pointed out that a number of key bindings in Org-mode
conflict with other packages.
@item 
Roland Winkler pointed out that additional keybindings are needed to
use Org-mode on a tty.
@end itemize

@node Index, Key Index, Miscellaneous, Top
@chapter Index

67344:22aa7225124f

@c %**start of header
@c @setfilename org
@setfilename ../info/org
@settitle Org Mode Manual

@set VERSION 3.22
@set DATE December 2005

@dircategory Emacs
@direntry
* Org Mode: (org).	Outline-based notes management and organizer

* Editing/debugging formulas::  Changing a stored formula
* Appetizer::                   Taste the power of calc

Hyperlinks

* Internal Links::              CamelCaseWords as internal links
* External Links::              URL-like links to the world
* Managing links::              Creating, inserting and following
* Search Options::              Linking to a specific location
* Remember::                    Org-trees store quick notes

TODO items

* TODO basics::                 Marking and displaying TODO entries

@cindex global keybindings
@cindex keybindings, global

If Org-mode is part of the Emacs distribution or an XEmacs package,
you only need to copy the following lines to your @file{.emacs} file.
The last three lines define @emph{global} keys for the commands
@command{org-store-link}, @command{org-agenda}, and
@code{org-todo-list} - please choose suitable keys yourself.

@lisp
;; The following lines are always needed.  Choose your own keys.
(add-to-list 'auto-mode-alist '("\\.org$" . org-mode))
(define-key global-map "\C-cl" 'org-store-link)
(define-key global-map "\C-ca" 'org-agenda)
(define-key global-map "\C-ct" 'org-todo-list)
@end lisp

If you have downloaded Org-mode from the Web, you must byte-compile
@file{org.el} and put it on your load path.  In addition to the Emacs
Lisp lines above, you also need to add the following lines to

@lisp
;; These lines only if org-mode is not part of the X/Emacs distribution.
(autoload 'org-mode "org" "Org mode" t)
(autoload 'org-diary "org" "Diary entries from Org mode")
(autoload 'org-agenda "org" "Multi-file agenda from Org mode" t)
(autoload 'org-todo-list "org" "Global TODO list from Org mode" t)
(autoload 'org-store-link "org" "Store a link to the current location" t)
(autoload 'orgtbl-mode "org" "Org tables as a minor mode" t)
(autoload 'turn-on-orgtbl "org" "Org tables as a minor mode")
@end lisp

Occur.  Prompts for a regexp and shows a sparse tree with all matches.
If the match is in a headline, the headline is made visible.  If the
match is in the body of an entry, headline and body are made visible.
In order to provide minimal context, also the full hierarchy of
headlines above the match is shown, as well as the headline following
the match.  Each match is also highlighted, the highlights disappear
when the buffer is changed with an editing command.
@end table

Other commands are using this feature as well.  For example @kbd{C-c
C-v} creates a sparse TODO tree (@pxref{TODO basics}).

@node Plain Lists,  , Sparse trees, Document Structure
@section Plain Lists
@cindex plain lists
@cindex lists, plain

Headlines define the structure of the Org-mode file, and also lists
(for example TODO items (@pxref{TODO items}) should be created using
headline levels.  However, when taking notes, the plain text is
sometimes easier to read with hand-formatted lists.  Org-mode supports
editing such lists, and the HTML exporter (@pxref{Exporting}) does
parse and format them.

Org-mode knows ordered and unordered lists.  Unordered list items

that is indented like the bullet/number, or less.  For example:

@example
** Lord of the Rings
My favorite scenes are (in this order)
1. Eowyns fight with the witch king
   + this was already my favorite scene in the book
   + I really like Miranda Otto.
2. The attack of the Rohirrim
3. Peter Jackson being shot by Legolas
    - on DVD only
   He makes a really funny face when it happens.
@end example

Org-mode supports these lists by tuning filling and wrapping commands
to correctly deal with them.  Futhermore, the following commands act
on items when the cursor is in the first line of an item (the line
with the bullet or number).

@table @kbd
@kindex @key{TAB}
@item @key{TAB}
Items can be folded just like headline levels if you set the variable
@code{org-cycle-include-plain-lists}.  The level of an item is then
given by the indentation of the bullet/number.  However, items are
always subortinate to real headlines, the hierarchies remain
completely separated.
@kindex M-S-@key{up}
@kindex M-S-@key{down}
@item M-S-@key{up}
@itemx M-S-@key{down}
Move the item including subitems up/down (swap with previous/next item

@kindex C-c ^
@item C-c ^
Sort the table lines in the region.  Point and mark must be in the first
and last line to be included, and must be in the column that should be
used for sorting.  The command prompts for numerical versus
alphanumerical sorting.

@tsubheading{Regions}
@kindex C-c C-x M-w
@item C-c C-x M-w
Copy a rectangular region from a table to a special clipboard.  Point

@node Hyperlinks, TODO items, Tables, Top
@chapter Hyperlinks
@cindex hyperlinks

Just like HMTL, Org-mode provides links inside a file, and external
links to other files, Usenet articles, emails and much more.

@menu
* Internal Links::              CamelCaseWords as internal links
* External Links::              URL-like links to the world
* Managing links::              Creating, inserting and following
* Search Options::              Linking to a specific location
* Remember::                    Org-trees store quick notes
@end menu

@node Internal Links, External Links, Hyperlinks, Hyperlinks
@section Internal Links
@cindex internal links
@cindex links, internal
@cindex CamelCase links

Similar to Wiki implementations, Org-mode interprets words spelled in
CamelCase (i.e. mixed case with at least one capital letter following
on a small letter inside the word) as links.  While in Wiki
implementations these links usually point to another file, in Org-mode
they point to a target in the current file.  Targets are CamelCased
words in double angular brackets, and may be located anywhere, also in
a comment line.  For example
@example
# <<MyTarget>>
@end example

Each occurence of @samp{MyTarget} in the file is an active link that
can be followed with @kbd{C-c C-o} or with a mouse click
(@pxref{Managing links}).  If no dedicated target exists, org-mode will
search for the words in the link separated by white space, in the
above example for @samp{my target}.  If the link starts with a star
like @samp{*MyTarget}, the search is restricted to headlines.
Org-mode will first try an exact match of a full headline, but then
move on to more and more lenient searches.  The link @samp{*MyTargets}
will find any of the following
@example
** My targets
** TODO my targets are bright
** my 20 targets are
@end example
@cindex completion, of CamelCase links
@cindex CamelCase links, completion of
It is therefore often not even necessary to set a dedicated target.
The link will automatically find a target.  If you want to see what
lines in the current buffer are matched by a given CamelCase link,
open the link with @kbd{C-u C-c C-o}.  Even if there are several
matches, org-mode will usually find the right one since it tries
targets and exact matches first.  To insert links targeting a
headline, in-buffer completion can be used.  Just type a star followed
by a few optional letters into the buffer and press @kbd{M-@key{TAB}}.
CamelCased versions of all headlines in the current buffer will be
offered as completions.  @xref{Managing links} for more commands
creating links.

@node External Links, Managing links, Internal Links, Hyperlinks
@section External Links
@cindex links
@cindex external links
@cindex links, external
@cindex GNUS links
@cindex BBDB links
@cindex URL links
@cindex file links
@cindex VM links

@example
<http://www.astro.uva.nl/~dominik>         @r{on the web}
<file:/home/dominik/images/jupiter.jpg>    @r{file, absolute path}
<file:papers/last.pdf>                     @r{file, relative path}
<news:comp.emacs>                          @r{Usenet link}
<mailto:adent@@galaxy.net>                  @r{Mail link}
<vm:folder>                                @r{VM folder link}
<vm:folder#id>                             @r{VM message link}
<vm://myself@@some.where.org/folder#id>     @r{VM on remote machine}

the end of a line.  In tables, the end of a table field also terminates
a link.  Angle brackets around a link are not required, but are
recommended to avoid problems with punctuation and other text following
the link.  See also the variable @code{org-allow-space-in-links}.


@node Managing links, Search Options, External Links, Hyperlinks
@section Managing links

Org-mode provides methods to create a link in the correct syntax, to
insert it into an org-mode file, and to follow the link.

@table @kbd
@kindex C-c l
@cindex storing links
@item C-c l
Store a link to the current location.  This is a @emph{global} command
which can be used in any buffer to create a link.  The link will be
stored for later insertion into an Org-mode buffer (see below).  For
VM, RMAIL, WANDERLUST, GNUS and BBDB buffers, the link will point to
the current article/entry.  For W3 and W3M buffer, the link goes to
the current URL.  For Org-mode files, the current headline is
targeted.  For any other files, the link will point to the file, with
a CamelCase (@pxref{Search Options}) search string pointing to the
contents of the current line.  If there is an active region, the
selected words will form the basis of the search string.  The key
binding @kbd{C-c l} is only a suggestion - see @ref{Installation and
Activation}.

@kindex C-c C-l
@cindex completion, of links
@cindex completion, of file names
@item C-c C-l

@kindex mouse-3
@item mouse-3
Like @kbd{mouse-2}, but force file links to be opened with Emacs.
@end table


@node Search Options, Remember, Managing links, Hyperlinks
@section Search options in file links

File links can contain additional information to make Emacs jump to a
particular location in the file when following a link.  This can be a
line number or a search option after a double@footnote{For backward
compatibility, line numbers can also follow a single colon.} colon.
For example:
@example
<file:~/code/main.c::255>
<file:~/xx.org::MyTarget>
<file:~/xx.org::find me>
<file:~/xx.org::/regexp/>
@end example
@noindent Here is what these options do.

@table @code
@item 255
Jump to line 255.
@item MyGoal
Search for a link target with name MyGoal, or do a text search for
@samp{my target}, similar to the CamelCase search in internal links,
see @ref{Internal Links}.
@item find me
Do a normal text search for the text @samp{find me}.
@item /regexp/
Do a regular expression search for @code{regexp}.  This uses the Emacs
command @code{occur} to list all matches in a separate window.  If the
target file is in Org-mode, @code{org-occur} is used to create a
sparse tree with the matches.
@c If the target file is a directory,
@c @code{grep} will be used to search all files in the directory.
@end table

To use the search options also for a search in the current file, a
file link with an empty file name can be used.  For example,
@code{<file:::find me>} does a search for @samp{find me} in the
current file.

@node Remember,  , Search Options, Hyperlinks
@section Remember
@cindex @file{remember.el}

Another way to create org entries with links to other files is through
the @emph{Remember} package by John Wiegley.  @emph{Remember} lets you

information.  The notes produced by @emph{Remember} can be stored in
different ways, and Org-mode files are a good target.  Org-mode allows
to file away notes either to a default file, or directly to the
correct location in your Org-mode outline tree.  The following
customization@footnote{The two autoload forms are only necessary if
@file{org.el} is not part of the Emacs distribution or an XEmacs
package.} will tell @emph{Remember} to use org files as target, and to
create annotations compatible with Org-mode links.

@example
(autoload 'org-remember-annotation "org")

@kindex C-c C-v
@cindex sparse tree, for TODO
@item C-c C-v
View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}).  Folds
the entire buffer, but shows all TODO items and the headings hierarchy
above them.  With prefix arg, show also the DONE entries.  With
numerical prefix N, show the tree for the Nth keyword in the variable
@code{org-todo-keywords}.
@kindex C-c t
@item C-c t
Show the global TODO list.  This collects the TODO items from all
agenda files (@pxref{Agenda}) into a single buffer.  The buffer is in
@code{agenda-mode}, so there are commands to examine and manipulate
the TODO entries directly from that buffer (@pxref{Agenda commands}).
A prefix argument can be used to collect only TODO entries of a
particular type.  With a C-u prefix you are prompted for a keyword.
With a numeric prefix, the Nth keyword in @code{org-todo-keywords} is
selected.
@kindex r
The @kbd{r} key in the agenda
buffer regenerates it, and you can give a prefix argument to this
command to change the selected TODO keyword, for example @kbd{3 r}.
The key binding @kbd{C-c t} is only a suggestion - see
@ref{Installation and Activation}.
@kindex C-u C-c a
@item C-u C-c a
A @kbd{C-u} argument to the @code{org-agenda command} (@pxref{Agenda})
includes all unfinished TODO items at the beginning of todays agenda.
@end table

@node TODO extensions, Priorities, TODO basics, TODO items
@section Extended use of TODO keywords
@cindex extended TODO keywords

@cindex names as TODO keywords
@cindex types as TODO keywords

The second possibility is to use TODO keywords to indicate different
types of action items.  For example, you might want to indicate that
items are for ``work'' or ``home''.  If you are into David Allen's
@emph{Getting Things DONE}, you might want to use todo types
@samp{NEXTACTION}, @samp{WAITING}, @samp{MAYBE}.  Or, when you work
with several people on a single project, you might want to assign
action items directly to persons, by using their names as TODO
keywords.  This would be set up like this:

@lisp
(setq org-todo-keywords '("Fred" "Sara" "Lucy" "Mike" "DONE")
      org-todo-interpretation 'type)
@end lisp

rather different types.  So it is normally not useful to change from
one type to another.  Therefore, in this case the behavior of the
command @kbd{C-c C-t} is changed slightly@footnote{This is also true
for the @kbd{t} command in the timeline and agenda buffers.}.  When
used several times in succession, it will still cycle through all
names.  But when you return to the item after some time and execute
@kbd{C-c C-t} again, it will switch from each name directly to DONE.
Use prefix arguments or completion to quickly select a specific name.
You can also review the items of a specific TODO type in a sparse tree
by using a numeric prefix to @kbd{C-c C-v}.  For example, to see all
things Lucy has to do, you would use @kbd{C-3 C-c C-v}.  To collect
collect Lucy's items from all agenda files into a single buffer, you
would use the prefix arg as well when creating the global todo list:
@kbd{C-3 C-c t}.

@node Per file keywords,  , TODO types, TODO extensions
@subsection Setting up TODO keywords for individual files
@cindex keyword options
@cindex per file keywords

Increase/decrease priority of current item.  Note that these keys are
also used to modify time stamps (@pxref{Creating timestamps}).
Furthermore, these keys are also used by CUA-mode
(@pxref{Interaction}).
@end table

@node Timestamps, Timeline and Agenda, TODO items, Top
@chapter Timestamps

Items can be labeled with timestamps to make them useful for project

which is derived from the file name.  The category can also be set
with a special line anywhere in the buffer, looking like this:
@example
#+CATEGORY: Thesis
@end example
If there are several such lines in a file, each specifies the category
for the text below it.  The display in the agenda buffer looks best if
the category is not longer than 10 characters.

@subsection Time-of-Day Specifications

Org-mode checks each agenda item for a time-of-day specification.  The
time can be part of the time stamp that triggered inclusion into the

@kindex r
@item r
Recreate the agenda buffer, for example to reflect the changes
after modification of the time stamps of items with S-@key{left} and
S-@key{right}.  When the buffer is the global todo list, a prefix
argument is interpreted to create a selective list for a specific TODO
keyword.

@kindex @key{right}
@item @key{right}
Display the following @code{org-agenda-ndays} days.  For example, if
the display covers a week, switch to the following week.  With prefix

@example
@kbd{C-1 C-c C-x a org-export-as-ascii}
@end example
@noindent
creates only top level headlines and does the rest as items.  Lines
starting with @samp{#} and subtrees starting with the word @samp{COMMENT}
will not be exported.

@node HTML export, iCalendar export, ASCII export, Exporting
@section HTML export
@cindex HTML export

Create a single large iCalendar file from all files in
@code{org-agenda-files} and write it to the file given by
@code{org-combined-agenda-icalendar-file}.
@end table

How this calendar is best read and updated, depends on the application
you are using.  For example, when using iCal under Apple MacOS X, you
could create a new calendar @samp{OrgMode} (the default name for the
calendar created by @kbd{C-c C-x c}, see the variables
@code{org-icalendar-combined-name} and
@code{org-combined-agenda-icalendar-file}).  Then set Org-mode to
overwrite the corresponding file
@file{~/Library/Calendars/OrgMode.ics}.  You may even use AppleScript
to make iCal re-read the calendar files each time a new version of

@section Completion
@cindex completion, of @TeX{} symbols
@cindex completion, of TODO keywords
@cindex completion, of dictionary words
@cindex completion, of option keywords
@cindex completion, of CamelCase links

Org-mode supports in-buffer completion.  This type of completion does
not make use of the minibuffer.  You simply type a few letters into
the buffer and use the key to complete text right there.

@itemize @bullet
@item
At the beginning of a headline, complete TODO keywords.
@item
After @samp{\}, complete @TeX{} symbols supported by the exporter.
@item
After @samp{*}, complete CamelCase versions of all headlines in the
buffer.
@item
After @samp{#+}, complete the special keywords like @samp{TYP_TODO} or
@samp{OPTIONS} which set file-specific options for Org-mode.  When the
option keyword is already complete, pressing @kbd{M-@key{TAB}} again
will insert example settings for this keyword.

Kai Grossjohann pointed out that a number of key bindings in Org-mode
conflict with other packages.
@item 
Roland Winkler pointed out that additional keybindings are needed to
use Org-mode on a tty.
@item
Tim O'Callaghan suggested in-file links, and search options for
general file links.
@c @item
@c Nic Ferrier and Christian Egli implemented XML export.
@end itemize

@node Index, Key Index, Miscellaneous, Top
@chapter Index