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

[Carsten Dominik]

Index: emacs/man/org.texi
diff -u emacs/man/org.texi:1.53 emacs/man/org.texi:1.54
--- emacs/man/org.texi:1.53     Tue Apr 18 06:36:56 2006
+++ emacs/man/org.texi  Thu Apr 20 11:48:19 2006
@@ -4,7 +4,7 @@
 @setfilename ../info/org
 @settitle Org Mode Manual
 
address@hidden VERSION 4.24
address@hidden VERSION 4.25
 @set DATE April 2006
 
 @dircategory Emacs
@@ -76,13 +76,13 @@
 
 @menu
 * Introduction::                Getting started
-* Document Structure::          A tree works like your brain
+* Document structure::          A tree works like your brain
 * Tables::                      Pure magic for quick formatting
 * Hyperlinks::                  Notes in context
 * TODO items::                  Every tree branch can be a TODO item
 * Timestamps::                  Assign date and time to items
 * Tags::                        Tagging headlines and matching sets of tags
-* Agenda Views::                Collecting information into views
+* Agenda views::                Collecting information into views
 * Exporting::                   Sharing and publishing of notes
 * Miscellaneous::               All the rest which did not fit elsewhere
 * Index::                       The fast road to specific information
@@ -97,7 +97,7 @@
 * Installation and activation::  How to install Org-mode
 * Feedback::                    Bug reports, ideas, patches etc.
 
-Document Structure
+Document structure
 
 * Outlines::                    Org-mode is based on outline-mode
 * Headlines::                   How to typeset org-tree headlines
@@ -106,7 +106,7 @@
 * Structure editing::           Changing sequence and level of headlines
 * Archiving::                   Move done task trees to a different place
 * Sparse trees::                Matches embedded in context
-* Plain Lists::                 Editing hand-formatted lists
+* Plain lists::                 Editing hand-formatted lists
 
 Tables
 
@@ -163,11 +163,11 @@
 * Setting tags::                How to assign tags to a headline
 * Tag searches::                Searching for combinations of tags
 
-Agenda Views
+Agenda views
 
 * Agenda files::                Files being searched for agenda information
 * Agenda dispatcher::           Keyboard access to agenda views
-* Weekly/Daily Agenda::         The calendar page with current tasks
+* Weekly/Daily agenda::         The calendar page with current tasks
 * Global TODO list::            All unfinished action items
 * Matching headline tags::      Structured information with fine-tuned search
 * Timeline::                    Time-sorted view for single file
@@ -210,7 +210,7 @@
 @end detailmenu
 @end menu
 
address@hidden Introduction, Document Structure, Top, Top
address@hidden Introduction, Document structure, Top, Top
 @chapter Introduction
 @cindex introduction
 
@@ -339,7 +339,7 @@
 @end enumerate
 @noindent Thank you for helping to improve this mode.
 
address@hidden Document Structure, Tables, Introduction, Top
address@hidden Document structure, Tables, Introduction, Top
 @chapter Document Structure
 @cindex document structure
 @cindex structure of document
@@ -355,10 +355,10 @@
 * Structure editing::           Changing sequence and level of headlines
 * Archiving::                   Move done task trees to a different place
 * Sparse trees::                Matches embedded in context
-* Plain Lists::                 Editing hand-formatted lists
+* Plain lists::                 Editing hand-formatted lists
 @end menu
 
address@hidden Outlines, Headlines, Document Structure, Document Structure
address@hidden Outlines, Headlines, Document structure, Document structure
 @section Outlines
 @cindex outlines
 @cindex outline-mode
@@ -373,7 +373,7 @@
 single command @command{org-cycle}, which is bound to the @key{TAB}
 key.
 
address@hidden Headlines, Visibility cycling, Outlines, Document Structure
address@hidden Headlines, Visibility cycling, Outlines, Document structure
 @section Headlines
 @cindex headlines
 @cindex outline tree
@@ -396,7 +396,7 @@
 outline that has whitespace followed by a single star as headline
 starters.  @ref{Clean view} describes a setup to realize this.
 
address@hidden Visibility cycling, Motion, Headlines, Document Structure
address@hidden Visibility cycling, Motion, Headlines, Document structure
 @section Visibility cycling
 @cindex cycling, visibility
 @cindex visibility cycling
@@ -458,7 +458,7 @@
 #+STARTUP: showall
 @end example
 
address@hidden Motion, Structure editing, Visibility cycling, Document Structure
address@hidden Motion, Structure editing, Visibility cycling, Document structure
 @section Motion
 @cindex motion, between headlines
 @cindex jumping, to headlines
@@ -491,7 +491,7 @@
 visible.
 @end table
 
address@hidden Structure editing, Archiving, Motion, Document Structure
address@hidden Structure editing, Archiving, Motion, Document structure
 @section Structure editing
 @cindex structure editing
 @cindex headline, promotion and demotion
@@ -507,9 +507,14 @@
 @kindex address@hidden
 @item address@hidden
 Insert new heading with same level as current.  If the cursor is in a
-plain list item, a new item is created.  To force creation of a new
-headline, use a prefix arg, or first press @key{RET} to get to the
-beginning of the next line.
+plain list item, a new item is created (@pxref{Plain lists}).  To force
+creation of a new headline, use a prefix arg, or first press @key{RET}
+to get to the beginning of the next line.  When this command is used in
+the middle of a line, the line is split and the rest of the line becomes
+the new headline.  If the command is used at the beginning of a
+headline, the new headline is created before the current line.  It at
+the beginning of any other line, the content of that line is made the
+new heading.
 @kindex address@hidden
 @item address@hidden
 Insert new TODO entry with same level as current heading.
@@ -559,7 +564,7 @@
 inside a table (@pxref{Tables}), the Meta-Cursor keys have different
 functionality.
 
address@hidden Archiving, Sparse trees, Structure editing, Document Structure
address@hidden Archiving, Sparse trees, Structure editing, Document structure
 @section Archiving
 @cindex archiving
 @cindex filing subtrees
@@ -583,7 +588,7 @@
 agenda, archiving to a different file is a good way to keep archived
 trees from contributing agenda items.
 
address@hidden Sparse trees, Plain Lists, Archiving, Document Structure
address@hidden Sparse trees, Plain lists, Archiving, Document structure
 @section Sparse trees
 @cindex sparse trees
 @cindex trees, sparse
@@ -643,8 +648,8 @@
 printed in any desired way.
 
 
address@hidden Plain Lists,  , Sparse trees, Document Structure
address@hidden Plain Lists
address@hidden Plain lists,  , Sparse trees, Document structure
address@hidden Plain lists
 @cindex plain lists
 @cindex lists, plain
 @cindex lists, ordered
@@ -699,7 +704,14 @@
 completely separated.
 @kindex address@hidden
 @item address@hidden
-Insert new item at current level.  With prefix arg, for a new heading.
+Insert new item at current level.  With prefix arg, force a new heading
+(@pxref{Structure editing}).  If this command is used in the middle of a
+line, the line is @emph{split} and the rest of the line becomes the new
+item.  If this command is executed in the @emph{whitespace before a bullet or
+number}, the new item is created @emph{before} the current item.  If the
+command is executed in the white space before the text that is part of
+an item but does not contain the bullet, a bullet is added to the
+current line.
 @kindex address@hidden
 @kindex address@hidden
 @item address@hidden
@@ -722,7 +734,7 @@
 Renumber the ordered list at the cursor.
 @end table
 
address@hidden Tables, Hyperlinks, Document Structure, Top
address@hidden Tables, Hyperlinks, Document structure, Top
 @chapter Tables
 @cindex tables
 @cindex editing tables
@@ -1414,6 +1426,9 @@
 # <<My Target>>
 @end example
 
address@hidden In HTML export (@pxref{HTML export}), such targets will become
+named anchors for direct access through http links.
+
 If no dedicated target exists, Org-mode will search for the words in the
 link, often removing the need for a dedicated target.  In the above
 example the search would be for @samp{my target}.  Links starting with a
@@ -1571,9 +1586,10 @@
 a file will be inserted and you may use file name completion to select
 the name of the file.  The path to the file is inserted relative to the
 directory of the current org file, if the linked file is in the current
-directory or in a subdirectory of it.  Otherwise an absolute path, if
-possible with @samp{~/} for your home directory is used.  You can force
-an absolute path with two @kbd{C-u} prefixes.
+directory or in a subdirectory of it, or if the path is written relative
+to the current directory using @samp{../}.  Otherwise an absolute path
+is used, if possible with @samp{~/} for your home directory.  You can
+force an absolute path with two @kbd{C-u} prefixes.
 
 @item C-c C-l @r{with cursor on existing link}
 When the cursor is on an existing link, @kbd{C-c C-l} allows to edit the
@@ -1648,7 +1664,9 @@
 @item My Target
 Search for a link target @samp{<<My Target>>}, or do a text search for
 @samp{my target}, similar to the search in internal links, see
address@hidden links}.
address@hidden links}.  In HTML export (@pxref{HTML export}), such a file
+link will become an html reference to the corresponding named anchor in
+the linked file.
 @item *My Target
 In an Org-mode file, restrict search to headlines.
 @item /regexp/
@@ -1821,7 +1839,7 @@
 @kindex C-c a t
 @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
+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.
@@ -1847,7 +1865,7 @@
 @samp{CLOSED: [timestamp]} will be inserted just after the headline.
 If you turn the entry back into a TODO item again through further
 state cycling, that line will be removed again.  In the timeline
-(@pxref{Timeline}) and in the agenda (@pxref{Weekly/Daily Agenda}),
+(@pxref{Timeline}) and in the agenda (@pxref{Weekly/Daily agenda}),
 you can then use the @kbd{L} key to display the TODO items closed on
 each day, giving you an overview of what has been done on a day.
 
@@ -1989,7 +2007,7 @@
 With its standard setup, Org-mode supports priorities @samp{A},
 @samp{B}, and @samp{C}.  @samp{A} is the highest priority.  An entry
 without a cookie is treated as priority @samp{B}.  Priorities make a
-difference only in the agenda (@pxref{Weekly/Daily Agenda}).
+difference only in the agenda (@pxref{Weekly/Daily agenda}).
 
 @table @kbd
 @kindex @kbd{C-c ,}
@@ -2034,14 +2052,16 @@
 special format, either @samp{<2003-09-16 Tue>} or @samp{<2003-09-16
 Tue 09:39>}.  A time stamp can appear anywhere in the headline or body
 of an org-tree entry.  Its presence allows entries to be shown on specific
-dates in the agenda (@pxref{Weekly/Daily Agenda}).  We distinguish:
+dates in the agenda (@pxref{Weekly/Daily agenda}).  We distinguish:
 
 @table @var
 @cindex timestamp
 @item TIMESTAMP
-A simple time stamp just assigns a date/time to an item.  In the
-timeline and agenda displays, the headline of the entry will be shown
-exactly on that date.
+A simple time stamp just assigns a date/time to an item.  This is just
+like writing down an appointment in a paper agenda, or like writing down
+an event in a diary, when you want to take not of when something
+happened.  In the timeline and agenda displays, the headline of an entry
+associated with a plain time stamp will be shown exactly on that date.
 
 @item TIMERANGE
 @cindex timerange
@@ -2055,6 +2075,21 @@
    <2004-08-23 Mon>--<2004-08-26 Thu>
 @end example
 
address@hidden SCHEDULED
address@hidden SCHEDULED keyword
+If a time stamp is preceded by the word @samp{SCHEDULED:}, it means you
+are planning to start working on that task on the given date. So this is
+not about recording an event, but about planning your work.  The
+headline will be listed under the given date.  In addition, a reminder
+that the scheduled date has passed will be present in the compilation
+for @emph{today}, until the entry is marked DONE.  I.e., the task will
+automatically be forwarded until completed.
+
address@hidden
+*** TODO Call Trillian to ask her out for a date on New Years Eve.
+    SCHEDULED: <2004-12-25 Sat>
address@hidden example
+
 @item DEADLINE
 @cindex DEADLINE keyword
 If a time stamp is preceded by the word @samp{DEADLINE:}, the task
@@ -2069,15 +2104,6 @@
     The editor in charge is <bbdb:Ford Prefect>
     DEADLINE: <2004-02-29 Sun>
 @end example
-
address@hidden SCHEDULED
address@hidden SCHEDULED keyword
-If a time stamp is preceded by the word @samp{SCHEDULED:}, it means
-you are planning to start working on that task on the given date.  The
-headline will be listed under the given date.  In addition, a reminder
-that the scheduled date has passed will be present in the compilation
-for @emph{today}, until the entry is marked DONE.  I.e., the
-task will automatically be forwarded.
 @end table
 
 @node Creating timestamps,  , Time stamps, Timestamps
@@ -2120,7 +2146,7 @@
 @kindex C-c C-o
 @item C-c C-o
 Access the agenda for the date given by the time stamp at point
-(@pxref{Weekly/Daily Agenda}).
+(@pxref{Weekly/Daily agenda}).
 
 @kindex C-c C-d
 @item C-c C-d
@@ -2207,7 +2233,7 @@
 Choose date in calendar (only if nothing typed into minibuffer).
 @end table
 
address@hidden Tags, Agenda Views, Timestamps, Top
address@hidden Tags, Agenda views, Timestamps, Top
 @chapter Tags
 @cindex tags
 @cindex headline tagging
@@ -2311,7 +2337,7 @@
 @samp{WORK|LAPTOP&NIGHT} requires that the @samp{:LAPTOP:} lines are
 also tagged @samp{NIGHT}.
 
address@hidden Agenda Views, Exporting, Tags, Top
address@hidden Agenda views, Exporting, Tags, Top
 @chapter Agenda Views
 @cindex agenda views
 
@@ -2345,14 +2371,14 @@
 @menu
 * Agenda files::                Files being searched for agenda information
 * Agenda dispatcher::           Keyboard access to agenda views
-* Weekly/Daily Agenda::         The calendar page with current tasks
+* Weekly/Daily agenda::         The calendar page with current tasks
 * Global TODO list::            All unfinished action items
 * Matching headline tags::      Structured information with fine-tuned search
 * Timeline::                    Time-sorted view for single file
 * Agenda commands::             Remote editing of org trees
 @end menu
 
address@hidden Agenda files, Agenda dispatcher, Agenda Views, Agenda Views
address@hidden Agenda files, Agenda dispatcher, Agenda views, Agenda views
 @section Agenda files
 
 The information to be shown is collected from all @emph{agenda files},
@@ -2385,7 +2411,7 @@
 The Org menu contains the current list of files and can be used
 to visit any of them.
 
address@hidden Agenda dispatcher, Weekly/Daily Agenda, Agenda files, Agenda 
Views
address@hidden Agenda dispatcher, Weekly/Daily agenda, Agenda files, Agenda 
views
 @section The agenda dispatcher
 @cindex agenda dispatcher
 @cindex dispatching agenda commands
@@ -2400,7 +2426,7 @@
 following default commands:
 @table @kbd
 @item a
-Create the calendar-like agenda (@pxref{Weekly/Daily Agenda}).
+Create the calendar-like agenda (@pxref{Weekly/Daily agenda}).
 @item t / T
 Create a list of all TODO items (@pxref{Global TODO list}).
 @item m / M
@@ -2438,7 +2464,7 @@
 @samp{FIXME}.  For more information, look at the documentation string
 of the variable @code{org-agenda-custom-commands}.
 
address@hidden Weekly/Daily Agenda, Global TODO list, Agenda dispatcher, Agenda 
Views
address@hidden Weekly/Daily agenda, Global TODO list, Agenda dispatcher, Agenda 
views
 @section The weekly/daily agenda
 @cindex agenda
 
@@ -2468,7 +2494,7 @@
 * Sorting of agenda items::     The order of things
 @end menu
 
address@hidden Categories, Time-of-day specifications, Weekly/Daily Agenda, 
Weekly/Daily Agenda
address@hidden Categories, Time-of-day specifications, Weekly/Daily agenda, 
Weekly/Daily agenda
 @subsection Categories
 
 @cindex category
@@ -2485,7 +2511,7 @@
 before the first CATEGORY line).  The display in the agenda buffer looks
 best if the category is not longer than 10 characters.
 
address@hidden Time-of-day specifications, Calendar/Diary integration, 
Categories, Weekly/Daily Agenda
address@hidden Time-of-day specifications, Calendar/Diary integration, 
Categories, Weekly/Daily agenda
 @subsection Time-of-Day Specifications
 
 Org-mode checks each agenda item for a time-of-day specification.  The
@@ -2533,7 +2559,7 @@
 @code{org-agenda-time-grid}.
 
 
address@hidden Calendar/Diary integration, Sorting of agenda items, Time-of-day 
specifications, Weekly/Daily Agenda
address@hidden Calendar/Diary integration, Sorting of agenda items, Time-of-day 
specifications, Weekly/Daily agenda
 @subsection Calendar/Diary integration
 @cindex calendar integration
 @cindex diary integration
@@ -2564,7 +2590,7 @@
 calendars, respectively.  @kbd{c} can be used to switch back and forth
 between calendar and agenda.
 
address@hidden Sorting of agenda items,  , Calendar/Diary integration, 
Weekly/Daily Agenda
address@hidden Sorting of agenda items,  , Calendar/Diary integration, 
Weekly/Daily agenda
 @subsection Sorting of agenda items
 @cindex sorting, of agenda items
 @cindex priorities, of agenda items
@@ -2583,7 +2609,7 @@
 @code{org-agenda-sorting-strategy}.
 
 
address@hidden Global TODO list, Matching headline tags, Weekly/Daily Agenda, 
Agenda Views
address@hidden Global TODO list, Matching headline tags, Weekly/Daily agenda, 
Agenda views
 @section The global TODO list
 @cindex global TODO list
 @cindex TODO list, global
@@ -2595,7 +2621,7 @@
 @kindex C-c a t
 @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
+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.
@@ -2616,7 +2642,7 @@
 TODO entry with a single key press.  The commands available in the
 TODO list are described in @ref{Agenda commands}.
 
address@hidden Matching headline tags, Timeline, Global TODO list, Agenda Views
address@hidden Matching headline tags, Timeline, Global TODO list, Agenda views
 @section Matching headline tags
 @cindex matching, of tags
 @cindex tags view
@@ -2643,7 +2669,7 @@
 The commands available in the tags list are described in @ref{Agenda
 commands}.
 
address@hidden Timeline, Agenda commands, Matching headline tags, Agenda Views
address@hidden Timeline, Agenda commands, Matching headline tags, Agenda views
 @section Timeline for a single file
 @cindex single file summary
 @cindex agenda, for single file
@@ -2669,7 +2695,7 @@
 The commands available in the timeline buffer are listed in
 @ref{Agenda commands}.
 
address@hidden Agenda commands,  , Timeline, Agenda Views
address@hidden Agenda commands,  , Timeline, Agenda views
 @section Commands in the agenda buffer
 @cindex commands, in agenda buffer
 
@@ -2886,7 +2912,7 @@
 
 @end table
 
address@hidden Exporting, Miscellaneous, Agenda Views, Top
address@hidden Exporting, Miscellaneous, Agenda views, Top
 @chapter Exporting
 @cindex exporting
 
@@ -3003,6 +3029,9 @@
 current buffer and forces Emacs to re-evaluate the local variables
 section in the buffer.
 
address@hidden FIXME: More about header and footer styles
address@hidden FIXME: Talk about links and targets.
+
 @node XML export, iCalendar export, HTML export, Exporting
 @section XML export
 @cindex XML export
@@ -3114,7 +3143,7 @@
 @item
 Plain lists @samp{-}, @samp{*} or @samp{+} as bullet, or with @samp{1.}
 or @samp{2)} as enumerator will be recognized and transformed if the
-backend supports lists.  See @xref{Plain Lists}.
+backend supports lists.  See @xref{Plain lists}.
 
 @cindex underlined text
 @cindex bold text