manuals, sum-down, radix

1 files changed, 41 insertions, 0 deletions

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