From 6a2f098e72e71437154ec00506e8e736aa8e1026 Mon Sep 17 00:00:00 2001 From: Soccera1 <129828376+Soccera1@users.noreply.github.com> Date: Tue, 28 Jul 2026 15:54:54 +1000 Subject: Add docs --- man/expr.1 | 113 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 man/expr.1 (limited to 'man/expr.1') 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 . +.br +For upstream GNU Coreutils, see . +.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 . +.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 +.br +BNU documentation is available locally via: info \(aq(bnu) expr invocation\(aq -- cgit v1.3