[manual] Re-generate manuals.

Author: cipriancraciun

documentation/manual/z-run.1.html

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "Z\-RUN" "1" "January 2021" "" ""
+.TH "Z\-RUN" "1" "2021-10-03" "volution.ro" "z-run"
 .
 .SH "NAME"
 \fBz\-run\fR \- lightweight scripts library tool
@@ -224,7 +224,7 @@ expects a single \fB<rpc\-target>\fR, but no other arguments or scriptlet; liste
 \fBz\-run\fR [ \fB<flag>\fR \.\.\. ] \fBexport\-library\-url\fR
 .
 .P
-expects no arguments or scriptlet; writes to \fB/dev/stdout\fR a line suitable for using it as value for the \fB\-\-library\-cache\fR flag; currently it is either a CDB database file \fB<path>\fR or \fB<rpc\-target>\fR; \fBhowever it should always be treated as an opaque value\fR, containing any ASCII character, except control characters, as it might change in future versions;
+expects no arguments or scriptlet; writes to \fB/dev/stdout\fR a line suitable for using it as value for the \fB\-\-library\-url\fR flag; currently it is either a CDB database file \fB<path>\fR or \fB<rpc\-target>\fR; \fBhowever it should always be treated as an opaque value\fR, containing any ASCII character, except control characters, as it might change in future versions;
 .
 .P
 \fBexport\-library\-fingerprint\fR
@@ -317,16 +317,16 @@ these trigger the input execution modes described in the sections above; \fBmust
 specifies a library \fB<source\-path>\fR, that overrides the default library source detection mecanism;
 .
 .P
-\fB\-\-library\-cache=<cache\-url>\fR
+\fB\-\-library\-url=<cache\-url>\fR
 .
 .P
-specifies a library \fB<cache\-url>\fR, either a \fB<cdb\-path>\fR or a \fB<rpc\-target>\fR; specifying both \fB\-\-library\-source=\.\.\.\fR and \fB\-\-library\-cache=\.\.\.\fR is not allowed;
+specifies a library \fB<cache\-url>\fR, either a \fB<cdb\-path>\fR or a \fB<rpc\-target>\fR; specifying both \fB\-\-library\-source=\.\.\.\fR and \fB\-\-library\-url=\.\.\.\fR is not allowed;
 .
 .P
 \fB\-\-workspace=<path>\fR
 .
 .P
-specifies a folder that \fBz\-run\fR switches to before executing; (if no \fB\-\-library\-source=\.\.\.\fR or \fB\-\-library\-cache=\.\.\.\fR is specified, the default library source detection mecanism uses this folder as the root;)
+specifies a folder that \fBz\-run\fR switches to before executing; (if no \fB\-\-library\-source=\.\.\.\fR or \fB\-\-library\-url=\.\.\.\fR is specified, the default library source detection mecanism uses this folder as the root;)
 .
 .P
 \fB\-\-ssh\-target=<ssh\-target>\fR
@@ -368,7 +368,7 @@ an alternative to the \fB\-\-library\-source=\.\.\.\fR flag; never exported insi
 \fBZRUN_LIBRARY_URL\fR
 .
 .P
-an alternative to the \fB\-\-library\-cache=\.\.\.\fR flag; always exported inside the scriptlet execution environment; (never unset it explicitly;)
+an alternative to the \fB\-\-library\-url=\.\.\.\fR flag; always exported inside the scriptlet execution environment; (never unset it explicitly;)
 .
 .P
 \fBZRUN_WORKSPACE\fR
@@ -394,8 +394,6 @@ always exported inside the scriptlet execution environment; (never unset it expl
 .P
 an alternative folder to the default \fB$HOME/\.cache/z\-run\fR, where various files (and pipes, sockets, etc\.) are created; (if explicitly specified, it is exported in the scriptlet execution environment;)
 .
-.P
-.
 .SH "LIBRARY"
 .
 .SS "Library source resolution"

documentation/manual/z-run.1.man

@@ -1,4 +1,4 @@
-Z-RUN(1)							      Z-RUN(1)
+Z-RUN(1)                             z-run                            Z-RUN(1)
 
 
 
@@ -197,11 +197,10 @@ COMMANDS
        z-run [ <flag> ... ] export-library-url
 
        expects no arguments or scriptlet; writes to /dev/stdout a line
-       suitable for using it as value for the --library-url flag; currently
-       it is either a CDB database file <path> or <rpc-target>; however it
-       should always be treated as an opaque value, containing any ASCII
-       character, except control characters, as it might change in future
-       versions;
+       suitable for using it as value for the --library-url flag; currently it
+       is either a CDB database file <path> or <rpc-target>; however it should
+       always be treated as an opaque value, containing any ASCII character,
+       except control characters, as it might change in future versions;
 
        export-library-fingerprint
        z-run [ <flag> ... ] export-library-fingerprint
@@ -402,24 +401,24 @@ NOTES
        What sets z-run aside from a "classical" scripts is:
 
        •   first it allows one to easily mix multiple languages; for example
-	   one can easily write a Bash script that chains together a Python,
-	   Ruby and another Bash script, all within the same file; (with
-	   classical scripts one would have had to create multiple files, one
-	   for each language, and explicitly invoke them via the interpreter;)
+           one can easily write a Bash script that chains together a Python,
+           Ruby and another Bash script, all within the same file; (with
+           classical scripts one would have had to create multiple files, one
+           for each language, and explicitly invoke them via the interpreter;)
 
        •   it allows one to easily bundle together unrelated scripts; for
-	   example say one uses z-run to aid in the development process, then
-	   one could bundle together scripts related to compiling, testing,
-	   deploying, and other single-shot shortcuts in the same file;
-	   (again, with classical scripts, one would have usually put each of
-	   these in separate files, or by using case or function try to manage
-	   them inside a reduced set of files;)
+           example say one uses z-run to aid in the development process, then
+           one could bundle together scripts related to compiling, testing,
+           deploying, and other single-shot shortcuts in the same file;
+           (again, with classical scripts, one would have usually put each of
+           these in separate files, or by using case or function try to manage
+           them inside a reduced set of files;)
 
        •   it allows one to easily invoke scriptlets from within the same
-	   library, without caring what language they are written in, or where
-	   their source code is stored; (with classical scripts one has to
-	   take care of getting the paths to other scripts right, especially
-	   when running from a different folder than the original one;)
+           library, without caring what language they are written in, or where
+           their source code is stored; (with classical scripts one has to
+           take care of getting the paths to other scripts right, especially
+           when running from a different folder than the original one;)
 
 
 
@@ -428,40 +427,40 @@ NOTES
        functionalities:
 
        •   environment variables management -- by allowing certain environment
-	   variables to be overriden, removed or appended (like in the case of
-	   $PATH); (with classical scripts one has to manage these by
-	   themselves, resort to various "envdir" tools, or interact with
-	   shell magic;)
+           variables to be overriden, removed or appended (like in the case of
+           $PATH); (with classical scripts one has to manage these by
+           themselves, resort to various "envdir" tools, or interact with
+           shell magic;)
 
        •   hierarchical menus -- by simply calling z-run without any
-	   arguments, it presents one with a selectable menu of all the
-	   scriptlets in the library, and after one selects a scriptlet it
-	   executes it; moreover one can group various scriptlets under other
-	   sub-menus, thus allowing arbitrary nesting and navigation; (when
-	   used from a terminal, z-run uses and embedded fzf-based UI; when
-	   used from outside a terminal, z-run tries to use z-run--select (any
-	   system), rofi or dmenu (under Linux and BSD´s) or choose (under
-	   OSX);)
+           arguments, it presents one with a selectable menu of all the
+           scriptlets in the library, and after one selects a scriptlet it
+           executes it; moreover one can group various scriptlets under other
+           sub-menus, thus allowing arbitrary nesting and navigation; (when
+           used from a terminal, z-run uses and embedded fzf-based UI; when
+           used from outside a terminal, z-run tries to use z-run--select (any
+           system), rofi or dmenu (under Linux and BSD´s) or choose (under
+           OSX);)
 
        •   SSH-based remote execution -- one can easily execute a given
-	   scriptlet on a remote server without having to previously copy
-	   anything there; moreover once the scriptlet is executing on the
-	   remote server, it can invoke other scriptlets from the library that
-	   are also to be executed remotely; (the only requirement is having
-	   z-run installed on the remote machine;)
+           scriptlet on a remote server without having to previously copy
+           anything there; moreover once the scriptlet is executing on the
+           remote server, it can invoke other scriptlets from the library that
+           are also to be executed remotely; (the only requirement is having
+           z-run installed on the remote machine;)
 
        •   scriptlets generation -- one can easily write a scriptlet that
-	   generates z-run compliant source, thus generating other scriptlets
-	   based on arbitrary criteria; (for example one could write a
-	   scriptlet, that generates other scriptlets specific for each file
-	   in a given folder;)
+           generates z-run compliant source, thus generating other scriptlets
+           based on arbitrary criteria; (for example one could write a
+           scriptlet, that generates other scriptlets specific for each file
+           in a given folder;)
 
        •   library compiling -- one can easily create a single file that
-	   contains the entire library, which can then be moved and used in
-	   another place;
+           contains the entire library, which can then be moved and used in
+           another place;
 
        •   Go-based templates -- that are useful especially in generating
-	   other scriptlets;
+           other scriptlets;
 
 
 
@@ -475,12 +474,12 @@ NOTES
        conditions are met:
 
        •   any of the files that comprise the source code of the library are
-	   changed; (based both on file timestamps and contents hashing;)
+           changed; (based both on file timestamps and contents hashing;)
 
        •   any of the environment variables change;
 
        •   a different version of z-run is installed; (this covers both
-	   upgrading and downgrading;)
+           upgrading and downgrading;)
 
 
 
@@ -495,4 +494,4 @@ EXAMPLES
 
 
 
-				 January 2021			      Z-RUN(1)
+volution.ro                       2021-10-03                          Z-RUN(1)

documentation/manual/z-run.1.md renamed to documentation/manual/z-run.1.ronn

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "Z\-RUN" "1" "January 2021" "" ""
+.TH "Z\-RUN" "1" "2021-10-03" "volution.ro" "z-run"
 .
 .SH "NAME"
 \fBz\-run\fR \- lightweight scripts library tool
@@ -224,7 +224,7 @@ expects a single \fB<rpc\-target>\fR, but no other arguments or scriptlet; liste
 \fBz\-run\fR [ \fB<flag>\fR \.\.\. ] \fBexport\-library\-url\fR
 .
 .P
-expects no arguments or scriptlet; writes to \fB/dev/stdout\fR a line suitable for using it as value for the \fB\-\-library\-cache\fR flag; currently it is either a CDB database file \fB<path>\fR or \fB<rpc\-target>\fR; \fBhowever it should always be treated as an opaque value\fR, containing any ASCII character, except control characters, as it might change in future versions;
+expects no arguments or scriptlet; writes to \fB/dev/stdout\fR a line suitable for using it as value for the \fB\-\-library\-url\fR flag; currently it is either a CDB database file \fB<path>\fR or \fB<rpc\-target>\fR; \fBhowever it should always be treated as an opaque value\fR, containing any ASCII character, except control characters, as it might change in future versions;
 .
 .P
 \fBexport\-library\-fingerprint\fR
@@ -317,16 +317,16 @@ these trigger the input execution modes described in the sections above; \fBmust
 specifies a library \fB<source\-path>\fR, that overrides the default library source detection mecanism;
 .
 .P
-\fB\-\-library\-cache=<cache\-url>\fR
+\fB\-\-library\-url=<cache\-url>\fR
 .
 .P
-specifies a library \fB<cache\-url>\fR, either a \fB<cdb\-path>\fR or a \fB<rpc\-target>\fR; specifying both \fB\-\-library\-source=\.\.\.\fR and \fB\-\-library\-cache=\.\.\.\fR is not allowed;
+specifies a library \fB<cache\-url>\fR, either a \fB<cdb\-path>\fR or a \fB<rpc\-target>\fR; specifying both \fB\-\-library\-source=\.\.\.\fR and \fB\-\-library\-url=\.\.\.\fR is not allowed;
 .
 .P
 \fB\-\-workspace=<path>\fR
 .
 .P
-specifies a folder that \fBz\-run\fR switches to before executing; (if no \fB\-\-library\-source=\.\.\.\fR or \fB\-\-library\-cache=\.\.\.\fR is specified, the default library source detection mecanism uses this folder as the root;)
+specifies a folder that \fBz\-run\fR switches to before executing; (if no \fB\-\-library\-source=\.\.\.\fR or \fB\-\-library\-url=\.\.\.\fR is specified, the default library source detection mecanism uses this folder as the root;)
 .
 .P
 \fB\-\-ssh\-target=<ssh\-target>\fR
@@ -368,7 +368,7 @@ an alternative to the \fB\-\-library\-source=\.\.\.\fR flag; never exported insi
 \fBZRUN_LIBRARY_URL\fR
 .
 .P
-an alternative to the \fB\-\-library\-cache=\.\.\.\fR flag; always exported inside the scriptlet execution environment; (never unset it explicitly;)
+an alternative to the \fB\-\-library\-url=\.\.\.\fR flag; always exported inside the scriptlet execution environment; (never unset it explicitly;)
 .
 .P
 \fBZRUN_WORKSPACE\fR
@@ -394,8 +394,6 @@ always exported inside the scriptlet execution environment; (never unset it expl
 .P
 an alternative folder to the default \fB$HOME/\.cache/z\-run\fR, where various files (and pipes, sockets, etc\.) are created; (if explicitly specified, it is exported in the scriptlet execution environment;)
 .
-.P
-.
 .SH "LIBRARY"
 .
 .SS "Library source resolution"