Download link for 1.2.0 release

[goredo.git] / usage.go

diff --git a/usage.go b/usage.go
index d01d85d95c0461773bf84852bd2718aff283b4a2..affd4540c56254502d11290fbb039fa514e65f99 100644 (file)
--- a/usage.go
+++ b/usage.go
@@ -1,6 +1,6 @@
 /*
 /*

-goredo -- redo implementation on pure Go
-Copyright (C) 2020 Sergey Matveev <stargrave@stargrave.org>
+goredo -- djb's redo implementation on pure Go
+Copyright (C) 2020-2021 Sergey Matveev <stargrave@stargrave.org>

 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by


@@ -26,7 +26,7 @@ import (
 )
 
 const (
 )
 
 const (

-       Version  = "0.1.0"
+       Version  = "1.2.0"

        Warranty = `This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, version 3 of the License.
        Warranty = `This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, version 3 of the License.


@@ -48,22 +48,24 @@ func versionGet() string {
 
 func usage() {
        fmt.Fprintf(os.Stderr, versionGet()+`
 
 func usage() {
        fmt.Fprintf(os.Stderr, versionGet()+`

-Copyright (C) 2020 Sergey Matveev
+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.
 
 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,ifchange,ifcreate,log,stamp,whichdo} must be
-linked to goredo executable. It determines the command by its own name.
+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 ...]
 You can create them by running: goredo -symlinks.
 
 * redo [options] [target ...]

-  forcefully and sequentially build specified targets
+  forcefully and *sequentially* build specified targets

 * redo-always
   always build current target. Unusable outside .do
 * redo-always
   always build current target. Unusable outside .do

-* redo-cleanup {full,log,tmp} [...]
+* 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
   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-ifchange target [...]
   build specified targets in parallel, if they are changed. Record them
   as dependencies for current target


@@ -74,7 +76,9 @@ You can create them by running: goredo -symlinks.
   last build is kept. You must enable stderr keeping with either -logs,
   or REDO_LOGS=1
 * redo-stamp < [$3]
   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
+  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
 * redo-whichdo target
   display .do search paths for specified target. Exits successfully
   if the last .do in output if the found existing one


@@ -85,8 +89,9 @@ Options:
        fmt.Fprintln(os.Stderr, `
 Additional environment variables:
   NO_COLOR -- disable messages colouring
        fmt.Fprintln(os.Stderr, `
 Additional environment variables:
   NO_COLOR -- disable messages colouring

-  REDO_NO_HASH -- disable dependencies (except redo-stamp-ed) hashing

   REDO_NO_SYNC -- disable files/directories explicit filesystem syncing
   REDO_TOP_DIR -- do not search for .do above that directory
   REDO_NO_SYNC -- disable files/directories explicit filesystem syncing
   REDO_TOP_DIR -- do not search for .do above that directory

-                  (it can contain .redo/top as an alternative)`)
+                  (it can contain .redo/top as an alternative)
+  REDO_INODE_NO_TRUST -- do not trust inode information (except for size)
+                         and always check file's hash`)

 }
 }