[Emacs-diffs] emacs/doc/misc org.texi

[Carsten Dominik]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Carsten Dominik <cdominik>      09/01/27 11:40:11

Modified files:
        doc/misc       : org.texi 

Log message:
        2009-01-27  Carsten Dominik  <address@hidden>
        
                * org.texi (Plain lists, TODO basics, Priorities)
                (Multiple sets in one file, Conflicts): Document interaction 
with
                `shift-selection-mode'.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/org.texi?cvsroot=emacs&r1=1.36&r2=1.37

Patches:
Index: org.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/org.texi,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -b -r1.36 -r1.37
--- org.texi    26 Jan 2009 02:37:20 -0000      1.36
+++ org.texi    27 Jan 2009 11:40:04 -0000      1.37
@@ -3,7 +3,7 @@
 @setfilename ../../info/org
 @settitle The Org Manual
 
address@hidden VERSION 6.19a
address@hidden VERSION 6.19e
 @set DATE January 2009
 
 @dircategory Emacs
@@ -583,7 +583,7 @@
 the file's name is.  See also the variable
 @code{org-insert-mode-line-in-empty-file}.
 
-Many commands in Org work on the region if the region is active.  To make use
+Many commands in Org work on the region is the region is active.  To make use
 of this, you need to have @code{transient-mark-mode} (@code{zmacs-regions} in
 XEmacs) turned on.  In Emacs 23 this is the default, in Emacs 22 you need to
 do this yourself with
@@ -1302,7 +1302,11 @@
 @kindex address@hidden
 @item address@hidden
 @itemx address@hidden
-Jump to the previous/next item in the current list.
address@hidden shift-selection-mode
+Jump to the previous/next item in the current list, but only if
address@hidden is off.  If not, you can still use paragraph
+jumping commands like @address@hidden and @address@hidden to quite
+similar effect.
 @kindex address@hidden
 @kindex address@hidden
 @item address@hidden
@@ -1338,7 +1342,9 @@
 @kindex address@hidden
 @kindex address@hidden
 @item address@hidden/@key{right}
-Also cycle bullet styles when in the first line of an item.
+This command also cycles bullet styles when the cursor in on the bullet or
+anywhere in an item line, details depending on
address@hidden
 @end table
 
 @node Drawers, Footnotes, Plain lists, Document Structure
@@ -3044,7 +3050,8 @@
 @itemx address@hidden
 Select the following/preceding TODO state, similar to cycling.  Useful
 mostly if more than two TODO states are possible (@pxref{TODO
-extensions}).
+extensions}).  See also @ref{Conflicts} for a discussion of the interaction
+with @code{shift-selection-mode}.
 @kindex C-c C-v
 @kindex C-c / t
 @cindex sparse tree, for TODO
@@ -3187,18 +3194,24 @@
 @table @kbd
 @kindex address@hidden
 @kindex address@hidden
address@hidden address@hidden
address@hidden C-u C-u C-c C-t
address@hidden C-u C-u C-c C-t
address@hidden address@hidden
 @itemx address@hidden
 These keys jump from one TODO subset to the next.  In the above example,
address@hidden@key{right}} would jump from @code{TODO} or @code{DONE} to
address@hidden, and any of the words in the second row to @code{CANCELED}.
address@hidden C-u C-c C-t} or @address@hidden would jump from @code{TODO} or
address@hidden to @code{REPORT}, and any of the words in the second row to
address@hidden  Note that the @kbd{C-S-} key binding conflict with
address@hidden (@pxref{Conflicts}).
 @kindex address@hidden
 @kindex address@hidden
 @item address@hidden
 @itemx address@hidden
address@hidden@key{<left>}} and @address@hidden<right>}} and walk through
address@hidden keywords from all sets, so for example @address@hidden<right>}}
-would switch from @code{DONE} to @code{REPORT} in the example above.
address@hidden@key{<left>}} and @address@hidden<right>}} and walk through 
@emph{all}
+keywords from all sets, so for example @address@hidden<right>}} would switch
+from @code{DONE} to @code{REPORT} in the example above.  See also
address@hidden for a discussion of the interaction with
address@hidden
 @end table
 
 @node Fast access to TODO states, Per-file keywords, Multiple sets in one 
file, TODO extensions
@@ -3441,10 +3454,11 @@
 @kindex address@hidden
 @item address@hidden
 @itemx address@hidden
-Increase/decrease priority of current address@hidden also the
-option @code{org-priority-start-cycle-with-default'}.}.  Note that these
-keys are also used to modify time stamps (@pxref{Creating timestamps}).
-Furthermore, these keys are also used by CUA mode (@pxref{Conflicts}).
+Increase/decrease priority of current address@hidden also the option
address@hidden'}.}.  Note that these keys are
+also used to modify time stamps (@pxref{Creating timestamps}).  See also
address@hidden for a discussion of the interaction with
address@hidden
 @end table
 
 You can change the range of allowed priorities by setting the variables
@@ -6731,11 +6745,11 @@
 @subsection Exporting Agenda Views
 @cindex agenda views, exporting
 
-If you are away from your computer, it can be very useful to have a
-printed version of some agenda views to carry around.  Org mode can
-export custom agenda views as plain text, address@hidden need to
-install Hrvoje Niksic's @file{htmlize.el}.}, postscript, and iCalendar
-files.  If you want to do this only occasionally, use the command
+If you are away from your computer, it can be very useful to have a printed
+version of some agenda views to carry around.  Org mode can export custom
+agenda views as plain text, address@hidden need to install Hrvoje Niksic's
address@hidden, Postscript, and iCalendar files.  If you want to do this
+only occasionally, use the command
 
 @table @kbd
 @kindex C-x C-w
@@ -9275,33 +9289,40 @@
 
 @table @asis
 
address@hidden @file{allout.el}
address@hidden @file{allout.el} by Ken Manheimer
-Startup of Org may fail with the error message
address@hidden(wrong-type-argument keymapp nil)} when there is an outdated
-version @file{allout.el} on the load path, for example the version
-distributed with Emacs 21.x.  Upgrade to Emacs 22 and this problem will
-disappear.  If for some reason you cannot do this, make sure that org.el
-is loaded @emph{before} @file{allout.el}, for example by putting
address@hidden(require 'org)} early enough into your @file{.emacs} file.
address@hidden @code{shift-selection-mode}
+In Emacs 23, @code{shift-selection-mode} is on by default, meaning that
+cursor motions combined with the shift key should start or enlarge regions.
+This conflicts with the use of @address@hidden commands in Org to change
+timestamps, TODO keywords, priorities, and item bullet types if the cursor is
+at such a location.  By default, @address@hidden commands outside
+special contexts don't do anything, but you can customize the variable
address@hidden  Org-mode then tries to accommodate shift
+selection by (i) using it outside of the special contexts where special
+commands apply, and by (ii) extending an existing active region even if the
+cursor moves across a special context.
 
 @cindex @file{CUA.el}
 @item @file{CUA.el} by Kim. F. Storm
-Key bindings in Org conflict with the @kbd{S-<cursor>} keys used by
-CUA mode (as well as pc-select-mode and s-region-mode) to select and
-extend the region.  If you want to use one of these packages along with
-Org, configure the variable @code{org-replace-disputed-keys}.  When
-set, Org will move the following key bindings in Org files, and
-in the agenda buffer (but not during date selection).
+Key bindings in Org conflict with the @kbd{S-<cursor>} keys used by CUA mode
+(as well as pc-select-mode and s-region-mode) to select and extend the
+region.  In fact, Emacs 23 has this built-in in the form of
address@hidden, see previous paragraph.  If you are using Emacs
+23 you probably don't want to use another package for this purpose.  However,
+if you prefer to leave these keys to a different package while working in
+Org-mode, configure the variable @code{org-replace-disputed-keys}.  When set,
+Org will move the following key bindings in Org files, and in the agenda
+buffer (but not during date selection).
 
 @example
 S-UP    -> M-p             S-DOWN  -> M-n
 S-LEFT  -> M--             S-RIGHT -> M-+
+C-S-LEFT  ->  M-S--           C-S-RIGHT  ->  M-S-+
 @end example
 
 Yes, these are unfortunately more difficult to remember.  If you want
 to have other replacement keys, look at the variable
 @code{org-disputed-keys}.
+
 @item @file{windmove.el} by Hovav Shacham
 @cindex @file{windmove.el}
 Also this package uses the @kbd{S-<cursor>} keys, so everything written
@@ -9411,8 +9432,8 @@
 
 @item @file{org-interactive-query.el} by @i{Christopher League}
 Interactive modification of tags queries.  After running a general query in
-Org, this package allows you to narrow down the results by adding more tags or
-keywords.
+Org, this package allows you to narrow down the results by adding more tags
+or keywords.
 
 @item @file{org-mairix.el} by @i{Georg C. F. Greve}
 Hook mairix search into Org for different MUAs.