notes.texi

   1 @node Notes
   2 @unnumbered Implementation notes
   3
   4 @itemize
   5
   6 @item @file{all} target is default
   7 @item @file{stdout} is always captured, but no target is created if it
   8     was empty
   9 @item empty targets are considered always out of date
  10 @item @file{.do}'s @file{$3} is relative path to the file in target directory
  11 @item @file{.do} search goes up to @file{/} by default, but can be
  12     limited with either @env{$REDO_TOP_DIR} environment variable, or by
  13     having @file{.redo/top} file in it
  14 @item target's completion messages are written after they finish
  15 @item executable @file{.do} is run as is, non-executable is run with
  16     @code{/bin/sh -e[x]}
  17 @item tracing (-x) can be obviously done only for non-executable @file{.do}
  18 @item parallizable build is done only during @command{redo-ifchange} for
  19     human convenience: you can globally enable @env{REDO_JOBS}, but
  20     still do for example: @code{redo htmls infos index upload}
  21
  22 @end itemize