[Emacs-diffs] Changes to emacs/man/org.texi,v

[Carsten Dominik]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Carsten Dominik <cdominik>      06/07/07 06:32:09

Index: org.texi
===================================================================
RCS file: /sources/emacs/emacs/man/org.texi,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -b -r1.67 -r1.68
--- org.texi    3 Jul 2006 10:25:27 -0000       1.67
+++ org.texi    7 Jul 2006 06:32:09 -0000       1.68
@@ -3,7 +3,7 @@
 @setfilename ../info/org
 @settitle Org Mode Manual
 
address@hidden VERSION 4.42
address@hidden VERSION 4.43
 @set DATE July 2006
 
 @dircategory Emacs
@@ -771,14 +771,14 @@
 Other commands use sparse trees as well.  For example @kbd{C-c
 C-v} creates a sparse TODO tree (@pxref{TODO basics}).
 
address@hidden C-c C-x v
address@hidden C-c C-e v
 @cindex printing sparse trees
 @cindex visible text, printing
 To print a sparse tree, you can use the Emacs command
 @code{ps-print-buffer-with-faces} which does not print invisible parts
 of the document @footnote{This does not work under XEmacs, because
 XEmacs uses selective display for outlining, not text properties.}.
-Or you can use the command @kbd{C-c C-x v} to export only the visible
+Or you can use the command @kbd{C-c C-e v} to export only the visible
 part of the document and print the resulting file.
 
 
@@ -3059,6 +3059,23 @@
 TODO entry with a single key press.  The commands available in the
 TODO list are described in @ref{Agenda commands}.
 
+Nomally the global todo list simply shows all headlines with TODO
+keywords.  This list can become very long.  There are two ways to keep
+it more compact:
address@hidden @minus
address@hidden
+Some people view a TODO item that has been @emph{scheduled} for
+execution (@pxref{Time stamps}) as no longer @emph{open}.  Configure the
+variable @code{org-agenda-todo-ignore-scheduled} to exclude scheduled
+items from the global TODO list.
address@hidden
+TODO items may have sublevels to break up the task into subtasks.  In
+such cases it may be enough to list only the highest level TODO headline
+and omit the sublevels from the global list.  Configure the variable
address@hidden to get this behavior.
address@hidden itemize
+
+
 @node Matching headline tags, Timeline, Global TODO list, Agenda views
 @section Matching headline tags
 @cindex matching, of tags
@@ -3341,6 +3358,7 @@
 @item H
 Show holidays for three month around the cursor date.
 
address@hidden FIXME:  This should be a different key.
 @kindex C-c C-x C-c
 @item C-c C-x C-c
 Export a single iCalendar file containing entries from all agenda files.
@@ -3575,6 +3593,14 @@
 When exporting, Org-mode uses special conventions to enrich the output
 produced.  @xref{Text interpretation}, for more details.
 
address@hidden @kbd
address@hidden C-c C-e
address@hidden 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.
address@hidden table
+
 @menu
 * ASCII export::                Exporting to plain ASCII
 * HTML export::                 Exporting to HTML
@@ -3594,14 +3620,14 @@
 @cindex active region
 @cindex transient-mark-mode
 @table @kbd
address@hidden C-c C-x a
address@hidden C-c C-x a
address@hidden C-c C-e a
address@hidden C-c C-e a
 Export as ASCII file.  If there is an active region, only the region
 will be exported.  For an org file @file{myfile.org}, the ASCII file
 will be @file{myfile.txt}.  The file will be overwritten without
 warning.
address@hidden C-c C-x v a
address@hidden C-c C-x v a
address@hidden C-c C-e v a
address@hidden C-c C-e v a
 Export only the visible part of the document.
 @end table
 
@@ -3612,7 +3638,7 @@
 at a different level, specify it with a prefix argument.  For example,
 
 @example
address@hidden C-c C-x a}
address@hidden C-c C-e a}
 @end example
 
 @noindent
@@ -3636,16 +3662,16 @@
 @cindex active region
 @cindex transient-mark-mode
 @table @kbd
address@hidden C-c C-x h
address@hidden C-c C-x h
address@hidden C-c C-e h
address@hidden C-c C-e h
 Export as HTML file @file{myfile.html}.
address@hidden C-c C-x b
address@hidden C-c C-x b
address@hidden C-c C-e b
address@hidden C-c C-e b
 Export as HTML file and open it with a browser.
address@hidden C-c C-x v h
address@hidden C-c C-x v b
address@hidden C-c C-x v h
address@hidden C-c C-x v b
address@hidden C-c C-e v h
address@hidden C-c C-e v b
address@hidden C-c C-e v h
address@hidden C-c C-e v b
 Export only the visible part of the document.
 @end table
 
@@ -3656,7 +3682,7 @@
 at a different level, specify it with a prefix argument.  For example,
 
 @example
address@hidden C-c C-x b}
address@hidden C-c C-e b}
 @end example
 
 @noindent
@@ -3725,11 +3751,11 @@
 does not interpret any additional Org-mode features.
 
 @table @kbd
address@hidden C-c C-x C-x
address@hidden C-c C-x C-x
address@hidden C-c C-e x
address@hidden C-c C-e x
 Export as XOXO file @file{myfile.html}.
address@hidden C-c C-x v
address@hidden C-c C-x v x
address@hidden C-c C-e v
address@hidden C-c C-e v x
 Export only the visible part of the document.
 @end table
 
@@ -3745,17 +3771,17 @@
 iCalendar format.
 
 @table @kbd
address@hidden C-c C-x i
address@hidden C-c C-x i
address@hidden C-c C-e i
address@hidden C-c C-e i
 Create iCalendar entries for the current file and store them in the same
 directory, using a file extension @file{.ics}.
address@hidden C-c C-x C-i
address@hidden C-c C-x C-i
-Like @kbd{C-c C-x i}, but do this for all files in
address@hidden C-c C-e I
address@hidden C-c C-e I
+Like @kbd{C-c C-e i}, but do this for all files in
 @code{org-agenda-files}.  For each of these files, a separate iCalendar
 file will be written.
address@hidden C-c C-x c
address@hidden C-c C-x c
address@hidden C-c C-e c
address@hidden C-c C-e c
 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}.
@@ -3764,7 +3790,7 @@
 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
+calendar created by @kbd{C-c C-e 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
@@ -3881,13 +3907,13 @@
 The exporter recognizes special lines in the buffer which provide
 additional information.  These lines may be put anywhere in the file.
 The whole set of lines can be inserted into the buffer with @kbd{C-c
-C-x t}.  For individual lines, a good way to make sure the keyword is
+C-e t}.  For individual lines, a good way to make sure the keyword is
 correct is to type @samp{#+} and then use @address@hidden completion
 (@pxref{Completion}).
 
 @table @kbd
address@hidden C-c C-x t
address@hidden C-c C-x t
address@hidden C-c C-e t
address@hidden C-c C-e t
 Insert template with export options, see example below.
 @end table
 
@@ -4251,11 +4277,11 @@
 
 @table @kbd
 @item C-c C-e c
-Prompts for a specific project to publish.
+Prompt for a specific project and publish all files that belong to it.
 @item C-c C-e p
-Publishes the project the current file is part of. 
+Publish the project containin the current file.
 @item C-c C-e f
-Publishes only the current file.
+Publish only the current file.
 @item C-c C-e a
 Publish all projects.
 @end table
@@ -4770,7 +4796,7 @@
 @section Dynamic blocks
 
 Org-mode documents can contain @emph{dynamic blocks}.  These are
-specially marked regions that are updates by some user-written
+specially marked regions that are updated by some user-written
 function.  A good example for such a block is the clock table inserted
 by the command @kbd{C-c C-x C-r} (@pxref{Clocking work time}).
 
@@ -4814,7 +4840,7 @@
 The corresponding block writer function could look like this:
 
 @lisp
-(defun org-dblock-write:date-and-time (params)
+(defun org-dblock-write:block-update-time (params)
    (let ((fmt (or (plist-get params :format) "%d. %m. %Y")))
      (insert "Last block update at: "
             (format-time-string fmt (current-time)))))