C-u C-c C-t not behaving as documented

C-u C-c C-t not behaving as documented

[Brian van den Broek]

Hi all,

I have

(setq org-todo-keywords
       '((sequence "TODO(t!)" "STARTED(s!)" "WAITING(w@/@)" "|" "DONE(d@/@)"
                   "CANCELLED(c@/@)" "DEFERRED(D@/@)")))

in my .emacs.

In http://orgmode.org/org.html#TODO-basics I read

C-u C-c C-t
    Select a specific keyword using completion or (if it has been set
up) the fast selection interface.
    For the latter, you need to assign keys to TODO states, see
Per-file keywords, and Setting
    tags, for more information.

When I hit C-u C-c C-t on a headline, the result is that the headline
cycles through my TODO states (as defined above). In effect, C-u C-c
C-t behaves as C-c C-t is documented to.

I've checked through my org configuration for other settings that
affect todo sequences and states and don't think I've got anything
that accounts for this.

I'm perfectly happy with the behaviour I observe. But, it isn't what
one would expect from reading the docs. (I suspect that the docs might
not have been updated when org-todo-keywords was introduced. Or, as
has happened before, I've misunderstood something.)

Org-mode version 7.9.2 (7.9.2-dist @ /home/brian/.emacsd/site-lisp/org/)
Mark set
GNU Emacs 23.2.1 (x86_64-pc-linux-gnu, GTK+ Version 2.20.1) of
2010-12-11 on brahms, modified by Debian

Best,

Brian vdB

Re: C-u C-c C-t not behaving as documented

[J. David Boyd]

Brian van den Broek <brian.van.den.broek@gmail.com> writes:

> Hi all,
>
> I have
>
> (setq org-todo-keywords
>        '((sequence "TODO(t!)" "STARTED(s!)" "WAITING(w@/@)" "|" "DONE(d@/@)"
>                    "CANCELLED(c@/@)" "DEFERRED(D@/@)")))
>
> in my .emacs.
>
> In http://orgmode.org/org.html#TODO-basics I read
>
> C-u C-c C-t
>     Select a specific keyword using completion or (if it has been set
> up) the fast selection interface.
>     For the latter, you need to assign keys to TODO states, see
> Per-file keywords, and Setting
>     tags, for more information.
>
> When I hit C-u C-c C-t on a headline, the result is that the headline
> cycles through my TODO states (as defined above). In effect, C-u C-c
> C-t behaves as C-c C-t is documented to.
>
> I've checked through my org configuration for other settings that
> affect todo sequences and states and don't think I've got anything
> that accounts for this.
>
> I'm perfectly happy with the behaviour I observe. But, it isn't what
> one would expect from reading the docs. (I suspect that the docs might
> not have been updated when org-todo-keywords was introduced. Or, as
> has happened before, I've misunderstood something.)
>
> Org-mode version 7.9.2 (7.9.2-dist @ /home/brian/.emacsd/site-lisp/org/)
> Mark set
> GNU Emacs 23.2.1 (x86_64-pc-linux-gnu, GTK+ Version 2.20.1) of
> 2010-12-11 on brahms, modified by Debian
>
> Best,
>
> Brian vdB

I get the same exact behavior, and like you, I'm fine with it too.

Re: C-u C-c C-t not behaving as documented

[Bastien]

Hi Brian,

thanks for the detailed feedback on this.

Brian van den Broek <brian.van.den.broek@gmail.com> writes:

> I'm perfectly happy with the behaviour I observe. 

Me too :)

> But, it isn't what
> one would expect from reading the docs.

The manual was describing the behavior *when there is no fast todo
selection key*.  But it was not complete.  I just fixed the doc,
hopefully things are clearer now.

> (I suspect that the docs might
> not have been updated when org-todo-keywords was introduced. Or, as
> has happened before, I've misunderstood something.)

See http://orgmode.org/cgit.cgi/org-mode.git/commit/?id=2949012f0
`org-todo-keywords' was here a long time ago when the default value
of `org-use-fast-todo-selection' was changed (after Carsten's poll
on default values for variables...)

Thanks!

-- 
 Bastien