From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jason Dunsmore Subject: [PATCH] Documentation for "Tracking TODO state changes" Date: Wed, 09 Nov 2011 11:03:06 -0600 Message-ID: <87ipmt9qk5.fsf_-_@riotblast.dunsmor.com> References: <8762itbazi.fsf@riotblast.dunsmor.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([140.186.70.92]:41271) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ROBYO-0005oa-Kw for emacs-orgmode@gnu.org; Wed, 09 Nov 2011 12:03:17 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ROBYK-0008M6-Da for emacs-orgmode@gnu.org; Wed, 09 Nov 2011 12:03:12 -0500 Received: from deathroller.dunsmor.com ([98.129.169.48]:50286) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ROBYJ-0008Lx-W4 for emacs-orgmode@gnu.org; Wed, 09 Nov 2011 12:03:08 -0500 In-Reply-To: (suvayu ali's message of "Wed, 9 Nov 2011 17:37:58 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: suvayu ali Cc: emacs-orgmode@gnu.org suvayu ali writes: > Hi Jason, > > On Wed, Nov 9, 2011 at 15:56, Jason Dunsmore wr= ote: >> 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. =C2=A0Is 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 =20 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 =20 @lisp (setq org-todo-keywords '((sequence "TODO(t)" "WAIT(w@@/!)" "|" "DONE(d!)" "CANCELED(c@@)"))) @end lisp =20 +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---