Release 4.72

org

@@ -5,7 +5,7 @@ START-INFO-DIR-ENTRY
 * Org Mode: (org).      Outline-based notes management and organizer
 END-INFO-DIR-ENTRY
 
-   This manual is for Org-mode (version 4.71).
+   This manual is for Org-mode (version 4.72).
 
    Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation
 
@@ -27,7 +27,7 @@ File: org,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
 Org Mode Manual
 ***************
 
-This manual is for Org-mode (version 4.71).
+This manual is for Org-mode (version 4.72).
 
    Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation
 
@@ -511,7 +511,8 @@ File: org,  Node: Headlines,  Next: Visibility cycling,  Prev: Outlines,  Up: Do
 =============
 
 Headlines define the structure of an outline tree.  The headlines in
-Org-mode start with one or more stars, on the left margin.  For example:
+Org-mode start with one or more stars, on the left margin(1).  For
+example:
 
      * Top level headline
      ** Second level
@@ -519,12 +520,24 @@ Org-mode start with one or more stars, on the left margin.  For example:
          some text
      *** 3rd level
          more text
+
      * Another top level headline
 
 Some people find the many stars too noisy and would prefer an outline
 that has whitespace followed by a single star as headline starters.
 *Note Clean view:: describes a setup to realize this.
 
+   An empty line after the end of a subtree is considered part of it and
+will be hidden when the subtree is folded.  However, if you leave at
+least two empty lines, one empty line will remain visible after folding
+the subtree, in order to structure the collapsed view.  See the
+variable `org-cycle-separator-lines' for modifying this behavior.
+
+   ---------- Footnotes ----------
+
+   (1) See the variable `org-special-ctrl-a' to configure special
+behavior of `C-a' in headlines.
+
 
 File: org,  Node: Visibility cycling,  Next: Motion,  Prev: Headlines,  Up: Document structure
 
@@ -1349,13 +1362,12 @@ File: org,  Node: Formula syntax for Calc,  Next: Formula syntax for Lisp,  Prev
 -----------------------------
 
 A formula can be any algebraic expression understood by the Emacs
-`Calc' package.  Note that `calc' has the slightly non-standard
-convention that `/' has lower precedence than `*', so that `a/b*c' is
-interpreted as `a/(b*c)'.  Before evaluation by `calc-eval' (*note
-calc-eval: (calc)Calling Calc from Your Programs.), variable
-substitution takes place according to the rules described above.  The
-range vectors can be directly fed into the calc vector functions like
-`vmean' and `vsum'.
+`Calc' package.  Note that `calc' has the non-standard convention that
+`/' has lower precedence than `*', so that `a/b*c' is interpreted as
+`a/(b*c)'.  Before evaluation by `calc-eval' (*note calc-eval:
+(calc)Calling Calc from Your Programs.), variable substitution takes
+place according to the rules described above.  The range vectors can be
+directly fed into the calc vector functions like `vmean' and `vsum'.
 
    A formula can contain an optional mode string after a semicolon.
 This string consists of flags to influence Calc and other modes during
@@ -2158,10 +2170,11 @@ use:
 In these entries, the character specifies how to select the template.
 The first string specifies the template.  Two more (optional) strings
 give the file in which, and the headline under which the new note
-should be stored.  The file defaults to `org-default-notes-file', the
-heading to `org-remember-default-headline'.  Both defaults help to get
-to the storing location quickly, but you can change the location
-interactively while storing the note.
+should be stored.  The file defaults (if not present or `nil') to
+`org-default-notes-file', the heading to
+`org-remember-default-headline'.  Both defaults help to get to the
+storing location quickly, but you can change the location interactively
+while storing the note.
 
    When you call `M-x remember' (or `M-x org-remember') to remember
 something, org will prompt for a key to select the template (if you have
@@ -2244,8 +2257,7 @@ buffer-start   <RET>       as level 2 heading at end of file
 on headline    <RET>       as sublevel of the heading at cursor
                <left>/<right>as same level, before/after current heading
 not on         <RET>       at cursor position, level taken from context.
-headline                             Or use prefix arg to specify level
-                           manually.
+headline                   
 
    So a fast way to store the note to its default location is to press
 `C-c C-c <RET> <RET>'.  Even shorter would be `C-u C-c C-c', which does
@@ -3636,15 +3648,17 @@ one entry marked with a todo keyword TODO or NEXT or NEXTACTION.
 projects with a tag PROJECT, and that you use a todo keyword MAYBE to
 indicate a project that should not be considered yet.  Lets further
 assume that the todo keyword DONE marks finished projects, and that NEXT
-and TODO indicate next actions.  Finally, the tag @SHOP indicates
-shopping and is a next action even without the NEXT tag.  In this case
-you would start by identifying eligible projects with a tags/todo match
-`+PROJECT/-MAYBE-DONE', and then check for TODO, NEXT and @SHOP in the
-subtree to identify projects that are not stuck.  The correct
-customization for this is
+and TODO indicate next actions.  The tag @SHOP indicates shopping and
+is a next action even without the NEXT tag.  Finally, if the project
+contains the special word IGNORE anywhere, it should not be listed
+either.  In this case you would start by identifying eligible projects
+with a tags/todo match `+PROJECT/-MAYBE-DONE', and then check for TODO,
+NEXT, @SHOP, and IGNORE in the subtree to identify projects that are
+not stuck.  The correct customization for this is
 
      (setq org-stuck-projects
-           ("+PROJECT/-MAYBE-DONE" ("NEXT" "TODO") ("@SHOP")))
+           '("+PROJECT/-MAYBE-DONE" ("NEXT" "TODO") ("@SHOP")
+                                    "\\<IGNORE\\>"))
 
 
 File: org,  Node: Presentation and sorting,  Next: Agenda commands,  Prev: Built-in agenda views,  Up: Agenda views
@@ -5242,6 +5256,8 @@ file is visited again in a new Emacs session.
           nologging        don't record when items are marked DONE
           lognotedone      record timestamp and a note when DONE
           lognotestate     record timestamp, note when TODO state changes
+          logrepeat        record a not when re-instating a repeating item
+          nologrepeat      do not record when re-instating repeating item
           lognoteclock-out record timestamp and a note when clocking out
      Here are the options for hiding leading stars in outline headings.
      The corresponding variables are `org-hide-leading-stars' and
@@ -5560,7 +5576,6 @@ File: org,  Node: Conflicts,  Prev: Cooperation,  Up: Interaction
 
           S-UP    -> M-p             S-DOWN  -> M-n
           S-LEFT  -> M--             S-RIGHT -> M-+
-          S-RET   -> C-S-RET
 
      Yes, these are unfortunately more difficult to remember.  If you
      want to have other replacement keys, look at the variable
@@ -6255,8 +6270,8 @@ Index
 * completion, of TODO keywords:          Workflow states.     (line  15)
 * constants, in calculations:            References.          (line  82)
 * constants.el:                          Cooperation.         (line  14)
-* constcgs, STARTUP keyword:             In-buffer settings.  (line  52)
-* constSI, STARTUP keyword:              In-buffer settings.  (line  52)
+* constcgs, STARTUP keyword:             In-buffer settings.  (line  54)
+* constSI, STARTUP keyword:              In-buffer settings.  (line  54)
 * content, STARTUP keyword:              In-buffer settings.  (line  22)
 * contents, global visibility state:     Visibility cycling.  (line  22)
 * copying, of subtrees:                  Structure editing.   (line   6)
@@ -6266,7 +6281,7 @@ Index
 * custom date/time format:               Custom time format.  (line   6)
 * custom search strings:                 Custom searches.     (line   6)
 * customization:                         Customization.       (line   6)
-* customtime, STARTUP keyword:           In-buffer settings.  (line  49)
+* customtime, STARTUP keyword:           In-buffer settings.  (line  51)
 * cutting, of subtrees:                  Structure editing.   (line   6)
 * cycling, of TODO states:               TODO basics.         (line  13)
 * cycling, visibility:                   Visibility cycling.  (line   6)
@@ -6299,7 +6314,7 @@ Index
 * emphasized text:                       Export options.      (line  25)
 * enhancing text:                        Enhancing text.      (line   6)
 * evaluate time range:                   Creating timestamps. (line  64)
-* even, STARTUP keyword:                 In-buffer settings.  (line  42)
+* even, STARTUP keyword:                 In-buffer settings.  (line  44)
 * exporting:                             Exporting.           (line   6)
 * exporting, not:                        Comment lines.       (line   6)
 * extended TODO keywords:                TODO extensions.     (line   6)
@@ -6323,7 +6338,7 @@ Index
 * folding, sparse trees:                 Sparse trees.        (line   6)
 * following links:                       Handling links.      (line  56)
 * format specifier:                      Formula syntax for Calc.
-                                                              (line  15)
+                                                              (line  14)
 * format, of links:                      Link format.         (line   6)
 * formula debugging:                     Editing and debugging formulas.
                                                               (line  97)
@@ -6349,7 +6364,7 @@ Index
 * headline, promotion and demotion:      Structure editing.   (line   6)
 * headlines:                             Headlines.           (line   6)
 * hide text:                             Visibility cycling.  (line   6)
-* hidestars, STARTUP keyword:            In-buffer settings.  (line  42)
+* hidestars, STARTUP keyword:            In-buffer settings.  (line  44)
 * hiding leading stars:                  Clean view.          (line   6)
 * history:                               History and Acknowledgments.
                                                               (line   6)
@@ -6408,6 +6423,7 @@ Index
 * lognoteclock-out, STARTUP keyword:     In-buffer settings.  (line  33)
 * lognotedone, STARTUP keyword:          In-buffer settings.  (line  33)
 * lognotestate, STARTUP keyword:         In-buffer settings.  (line  33)
+* logrepeat, STARTUP keyword:            In-buffer settings.  (line  33)
 * maintainer:                            Feedback.            (line   6)
 * mark ring:                             Handling links.      (line  79)
 * marking characters, tables:            Advanced features.   (line  40)
@@ -6418,7 +6434,7 @@ Index
 * MH-E links:                            External links.      (line   6)
 * minor mode for tables:                 orgtbl-mode.         (line   6)
 * mode, for calc:                        Formula syntax for Calc.
-                                                              (line  15)
+                                                              (line  14)
 * motion commands in agenda:             Agenda commands.     (line  19)
 * motion, between headlines:             Motion.              (line   6)
 * name, of column or field:              References.          (line  82)
@@ -6427,8 +6443,9 @@ Index
 * narrow columns in tables:              Narrow columns.      (line   6)
 * noalign, STARTUP keyword:              In-buffer settings.  (line  29)
 * nologging, STARTUP keyword:            In-buffer settings.  (line  33)
+* nologrepeat, STARTUP keyword:          In-buffer settings.  (line  33)
 * occur, command:                        Sparse trees.        (line   6)
-* odd, STARTUP keyword:                  In-buffer settings.  (line  42)
+* odd, STARTUP keyword:                  In-buffer settings.  (line  44)
 * option keyword completion:             Completion.          (line   6)
 * options, for custom agenda views:      Setting Options.     (line   6)
 * options, for customization:            Customization.       (line   6)
@@ -6500,7 +6517,7 @@ Index
 * show all, global visibility state:     Visibility cycling.  (line  22)
 * show hidden text:                      Visibility cycling.  (line   6)
 * showall, STARTUP keyword:              In-buffer settings.  (line  22)
-* showstars, STARTUP keyword:            In-buffer settings.  (line  42)
+* showstars, STARTUP keyword:            In-buffer settings.  (line  44)
 * sorting, of agenda items:              Sorting of agenda items.
                                                               (line   6)
 * sparse tree, for deadlines:            Creating timestamps. (line  39)
@@ -6604,7 +6621,7 @@ Index
 * VM links:                              External links.      (line   6)
 * WANDERLUST links:                      External links.      (line   6)
 * weekly agenda:                         Weekly/Daily agenda. (line   6)
-* windmove.el:                           Conflicts.           (line  33)
+* windmove.el:                           Conflicts.           (line  32)
 * workflow states as TODO keywords:      Workflow states.     (line   6)
 * XEmacs:                                Installation.        (line   6)
 * XOXO export:                           XOXO export.         (line   6)
@@ -6952,178 +6969,179 @@ Node: Feedback17587
 Node: Document structure19663
 Node: Outlines20437
 Node: Headlines21097
-Node: Visibility cycling21720
-Ref: Visibility cycling-Footnote-123934
-Ref: Visibility cycling-Footnote-223992
-Ref: Visibility cycling-Footnote-324042
-Node: Motion24312
-Node: Structure editing25266
-Node: Archiving28092
-Node: ARCHIVE tag28650
-Node: Moving subtrees30443
-Node: Sparse trees31754
-Ref: Sparse trees-Footnote-133886
-Ref: Sparse trees-Footnote-234068
-Node: Plain lists34183
-Ref: Plain lists-Footnote-137952
-Ref: Plain lists-Footnote-238310
-Node: Tables38494
-Node: Built-in table editor39008
-Node: Narrow columns46027
-Ref: Narrow columns-Footnote-147960
-Node: orgtbl-mode48006
-Node: The spreadsheet48810
-Node: References49897
-Ref: References-Footnote-154026
-Node: Formula syntax for Calc54315
-Node: Formula syntax for Lisp56781
-Node: Field formulas58050
-Node: Column formulas59358
-Node: Editing and debugging formulas60957
-Node: Updating the table65110
-Node: Advanced features66145
-Node: Hyperlinks70670
-Node: Link format71443
-Node: Internal links72736
-Ref: Internal links-Footnote-174661
-Node: Radio targets74793
-Node: External links75484
-Node: Handling links77888
-Ref: Handling links-Footnote-182998
-Ref: Handling links-Footnote-283235
-Node: Link abbreviations83309
-Node: Search options84988
-Ref: Search options-Footnote-186768
-Node: Custom searches86849
-Node: Remember87897
-Node: Setting up remember88884
-Node: Remember templates89466
-Ref: Remember templates-Footnote-192732
-Node: Storing notes92830
-Node: TODO items94798
-Node: TODO basics95781
-Node: TODO extensions97480
-Node: Workflow states98299
-Ref: Workflow states-Footnote-199474
-Node: TODO types99567
-Ref: TODO types-Footnote-1101150
-Node: Multiple sets in one file101232
-Node: Per file keywords102843
-Ref: Per file keywords-Footnote-1104132
-Node: Priorities104333
-Node: Breaking down tasks105579
-Ref: Breaking down tasks-Footnote-1106099
-Node: Checkboxes106195
-Node: Timestamps108950
-Node: Time stamps109484
-Ref: Time stamps-Footnote-1112978
-Ref: Time stamps-Footnote-2113094
-Node: Creating timestamps113249
-Node: The date/time prompt115907
-Ref: The date/time prompt-Footnote-1117868
-Node: Custom time format117974
-Node: Repeating items119532
-Node: Progress logging121342
-Node: Closing items121988
-Ref: Closing items-Footnote-1122922
-Ref: Closing items-Footnote-2122991
-Node: Tracking TODO state changes123064
-Node: Clocking work time123920
-Ref: Clocking work time-Footnote-1127566
-Ref: Clocking work time-Footnote-2127644
-Node: Tags127770
-Node: Tag inheritance128532
-Node: Setting tags129469
-Ref: Setting tags-Footnote-1133992
-Ref: Setting tags-Footnote-2134104
-Node: Tag searches134187
-Node: Agenda views136898
-Node: Agenda files138843
-Ref: Agenda files-Footnote-1139809
-Ref: Agenda files-Footnote-2139958
-Node: Agenda dispatcher140151
-Node: Built-in agenda views141842
-Node: Weekly/Daily agenda142420
-Node: Global TODO list144549
-Node: Matching headline tags146821
-Node: Timeline147892
-Node: Stuck projects148558
-Node: Presentation and sorting150257
-Node: Categories151048
-Node: Time-of-day specifications151712
-Node: Sorting of agenda items153683
-Node: Agenda commands154965
-Node: Custom agenda views161694
-Node: Storing searches162369
-Node: Block agenda164281
-Node: Setting Options165511
-Node: Batch processing168223
-Node: Embedded LaTeX169353
-Ref: Embedded LaTeX-Footnote-1170445
-Node: Math symbols170635
-Node: Subscripts and Superscripts171400
-Node: LaTeX fragments172244
-Ref: LaTeX fragments-Footnote-1174478
-Node: Processing LaTeX fragments174740
-Node: CDLaTeX mode175686
-Ref: CDLaTeX mode-Footnote-1178170
-Node: Exporting178318
-Node: ASCII export179632
-Node: HTML export180922
-Node: Export commands181541
-Node: Quoting HTML tags182352
-Node: Links182982
-Node: Images183679
-Ref: Images-Footnote-1184550
-Node: CSS support184611
-Ref: CSS support-Footnote-1185930
-Node: XOXO export186043
-Node: iCalendar export186482
-Node: Text interpretation187701
-Node: Comment lines188243
-Node: Initial text188638
-Node: Enhancing text190312
-Ref: Enhancing text-Footnote-1192174
-Node: Export options192264
-Node: Publishing194157
-Ref: Publishing-Footnote-1194953
-Node: Configuration195149
-Node: Project alist195867
-Node: Sources and destinations196933
-Node: Selecting files197663
-Node: Publishing action198411
-Node: Publishing options199644
-Node: Publishing links201796
-Node: Project page index203309
-Node: Sample configuration204087
-Node: Simple example204579
-Node: Complex example205252
-Node: Triggering publication207328
-Node: Miscellaneous208013
-Node: Completion208647
-Node: Customization210118
-Node: In-buffer settings210701
-Node: The very busy C-c C-c key215178
-Node: Clean view216822
-Node: TTY keys219399
-Node: Interaction221009
-Node: Cooperation221406
-Node: Conflicts224148
-Node: Bugs225740
-Node: Extensions and Hacking227236
-Node: Extensions227832
-Node: Tables in arbitrary syntax229779
-Node: Radio tables230856
-Node: A LaTeX example233359
-Ref: A LaTeX example-Footnote-1237005
-Ref: A LaTeX example-Footnote-2237153
-Node: Translator functions237588
-Ref: Translator functions-Footnote-1240697
-Node: Dynamic blocks240785
-Node: Special agenda views242757
-Ref: Special agenda views-Footnote-1245036
-Node: History and Acknowledgments245296
-Node: Index251156
-Node: Key Index282137
+Ref: Headlines-Footnote-122105
+Node: Visibility cycling22204
+Ref: Visibility cycling-Footnote-124418
+Ref: Visibility cycling-Footnote-224476
+Ref: Visibility cycling-Footnote-324526
+Node: Motion24796
+Node: Structure editing25750
+Node: Archiving28576
+Node: ARCHIVE tag29134
+Node: Moving subtrees30927
+Node: Sparse trees32238
+Ref: Sparse trees-Footnote-134370
+Ref: Sparse trees-Footnote-234552
+Node: Plain lists34667
+Ref: Plain lists-Footnote-138436
+Ref: Plain lists-Footnote-238794
+Node: Tables38978
+Node: Built-in table editor39492
+Node: Narrow columns46511
+Ref: Narrow columns-Footnote-148444
+Node: orgtbl-mode48490
+Node: The spreadsheet49294
+Node: References50381
+Ref: References-Footnote-154510
+Node: Formula syntax for Calc54799
+Node: Formula syntax for Lisp57256
+Node: Field formulas58525
+Node: Column formulas59833
+Node: Editing and debugging formulas61432
+Node: Updating the table65585
+Node: Advanced features66620
+Node: Hyperlinks71145
+Node: Link format71918
+Node: Internal links73211
+Ref: Internal links-Footnote-175136
+Node: Radio targets75268
+Node: External links75959
+Node: Handling links78363
+Ref: Handling links-Footnote-183473
+Ref: Handling links-Footnote-283710
+Node: Link abbreviations83784
+Node: Search options85463
+Ref: Search options-Footnote-187243
+Node: Custom searches87324
+Node: Remember88372
+Node: Setting up remember89359
+Node: Remember templates89941
+Ref: Remember templates-Footnote-193233
+Node: Storing notes93331
+Node: TODO items95218
+Node: TODO basics96201
+Node: TODO extensions97900
+Node: Workflow states98719
+Ref: Workflow states-Footnote-199894
+Node: TODO types99987
+Ref: TODO types-Footnote-1101570
+Node: Multiple sets in one file101652
+Node: Per file keywords103263
+Ref: Per file keywords-Footnote-1104552
+Node: Priorities104753
+Node: Breaking down tasks105999
+Ref: Breaking down tasks-Footnote-1106519
+Node: Checkboxes106615
+Node: Timestamps109370
+Node: Time stamps109904
+Ref: Time stamps-Footnote-1113398
+Ref: Time stamps-Footnote-2113514
+Node: Creating timestamps113669
+Node: The date/time prompt116327
+Ref: The date/time prompt-Footnote-1118288
+Node: Custom time format118394
+Node: Repeating items119952
+Node: Progress logging121762
+Node: Closing items122408
+Ref: Closing items-Footnote-1123342
+Ref: Closing items-Footnote-2123411
+Node: Tracking TODO state changes123484
+Node: Clocking work time124340
+Ref: Clocking work time-Footnote-1127986
+Ref: Clocking work time-Footnote-2128064
+Node: Tags128190
+Node: Tag inheritance128952
+Node: Setting tags129889
+Ref: Setting tags-Footnote-1134412
+Ref: Setting tags-Footnote-2134524
+Node: Tag searches134607
+Node: Agenda views137318
+Node: Agenda files139263
+Ref: Agenda files-Footnote-1140229
+Ref: Agenda files-Footnote-2140378
+Node: Agenda dispatcher140571
+Node: Built-in agenda views142262
+Node: Weekly/Daily agenda142840
+Node: Global TODO list144969
+Node: Matching headline tags147241
+Node: Timeline148312
+Node: Stuck projects148978
+Node: Presentation and sorting150829
+Node: Categories151620
+Node: Time-of-day specifications152284
+Node: Sorting of agenda items154255
+Node: Agenda commands155537
+Node: Custom agenda views162266
+Node: Storing searches162941
+Node: Block agenda164853
+Node: Setting Options166083
+Node: Batch processing168795
+Node: Embedded LaTeX169925
+Ref: Embedded LaTeX-Footnote-1171017
+Node: Math symbols171207
+Node: Subscripts and Superscripts171972
+Node: LaTeX fragments172816
+Ref: LaTeX fragments-Footnote-1175050
+Node: Processing LaTeX fragments175312
+Node: CDLaTeX mode176258
+Ref: CDLaTeX mode-Footnote-1178742
+Node: Exporting178890
+Node: ASCII export180204
+Node: HTML export181494
+Node: Export commands182113
+Node: Quoting HTML tags182924
+Node: Links183554
+Node: Images184251
+Ref: Images-Footnote-1185122
+Node: CSS support185183
+Ref: CSS support-Footnote-1186502
+Node: XOXO export186615
+Node: iCalendar export187054
+Node: Text interpretation188273
+Node: Comment lines188815
+Node: Initial text189210
+Node: Enhancing text190884
+Ref: Enhancing text-Footnote-1192746
+Node: Export options192836
+Node: Publishing194729
+Ref: Publishing-Footnote-1195525
+Node: Configuration195721
+Node: Project alist196439
+Node: Sources and destinations197505
+Node: Selecting files198235
+Node: Publishing action198983
+Node: Publishing options200216
+Node: Publishing links202368
+Node: Project page index203881
+Node: Sample configuration204659
+Node: Simple example205151
+Node: Complex example205824
+Node: Triggering publication207900
+Node: Miscellaneous208585
+Node: Completion209219
+Node: Customization210690
+Node: In-buffer settings211273
+Node: The very busy C-c C-c key215899
+Node: Clean view217543
+Node: TTY keys220120
+Node: Interaction221730
+Node: Cooperation222127
+Node: Conflicts224869
+Node: Bugs226432
+Node: Extensions and Hacking227928
+Node: Extensions228524
+Node: Tables in arbitrary syntax230471
+Node: Radio tables231548
+Node: A LaTeX example234051
+Ref: A LaTeX example-Footnote-1237697
+Ref: A LaTeX example-Footnote-2237845
+Node: Translator functions238280
+Ref: Translator functions-Footnote-1241389
+Node: Dynamic blocks241477
+Node: Special agenda views243449
+Ref: Special agenda views-Footnote-1245728
+Node: History and Acknowledgments245988
+Node: Index251848
+Node: Key Index282975
 
 End Tag Table

org.texi

@@ -3,7 +3,7 @@
 @setfilename ../info/org
 @settitle Org Mode Manual
 
-@set VERSION 4.71
+@set VERSION 4.72
 @set DATE April 2007
 
 @dircategory Emacs
@@ -579,8 +579,9 @@ key.
 @cindex outline tree
 
 Headlines define the structure of an outline tree.  The headlines in
-Org-mode start with one or more stars, on the left margin.  For
-example:
+Org-mode start with one or more stars, on the left margin@footnote{See
+the variable @code{org-special-ctrl-a} to configure special behavior of
+@kbd{C-a} in headlines.}.  For example:
 
 @example
 * Top level headline
@@ -589,6 +590,7 @@ example:
     some text
 *** 3rd level
     more text
+
 * Another top level headline
 @end example
 
@@ -596,6 +598,12 @@ example:
 outline that has whitespace followed by a single star as headline
 starters.  @ref{Clean view} describes a setup to realize this.
 
+An empty line after the end of a subtree is considered part of it and
+will be hidden when the subtree is folded.  However, if you leave at
+least two empty lines, one empty line will remain visible after folding
+the subtree, in order to structure the collapsed view.  See the
+variable @code{org-cycle-separator-lines} for modifying this behavior.
+
 @node Visibility cycling, Motion, Headlines, Document structure
 @section Visibility cycling
 @cindex cycling, visibility
@@ -1519,9 +1527,9 @@ numbers.
 @cindex syntax, of formulas
 
 A formula can be any algebraic expression understood by the Emacs
-@file{Calc} package.  Note that @file{calc} has the slightly
+@file{Calc} package.  @b{Note that @file{calc} has the
 non-standard convention that @samp{/} has lower precedence than
-@samp{*}, so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}.  Before
+@samp{*}, so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}.}  Before
 evaluation by @code{calc-eval} (@pxref{Calling Calc from
 Your Programs,calc-eval,Calling calc from Your Lisp Programs,calc,GNU
 Emacs Calc Manual}),
@@ -2409,8 +2417,8 @@ use:
 @noindent In these entries, the character specifies how to select the
 template.  The first string specifies the template.  Two more (optional)
 strings give the file in which, and the headline under which the new
-note should be stored.  The file defaults to
-@code{org-default-notes-file}, the heading to
+note should be stored.  The file defaults (if not present or @code{nil})
+to @code{org-default-notes-file}, the heading to
 @code{org-remember-default-headline}.  Both defaults help to get to the
 storing location quickly, but you can change the location interactively
 while storing the note.
@@ -2507,7 +2515,6 @@ then leads to the following result.
 @item             @tab @key{left}/@key{right} @tab as same level, before/after current heading
 @item not on headline @tab @key{RET}
       @tab at cursor position, level taken from context.
-           Or use prefix arg to specify level manually.
 @end multitable
 
 So a fast way to store the note to its default location is to press
@@ -4000,16 +4007,18 @@ Lets assume that you, in your own way of using Org-mode, identify
 projects with a tag PROJECT, and that you use a todo keyword MAYBE to
 indicate a project that should not be considered yet.  Lets further
 assume that the todo keyword DONE marks finished projects, and that NEXT
-and TODO indicate next actions.  Finally, the tag @@SHOP indicates
-shopping and is a next action even without the NEXT tag.  In this case
-you would start by identifying eligible projects with a tags/todo match
-@samp{+PROJECT/-MAYBE-DONE}, and then check for TODO, NEXT and @@SHOP in
-the subtree to identify projects that are not stuck.  The correct
-customization for this is
+and TODO indicate next actions.  The tag @@SHOP indicates shopping and
+is a next action even without the NEXT tag.  Finally, if the project
+contains the special word IGNORE anywhere, it should not be listed
+either.  In this case you would start by identifying eligible projects
+with a tags/todo match @samp{+PROJECT/-MAYBE-DONE}, and then check for
+TODO, NEXT, @@SHOP, and IGNORE in the subtree to identify projects that
+are not stuck.  The correct customization for this is
 
 @lisp
 (setq org-stuck-projects
-      ("+PROJECT/-MAYBE-DONE" ("NEXT" "TODO") ("@@SHOP")))
+      '("+PROJECT/-MAYBE-DONE" ("NEXT" "TODO") ("@@SHOP")
+                               "\\<IGNORE\\>"))
 @end lisp
 
 
@@ -5760,11 +5769,15 @@ Logging TODO state changes and clock intervals (variable
 @cindex @code{lognotedone}, STARTUP keyword
 @cindex @code{lognoteclock-out}, STARTUP keyword
 @cindex @code{lognotestate}, STARTUP keyword
+@cindex @code{logrepeat}, STARTUP keyword
+@cindex @code{nologrepeat}, STARTUP keyword
 @example
 logging          @r{record a timestamp when an item is marked DONE}
 nologging        @r{don't record when items are marked DONE}
 lognotedone      @r{record timestamp and a note when DONE}
 lognotestate     @r{record timestamp, note when TODO state changes}
+logrepeat        @r{record a not when re-instating a repeating item}
+nologrepeat      @r{do not record when re-instating repeating item}
 lognoteclock-out @r{record timestamp and a note when clocking out}
 @end example
 Here are the options for hiding leading stars in outline headings.  The
@@ -6113,7 +6126,6 @@ during date selection).
 @example
 S-UP    -> M-p             S-DOWN  -> M-n
 S-LEFT  -> M--             S-RIGHT -> M-+
-S-RET   -> C-S-RET
 @end example
 
 Yes, these are unfortunately more difficult to remember.  If you want
@@ -6125,7 +6137,6 @@ Also this package uses the @kbd{S-<cursor>} keys, so everything written
 in the paragraph above about CUA mode also applies here.
 @end table
 
-
 @node Bugs,  , Interaction, Miscellaneous
 @section Bugs
 @cindex bugs

orgcard.tex

@@ -1,5 +1,5 @@
 % Reference Card for Org Mode
-\def\orgversionnumber{4.71}
+\def\orgversionnumber{4.72}
 \def\versionyear{2007}          % latest update
 \def\year{2007}                 % latest copyright year
 %
@@ -386,7 +386,6 @@ Outside of tables, the same keys may have other functionality.
 \metax{export as tab-separated file}{M-x org-table-export}
 \metax{import tab-separated file}{M-x org-table-import}
 \key{sum numbers in current column/rectangle}{C-c +}
-\key{copy down with increment}{S-RET$^3$}
 
 {\bf Tables created with the \kbd{table.el} package}
 
@@ -731,21 +730,6 @@ Subtrees whose header starts with COMMENT are never exported.
 
 \key{toggle COMMENT keyword on entry}{C-c ;}
 
-
-%\section{CUA and pc-select compatibility}%
-
-%Configure the variable {\tt org-CUA-compatibility} to make Org-mode
-%avoid the \kbd{S-<cursor>} bindings used by these modes.  When set,
-%Org-mode will change the following keybindings (also in the agenda
-%buffer, but not during date selection). See note mark four$^3$
-%throughout the reference card.
-%%\vskip-mm
-%\beginexample
-%S-UP    $\to$ M-p             S-DOWN  $\to$ M-n
-%S-LEFT  $\to$ M--             S-RIGHT $\to$ M-+
-%S-RET   $\to$ C-S-RET
-%\endexample
-
 \section{Dynamic Blocks}
 
 \key{update dynamic block at point}{C-c C-x C-u}