todo-mode: Other Display Commands and Options
11.3 Other Display Commands and Options
=======================================
There are two additional toggle commands that affect display in the
current file:
‘F h’
‘h’
Hide the item headers if visible, or show them if they are hidden.
With done items, only the done header (i.e., the done tag and
date-time string inserted when the item was marked done) is hidden,
the original date-time string is not. With filtered items, the
category (or category-file) tag is not hidden.
‘F H’
‘H’
Highlight the current item (with the face ‘hl-line’) if
unhighlighted, or remove its highlighting. When item highlighting
is enabled, it follows navigation by ‘n’ or ‘p’. If you want to
have current item highlighting by default, enable the option
‘todo-highlight-item’. ‘F H’ or ‘H’ will still toggle it.
There are two options which affect the display of items whose content
is longer than one screen line:
• ‘todo-indent-to-here’ sets the amount of indentation for all lines
after the first in multiline todo items, which is necessary in
order for todo diary items to be fully visible in the Fancy Diary
display. The default indentation is 3 spaces. For a uniform
appearance this option applies to all items, i.e., diary and
nondiary todo items and also done items.
• ‘todo-wrap-lines’ allows you to choose, for the purposes of
insertion and editing, between treating multiline todo items as
containing multiple logical lines with hard line breaks or as
multiple visual lines using Visual Line mode; the latter is the
default. Since multiparagraph items also contain hard line breaks
in Visual Line mode, for a uniform appearance this display shows
indentation on wrapped lines by using a wrap-prefix of
‘todo-indent-to-here’ spaces.
The indentation inserted after a hard newline is actually a tab
character, and the Todo modes that display items bind ‘tab-width’ to
‘todo-indent-to-here’, so if you change the default value of the latter,
the next time you visit a Todo file, the indentation will reflect your
change.
By default, the todo and done items sections of a todo category are
visually separated by a line as wide as the window the buffer is
displayed in. You can change the appearance and width of the separator
by customizing ‘todo-done-separator-string’; you can also change the
face of the separator string (‘todo-done-sep’).
There are also several options for changing the appearance in Todo
Categories mode and Todo Filtered Items mode, beyond those mentioned
above in the sections on these modes; see the customization groups
‘todo-categories’ and ‘todo-filtered’ for details.