X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Ffeatures.texi;h=c1eb41b90f02fb3d115c6399e59d75c136bba2a6;hb=bf96757828d2ae663f5f54147c0e229f74fc9357;hp=9145312fe547e5cd9d8aa74e3068e1776dc27f26;hpb=e2bafe8e0da716b4909da1b192d06c92c4f6260d;p=goredo.git diff --git a/doc/features.texi b/doc/features.texi index 9145312..c1eb41b 100644 --- a/doc/features.texi +++ b/doc/features.texi @@ -1,6 +1,9 @@ @node Features @unnumbered Features +Notable features that differentiate @command{goredo} from many other +implementations. + @itemize @item explicit useful and convenient checks from @command{apenwarr/redo}: @@ -10,13 +13,21 @@ @item check that generated target was not modified "externally" outside the redo, preventing its overwriting, but continuing the build @end itemize +@item recursive, indented and serialized logs display ability, with + priority to the depth and bad return codes, like in @command{apenwarr/redo}, + thanks to @url{https://apenwarr.ca/log/20181106, apenwarr's article} +@item all environment variables, working directory, command line + arguments, start/finish times, duration, participated PIDs, return + codes can be saved for later investigation @item targets, dependency information and their directories are explicitly synced (can be disabled, should work faster) -@item file's change is detected by comparing its @code{ctime} and BLAKE3 hash +@item file's change is detected by comparing its size, @code{ctime} (if + @env{$REDO_INODE_NO_TRUST} environment variable is not set) and + @url{https://github.com/BLAKE3-team/BLAKE3, BLAKE3} hash @item files creation is @code{umask}-friendly (unlike @code{mkstemp()} used in @command{redo-c}) @item parallel build with jobs limit, optionally in infinite mode -@item coloured messages (can be disabled) +@item optional coloured messages @item verbose debug messages, including out-of-date determination, PIDs, lock and jobserver acquirings/releases @item displaying of each target's execution time @@ -28,5 +39,6 @@ @command{tai64nlocal} utility from @url{http://cr.yp.to/daemontools.html, daemontools}, or similar one: @code{go get go.cypherpunks.ru/tai64n/cmd/tai64nlocal} +@item Either GNU Make or bmake @ref{Jobserver, jobserver} compatibility support @end itemize