From: Jason Dunsmore <jasondunsmore@gmail.com>
To: suvayu ali <fatkasuvayu+linux@gmail.com>
Cc: emacs-orgmode@gnu.org
Subject: [PATCH] Documentation for "Tracking TODO state changes"
Date: Wed, 09 Nov 2011 11:03:06 -0600 [thread overview]
Message-ID: <87ipmt9qk5.fsf_-_@riotblast.dunsmor.com> (raw)
In-Reply-To: <CAMXnza3QA9SMxbQrPLx7cguA_za0HZ3Yu-sWSnRg6uSppRHzfQ@mail.gmail.com> (suvayu ali's message of "Wed, 9 Nov 2011 17:37:58 +0100")
suvayu ali <fatkasuvayu+linux@gmail.com> writes:
> Hi Jason,
>
> On Wed, Nov 9, 2011 at 15:56, Jason Dunsmore <jasondunsmore@gmail.com> wrote:
>> After reading http://orgmode.org/org.html#Tracking-TODO-state-changes, I
>> expected the "@!" TODO syntax, eg. TODO(t@!), to do the following:
>>
>> - Log timestamp when entering state
>> - Add note when entering state
>>
>> This syntax appears to break the functionality, because it does neither.
>> The state is changed with no logging or note prompt. Is this a bug?
>>
>> I verified that the TODO(t@/!) syntax does work as indicated in the
>> manual.
>>
>> - Add note when entering state
>> - Log timestamp when entering state
>> - Log timestamp when exiting state
>>
>> This is with the latest org-mode (commit a4273cbe0e0) and Emacs 23.2.1.
>>
>
> I believe the above should be:
>
> - Add note _with timestamp_ when entering state
> - Log timestamp when exiting state
>
> That said, you can simply hit C-c C-c to simply log the timestamp
> without a note. In other words, '@' is equivalent to '!' + note, so just
> enter a blank note. :)
Ah, I understand now. Thanks for the explanation. Here's a patch to to
the documentation:
--8<---------------cut here---------------start------------->8---
diff --git a/doc/org.texi b/doc/org.texi
index 4a547d0..e1167eb 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -4032,14 +4032,18 @@ also overrule the setting of this variable for a
subtree
Since it is normally too much to record a note for every state,
Org-mode
expects configuration on a per-keyword basis for this. This is
achieved by
-adding special markers @samp{!} (for a timestamp) and @samp{@@} (for a
note)
-in parentheses after each keyword. For example, with the setting
+adding special markers @samp{!} (for a timestamp) or @samp{@@} (for a
note
+with timestamp) in parentheses after each keyword. For example, with
the
+setting
@lisp
(setq org-todo-keywords
'((sequence "TODO(t)" "WAIT(w@@/!)" "|" "DONE(d!)" "CANCELED(c@@)")))
@end lisp
+To record a timestamp without a note for TODO keywords configured with
+@samp{@@}, just type @kbd{C-c C-c} to enter a blank note when prompted.
+
@noindent
@vindex org-log-done
you not only define global TODO keywords and fast access keys, but also
--8<---------------cut here---------------end--------------->8---
next prev parent reply other threads:[~2011-11-09 17:03 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-11-09 14:56 [BUG] Unable to use TODO(t@!) to track TODO state changes Jason Dunsmore
2011-11-09 15:40 ` Giovanni Ridolfi
2011-11-09 16:24 ` Jason Dunsmore
2011-11-09 17:53 ` Dave Abrahams
2011-11-09 16:37 ` suvayu ali
2011-11-09 17:03 ` Jason Dunsmore [this message]
2011-11-09 17:18 ` [PATCH] Documentation for "Tracking TODO state changes" Bernt Hansen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87ipmt9qk5.fsf_-_@riotblast.dunsmor.com \
--to=jasondunsmore@gmail.com \
--cc=emacs-orgmode@gnu.org \
--cc=fatkasuvayu+linux@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).