manuals, sum-down, radix

1 files changed, 39 insertions, 0 deletions

diff --git a/man/man1/all.1 b/man/man1/all.1
new file mode 100644
index 0000000..28f9597
--- /dev/null
+++ b/man/man1/all.1
@@ -0,0 +1,39 @@
+.TH all 1 2022-05-27 utils
+
+.SH NAME
+all \- logical and operator
+
+.SH SYNOPSIS
+.B all
+.RI [ arg\ ... ]
+
+.SH DESCRIPTION
+.B all
+evaluates each parameter according to the
+.BR bash (1)
+built-in
+.B test
+until the first the evaluates to false.
+Returns true if all parameters evaluate to true, or no paramters are passed.
+Note, however, that the shell may omit parameters
+that would evaluate to false.
+
+Admittedly, this is not as useful as it could be.
+As
+.B all
+does not run any commands, it cannot be used for lazy evaluation.
+
+.SH EXIT STATUS
+.TP
+.B 0
+No parameter evaluates to false.
+.TP
+.B 1
+At least one parameter evaluates to false.
+
+.SH EXAMPLES
+.B all
+"$a" "$b" "$c"
+
+.SH SEE ALSO
+.BR any (1),\  xargs (1),\  map (1),\  fmap (1)