aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog7
-rw-r--r--doc/misc/todo-mode.texi24
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 @@
12013-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
12013-08-07 Xue Fuqiao <xfq.free@gmail.com> 82013-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
139This version of Todo mode greatly expands on, and in significant ways 139This version of Todo mode greatly expands on, and in significant ways
140differs from, the original version; for details and consequences of the 140differs from, the original version; for details and consequences of the
141most important differences, @xref{Legacy Todo Mode Files}. 141most 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
192Fancy Diary display will show those todo items that are not marked with 192Fancy 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
194with categorized diary entries. For the various options available for 194with categorized diary entries. For the various options available for
195making a todo item a diary entry, @ref{Inserting New Items} and 195making 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
198To ensure the proper display of todo items in the Fancy Diary display, 198To ensure the proper display of todo items in the Fancy Diary display,
199they must have the format of diary entries, i.e., they have to begin 199they must have the format of diary entries, i.e., they have to begin
@@ -244,9 +244,9 @@ default todo file.
244 244
245If you want to enter Todo mode and go directly to a specific category 245If you want to enter Todo mode and go directly to a specific category
246instead the first or current category in the current or default todo 246instead the first or current category in the current or default todo
247file, use the command @code{todo-jump-to-category}; @ref{Navigation} for 247file, use the command @code{todo-jump-to-category}; @ref{Navigation}, for
248details. You can also enter Todo mode by invoking a todo item insertion 248details. You can also enter Todo mode by invoking a todo item insertion
249command; @ref{Inserting New Items} for details. 249command; @ref{Inserting New Items}, for details.
250 250
251The most convenient way to use these commands to enter Todo mode is to 251The most convenient way to use these commands to enter Todo mode is to
252define global key bindings for them in your init file. Good choices are 252define 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
422name you enter). The command also prompts for the file's first category and, if 422name you enter). The command also prompts for the file's first category and, if
423option @code{todo-add-item-if-new-category} is enabled (the default), 423option @code{todo-add-item-if-new-category} is enabled (the default),
424for that category's first item. 424for that category's first item.
425 425
426@item F r 426@item F r
427Rename the current todo file (@code{todo-rename-file}). If called with 427Rename 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,
461since it runs a file format check, signaling an error if the format has 461since it runs a file format check, signaling an error if the format has
462become invalid. However, this check cannot tell if the number of items 462become invalid. However, this check cannot tell if the number of items
463changed, which could result in the file containing inconsistent 463changed, which could result in the file containing inconsistent
464information (see the cautionary note in @ref{Reordering Categories} for 464information (see the cautionary note in @ref{Reordering Categories}, for
465more details). For this reason @kbd{F e} should be used with caution. 465more 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
1139already marked (@code{todo-toggle-mark-item}). The mark is a string 1139already marked (@code{todo-toggle-mark-item}). The mark is a string
1140specified by the option @code{todo-item-mark} (by default @samp{*}) 1140specified by the option @code{todo-item-mark} (by default @samp{*})
1141appended in front of the item header (more precisely, in front of the 1141appended in front of the item header (more precisely, in front of the
1142item's priority number or prefix; @pxref{Todo Display Features} for 1142item's priority number or prefix; see @ref{Todo Display Features}, for
1143details of the latter). After marking the current item, the command 1143details of the latter). After marking the current item, the command
1144advances point to the next item. It also accepts a numeric prefix 1144advances point to the next item. It also accepts a numeric prefix
1145argument, which allows toggling the mark of multiple consecutive items. 1145argument, 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
1335This command (@code{todo-search}; the key is capital `S') prompts for a 1335This command (@code{todo-search}; the key is capital @kbd{S}) prompts for a
1336regular expression, searches from the beginning of the current todo file 1336regular expression, searches from the beginning of the current todo file
1337and displays the category containing the first match it finds, with the 1337and displays the category containing the first match it finds, with the
1338match highlighted. If there are further matches, a message saying how 1338match highlighted. If there are further matches, a message saying how
@@ -1355,7 +1355,7 @@ These commands are also available in Todo Archive mode.
1355A more powerful alternative to sequential searching is item filtering, 1355A more powerful alternative to sequential searching is item filtering,
1356by which items from different categories that match specified criteria 1356by which items from different categories that match specified criteria
1357are gathered and displayed in a new buffer as a kind of virtual 1357are gathered and displayed in a new buffer as a kind of virtual
1358category in a distinct mode, Todo Filtered Items mode. 1358category 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
1613In the todo items section of each Todo mode category, the item prefix 1613In 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
1616different face from the prefix of the other items, so you see at a 1616different face from the prefix of the other items, so you see at a
1617glance how many items in the category are top priorities. 1617glance how many items in the category are top priorities.
1618 1618