diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/misc/todo-mode.texi | 24 |
2 files changed, 19 insertions, 12 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 5721626f4e3..4ced6e2e97b 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,10 @@ | |||
| 1 | 2013-08-07 Eli Zaretskii <eliz@gnu.org> | ||
| 2 | |||
| 3 | * todo-mode.texi: Update @dircategory. | ||
| 4 | (Overview, Todo Items as Diary Entries, Todo Mode Entry Points) | ||
| 5 | (File Editing, Marked Items, Item Prefix): Fix usage of @xref and | ||
| 6 | @ref. | ||
| 7 | |||
| 1 | 2013-08-07 Xue Fuqiao <xfq.free@gmail.com> | 8 | 2013-08-07 Xue Fuqiao <xfq.free@gmail.com> |
| 2 | 9 | ||
| 3 | * sc.texi (Introduction): Fix index. | 10 | * sc.texi (Introduction): Fix index. |
diff --git a/doc/misc/todo-mode.texi b/doc/misc/todo-mode.texi index a14802e9181..27ec68cdf05 100644 --- a/doc/misc/todo-mode.texi +++ b/doc/misc/todo-mode.texi | |||
| @@ -23,7 +23,7 @@ modify this GNU manual.'' | |||
| 23 | @end quotation | 23 | @end quotation |
| 24 | @end copying | 24 | @end copying |
| 25 | 25 | ||
| 26 | @dircategory Emacs | 26 | @dircategory Emacs misc features |
| 27 | @direntry | 27 | @direntry |
| 28 | * Todo Mode: (todo-mode). Make and maintain todo lists. | 28 | * Todo Mode: (todo-mode). Make and maintain todo lists. |
| 29 | @end direntry | 29 | @end direntry |
| @@ -138,7 +138,7 @@ are subsidiary to and accessible from Todo mode. | |||
| 138 | 138 | ||
| 139 | This version of Todo mode greatly expands on, and in significant ways | 139 | This version of Todo mode greatly expands on, and in significant ways |
| 140 | differs from, the original version; for details and consequences of the | 140 | differs from, the original version; for details and consequences of the |
| 141 | most important differences, @xref{Legacy Todo Mode Files}. | 141 | most important differences, @ref{Legacy Todo Mode Files}. |
| 142 | 142 | ||
| 143 | @menu | 143 | @menu |
| 144 | * Levels of Organization:: | 144 | * Levels of Organization:: |
| @@ -192,8 +192,8 @@ file in the Emacs diary file (@pxref{Fancy Diary Display,,, emacs}), the | |||
| 192 | Fancy Diary display will show those todo items that are not marked with | 192 | Fancy Diary display will show those todo items that are not marked with |
| 193 | @code{todo-nondiary-marker}. This effectively augments the Emacs diary | 193 | @code{todo-nondiary-marker}. This effectively augments the Emacs diary |
| 194 | with categorized diary entries. For the various options available for | 194 | with categorized diary entries. For the various options available for |
| 195 | making a todo item a diary entry, @ref{Inserting New Items} and | 195 | making a todo item a diary entry, see @ref{Inserting New Items} and |
| 196 | @xref{Editing Item Headers and Text}. | 196 | @ref{Editing Item Headers and Text}. |
| 197 | 197 | ||
| 198 | To ensure the proper display of todo items in the Fancy Diary display, | 198 | To ensure the proper display of todo items in the Fancy Diary display, |
| 199 | they must have the format of diary entries, i.e., they have to begin | 199 | they must have the format of diary entries, i.e., they have to begin |
| @@ -244,9 +244,9 @@ default todo file. | |||
| 244 | 244 | ||
| 245 | If you want to enter Todo mode and go directly to a specific category | 245 | If you want to enter Todo mode and go directly to a specific category |
| 246 | instead the first or current category in the current or default todo | 246 | instead the first or current category in the current or default todo |
| 247 | file, use the command @code{todo-jump-to-category}; @ref{Navigation} for | 247 | file, use the command @code{todo-jump-to-category}; @ref{Navigation}, for |
| 248 | details. You can also enter Todo mode by invoking a todo item insertion | 248 | details. You can also enter Todo mode by invoking a todo item insertion |
| 249 | command; @ref{Inserting New Items} for details. | 249 | command; @ref{Inserting New Items}, for details. |
| 250 | 250 | ||
| 251 | The most convenient way to use these commands to enter Todo mode is to | 251 | The most convenient way to use these commands to enter Todo mode is to |
| 252 | define global key bindings for them in your init file. Good choices are | 252 | define global key bindings for them in your init file. Good choices are |
| @@ -421,7 +421,7 @@ name and creates the file in @code{todo-directory}, adding the | |||
| 421 | @samp{.todo} extension (so you should not include the extension in the | 421 | @samp{.todo} extension (so you should not include the extension in the |
| 422 | name you enter). The command also prompts for the file's first category and, if | 422 | name you enter). The command also prompts for the file's first category and, if |
| 423 | option @code{todo-add-item-if-new-category} is enabled (the default), | 423 | option @code{todo-add-item-if-new-category} is enabled (the default), |
| 424 | for that category's first item. | 424 | for that category's first item. |
| 425 | 425 | ||
| 426 | @item F r | 426 | @item F r |
| 427 | Rename the current todo file (@code{todo-rename-file}). If called with | 427 | Rename the current todo file (@code{todo-rename-file}). If called with |
| @@ -461,7 +461,7 @@ Using @kbd{C-x C-q} to quit Todo Edit mode provides a measure of safety, | |||
| 461 | since it runs a file format check, signaling an error if the format has | 461 | since it runs a file format check, signaling an error if the format has |
| 462 | become invalid. However, this check cannot tell if the number of items | 462 | become invalid. However, this check cannot tell if the number of items |
| 463 | changed, which could result in the file containing inconsistent | 463 | changed, which could result in the file containing inconsistent |
| 464 | information (see the cautionary note in @ref{Reordering Categories} for | 464 | information (see the cautionary note in @ref{Reordering Categories}, for |
| 465 | more details). For this reason @kbd{F e} should be used with caution. | 465 | more details). For this reason @kbd{F e} should be used with caution. |
| 466 | @end table | 466 | @end table |
| 467 | 467 | ||
| @@ -1139,7 +1139,7 @@ Mark the item at point if it is unmarked, and remove the mark it is | |||
| 1139 | already marked (@code{todo-toggle-mark-item}). The mark is a string | 1139 | already marked (@code{todo-toggle-mark-item}). The mark is a string |
| 1140 | specified by the option @code{todo-item-mark} (by default @samp{*}) | 1140 | specified by the option @code{todo-item-mark} (by default @samp{*}) |
| 1141 | appended in front of the item header (more precisely, in front of the | 1141 | appended in front of the item header (more precisely, in front of the |
| 1142 | item's priority number or prefix; @pxref{Todo Display Features} for | 1142 | item's priority number or prefix; see @ref{Todo Display Features}, for |
| 1143 | details of the latter). After marking the current item, the command | 1143 | details of the latter). After marking the current item, the command |
| 1144 | advances point to the next item. It also accepts a numeric prefix | 1144 | advances point to the next item. It also accepts a numeric prefix |
| 1145 | argument, which allows toggling the mark of multiple consecutive items. | 1145 | argument, which allows toggling the mark of multiple consecutive items. |
| @@ -1332,7 +1332,7 @@ way to do this in Todo mode is by sequentially searching in the file: | |||
| 1332 | @table @kbd | 1332 | @table @kbd |
| 1333 | 1333 | ||
| 1334 | @item S | 1334 | @item S |
| 1335 | This command (@code{todo-search}; the key is capital `S') prompts for a | 1335 | This command (@code{todo-search}; the key is capital @kbd{S}) prompts for a |
| 1336 | regular expression, searches from the beginning of the current todo file | 1336 | regular expression, searches from the beginning of the current todo file |
| 1337 | and displays the category containing the first match it finds, with the | 1337 | and displays the category containing the first match it finds, with the |
| 1338 | match highlighted. If there are further matches, a message saying how | 1338 | match highlighted. If there are further matches, a message saying how |
| @@ -1355,7 +1355,7 @@ These commands are also available in Todo Archive mode. | |||
| 1355 | A more powerful alternative to sequential searching is item filtering, | 1355 | A more powerful alternative to sequential searching is item filtering, |
| 1356 | by which items from different categories that match specified criteria | 1356 | by which items from different categories that match specified criteria |
| 1357 | are gathered and displayed in a new buffer as a kind of virtual | 1357 | are gathered and displayed in a new buffer as a kind of virtual |
| 1358 | category in a distinct mode, Todo Filtered Items mode. | 1358 | category in a distinct mode, Todo Filtered Items mode. |
| 1359 | 1359 | ||
| 1360 | @menu | 1360 | @menu |
| 1361 | * Filtering Items:: | 1361 | * Filtering Items:: |
| @@ -1612,7 +1612,7 @@ buffers of filtered items that have not yet been written to a file.) | |||
| 1612 | 1612 | ||
| 1613 | In the todo items section of each Todo mode category, the item prefix | 1613 | In the todo items section of each Todo mode category, the item prefix |
| 1614 | (whether a priority number or a fixed string) of the top priority items | 1614 | (whether a priority number or a fixed string) of the top priority items |
| 1615 | (determined as specified in @ref{Filtering Items}) is displayed in a | 1615 | (determined as specified in @pxref{Filtering Items}) is displayed in a |
| 1616 | different face from the prefix of the other items, so you see at a | 1616 | different face from the prefix of the other items, so you see at a |
| 1617 | glance how many items in the category are top priorities. | 1617 | glance how many items in the category are top priorities. |
| 1618 | 1618 | ||