org.el: tiny docstring fix.

This commit is contained in:
Bastien Guerry 2011-08-19 17:42:27 +02:00
parent 96ad99ba07
commit 5b51893824
1 changed files with 20 additions and 19 deletions

View File

@ -361,14 +361,14 @@ to add the symbol `xyz', and the package must have a call to
(defcustom org-support-shift-select nil (defcustom org-support-shift-select nil
"Non-nil means make shift-cursor commands select text when possible. "Non-nil means make shift-cursor commands select text when possible.
In Emacs 23, when `shift-select-mode' is on, shifted cursor keys start In Emacs 23, when `shift-select-mode' is on, shifted cursor keys
selecting a region, or enlarge regions started in this way. start selecting a region, or enlarge regions started in this way.
In Org-mode, in special contexts, these same keys are used for other In Org-mode, in special contexts, these same keys are used for
purposes, important enough to compete with shift selection. Org tries other purposes, important enough to compete with shift selection.
to balance these needs by supporting `shift-select-mode' outside these Org tries to balance these needs by supporting `shift-select-mode'
special contexts, under control of this variable. outside these special contexts, under control of this variable.
The default of this variable is nil, to avoid confusing behavior. Shifted The default of this variable is nil, to avoid confusing behavior. Shifted
cursor keys will then execute Org commands in the following contexts: cursor keys will then execute Org commands in the following contexts:
- on a headline, changing TODO state (left/right) and priority (up/down) - on a headline, changing TODO state (left/right) and priority (up/down)
- on a time stamp, changing the time - on a time stamp, changing the time
@ -377,24 +377,25 @@ cursor keys will then execute Org commands in the following contexts:
- in the BEGIN line of a clock table (changing the time block). - in the BEGIN line of a clock table (changing the time block).
Outside these contexts, the commands will throw an error. Outside these contexts, the commands will throw an error.
When this variable is t and the cursor is not in a special context, When this variable is t and the cursor is not in a special
Org-mode will support shift-selection for making and enlarging regions. context, Org-mode will support shift-selection for making and
To make this more effective, the bullet cycling will no longer happen enlarging regions. To make this more effective, the bullet
anywhere in an item line, but only if the cursor is exactly on the bullet. cycling will no longer happen anywhere in an item line, but only
if the cursor is exactly on the bullet.
If you set this variable to the symbol `always', then the keys If you set this variable to the symbol `always', then the keys
will not be special in headlines, property lines, and item lines, to make will not be special in headlines, property lines, and item lines,
shift selection work there as well. If this is what you want, you can to make shift selection work there as well. If this is what you
use the following alternative commands: `C-c C-t' and `C-c ,' to want, you can use the following alternative commands: `C-c C-t'
change TODO state and priority, `C-u C-u C-c C-t' can be used to switch and `C-c ,' to change TODO state and priority, `C-u C-u C-c C-t'
TODO sets, `C-c -' to cycle item bullet types, and properties can be can be used to switch TODO sets, `C-c -' to cycle item bullet
edited by hand or in column view. types, and properties can be edited by hand or in column view.
However, when the cursor is on a timestamp, shift-cursor commands However, when the cursor is on a timestamp, shift-cursor commands
will still edit the time stamp - this is just too good to give up. will still edit the time stamp - this is just too good to give up.
XEmacs user should have this variable set to nil, because shift-select-mode XEmacs user should have this variable set to nil, because
is Emacs 23 only." `shift-select-mode' is in Emacs 23 or later only."
:group 'org :group 'org
:type '(choice :type '(choice
(const :tag "Never" nil) (const :tag "Never" nil)