---

1.16 TODO

TODO STATE CHANGE

keep track of when a state change occurred and maybe take a note about this change. You can either record just a timestamp, or a time-stamped note for a change. These records will be inserted after the headline as an itemized list, newest first.

To keep the notes hidden and out of the way, place them into a special drawer called :LOGBOOK:. Logbook Drawer Globally customize the variable org-log-into-drawer to get this behavior. You can also set a property called :LOG-INTO-DRAWER:DrawerName.

C-c C-z :: (org-add-note) add a note to the current entry

To time-stamp when a TODO is changed to DONE, set the variable org-log-done to the value of time, or use the in-buffer setting of #+STARTUP: logdone. A line CLOSED: [timestamp] will be inserted.

To also record a note when cycling a TODO to DONE, set the variable org-log-done to the value note instead, or add an in-buffer setting of #+STARTUP: lognotedone.

To customize special logging for other state changes, see Tracking TODO State Changes

TAG (:tag:)

Words delimited by colons (:) added to the end of a headline to give extra context. ==> See Tags. They can be stacked (called a list of tags): :tag1:tag2:

Tags are normal words containing letters, numbers, underscores (_), and ampersands (@).

C-c C-c

activate changes to in-buffer settings

Clocking Time

Clock the time you spend on a specific task in a project. When you start working on an item, start the clock. When you stop, or when you mark DONE, stop the clock. The corresponding time interval is recorded. Org will also comput the total time spent on each subtree of a project. (org)Clocking Commands

Consider creating global key bindings for (org-clock-out) and (org-clock-in-last)

C-c C-x C-i

(org-clock-in) — inserts the CLOCK keyword together with a timestamp.

C-u C-c C-x C-i

select from a list of recently clocked tasks.

C-u C-u C-c C-x C-i

clock into the task at point and mark it as the default task; the default task will then be available with d when selecting a clocking task.

C-u C-u C-u C-c C-x C-i

force continuous clocking by starting the clock when the last clock is stopped.

C-c C-x C-o

(org-clock-out) — stop the clock; inserts another timestamp at the same location where the clock was started. Computes the resulting time and inserts it. Have the option of inserting an additional note using the variable: org-log-note-clock-out, or #+STARTUP: lognoteclock-out.

C-c C-x C-x

(org-clock-in-last) — reclock the last clocked task.

C-u C-c C-x C-x

select the task from the clock history

C-u C-u C-c C-x C-x

force continuous clocking by starting the clock when the last clock is stopped.

C-c C-x C-e

(org-clock-modify-effort-estimate)

C-c C-c or C-c C-y

(org-evaluate-time-range)

C-S-<up/down>

(org-clock-timestamps-up/down) — both timestamps; clock duration remains the same

S-M-<up/down>

(org-timestamp-up/down) — timestamp at point, and next or previous

C-c C-t

(org-todo) — changes TODO to DONE and stops clock

C-c C-x C-q

(org-clock-cancel)

C-c C-x C-j

(org-clock-goto) — jumpt to headline of currently clocked-in task

C-u C-c C-x C-j

select the target task from a list of recently clocked tasks

C-c C-x C-d

(org-clock-display) — display time summaries for each subtree in the current buffer.

l

in the agenda, l key shows which tasks have been worked on or closed in a day