13.43 guile-tools summarize-guile-TODO

Usage: summarize-guile-TODO TODOFILE

The TODOFILE is a simple text file, in a straightforward outline,
presumed to serve as our signal to ourselves (lest we want real
bosses hassling us) wrt to the overt message "items to do" as well as
the messages that can be inferred from its structure.

This program reads TODOFILE and displays interpretations on its
structure, including registered markers and ownership, in various
ways.

A primary interest in any task is its parent task.  The output
summarization by default lists every item and its parent chain.
Top-level parents are not items.  You can use these command-line
options to modify the selection and display (selection criteria
are ANDed together):

-i, --involved [USER] -- select USER-involved items
-p, --personal [USER] -- select USER-responsible items
-t, --todo            -- select unfinished items (status "-")
-d, --done            -- select finished items (status "+")
-r, --review          -- select review items (marker "R")

-w, --who             -- also show who is associated w/ the item
-n, --no-parent       -- do not show parent chain

If USER is not specified, it defaults to you (your login name).


Usage from a Scheme program:
  (summarize-guile-TODO options todo-file)

Send output to the current output port.  Return value is unspecified.
TODO-FILE is a filename.  OPTIONS is either #f or an alist the keys of
which correspond to the shell command options.


Bugs: (1) Markers are scanned in sequence: D R X N%.  This means "XD"
          and the like are completely dropped.  However, such strings
          are unlikely to be used if the markers are chosen to be
          somewhat exclusive, which is currently the case for D R X.
          N% used w/ these needs to be something like: "D25%" (this
          means discussion accounts for 1/4 of the task).