-func usage() {
- fmt.Fprintf(os.Stderr, versionGet()+`
-Copyright (C) 2020-2021 Sergey Matveev
-License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>
-This is free software: you are free to change and redistribute it.
-There is NO WARRANTY, to the extent permitted by law.
-
-redo, redo-{always,cleanup,dot,ifchange,ifcreate,log,stamp,whichdo} must
-be linked to goredo executable. It determines the command by its own name.
-You can create them by running: goredo -symlinks.
-
-* redo [options] [target ...]
- forcefully and *sequentially* build specified targets
-* redo-always
- always build current target. Unusable outside .do
-* redo-cleanup [-dry-run] {full,log,tmp} [...]
- remove either all goredo's related temporary files, or kept stderr
- logs, or everything (including .redo directories) related
-* redo-dot target [...]
- write dependency DOT graph to stdout
-* redo-ifchange target [...]
- build specified targets in parallel, if they are changed. Record them
- as dependencies for current target
-* redo-ifcreate target [...]
- record ifcreate dependency for current target. Unusable outside .do
-* redo-log target [ | tai64nlocal ]
- display kept target's stderr with TAI64N timestamped lines. Only the
- last build is kept. You must enable stderr keeping with either -logs,
- or REDO_LOGS=1
-* redo-stamp < [$3]
- record stamp dependency for current target. Unusable outside .do.
- Stamp dependency does not play any role, as all targets are hashed
- anyway
-* redo-whichdo target
- display .do search paths for specified target. Exits successfully
- if the last .do in output if the found existing one
-
-Options:
-`)
+Record ifcreate dependency for current target. Unusable outside .do.`
+ case CmdNameRedoAlways:
+ d = `Usage: redo-always
+
+Always build current target. Unusable outside .do.`
+ case CmdNameRedoCleanup:
+ d = `Usage: redo-cleanup [-n] {full,log,lock,tmp} [...]
+
+Remove either all of goredo's related temporary files, or kept stderr
+logs, or lock files, or everything (including .redo directories) related.`
+ case CmdNameRedoLog:
+ d = `Usage: redo-log [-c] [-r] target [ | tai64nlocal ]
+
+Display kept target's stderr with TAI64N timestamped lines. Only the
+last build is kept. You must enable stderr keeping with either -logs,
+or REDO_LOGS=1. -c option show the exact command invoked, start and
+finish time. -r option recursively and linearly show also all deeper
+redo calls and their logs.`
+ case CmdNameRedoDot:
+ d = `Usage: redo-dot target [...]
+
+Write dependency DOT graph to stdout.`
+ case CmdNameRedoStamp:
+ d = `Usage: redo-stamp < [$3]
+
+Record stamp dependency for current target. Unusable outside .do.
+Stamp dependency does not play any role, as all targets are hashed
+anyway.`
+ case CmdNameRedoWhichdo:
+ d = `Usage: redo-whichdo target
+
+Display .do search paths for specified target. Exits successfully
+if the last .do in output if the found existing one.`
+ case CmdNameRedoTargets:
+ d = `Usage: redo-targets [target ...]
+
+List all currently known targets.`
+ case CmdNameRedoSources:
+ d = `Usage: redo-sources [target ...]
+
+List all currently known source files.`
+ case CmdNameRedoOOD:
+ d = `Usage: redo-ood [target ...]
+
+List all currently known out-of-date targets.`
+ case CmdNameRedoAffects:
+ d = `Usage: redo-affects target [...]
+
+List all targets that will be affected by changing the specified ones.`
+ case CmdNameRedoDep2Rec:
+ d = `Usage: redo-dep2rec .../.redo/file.dep
+
+Convert binary .dep file to recfile and write it to stdout.`
+ case CmdNameRedoDepFix:
+ d = `Usage: redo-depfix
+
+Traverse over all .redo directories beneath and recalculate each target's
+inode and hash information, rewriting dependency files. If dependency has
+legacy .rec format, then it will be converted to .dep one.`
+ case CmdNameRedoInode:
+ d = `Usage: redo-inode target [...]
+
+Just calculate inode information about each target and print in recfile format.`
+ default:
+ d = `Usage: goredo -symlinks
+
+goredo expects to be called through the symbolic link to it.
+Available commands: redo, redo-affects, redo-always, redo-cleanup,
+redo-dep2rec, redo-depfix, redo-dot, redo-ifchange, redo-ifcreate,
+redo-inode, redo-log, redo-ood, redo-sources, redo-stamp,
+redo-targets, redo-whichdo.`
+ }
+ fmt.Fprintf(os.Stderr, "%s\n\nCommon options:\n", d)