Release 4.54

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.53).
+   This manual is for Org-mode (version 4.54).
 
    Copyright (C) 2004, 2005, 2006 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.53).
+This manual is for Org-mode (version 4.54).
 
    Copyright (C) 2004, 2005, 2006 Free Software Foundation
 
@@ -398,14 +398,14 @@ File: org,  Node: Feedback,  Prev: Activation,  Up: Introduction
 
 If you find problems with Org-mode, or if you have questions, remarks,
 or ideas about it, please contact the maintainer Carsten Dominik at
-<dominik@science.uva.nl>.
+<dominik at science dot uva dot nl>.
 
    For bug reports, please provide as much information as possible,
 including the version information of Emacs (`C-h v emacs-version
 <RET>') and Org-mode (`C-h v org-version <RET>'), as well as the
-Org-mode related setup in `.emacs'.  If an error occurs, a traceback
-can be very useful.  Often a small example file helps, along with clear
-information about:
+Org-mode related setup in `.emacs'.  If an error occurs, a backtrace
+can be very useful (see below on how to create one).  Often a small
+example file helps, along with clear information about:
 
   1. What exactly did you do?
 
@@ -414,6 +414,33 @@ information about:
   3. What happened instead?
         Thank you for helping to improve this mode.
 
+How to create a useful backtrace
+................................
+
+If working with Org-mode produces an error with a message you don't
+understand, you may have hit a bug.  The best way to report this is by
+providing, in addition to what was mentioned above, a _Backtrace_.
+This is information from the built-in debugger about where and how the
+error occurred.  Here is how to produce a useful backtrace:
+
+  1. Start a fresh Emacs or XEmacs, and make sure that it will load the
+     original Lisp code in `org.el' instead of the compiled version in
+     `org.elc'.  The backtrace contains much more information if it is
+     produced with uncompiled code.  To do this, either rename `org.elc'
+     to something else before starting Emacs, or ask Emacs explicitly
+     to load `org.el' by using the command line
+          emacs -l /path/to/org.el
+
+  2. Go to the `Options' menu and select `Enter Debugger on Error'
+     (XEmacs has this option in the `Troubleshooting' sub-menu).
+
+  3. Do whatever you have to do to hit the error.  Don't forget to to
+     document the steps you take.
+
+  4. When you hit the error, a `*Backtrace*' buffer will appear on the
+     screen.  Safe this buffer to a file (for example using `C-x C-w'
+     and attach) it to your bug report.
+
 
 File: org,  Node: Document structure,  Next: Tables,  Prev: Introduction,  Up: Top
 
@@ -502,7 +529,13 @@ the visibility in the buffer.
      Note that inside tables, `S-<TAB>' jumps to the previous field.
 
 `C-c C-a'
-     Show all.
+     Show all.  
+
+`C-c C-r'
+     Reveal context around point, showing the current entry, the
+     following heading and the hierarchy above.  Useful for working
+     near a location exposed by a sparse tree command (*note Sparse
+     trees::) or an agenda command (*note Agenda commands::).
 
    When Emacs first visits an Org-mode file, the global state is set to
 OVERVIEW, i.e. only the top level headlines are visible.  This can be
@@ -2736,19 +2769,37 @@ following keys:
 `C-g'
      Abort without installing changes.
 
+`q'
+     If `q' is not assigned to a tag, it aborts like `C-g'.
+
+`!'
+     Turn of groups of mutually exclusive tags.  Use this to (as an
+     exception) assign several tags from such a group.
+
+`C-c'
+     Toggle auto-exit after the next change (see below).
+
 This method lets you assign tags to a headline with very few keys.  With
 the above setup, you could clear the current tags and set `@HOME',
 `Laptop' and `PC' tags with just the following keys: `C-c C-c <SPC> h l
 p <RET>'.  Switching from `@HOME' to `@WORK' would be done with `C-c
-C-c w <RET>'.  Adding the non-predefined tag `Sarah' could be done with
-`C-c C-c <TAB> S a r a h <RET> <RET>'.
+C-c w <RET>' or alternatively with `C-c C-c C-c w'.  Adding the
+non-predefined tag `Sarah' could be done with `C-c C-c <TAB> S a r a h
+<RET> <RET>'.
+
+   If you find that most of the time, you need only a single keypress to
+modify your list of tags, set the variable
+`org-fast-tag-selection-single-key'.  Then you no longer have to press
+<RET> to exit fast tag selection - it will immediately exit after the
+first change.  If you then occasionally need more keys, press `C-c' to
+turn off auto-exit for the current tag selection process.
 
    ---------- Footnotes ----------
 
    (1) In `org-mode-alist' use `'(:startgroup)' and `'(:endgroup)',
 respectively.  Several groups are allowed.
 
-   (2) Keys will automatically assigned to tags which have no
+   (2) Keys will automatically be assigned to tags which have no
 configured keys.
 
 
@@ -4906,14 +4957,6 @@ A.1 Third-party extensions for Org-mode
 
 The following extensions for Org-mode have been written by other people:
 
-`org-mouse.el' by Piotr Zielinski
-     This package implements extended mouse functionality for Org-mode.
-     It allows you to cycle visibility and to edit the document
-     structure with the mouse.  Best of all, it provides a
-     context-sensitive menu on <mouse-3> that changes depending on the
-     context of a mouse-click.  `org-mouse.el' is freely available at
-     `http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el'.  
-
 `org-publish.el' by David O'Toole
      This package provides facilities for publishing related sets of
      Org-mode files together with linked files like images as a
@@ -4925,6 +4968,18 @@ The following extensions for Org-mode have been written by other people:
      downloaded from David's site:
      `http://dto.freeshell.org/e/org-publish.el'.  
 
+`org-mouse.el' by Piotr Zielinski
+     This package implements extended mouse functionality for Org-mode.
+     It allows you to cycle visibility and to edit the document
+     structure with the mouse.  Best of all, it provides a
+     context-sensitive menu on <mouse-3> that changes depending on the
+     context of a mouse-click.  As of Org-mode version 4.53,
+     `org-mouse.el' is part of the Org-mode distribution.  It is not
+     yet part of Emacs, however, a delay caused by the preparations for
+     the 22.1 release.  In the mean time, `org-mouse.el' can be
+     downloaded from Piotr's site:
+     `http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el'.  
+
 `org-blog.el' by David O'Toole
      A blogging plug-in for `org-publish.el'.
      `http://dto.freeshell.org/notebook/OrgMode.html'.  
@@ -5152,6 +5207,7 @@ Index
 * ASCII export:                          ASCII export.        (line   6)
 * author:                                Feedback.            (line   6)
 * autoload:                              Activation.          (line   6)
+* backtrace of an error:                 Feedback.            (line  27)
 * BBDB links:                            External links.      (line   6)
 * block agenda:                          Block agenda.        (line   6)
 * bold text:                             Enhancing text.      (line  15)
@@ -5349,12 +5405,12 @@ Index
 * options, for publishing:               Publishing options.  (line   6)
 * ordered lists:                         Plain lists.         (line   6)
 * org-agenda, command:                   Weekly/Daily agenda. (line   9)
-* org-blog.el:                           Extensions.          (line  25)
-* org-blogging.el:                       Extensions.          (line  29)
+* org-blog.el:                           Extensions.          (line  29)
+* org-blogging.el:                       Extensions.          (line  33)
 * org-mode, turning on:                  Activation.          (line  22)
-* org-mouse.el:                          Extensions.          (line   8)
+* org-mouse.el:                          Extensions.          (line  17)
 * org-publish-project-alist:             Project alist.       (line   6)
-* org-publish.el:                        Extensions.          (line  14)
+* org-publish.el:                        Extensions.          (line   8)
 * orgtbl-mode:                           orgtbl-mode.         (line   6)
 * outline tree:                          Headlines.           (line   6)
 * outline-mode:                          Outlines.            (line   6)
@@ -5634,6 +5690,7 @@ Key Index
                                                               (line  20)
 * C-c C-q:                               Built-in table editor.
                                                               (line 119)
+* C-c C-r:                               Visibility cycling.  (line  32)
 * C-c C-s <1>:                           Agenda commands.     (line 136)
 * C-c C-s:                               Creating timestamps. (line  48)
 * C-c C-t <1>:                           Clocking work time.  (line  26)
@@ -5787,150 +5844,150 @@ Node: Summary10777
 Node: Installation13689
 Node: Activation15067
 Node: Feedback16316
-Node: Document structure17085
-Node: Outlines17859
-Node: Headlines18519
-Node: Visibility cycling19142
-Ref: Visibility cycling-Footnote-120617
-Ref: Visibility cycling-Footnote-220675
-Node: Motion20725
-Node: Structure editing21509
-Node: Archiving23825
-Node: ARCHIVE tag24383
-Node: Moving subtrees26176
-Node: Sparse trees27217
-Ref: Sparse trees-Footnote-129348
-Ref: Sparse trees-Footnote-229440
-Node: Plain lists29555
-Ref: Plain lists-Footnote-133080
-Ref: Plain lists-Footnote-233437
-Node: Tables33619
-Node: Built-in table editor34167
-Node: Narrow columns41775
-Ref: Narrow columns-Footnote-143714
-Node: Table calculations43760
-Node: Formula syntax45080
-Ref: Formula syntax-Footnote-147985
-Node: Lisp formulas48285
-Node: Column formulas49074
-Node: Advanced features50836
-Node: Named-field formulas54090
-Node: Editing/debugging formulas54730
-Node: Appetizer56488
-Node: orgtbl-mode57591
-Node: table.el58082
-Node: Hyperlinks59059
-Node: Link format59832
-Node: Internal links61125
-Ref: Internal links-Footnote-163114
-Node: Radio targets63246
-Node: CamelCase links63961
-Node: External links64555
-Node: Handling links66686
-Ref: Handling links-Footnote-171338
-Ref: Handling links-Footnote-271575
-Node: Link abbreviations71649
-Node: Search options73328
-Ref: Search options-Footnote-175106
-Node: Custom searches75187
-Node: Remember76235
-Node: TODO items79925
-Node: TODO basics80907
-Node: TODO extensions82434
-Node: Workflow states83229
-Node: TODO types84097
-Ref: TODO types-Footnote-185755
-Node: Per file keywords85837
-Ref: Per file keywords-Footnote-187291
-Node: Priorities87492
-Node: Breaking down tasks88736
-Ref: Breaking down tasks-Footnote-189256
-Node: Checkboxes89352
-Node: Timestamps92088
-Node: Time stamps92549
-Ref: Time stamps-Footnote-196038
-Node: Creating timestamps96154
-Node: The date/time prompt98779
-Ref: The date/time prompt-Footnote-1100472
-Node: Custom time format100578
-Node: Progress logging102137
-Node: Closing items102666
-Node: Clocking work time103570
-Ref: Clocking work time-Footnote-1107196
-Node: Tags107322
-Node: Tag inheritance108084
-Node: Setting tags109021
-Ref: Setting tags-Footnote-1112537
-Ref: Setting tags-Footnote-2112649
-Node: Tag searches112729
-Node: Agenda views114729
-Node: Agenda files116822
-Ref: Agenda files-Footnote-1117782
-Ref: Agenda files-Footnote-2117931
-Node: Agenda dispatcher118124
-Node: Weekly/Daily agenda119741
-Node: Calendar/Diary integration120706
-Node: Global TODO list122044
-Node: Matching headline tags124204
-Node: Timeline125262
-Node: Presentation and sorting125925
-Node: Categories126703
-Node: Time-of-day specifications127367
-Node: Sorting of agenda items129345
-Node: Agenda commands130627
-Node: Custom agenda views136515
-Node: Storing searches137190
-Node: Block agenda139102
-Node: Setting Options140332
-Node: Batch processing143044
-Node: Embedded LaTeX144174
-Ref: Embedded LaTeX-Footnote-1145266
-Node: Math symbols145456
-Node: Subscripts and Superscripts146221
-Node: LaTeX fragments147065
-Ref: LaTeX fragments-Footnote-1149173
-Node: Processing LaTeX fragments149435
-Node: CDLaTeX mode150381
-Ref: CDLaTeX mode-Footnote-1152865
-Node: Exporting153013
-Node: ASCII export154327
-Node: HTML export155617
-Node: XOXO export158453
-Node: iCalendar export158892
-Node: Text interpretation160715
-Node: Comment lines161194
-Node: Enhancing text161665
-Node: Export options163357
-Node: Publishing165024
-Ref: Publishing-Footnote-1165820
-Node: Configuration166016
-Node: Project alist166734
-Node: Sources and destinations167800
-Node: Selecting files168530
-Node: Publishing action169278
-Node: Publishing options170511
-Node: Publishing links172663
-Node: Project page index174176
-Node: Sample configuration174954
-Node: Simple example175446
-Node: Complex example176119
-Node: Triggering publication178195
-Node: Miscellaneous178880
-Node: Completion179514
-Node: Customization180985
-Node: In-buffer settings181570
-Node: The very busy C-c C-c key185190
-Node: Clean view186834
-Node: TTY keys189411
-Node: Interaction191020
-Node: Cooperation191417
-Node: Conflicts193284
-Node: Bugs194876
-Node: Extensions and Hacking196499
-Node: Extensions196985
-Node: Dynamic blocks198555
-Node: History and Acknowledgments200482
-Node: Index205490
-Node: Key Index232505
+Node: Document structure18395
+Node: Outlines19169
+Node: Headlines19829
+Node: Visibility cycling20452
+Ref: Visibility cycling-Footnote-122203
+Ref: Visibility cycling-Footnote-222261
+Node: Motion22311
+Node: Structure editing23095
+Node: Archiving25411
+Node: ARCHIVE tag25969
+Node: Moving subtrees27762
+Node: Sparse trees28803
+Ref: Sparse trees-Footnote-130934
+Ref: Sparse trees-Footnote-231026
+Node: Plain lists31141
+Ref: Plain lists-Footnote-134666
+Ref: Plain lists-Footnote-235023
+Node: Tables35205
+Node: Built-in table editor35753
+Node: Narrow columns43361
+Ref: Narrow columns-Footnote-145300
+Node: Table calculations45346
+Node: Formula syntax46666
+Ref: Formula syntax-Footnote-149571
+Node: Lisp formulas49871
+Node: Column formulas50660
+Node: Advanced features52422
+Node: Named-field formulas55676
+Node: Editing/debugging formulas56316
+Node: Appetizer58074
+Node: orgtbl-mode59177
+Node: table.el59668
+Node: Hyperlinks60645
+Node: Link format61418
+Node: Internal links62711
+Ref: Internal links-Footnote-164700
+Node: Radio targets64832
+Node: CamelCase links65547
+Node: External links66141
+Node: Handling links68272
+Ref: Handling links-Footnote-172924
+Ref: Handling links-Footnote-273161
+Node: Link abbreviations73235
+Node: Search options74914
+Ref: Search options-Footnote-176692
+Node: Custom searches76773
+Node: Remember77821
+Node: TODO items81511
+Node: TODO basics82493
+Node: TODO extensions84020
+Node: Workflow states84815
+Node: TODO types85683
+Ref: TODO types-Footnote-187341
+Node: Per file keywords87423
+Ref: Per file keywords-Footnote-188877
+Node: Priorities89078
+Node: Breaking down tasks90322
+Ref: Breaking down tasks-Footnote-190842
+Node: Checkboxes90938
+Node: Timestamps93674
+Node: Time stamps94135
+Ref: Time stamps-Footnote-197624
+Node: Creating timestamps97740
+Node: The date/time prompt100365
+Ref: The date/time prompt-Footnote-1102058
+Node: Custom time format102164
+Node: Progress logging103723
+Node: Closing items104252
+Node: Clocking work time105156
+Ref: Clocking work time-Footnote-1108782
+Node: Tags108908
+Node: Tag inheritance109670
+Node: Setting tags110607
+Ref: Setting tags-Footnote-1114805
+Ref: Setting tags-Footnote-2114917
+Node: Tag searches115000
+Node: Agenda views117000
+Node: Agenda files119093
+Ref: Agenda files-Footnote-1120053
+Ref: Agenda files-Footnote-2120202
+Node: Agenda dispatcher120395
+Node: Weekly/Daily agenda122012
+Node: Calendar/Diary integration122977
+Node: Global TODO list124315
+Node: Matching headline tags126475
+Node: Timeline127533
+Node: Presentation and sorting128196
+Node: Categories128974
+Node: Time-of-day specifications129638
+Node: Sorting of agenda items131616
+Node: Agenda commands132898
+Node: Custom agenda views138786
+Node: Storing searches139461
+Node: Block agenda141373
+Node: Setting Options142603
+Node: Batch processing145315
+Node: Embedded LaTeX146445
+Ref: Embedded LaTeX-Footnote-1147537
+Node: Math symbols147727
+Node: Subscripts and Superscripts148492
+Node: LaTeX fragments149336
+Ref: LaTeX fragments-Footnote-1151444
+Node: Processing LaTeX fragments151706
+Node: CDLaTeX mode152652
+Ref: CDLaTeX mode-Footnote-1155136
+Node: Exporting155284
+Node: ASCII export156598
+Node: HTML export157888
+Node: XOXO export160724
+Node: iCalendar export161163
+Node: Text interpretation162986
+Node: Comment lines163465
+Node: Enhancing text163936
+Node: Export options165628
+Node: Publishing167295
+Ref: Publishing-Footnote-1168091
+Node: Configuration168287
+Node: Project alist169005
+Node: Sources and destinations170071
+Node: Selecting files170801
+Node: Publishing action171549
+Node: Publishing options172782
+Node: Publishing links174934
+Node: Project page index176447
+Node: Sample configuration177225
+Node: Simple example177717
+Node: Complex example178390
+Node: Triggering publication180466
+Node: Miscellaneous181151
+Node: Completion181785
+Node: Customization183256
+Node: In-buffer settings183841
+Node: The very busy C-c C-c key187461
+Node: Clean view189105
+Node: TTY keys191682
+Node: Interaction193291
+Node: Cooperation193688
+Node: Conflicts195555
+Node: Bugs197147
+Node: Extensions and Hacking198770
+Node: Extensions199256
+Node: Dynamic blocks201057
+Node: History and Acknowledgments202984
+Node: Index207992
+Node: Key Index235080
 
 End Tag Table

org-mouse.el

@@ -164,7 +164,6 @@
     (skip-chars-backward ":A-Za-z")
     (skip-chars-backward "\t ")))
 
-
 (defun org-mouse-show-context-menu (event prefix)
   (interactive "@e \nP")
   (if (and (= (event-click-count event) 1)

org.texi

@@ -3,7 +3,7 @@
 @setfilename ../info/org
 @settitle Org Mode Manual
 
-@set VERSION 4.53
+@set VERSION 4.54
 @set DATE November 2006
 
 @dircategory Emacs
@@ -15,8 +15,8 @@
 @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}
+@set MAINTAINEREMAIL @email{dominik at science dot uva dot nl}
+@set MAINTAINERCONTACT @uref{mailto:dominik at science dot uva dot nl,contact the maintainer}
 @c %**end of header
 @finalout
 
@@ -461,8 +461,8 @@ 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
 the Org-mode related setup in @file{.emacs}.  If an error occurs, a
-traceback can be very useful.  Often a small example file helps, along
-with clear information about:
+backtrace can be very useful (see below on how to create one).  Often a
+small example file helps, along with clear information about:
 
 @enumerate
 @item What exactly did you do?
@@ -471,6 +471,38 @@ with clear information about:
 @end enumerate
 @noindent Thank you for helping to improve this mode.
 
+@subsubheading How to create a useful backtrace
+
+@cindex backtrace of an error
+If working with Org-mode produces an error with a message you don't
+understand, you may have hit a bug.  The best way to report this is by
+providing, in addition to what was mentioned above, a @emph{Backtrace}.
+This is information from the built-in debugger about where and how the
+error occurred.  Here is how to produce a useful backtrace:
+
+@enumerate
+@item
+Start a fresh Emacs or XEmacs, and make sure that it will load the
+original Lisp code in @file{org.el} instead of the compiled version in
+@file{org.elc}.  The backtrace contains much more information if it is
+produced with uncompiled code.  To do this, either rename @file{org.elc}
+to something else before starting Emacs, or ask Emacs explicitly to load
+@file{org.el} by using the command line
+@example
+emacs -l /path/to/org.el
+@end example
+@item
+Go to the @code{Options} menu and select @code{Enter Debugger on Error}
+(XEmacs has this option in the @code{Troubleshooting} sub-menu).
+@item
+Do whatever you have to do to hit the error.  Don't forget to to
+document the steps you take.
+@item
+When you hit the error, a @file{*Backtrace*} buffer will appear on the
+screen.  Safe this buffer to a file (for example using @kbd{C-x C-w} and
+attach) it to your bug report.
+@end enumerate
+
 @node Document structure, Tables, Introduction, Top
 @chapter Document Structure
 @cindex document structure
@@ -583,6 +615,12 @@ Note that inside tables, @kbd{S-@key{TAB}} jumps to the previous field.
 @kindex C-c C-a
 @item C-c C-a
 Show all.
+@kindex C-c C-r
+@item C-c C-r
+Reveal context around point, showing the current entry, the following
+heading and the hierarchy above.  Useful for working near a location
+exposed by a sparse tree command (@pxref{Sparse trees}) or an agenda
+command (@pxref{Agenda commands}).
 @end table
 
 When Emacs first visits an Org-mode file, the global state is set to
@@ -3007,7 +3045,7 @@ these lines to activate any changes.
 If at least one tag has a selection key, pressing @kbd{C-c C-c} will
 automatically present you with a special interface, listing inherited
 tags, the tags of the current headline, and a list of all legal tags
-with corresponding keys@footnote{Keys will automatically assigned to
+with corresponding keys@footnote{Keys will automatically be assigned to
 tags which have no configured keys.}.  In this interface, you can use
 the following keys:
 
@@ -3028,6 +3066,13 @@ Clear all tags for this line.
 Accept the modified set.
 @item C-g
 Abort without installing changes.
+@item q
+If @kbd{q} is not assigned to a tag, it aborts like @kbd{C-g}.
+@item !
+Turn of groups of mutually exclusive tags.  Use this to (as an
+exception) assign several tags from such a group.
+@item C-c
+Toggle auto-exit after the next change (see below).
 @end table
 
 @noindent
@@ -3035,10 +3080,17 @@ This method lets you assign tags to a headline with very few keys.  With
 the above setup, you could clear the current tags and set @samp{@@HOME},
 @samp{Laptop} and @samp{PC} tags with just the following keys: @kbd{C-c
 C-c @key{SPC} h l p @key{RET}}.  Switching from @samp{@@HOME} to
-@samp{@@WORK} would be done with @kbd{C-c C-c w @key{RET}}.  Adding the
-non-predefined tag @samp{Sarah} could be done with @kbd{C-c C-c
-@key{TAB} S a r a h @key{RET} @key{RET}}.
-
+@samp{@@WORK} would be done with @kbd{C-c C-c w @key{RET}} or
+alternatively with @kbd{C-c C-c C-c w}.  Adding the non-predefined tag
+@samp{Sarah} could be done with @kbd{C-c C-c @key{TAB} S a r a h
+@key{RET} @key{RET}}.
+
+If you find that most of the time, you need only a single keypress to
+modify your list of tags, set the variable
+@code{org-fast-tag-selection-single-key}.  Then you no longer have to
+press @key{RET} to exit fast tag selection - it will immediately exit
+after the first change.  If you then occasionally need more keys, press
+@kbd{C-c} to turn off auto-exit for the current tag selection process.
 
 @node Tag searches,  , Setting tags, Tags
 @section Tag searches
@@ -5379,13 +5431,6 @@ functionality of Org-mode.
 The following extensions for Org-mode have been written by other people:
 
 @table @asis
-@cindex @file{org-mouse.el}
-@item @file{org-mouse.el} by Piotr Zielinski
-This package implements extended mouse functionality for Org-mode.  It
-allows you to cycle visibility and to edit the document structure with
-the mouse.  Best of all, it provides a context-sensitive menu on
-@key{mouse-3} that changes depending on the context of a mouse-click.
-@file{org-mouse.el} is freely available at @url{http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el}.
 @cindex @file{org-publish.el}
 @item @file{org-publish.el} by David O'Toole
 This package provides facilities for publishing related sets of Org-mode
@@ -5396,6 +5441,17 @@ Org-mode distribution.  It is not yet part of Emacs, however, a delay
 caused by the preparations for the 22.1 release.  In the mean time,
 @file{org-publish.el} can be downloaded from David's site:
 @url{http://dto.freeshell.org/e/org-publish.el}.
+@cindex @file{org-mouse.el}
+@item @file{org-mouse.el} by Piotr Zielinski
+This package implements extended mouse functionality for Org-mode.  It
+allows you to cycle visibility and to edit the document structure with
+the mouse.  Best of all, it provides a context-sensitive menu on
+@key{mouse-3} that changes depending on the context of a mouse-click.
+As of Org-mode version 4.53, @file{org-mouse.el} is part of the
+Org-mode distribution.  It is not yet part of Emacs, however, a delay
+caused by the preparations for the 22.1 release.  In the mean time,
+@file{org-mouse.el} can be downloaded from Piotr's site:
+@url{http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el}.
 @cindex @file{org-blog.el}
 @item @file{org-blog.el} by David O'Toole
 A blogging plug-in for @file{org-publish.el}.@*

orgcard.tex

@@ -1,5 +1,5 @@
 % Reference Card for Org Mode
-\def\orgversionnumber{4.53}
+\def\orgversionnumber{4.54}
 \def\year{2006}
 %
 %**start of header
@@ -284,6 +284,7 @@ are preserved on all copies.
 \key{rotate current subtree between states}{TAB}
 \key{rotate entire buffer between states}{S-TAB}
 \key{show the whole file}{C-c C-a}
+\key{reveal context around point}{C-c C-r}
 %\key{show branches}{C-c C-k}
 
 \section{Motion}