ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improved documentation of exit-logging of states. 

I got questions in email that made clear that the documentation
does not explain the meaning of the second logging trigger
(like the "/@" in WAIT(@/@)) well enough.
Hope it is better now.
This commit is contained in:
Carsten Dominik 2008-03-04 09:52:54 +01:00
parent 5e14025496
commit b72a2d71e7
2 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
org.el
View File

@ -1716,7 +1716,9 @@ that the WAIT state can be selected with the \"w\" key. \"WAIT(w!)\"
indicates to record a time stamp each time this state is selected. indicates to record a time stamp each time this state is selected.
\"WAIT(w@)\" says that the user should in addition be prompted for a \"WAIT(w@)\" says that the user should in addition be prompted for a
note, and \"WAIT(w@/@)\" says that a note should be taken both when note, and \"WAIT(w@/@)\" says that a note should be taken both when
entering and when leaving this state. entering and when leaving this state. The last double-setting is
only a backup, to force a note even if the target state has no
logging configured.
For backward compatibility, this variable may also be just a list For backward compatibility, this variable may also be just a list
of keywords - in this case the interptetation (sequence or type) will be of keywords - in this case the interptetation (sequence or type) will be

11
org.texi
View File

@ -4,7 +4,7 @@
@settitle Org Mode Manual @settitle Org Mode Manual
@set VERSION 5.22a @set VERSION 5.22a
@set DATE February 2008 @set DATE March 2008
@dircategory Emacs @dircategory Emacs
@direntry @direntry
@ -3015,9 +3015,12 @@ the @samp{Closing Note}.}, and that a note is recorded when switching to
WAIT or CANCELED. The setting for WAIT is even more special: The WAIT or CANCELED. The setting for WAIT is even more special: The
@samp{!} after the slash means that in addition to the note taken when @samp{!} after the slash means that in addition to the note taken when
entering the state, a time stamp should be recorded when @i{leaving} the entering the state, a time stamp should be recorded when @i{leaving} the
WAIT state. This allows you to get a record when switching from WAIT WAIT state. This second logging setting only comes into play when
back to TODO, without getting one when first turning an entry into a switching to a state that has no logging set up. So it has no effect
TODO. when switching from WAIT to DONE, because DONE is configured to record a
timestamp only. But when switching from WAIT back to TODO, the
@samp{/!} in the WAIT setting now triggers a timestamp even though TODO
has no logging configured.
You can use the exact same syntax for setting logging preferences local You can use the exact same syntax for setting logging preferences local
to a buffer: to a buffer: