Mercurial > emacs
comparison man/org.texi @ 67537:f0c77dab544c
(Progress Logging): New section.
author | Carsten Dominik <dominik@science.uva.nl> |
---|---|
date | Mon, 12 Dec 2005 11:48:19 +0000 |
parents | 62adeda8b0dd |
children | d690cd38b69b |
comparison
equal
deleted
inserted
replaced
67536:b071fde35608 | 67537:f0c77dab544c |
---|---|
2 @c %**start of header | 2 @c %**start of header |
3 @c @setfilename org | 3 @c @setfilename org |
4 @setfilename ../info/org | 4 @setfilename ../info/org |
5 @settitle Org Mode Manual | 5 @settitle Org Mode Manual |
6 | 6 |
7 @set VERSION 3.23 | 7 @set VERSION 3.24 |
8 @set DATE December 2005 | 8 @set DATE December 2005 |
9 | 9 |
10 @dircategory Emacs | 10 @dircategory Emacs |
11 @direntry | 11 @direntry |
12 * Org Mode: (org). Outline-based notes management and organizer | 12 * Org Mode: (org). Outline-based notes management and organizer |
132 * Remember:: Org-trees store quick notes | 132 * Remember:: Org-trees store quick notes |
133 | 133 |
134 TODO items | 134 TODO items |
135 | 135 |
136 * TODO basics:: Marking and displaying TODO entries | 136 * TODO basics:: Marking and displaying TODO entries |
137 * Progress Logging:: Document your productivity | |
137 * TODO extensions:: Workflow and assignments | 138 * TODO extensions:: Workflow and assignments |
138 * Priorities:: Some things are more important than others | 139 * Priorities:: Some things are more important than others |
139 | 140 |
140 Extended use of TODO keywords | 141 Extended use of TODO keywords |
141 | 142 |
1070 a definition, any formula in the table may use @samp{$m1} to refer to | 1071 a definition, any formula in the table may use @samp{$m1} to refer to |
1071 the value @samp{10}. Also, named fields can have their own formula | 1072 the value @samp{10}. Also, named fields can have their own formula |
1072 associated with them. | 1073 associated with them. |
1073 @item _ | 1074 @item _ |
1074 Similar to @samp{^}, but defines names for the fields in the row | 1075 Similar to @samp{^}, but defines names for the fields in the row |
1075 @emph{below}. | 1076 @emph{below}. |
1076 @item $ | 1077 @item $ |
1077 Fields in this row can define @emph{parameters} for formulas. For | 1078 Fields in this row can define @emph{parameters} for formulas. For |
1078 example, if a field in a @samp{$} row contains @samp{max=50}, then | 1079 example, if a field in a @samp{$} row contains @samp{max=50}, then |
1079 formulas in this table can refer to the value 50 using @samp{$max}. | 1080 formulas in this table can refer to the value 50 using @samp{$max}. |
1080 Parameters work exactly like constants, only that they can be defined on | 1081 Parameters work exactly like constants, only that they can be defined on |
1087 lines will be left alone by this command. | 1088 lines will be left alone by this command. |
1088 @item * | 1089 @item * |
1089 Selects this line for global recalculation with @kbd{C-u C-c *}, but | 1090 Selects this line for global recalculation with @kbd{C-u C-c *}, but |
1090 not for automatic recalculation. Use this when automatic | 1091 not for automatic recalculation. Use this when automatic |
1091 recalculation slows down editing too much. | 1092 recalculation slows down editing too much. |
1092 @item | 1093 @item |
1093 Unmarked lines are exempted from recalculation with @kbd{C-u C-c *}. | 1094 Unmarked lines are exempted from recalculation with @kbd{C-u C-c *}. |
1094 All lines that should be recalculated should be marked with @samp{#} | 1095 All lines that should be recalculated should be marked with @samp{#} |
1095 or @samp{*}. | 1096 or @samp{*}. |
1096 @end table | 1097 @end table |
1097 | 1098 |
1121 @samp{#+TBLFM} line. | 1122 @samp{#+TBLFM} line. |
1122 | 1123 |
1123 @kindex C-c C-c | 1124 @kindex C-c C-c |
1124 You may edit the @samp{#+TBLFM} directly and re-apply | 1125 You may edit the @samp{#+TBLFM} directly and re-apply |
1125 the changed equations with @kbd{C-c C-c} in that line, or with the | 1126 the changed equations with @kbd{C-c C-c} in that line, or with the |
1126 normal recalculation commands in the table. | 1127 normal recalculation commands in the table. |
1127 | 1128 |
1128 @kindex C-c ' | 1129 @kindex C-c ' |
1129 @kindex C-c C-c | 1130 @kindex C-c C-c |
1130 @kindex C-c C-q | 1131 @kindex C-c C-q |
1131 @kindex C-c ? | 1132 @kindex C-c ? |
1267 matches, org-mode will usually find the right one since it tries | 1268 matches, org-mode will usually find the right one since it tries |
1268 targets and exact matches first. To insert links targeting a | 1269 targets and exact matches first. To insert links targeting a |
1269 headline, in-buffer completion can be used. Just type a star followed | 1270 headline, in-buffer completion can be used. Just type a star followed |
1270 by a few optional letters into the buffer and press @kbd{M-@key{TAB}}. | 1271 by a few optional letters into the buffer and press @kbd{M-@key{TAB}}. |
1271 CamelCased versions of all headlines in the current buffer will be | 1272 CamelCased versions of all headlines in the current buffer will be |
1272 offered as completions. @xref{Managing links}, for more commands | 1273 offered as completions. @xref{Managing links} for more commands |
1273 creating links. | 1274 creating links. |
1274 | 1275 |
1275 @node External Links, Managing links, Internal Links, Hyperlinks | 1276 @node External Links, Managing links, Internal Links, Hyperlinks |
1276 @section External Links | 1277 @section External Links |
1277 @cindex links | 1278 @cindex links |
1495 your file. Org-mode provides methods to give you an overview over all | 1496 your file. Org-mode provides methods to give you an overview over all |
1496 things you have to do. | 1497 things you have to do. |
1497 | 1498 |
1498 @menu | 1499 @menu |
1499 * TODO basics:: Marking and displaying TODO entries | 1500 * TODO basics:: Marking and displaying TODO entries |
1501 * Progress Logging:: Document your productivity | |
1500 * TODO extensions:: Workflow and assignments | 1502 * TODO extensions:: Workflow and assignments |
1501 * Priorities:: Some things are more important than others | 1503 * Priorities:: Some things are more important than others |
1502 @end menu | 1504 @end menu |
1503 | 1505 |
1504 @node TODO basics, TODO extensions, TODO items, TODO items | 1506 @node TODO basics, Progress Logging, TODO items, TODO items |
1505 @section Basic TODO functionality | 1507 @section Basic TODO functionality |
1506 | 1508 |
1507 Any headline can become a TODO item by starting it with the word TODO, | 1509 Any headline can become a TODO item by starting it with the word TODO, |
1508 for example | 1510 for example |
1509 | 1511 |
1541 A prefix argument can be used to collect only TODO entries of a | 1543 A prefix argument can be used to collect only TODO entries of a |
1542 particular type. With a C-u prefix you are prompted for a keyword. | 1544 particular type. With a C-u prefix you are prompted for a keyword. |
1543 With a numeric prefix, the Nth keyword in @code{org-todo-keywords} is | 1545 With a numeric prefix, the Nth keyword in @code{org-todo-keywords} is |
1544 selected. | 1546 selected. |
1545 @kindex r | 1547 @kindex r |
1546 The @kbd{r} key in the agenda | 1548 The @kbd{r} key in the agenda buffer regenerates it, and you can give |
1547 buffer regenerates it, and you can give a prefix argument to this | 1549 a prefix argument to this command to change the selected TODO keyword, |
1548 command to change the selected TODO keyword, for example @kbd{3 r}. | 1550 for example @kbd{3 r}. The key binding @kbd{C-c t} is only a |
1549 The key binding @kbd{C-c t} is only a suggestion - see | 1551 suggestion - see @ref{Installation and Activation}. |
1550 @ref{Installation and Activation}. | |
1551 @kindex C-u C-c a | 1552 @kindex C-u C-c a |
1552 @item C-u C-c a | 1553 @item C-u C-c a |
1553 A @kbd{C-u} argument to the @code{org-agenda command} (@pxref{Agenda}) | 1554 A @kbd{C-u} argument to the @code{org-agenda command} (@pxref{Agenda}) |
1554 includes all unfinished TODO items at the beginning of todays agenda. | 1555 includes all unfinished TODO items at the beginning of todays agenda. |
1556 See also the variable @code{org-agenda-include-all-todo} to get this | |
1557 by default. | |
1555 @end table | 1558 @end table |
1556 | 1559 |
1557 @node TODO extensions, Priorities, TODO basics, TODO items | 1560 @node Progress Logging, TODO extensions, TODO basics, TODO items |
1561 @section Progress Logging | |
1562 @cindex progress logging | |
1563 @cindex logging, of progress | |
1564 If you want to keep track of @emph{when} a certain TODO item was | |
1565 finished, turn on logging with | |
1566 @lisp | |
1567 (setq org-log-done t) | |
1568 @end lisp | |
1569 @noindent | |
1570 Then each time you turn a TODO entry into DONE using either @kbd{C-c | |
1571 C-v} in the Org-mode buffer or @kbd{t} in the agenda buffer, a line | |
1572 @samp{CLOSED: [timestamp]} will be inserted just after the headline. | |
1573 If you turn the entry back into a TODO item again thorugh further | |
1574 state cycling, that line will be removed again. In the timeline | |
1575 (@pxref{Timeline}) and in the agenda (@pxref{Agenda}), you can then | |
1576 use the @kbd{L} key to display the TODO items closed on each day, | |
1577 giving you an overview of what has been done on a day. | |
1578 | |
1579 @node TODO extensions, Priorities, Progress Logging, TODO items | |
1558 @section Extended use of TODO keywords | 1580 @section Extended use of TODO keywords |
1559 @cindex extended TODO keywords | 1581 @cindex extended TODO keywords |
1560 | 1582 |
1561 The default implementation of TODO entries is just two states: TODO | 1583 The default implementation of TODO entries is just two states: TODO |
1562 and DONE. You can, however, use the TODO feature for more | 1584 and DONE. You can, however, use the TODO feature for more |
1800 and time. | 1822 and time. |
1801 | 1823 |
1802 @kindex C-c ! | 1824 @kindex C-c ! |
1803 @item C-c ! | 1825 @item C-c ! |
1804 Like @kbd{C-c .}, but insert an inactive time stamp not triggering the | 1826 Like @kbd{C-c .}, but insert an inactive time stamp not triggering the |
1805 agenda. | 1827 agenda. |
1806 | 1828 |
1807 @kindex C-c < | 1829 @kindex C-c < |
1808 @item C-c < | 1830 @item C-c < |
1809 Insert a time stamp corresponding to the cursor date in the Calendar. | 1831 Insert a time stamp corresponding to the cursor date in the Calendar. |
1810 | 1832 |
2134 @itemx @key{RET} | 2156 @itemx @key{RET} |
2135 Go to the original location of the item and delete other windows. | 2157 Go to the original location of the item and delete other windows. |
2136 | 2158 |
2137 @kindex f | 2159 @kindex f |
2138 @item f | 2160 @item f |
2139 Toggle follow mode. In follow mode, as you move the cursor through | 2161 Toggle Follow mode. In Follow mode, as you move the cursor through |
2140 the agenda buffer, the other window always shows the corresponding | 2162 the agenda buffer, the other window always shows the corresponding |
2141 location in the org file. | 2163 location in the org file. |
2164 | |
2165 @kindex L | |
2166 @item L | |
2167 Toggle Logbook mode. In Logbook mode, entries that where marked DONE while | |
2168 logging was on (variable @code{org-log-done}) are shown in the agenda. | |
2142 | 2169 |
2143 @tsubheading{Change display} | 2170 @tsubheading{Change display} |
2144 @kindex o | 2171 @kindex o |
2145 @item o | 2172 @item o |
2146 Delete other windows. | 2173 Delete other windows. |
2574 end of the outline tree. For example: | 2601 end of the outline tree. For example: |
2575 | 2602 |
2576 @example | 2603 @example |
2577 * COMMENT HTML style specifications | 2604 * COMMENT HTML style specifications |
2578 | 2605 |
2579 # Local Variables: | 2606 # Local Variables: |
2580 # org-export-html-style: " <style type=\"text/css\"> | 2607 # org-export-html-style: " <style type=\"text/css\"> |
2581 p @{font-weight: normal; color: gray; @} | 2608 p @{font-weight: normal; color: gray; @} |
2582 h1 @{color: black; @} | 2609 h1 @{color: black; @} |
2583 </style>" | 2610 </style>" |
2584 # End: *** | 2611 # End: *** |
2996 Stefan Monnier provided a patch with lots of little fixes to keep the | 3023 Stefan Monnier provided a patch with lots of little fixes to keep the |
2997 Emacs-Lisp compiler happy. | 3024 Emacs-Lisp compiler happy. |
2998 @item | 3025 @item |
2999 Kai Grossjohann pointed out that a number of key bindings in Org-mode | 3026 Kai Grossjohann pointed out that a number of key bindings in Org-mode |
3000 conflict with other packages. | 3027 conflict with other packages. |
3001 @item | 3028 @item |
3002 Roland Winkler pointed out that additional keybindings are needed to | 3029 Roland Winkler pointed out that additional keybindings are needed to |
3003 use Org-mode on a tty. | 3030 use Org-mode on a tty. |
3004 @item | 3031 @item |
3005 Tim O'Callaghan suggested in-file links, and search options for | 3032 Tim O'Callaghan suggested in-file links, and search options for |
3006 general file links. | 3033 general file links. |