comparison man/org.texi @ 70951:39f6e1889f85

(ASCII export): Omit command name. (HTML export): Add prefix to all lines in Local Variable example. (Acknowledgments): Typeset names in italics.

70950:5b39adf3adb7

\input texinfo

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

@set VERSION 4.33
@set DATE May 2006

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

@c Version and Contact Info
@set MAINTAINERSITE @uref{http://www.astro.uva.nl/~dominik/Tools/org/,maintainers webpage}
@set MAINTAINER Carsten Dominik
@set MAINTAINEREMAIL @email{dominik@@science.uva.nl}
@set MAINTAINERCONTACT @uref{mailto:dominik@@science.uva.nl,contact the maintainer}
@c %**end of header
@finalout

@cindex bug reports
@cindex maintainer
@cindex author

If you find problems with Org-mode, or if you have questions, remarks,
or ideas about it, please contact the maintainer Carsten Dominik at
@value{MAINTAINEREMAIL}.

For bug reports, please provide as much information as possible,
including the version information of Emacs (@kbd{C-h v emacs-version
@key{RET}}) and Org-mode (@kbd{C-h v org-version @key{RET}}), as well as

@item C-c a t
Show the global TODO list.  This collects the TODO items from all
agenda files (@pxref{Agenda views}) 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}).
@xref{Global TODO list}, for more information.
@kindex C-c a T
@item C-c a T
Like the above, but allows selection of a specific TODO keyword.  You can
also do this by specifying a prefix argument to @kbd{C-c a t}.  With a
@kbd{C-u} prefix you are prompted for a keyword.  With a numeric

headlines, defining a general document structure.  Additional levels
will be exported as itemized lists.  If you want that transition to occur
at a different level, specify it with a prefix argument.  For example,

@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.

@example
* COMMENT HTML style specifications

# Local Variables:
# org-export-html-style: "   <style type=\"text/css\">
       p @{font-weight: normal; color: gray; @}
       h1 @{color: black; @}
   </style>"
# End: ***
@end example

Remember to execute @kbd{M-x normal-mode} after changing this to make
the new style visible to Emacs.  This command restarts org-mode for the
current buffer and forces Emacs to re-evaluate the local variables

@cindex special keywords

Org-mode uses special lines in the buffer to define settings on a
per-file basis.  These lines start with a @samp{#+} followed by a
keyword, a colon, and then individual words defining a setting.  Several
settings words con be in the same line, but you can also have multiple
lines for the keyword.  While these settings are described throughout
the manual, here is a summary.  After changing any of those lines in the
buffer, press @kbd{C-c C-c} with the cursor still in the line to
activate the changes immediately.  Otherwise they become effective only
when the file is visited again in a new Emacs session.

showstars  @r{show all stars starting a headline}
odd        @r{allow only odd outline levels (1,3,...)}
oddeven    @r{allow all outline levels}
@end example
@item #+SEQ_TODO:   #+TYP_TODO:
These lines that the TODO keywords and their interpretation in the
current file.  The corresponding variables are @code{org-todo-keywords}
and @code{org-todo-interpretation}.
@item #+TAGS:  TAG1(c1) TAG2(c2)
These lines (several such lines are allowed) specify the legal tags in
this file, and (potionally) the corresponding @emph{fast tag selection}

@node Acknowledgments,  , Bugs, Miscellaneous
@section Acknowledgments
@cindex acknowledgments
@cindex thanks

Org-mode was written by Carsten Dominik, who still maintains it at the
Org-mode homepage @uref{http://www.astro.uva.nl/~dominik/Tools/org/}.
The following people (in alphabetic order) have helped the development
along with ideas, suggestions and patches.  Many thanks to all of you,
Org-mode would not be what it is without your input.

@itemize @bullet
@item
Thomas Baumann contributed the code for links to the MH-E email system.
@item
Alex Bochannek provided a patch for rounding time stamps.
@item
Charles Caves' suggestion sparked the implementation of templates for
Remember.
@item
Pavel Chalmoviansky influenced the agenda treatment of items with
specified time.
@item
Gregory Chenov patched support for lisp forms into table calculations
and improved XEmacs compatibility.
@item
Sacha Chua suggested to copy some linking code from Planner.
@item
Kees Dullemond inspired the use of narrowed tabled columns.
@item
Christian Egli converted the documentation into TeXInfo format, patched
CSS formatting into the HTML exporter, and inspired the agenda.
@item
Nic Ferrier contributed mailcap and XOXO support.
@item
Kai Grossjohann pointed out key-binding conflicts caused by Org-mode.
@item
Stefan Monnier provided a patch to keep the Emacs-Lisp compiler happy.
@item
Todd Neal provided patches for links to Info files and elisp forms.
@item
Tim O'Callaghan suggested in-file links, search options for
general file links, and TAGS.
@item
Oliver Oppitz suggested multi-state TODO items.
@item
Scott Otterson sparked the introduction of descriptive text for links,
among other things.
@item
Pete Phillips helped the development of the TAGS feature.
@item
T.V. Raman reported bugs and suggested improvements.
@item
Matthias Rempe (Oelde) provided ideas, Windows support, and quality
control.
@item
Kevin Rogers contributed code to access VM files on remote hosts.
@item
Frank Ruell solved the mystery of the @code{keymapp nil} bug, a conflict
with @file{allout.el}.
@item
Philip Rooke created the Org-mode reference card and provided lots of feedback.
@item
Christian Schlauer proposed angular brackets around links, among other
things.
@item
Linking to VM/BBDB/GNUS was inspired by Tom Shannon's
@file{organizer-mode.el}.
@item
David O'Toole wrote @file{org-publish.el} and came up with lots is ideas
for small changes.
@item
J@"urgen Vollmer contributed code generating the table of contents
in HTML output.
@item
Chris Wallace provided a patch implementing the @samp{QUOTE} keyword.
@item
David Wainberg suggested archiving, and improvements to the linking
system.
@item
John Wiegley wrote @file{emacs-wiki.el} and @file{planner.el}.  The
development of Org-mode was fully independent, and both systems are
really different beasts in their basic ideas and implementation details.
I later looked at John's code, however, and learned from his
implementation of (i) links where the link itself is hidden and only a
description is shown, and (ii) popping up a calendar to select a date.
@item
Carsten Wimmer suggested some changes and helped fix a bug in linking
to GNUS.
@item
Roland Winkler requested additional keybindings to make Org-mode
work on a tty.
@item
Piotr Zielinski wrote @file{org-mouse.el} and showed how to follow links
with mouse-1.
@end itemize
 
@node Index, Key Index, Miscellaneous, Top
@chapter Index

70951:39f6e1889f85

\input texinfo

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

@set VERSION 4.34
@set DATE May 2006

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

@c Version and Contact Info
@set MAINTAINERSITE @uref{http://www.astro.uva.nl/~dominik/Tools/org/,maintainers webpage}
@set AUTHOR Carsten Dominik
@set MAINTAINER Carsten Dominik
@set MAINTAINEREMAIL @email{dominik@@science.uva.nl}
@set MAINTAINERCONTACT @uref{mailto:dominik@@science.uva.nl,contact the maintainer}
@c %**end of header
@finalout

@cindex bug reports
@cindex maintainer
@cindex author

If you find problems with Org-mode, or if you have questions, remarks,
or ideas about it, please contact the maintainer @value{MAINTAINER} at
@value{MAINTAINEREMAIL}.

For bug reports, please provide as much information as possible,
including the version information of Emacs (@kbd{C-h v emacs-version
@key{RET}}) and Org-mode (@kbd{C-h v org-version @key{RET}}), as well as

@item C-c a t
Show the global TODO list.  This collects the TODO items from all
agenda files (@pxref{Agenda views}) 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}).
@kindex C-c a T
@item C-c a T
Like the above, but allows selection of a specific TODO keyword.  You can
also do this by specifying a prefix argument to @kbd{C-c a t}.  With a
@kbd{C-u} prefix you are prompted for a keyword.  With a numeric

headlines, defining a general document structure.  Additional levels
will be exported as itemized lists.  If you want that transition to occur
at a different level, specify it with a prefix argument.  For example,

@example
@kbd{C-1 C-c C-x a}
@end example

@noindent
creates only top level headlines and does the rest as items.

@example
* COMMENT HTML style specifications

# Local Variables:
# org-export-html-style: "   <style type=\"text/css\">
#       p @{font-weight: normal; color: gray; @}
#       h1 @{color: black; @}
#   </style>"
# End:
@end example

Remember to execute @kbd{M-x normal-mode} after changing this to make
the new style visible to Emacs.  This command restarts org-mode for the
current buffer and forces Emacs to re-evaluate the local variables

@cindex special keywords

Org-mode uses special lines in the buffer to define settings on a
per-file basis.  These lines start with a @samp{#+} followed by a
keyword, a colon, and then individual words defining a setting.  Several
setting words can be in the same line, but you can also have multiple
lines for the keyword.  While these settings are described throughout
the manual, here is a summary.  After changing any of those lines in the
buffer, press @kbd{C-c C-c} with the cursor still in the line to
activate the changes immediately.  Otherwise they become effective only
when the file is visited again in a new Emacs session.

showstars  @r{show all stars starting a headline}
odd        @r{allow only odd outline levels (1,3,...)}
oddeven    @r{allow all outline levels}
@end example
@item #+SEQ_TODO:   #+TYP_TODO:
These lines set the TODO keywords and their interpretation in the
current file.  The corresponding variables are @code{org-todo-keywords}
and @code{org-todo-interpretation}.
@item #+TAGS:  TAG1(c1) TAG2(c2)
These lines (several such lines are allowed) specify the legal tags in
this file, and (potionally) the corresponding @emph{fast tag selection}

@node Acknowledgments,  , Bugs, Miscellaneous
@section Acknowledgments
@cindex acknowledgments
@cindex thanks

Org-mode was created by @value{AUTHOR}, who still maintains it at the
Org-mode homepage @uref{http://www.astro.uva.nl/~dominik/Tools/org/}.
The following people (in alphabetic order) have helped the development
along with ideas, suggestions and patches.  Many thanks to all of you,
Org-mode would not be what it is without your input.

@itemize @bullet
@item
@i{Thomas Baumann} contributed the code for links to the MH-E email
system.
@item
@i{Alex Bochannek} provided a patch for rounding time stamps.
@item
@i{Charles Cave}'s suggestion sparked the implementation of templates
for Remember.
@item
@i{Pavel Chalmoviansky} influenced the agenda treatment of items with
specified time.
@item
@i{Gregory Chenov} patched support for lisp forms into table
calculations and improved XEmacs compatibility.
@item
@i{Sacha Chua} suggested to copy some linking code from Planner.
@item
@i{Kees Dullemond} inspired the use of narrowed tabled columns.
@item
@i{Christian Egli} converted the documentation into TeXInfo format,
patched CSS formatting into the HTML exporter, and inspired the agenda.
@item
@i{Nic Ferrier} contributed mailcap and XOXO support.
@item
@i{Kai Grossjohann} pointed out key-binding conflicts caused by
Org-mode.
@item
@i{Stefan Monnier} provided a patch to keep the Emacs-Lisp compiler
happy.
@item
@i{Todd Neal} provided patches for links to Info files and elisp forms.
@item
@i{Tim O'Callaghan} suggested in-file links, search options for general
file links, and TAGS.
@item
@i{Oliver Oppitz} suggested multi-state TODO items.
@item
@i{Scott Otterson} sparked the introduction of descriptive text for
links, among other things.
@item
@i{Pete Phillips} helped the development of the TAGS feature.
@item
@i{T.V. Raman} reported bugs and suggested improvements.
@item
@i{Matthias Rempe} (Oelde) provided ideas, Windows support, and quality
control.
@item
@i{Kevin Rogers} contributed code to access VM files on remote hosts.
@item
@i{Frank Ruell} solved the mystery of the @code{keymapp nil} bug, a
conflict with @file{allout.el}.
@item
@i{Philip Rooke} created the Org-mode reference card and provided lots
of feedback.
@item
@i{Christian Schlauer} proposed angular brackets around links, among
other things.
@item
Linking to VM/BBDB/GNUS was inspired by @i{Tom Shannon}'s
@file{organizer-mode.el}.
@item
@i{David O'Toole} wrote @file{org-publish.el} and came up with lots is
ideas for small changes.
@item
@i{J@"urgen Vollmer} contributed code generating the table of contents
in HTML output.
@item
@i{Chris Wallace} provided a patch implementing the @samp{QUOTE}
keyword.
@item
@i{David Wainberg} suggested archiving, and improvements to the linking
system.
@item
@i{John Wiegley} wrote @file{emacs-wiki.el} and @file{planner.el}.  The
development of Org-mode was fully independent, and both systems are
really different beasts in their basic ideas and implementation details.
I later looked at John's code, however, and learned from his
implementation of (i) links where the link itself is hidden and only a
description is shown, and (ii) popping up a calendar to select a date.
@item
@i{Carsten Wimmer} suggested some changes and helped fix a bug in
linking to GNUS.
@item
@i{Roland Winkler} requested additional keybindings to make Org-mode
work on a tty.
@item
@i{Piotr Zielinski} wrote @file{org-mouse.el} and showed how to follow
links with mouse-1.
@end itemize
 
@node Index, Key Index, Miscellaneous, Top
@chapter Index