]> Cypherpunks.ru repositories - goredo.git/blobdiff - doc/cmds.texi
redo-depfix
[goredo.git] / doc / cmds.texi
index 144b1189d1acd9ecf688a4ec9f436b0c9ea4b358..b4e7bf575c99413ef7c67df4f9c8a90c3f938114 100644 (file)
@@ -46,12 +46,6 @@ By default all build commands use @code{fsync} to assure data is reached
 the disk. You can disable its usage with @env{$REDO_NO_SYNC=1}
 environment variable, for speeding up the build process.
 
-@command{goredo} determines target is out-of-date by comparing its size,
-@code{ctime} and content's hash, if @code{ctime} differs. Depending on
-the filesystem you use, probably you can not trust its @code{ctime}
-value at all. In that case you can set @env{$REDO_INODE_NO_TRUST=1} to
-forcefully verify the hash.
-
 There are other commands that could be found in other implementations too:
 
 @table @command
@@ -81,6 +75,7 @@ And there are some maintenance and debug commands:
 @item redo-cleanup
     Removes either temporary (@option{tmp}), log files (@option{log}),
     or everything related to @command{goredo} (@option{full}).
+
 @item redo-whichdo
     Display @file{.do} search paths for specified target (similar to
     @command{apenwarr/redo}):
@@ -100,6 +95,7 @@ default.do
 ../default.o.do
 ../default.do
 @end example
+
 @item redo-dot
     Dependency
     @url{https://en.wikipedia.org/wiki/DOT_(graph_description_language), DOT}
@@ -110,4 +106,13 @@ $ redo-dot target [...] > whatever.dot
 $ dot -Tpng whatever.dot > whatever.png # possibly add -Gsplines=ortho
 @end example
 
+@item redo-depfix
+    When you copy your worktree to different place, then copied files
+    ctime will change. And because recorded dependency information
+    differs from updated ctimes, out-of-date algorithm will fallback to
+    rereading the whole files for hash calculation, that is much slower.
+    If you do not want to rebuild your targets from the ground, then
+    @command{redo-depfix} can traverse through all dependency files and
+    check if they have non-altered ctime values and update them in place.
+
 @end table