doc/features.texi

   1 @node Features
   2 @unnumbered Features
   3
   4 Notable features that differentiate @command{goredo} from many other
   5 implementations.
   6
   7 @itemize
   8
   9 @item explicit useful and convenient checks from @command{apenwarr/redo}:
  10     @itemize
  11     @item check that @file{$1} was not touched during .do execution
  12     @item check that @file{stdout} and @file{$3} are not written simultaneously
  13     @item check that generated target was not modified "externally" outside
  14       the redo, preventing its overwriting, but continuing the build
  15     @end itemize
  16 @item targets, dependency information and their directories are explicitly
  17   synced (can be disabled, should work faster)
  18 @item file's change is detected by comparing its size, @code{ctime} (if
  19     @env{REDO_INODE_NO_TRUST} environment variable is not set) and
  20     @url{https://github.com/BLAKE3-team/BLAKE3, BLAKE3} hash
  21 @item files creation is @code{umask}-friendly (unlike @code{mkstemp()}
  22     used in @command{redo-c})
  23 @item parallel build with jobs limit, optionally in infinite mode
  24 @item optional coloured messages
  25 @item verbose debug messages, including out-of-date determination, PIDs,
  26   lock and jobserver acquirings/releases
  27 @item displaying of each target's execution time
  28 @item each target's @file{stderr} can be prefixed with the PID
  29 @item optional statusline with currently running/waiting/done jobs
  30 @item target's @file{stderr} can be stored on the disk with
  31     @url{http://cr.yp.to/libtai/tai64.html, TAI64N} timestamp prefixes
  32     for each line. To convert them to localtime you can use either
  33     @command{tai64nlocal} utility from
  34     @url{http://cr.yp.to/daemontools.html, daemontools}, or similar one:
  35     @code{go get go.cypherpunks.ru/tai64n/cmd/tai64nlocal}
  36 @item Either GNU Make or bmake @ref{Jobserver, jobserver} compatibility support
  37
  38 @end itemize