todo-mode: Marked Items

 
 7 Marked Items
 **************
 
 For many item editing commands it can make sense and be convenient to
 apply them simultaneously to more than one item in the current category.
 Todo facilitates this by means of marked items.
 
 ‘*’
      Mark the item at point if it is unmarked, and remove the mark it is
      already marked (‘todo-toggle-mark-item’).  The mark is a string
      specified by the option ‘todo-item-mark’ (by default ‘*’) appended
      in front of the item header (more precisely, in front of the item’s
      priority number or prefix; see SeeTodo Display Features, for
      details of the latter).  After marking the current item, the
      command advances point to the next item.  It also accepts a numeric
      prefix argument, which allows toggling the mark of multiple
      consecutive items.
 
 ‘C *’
      Mark all todo items in the current category.
 
 ‘C u’
      Unmark all todo item in the current category.
 
    You can also use the last two commands to mark or unmark all done
 items in the category, but only when only the done items section is
 being displayed, i.e., after invoking ‘C V’ or ‘V’.
 
    The following commands operate on marked items:
 
    • ‘k’ (deleting)
    • ‘m’ (moving to another category)
    • ‘d’ (moving to the done items section; note that ‘C-u d’ adds the
      same comment to all marked items)
    • ‘A d’ (archiving)
    • ‘u’ (both in Todo mode for undoing a done item and in Todo Archive
      mode for unarchiving an item)
    • the commands for editing the item header (those beginning with the
      prefix ‘e d’ as well as ‘e t’, ‘e y’ and ‘e k’)
 
 The item insertion, textual editing and priority changing commands do
 not operate on marked items.
 
    If you use ‘m’, ‘d’, ‘A d’ or ‘u’ on multiple noncontiguous marked
 items, the relocated items retain their relative order but are now
 listed consecutively en bloc.
 
    You can mark both todo and done items, but note that only ‘m’ and ‘k’
 can apply to both; other commands only affect either marked todo or
 marked done items, so if both types of items are marked, invoking these
 commands has no effect and informs you of your erroneous attempt.