aboutsummaryrefslogtreecommitdiff
path: root/man/expr.1
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-07-28 15:54:54 +1000
committerSoccera1 <[email protected]>2026-07-28 15:54:54 +1000
commit6a2f098e72e71437154ec00506e8e736aa8e1026 (patch)
tree63e9f5596be38558dbeb40bb566735759a3ccabb /man/expr.1
parenta753f669c9bedfccb9f7f400da018bb487dca5d0 (diff)
downloadbnu-6a2f098e72e71437154ec00506e8e736aa8e1026.tar.gz
bnu-6a2f098e72e71437154ec00506e8e736aa8e1026.zip
Add docs
Diffstat (limited to 'man/expr.1')
-rw-r--r--man/expr.1113
1 files changed, 113 insertions, 0 deletions
diff --git a/man/expr.1 b/man/expr.1
new file mode 100644
index 0000000..4c29959
--- /dev/null
+++ b/man/expr.1
@@ -0,0 +1,113 @@
+.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
+.TH EXPR "1" "2026-07-28" "BNU 9.11" "BNU Commands"
+.SH NAME
+expr \- evaluate expressions
+.SH SYNOPSIS
+.B expr
+\fI\,EXPRESSION\/\fR
+.br
+.B expr
+\fI\,OPTION\/\fR
+.SH DESCRIPTION
+.\" This page is derived from GNU Coreutils documentation.
+This page documents BNU, an independent Bun implementation compatible with
+GNU Coreutils 9.11.
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/expr#expr--help'\fB\-\-help\fP\X'tty: link'
+display this help and exit
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/expr#expr--version'\fB\-\-version\fP\X'tty: link'
+output version information and exit
+.PP
+Print the value of EXPRESSION to standard output. A blank line below
+separates increasing precedence groups. EXPRESSION may be:
+.TP
+ARG1 | ARG2
+ARG1 if it is neither null nor 0, otherwise ARG2
+.TP
+ARG1 & ARG2
+ARG1 if neither argument is null or 0, otherwise 0
+.TP
+ARG1 < ARG2
+ARG1 is less than ARG2
+.TP
+ARG1 <= ARG2
+ARG1 is less than or equal to ARG2
+.TP
+ARG1 = ARG2
+ARG1 is equal to ARG2
+.TP
+ARG1 != ARG2
+ARG1 is unequal to ARG2
+.TP
+ARG1 >= ARG2
+ARG1 is greater than or equal to ARG2
+.TP
+ARG1 > ARG2
+ARG1 is greater than ARG2
+.TP
+ARG1 + ARG2
+arithmetic sum of ARG1 and ARG2
+.TP
+ARG1 \- ARG2
+arithmetic difference of ARG1 and ARG2
+.TP
+ARG1 * ARG2
+arithmetic product of ARG1 and ARG2
+.TP
+ARG1 / ARG2
+arithmetic quotient of ARG1 divided by ARG2
+.TP
+ARG1 % ARG2
+arithmetic remainder of ARG1 divided by ARG2
+.TP
+STRING : REGEXP
+anchored pattern match of REGEXP in STRING
+.TP
+match STRING REGEXP
+same as STRING : REGEXP
+.TP
+substr STRING POS LENGTH
+substring of STRING, POS counted from 1
+.TP
+index STRING CHARS
+index in STRING where any CHARS is found, or 0
+.TP
+length STRING
+length of STRING
+.TP
++ TOKEN
+interpret TOKEN as a string, even if it is a
+keyword like 'match' or an operator like '/'
+.TP
+( EXPRESSION )
+value of EXPRESSION
+.PP
+Beware that many operators need to be escaped or quoted for shells.
+Comparisons are arithmetic if both ARGs are numbers, else lexicographical.
+Pattern matches return the string matched between \e( and \e) or null; if
+\e( and \e) are not used, they return the number of characters matched or 0.
+.PP
+Exit status is 0 if EXPRESSION is neither null nor 0, 1 if EXPRESSION is null
+or 0, 2 if EXPRESSION is syntactically invalid, and 3 if an error occurred.
+.SH AUTHORS
+Upstream GNU Coreutils documentation authors:
+Written by Mike Parker, James Youngman, and Paul Eggert.
+.br
+Adapted for BNU; the BNU implementation is independent.
+.SH "REPORTING BUGS"
+Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
+.br
+For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>.
+.SH COPYRIGHT
+Copyright \(co 2026 Free Software Foundation, Inc.
+.br
+This manual page was adapted for BNU in 2026.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+Upstream documentation <https://www.gnu.org/software/coreutils/expr>
+.br
+BNU documentation is available locally via: info \(aq(bnu) expr invocation\(aq