diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/[.1 | 26 | ||||
| -rw-r--r-- | man/arch.1 | 43 | ||||
| -rw-r--r-- | man/b2sum.1 | 93 | ||||
| -rw-r--r-- | man/base32.1 | 62 | ||||
| -rw-r--r-- | man/base64.1 | 62 | ||||
| -rw-r--r-- | man/basename.1 | 71 | ||||
| -rw-r--r-- | man/basenc.1 | 116 | ||||
| -rw-r--r-- | man/bnu.1 | 68 | ||||
| -rw-r--r-- | man/cat.1 | 82 | ||||
| -rw-r--r-- | man/chcon.1 | 96 | ||||
| -rw-r--r-- | man/chgrp.1 | 103 | ||||
| -rw-r--r-- | man/chmod.1 | 204 | ||||
| -rw-r--r-- | man/chown.1 | 130 | ||||
| -rw-r--r-- | man/chroot.1 | 67 | ||||
| -rw-r--r-- | man/cksum.1 | 125 | ||||
| -rw-r--r-- | man/comm.1 | 83 | ||||
| -rw-r--r-- | man/coreutils.1 | 42 | ||||
| -rw-r--r-- | man/cp.1 | 204 | ||||
| -rw-r--r-- | man/csplit.1 | 84 | ||||
| -rw-r--r-- | man/cut.1 | 97 | ||||
| -rw-r--r-- | man/date.1 | 282 | ||||
| -rw-r--r-- | man/dd.1 | 183 | ||||
| -rw-r--r-- | man/df.1 | 127 | ||||
| -rw-r--r-- | man/dir.1 | 271 | ||||
| -rw-r--r-- | man/dircolors.1 | 57 | ||||
| -rw-r--r-- | man/dirname.1 | 57 | ||||
| -rw-r--r-- | man/du.1 | 168 | ||||
| -rw-r--r-- | man/echo.1 | 100 | ||||
| -rw-r--r-- | man/env.1 | 137 | ||||
| -rw-r--r-- | man/expand.1 | 61 | ||||
| -rw-r--r-- | man/expr.1 | 113 | ||||
| -rw-r--r-- | man/factor.1 | 44 | ||||
| -rw-r--r-- | man/false.1 | 47 | ||||
| -rw-r--r-- | man/fmt.1 | 67 | ||||
| -rw-r--r-- | man/fold.1 | 59 | ||||
| -rw-r--r-- | man/ginstall.1 | 18 | ||||
| -rw-r--r-- | man/groups.1 | 44 | ||||
| -rw-r--r-- | man/head.1 | 70 | ||||
| -rw-r--r-- | man/hostid.1 | 43 | ||||
| -rw-r--r-- | man/hostname.1 | 43 | ||||
| -rw-r--r-- | man/id.1 | 68 | ||||
| -rw-r--r-- | man/install.1 | 145 | ||||
| -rw-r--r-- | man/join.1 | 104 | ||||
| -rw-r--r-- | man/kill.1 | 68 | ||||
| -rw-r--r-- | man/link.1 | 46 | ||||
| -rw-r--r-- | man/ln.1 | 124 | ||||
| -rw-r--r-- | man/logname.1 | 43 | ||||
| -rw-r--r-- | man/ls.1 | 271 | ||||
| -rw-r--r-- | man/md5sum.1 | 90 | ||||
| -rw-r--r-- | man/mkdir.1 | 63 | ||||
| -rw-r--r-- | man/mkfifo.1 | 55 | ||||
| -rw-r--r-- | man/mknod.1 | 73 | ||||
| -rw-r--r-- | man/mktemp.1 | 71 | ||||
| -rw-r--r-- | man/mv.1 | 128 | ||||
| -rw-r--r-- | man/nice.1 | 67 | ||||
| -rw-r--r-- | man/nl.1 | 110 | ||||
| -rw-r--r-- | man/nohup.1 | 66 | ||||
| -rw-r--r-- | man/nproc.1 | 51 | ||||
| -rw-r--r-- | man/numfmt.1 | 196 | ||||
| -rw-r--r-- | man/od.1 | 177 | ||||
| -rw-r--r-- | man/paste.1 | 58 | ||||
| -rw-r--r-- | man/pathchk.1 | 49 | ||||
| -rw-r--r-- | man/pinky.1 | 71 | ||||
| -rw-r--r-- | man/pr.1 | 136 | ||||
| -rw-r--r-- | man/printenv.1 | 48 | ||||
| -rw-r--r-- | man/printf.1 | 111 | ||||
| -rw-r--r-- | man/ptx.1 | 99 | ||||
| -rw-r--r-- | man/pwd.1 | 55 | ||||
| -rw-r--r-- | man/readlink.1 | 76 | ||||
| -rw-r--r-- | man/realpath.1 | 73 | ||||
| -rw-r--r-- | man/rm.1 | 119 | ||||
| -rw-r--r-- | man/rmdir.1 | 53 | ||||
| -rw-r--r-- | man/runcon.1 | 87 | ||||
| -rw-r--r-- | man/seq.1 | 69 | ||||
| -rw-r--r-- | man/sha1sum.1 | 90 | ||||
| -rw-r--r-- | man/sha224sum.1 | 86 | ||||
| -rw-r--r-- | man/sha256sum.1 | 86 | ||||
| -rw-r--r-- | man/sha384sum.1 | 86 | ||||
| -rw-r--r-- | man/sha512sum.1 | 86 | ||||
| -rw-r--r-- | man/shred.1 | 87 | ||||
| -rw-r--r-- | man/shuf.1 | 71 | ||||
| -rw-r--r-- | man/sleep.1 | 48 | ||||
| -rw-r--r-- | man/sm3sum.1 | 86 | ||||
| -rw-r--r-- | man/sort.1 | 163 | ||||
| -rw-r--r-- | man/split.1 | 117 | ||||
| -rw-r--r-- | man/stat.1 | 230 | ||||
| -rw-r--r-- | man/stdbuf.1 | 88 | ||||
| -rw-r--r-- | man/stty.1 | 420 | ||||
| -rw-r--r-- | man/sum.1 | 49 | ||||
| -rw-r--r-- | man/sync.1 | 55 | ||||
| -rw-r--r-- | man/tac.1 | 58 | ||||
| -rw-r--r-- | man/tail.1 | 108 | ||||
| -rw-r--r-- | man/tee.1 | 71 | ||||
| -rw-r--r-- | man/test.1 | 191 | ||||
| -rw-r--r-- | man/timeout.1 | 95 | ||||
| -rw-r--r-- | man/touch.1 | 89 | ||||
| -rw-r--r-- | man/tr.1 | 151 | ||||
| -rw-r--r-- | man/true.1 | 47 | ||||
| -rw-r--r-- | man/truncate.1 | 71 | ||||
| -rw-r--r-- | man/tsort.1 | 42 | ||||
| -rw-r--r-- | man/tty.1 | 43 | ||||
| -rw-r--r-- | man/uname.1 | 71 | ||||
| -rw-r--r-- | man/unexpand.1 | 64 | ||||
| -rw-r--r-- | man/uniq.1 | 89 | ||||
| -rw-r--r-- | man/unlink.1 | 46 | ||||
| -rw-r--r-- | man/uptime.1 | 44 | ||||
| -rw-r--r-- | man/users.1 | 44 | ||||
| -rw-r--r-- | man/vdir.1 | 271 | ||||
| -rw-r--r-- | man/wc.1 | 77 | ||||
| -rw-r--r-- | man/who.1 | 91 | ||||
| -rw-r--r-- | man/whoami.1 | 41 | ||||
| -rw-r--r-- | man/yes.1 | 43 |
112 files changed, 10664 insertions, 0 deletions
@@ -0,0 +1,26 @@ +.TH "[" "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +[ \- evaluate a conditional expression +.SH SYNOPSIS +.B [ +\fI\,EXPRESSION \/\fR] +.br +.B [ ] +.br +.B [ +\fI\,OPTION\/\fR +.SH DESCRIPTION +.B [ +is BNU's alternate form of +.BR test (1). +The closing bracket must be a separate final operand. To request help or +version information, omit the closing bracket and use +.B [ --help +or +.BR "[ --version" . +.SH "REPORTING BUGS" +Report BNU bugs at <https://github.com/Soccera1/bnu/issues>. +.SH "SEE ALSO" +.BR test (1) +.PP +BNU documentation is available locally via: info \(aq(bnu) test invocation\(aq diff --git a/man/arch.1 b/man/arch.1 new file mode 100644 index 0000000..df19cdd --- /dev/null +++ b/man/arch.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH ARCH "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +arch \- print machine hardware name (same as uname -m) +.SH SYNOPSIS +.B arch +[\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. +.PP +Print machine architecture. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/arch#arch--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/arch#arch--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Karel Zak. +.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" +\fBuname\fP(1), \fBuname\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/arch> +.br +BNU documentation is available locally via: info \(aq(bnu) arch invocation\(aq diff --git a/man/b2sum.1 b/man/b2sum.1 new file mode 100644 index 0000000..53ab540 --- /dev/null +++ b/man/b2sum.1 @@ -0,0 +1,93 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH B2SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +b2sum \- compute and check BLAKE2 message digest +.SH SYNOPSIS +.B b2sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check BLAKE2b (512\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-l'\fB\-l, \-\-length=\,BITS\fP\X'tty: link'\/\fR +digest length in bits; must not exceed the max size +and must be a multiple of 8 for blake2b; +must be 224, 256, 384, or 512 for sha2 or sha3 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in RFC 7693. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady and Samuel Neves. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/b2sum> +.br +BNU documentation is available locally via: info \(aq(bnu) b2sum invocation\(aq diff --git a/man/base32.1 b/man/base32.1 new file mode 100644 index 0000000..6395ad8 --- /dev/null +++ b/man/base32.1 @@ -0,0 +1,62 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH BASE32 "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +base32 \- base32 encode/decode data and print to standard output +.SH SYNOPSIS +.B base32 +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Base32 encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base32-d'\fB\-d, \-\-decode\fP\X'tty: link' +decode data +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base32-i'\fB\-i, \-\-ignore\-garbage\fP\X'tty: link' +when decoding, ignore non\-alphabet characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base32-w'\fB\-w, \-\-wrap=\,COLS\fP\X'tty: link'\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\X'tty: link https://www.gnu.org/software/coreutils/base32#base32--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/base32#base32--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The data are encoded as described for the base32 alphabet in RFC 4648. +When decoding, the input may contain newlines in addition to the bytes of +the formal base32 alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Simon Josefsson. +.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" +\fBbasenc\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/base32> +.br +BNU documentation is available locally via: info \(aq(bnu) base32 invocation\(aq diff --git a/man/base64.1 b/man/base64.1 new file mode 100644 index 0000000..368b387 --- /dev/null +++ b/man/base64.1 @@ -0,0 +1,62 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH BASE64 "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +base64 \- base64 encode/decode data and print to standard output +.SH SYNOPSIS +.B base64 +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Base64 encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base64-d'\fB\-d, \-\-decode\fP\X'tty: link' +decode data +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base64-i'\fB\-i, \-\-ignore\-garbage\fP\X'tty: link' +when decoding, ignore non\-alphabet characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#base64-w'\fB\-w, \-\-wrap=\,COLS\fP\X'tty: link'\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\X'tty: link https://www.gnu.org/software/coreutils/base64#base64--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/base64#base64--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The data are encoded as described for the base64 alphabet in RFC 4648. +When decoding, the input may contain newlines in addition to the bytes of +the formal base64 alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Simon Josefsson. +.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" +\fBbasenc\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/base64> +.br +BNU documentation is available locally via: info \(aq(bnu) base64 invocation\(aq diff --git a/man/basename.1 b/man/basename.1 new file mode 100644 index 0000000..8c9bd7e --- /dev/null +++ b/man/basename.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH BASENAME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +basename \- strip directory and suffix from filenames +.SH SYNOPSIS +.B basename +\fI\,NAME \/\fR[\fI\,SUFFIX\/\fR] +.br +.B basename +\fI\,OPTION\/\fR... \fI\,NAME\/\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. +.PP +Print NAME with any leading directory components removed. +If specified, also remove a trailing SUFFIX. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-a'\fB\-a, \-\-multiple\fP\X'tty: link' +support multiple arguments and treat each as a NAME +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-s'\fB\-s, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +remove a trailing SUFFIX; implies \fB\-a\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/basename#basename--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/basename#basename--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH EXAMPLES +.TP +basename /usr/bin/sort +\-> "sort" +.TP +basename include/stdio.h .h +\-> "stdio" +.TP +basename \-s .h include/stdio.h +\-> "stdio" +.TP +basename \-a any/str1 any/str2 +\-> "str1" followed by "str2" +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBdirname\fP(1), \fBreadlink\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/basename> +.br +BNU documentation is available locally via: info \(aq(bnu) basename invocation\(aq diff --git a/man/basenc.1 b/man/basenc.1 new file mode 100644 index 0000000..a4929e9 --- /dev/null +++ b/man/basenc.1 @@ -0,0 +1,116 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH BASENC "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +basenc \- Encode/decode data and print to standard output +.SH SYNOPSIS +.B basenc +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +basenc encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base64'\fB\-\-base64\fP\X'tty: link' +same as 'base64' program (RFC4648 section 4) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base64url'\fB\-\-base64url\fP\X'tty: link' +file\- and url\-safe base64 (RFC4648 section 5) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base58'\fB\-\-base58\fP\X'tty: link' +visually unambiguous base58 encoding +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base32'\fB\-\-base32\fP\X'tty: link' +same as 'base32' program (RFC4648 section 6) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base32hex'\fB\-\-base32hex\fP\X'tty: link' +extended hex alphabet base32 (RFC4648 section 7) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base16'\fB\-\-base16\fP\X'tty: link' +hex encoding (RFC4648 section 8) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base2msbf'\fB\-\-base2msbf\fP\X'tty: link' +bit string with most significant bit (msb) first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--base2lsbf'\fB\-\-base2lsbf\fP\X'tty: link' +bit string with least significant bit (lsb) first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc-d'\fB\-d, \-\-decode\fP\X'tty: link' +decode data +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc-i'\fB\-i, \-\-ignore\-garbage\fP\X'tty: link' +when decoding, ignore non\-alphabet characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc-w'\fB\-w, \-\-wrap=\,COLS\fP\X'tty: link'\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basenc--z85'\fB\-\-z85\fP\X'tty: link' +ascii85\-like encoding (ZeroMQ spec:32/Z85); +when encoding, input length must be a multiple of 4; +when decoding, input length must be a multiple of 5 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/basenc#basenc--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/basenc#basenc--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +When decoding, the input may contain newlines in addition to the bytes of +the formal alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH "ENCODING EXAMPLES" +.PP +.nf +.RS +$ printf '\\376\\117\\202' | basenc \-\-base64 +/k+C + +$ printf '\\376\\117\\202' | basenc \-\-base64url +_k-C + +$ printf '\\376\\117\\202' | basenc \-\-base32 +7ZHYE=== + +$ printf '\\376\\117\\202' | basenc \-\-base32hex +VP7O4=== + +$ printf '\\376\\117\\202' | basenc \-\-base16 +FE4F82 + +$ printf '\\376\\117\\202' | basenc \-\-base2lsbf +011111111111001001000001 + +$ printf '\\376\\117\\202' | basenc \-\-base2msbf +111111100100111110000010 + +$ printf '\\376\\117\\202\\000' | basenc \-\-z85 +.RE +.fi +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Simon Josefsson and Assaf Gordon. +.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/basenc> +.br +BNU documentation is available locally via: info \(aq(bnu) basenc invocation\(aq diff --git a/man/bnu.1 b/man/bnu.1 new file mode 100644 index 0000000..f2d995f --- /dev/null +++ b/man/bnu.1 @@ -0,0 +1,68 @@ +.TH BNU "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +bnu \- run a BNU core utility +.SH SYNOPSIS +.B bnu +\fI\,COMMAND \/\fR[\fI\,ARG\fR]... +.br +.B bnu +[\fB\-\-help\fR|\fB\-\-version\fR] +.SH DESCRIPTION +BNU is an independent implementation of the GNU Coreutils 9.11 +command\-line interface for the Bun runtime. +.PP +The first operand selects a utility. The remaining operands are passed to +that utility. Run +.B bnu \-\-help +to list the implemented commands, or run +.I COMMAND +.B \-\-help +to see command-specific help. +.PP +Utilities may also be invoked through command-name wrappers generated with: +.PP +.RS +bun run link\-commands \-\- DIRECTORY +.RE +.PP +For compatibility with the GNU Coreutils multi-call interface, the +.B coreutils +command accepts +.BR \-\-coreutils\-prog= PROGRAM_NAME . +.SH OPTIONS +.TP +.B \-\-help +display the usage and implemented command list, then exit +.TP +.B \-\-version +output BNU version information, then exit +.SH ENVIRONMENT +.TP +.B GNULY_CORRECT +When set to a truthy value such as +.BR 1 , +emit GNU-compatible diagnostics without BNU's additional +.B Hint: +lines. An empty value, +.BR 0 , +or any capitalization of +.B false +leaves friendly hints enabled. This changes diagnostic wording, not command +semantics. +.SH FILES +.TP +.I bin/bnu.js +multi-call entry point in a source checkout +.TP +.I src/coreutils.js +command implementations in a source checkout +.SH "REPORTING BUGS" +Report BNU bugs at <https://github.com/Soccera1/bnu/issues>. +.SH COPYRIGHT +BNU is distributed under the GNU General Public License version 3. See the +.I LICENSE +file in the source distribution. +.SH "SEE ALSO" +.BR coreutils (1) +.PP +The complete adapted manual is available locally via: info \(aqbnu\(aq diff --git a/man/cat.1 b/man/cat.1 new file mode 100644 index 0000000..041ce92 --- /dev/null +++ b/man/cat.1 @@ -0,0 +1,82 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CAT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +cat \- concatenate files and print on the standard output +.SH SYNOPSIS +.B cat +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Concatenate FILE(s) to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-A'\fB\-A, \-\-show\-all\fP\X'tty: link' +equivalent to \fB\-vET\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-b'\fB\-b, \-\-number\-nonblank\fP\X'tty: link' +number nonempty output lines, overrides \fB\-n\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-e'\fB\-e\fP\X'tty: link' +equivalent to \fB\-vE\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-E'\fB\-E, \-\-show\-ends\fP\X'tty: link' +display $ or ^M$ at end of each line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-n'\fB\-n, \-\-number\fP\X'tty: link' +number all output lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-s'\fB\-s, \-\-squeeze\-blank\fP\X'tty: link' +suppress repeated empty output lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-t'\fB\-t\fP\X'tty: link' +equivalent to \fB\-vT\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-T'\fB\-T, \-\-show\-tabs\fP\X'tty: link' +display TAB characters as ^I +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-u'\fB\-u\fP\X'tty: link' +(ignored) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cat-v'\fB\-v, \-\-show\-nonprinting\fP\X'tty: link' +use ^ and M\- notation, except for LFD and TAB +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cat#cat--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cat#cat--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH EXAMPLES +.TP +cat f \- g +Output f's contents, then standard input, then g's contents. +.TP +cat +Copy standard input to standard output. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Torbjorn Granlund and Richard M. Stallman. +.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" +\fBtac\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/cat> +.br +BNU documentation is available locally via: info \(aq(bnu) cat invocation\(aq diff --git a/man/chcon.1 b/man/chcon.1 new file mode 100644 index 0000000..22cf19e --- /dev/null +++ b/man/chcon.1 @@ -0,0 +1,96 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CHCON "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +chcon \- change file security context +.SH SYNOPSIS +.B chcon +[\fI\,OPTION\/\fR]... \fI\,CONTEXT FILE\/\fR... +.br +.B chcon +[\fI\,OPTION\/\fR]... [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-l RANGE\/\fR] [\fI\,-t TYPE\/\fR] \fI\,FILE\/\fR... +.br +.B chcon +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\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. +.PP +Change the SELinux security context of each FILE to CONTEXT. +With \fB\-\-reference\fR, change the security context of each FILE to that of RFILE. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon--dereference'\fB\-\-dereference\fP\X'tty: link' +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-h'\fB\-h, \-\-no\-dereference\fP\X'tty: link' +affect symbolic links instead of any referenced file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-u'\fB\-u, \-\-user=\,USER\fP\X'tty: link'\/\fR +set user USER in the target security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-r'\fB\-r, \-\-role=\,ROLE\fP\X'tty: link'\/\fR +set role ROLE in the target security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-t'\fB\-t, \-\-type=\,TYPE\fP\X'tty: link'\/\fR +set type TYPE in the target security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-l'\fB\-l, \-\-range=\,RANGE\fP\X'tty: link'\/\fR +set range RANGE in the target security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon--no-preserve-root'\fB\-\-no\-preserve\-root\fP\X'tty: link' +do not treat '/' specially (the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon--preserve-root'\fB\-\-preserve\-root\fP\X'tty: link' +fail to operate recursively on '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon--reference'\fB\-\-reference=RFILE\fP\X'tty: link' +use RFILE's security context rather than specifying a CONTEXT value +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-R'\fB\-R, \-\-recursive\fP\X'tty: link' +operate on files and directories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-v'\fB\-v, \-\-verbose\fP\X'tty: link' +output a diagnostic for every file processed +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. \fB\-P\fR is the default. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-H'\fB\-H\fP\X'tty: link' +if a command line argument is a symlink to a directory, traverse it +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-L'\fB\-L\fP\X'tty: link' +traverse every symbolic link to a directory encountered +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chcon-P'\fB\-P\fP\X'tty: link' +do not traverse any symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chcon#chcon--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chcon#chcon--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Russell Coker and Jim Meyering. +.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/chcon> +.br +BNU documentation is available locally via: info \(aq(bnu) chcon invocation\(aq diff --git a/man/chgrp.1 b/man/chgrp.1 new file mode 100644 index 0000000..b35353f --- /dev/null +++ b/man/chgrp.1 @@ -0,0 +1,103 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CHGRP "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +chgrp \- change group ownership +.SH SYNOPSIS +.B chgrp +[\fI\,OPTION\/\fR]... \fI\,GROUP FILE\/\fR... +.br +.B chgrp +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\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. +.PP +Change the group of each FILE to GROUP. +With \fB\-\-reference\fR, change the group of each FILE to that of RFILE. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-c'\fB\-c, \-\-changes\fP\X'tty: link' +like verbose but report only when a change is made +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-f'\fB\-f, \-\-silent, \-\-quiet\fP\X'tty: link' +suppress most error messages +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-v'\fB\-v, \-\-verbose\fP\X'tty: link' +output a diagnostic for every file processed +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp--dereference'\fB\-\-dereference\fP\X'tty: link' +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-h'\fB\-h, \-\-no\-dereference\fP\X'tty: link' +affect symbolic links instead of any referenced file; +useful only on systems that can change the ownership of a symlink +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp--from'\fB\-\-from=CURRENT_OWNER:CURRENT_GROUP\fP\X'tty: link' +change the ownership of each file only if its +current owner and/or group match those specified here. +Either may be omitted, in which case a match +is not required for the omitted attribute +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp--no-preserve-root'\fB\-\-no\-preserve\-root\fP\X'tty: link' +do not treat '/' specially (the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp--preserve-root'\fB\-\-preserve\-root\fP\X'tty: link' +fail to operate recursively on '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp--reference'\fB\-\-reference=RFILE\fP\X'tty: link' +use RFILE's ownership rather than specifying values. +RFILE is always dereferenced if a symbolic link. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-R'\fB\-R, \-\-recursive\fP\X'tty: link' +operate on files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. \fB\-P\fR is the default. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-H'\fB\-H\fP\X'tty: link' +if a command line argument is a symlink to a directory, traverse it +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-L'\fB\-L\fP\X'tty: link' +traverse every symbolic link to a directory encountered +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chgrp-P'\fB\-P\fP\X'tty: link' +do not traverse any symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chgrp#chgrp--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chgrp#chgrp--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH EXAMPLES +.TP +chgrp staff /u +Change the group of /u to "staff". +.TP +chgrp \-hR staff /u +Change the group of /u and subfiles to "staff". +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Jim Meyering. +.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" +\fBchown\fP(1), \fBchown\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/chgrp> +.br +BNU documentation is available locally via: info \(aq(bnu) chgrp invocation\(aq diff --git a/man/chmod.1 b/man/chmod.1 new file mode 100644 index 0000000..6027107 --- /dev/null +++ b/man/chmod.1 @@ -0,0 +1,204 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CHMOD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +chmod \- change file mode bits +.SH SYNOPSIS +.B chmod +[\fI\,OPTION\/\fR]... \fI\,MODE\/\fR[\fI\,,MODE\/\fR]... \fI\,FILE\/\fR... +.br +.B chmod +[\fI\,OPTION\/\fR]... \fI\,OCTAL-MODE FILE\/\fR... +.br +.B chmod +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\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. +This manual page +describes the BNU implementation of +.BR chmod . +.B chmod +changes the file mode bits of each given file according to +.IR mode , +which can be either a symbolic representation of changes to make, or +an octal number representing the bit pattern for the new mode bits. +.PP +The format of a symbolic mode is [\c +\fBugoa\fP.\|.\|.][[\fB-+=\fP][\fIperms\fP.\|.\|.].\|.\|.], +where +.I "perms" +is either zero or more letters from the set +\fBrwxXst\fP, or a single letter from the set \fBugo\fP. +Multiple symbolic +modes can be given, separated by commas. +.PP +A combination of the letters \fBugoa\fP controls which users' access +to the file will be changed: the user who owns it (\fBu\fP), other +users in the file's group (\fBg\fP), other users not in the file's +group (\fBo\fP), or all users (\fBa\fP). If none of these are given, +the effect is as if (\fBa\fP) were +given, but bits that are set in the umask are not affected. +.PP +The operator \fB+\fP causes the selected file mode bits to be added to +the existing file mode bits of each file; \fB-\fP causes them to be +removed; and \fB=\fP causes them to be added and causes unmentioned +bits to be removed except that a directory's unmentioned set user and +group ID bits are not affected. +.PP +The letters \fBrwxXst\fP select file mode bits for the affected users: +read (\fBr\fP), write (\fBw\fP), execute (or search for directories) +(\fBx\fP), execute/search only if the file is a directory or already +has execute permission for some user (\fBX\fP), set user or group ID +on execution (\fBs\fP), restricted deletion flag or sticky bit +(\fBt\fP). Instead of one or more of these letters, you can specify +exactly one of the letters \fBugo\fP: the permissions granted to the +user who owns the file (\fBu\fP), the permissions granted to other +users who are members of the file's group (\fBg\fP), +and the permissions granted to users that are in neither of the two preceding +categories (\fBo\fP). +.PP +A numeric mode is from one to four octal digits (0\-7), derived by +adding up the bits with values 4, 2, and 1. Omitted digits are +assumed to be leading zeros. +The first digit selects the set user ID (4) and set group ID (2) and +restricted deletion or sticky (1) attributes. The second digit +selects permissions for the user who owns the file: read (4), write (2), +and execute (1); the third selects permissions for other users in the +file's group, with the same values; and the fourth for other users not +in the file's group, with the same values. +.PP +.B chmod +doesn't change the permissions of symbolic links; the +.B chmod +system call cannot change their permissions on most systems, +and most systems ignore permissions of symbolic links. +However, for each symbolic link listed on the command line, +.B chmod +changes the permissions of the pointed-to file. +In contrast, +.B chmod +ignores symbolic links encountered during recursive directory +traversals. Options that modify this behavior are described in the +.B OPTIONS +section. +.SH "SETUID AND SETGID BITS" +.B chmod +clears the set-group-ID bit of a +regular file if the file's group ID does not match the user's +effective group ID or one of the user's supplementary group IDs, +unless the user has appropriate privileges. Additional restrictions +may cause the set-user-ID and set-group-ID bits of +.I MODE +or +.I RFILE +to be ignored. This behavior depends on the policy and +functionality of the underlying +.B chmod +system call. When in +doubt, check the underlying system behavior. +.PP +For directories +.B chmod +preserves set-user-ID and set-group-ID bits unless you +explicitly specify otherwise. You can set or clear the bits with +symbolic modes like +.B u+s +and +.BR g\-s . +To clear these bits for directories with a numeric mode requires +an additional leading zero like +.BR 00755 , +leading minus like +.BR \-6000 , +or leading equals like +.BR =755 . +.SH "RESTRICTED DELETION FLAG OR STICKY BIT" +The restricted deletion flag or sticky bit is a single bit, whose +interpretation depends on the file type. For directories, it prevents +unprivileged users from removing or renaming a file in the directory +unless they own the file or the directory; this is called the +.I "restricted deletion flag" +for the directory, and is commonly found on world-writable directories +like \fB/tmp\fP. For regular files on some older systems, the bit +saves the program's text image on the swap device so it will load more +quickly when run; this is called the +.IR "sticky bit" . +.SH OPTIONS +.PP +Change the mode of each FILE to MODE. +With \fB\-\-reference\fR, change the mode of each FILE to that of RFILE. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-c'\fB\-c, \-\-changes\fP\X'tty: link' +like verbose but report only when a change is made +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-f'\fB\-f, \-\-silent, \-\-quiet\fP\X'tty: link' +suppress most error messages +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-v'\fB\-v, \-\-verbose\fP\X'tty: link' +output a diagnostic for every file processed +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod--dereference'\fB\-\-dereference\fP\X'tty: link' +affect the referent of each symbolic link, +rather than the symbolic link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-h'\fB\-h, \-\-no\-dereference\fP\X'tty: link' +affect each symbolic link, rather than the referent +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod--no-preserve-root'\fB\-\-no\-preserve\-root\fP\X'tty: link' +do not treat '/' specially (the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod--preserve-root'\fB\-\-preserve\-root\fP\X'tty: link' +fail to operate recursively on '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod--reference'\fB\-\-reference=RFILE\fP\X'tty: link' +use RFILE's mode instead of specifying MODE values. +RFILE is always dereferenced if a symbolic link. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-R'\fB\-R, \-\-recursive\fP\X'tty: link' +change files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. \fB\-H\fR is the default. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-H'\fB\-H\fP\X'tty: link' +if a command line argument is a symlink to a directory, traverse it +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-L'\fB\-L\fP\X'tty: link' +traverse every symbolic link to a directory encountered +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chmod-P'\fB\-P\fP\X'tty: link' +do not traverse any symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chmod#chmod--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chmod#chmod--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Each MODE is of the form '[ugoa]*([\-+=]([rwxXst]*|[ugo]))+|[\-+=][0\-7]+'. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Jim Meyering. +.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" +\fBchmod\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/chmod> +.br +BNU documentation is available locally via: info \(aq(bnu) chmod invocation\(aq diff --git a/man/chown.1 b/man/chown.1 new file mode 100644 index 0000000..6ffd848 --- /dev/null +++ b/man/chown.1 @@ -0,0 +1,130 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CHOWN "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +chown \- change file owner and group +.SH SYNOPSIS +.B chown +[\fI\,OPTION\/\fR]... [\fI\,OWNER\/\fR][\fI\,:\/\fR[\fI\,GROUP\/\fR]] \fI\,FILE\/\fR... +.br +.B chown +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\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. +This manual page +describes the BNU implementation of +.BR chown . +.B chown +changes the user and/or group ownership of each given file. If +only an owner (a user name or numeric user ID) is given, that user is made the +owner of each given file, and the files' group is not changed. If the +owner is followed by a colon and a group name (or numeric group ID), +with no spaces between them, the group ownership of the files is +changed as well. If a colon but no group name follows the user name, +that user is made the owner of the files and the group of the files is +changed to that user's login group. If the colon and group are given, +but the owner is omitted, only the group of the files is changed; +in this case, +.B chown +performs the same function as +.BR chgrp . +If only a colon is given, or if the entire operand is empty, neither the +owner nor the group is changed. +.SH OPTIONS +.PP +Change the owner and/or group of each FILE to OWNER and/or GROUP. +With \fB\-\-reference\fR, change the owner and group of each FILE to those of RFILE. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-c'\fB\-c, \-\-changes\fP\X'tty: link' +like verbose but report only when a change is made +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-f'\fB\-f, \-\-silent, \-\-quiet\fP\X'tty: link' +suppress most error messages +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-v'\fB\-v, \-\-verbose\fP\X'tty: link' +output a diagnostic for every file processed +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown--dereference'\fB\-\-dereference\fP\X'tty: link' +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-h'\fB\-h, \-\-no\-dereference\fP\X'tty: link' +affect symbolic links instead of any referenced file; +useful only on systems that can change the ownership of a symlink +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown--from'\fB\-\-from=CURRENT_OWNER:CURRENT_GROUP\fP\X'tty: link' +change the ownership of each file only if its +current owner and/or group match those specified here. +Either may be omitted, in which case a match +is not required for the omitted attribute +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown--no-preserve-root'\fB\-\-no\-preserve\-root\fP\X'tty: link' +do not treat '/' specially (the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown--preserve-root'\fB\-\-preserve\-root\fP\X'tty: link' +fail to operate recursively on '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown--reference'\fB\-\-reference=RFILE\fP\X'tty: link' +use RFILE's ownership rather than specifying values. +RFILE is always dereferenced if a symbolic link. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-R'\fB\-R, \-\-recursive\fP\X'tty: link' +operate on files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. \fB\-P\fR is the default. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-H'\fB\-H\fP\X'tty: link' +if a command line argument is a symlink to a directory, traverse it +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-L'\fB\-L\fP\X'tty: link' +traverse every symbolic link to a directory encountered +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chown-P'\fB\-P\fP\X'tty: link' +do not traverse any symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chown#chown--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chown#chown--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Owner is unchanged if missing. Group is unchanged if missing, but changed +to login group if implied by a ':' following a symbolic OWNER. +OWNER and GROUP may be numeric as well as symbolic. +.SH EXAMPLES +.TP +chown root /u +Change the owner of /u to "root". +.TP +chown root:staff /u +Likewise, but also change its group to "staff". +.TP +chown \-hR root /u +Change the owner of /u and subfiles to "root". +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Jim Meyering. +.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" +\fBchown\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/chown> +.br +BNU documentation is available locally via: info \(aq(bnu) chown invocation\(aq diff --git a/man/chroot.1 b/man/chroot.1 new file mode 100644 index 0000000..79385c0 --- /dev/null +++ b/man/chroot.1 @@ -0,0 +1,67 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CHROOT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +chroot \- run command or interactive shell with special root directory +.SH SYNOPSIS +.B chroot +[\fI\,OPTION\/\fR]... \fI\,NEWROOT \/\fR[\fI\,COMMAND \/\fR[\fI\,ARG\/\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. +.PP +Run COMMAND with root directory set to NEWROOT. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--groups'\fB\-\-groups=G_LIST\fP\X'tty: link' +specify supplementary groups as g1,g2,..,gN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--userspec'\fB\-\-userspec=USER:GROUP\fP\X'tty: link' +specify user and group (ID or name) to use +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--skip-chdir'\fB\-\-skip\-chdir\fP\X'tty: link' +do not change working directory to '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If no command is given, run '"$SHELL" \fB\-i\fR' (default: '/bin/sh \fB\-i\fR'). +.SS "Exit status:" +.TP +125 +if the chroot command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Roland McGrath. +.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" +\fBchroot\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/chroot> +.br +BNU documentation is available locally via: info \(aq(bnu) chroot invocation\(aq diff --git a/man/cksum.1 b/man/cksum.1 new file mode 100644 index 0000000..967cfbd --- /dev/null +++ b/man/cksum.1 @@ -0,0 +1,125 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CKSUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +cksum \- compute and verify file checksums +.SH SYNOPSIS +.B cksum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or verify checksums. +By default use the 32 bit CRC algorithm. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-a'\fB\-a, \-\-algorithm=\,TYPE\fP\X'tty: link'\/\fR +select the digest type to use. See DIGEST below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--base64'\fB\-\-base64\fP\X'tty: link' +emit base64\-encoded digests, not hexadecimal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-l'\fB\-l, \-\-length=\,BITS\fP\X'tty: link'\/\fR +digest length in bits; must not exceed the max size +and must be a multiple of 8 for blake2b; +must be 224, 256, 384, or 512 for sha2 or sha3 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--raw'\fB\-\-raw\fP\X'tty: link' +emit a raw binary digest, not hexadecimal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum (the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--untagged'\fB\-\-untagged\fP\X'tty: link' +create a reversed style checksum, without digest type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--debug'\fB\-\-debug\fP\X'tty: link' +indicate which implementation used +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "DIGEST determines the digest algorithm and default output format:" +.TP +sysv +(equivalent to sum \fB\-s\fR) +.TP +bsd +(equivalent to sum \fB\-r\fR) +.TP +crc +(equivalent to cksum) +.TP +crc32b +(only available through cksum) +.TP +md5 +(equivalent to md5sum) +.TP +sha1 +(equivalent to sha1sum) +.TP +sha2 +(equivalent to sha{224,256,384,512}sum) +.TP +sha3 +(only available through cksum) +.TP +blake2b +(equivalent to b2sum) +.TP +sm3 +(only available through cksum) +.PP +When checking, the input should be a former output of this program, +or equivalent standalone program. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady and Q. Frank Xia. +.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/cksum> +.br +BNU documentation is available locally via: info \(aq(bnu) cksum invocation\(aq diff --git a/man/comm.1 b/man/comm.1 new file mode 100644 index 0000000..fc53430 --- /dev/null +++ b/man/comm.1 @@ -0,0 +1,83 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH COMM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +comm \- compare two sorted files line by line +.SH SYNOPSIS +.B comm +[\fI\,OPTION\/\fR]... \fI\,FILE1 FILE2\/\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. +.PP +Compare sorted files FILE1 and FILE2 line by line. +.PP +When FILE1 or FILE2 (not both) is \-, read standard input. +.PP +With no options, produce three\-column output. Column one contains +lines unique to FILE1, column two contains lines unique to FILE2, +and column three contains lines common to both files. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm-1'\fB\-1\fP\X'tty: link' +suppress column 1 (lines unique to FILE1) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm-2'\fB\-2\fP\X'tty: link' +suppress column 2 (lines unique to FILE2) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm-3'\fB\-3\fP\X'tty: link' +suppress column 3 (lines that appear in both files) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm--check-order'\fB\-\-check\-order\fP\X'tty: link' +check that the input is correctly sorted, +even if all input lines are pairable +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm--nocheck-order'\fB\-\-nocheck\-order\fP\X'tty: link' +do not check that the input is correctly sorted +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm--output-delimiter'\fB\-\-output\-delimiter=STR\fP\X'tty: link' +separate columns with STR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm--total'\fB\-\-total\fP\X'tty: link' +output a summary +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#comm-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/comm#comm--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/comm#comm--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Comparisons honor the rules specified by 'LC_COLLATE'. +.SH EXAMPLES +.TP +comm \-12 file1 file2 +Print only lines present in both file1 and file2. +.TP +comm \-3 file1 file2 +Print lines in file1 not in file2, and vice versa. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.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" +\fBjoin\fP(1), \fBuniq\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/comm> +.br +BNU documentation is available locally via: info \(aq(bnu) comm invocation\(aq diff --git a/man/coreutils.1 b/man/coreutils.1 new file mode 100644 index 0000000..e71cd3d --- /dev/null +++ b/man/coreutils.1 @@ -0,0 +1,42 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH COREUTILS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +coreutils \- single binary for coreutils programs +.SH SYNOPSIS +.B coreutils +\fI\,--coreutils-prog=PROGRAM_NAME \/\fR[\fI\,PARAMETERS\/\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. +.PP +Execute the PROGRAM_NAME built\-in program with the given PARAMETERS. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/coreutils#coreutils--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/coreutils#coreutils--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Use: 'coreutils \fB\-\-coreutils\-prog\fR=\fI\,PROGRAM_NAME\/\fR \fB\-\-help\fR' for individual program help. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Alex Deymo. +.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/coreutils> +.br +BNU documentation is available locally via: info \(aq(bnu) Multi\-call invocation\(aq diff --git a/man/cp.1 b/man/cp.1 new file mode 100644 index 0000000..9ac4176 --- /dev/null +++ b/man/cp.1 @@ -0,0 +1,204 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CP "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +cp \- copy files and directories +.SH SYNOPSIS +.B cp +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B cp +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B cp +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\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. +.PP +Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-a'\fB\-a, \-\-archive\fP\X'tty: link' +same as \fB\-dR\fR \fB\-\-preserve\fR=\fI\,all\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--attributes-only'\fB\-\-attributes\-only\fP\X'tty: link' +don't copy the file data, just the attributes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link' +make a backup of each existing destination file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-b'\fB\-b\fP\X'tty: link' +like \fB\-\-backup\fR but does not accept an argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--copy-contents'\fB\-\-copy\-contents\fP\X'tty: link' +copy contents of special files when recursive +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-d'\fB\-d\fP\X'tty: link' +same as \fB\-\-no\-dereference\fR \fB\-\-preserve\fR=\fI\,links\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--debug'\fB\-\-debug\fP\X'tty: link' +explain how a file is copied. Implies \fB\-v\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-f'\fB\-f, \-\-force\fP\X'tty: link' +if an existing destination file cannot be opened, remove it and try +again (this option is ignored when the \fB\-n\fR option is also used) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-i'\fB\-i, \-\-interactive\fP\X'tty: link' +prompt before overwrite (overrides a previous \fB\-n\fR option) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-H'\fB\-H\fP\X'tty: link' +follow command\-line symbolic links in SOURCE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-L'\fB\-L, \-\-dereference\fP\X'tty: link' +always follow symbolic links in SOURCE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-P'\fB\-P, \-\-no\-dereference\fP\X'tty: link' +never follow symbolic links in SOURCE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--keep-directory-symlink'\fB\-\-keep\-directory\-symlink\fP\X'tty: link' +follow existing symlinks to directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-l'\fB\-l, \-\-link\fP\X'tty: link' +hard link files instead of copying +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-n'\fB\-n, \-\-no\-clobber\fP\X'tty: link' +(deprecated) silently skip existing files. See also \fB\-\-update\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-p'\fB\-p\fP\X'tty: link' +same as \fB\-\-preserve\fR=\fI\,mode,ownership,timestamps\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--preserve'\fB\-\-preserve[=ATTR_LIST]\fP\X'tty: link' +preserve the specified attributes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--no-preserve'\fB\-\-no\-preserve=ATTR_LIST\fP\X'tty: link' +don't preserve the specified attributes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--parents'\fB\-\-parents\fP\X'tty: link' +use full source file name under DIRECTORY +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-R'\fB\-R, \-r, \-\-recursive\fP\X'tty: link' +copy directories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--reflink'\fB\-\-reflink[=WHEN]\fP\X'tty: link' +control clone/CoW copies. See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--remove-destination'\fB\-\-remove\-destination\fP\X'tty: link' +remove each existing destination file before attempting to open it +(contrast with \fB\-\-force\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--sparse'\fB\-\-sparse=WHEN\fP\X'tty: link' +control creation of sparse files. See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--strip-trailing-slashes'\fB\-\-strip\-trailing\-slashes\fP\X'tty: link' +remove any trailing slashes from each SOURCE argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-s'\fB\-s, \-\-symbolic\-link\fP\X'tty: link' +make symbolic links instead of copying +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +override the usual backup suffix +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR +copy all SOURCE arguments into DIRECTORY +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link' +treat DEST as a normal file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--update'\fB\-\-update[=UPDATE]\fP\X'tty: link' +control which existing files are updated; +UPDATE={all,none,none\-fail,older(default)} +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-u'\fB\-u\fP\X'tty: link' +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-v'\fB\-v, \-\-verbose\fP\X'tty: link' +explain what is being done +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-x'\fB\-x, \-\-one\-file\-system\fP\X'tty: link' +stay on this file system +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp-Z'\fB\-Z\fP\X'tty: link' +set SELinux security context of destination file to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cp--context'\fB\-\-context[=CTX]\fP\X'tty: link' +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cp#cp--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cp#cp--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +ATTR_LIST is a comma\-separated list of attributes. Attributes are 'mode' for +permissions (including any ACL and xattr permissions), 'ownership' for user +and group, 'timestamps' for file timestamps, 'links' for hard links, 'context' +for security context, 'xattr' for extended attributes, and 'all' for all +attributes. +.PP +By default, sparse SOURCE files are detected by a crude heuristic and the +corresponding DEST file is made sparse as well. That is the behavior +selected by \fB\-\-sparse\fR=\fI\,auto\/\fR. Specify \fB\-\-sparse\fR=\fI\,always\/\fR to create a sparse DEST +file whenever the SOURCE file contains a long enough sequence of zero bytes. +Use \fB\-\-sparse\fR=\fI\,never\/\fR to inhibit creation of sparse files. +.PP +UPDATE controls which existing files in the destination are replaced. +\&'all' is the default operation when an \fB\-\-update\fR option is not specified, +and results in all existing files in the destination being replaced. +\&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, and skipped files do not induce a failure. +\&'none\-fail' also ensures no files are replaced in the destination, +but any skipped files are diagnosed and induce a failure. +\&'older' is the default operation when \fB\-\-update\fR is specified, and results +in files being replaced if they're older than the corresponding source file. +.PP +By default or with \fB\-\-reflink\fR=\fI\,auto\/\fR, cp will try a lightweight copy, where the +data blocks are copied only when modified, falling back to a standard copy +if this is not possible. With \fB\-\-reflink\fR[=\fI\,always\/\fR] cp will fail if CoW is not +supported, while \fB\-\-reflink\fR=\fI\,never\/\fR ensures a standard copy is performed. +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.PP +As a special case, cp makes a backup of SOURCE when the force and backup +options are given and SOURCE and DEST are the same name for an existing, +regular file. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Torbjorn Granlund, David MacKenzie, and Jim Meyering. +.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" +\fBinstall\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/cp> +.br +BNU documentation is available locally via: info \(aq(bnu) cp invocation\(aq diff --git a/man/csplit.1 b/man/csplit.1 new file mode 100644 index 0000000..1e0b812 --- /dev/null +++ b/man/csplit.1 @@ -0,0 +1,84 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CSPLIT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +csplit \- split a file into sections determined by context lines +.SH SYNOPSIS +.B csplit +[\fI\,OPTION\/\fR]... \fI\,FILE PATTERN\/\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. +.PP +Output pieces of FILE separated by PATTERN(s) to files 'xx00', 'xx01', ..., +and output byte counts of each piece to standard output. +.PP +Read standard input if FILE is \- +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-b'\fB\-b, \-\-suffix\-format=\,FORMAT\fP\X'tty: link'\/\fR +use sprintf FORMAT instead of %02d +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-f'\fB\-f, \-\-prefix=\,PREFIX\fP\X'tty: link'\/\fR +use PREFIX instead of 'xx' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-k'\fB\-k, \-\-keep\-files\fP\X'tty: link' +do not remove output files on errors +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit--suppress-matched'\fB\-\-suppress\-matched\fP\X'tty: link' +suppress the lines matching PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-n'\fB\-n, \-\-digits=\,DIGITS\fP\X'tty: link'\/\fR +use specified number of digits instead of 2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-s'\fB\-s, \-\-quiet, \-\-silent\fP\X'tty: link' +do not print counts of output file sizes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-z'\fB\-z, \-\-elide\-empty\-files\fP\X'tty: link' +suppress empty output files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/csplit#csplit--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/csplit#csplit--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "Each PATTERN may be:" +.TP +INTEGER +copy up to but not including specified line number +.TP +/REGEXP/[OFFSET] +copy up to but not including a matching line +.TP +%REGEXP%[OFFSET] +skip to, but not including a matching line +.TP +{INTEGER} +repeat the previous pattern specified number of times +.TP +{*} +repeat the previous pattern as many times as possible +.PP +A line OFFSET is an integer optionally preceded by '+' or '\-' +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Stuart Kemp and David MacKenzie. +.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/csplit> +.br +BNU documentation is available locally via: info \(aq(bnu) csplit invocation\(aq diff --git a/man/cut.1 b/man/cut.1 new file mode 100644 index 0000000..a8be226 --- /dev/null +++ b/man/cut.1 @@ -0,0 +1,97 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH CUT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +cut \- remove sections from each line of files +.SH SYNOPSIS +.B cut +\fI\,OPTION\/\fR... [\fI\,FILE\/\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. +.PP +Print selected parts of lines from each FILE to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-b'\fB\-b, \-\-bytes=\,LIST\fP\X'tty: link'\/\fR +select only these byte positions +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-c'\fB\-c, \-\-characters=\,LIST\fP\X'tty: link'\/\fR +select only these character positions +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut--complement'\fB\-\-complement\fP\X'tty: link' +complement the set of selected bytes, characters or fields +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-d'\fB\-d, \-\-delimiter=\,DELIM\fP\X'tty: link'\/\fR +use DELIM instead of TAB for field delimiter +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-f'\fB\-f, \-\-fields=\,LIST\fP\X'tty: link'\/\fR +select only these fields; also print any line that contains +no delimiter character, unless the \fB\-s\fR option is specified +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-F'\fB\-F LIST\fP\X'tty: link' +like \fB\-f\fR, but also implies \fB\-w\fR and \fB\-O\fR ' ' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-n'\fB\-n, \-\-no\-partial\fP\X'tty: link' +with \fB\-b\fR, don't output partial multi\-byte characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-O'\fB\-O, \-\-output\-delimiter=\,STRING\fP\X'tty: link'\/\fR +use STRING as the output delimiter; +the default is to use the input delimiter +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-s'\fB\-s, \-\-only\-delimited\fP\X'tty: link' +do not print lines not containing delimiters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-w'\fB\-w, \-\-whitespace\-delimited[=\,trimmed]\fP\X'tty: link'\/\fR +use a run of blank characters as the field delimiter; +with 'trimmed', ignore leading and trailing blanks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cut#cut--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cut#cut--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Use one, and only one of \fB\-b\fR, \fB\-c\fR, \fB\-f\fR or \fB\-F\fR. Each LIST is made up of one +range, or many ranges separated by commas. Selected input is written +in the same order that it is read, and is written exactly once. +Each range is one of: +.TP +N +N'th byte, character or field, counted from 1 +.TP +N\- +from N'th byte, character or field, to end of line +.TP +N\-M +from N'th to M'th (included) byte, character or field +.TP +\fB\-M\fR +from first to M'th (included) byte, character or field +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David M. Ihnat, David MacKenzie, and Jim Meyering. +.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/cut> +.br +BNU documentation is available locally via: info \(aq(bnu) cut invocation\(aq diff --git a/man/date.1 b/man/date.1 new file mode 100644 index 0000000..775bd51 --- /dev/null +++ b/man/date.1 @@ -0,0 +1,282 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DATE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.\" Define monospaced roman font for groff in troff mode. +.if t .if \n(.g \{\ +. ds mono \f(CR +. ds /mono \fP +.\} +.SH NAME +date \- print or set the system date and time +.SH SYNOPSIS +.B date +[\fI\,OPTION\/\fR]... [\fB+\fR\fI\,FORMAT\/\fR] +.br +.B date +[\fI\,OPTION\/\fR]... \ +\fIMMDDhhmm\/\fR[[\fI\,CC\/\fR]\fI\,YY\/\fR][\fB.\fI\,ss\/\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. +.PP +Display date and time in the given FORMAT. +With \fB\-s\fR, or with MMDDhhmm[[CC]YY][.ss], set the date and time first. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-d'\fB\-d, \-\-date=\,STRING\fP\X'tty: link'\/\fR +display time described by STRING, not 'now' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date--debug'\fB\-\-debug\fP\X'tty: link' +annotate the parsed date, +and warn about questionable usage to standard error +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-f'\fB\-f, \-\-file=\,DATEFILE\fP\X'tty: link'\/\fR +like \fB\-\-date\fR; once for each line of DATEFILE; +if DATEFILE is \-, read names from standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-I'\fB\-I[FMT], \-\-iso\-8601[=\,FMT]\fP\X'tty: link'\/\fR +output date/time in ISO 8601 format. +FMT='date' (default), 'hours', 'minutes', 'seconds', or 'ns' +for date and time to the indicated precision. +Example: 2006\-08\-14T02:34:56\-06:00 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date--resolution'\fB\-\-resolution\fP\X'tty: link' +output the available resolution of timestamps. +Example: 0.000000001 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-R'\fB\-R, \-\-rfc\-email\fP\X'tty: link' +output date and time in RFC 5322 format. +Example: Mon, 14 Aug 2006 02:34:56 +0000 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date--rfc-3339'\fB\-\-rfc\-3339=FMT\fP\X'tty: link' +output date/time in RFC 3339 format. +FMT='date', 'seconds', or 'ns' +for date and time to the indicated precision. +Example: 2006\-08\-14 02:34:56\-06:00 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-r'\fB\-r, \-\-reference=\,FILE\fP\X'tty: link'\/\fR +display the last modification time of FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-s'\fB\-s, \-\-set=\,STRING\fP\X'tty: link'\/\fR +set time described by STRING +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#date-u'\fB\-u, \-\-utc, \-\-universal\fP\X'tty: link' +print or set Coordinated Universal Time (UTC) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/date#date--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/date#date--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +All options that specify the date to display are mutually exclusive. +I.e.: \fB\-\-date\fR, \fB\-\-file\fR, \fB\-\-reference\fR, \fB\-\-resolution\fR. +.PP +FORMAT controls the output. Interpreted sequences are: +.TP +%% +a literal % +.TP +%a +locale's abbreviated weekday name (e.g., Sun) +.TP +%A +locale's full weekday name (e.g., Sunday) +.TP +%b +locale's abbreviated month name (e.g., Jan) +.TP +%B +locale's full month name (e.g., January) +.TP +%c +locale's date and time (e.g., Thu Mar 3 23:05:25 2005) +.TP +%C +century; like %Y, except omit last two digits (e.g., 20) +.TP +%d +day of month (e.g., 01) +.TP +%D +date (ambiguous); same as %m/%d/%y +.TP +%e +day of month, space padded; same as %_d +.TP +%F +full date; like %+4Y\-%m\-%d +.TP +%g +last two digits of year of ISO week number (ambiguous; 00\-99); see %G +.TP +%G +year of ISO week number; normally useful only with %V +.TP +%h +same as %b +.TP +%H +hour (00..23) +.TP +%I +hour (01..12) +.TP +%j +day of year (001..366) +.TP +%k +hour, space padded ( 0..23); same as %_H +.TP +%l +hour, space padded ( 1..12); same as %_I +.TP +%m +month (01..12) +.TP +%M +minute (00..59) +.TP +%n +a newline +.TP +%N +nanoseconds (000000000..999999999) +.TP +%p +locale's equivalent of either AM or PM; blank if not known +.TP +%P +like %p, but lower case +.TP +%q +quarter of year (1..4) +.TP +%r +locale's 12\-hour clock time (e.g., 11:11:04 PM) +.TP +%R +24\-hour hour and minute; same as %H:%M +.TP +%s +seconds since the Epoch (1970\-01\-01 00:00 UTC) +.TP +%S +second (00..60) +.TP +%t +a tab +.TP +%T +time; same as %H:%M:%S +.TP +%u +day of week (1..7); 1 is Monday +.TP +%U +week number of year, with Sunday as first day of week (00..53) +.TP +%V +ISO week number, with Monday as first day of week (01..53) +.TP +%w +day of week (0..6); 0 is Sunday +.TP +%W +week number of year, with Monday as first day of week (00..53) +.TP +%x +locale's date (can be ambiguous; e.g., 12/31/99) +.TP +%X +locale's time representation (e.g., 23:13:48) +.TP +%y +last two digits of year (ambiguous; 00..99) +.TP +%Y +year +.TP +%z ++hhmm numeric time zone (e.g., \fB\-0400\fR) +.TP +%:z ++hh:mm numeric time zone (e.g., \fB\-04\fR:00) +.TP +%::z ++hh:mm:ss numeric time zone (e.g., \fB\-04\fR:00:00) +.TP +%:::z +numeric time zone with : to necessary precision (e.g., \fB\-04\fR, +05:30) +.TP +%Z +alphabetic time zone abbreviation (e.g., EDT) +.PP +By default, date pads numeric fields with zeroes. +The following optional flags may follow '%': +.TP +\- +(hyphen) do not pad the field +.TP +_ +(underscore) pad with spaces +.TP +0 +(zero) pad with zeros +.TP ++ +pad with zeros, and put '+' before future years with >4 digits +.TP +^ +use upper case if possible +.TP +# +use opposite case if possible +.PP +After any flags comes an optional field width, as a decimal number; +then an optional modifier, which is either +E to use the locale's alternate representations if available, or +O to use the locale's alternate numeric symbols if available. +.SH EXAMPLES +Convert seconds since the Epoch (1970\-01\-01 UTC) to a date +.IP +\*[mono]$ date --date='@2147483647'\*[/mono] +.PP +Show the time on the west coast of the US (use \fBtzselect\fP(1) to find TZ) +.IP +\*[mono]$ TZ='America/Los_Angeles' date\*[/mono] +.PP +Show the local time for 9AM next Friday on the west coast of the US +.IP +\*[mono]$ date --date='TZ="America/Los_Angeles" 09:00 next Fri'\*[/mono] +.SH "DATE STRING" +.\" NOTE: keep this paragraph in sync with the one in touch.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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/date> +.br +BNU documentation is available locally via: info \(aq(bnu) date invocation\(aq diff --git a/man/dd.1 b/man/dd.1 new file mode 100644 index 0000000..dbe9163 --- /dev/null +++ b/man/dd.1 @@ -0,0 +1,183 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +dd \- convert and copy a file +.SH SYNOPSIS +.B dd +[\fI\,OPERAND\/\fR]... +.br +.B dd +\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. +.PP +Copy a file, converting and formatting according to the operands. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddbs'\fBbs=BYTES\fP\X'tty: link' +read and write up to BYTES bytes at a time (default: 512); +overrides ibs and obs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcbs'\fBcbs=BYTES\fP\X'tty: link' +convert BYTES bytes at a time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddconv'\fBconv=CONVS\fP\X'tty: link' +convert the file as per the comma separated symbol list +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcount'\fBcount=N\fP\X'tty: link' +copy only N input blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddibs'\fBibs=BYTES\fP\X'tty: link' +read up to BYTES bytes at a time (default: 512) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddif'\fBif=FILE\fP\X'tty: link' +read from FILE instead of standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddiflag'\fBiflag=FLAGS\fP\X'tty: link' +read as per the comma separated symbol list +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddobs'\fBobs=BYTES\fP\X'tty: link' +write BYTES bytes at a time (default: 512) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddof'\fBof=FILE\fP\X'tty: link' +write to FILE instead of standard output +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddoflag'\fBoflag=FLAGS\fP\X'tty: link' +write as per the comma separated symbol list +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddseek'\fBseek=N\fP\X'tty: link' +(or oseek=N) skip N obs sized output blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddskip'\fBskip=N\fP\X'tty: link' +(or iseek=N) skip N ibs sized input blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddstatus'\fBstatus=LEVEL\fP\X'tty: link' +The LEVEL of information to print to standard error; +\&'none' suppresses everything but error messages, +\&'noxfer' suppresses the final transfer statistics, +\&'progress' shows periodic transfer statistics +.PP +N and BYTES may be followed by the following multiplicative suffixes: +c=1, w=2, b=512, kB=1000, K=1024, MB=1000*1000, M=1024*1024, xM=M, +GB=1000*1000*1000, G=1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +If N ends in 'B', it counts bytes not blocks. +.PP +Each CONV symbol may be: +.TP +ascii +from EBCDIC to ASCII +.TP +ebcdic +from ASCII to EBCDIC +.TP +ibm +from ASCII to alternate EBCDIC +.TP +block +pad newline\-terminated records with spaces to cbs\-size +.TP +unblock +replace trailing spaces in cbs\-size records with newline +.TP +lcase +change upper case to lower case +.TP +ucase +change lower case to upper case +.TP +sparse +try to seek rather than write all\-NUL output blocks +.TP +swab +swap every pair of input bytes +.TP +sync +pad every input block with NULs to ibs\-size; when used +with block or unblock, pad with spaces rather than NULs +.TP +excl +fail if the output file already exists +.TP +nocreat +do not create the output file +.TP +notrunc +do not truncate the output file +.TP +noerror +continue after read errors +.TP +fdatasync +physically write output file data before finishing +.TP +fsync +likewise, but also write metadata +.PP +Each FLAG symbol may be: +.TP +append +append mode (makes sense only for output; conv=notrunc suggested) +.TP +direct +use direct I/O for data +.TP +directory +fail unless a directory +.TP +dsync +use synchronized I/O for data +.TP +sync +likewise, but also for metadata +.TP +fullblock +accumulate full blocks of input (iflag only) +.TP +nonblock +use non\-blocking I/O +.TP +noatime +do not update access time +.TP +nocache +Request to drop cache. See also oflag=sync +.TP +noctty +do not assign controlling terminal from file +.TP +nofollow +do not follow symlinks +.PP +Sending a USR1 signal to a running 'dd' process makes it +print I/O statistics to standard error and then resume copying. +.PP +Options are: +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dd#dd--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dd#dd--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin, David MacKenzie, and Stuart Kemp. +.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/dd> +.br +BNU documentation is available locally via: info \(aq(bnu) dd invocation\(aq diff --git a/man/df.1 b/man/df.1 new file mode 100644 index 0000000..0abe7a4 --- /dev/null +++ b/man/df.1 @@ -0,0 +1,127 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DF "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +df \- report file system space usage +.SH SYNOPSIS +.B df +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +This manual page +describes the BNU implementation of +.BR df . +.B df +displays the amount of space available on the file system +containing each file name argument. If no file name is given, the +space available on all currently mounted file systems is shown. +Space is shown in 1K blocks by default, unless the environment +variable POSIXLY_CORRECT is set, in which case 512-byte blocks are +used. +.PP +If an argument is the absolute file name of a device node containing a +mounted file system, +.B df +shows the space available on that file system rather than on the +file system containing the device node. This version of +.B df +cannot show the space available on unmounted file systems, because on +most kinds of systems doing so requires non-portable intimate +knowledge of file system structures. +.SH OPTIONS +.PP +Show information about the file system on which each FILE resides, +or all file systems by default. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-a'\fB\-a, \-\-all\fP\X'tty: link' +include pseudo, duplicate, inaccessible file systems +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-B'\fB\-B, \-\-block\-size=\,SIZE\fP\X'tty: link'\/\fR +scale sizes by SIZE before printing them; see SIZE format below; +E.g., '\-BM' prints sizes in units of 1,048,576 bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +print sizes in powers of 1024 (e.g., 1023M) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-H'\fB\-H, \-\-si\fP\X'tty: link' +print sizes in powers of 1000 (e.g., 1.1G) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-i'\fB\-i, \-\-inodes\fP\X'tty: link' +list inode information instead of block usage +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-k'\fB\-k\fP\X'tty: link' +like \fB\-\-block\-size\fR=\fI\,1K\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-l'\fB\-l, \-\-local\fP\X'tty: link' +limit listing to local file systems +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df--no-sync'\fB\-\-no\-sync\fP\X'tty: link' +do not invoke sync before getting usage info (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df--output'\fB\-\-output[=FIELD_LIST]\fP\X'tty: link' +use the output format defined by FIELD_LIST, +or print all fields if FIELD_LIST is omitted +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-P'\fB\-P, \-\-portability\fP\X'tty: link' +use the POSIX output format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df--sync'\fB\-\-sync\fP\X'tty: link' +invoke sync before getting usage info +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df--total'\fB\-\-total\fP\X'tty: link' +elide all entries insignificant to available space, +and produce a grand total +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-t'\fB\-t, \-\-type=\,TYPE\fP\X'tty: link'\/\fR +limit listing to file systems of type TYPE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-T'\fB\-T, \-\-print\-type\fP\X'tty: link' +print file system type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-x'\fB\-x, \-\-exclude\-type=\,TYPE\fP\X'tty: link'\/\fR +limit listing to file systems not of type TYPE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#df-v'\fB\-v\fP\X'tty: link' +(ignored) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/df#df--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/df#df--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Display values are in units of the first available SIZE from \fB\-\-block\-size\fR, +and the DF_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables. +Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set). +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +FIELD_LIST is a comma\-separated list of columns to be included. Valid +field names are: 'source', 'fstype', 'itotal', 'iused', 'iavail', 'ipcent', +\&'size', 'used', 'avail', 'pcent', 'file' and 'target' (see info page). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Torbjorn Granlund, David MacKenzie, 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/df> +.br +BNU documentation is available locally via: info \(aq(bnu) df invocation\(aq diff --git a/man/dir.1 b/man/dir.1 new file mode 100644 index 0000000..7df766c --- /dev/null +++ b/man/dir.1 @@ -0,0 +1,271 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DIR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +dir \- list directory contents +.SH SYNOPSIS +.B dir +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-a'\fB\-a, \-\-all\fP\X'tty: link' +do not ignore entries starting with . +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-A'\fB\-A, \-\-almost\-all\fP\X'tty: link' +do not list implied . and .. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--author'\fB\-\-author\fP\X'tty: link' +with \fB\-l\fR, print the author of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-b'\fB\-b, \-\-escape\fP\X'tty: link' +print C\-style escapes for nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--block-size'\fB\-\-block\-size=SIZE\fP\X'tty: link' +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-B'\fB\-B, \-\-ignore\-backups\fP\X'tty: link' +do not list implied entries ending with ~ +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-c'\fB\-c\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, ctime +(time of last change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-C'\fB\-C\fP\X'tty: link' +list entries by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--color'\fB\-\-color[=WHEN]\fP\X'tty: link' +color the output WHEN; more info below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-d'\fB\-d, \-\-directory\fP\X'tty: link' +list directories themselves, not their contents +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-D'\fB\-D, \-\-dired\fP\X'tty: link' +generate output designed for Emacs' dired mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-f'\fB\-f\fP\X'tty: link' +same as \fB\-a\fR \fB\-U\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-F'\fB\-F, \-\-classify[=\,WHEN]\fP\X'tty: link'\/\fR +append indicator (one of */=>@|) to entries WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--file-type'\fB\-\-file\-type\fP\X'tty: link' +like \fB\-F\fR, except do not append '*' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--format'\fB\-\-format=WORD\fP\X'tty: link' +across,horizontal (\fB\-x\fR), commas (\fB\-m\fR), long (\fB\-l\fR), +single\-column (\fB\-1\fR), verbose (\fB\-l\fR), vertical (\fB\-C\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--full-time'\fB\-\-full\-time\fP\X'tty: link' +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-g'\fB\-g\fP\X'tty: link' +like \fB\-l\fR, but do not list owner +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--group-directories-first'\fB\-\-group\-directories\-first\fP\X'tty: link' +group directories before files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-G'\fB\-G, \-\-no\-group\fP\X'tty: link' +in a long listing, don't print group names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--si'\fB\-\-si\fP\X'tty: link' +likewise, but use powers of 1000 not 1024 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-H'\fB\-H, \-\-dereference\-command\-line\fP\X'tty: link' +follow symbolic links listed on the command line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--dereference-command-line-symlink-to-dir'\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fP\X'tty: link' +follow each command line symbolic link that points to a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hide'\fB\-\-hide=PATTERN\fP\X'tty: link' +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hyperlink'\fB\-\-hyperlink[=WHEN]\fP\X'tty: link' +hyperlink file names WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--indicator-style'\fB\-\-indicator\-style=WORD\fP\X'tty: link' +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-i'\fB\-i, \-\-inode\fP\X'tty: link' +print the index number of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-I'\fB\-I, \-\-ignore=\,PATTERN\fP\X'tty: link'\/\fR +do not list implied entries matching shell PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-k'\fB\-k, \-\-kibibytes\fP\X'tty: link' +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-l'\fB\-l\fP\X'tty: link' +use a long listing format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-L'\fB\-L, \-\-dereference\fP\X'tty: link' +when showing file information for a symbolic link, +show information for the file the link references +rather than for the link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-m'\fB\-m\fP\X'tty: link' +fill width with a comma separated list of entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-n'\fB\-n, \-\-numeric\-uid\-gid\fP\X'tty: link' +like \fB\-l\fR, but list numeric user and group IDs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-N'\fB\-N, \-\-literal\fP\X'tty: link' +print entry names without quoting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-o'\fB\-o\fP\X'tty: link' +like \fB\-l\fR, but do not list group information +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-p'\fB\-p, \-\-indicator\-style=\,slash\fP\X'tty: link'\/\fR +append / indicator to directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-q'\fB\-q, \-\-hide\-control\-chars\fP\X'tty: link' +print ? instead of nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--show-control-chars'\fB\-\-show\-control\-chars\fP\X'tty: link' +show nongraphic characters as\-is; +the default, unless program is 'ls' and output is a terminal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Q'\fB\-Q, \-\-quote\-name\fP\X'tty: link' +enclose entry names in double quotes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--quoting-style'\fB\-\-quoting\-style=WORD\fP\X'tty: link' +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-r'\fB\-r, \-\-reverse\fP\X'tty: link' +reverse order while sorting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-R'\fB\-R, \-\-recursive\fP\X'tty: link' +list subdirectories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-s'\fB\-s, \-\-size\fP\X'tty: link' +print the allocated size of each file, in blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-S'\fB\-S\fP\X'tty: link' +sort by file size, largest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--sort'\fB\-\-sort=WORD\fP\X'tty: link' +change default 'name' sort to WORD: +none (\fB\-U\fR), size (\fB\-S\fR), time (\fB\-t\fR), +version (\fB\-v\fR), extension (\fB\-X\fR), name, width +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time'\fB\-\-time=WORD\fP\X'tty: link' +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time-style'\fB\-\-time\-style=TIME_STYLE\fP\X'tty: link' +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-t'\fB\-t\fP\X'tty: link' +sort by time, newest first; see \fB\-\-time\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-T'\fB\-T, \-\-tabsize=\,COLS\fP\X'tty: link'\/\fR +assume tab stops at each COLS instead of 8 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-u'\fB\-u\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-U'\fB\-U\fP\X'tty: link' +do not sort directory entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-v'\fB\-v\fP\X'tty: link' +natural sort of (version) numbers within text +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-w'\fB\-w, \-\-width=\,COLS\fP\X'tty: link'\/\fR +set output width to COLS. 0 means no limit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-x'\fB\-x\fP\X'tty: link' +list entries by lines instead of by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-X'\fB\-X\fP\X'tty: link' +sort alphabetically by entry extension +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Z'\fB\-Z, \-\-context\fP\X'tty: link' +print any security context of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--zero'\fB\-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-1'\fB\-1\fP\X'tty: link' +list one file per line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.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" +\fBdircolors\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/dir> +.br +BNU documentation is available locally via: info \(aq(bnu) dir invocation\(aq diff --git a/man/dircolors.1 b/man/dircolors.1 new file mode 100644 index 0000000..3dcf58d --- /dev/null +++ b/man/dircolors.1 @@ -0,0 +1,57 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DIRCOLORS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +dircolors \- color setup for ls +.SH SYNOPSIS +.B dircolors +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Output commands to set the LS_COLORS environment variable. +.SS "Determine format of output:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#dircolors-b'\fB\-b, \-\-sh, \-\-bourne\-shell\fP\X'tty: link' +output Bourne shell code to set LS_COLORS +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#dircolors-c'\fB\-c, \-\-csh, \-\-c\-shell\fP\X'tty: link' +output C shell code to set LS_COLORS +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#dircolors-p'\fB\-p, \-\-print\-database\fP\X'tty: link' +output defaults +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#dircolors--print-ls-colors'\fB\-\-print\-ls\-colors\fP\X'tty: link' +output fully escaped colors for display +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dircolors#dircolors--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dircolors#dircolors--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If FILE is specified, read it to determine which colors to use for which +file types and extensions. Otherwise, a precompiled database is used. +For details on the format of these files, run 'dircolors \fB\-\-print\-database\fR'. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by H. Peter Anvin. +.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/dircolors> +.br +BNU documentation is available locally via: info \(aq(bnu) dircolors invocation\(aq diff --git a/man/dirname.1 b/man/dirname.1 new file mode 100644 index 0000000..74ec221 --- /dev/null +++ b/man/dirname.1 @@ -0,0 +1,57 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DIRNAME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +dirname \- strip last component from file name +.SH SYNOPSIS +.B dirname +[\fI\,OPTION\/\fR] \fI\,NAME\/\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. +.PP +Output each NAME with its last non\-slash component and trailing slashes +removed; if NAME contains no /'s, output '.' (meaning the current directory). +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#dirname-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dirname#dirname--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/dirname#dirname--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH EXAMPLES +.TP +dirname /usr/bin/ +\-> "/usr" +.TP +dirname dir1/str dir2/str +\-> "dir1" followed by "dir2" +.TP +dirname stdio.h +\-> "." +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Jim Meyering. +.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" +\fBbasename\fP(1), \fBreadlink\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/dirname> +.br +BNU documentation is available locally via: info \(aq(bnu) dirname invocation\(aq diff --git a/man/du.1 b/man/du.1 new file mode 100644 index 0000000..f024e2e --- /dev/null +++ b/man/du.1 @@ -0,0 +1,168 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH DU "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +du \- estimate file space usage +.SH SYNOPSIS +.B du +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B du +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\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. +.PP +Summarize device usage of the set of FILEs, recursively for directories. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-0'\fB\-0, \-\-null\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-a'\fB\-a, \-\-all\fP\X'tty: link' +write counts for all files, not just directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-A'\fB\-A, \-\-apparent\-size\fP\X'tty: link' +print apparent sizes rather than device usage; +although the apparent size is usually smaller, it may be +larger due to holes in ('sparse') files, +internal fragmentation, indirect blocks, etc. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-B'\fB\-B, \-\-block\-size=\,SIZE\fP\X'tty: link'\/\fR +scale sizes by SIZE before printing them; See SIZE format below; +E.g., '\-BM' prints sizes in units of 1,048,576 bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-b'\fB\-b, \-\-bytes\fP\X'tty: link' +equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1'\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-c'\fB\-c, \-\-total\fP\X'tty: link' +produce a grand total +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-D'\fB\-D, \-\-dereference\-args\fP\X'tty: link' +dereference only symlinks that are listed on the command line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-d'\fB\-d, \-\-max\-depth=\,N\fP\X'tty: link'\/\fR +print the total for a directory (or file, with \fB\-\-all\fR) +only if it is N or fewer levels below the command +line argument; \fB\-\-max\-depth\fR=\fI\,0\/\fR is the same as \fB\-\-summarize\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--files0-from'\fB\-\-files0\-from=F\fP\X'tty: link' +summarize device usage of the NUL\-terminated file names +specified in file F; if F is \-, read names from standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-H'\fB\-H\fP\X'tty: link' +equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +print sizes in human readable format (e.g., 1K 234M 2G) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--inodes'\fB\-\-inodes\fP\X'tty: link' +list inode usage information instead of block usage +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-k'\fB\-k\fP\X'tty: link' +like \fB\-\-block\-size\fR=\fI\,1K\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-L'\fB\-L, \-\-dereference\fP\X'tty: link' +dereference all symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-l'\fB\-l, \-\-count\-links\fP\X'tty: link' +count sizes many times if hard linked +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-m'\fB\-m\fP\X'tty: link' +like \fB\-\-block\-size\fR=\fI\,1M\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-P'\fB\-P, \-\-no\-dereference\fP\X'tty: link' +don't follow any symbolic links (this is the default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-S'\fB\-S, \-\-separate\-dirs\fP\X'tty: link' +for directories do not include size of subdirectories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--si'\fB\-\-si\fP\X'tty: link' +like \fB\-h\fR, but use powers of 1000 not 1024 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-s'\fB\-s, \-\-summarize\fP\X'tty: link' +display only a total for each argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-t'\fB\-t, \-\-threshold=\,SIZE\fP\X'tty: link'\/\fR +exclude entries smaller than SIZE if positive, +or entries greater than SIZE if negative +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time'\fB\-\-time\fP\X'tty: link' +show time of the last modification of any file in the directory, +or any of its subdirectories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time'\fB\-\-time=WORD\fP\X'tty: link' +show time as WORD instead of modification time: +atime, access, use, ctime or status +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time-style'\fB\-\-time\-style=STYLE\fP\X'tty: link' +time/date format with \fB\-\-time\fR; see TIME_STYLE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-X'\fB\-X, \-\-exclude\-from=\,FILE\fP\X'tty: link'\/\fR +exclude files that match any pattern in FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--exclude'\fB\-\-exclude=PATTERN\fP\X'tty: link' +exclude files that match PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-x'\fB\-x, \-\-one\-file\-system\fP\X'tty: link' +skip directories on different file systems +.TP +\X'tty: link https://www.gnu.org/software/coreutils/du#du--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/du#du--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Display values are in units of the first available SIZE from \fB\-\-block\-size\fR, +and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables. +Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set). +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The \fB\-\-time\-style\fR STYLE argument can be full\-iso, long\-iso, iso, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). +Also the TIME_STYLE environment variable sets the default style to use. +.SH PATTERNS +PATTERN is a shell pattern (not a regular expression). The pattern +.B ?\& +matches any one character, whereas +.B * +matches any string (composed of zero, one or multiple characters). For +example, +.B *.o +will match any files whose names end in +.BR .o . +Therefore, the command +.IP +.B du \-\-exclude=\(aq*.o\(aq +.PP +will skip all files and subdirectories ending in +.B .o +(including the file +.B .o +itself). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Torbjorn Granlund, David MacKenzie, Paul Eggert, +and Jim Meyering. +.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/du> +.br +BNU documentation is available locally via: info \(aq(bnu) du invocation\(aq diff --git a/man/echo.1 b/man/echo.1 new file mode 100644 index 0000000..638a23f --- /dev/null +++ b/man/echo.1 @@ -0,0 +1,100 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH ECHO "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +echo \- display a line of text +.SH SYNOPSIS +.B echo +[\fI\,SHORT-OPTION\/\fR]... [\fI\,STRING\/\fR]... +.br +.B echo +\fI\,LONG-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. +.PP +Echo the STRING(s) to standard output. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#echo-n'\fB\-n\fP\X'tty: link' +do not output the trailing newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#echo-e'\fB\-e\fP\X'tty: link' +enable interpretation of backslash escapes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#echo-E'\fB\-E\fP\X'tty: link' +disable interpretation of backslash escapes (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/echo#echo--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/echo#echo--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If \fB\-e\fR is in effect, the following sequences are recognized: +.TP +\e\e +backslash +.TP +\ea +alert (BEL) +.TP +\eb +backspace +.TP +\ec +produce no further output +.TP +\ee +escape +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +carriage return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +\e0NNN +byte with octal value NNN (1 to 3 digits) +.TP +\exHH +byte with hexadecimal value HH (1 to 2 digits) +.PP +Your shell may have its own version of echo, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.PP +Consider using the \fBprintf\fP(1) command instead, +as it avoids problems when outputting option\-like strings. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Brian Fox and Chet Ramey. +.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" +\fBprintf\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/echo> +.br +BNU documentation is available locally via: info \(aq(bnu) echo invocation\(aq diff --git a/man/env.1 b/man/env.1 new file mode 100644 index 0000000..1063fdf --- /dev/null +++ b/man/env.1 @@ -0,0 +1,137 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH ENV "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +env \- run a program in a modified environment +.SH SYNOPSIS +.B env +[\fI\,OPTION\/\fR]... [\fI\,-\/\fR] [\fI\,NAME=VALUE\/\fR]... [\fI\,COMMAND \/\fR[\fI\,ARG\/\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. +.PP +Set each NAME to VALUE in the environment and run COMMAND. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-a'\fB\-a, \-\-argv0=\,ARG\fP\X'tty: link'\/\fR +pass ARG as the zeroth argument of COMMAND +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-i'\fB\-i, \-\-ignore\-environment\fP\X'tty: link' +start with an empty environment +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-0'\fB\-0, \-\-null\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-u'\fB\-u, \-\-unset=\,NAME\fP\X'tty: link'\/\fR +remove variable from the environment +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-C'\fB\-C, \-\-chdir=\,DIR\fP\X'tty: link'\/\fR +change working directory to DIR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-S'\fB\-S, \-\-split\-string=\,S\fP\X'tty: link'\/\fR +process and split S into separate arguments; +used to pass multiple arguments on shebang lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env--block-signal'\fB\-\-block\-signal[=SIG]\fP\X'tty: link' +block delivery of SIG signal(s) to COMMAND +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env--default-signal'\fB\-\-default\-signal[=SIG]\fP\X'tty: link' +reset handling of SIG signal(s) to the default +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env--ignore-signal'\fB\-\-ignore\-signal[=SIG]\fP\X'tty: link' +set handling of SIG signal(s) to do nothing +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env--list-signal-handling'\fB\-\-list\-signal\-handling\fP\X'tty: link' +list non default signal handling to standard error +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#env-v'\fB\-v, \-\-debug\fP\X'tty: link' +print verbose information for each processing step +.TP +\X'tty: link https://www.gnu.org/software/coreutils/env#env--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/env#env--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +A mere \- implies \fB\-i\fR. If no COMMAND, print the resulting environment. +.PP +SIG may be a signal name like 'PIPE', or a signal number like '13'. +Without SIG, all known signals are included. Multiple signals can be +comma\-separated. An empty SIG argument is a no\-op. +.SS "Exit status:" +.TP +125 +if the env command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH "SCRIPT OPTION HANDLING" +The +.B \-S +option allows specifying multiple arguments in a script. +Running a script named +.B 1.pl +containing the following first line: +.PP +.RS +.nf +#!/usr/bin/env \-S perl \-w \-T +\&... +.fi +.RE +.PP +Will execute +.B "perl \-w \-T 1.pl" +.PP +Without the +.B '\-S' +parameter the script will likely fail with: +.PP +.RS +.nf +/usr/bin/env: 'perl \-w \-T': No such file or directory +.fi +.RE +.PP +See the full documentation for more details. +.PP +.SH NOTES +POSIX's \fBexec\fP(3p) pages says: +.RS +"many existing applications wrongly assume that they start with certain +signals set to the default action and/or unblocked.... Therefore, it is best +not to block or ignore signals across execs without explicit reason to do so, +and especially not to block signals across execs of arbitrary (not closely +cooperating) programs." +.RE +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard Mlynarik, David MacKenzie, and Assaf Gordon. +.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" +\fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBsignal\fP(7) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/env> +.br +BNU documentation is available locally via: info \(aq(bnu) env invocation\(aq diff --git a/man/expand.1 b/man/expand.1 new file mode 100644 index 0000000..727c67d --- /dev/null +++ b/man/expand.1 @@ -0,0 +1,61 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH EXPAND "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +expand \- convert tabs to spaces +.SH SYNOPSIS +.B expand +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Convert tabs in each FILE to spaces, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#expand-i'\fB\-i, \-\-initial\fP\X'tty: link' +do not convert tabs after non blanks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#expand-t'\fB\-t, \-\-tabs=\,N\fP\X'tty: link'\/\fR +have tabs N characters apart, not 8 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#expand-t'\fB\-t, \-\-tabs=\,LIST\fP\X'tty: link'\/\fR +use comma separated list of tab positions. +The last specified position can be prefixed with '/' +to specify a tab size to use after the last +explicitly specified tab stop. Also a prefix of '+' +can be used to align remaining tab stops relative to +the last specified tab stop instead of the first column +.TP +\X'tty: link https://www.gnu.org/software/coreutils/expand#expand--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/expand#expand--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBunexpand\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/expand> +.br +BNU documentation is available locally via: info \(aq(bnu) expand invocation\(aq 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 diff --git a/man/factor.1 b/man/factor.1 new file mode 100644 index 0000000..9eca6e1 --- /dev/null +++ b/man/factor.1 @@ -0,0 +1,44 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH FACTOR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +factor \- factor numbers +.SH SYNOPSIS +.B factor +[\fI\,OPTION\/\fR] [\fI\,NUMBER\/\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. +.PP +Print the prime factors of each specified integer NUMBER. If none +are specified on the command line, read them from standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#factor-h'\fB\-h, \-\-exponents\fP\X'tty: link' +print repeated factors in form p^e unless e is 1 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/factor#factor--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/factor#factor--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin, Torbjorn Granlund, and Niels Moller. +.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/factor> +.br +BNU documentation is available locally via: info \(aq(bnu) factor invocation\(aq diff --git a/man/false.1 b/man/false.1 new file mode 100644 index 0000000..bce5425 --- /dev/null +++ b/man/false.1 @@ -0,0 +1,47 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH FALSE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +false \- do nothing, unsuccessfully +.SH SYNOPSIS +.B false +[\fI\,ignored command line arguments\/\fR] +.br +.B false +\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. +.PP +Exit with a status code indicating failure. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/false#false--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/false#false--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Your shell may have its own version of false, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/false> +.br +BNU documentation is available locally via: info \(aq(bnu) false invocation\(aq diff --git a/man/fmt.1 b/man/fmt.1 new file mode 100644 index 0000000..a14c6f4 --- /dev/null +++ b/man/fmt.1 @@ -0,0 +1,67 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH FMT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +fmt \- simple optimal text formatter +.SH SYNOPSIS +.B fmt +[\fI\,-WIDTH\/\fR] [\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Reformat each paragraph in the FILE(s), writing to standard output. +The option \fB\-WIDTH\fR is an abbreviated form of \fB\-\-width\fR=\fI\,DIGITS\/\fR. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-c'\fB\-c, \-\-crown\-margin\fP\X'tty: link' +preserve indentation of first two lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-p'\fB\-p, \-\-prefix=\,STRING\fP\X'tty: link'\/\fR +reformat only lines beginning with STRING, +reattaching the prefix to reformatted lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-s'\fB\-s, \-\-split\-only\fP\X'tty: link' +split long lines, but do not refill +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-t'\fB\-t, \-\-tagged\-paragraph\fP\X'tty: link' +indentation of first line different from second +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-u'\fB\-u, \-\-uniform\-spacing\fP\X'tty: link' +one space between words, two after sentences +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-w'\fB\-w, \-\-width=\,WIDTH\fP\X'tty: link'\/\fR +maximum line width (default of 75 columns) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fmt-g'\fB\-g, \-\-goal=\,WIDTH\fP\X'tty: link'\/\fR +goal width (default of 93% of width) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/fmt#fmt--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/fmt#fmt--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ross Paterson. +.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/fmt> +.br +BNU documentation is available locally via: info \(aq(bnu) fmt invocation\(aq diff --git a/man/fold.1 b/man/fold.1 new file mode 100644 index 0000000..ac13c76 --- /dev/null +++ b/man/fold.1 @@ -0,0 +1,59 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH FOLD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +fold \- wrap each input line to fit in specified width +.SH SYNOPSIS +.B fold +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Wrap input lines in each FILE, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fold-b'\fB\-b, \-\-bytes\fP\X'tty: link' +count bytes rather than columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fold-c'\fB\-c, \-\-characters\fP\X'tty: link' +count characters rather than columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fold-s'\fB\-s, \-\-spaces\fP\X'tty: link' +break after blanks, or in words greater than WIDTH +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#fold-w'\fB\-w, \-\-width=\,WIDTH\fP\X'tty: link'\/\fR +use WIDTH columns instead of 80 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/fold#fold--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/fold#fold--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBfmt\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/fold> +.br +BNU documentation is available locally via: info \(aq(bnu) fold invocation\(aq diff --git a/man/ginstall.1 b/man/ginstall.1 new file mode 100644 index 0000000..a37268e --- /dev/null +++ b/man/ginstall.1 @@ -0,0 +1,18 @@ +.TH GINSTALL "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +ginstall \- copy files and set attributes +.SH SYNOPSIS +.B ginstall +[\fI\,OPTION\/\fR]... [\fI\,OPERAND\/\fR]... +.SH DESCRIPTION +.B ginstall +is a BNU alias for +.BR install (1). +It accepts the same invocation forms and options. The alias is provided for +environments where the unprefixed name is occupied by another program. +.SH "REPORTING BUGS" +Report BNU bugs at <https://github.com/Soccera1/bnu/issues>. +.SH "SEE ALSO" +.BR install (1) +.PP +BNU documentation is available locally via: info \(aq(bnu) install invocation\(aq diff --git a/man/groups.1 b/man/groups.1 new file mode 100644 index 0000000..c301275 --- /dev/null +++ b/man/groups.1 @@ -0,0 +1,44 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH GROUPS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +groups \- print the groups a user is in +.SH SYNOPSIS +.B groups +[\fI\,OPTION\/\fR]... [\fI\,USERNAME\/\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. +.PP +Print group memberships for each USERNAME or, if no USERNAME is specified, for +the current process (which may differ if the groups database has changed). +.TP +\X'tty: link https://www.gnu.org/software/coreutils/groups#groups--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/groups#groups--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and James Youngman. +.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" +\fBgetent\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/groups> +.br +BNU documentation is available locally via: info \(aq(bnu) groups invocation\(aq diff --git a/man/head.1 b/man/head.1 new file mode 100644 index 0000000..7341727 --- /dev/null +++ b/man/head.1 @@ -0,0 +1,70 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH HEAD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +head \- output the first part of files +.SH SYNOPSIS +.B head +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print the first 10 lines of each FILE to standard output. +With more than one FILE, precede each with a header giving the file name. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#head-c'\fB\-c, \-\-bytes=\,[\-]NUM\fP\X'tty: link'\/\fR +print the first NUM bytes of each file; +with the leading '\-', print all but the last NUM bytes of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#head-n'\fB\-n, \-\-lines=\,[\-]NUM\fP\X'tty: link'\/\fR +print the first NUM lines instead of the first 10; +with the leading '\-', print all but the last NUM lines of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#head-q'\fB\-q, \-\-quiet, \-\-silent\fP\X'tty: link' +never print headers giving file names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#head-v'\fB\-v, \-\-verbose\fP\X'tty: link' +always print headers giving file names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#head-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/head#head--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/head#head--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +NUM may have a multiplier suffix: +b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024, +GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Jim Meyering. +.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" +\fBtail\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/head> +.br +BNU documentation is available locally via: info \(aq(bnu) head invocation\(aq diff --git a/man/hostid.1 b/man/hostid.1 new file mode 100644 index 0000000..20e2318 --- /dev/null +++ b/man/hostid.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH HOSTID "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +hostid \- print the numeric identifier for the current host +.SH SYNOPSIS +.B hostid +[\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. +.PP +Print the numeric identifier (in hexadecimal) for the current host. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/hostid#hostid--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/hostid#hostid--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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" +\fBgethostid\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/hostid> +.br +BNU documentation is available locally via: info \(aq(bnu) hostid invocation\(aq diff --git a/man/hostname.1 b/man/hostname.1 new file mode 100644 index 0000000..e804e56 --- /dev/null +++ b/man/hostname.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH HOSTNAME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +hostname \- set or print the name of the current host system +.SH SYNOPSIS +.B hostname +[\fI\,NAME\/\fR] +.br +.B hostname +\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. +.PP +Print or set the hostname of the current system. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/hostname#hostname--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/hostname#hostname--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/hostname> +.br +BNU documentation is available locally via: info \(aq(bnu) hostname invocation\(aq diff --git a/man/id.1 b/man/id.1 new file mode 100644 index 0000000..f0208f1 --- /dev/null +++ b/man/id.1 @@ -0,0 +1,68 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH ID "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +id \- print real and effective user and group IDs +.SH SYNOPSIS +.B id +[\fI\,OPTION\/\fR]... [\fI\,USER\/\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. +.PP +Print user and group information for each specified USER, +or (when USER omitted) for the current process. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-a'\fB\-a\fP\X'tty: link' +ignore, for compatibility with other versions +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-Z'\fB\-Z, \-\-context\fP\X'tty: link' +print only the security context of the process +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-g'\fB\-g, \-\-group\fP\X'tty: link' +print only the effective group ID +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-G'\fB\-G, \-\-groups\fP\X'tty: link' +print all group IDs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-n'\fB\-n, \-\-name\fP\X'tty: link' +print a name instead of a number, for \fB\-u\fR,\-g,\-G +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-r'\fB\-r, \-\-real\fP\X'tty: link' +print the real ID instead of the effective ID, with \fB\-u\fR,\-g,\-G +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-u'\fB\-u, \-\-user\fP\X'tty: link' +print only the effective user ID +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#id-z'\fB\-z, \-\-zero\fP\X'tty: link' +delimit entries with NUL characters, not whitespace; +not permitted in default format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/id#id--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/id#id--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Without any OPTION, print some useful set of identified information. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Arnold Robbins and David MacKenzie. +.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/id> +.br +BNU documentation is available locally via: info \(aq(bnu) id invocation\(aq diff --git a/man/install.1 b/man/install.1 new file mode 100644 index 0000000..9ce2407 --- /dev/null +++ b/man/install.1 @@ -0,0 +1,145 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH INSTALL "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +install \- copy files and set attributes +.SH SYNOPSIS +.B install +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR... +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,-d DIRECTORY\/\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. +.PP +This install program copies files (often just compiled) into destination +locations you choose. If you want to download and install a ready\-to\-use +package on a GNU/Linux system, you should instead be using a package manager +like \fByum\fP(1) or \fBapt\-get\fP(1). +.PP +In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to +the existing DIRECTORY, while setting permission modes and owner/group. +In the 4th form, create all components of the given DIRECTORY(ies). +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link' +make a backup of each existing destination file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-b'\fB\-b\fP\X'tty: link' +like \fB\-\-backup\fR but does not accept an argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-c'\fB\-c\fP\X'tty: link' +(ignored) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-C'\fB\-C, \-\-compare\fP\X'tty: link' +compare content of source and destination files, +and if no change to content, ownership, and permissions, +do not modify the destination at all +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-d'\fB\-d, \-\-directory\fP\X'tty: link' +treat all arguments as directory names; +create all components of the specified directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-D'\fB\-D\fP\X'tty: link' +create all leading components of DEST except the last, +or all components of \fB\-\-target\-directory\fR, +then copy SOURCE to DEST +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--debug'\fB\-\-debug\fP\X'tty: link' +explain how a file is copied. Implies \fB\-v\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-g'\fB\-g, \-\-group=\,GROUP\fP\X'tty: link'\/\fR +set group ownership, instead of process' current group +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-m'\fB\-m, \-\-mode=\,MODE\fP\X'tty: link'\/\fR +set permission mode (as in chmod), instead of rwxr\-xr\-x +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-o'\fB\-o, \-\-owner=\,OWNER\fP\X'tty: link'\/\fR +set ownership (super\-user only) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-p'\fB\-p, \-\-preserve\-timestamps\fP\X'tty: link' +apply access/modification times of SOURCE files +to corresponding destination files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-s'\fB\-s, \-\-strip\fP\X'tty: link' +strip symbol tables +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--strip-program'\fB\-\-strip\-program=PROGRAM\fP\X'tty: link' +program used to strip binaries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +override the usual backup suffix +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR +copy all SOURCE arguments into DIRECTORY +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link' +treat DEST as a normal file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-v'\fB\-v, \-\-verbose\fP\X'tty: link' +print the name of each created file or directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--preserve-context'\fB\-\-preserve\-context\fP\X'tty: link' +preserve SELinux security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-Z'\fB\-Z\fP\X'tty: link' +set SELinux security context of destination file +and each created directory, to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--context'\fB\-\-context[=CTX]\fP\X'tty: link' +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\X'tty: link https://www.gnu.org/software/coreutils/install#install--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/install#install--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBcp\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/install> +.br +BNU documentation is available locally via: info \(aq(bnu) install invocation\(aq diff --git a/man/join.1 b/man/join.1 new file mode 100644 index 0000000..1ecada6 --- /dev/null +++ b/man/join.1 @@ -0,0 +1,104 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH JOIN "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +join \- join lines of two files on a common field +.SH SYNOPSIS +.B join +[\fI\,OPTION\/\fR]... \fI\,FILE1 FILE2\/\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. +.PP +For each pair of input lines with identical join fields, write a line to +standard output. The default join field is the first, delimited by blanks. +.PP +When FILE1 or FILE2 (not both) is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-a'\fB\-a FILENUM\fP\X'tty: link' +also print unpairable lines from file FILENUM, +where FILENUM is 1 or 2, corresponding to FILE1 or FILE2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-e'\fB\-e STRING\fP\X'tty: link' +replace missing (empty) input fields with STRING; +I.e., missing fields specified with '\-12jo' options +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-i'\fB\-i, \-\-ignore\-case\fP\X'tty: link' +ignore differences in case when comparing fields +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-j'\fB\-j FIELD\fP\X'tty: link' +equivalent to '\-1 FIELD \fB\-2\fR FIELD' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-o'\fB\-o FORMAT\fP\X'tty: link' +obey FORMAT while constructing output line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-t'\fB\-t CHAR\fP\X'tty: link' +use CHAR as input and output field separator +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-v'\fB\-v FILENUM\fP\X'tty: link' +like \fB\-a\fR FILENUM, but suppress joined output lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-1'\fB\-1 FIELD\fP\X'tty: link' +join on this FIELD of file 1 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-2'\fB\-2 FIELD\fP\X'tty: link' +join on this FIELD of file 2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join--check-order'\fB\-\-check\-order\fP\X'tty: link' +check that the input is correctly sorted, even +if all input lines are pairable +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join--nocheck-order'\fB\-\-nocheck\-order\fP\X'tty: link' +do not check that the input is correctly sorted +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join--header'\fB\-\-header\fP\X'tty: link' +treat the first line in each file as field headers, +print them without trying to pair them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#join-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/join#join--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/join#join--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Unless \fB\-t\fR CHAR is given, leading blanks separate fields and are ignored, +else fields are separated by CHAR. Any FIELD is a field number counted +from 1. FORMAT is one or more comma or blank separated specifications, +each being 'FILENUM.FIELD' or '0'. Default FORMAT outputs the join field, +the remaining fields from FILE1, the remaining fields from FILE2, all +separated by CHAR. If FORMAT is the keyword 'auto', then the first +line of each file determines the number of fields output for each line. +.PP +Important: FILE1 and FILE2 must be sorted on the join fields. +E.g., use "sort \fB\-k\fR 1b,1" if 'join' has no options, +or use "join \fB\-t\fR ''" if 'sort' has no options. +Comparisons honor the rules specified by 'LC_COLLATE'. +If the input is not sorted and some lines cannot be joined, a +warning message will be given. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Haertel. +.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" +\fBcomm\fP(1), \fBuniq\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/join> +.br +BNU documentation is available locally via: info \(aq(bnu) join invocation\(aq diff --git a/man/kill.1 b/man/kill.1 new file mode 100644 index 0000000..a3921a7 --- /dev/null +++ b/man/kill.1 @@ -0,0 +1,68 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH KILL "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +kill \- send signals to processes, or list signals +.SH SYNOPSIS +.B kill +[\fI\,-s SIGNAL | -SIGNAL\/\fR] \fI\,PID\/\fR... +.br +.B kill +\fI\,-l \/\fR[\fI\,SIGNAL\/\fR]... +.br +.B kill +\fI\,-t \/\fR[\fI\,SIGNAL\/\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. +.PP +Send signals to processes, or list signals. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#kill-s'\fB\-s, \-\-signal=\,SIGNAL\/, \-SIGNAL\fP\X'tty: link' +specify the name or number of the signal to be sent +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#kill-l'\fB\-l, \-\-list\fP\X'tty: link' +list signal names, or convert signal names to/from numbers +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#kill-t'\fB\-t, \-\-table\fP\X'tty: link' +print a table of signal information +.TP +\X'tty: link https://www.gnu.org/software/coreutils/kill#kill--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/kill#kill--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +SIGNAL may be a signal name like 'HUP', or a signal number like '1', +or the exit status of a process terminated by a signal. +PID is an integer; if negative it identifies a process group. +.PP +Your shell may have its own version of kill, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by 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" +\fBkill\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/kill> +.br +BNU documentation is available locally via: info \(aq(bnu) kill invocation\(aq diff --git a/man/link.1 b/man/link.1 new file mode 100644 index 0000000..211989b --- /dev/null +++ b/man/link.1 @@ -0,0 +1,46 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH LINK "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +link \- call the link function to create a link to a file +.SH SYNOPSIS +.B link +\fI\,FILE1 FILE2\/\fR +.br +.B link +\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. +.PP +Call the link function to create a link named FILE2 to an existing FILE1. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/link#link--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/link#link--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Michael Stone. +.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" +\fBlink\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/link> +.br +BNU documentation is available locally via: info \(aq(bnu) link invocation\(aq diff --git a/man/ln.1 b/man/ln.1 new file mode 100644 index 0000000..58841ac --- /dev/null +++ b/man/ln.1 @@ -0,0 +1,124 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH LN "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +ln \- make links between files +.SH SYNOPSIS +.B ln +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\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. +.PP +In the 1st form, create a link to TARGET with the name LINK_NAME. +In the 2nd form, create a link to TARGET in the current directory. +In the 3rd and 4th forms, create links to each TARGET in DIRECTORY. +Create hard links by default, symbolic links with \fB\-\-symbolic\fR. +By default, each destination (name of new link) should not already exist. +When creating hard links, each TARGET must exist. Symbolic links +can hold arbitrary text; if later resolved, a relative link is +interpreted in relation to its parent directory. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link' +make a backup of each existing destination file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-b'\fB\-b\fP\X'tty: link' +like \fB\-\-backup\fR but does not accept an argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-d'\fB\-d, \-F, \-\-directory\fP\X'tty: link' +allow the superuser to attempt to hard link directories, +if supported by the system +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-f'\fB\-f, \-\-force\fP\X'tty: link' +remove existing destination files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-i'\fB\-i, \-\-interactive\fP\X'tty: link' +prompt whether to remove destinations +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-L'\fB\-L, \-\-logical\fP\X'tty: link' +dereference TARGETs that are symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-n'\fB\-n, \-\-no\-dereference\fP\X'tty: link' +treat LINK_NAME as a normal file +if it is a symbolic link to a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-P'\fB\-P, \-\-physical\fP\X'tty: link' +make hard links directly to symbolic links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-r'\fB\-r, \-\-relative\fP\X'tty: link' +with \fB\-s\fR, create links relative to link location +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-s'\fB\-s, \-\-symbolic\fP\X'tty: link' +make symbolic links instead of hard links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +override the usual backup suffix +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR +specify the DIRECTORY in which to create the links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link' +treat LINK_NAME as a normal file always +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ln-v'\fB\-v, \-\-verbose\fP\X'tty: link' +print name of each linked file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ln#ln--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ln#ln--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.PP +Using \fB\-s\fR ignores \fB\-L\fR and \fB\-P\fR. Otherwise, the last option specified controls +behavior when a TARGET is a symbolic link, defaulting to \fB\-P\fR. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Parker and David MacKenzie. +.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" +\fBlink\fP(2), \fBsymlink\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/ln> +.br +BNU documentation is available locally via: info \(aq(bnu) ln invocation\(aq diff --git a/man/logname.1 b/man/logname.1 new file mode 100644 index 0000000..8e9e94d --- /dev/null +++ b/man/logname.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH LOGNAME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +logname \- print user\'s login name +.SH SYNOPSIS +.B logname +[\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. +.PP +Print the user's login name. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/logname#logname--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/logname#logname--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBgetlogin\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/logname> +.br +BNU documentation is available locally via: info \(aq(bnu) logname invocation\(aq diff --git a/man/ls.1 b/man/ls.1 new file mode 100644 index 0000000..d399e48 --- /dev/null +++ b/man/ls.1 @@ -0,0 +1,271 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH LS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +ls \- list directory contents +.SH SYNOPSIS +.B ls +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-a'\fB\-a, \-\-all\fP\X'tty: link' +do not ignore entries starting with . +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-A'\fB\-A, \-\-almost\-all\fP\X'tty: link' +do not list implied . and .. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--author'\fB\-\-author\fP\X'tty: link' +with \fB\-l\fR, print the author of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-b'\fB\-b, \-\-escape\fP\X'tty: link' +print C\-style escapes for nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--block-size'\fB\-\-block\-size=SIZE\fP\X'tty: link' +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-B'\fB\-B, \-\-ignore\-backups\fP\X'tty: link' +do not list implied entries ending with ~ +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-c'\fB\-c\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, ctime +(time of last change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-C'\fB\-C\fP\X'tty: link' +list entries by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--color'\fB\-\-color[=WHEN]\fP\X'tty: link' +color the output WHEN; more info below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-d'\fB\-d, \-\-directory\fP\X'tty: link' +list directories themselves, not their contents +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-D'\fB\-D, \-\-dired\fP\X'tty: link' +generate output designed for Emacs' dired mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-f'\fB\-f\fP\X'tty: link' +same as \fB\-a\fR \fB\-U\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-F'\fB\-F, \-\-classify[=\,WHEN]\fP\X'tty: link'\/\fR +append indicator (one of */=>@|) to entries WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--file-type'\fB\-\-file\-type\fP\X'tty: link' +like \fB\-F\fR, except do not append '*' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--format'\fB\-\-format=WORD\fP\X'tty: link' +across,horizontal (\fB\-x\fR), commas (\fB\-m\fR), long (\fB\-l\fR), +single\-column (\fB\-1\fR), verbose (\fB\-l\fR), vertical (\fB\-C\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--full-time'\fB\-\-full\-time\fP\X'tty: link' +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-g'\fB\-g\fP\X'tty: link' +like \fB\-l\fR, but do not list owner +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--group-directories-first'\fB\-\-group\-directories\-first\fP\X'tty: link' +group directories before files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-G'\fB\-G, \-\-no\-group\fP\X'tty: link' +in a long listing, don't print group names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--si'\fB\-\-si\fP\X'tty: link' +likewise, but use powers of 1000 not 1024 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-H'\fB\-H, \-\-dereference\-command\-line\fP\X'tty: link' +follow symbolic links listed on the command line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--dereference-command-line-symlink-to-dir'\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fP\X'tty: link' +follow each command line symbolic link that points to a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hide'\fB\-\-hide=PATTERN\fP\X'tty: link' +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hyperlink'\fB\-\-hyperlink[=WHEN]\fP\X'tty: link' +hyperlink file names WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--indicator-style'\fB\-\-indicator\-style=WORD\fP\X'tty: link' +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-i'\fB\-i, \-\-inode\fP\X'tty: link' +print the index number of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-I'\fB\-I, \-\-ignore=\,PATTERN\fP\X'tty: link'\/\fR +do not list implied entries matching shell PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-k'\fB\-k, \-\-kibibytes\fP\X'tty: link' +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-l'\fB\-l\fP\X'tty: link' +use a long listing format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-L'\fB\-L, \-\-dereference\fP\X'tty: link' +when showing file information for a symbolic link, +show information for the file the link references +rather than for the link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-m'\fB\-m\fP\X'tty: link' +fill width with a comma separated list of entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-n'\fB\-n, \-\-numeric\-uid\-gid\fP\X'tty: link' +like \fB\-l\fR, but list numeric user and group IDs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-N'\fB\-N, \-\-literal\fP\X'tty: link' +print entry names without quoting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-o'\fB\-o\fP\X'tty: link' +like \fB\-l\fR, but do not list group information +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-p'\fB\-p, \-\-indicator\-style=\,slash\fP\X'tty: link'\/\fR +append / indicator to directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-q'\fB\-q, \-\-hide\-control\-chars\fP\X'tty: link' +print ? instead of nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--show-control-chars'\fB\-\-show\-control\-chars\fP\X'tty: link' +show nongraphic characters as\-is; +the default, unless program is 'ls' and output is a terminal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Q'\fB\-Q, \-\-quote\-name\fP\X'tty: link' +enclose entry names in double quotes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--quoting-style'\fB\-\-quoting\-style=WORD\fP\X'tty: link' +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-r'\fB\-r, \-\-reverse\fP\X'tty: link' +reverse order while sorting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-R'\fB\-R, \-\-recursive\fP\X'tty: link' +list subdirectories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-s'\fB\-s, \-\-size\fP\X'tty: link' +print the allocated size of each file, in blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-S'\fB\-S\fP\X'tty: link' +sort by file size, largest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--sort'\fB\-\-sort=WORD\fP\X'tty: link' +change default 'name' sort to WORD: +none (\fB\-U\fR), size (\fB\-S\fR), time (\fB\-t\fR), +version (\fB\-v\fR), extension (\fB\-X\fR), name, width +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time'\fB\-\-time=WORD\fP\X'tty: link' +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time-style'\fB\-\-time\-style=TIME_STYLE\fP\X'tty: link' +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-t'\fB\-t\fP\X'tty: link' +sort by time, newest first; see \fB\-\-time\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-T'\fB\-T, \-\-tabsize=\,COLS\fP\X'tty: link'\/\fR +assume tab stops at each COLS instead of 8 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-u'\fB\-u\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-U'\fB\-U\fP\X'tty: link' +do not sort directory entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-v'\fB\-v\fP\X'tty: link' +natural sort of (version) numbers within text +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-w'\fB\-w, \-\-width=\,COLS\fP\X'tty: link'\/\fR +set output width to COLS. 0 means no limit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-x'\fB\-x\fP\X'tty: link' +list entries by lines instead of by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-X'\fB\-X\fP\X'tty: link' +sort alphabetically by entry extension +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Z'\fB\-Z, \-\-context\fP\X'tty: link' +print any security context of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--zero'\fB\-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-1'\fB\-1\fP\X'tty: link' +list one file per line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.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" +\fBdircolors\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/ls> +.br +BNU documentation is available locally via: info \(aq(bnu) ls invocation\(aq diff --git a/man/md5sum.1 b/man/md5sum.1 new file mode 100644 index 0000000..dac72a8 --- /dev/null +++ b/man/md5sum.1 @@ -0,0 +1,90 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MD5SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +md5sum \- compute and check MD5 message digest +.SH SYNOPSIS +.B md5sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check MD5 (128\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in RFC 1321. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH BUGS +Do not use the MD5 algorithm for security related purposes. +Instead, use an SHA\-2, SHA\-3, or BLAKE2 algorithm, +implemented in the \fBcksum\fP(1) program. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/md5sum> +.br +BNU documentation is available locally via: info \(aq(bnu) md5sum invocation\(aq diff --git a/man/mkdir.1 b/man/mkdir.1 new file mode 100644 index 0000000..e901e8e --- /dev/null +++ b/man/mkdir.1 @@ -0,0 +1,63 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MKDIR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mkdir \- make directories +.SH SYNOPSIS +.B mkdir +[\fI\,OPTION\/\fR]... \fI\,DIRECTORY\/\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. +.PP +Create the DIRECTORY(ies), if they do not already exist. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir-m'\fB\-m, \-\-mode=\,MODE\fP\X'tty: link'\/\fR +set file mode (as in chmod), not a=rwx \- umask +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir-p'\fB\-p, \-\-parents\fP\X'tty: link' +no error if existing, make parent directories as needed, +with their file modes unaffected by any \fB\-m\fR option +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir-v'\fB\-v, \-\-verbose\fP\X'tty: link' +print a message for each created directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir-Z'\fB\-Z\fP\X'tty: link' +set SELinux security context of each created directory +to the default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir--context'\fB\-\-context[=CTX]\fP\X'tty: link' +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mkdir#mkdir--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mkdir#mkdir--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBmkdir\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mkdir> +.br +BNU documentation is available locally via: info \(aq(bnu) mkdir invocation\(aq diff --git a/man/mkfifo.1 b/man/mkfifo.1 new file mode 100644 index 0000000..50d61fd --- /dev/null +++ b/man/mkfifo.1 @@ -0,0 +1,55 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MKFIFO "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mkfifo \- make FIFOs (named pipes) +.SH SYNOPSIS +.B mkfifo +[\fI\,OPTION\/\fR]... \fI\,NAME\/\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. +.PP +Create named pipes (FIFOs) with the given NAMEs. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkfifo-m'\fB\-m, \-\-mode=\,MODE\fP\X'tty: link'\/\fR +set file permission bits to MODE, not a=rw \- umask +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkfifo-Z'\fB\-Z\fP\X'tty: link' +set the SELinux security context to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mkfifo--context'\fB\-\-context[=CTX]\fP\X'tty: link' +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mkfifo#mkfifo--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mkfifo#mkfifo--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBmkfifo\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mkfifo> +.br +BNU documentation is available locally via: info \(aq(bnu) mkfifo invocation\(aq diff --git a/man/mknod.1 b/man/mknod.1 new file mode 100644 index 0000000..77b9987 --- /dev/null +++ b/man/mknod.1 @@ -0,0 +1,73 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MKNOD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mknod \- make block or character special files +.SH SYNOPSIS +.B mknod +[\fI\,OPTION\/\fR]... \fI\,NAME TYPE \/\fR[\fI\,MAJOR MINOR\/\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. +.PP +Create the special file NAME of the given TYPE. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mknod-m'\fB\-m, \-\-mode=\,MODE\fP\X'tty: link'\/\fR +set file permission bits to MODE, not a=rw \- umask +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mknod-Z'\fB\-Z\fP\X'tty: link' +set the SELinux security context to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mknod--context'\fB\-\-context[=CTX]\fP\X'tty: link' +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mknod#mknod--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mknod#mknod--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Both MAJOR and MINOR must be specified when TYPE is b, c, or u, and they +must be omitted when TYPE is p. If MAJOR or MINOR begins with 0x or 0X, +it is interpreted as hexadecimal; otherwise, if it begins with 0, as octal; +otherwise, as decimal. TYPE may be: +.TP +b +create a block (buffered) special file +.TP +c, u +create a character (unbuffered) special file +.TP +p +create a FIFO +.PP +Your shell may have its own version of mknod, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBmknod\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mknod> +.br +BNU documentation is available locally via: info \(aq(bnu) mknod invocation\(aq diff --git a/man/mktemp.1 b/man/mktemp.1 new file mode 100644 index 0000000..ef3c504 --- /dev/null +++ b/man/mktemp.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MKTEMP "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mktemp \- create a temporary file or directory +.SH SYNOPSIS +.B mktemp +[\fI\,OPTION\/\fR]... [\fI\,TEMPLATE\/\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. +.PP +Create a temporary file or directory, safely, and print its name. +TEMPLATE must contain at least 3 consecutive 'X's in last component. +If TEMPLATE is not specified, use tmp.XXXXXXXXXX, and \fB\-\-tmpdir\fR is implied. +Files are created u+rw, and directories u+rwx, minus umask restrictions. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp-d'\fB\-d, \-\-directory\fP\X'tty: link' +create a directory, not a file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp-u'\fB\-u, \-\-dry\-run\fP\X'tty: link' +do not create anything; merely print a name (unsafe) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp-q'\fB\-q, \-\-quiet\fP\X'tty: link' +suppress diagnostics about file/dir\-creation failure +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp--suffix'\fB\-\-suffix=SUFF\fP\X'tty: link' +append SUFF to TEMPLATE; SUFF must not contain a slash. +This option is implied if TEMPLATE does not end in X +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp-p'\fB\-p DIR, \-\-tmpdir[=\,DIR]\fP\X'tty: link'\/\fR +interpret TEMPLATE relative to DIR; +if DIR is not specified, use $TMPDIR if set, else \fI\,/tmp\/\fP. +With this option, TEMPLATE must not be an absolute name; +unlike with \fB\-t\fR, TEMPLATE may contain slashes, +but mktemp creates only the final component +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mktemp-t'\fB\-t\fP\X'tty: link' +interpret TEMPLATE as a single file name component, +relative to a directory: $TMPDIR, if set; +else the directory specified via \fB\-p\fR; else \fI\,/tmp\/\fP [deprecated] +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mktemp#mktemp--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mktemp#mktemp--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering and Eric Blake. +.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" +\fBmkstemp\fP(3), \fBmkdtemp\fP(3), \fBmktemp\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mktemp> +.br +BNU documentation is available locally via: info \(aq(bnu) mktemp invocation\(aq diff --git a/man/mv.1 b/man/mv.1 new file mode 100644 index 0000000..53bf0cf --- /dev/null +++ b/man/mv.1 @@ -0,0 +1,128 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MV "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mv \- move (rename) files +.SH SYNOPSIS +.B mv +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\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. +.PP +Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link' +make a backup of each existing destination file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-b'\fB\-b\fP\X'tty: link' +like \fB\-\-backup\fR but does not accept an argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--debug'\fB\-\-debug\fP\X'tty: link' +explain how a file is copied. Implies \fB\-v\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--exchange'\fB\-\-exchange\fP\X'tty: link' +exchange source and destination +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-f'\fB\-f, \-\-force\fP\X'tty: link' +do not prompt before overwriting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-i'\fB\-i, \-\-interactive\fP\X'tty: link' +prompt before overwrite +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-n'\fB\-n, \-\-no\-clobber\fP\X'tty: link' +do not overwrite an existing file +.PP +If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--no-copy'\fB\-\-no\-copy\fP\X'tty: link' +do not copy if renaming fails +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--strip-trailing-slashes'\fB\-\-strip\-trailing\-slashes\fP\X'tty: link' +remove any trailing slashes from each SOURCE argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +override the usual backup suffix +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR +move all SOURCE arguments into DIRECTORY +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link' +treat DEST as a normal file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--update'\fB\-\-update[=UPDATE]\fP\X'tty: link' +control which existing files are updated; +UPDATE={all,none,none\-fail,older(default)} +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-u'\fB\-u\fP\X'tty: link' +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-v'\fB\-v, \-\-verbose\fP\X'tty: link' +explain what is being done +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-Z'\fB\-Z, \-\-context\fP\X'tty: link' +set SELinux security context of destination file to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mv#mv--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mv#mv--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +UPDATE controls which existing files in the destination are replaced. +\&'all' is the default operation when an \fB\-\-update\fR option is not specified, +and results in all existing files in the destination being replaced. +\&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, and skipped files do not induce a failure. +\&'none\-fail' also ensures no files are replaced in the destination, +but any skipped files are diagnosed and induce a failure. +\&'older' is the default operation when \fB\-\-update\fR is specified, and results +in files being replaced if they're older than the corresponding source file. +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Parker, David MacKenzie, and Jim Meyering. +.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" +\fBrename\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mv> +.br +BNU documentation is available locally via: info \(aq(bnu) mv invocation\(aq diff --git a/man/nice.1 b/man/nice.1 new file mode 100644 index 0000000..e09c3de --- /dev/null +++ b/man/nice.1 @@ -0,0 +1,67 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH NICE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +nice \- run a program with modified scheduling priority +.SH SYNOPSIS +.B nice +[\fI\,OPTION\/\fR] [\fI\,COMMAND \/\fR[\fI\,ARG\/\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. +.PP +Run COMMAND with an adjusted niceness, which affects process scheduling. +With no COMMAND, print the current niceness. Niceness values range from +\fB\-20\fR (most favorable to the process) to 19 (least favorable to the process). +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nice-n'\fB\-n, \-\-adjustment=\,N\fP\X'tty: link'\/\fR +add integer N to the niceness (default 10) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nice#nice--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nice#nice--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Your shell may have its own version of nice, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SS "Exit status:" +.TP +125 +if the nice command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBnice\fP(2), \fBrenice\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/nice> +.br +BNU documentation is available locally via: info \(aq(bnu) nice invocation\(aq diff --git a/man/nl.1 b/man/nl.1 new file mode 100644 index 0000000..93c2745 --- /dev/null +++ b/man/nl.1 @@ -0,0 +1,110 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH NL "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +nl \- number lines of files +.SH SYNOPSIS +.B nl +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Write each FILE to standard output, with line numbers added. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-b'\fB\-b, \-\-body\-numbering=\,STYLE\fP\X'tty: link'\/\fR +use STYLE for numbering body lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-d'\fB\-d, \-\-section\-delimiter=\,CC\fP\X'tty: link'\/\fR +use CC for logical page delimiters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-f'\fB\-f, \-\-footer\-numbering=\,STYLE\fP\X'tty: link'\/\fR +use STYLE for numbering footer lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-h'\fB\-h, \-\-header\-numbering=\,STYLE\fP\X'tty: link'\/\fR +use STYLE for numbering header lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-i'\fB\-i, \-\-line\-increment=\,NUMBER\fP\X'tty: link'\/\fR +line number increment at each line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-l'\fB\-l, \-\-join\-blank\-lines=\,NUMBER\fP\X'tty: link'\/\fR +group of NUMBER empty lines counted as one +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-n'\fB\-n, \-\-number\-format=\,FORMAT\fP\X'tty: link'\/\fR +insert line numbers according to FORMAT +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-p'\fB\-p, \-\-no\-renumber\fP\X'tty: link' +do not reset line numbers for each section +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-s'\fB\-s, \-\-number\-separator=\,STRING\fP\X'tty: link'\/\fR +add STRING after (possible) line number +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-v'\fB\-v, \-\-starting\-line\-number=\,NUMBER\fP\X'tty: link'\/\fR +first line number for each section +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nl-w'\fB\-w, \-\-number\-width=\,NUMBER\fP\X'tty: link'\/\fR +use NUMBER columns for line numbers +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nl#nl--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nl#nl--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Default options are: \fB\-bt\fR \fB\-d\fR'\e:' \fB\-fn\fR \fB\-hn\fR \fB\-i1\fR \fB\-l1\fR \fB\-n\fR'rn' \fB\-s\fR<TAB> \fB\-v1\fR \fB\-w6\fR +.PP +CC are two delimiter characters used to construct logical page delimiters; +a missing second character implies ':'. As a GNU extension one can specify +more than two characters, and also specifying the empty string (\fB\-d\fR '') +disables section matching. +.PP +STYLE is one of: +.TP +a +number all lines +.TP +t +number only nonempty lines +.TP +n +number no lines +.TP +pBRE +number only lines that contain a match for the basic regular +expression, BRE +.PP +FORMAT is one of: +.TP +ln +left justified, no leading zeros +.TP +rn +right justified, no leading zeros +.TP +rz +right justified, leading zeros +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Scott Bartram and David MacKenzie. +.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/nl> +.br +BNU documentation is available locally via: info \(aq(bnu) nl invocation\(aq diff --git a/man/nohup.1 b/man/nohup.1 new file mode 100644 index 0000000..80f06b8 --- /dev/null +++ b/man/nohup.1 @@ -0,0 +1,66 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH NOHUP "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +nohup \- run a command immune to hangups, with output to a non-tty +.SH SYNOPSIS +.B nohup +\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]... +.br +.B nohup +\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. +.PP +Run COMMAND, ignoring hangup signals. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nohup#nohup--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nohup#nohup--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If standard input is a terminal, redirect it from an unreadable file. +If standard output is a terminal, append output to 'nohup.out' if possible, +\&'$HOME/nohup.out' otherwise. +If standard error is a terminal, redirect it to standard output. +To save output to FILE, use 'nohup COMMAND > FILE'. +.PP +Your shell may have its own version of nohup, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SS "Exit status:" +.TP +125 +if the nohup command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/nohup> +.br +BNU documentation is available locally via: info \(aq(bnu) nohup invocation\(aq diff --git a/man/nproc.1 b/man/nproc.1 new file mode 100644 index 0000000..aa4343f --- /dev/null +++ b/man/nproc.1 @@ -0,0 +1,51 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH NPROC "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +nproc \- print the number of processing units available +.SH SYNOPSIS +.B nproc +[\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. +.PP +Print the number of processing units available to the current process, +which may be less than the number of online processors. +If the 'OMP_NUM_THREADS' or 'OMP_THREAD_LIMIT' environment variables are set, +then they will determine the minimum and maximum returned value respectively. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nproc--all'\fB\-\-all\fP\X'tty: link' +print the number of installed processors, +disregarding any OpenMP environment variables, or CPU quotas. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#nproc--ignore'\fB\-\-ignore=N\fP\X'tty: link' +if possible, exclude N processing units. +The result is guaranteed to be at least 1. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nproc#nproc--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/nproc#nproc--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Giuseppe Scrivano. +.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/nproc> +.br +BNU documentation is available locally via: info \(aq(bnu) nproc invocation\(aq diff --git a/man/numfmt.1 b/man/numfmt.1 new file mode 100644 index 0000000..079d4ef --- /dev/null +++ b/man/numfmt.1 @@ -0,0 +1,196 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH NUMFMT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.\" Define monospaced roman font for groff in troff mode. +.if t .if \n(.g \{\ +. ds mono \f(CR +. ds /mono \fP +.\} +.SH NAME +numfmt \- Convert numbers from/to human-readable strings +.SH SYNOPSIS +.B numfmt +[\fI\,OPTION\/\fR]... [\fI\,NUMBER\/\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. +.PP +Reformat NUMBER(s), or the numbers from standard input if none are specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--debug'\fB\-\-debug\fP\X'tty: link' +print warnings about invalid input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt-d'\fB\-d, \-\-delimiter=\,X\fP\X'tty: link'\/\fR +use X instead of whitespace for field delimiter +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--field'\fB\-\-field=FIELDS\fP\X'tty: link' +replace the numbers in these input fields (default=1); +see FIELDS below for details +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--format'\fB\-\-format=FORMAT\fP\X'tty: link' +use printf style floating\-point FORMAT; +see FORMAT below for details +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--from'\fB\-\-from=UNIT\fP\X'tty: link' +auto\-scale input numbers to UNITs; default is 'none'; +see UNIT below for details +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--from-unit'\fB\-\-from\-unit=N\fP\X'tty: link' +specify the input unit size (instead of the default 1) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--grouping'\fB\-\-grouping\fP\X'tty: link' +use locale\-defined grouping of digits, e.g. 1,000,000. +This has no effect in the C/POSIX locale +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--header'\fB\-\-header[=N]\fP\X'tty: link' +print (without converting) the first N header lines; +N defaults to 1 if not specified +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--invalid'\fB\-\-invalid=MODE\fP\X'tty: link' +failure mode for invalid numbers; +MODE can be: abort (default), fail, warn, ignore +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--padding'\fB\-\-padding=N\fP\X'tty: link' +pad the output to N characters; +positive N will right\-align, negative N will left\-align; +padding is ignored if the output is wider than N; +the default is to automatically pad if a whitespace is found +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--round'\fB\-\-round=METHOD\fP\X'tty: link' +use METHOD for rounding when scaling; METHOD can be: +up, down, from\-zero (default), towards\-zero, nearest +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--suffix'\fB\-\-suffix=SUFFIX\fP\X'tty: link' +add SUFFIX to output numbers, +and accept an optional SUFFIX in input numbers +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--unit-separator'\fB\-\-unit\-separator=SEP\fP\X'tty: link' +insert SEP between number and unit on output, +and accept an optional SEP in input numbers +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--to'\fB\-\-to=UNIT\fP\X'tty: link' +auto\-scale output numbers to UNITs; see UNIT below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt--to-unit'\fB\-\-to\-unit=N\fP\X'tty: link' +the output unit size (instead of the default 1) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#numfmt-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/numfmt#numfmt--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/numfmt#numfmt--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "UNIT options:" +.TP +none +no auto\-scaling is done; suffixes will trigger an error +.TP +auto +accept optional single/two letter suffix: +1K = 1000, 1k = 1000, +1Ki = 1024, +1M = 1000000, +1Mi = 1048576, +.TP +si +accept optional single letter suffix: +1k = 1000, 1K = 1000, +1M = 1000000, +\&... +.TP +iec +accept optional single letter suffix: +1K = 1024, 1k = 1024, +1M = 1048576, +\&... +.TP +iec\-i +accept optional two\-letter suffix: +1Ki = 1024, 1ki = 1024, +1Mi = 1048576, +\&... +.SS "FIELDS supports \fBcut\fP(1) style field ranges:" +.TP +N +N'th field, counted from 1 +.TP +N\- +from N'th field, to end of line +.TP +N\-M +from N'th to M'th field (inclusive) +.TP +\fB\-M\fR +from first to M'th field (inclusive) +.TP +\- +all fields +.PP +Multiple fields/ranges can be separated with commas +.PP +FORMAT must be suitable for printing one floating\-point argument '%f'. +Optional quote (%'f) will enable \fB\-\-grouping\fR (if supported by current locale). +Optional width value (%10f) will pad output. Optional zero (%010f) width +will zero pad the number. Optional negative values (%\-10f) will left align. +Optional precision (%.1f) will override the input determined precision. +.PP +Exit status is 0 if all input numbers were successfully converted. +By default, numfmt will stop at the first conversion error with exit status 2. +With \fB\-\-invalid\fR=\fI\,'fail'\/\fR a warning is printed for each conversion error +and the exit status is 2. With \fB\-\-invalid\fR=\fI\,'warn'\/\fR each conversion error is +diagnosed, but the exit status is 0. With \fB\-\-invalid\fR=\fI\,'ignore'\/\fR conversion +errors are not diagnosed and the exit status is 0. +.SH EXAMPLES +.IP +\*[mono]$ numfmt --to=si 1000\*[/mono] +.IP +\-> "1.0k" +.IP +\*[mono]$ numfmt --to=iec 2048\*[/mono] +.IP +\-> "2.0K" +.IP +\*[mono]$ numfmt --to=iec-i 4096\*[/mono] +.IP +\-> "4.0Ki" +.IP +\*[mono]$ echo 1K | numfmt --from=si\*[/mono] +.IP +\-> "1000" +.IP +\*[mono]$ echo 1K | numfmt --from=iec\*[/mono] +.IP +\-> "1024" +.IP +\*[mono]$ df -B1 | numfmt --header --field 2-4 --to=si\*[/mono] +.br +\*[mono]$ ls -l | numfmt --header --field 5 --to=iec\*[/mono] +.br +\*[mono]$ ls -lh | numfmt --header --field 5 --from=iec --padding=10\*[/mono] +.br +\*[mono]$ ls -lh | numfmt --header --field 5 --from=iec --format %10f\*[/mono] +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Assaf Gordon. +.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/numfmt> +.br +BNU documentation is available locally via: info \(aq(bnu) numfmt invocation\(aq diff --git a/man/od.1 b/man/od.1 new file mode 100644 index 0000000..807ff1e --- /dev/null +++ b/man/od.1 @@ -0,0 +1,177 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH OD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +od \- dump files in octal and other formats +.SH SYNOPSIS +.B od +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B od +[\fI\,-abcdfilosx\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR]] +.br +.B od +\fI\,--traditional \/\fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR] [\fI\,+\/\fR][\fI\,LABEL\/\fR][\fI\,.\/\fR][\fI\,b\/\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. +.PP +Write an unambiguous representation, octal bytes by default, +of FILE to standard output. With more than one FILE argument, +concatenate them in the listed order to form the input. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +If first and second call formats both apply, the second format is assumed +if the last operand begins with + or (if there are 2 operands) a digit. +An OFFSET operand means \fB\-j\fR OFFSET. LABEL is the pseudo\-address +at first byte printed, incremented when dump is progressing. +For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal; +suffixes may be . for octal and b for multiply by 512. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-A'\fB\-A, \-\-address\-radix=\,RADIX\fP\X'tty: link'\/\fR +output format for file offsets; +RADIX is one of [doxn], for Decimal, Octal, Hex or None +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od--endian'\fB\-\-endian={big|little}\fP\X'tty: link' +swap input bytes according the specified order +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-j'\fB\-j, \-\-skip\-bytes=\,BYTES\fP\X'tty: link'\/\fR +skip BYTES input bytes first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-N'\fB\-N, \-\-read\-bytes=\,BYTES\fP\X'tty: link'\/\fR +limit dump to BYTES input bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-S'\fB\-S BYTES, \-\-strings[=\,BYTES]\fP\X'tty: link'\/\fR +show only NUL terminated strings +of at least BYTES (default 3) printable characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-t'\fB\-t, \-\-format=\,TYPE\fP\X'tty: link'\/\fR +select output format or formats +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-v'\fB\-v, \-\-output\-duplicates\fP\X'tty: link' +do not use * to mark line suppression +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-w'\fB\-w[BYTES], \-\-width[=\,BYTES]\fP\X'tty: link'\/\fR +output BYTES bytes per output line; +32 is implied when BYTES is not specified +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od--traditional'\fB\-\-traditional\fP\X'tty: link' +accept arguments in third form above +.TP +\X'tty: link https://www.gnu.org/software/coreutils/od#od--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/od#od--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "Traditional format specifications may be intermixed; they accumulate:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-a'\fB\-a\fP\X'tty: link' +same as \fB\-t\fR a, select named characters, ignoring high\-order bit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-b'\fB\-b\fP\X'tty: link' +same as \fB\-t\fR o1, select octal bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-c'\fB\-c\fP\X'tty: link' +same as \fB\-t\fR c, select printable characters or backslash escapes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-d'\fB\-d\fP\X'tty: link' +same as \fB\-t\fR u2, select unsigned decimal 2\-byte units +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-f'\fB\-f\fP\X'tty: link' +same as \fB\-t\fR fF, select floats +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-i'\fB\-i\fP\X'tty: link' +same as \fB\-t\fR dI, select decimal ints +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-l'\fB\-l\fP\X'tty: link' +same as \fB\-t\fR dL, select decimal longs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-o'\fB\-o\fP\X'tty: link' +same as \fB\-t\fR o2, select octal 2\-byte units +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-s'\fB\-s\fP\X'tty: link' +same as \fB\-t\fR d2, select decimal 2\-byte units +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#od-x'\fB\-x\fP\X'tty: link' +same as \fB\-t\fR x2, select hexadecimal 2\-byte units +.SS "TYPE is made up of one or more of these specifications:" +.TP +a +named character, ignoring high\-order bit +.TP +c +printable character or backslash escape +.TP +d[SIZE] +signed decimal, SIZE bytes per integer +.TP +f[SIZE] +floating point, SIZE bytes per float +.TP +o[SIZE] +octal, SIZE bytes per integer +.TP +u[SIZE] +unsigned decimal, SIZE bytes per integer +.TP +x[SIZE] +hexadecimal, SIZE bytes per integer +.PP +SIZE is a number. For TYPE in [doux], SIZE may also be C for +sizeof(char), S for sizeof(short), I for sizeof(int) or L for +sizeof(long). If TYPE is f, SIZE may also be B for Brain 16 bit, +H for Half precision float, F for sizeof(float), D for sizeof(double), +or L for sizeof(long double). +.PP +Adding a z suffix to any type displays printable characters at the end of +each output line. +.SS "BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:" +.TP +b +512 +.TP +KB +1000 +.TP +K +1024 +.TP +MB +1000*1000 +.TP +M +1024*1024 +.PP +and so on for G, T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SH EXAMPLES +.TP +.B od -A x -t x1z -v +Display hexdump format output +.TP +.B od -A o -t oS -w16 +The default output format used by od +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/od> +.br +BNU documentation is available locally via: info \(aq(bnu) od invocation\(aq diff --git a/man/paste.1 b/man/paste.1 new file mode 100644 index 0000000..e9ee4f2 --- /dev/null +++ b/man/paste.1 @@ -0,0 +1,58 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PASTE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +paste \- merge lines of files +.SH SYNOPSIS +.B paste +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Write lines consisting of the sequentially corresponding lines from +each FILE, separated by TABs, to standard output. +The newline of every line except the line from the last file +is replaced with a TAB. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#paste-d'\fB\-d, \-\-delimiters=\,LIST\fP\X'tty: link'\/\fR +reuse characters from LIST instead of TABs; +backslash escapes are supported +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#paste-s'\fB\-s, \-\-serial\fP\X'tty: link' +paste one file at a time instead of in parallel; the newline of +every line except the last line in each file is replaced with a TAB +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#paste-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/paste#paste--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/paste#paste--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David M. Ihnat and David MacKenzie. +.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/paste> +.br +BNU documentation is available locally via: info \(aq(bnu) paste invocation\(aq diff --git a/man/pathchk.1 b/man/pathchk.1 new file mode 100644 index 0000000..64f820e --- /dev/null +++ b/man/pathchk.1 @@ -0,0 +1,49 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PATHCHK "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +pathchk \- check whether file names are valid or portable +.SH SYNOPSIS +.B pathchk +[\fI\,OPTION\/\fR]... \fI\,NAME\/\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. +.PP +Diagnose invalid or non\-portable file names. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pathchk-p'\fB\-p\fP\X'tty: link' +check for most POSIX systems +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pathchk-P'\fB\-P\fP\X'tty: link' +check for empty names and leading "\-" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pathchk--portability'\fB\-\-portability\fP\X'tty: link' +check for all POSIX systems (equivalent to \fB\-p\fR \fB\-P\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pathchk#pathchk--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pathchk#pathchk--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Eggert, David MacKenzie, and Jim Meyering. +.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/pathchk> +.br +BNU documentation is available locally via: info \(aq(bnu) pathchk invocation\(aq diff --git a/man/pinky.1 b/man/pinky.1 new file mode 100644 index 0000000..2f4eb93 --- /dev/null +++ b/man/pinky.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PINKY "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +pinky \- lightweight finger +.SH SYNOPSIS +.B pinky +[\fI\,OPTION\/\fR]... [\fI\,USER\/\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/manual/coreutils.html#pinky-l'\fB\-l\fP\X'tty: link' +produce long format output for the specified USERs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-b'\fB\-b\fP\X'tty: link' +omit the user's home directory and shell in long format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-h'\fB\-h\fP\X'tty: link' +omit the user's project file in long format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-p'\fB\-p\fP\X'tty: link' +omit the user's plan file in long format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-s'\fB\-s\fP\X'tty: link' +do short format output, this is the default +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-f'\fB\-f\fP\X'tty: link' +omit the line of column headings in short format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-w'\fB\-w\fP\X'tty: link' +omit the user's full name in short format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-i'\fB\-i\fP\X'tty: link' +omit the user's full name and remote host in short format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky-q'\fB\-q\fP\X'tty: link' +omit the user's full name, remote host and idle time in short format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pinky--lookup'\fB\-\-lookup\fP\X'tty: link' +attempt to canonicalize hostnames via DNS +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pinky#pinky--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pinky#pinky--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +A lightweight 'finger' program; print user information. +The utmp file will be \fI\,/var/run/utmp\/\fP. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Joseph Arceneaux, David MacKenzie, and Kaveh Ghazi. +.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/pinky> +.br +BNU documentation is available locally via: info \(aq(bnu) pinky invocation\(aq diff --git a/man/pr.1 b/man/pr.1 new file mode 100644 index 0000000..aa421f0 --- /dev/null +++ b/man/pr.1 @@ -0,0 +1,136 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +pr \- convert text files for printing +.SH SYNOPSIS +.B pr +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Paginate or columnate FILE(s) for printing. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr--pages'\fB+FIRST_PAGE[:LAST_PAGE], \-\-pages=\,FIRST_PAGE[:LAST_PAGE]\fP\X'tty: link'\/\fR +begin [stop] printing with page FIRST_[LAST_]PAGE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-COLS'\fB\-COLS, \-\-columns=\,COLS\fP\X'tty: link'\/\fR +output COLS columns and print columns down, unless \fB\-a\fR is used. +Balance number of lines in the columns on each page +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-a'\fB\-a, \-\-across\fP\X'tty: link' +print columns across rather than down, used together with \fB\-COLS\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-c'\fB\-c, \-\-show\-control\-chars\fP\X'tty: link' +use hat notation (^G) and octal backslash notation +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-d'\fB\-d, \-\-double\-space\fP\X'tty: link' +double space the output +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-D'\fB\-D, \-\-date\-format=\,FORMAT\fP\X'tty: link'\/\fR +use FORMAT for the header date +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-e'\fB\-e[CHAR[WIDTH]], \-\-expand\-tabs[=\,CHAR[WIDTH]]\fP\X'tty: link'\/\fR +expand input CHARs (TABs) to tab WIDTH (8) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-F'\fB\-F, \-f, \-\-form\-feed\fP\X'tty: link' +use form feeds instead of newlines to separate pages +(by a 3\-line page header with \fB\-F\fR or a 5\-line header +and trailer without \fB\-F\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-h'\fB\-h, \-\-header=\,HEADER\fP\X'tty: link'\/\fR +use a centered HEADER instead of filename in page header, +\fB\-h\fR "" prints a blank line, don't use \fB\-h\fR"" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-i'\fB\-i[CHAR[WIDTH]], \-\-output\-tabs[=\,CHAR[WIDTH]]\fP\X'tty: link'\/\fR +replace spaces with CHARs (TABs) to tab WIDTH (8) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-J'\fB\-J, \-\-join\-lines\fP\X'tty: link' +merge full lines, turns off \fB\-W\fR line truncation, +no column alignment, \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR] sets separators +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-l'\fB\-l, \-\-length=\,PAGE_LENGTH\fP\X'tty: link'\/\fR +set the page length to PAGE_LENGTH (66) lines +(default number of lines of text 56, and with \fB\-F\fR 63). +implies \fB\-t\fR if PAGE_LENGTH <= 10 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-m'\fB\-m, \-\-merge\fP\X'tty: link' +print all files in parallel, one in each column, +truncate lines, but join lines of full length with \fB\-J\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-n'\fB\-n[SEP[DIGITS]], \-\-number\-lines[=\,SEP[DIGITS]]\fP\X'tty: link'\/\fR +number lines, use DIGITS (5) digits, then SEP (TAB), +default counting starts with 1st line of input file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-N'\fB\-N, \-\-first\-line\-number=\,NUMBER\fP\X'tty: link'\/\fR +start counting with NUMBER at 1st line of first +page printed (see +FIRST_PAGE) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-o'\fB\-o, \-\-indent=\,MARGIN\fP\X'tty: link'\/\fR +offset each line with MARGIN (zero) spaces, do not +affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-r'\fB\-r, \-\-no\-file\-warnings\fP\X'tty: link' +omit warning when a file cannot be opened +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-s'\fB\-s[CHAR], \-\-separator[=\,CHAR]\fP\X'tty: link'\/\fR +separate columns by a single character, default for CHAR +is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR. +\fB\-s\fR[\fI\,CHAR\/\fR] turns off line truncation of all 3 column +options (\fB\-COLS\fR|\-a \fB\-COLS\fR|\-m) except \fB\-w\fR is set +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-S'\fB\-S[STRING], \-\-sep\-string[=\,STRING]\fP\X'tty: link'\/\fR +separate columns by STRING, +without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space> +otherwise (same as \fB\-S\fR" "), no effect on column options +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-t'\fB\-t, \-\-omit\-header\fP\X'tty: link' +omit page headers and trailers; implied if PAGE_LENGTH <= 10 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-T'\fB\-T, \-\-omit\-pagination\fP\X'tty: link' +omit page headers and trailers, +eliminate any pagination by form feeds set in input files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-v'\fB\-v, \-\-show\-nonprinting\fP\X'tty: link' +use octal backslash notation +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-w'\fB\-w, \-\-width=\,PAGE_WIDTH\fP\X'tty: link'\/\fR +set page width to PAGE_WIDTH (72) characters for +multiple text\-column output only, \fB\-s\fR[\fI\,char\/\fR] turns off (72) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-W'\fB\-W, \-\-page\-width=\,PAGE_WIDTH\fP\X'tty: link'\/\fR +set page width to PAGE_WIDTH (72) characters always, +truncate lines, except \fB\-J\fR option is set, +no interference with \fB\-S\fR or \fB\-s\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pr#pr--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pr#pr--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Pete TerMaat and Roland Huebner. +.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/pr> +.br +BNU documentation is available locally via: info \(aq(bnu) pr invocation\(aq diff --git a/man/printenv.1 b/man/printenv.1 new file mode 100644 index 0000000..eecb514 --- /dev/null +++ b/man/printenv.1 @@ -0,0 +1,48 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PRINTENV "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +printenv \- print all or part of environment +.SH SYNOPSIS +.B printenv +[\fI\,OPTION\/\fR] [\fI\,VARIABLE\/\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. +.PP +Print the values of the specified environment VARIABLE(s). +If no VARIABLE is specified, print name and value pairs for them all. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#printenv-0'\fB\-0, \-\-null\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/printenv#printenv--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/printenv#printenv--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Your shell may have its own version of printenv, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie and Richard Mlynarik. +.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/printenv> +.br +BNU documentation is available locally via: info \(aq(bnu) printenv invocation\(aq diff --git a/man/printf.1 b/man/printf.1 new file mode 100644 index 0000000..a1a6be0 --- /dev/null +++ b/man/printf.1 @@ -0,0 +1,111 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PRINTF "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +printf \- format and print data +.SH SYNOPSIS +.B printf +\fI\,FORMAT \/\fR[\fI\,ARGUMENT\/\fR]... +.br +.B printf +\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. +.PP +Print ARGUMENT(s) according to FORMAT, or execute according to OPTION: +.TP +\X'tty: link https://www.gnu.org/software/coreutils/printf#printf--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/printf#printf--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +FORMAT controls the output as in C printf. Interpreted sequences are: +.TP +\e" +double quote +.TP +\e\e +backslash +.TP +\ea +alert (BEL) +.TP +\eb +backspace +.TP +\ec +produce no further output +.TP +\ee +escape +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +carriage return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +\eNNN +byte with octal value NNN (1 to 3 digits) +.TP +\exHH +byte with hexadecimal value HH (1 to 2 digits) +.TP +\euHHHH +Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits) +.TP +\eUHHHHHHHH +Unicode character with hex value HHHHHHHH (8 digits) +.TP +%% +a single % +.TP +%b +ARGUMENT as a string with '\e' escapes interpreted, +except that octal escapes should have a leading 0 like \e0NNN +.TP +%q +ARGUMENT is printed in a format that can be reused as shell input, +escaping non\-printable characters with the POSIX $'' syntax +.PP +and all C format specifications ending with one of diouxXfeEgGcs, with +ARGUMENTs converted to proper type first. Variable widths are handled. +.PP +Your shell may have its own version of printf, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBprintf\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/printf> +.br +BNU documentation is available locally via: info \(aq(bnu) printf invocation\(aq diff --git a/man/ptx.1 b/man/ptx.1 new file mode 100644 index 0000000..ceb2b03 --- /dev/null +++ b/man/ptx.1 @@ -0,0 +1,99 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PTX "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +ptx \- produce a permuted index of file contents +.SH SYNOPSIS +.B ptx +[\fI\,OPTION\/\fR]... [\fI\,INPUT\/\fR]... \fI\,(without -G)\/\fR +.br +.B ptx +\fI\,-G \/\fR[\fI\,OPTION\/\fR]... [\fI\,INPUT \/\fR[\fI\,OUTPUT\/\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. +.PP +Output a permuted index, including context, of the words in the input files. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-A'\fB\-A, \-\-auto\-reference\fP\X'tty: link' +output automatically generated references +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-G'\fB\-G, \-\-traditional\fP\X'tty: link' +behave more like System V 'ptx' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-F'\fB\-F, \-\-flag\-truncation=\,STRING\fP\X'tty: link'\/\fR +use STRING for flagging line truncations. +The default is '/' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-M'\fB\-M, \-\-macro\-name=\,STRING\fP\X'tty: link'\/\fR +macro name to use instead of 'xx' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-O'\fB\-O, \-\-format=\,roff\fP\X'tty: link'\/\fR +generate output as roff directives +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-R'\fB\-R, \-\-right\-side\-refs\fP\X'tty: link' +put references at right, not counted in \fB\-w\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-S'\fB\-S, \-\-sentence\-regexp=\,REGEXP\fP\X'tty: link'\/\fR +for end of lines or end of sentences +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-T'\fB\-T, \-\-format=\,tex\fP\X'tty: link'\/\fR +generate output as TeX directives +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-W'\fB\-W, \-\-word\-regexp=\,REGEXP\fP\X'tty: link'\/\fR +use REGEXP to match each keyword +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-b'\fB\-b, \-\-break\-file=\,FILE\fP\X'tty: link'\/\fR +word break characters in this FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-f'\fB\-f, \-\-ignore\-case\fP\X'tty: link' +fold lower case to upper case for sorting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-g'\fB\-g, \-\-gap\-size=\,NUMBER\fP\X'tty: link'\/\fR +gap size in columns between output fields +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-i'\fB\-i, \-\-ignore\-file=\,FILE\fP\X'tty: link'\/\fR +read ignore word list from FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-o'\fB\-o, \-\-only\-file=\,FILE\fP\X'tty: link'\/\fR +read only word list from this FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-r'\fB\-r, \-\-references\fP\X'tty: link' +first field of each line is a reference +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-t'\fB\-t, \-\-typeset\-mode\fP\X'tty: link' +change the default width from 72 to 100 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ptx-w'\fB\-w, \-\-width=\,NUMBER\fP\X'tty: link'\/\fR +output width in columns, reference excluded +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ptx#ptx--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ptx#ptx--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by F. Pinard. +.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/ptx> +.br +BNU documentation is available locally via: info \(aq(bnu) ptx invocation\(aq diff --git a/man/pwd.1 b/man/pwd.1 new file mode 100644 index 0000000..8deebed --- /dev/null +++ b/man/pwd.1 @@ -0,0 +1,55 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH PWD "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +pwd \- print name of current/working directory +.SH SYNOPSIS +.B pwd +[\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. +.PP +Print the full filename of the current working directory. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pwd-L'\fB\-L, \-\-logical\fP\X'tty: link' +use PWD from environment, even if it contains symlinks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pwd-P'\fB\-P, \-\-physical\fP\X'tty: link' +resolve all symlinks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pwd#pwd--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/pwd#pwd--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If no option is specified, \fB\-P\fR is assumed. +.PP +Your shell may have its own version of pwd, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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" +\fBgetcwd\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/pwd> +.br +BNU documentation is available locally via: info \(aq(bnu) pwd invocation\(aq diff --git a/man/readlink.1 b/man/readlink.1 new file mode 100644 index 0000000..4fd5c53 --- /dev/null +++ b/man/readlink.1 @@ -0,0 +1,76 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH READLINK "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +readlink \- print resolved symbolic links or canonical file names +.SH SYNOPSIS +.B readlink +[\fI\,OPTION\/\fR]... \fI\,FILE\/\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. +\fBrealpath\fP(1) is a better command +for canonicalization functionality. +.PP +Print value of a symbolic link or canonical file name +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-f'\fB\-f, \-\-canonicalize\fP\X'tty: link' +canonicalize by following every symlink +in every component of the given name recursively; +all but the last component must exist +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-e'\fB\-e, \-\-canonicalize\-existing\fP\X'tty: link' +canonicalize by following every symlink +in every component of the given name recursively; +all components must exist +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-m'\fB\-m, \-\-canonicalize\-missing\fP\X'tty: link' +canonicalize by following every symlink +in every component of the given name recursively, +without requirements on components existence +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-n'\fB\-n, \-\-no\-newline\fP\X'tty: link' +do not output the trailing delimiter +.HP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-q'\fB\-q, \-\-quiet\fP\X'tty: link' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-s'\fB\-s, \-\-silent\fP\X'tty: link' +suppress most error messages +(on by default if POSIXLY_CORRECT is not set) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-v'\fB\-v, \-\-verbose\fP\X'tty: link' +report error messages +(on by default if POSIXLY_CORRECT is set) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#readlink-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/readlink#readlink--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/readlink#readlink--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Dmitry V. Levin. +.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" +\fBreadlink\fP(2), \fBrealpath\fP(1), \fBrealpath\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/readlink> +.br +BNU documentation is available locally via: info \(aq(bnu) readlink invocation\(aq diff --git a/man/realpath.1 b/man/realpath.1 new file mode 100644 index 0000000..67483b7 --- /dev/null +++ b/man/realpath.1 @@ -0,0 +1,73 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH REALPATH "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +realpath \- print the resolved path +.SH SYNOPSIS +.B realpath +[\fI\,OPTION\/\fR]... \fI\,FILE\/\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. +.PP +Print the resolved absolute file name. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-E'\fB\-E, \-\-canonicalize\fP\X'tty: link' +all but the last component must exist (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-e'\fB\-e, \-\-canonicalize\-existing\fP\X'tty: link' +all components of the path must exist +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-m'\fB\-m, \-\-canonicalize\-missing\fP\X'tty: link' +no path components need exist or be a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-L'\fB\-L, \-\-logical\fP\X'tty: link' +resolve '..' components before symlinks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-P'\fB\-P, \-\-physical\fP\X'tty: link' +resolve symlinks as encountered (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-q'\fB\-q, \-\-quiet\fP\X'tty: link' +suppress most error messages +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath--relative-to'\fB\-\-relative\-to=DIR\fP\X'tty: link' +print the resolved path relative to DIR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath--relative-base'\fB\-\-relative\-base=DIR\fP\X'tty: link' +print absolute paths unless paths below DIR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-s'\fB\-s, \-\-strip, \-\-no\-symlinks\fP\X'tty: link' +don't expand symlinks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#realpath-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/realpath#realpath--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/realpath#realpath--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady. +.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" +\fBreadlink\fP(1), \fBreadlink\fP(2), \fBrealpath\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/realpath> +.br +BNU documentation is available locally via: info \(aq(bnu) realpath invocation\(aq diff --git a/man/rm.1 b/man/rm.1 new file mode 100644 index 0000000..cf978f6 --- /dev/null +++ b/man/rm.1 @@ -0,0 +1,119 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH RM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +rm \- remove files or directories +.SH SYNOPSIS +.B rm +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +This manual page +describes the BNU implementation of +.BR rm . +.B rm +removes each specified file. By default, it does not remove +directories. +.P +If the \fI\-I\fR or \fI\-\-interactive=once\fR option is given, +and there are more than three files or the \fI\-r\fR, \fI\-R\fR, +or \fI\-\-recursive\fR are given, then +.B rm +prompts the user for whether to proceed with the entire operation. If +the response is not affirmative, the entire command is aborted. +.P +Otherwise, if a file is unwritable, standard input is a terminal, and +the \fI\-f\fR or \fI\-\-force\fR option is not given, or the +\fI\-i\fR or \fI\-\-interactive=always\fR option is given, +.B rm +prompts the user for whether to remove the file. If the response is +not affirmative, the file is skipped. +.SH OPTIONS +.PP +Remove (unlink) the FILE(s). +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-f'\fB\-f, \-\-force\fP\X'tty: link' +ignore nonexistent files and arguments, never prompt +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-i'\fB\-i\fP\X'tty: link' +prompt before every removal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-I'\fB\-I\fP\X'tty: link' +prompt once before removing more than three files, +or when removing recursively; less intrusive than \fB\-i\fR, +while still giving protection against most mistakes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm--interactive'\fB\-\-interactive[=WHEN]\fP\X'tty: link' +prompt according to WHEN: never, once (\fB\-I\fR), or always (\fB\-i\fR); +without WHEN, prompt always +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm--one-file-system'\fB\-\-one\-file\-system\fP\X'tty: link' +when removing a hierarchy recursively, +skip any directory that is on a file system different +from that of the corresponding command line argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm--no-preserve-root'\fB\-\-no\-preserve\-root\fP\X'tty: link' +do not treat '/' specially +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm--preserve-root'\fB\-\-preserve\-root[=all]\fP\X'tty: link' +do not remove '/' (default); +with 'all', reject any command line argument +on a separate device from its parent +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-r'\fB\-r, \-R, \-\-recursive\fP\X'tty: link' +remove directories and their contents recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-d'\fB\-d, \-\-dir\fP\X'tty: link' +remove empty directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rm-v'\fB\-v, \-\-verbose\fP\X'tty: link' +explain what is being done +.TP +\X'tty: link https://www.gnu.org/software/coreutils/rm#rm--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/rm#rm--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +By default, rm does not remove directories. Use the \fB\-\-recursive\fR (\fB\-r\fR or \fB\-R\fR) +option to remove each listed directory, too, along with all of its contents. +.PP +Any attempt to remove a file whose last file name component is '.' or '..' +is rejected with a diagnostic. +.PP +To remove a file whose name starts with a '\-', for example '\-foo', +use one of these commands: +.IP +rm \fB\-\-\fR \fB\-foo\fR +.IP +rm ./\-foo +.PP +If you use rm to remove a file, it might be possible to recover +some of its contents, given sufficient expertise and/or time. For greater +assurance that the contents are unrecoverable, consider using \fBshred\fP(1). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin, David MacKenzie, Richard M. Stallman, +and Jim Meyering. +.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" +\fBunlink\fP(1), \fBunlink\fP(2), \fBchattr\fP(1), \fBshred\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/rm> +.br +BNU documentation is available locally via: info \(aq(bnu) rm invocation\(aq diff --git a/man/rmdir.1 b/man/rmdir.1 new file mode 100644 index 0000000..8bc941a --- /dev/null +++ b/man/rmdir.1 @@ -0,0 +1,53 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH RMDIR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +rmdir \- remove empty directories +.SH SYNOPSIS +.B rmdir +[\fI\,OPTION\/\fR]... \fI\,DIRECTORY\/\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. +.PP +Remove the DIRECTORY(ies), if they are empty. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rmdir--ignore-fail-on-non-empty'\fB\-\-ignore\-fail\-on\-non\-empty\fP\X'tty: link' +ignore each failure to remove a non\-empty directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rmdir-p'\fB\-p, \-\-parents\fP\X'tty: link' +remove DIRECTORY and its ancestors; +e.g., 'rmdir \fB\-p\fR a/b' is similar to 'rmdir a/b a' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#rmdir-v'\fB\-v, \-\-verbose\fP\X'tty: link' +output a diagnostic for every directory processed +.TP +\X'tty: link https://www.gnu.org/software/coreutils/rmdir#rmdir--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/rmdir#rmdir--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBrmdir\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/rmdir> +.br +BNU documentation is available locally via: info \(aq(bnu) rmdir invocation\(aq diff --git a/man/runcon.1 b/man/runcon.1 new file mode 100644 index 0000000..6058bcd --- /dev/null +++ b/man/runcon.1 @@ -0,0 +1,87 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH RUNCON "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +runcon \- run command with specified security context +.SH SYNOPSIS +.B runcon +[\fI\,CONTEXT COMMAND \/\fR[\fI\,ARG\/\fR]...] +.br +.B runcon +[\fI\,-c\/\fR] [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-t TYPE\/\fR] [\fI\,-l RANGE\/\fR] \fI\,COMMAND \/\fR[\fI\,ARG\/\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. +Run COMMAND with completely-specified CONTEXT, or with current or +transitioned security context modified by one or more of LEVEL, +ROLE, TYPE, and USER. +.PP +If none of \fI-c\fR, \fI-t\fR, \fI-u\fR, \fI-r\fR, or \fI-l\fR, is specified, +the first argument is used as the complete context. Any additional +arguments after \fICOMMAND\fR are interpreted as arguments to the +command. +.PP +Only carefully-chosen contexts are likely to run successfully. +.PP +Run a program in a different SELinux security context. +With neither CONTEXT nor COMMAND, print the current security context. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +CONTEXT +Complete security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-c'\fB\-c, \-\-compute\fP\X'tty: link' +compute process transition context before modifying +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-t'\fB\-t, \-\-type=\,TYPE\fP\X'tty: link'\/\fR +type (for same role as parent) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-u'\fB\-u, \-\-user=\,USER\fP\X'tty: link'\/\fR +user identity +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-r'\fB\-r, \-\-role=\,ROLE\fP\X'tty: link'\/\fR +role +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-l'\fB\-l, \-\-range=\,RANGE\fP\X'tty: link'\/\fR +levelrange +.TP +\X'tty: link https://www.gnu.org/software/coreutils/runcon#runcon--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/runcon#runcon--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "Exit status:" +.TP +125 +if the runcon command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Russell Coker. +.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/runcon> +.br +BNU documentation is available locally via: info \(aq(bnu) runcon invocation\(aq diff --git a/man/seq.1 b/man/seq.1 new file mode 100644 index 0000000..e3c1fa0 --- /dev/null +++ b/man/seq.1 @@ -0,0 +1,69 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SEQ "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +seq \- print a sequence of numbers +.SH SYNOPSIS +.B seq +[\fI\,OPTION\/\fR]... \fI\,LAST\/\fR +.br +.B seq +[\fI\,OPTION\/\fR]... \fI\,FIRST LAST\/\fR +.br +.B seq +[\fI\,OPTION\/\fR]... \fI\,FIRST INCREMENT LAST\/\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. +.PP +Print numbers from FIRST to LAST, in steps of INCREMENT. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#seq-f'\fB\-f, \-\-format=\,FORMAT\fP\X'tty: link'\/\fR +use printf style floating\-point FORMAT +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#seq-s'\fB\-s, \-\-separator=\,STRING\fP\X'tty: link'\/\fR +use STRING to separate numbers (default: \en) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#seq-w'\fB\-w, \-\-equal\-width\fP\X'tty: link' +equalize width by padding with leading zeroes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/seq#seq--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/seq#seq--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If FIRST or INCREMENT is omitted, it defaults to 1. That is, an +omitted INCREMENT defaults to 1 even when LAST is smaller than FIRST. +The sequence of numbers ends when the sum of the current number and +INCREMENT would become greater than LAST. +FIRST, INCREMENT, and LAST are interpreted as floating point values. +INCREMENT is usually positive if FIRST is smaller than LAST, and +INCREMENT is usually negative if FIRST is greater than LAST. +INCREMENT must not be 0; none of FIRST, INCREMENT and LAST may be NaN. +FORMAT must be suitable for printing one argument of type 'double'; +it defaults to %.PRECf if FIRST, INCREMENT, and LAST are all fixed point +decimal numbers with maximum precision PREC, and to %g otherwise. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper. +.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/seq> +.br +BNU documentation is available locally via: info \(aq(bnu) seq invocation\(aq diff --git a/man/sha1sum.1 b/man/sha1sum.1 new file mode 100644 index 0000000..c4266db --- /dev/null +++ b/man/sha1sum.1 @@ -0,0 +1,90 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHA1SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sha1sum \- compute and check SHA1 message digest +.SH SYNOPSIS +.B sha1sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SHA1 (160\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-1. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH BUGS +Do not use the MD5 algorithm for security related purposes. +Instead, use an SHA\-2, SHA\-3, or BLAKE2 algorithm, +implemented in the \fBcksum\fP(1) program. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sha1sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sha1sum invocation\(aq diff --git a/man/sha224sum.1 b/man/sha224sum.1 new file mode 100644 index 0000000..346353b --- /dev/null +++ b/man/sha224sum.1 @@ -0,0 +1,86 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHA224SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sha224sum \- compute and check SHA224 message digest +.SH SYNOPSIS +.B sha224sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SHA224 (224\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in RFC 3874. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sha224sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sha2 utilities\(aq diff --git a/man/sha256sum.1 b/man/sha256sum.1 new file mode 100644 index 0000000..265f4b1 --- /dev/null +++ b/man/sha256sum.1 @@ -0,0 +1,86 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHA256SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sha256sum \- compute and check SHA256 message digest +.SH SYNOPSIS +.B sha256sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SHA256 (256\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sha256sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sha2 utilities\(aq diff --git a/man/sha384sum.1 b/man/sha384sum.1 new file mode 100644 index 0000000..680e7b3 --- /dev/null +++ b/man/sha384sum.1 @@ -0,0 +1,86 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHA384SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sha384sum \- compute and check SHA384 message digest +.SH SYNOPSIS +.B sha384sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SHA384 (384\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sha384sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sha2 utilities\(aq diff --git a/man/sha512sum.1 b/man/sha512sum.1 new file mode 100644 index 0000000..9ebfca5 --- /dev/null +++ b/man/sha512sum.1 @@ -0,0 +1,86 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHA512SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sha512sum \- compute and check SHA512 message digest +.SH SYNOPSIS +.B sha512sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SHA512 (512\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sha512sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sha2 utilities\(aq diff --git a/man/shred.1 b/man/shred.1 new file mode 100644 index 0000000..8de40c1 --- /dev/null +++ b/man/shred.1 @@ -0,0 +1,87 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHRED "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +shred \- overwrite a file to hide its contents, and optionally delete it +.SH SYNOPSIS +.B shred +[\fI\,OPTION\/\fR]... \fI\,FILE\/\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. +.PP +Overwrite the specified FILE(s) repeatedly, in order to make it harder +for even very expensive hardware probing to recover the data. +.PP +If FILE is \-, shred standard output. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-f'\fB\-f, \-\-force\fP\X'tty: link' +change permissions to allow writing if necessary +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-n'\fB\-n, \-\-iterations=\,N\fP\X'tty: link'\/\fR +overwrite N times instead of the default (3) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred--random-source'\fB\-\-random\-source=FILE\fP\X'tty: link' +get random bytes from FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-s'\fB\-s, \-\-size=\,N\fP\X'tty: link'\/\fR +shred this many bytes (suffixes like K, M, G accepted) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-u'\fB\-u\fP\X'tty: link' +deallocate and remove file after overwriting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred--remove'\fB\-\-remove[=HOW]\fP\X'tty: link' +like \fB\-u\fR but give control on HOW to delete; See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-v'\fB\-v, \-\-verbose\fP\X'tty: link' +show details of data and metadata operations performed +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-x'\fB\-x, \-\-exact\fP\X'tty: link' +do not round file sizes up to the next full block; +this is the default for non\-regular files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shred-z'\fB\-z, \-\-zero\fP\X'tty: link' +add a final overwrite with zeros to hide shredding +.TP +\X'tty: link https://www.gnu.org/software/coreutils/shred#shred--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/shred#shred--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Delete FILE(s) if \fB\-\-remove\fR (\fB\-u\fR) is specified. The default is not to remove +the files because it is common to operate on device files like \fI\,/dev/hda\/\fP, +and those files usually should not be removed. +The optional HOW parameter indicates how to remove a directory entry: +\&'unlink' => use a standard unlink call. +\&'wipe' => also first obfuscate bytes in the name. +\&'wipesync' => also sync each obfuscated byte to the device. +The default mode is 'wipesync', but note it can be expensive. +.PP +CAUTION: shred assumes the file system and hardware overwrite data in place. +Although this is common, many platforms operate otherwise. Also, backups +and mirrors may contain unremovable copies that will let a shredded file +be recovered later. See the GNU coreutils manual for details. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Colin Plumb. +.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/shred> +.br +BNU documentation is available locally via: info \(aq(bnu) shred invocation\(aq diff --git a/man/shuf.1 b/man/shuf.1 new file mode 100644 index 0000000..b7680c2 --- /dev/null +++ b/man/shuf.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SHUF "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +shuf \- generate random permutations +.SH SYNOPSIS +.B shuf +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.br +.B shuf +\fI\,-e \/\fR[\fI\,OPTION\/\fR]... [\fI\,ARG\/\fR]... +.br +.B shuf +\fI\,-i LO-HI \/\fR[\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. +.PP +Write a random permutation of the input lines to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-e'\fB\-e, \-\-echo\fP\X'tty: link' +treat each ARG as an input line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-i'\fB\-i, \-\-input\-range=\,LO\-HI\fP\X'tty: link'\/\fR +treat each number LO through HI as an input line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-n'\fB\-n, \-\-head\-count=\,COUNT\fP\X'tty: link'\/\fR +output at most COUNT lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-o'\fB\-o, \-\-output=\,FILE\fP\X'tty: link'\/\fR +write result to FILE instead of standard output +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf--random-source'\fB\-\-random\-source=FILE\fP\X'tty: link' +get random bytes from FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-r'\fB\-r, \-\-repeat\fP\X'tty: link' +output lines can be repeated +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/shuf#shuf--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/shuf#shuf--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by 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/shuf> +.br +BNU documentation is available locally via: info \(aq(bnu) shuf invocation\(aq diff --git a/man/sleep.1 b/man/sleep.1 new file mode 100644 index 0000000..574b501 --- /dev/null +++ b/man/sleep.1 @@ -0,0 +1,48 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SLEEP "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sleep \- delay for a specified amount of time +.SH SYNOPSIS +.B sleep +\fI\,NUMBER\/\fR[\fI\,SUFFIX\/\fR]... +.br +.B sleep +\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. +.PP +Pause for NUMBER seconds, where NUMBER is an integer or floating\-point. +SUFFIX may be 's','m','h', or 'd', for seconds, minutes, hours, days. +With multiple arguments, pause for the sum of their values. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sleep#sleep--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sleep#sleep--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering 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" +\fBsleep\fP(3) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sleep> +.br +BNU documentation is available locally via: info \(aq(bnu) sleep invocation\(aq diff --git a/man/sm3sum.1 b/man/sm3sum.1 new file mode 100644 index 0000000..23bb2a0 --- /dev/null +++ b/man/sm3sum.1 @@ -0,0 +1,86 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SM3SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sm3sum \- compute and check SM3 message digest +.SH SYNOPSIS +.B sm3sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check SM3 (256\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-b'\fB\-b, \-\-binary\fP\X'tty: link' +read in binary mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-c'\fB\-c, \-\-check\fP\X'tty: link' +read checksums from the FILEs and check them +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--tag'\fB\-\-tag\fP\X'tty: link' +create a BSD\-style checksum +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-t'\fB\-t, \-\-text\fP\X'tty: link' +read in text mode (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-z'\fB\-z, \-\-zero\fP\X'tty: link' +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--ignore-missing'\fB\-\-ignore\-missing\fP\X'tty: link' +don't fail or report status for missing files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--quiet'\fB\-\-quiet\fP\X'tty: link' +don't print OK for each successfully verified file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--status'\fB\-\-status\fP\X'tty: link' +don't output anything, status code shows success +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum--strict'\fB\-\-strict\fP\X'tty: link' +exit non\-zero for improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cksum-w'\fB\-w, \-\-warn\fP\X'tty: link' +warn about improperly formatted checksum lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/cksum#cksum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The sums are computed with the 256\-bit SM3 cryptographic hash algorithm. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +There is no difference between binary mode and text mode on GNU systems. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Ulrich Drepper, Scott Miller, and David Madore. +.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" +\fBcksum\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sm3sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sm3sum invocation\(aq diff --git a/man/sort.1 b/man/sort.1 new file mode 100644 index 0000000..b4b5d02 --- /dev/null +++ b/man/sort.1 @@ -0,0 +1,163 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SORT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sort \- sort lines of text files +.SH SYNOPSIS +.B sort +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B sort +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\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. +.PP +Write sorted concatenation of all FILE(s) to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +Ordering options: +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-b'\fB\-b, \-\-ignore\-leading\-blanks\fP\X'tty: link' +ignore leading blanks when finding sort keys in each line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-d'\fB\-d, \-\-dictionary\-order\fP\X'tty: link' +consider only blanks and alphanumeric characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-f'\fB\-f, \-\-ignore\-case\fP\X'tty: link' +fold lower case to upper case characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-g'\fB\-g, \-\-general\-numeric\-sort\fP\X'tty: link' +compare according to general numerical value +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-i'\fB\-i, \-\-ignore\-nonprinting\fP\X'tty: link' +consider only printable characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-M'\fB\-M, \-\-month\-sort\fP\X'tty: link' +compare (unknown) < 'JAN' < ... < 'DEC' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-h'\fB\-h, \-\-human\-numeric\-sort\fP\X'tty: link' +compare human readable numbers (e.g., 2K 1G) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-n'\fB\-n, \-\-numeric\-sort\fP\X'tty: link' +compare according to string numerical value; +see full documentation for supported strings +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-R'\fB\-R, \-\-random\-sort\fP\X'tty: link' +shuffle, but group identical keys. See also \fBshuf\fP(1) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--random-source'\fB\-\-random\-source=FILE\fP\X'tty: link' +get random bytes from FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-r'\fB\-r, \-\-reverse\fP\X'tty: link' +reverse the result of comparisons +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--sort'\fB\-\-sort=WORD\fP\X'tty: link' +sort according to WORD: +general\-numeric \fB\-g\fR, human\-numeric \fB\-h\fR, month \fB\-M\fR, +numeric \fB\-n\fR, random \fB\-R\fR, version \fB\-V\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-V'\fB\-V, \-\-version\-sort\fP\X'tty: link' +natural sort of (version) numbers within text +.PP +Other options: +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--batch-size'\fB\-\-batch\-size=NMERGE\fP\X'tty: link' +merge at most NMERGE inputs at once; for more use temp files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-c'\fB\-c, \-\-check, \-\-check=\,diagnose\-first\fP\X'tty: link'\/\fR +check for sorted input; do not sort +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-C'\fB\-C, \-\-check=\,quiet\/, \-\-check=\,silent\fP\X'tty: link'\/\fR +like \fB\-c\fR, but do not report first bad line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--compress-program'\fB\-\-compress\-program=PROG\fP\X'tty: link' +compress temporaries with PROG; decompress them with PROG \fB\-d\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--debug'\fB\-\-debug\fP\X'tty: link' +annotate the part of the line used to sort, +and warn about questionable usage to standard error +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--files0-from'\fB\-\-files0\-from=F\fP\X'tty: link' +read input from the files specified by NUL\-terminated names in file F; +If F is \-, read names from standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-k'\fB\-k, \-\-key=\,KEYDEF\fP\X'tty: link'\/\fR +sort via a key; KEYDEF gives location and type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-m'\fB\-m, \-\-merge\fP\X'tty: link' +merge already sorted files; do not sort +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-o'\fB\-o, \-\-output=\,FILE\fP\X'tty: link'\/\fR +write result to FILE instead of standard output +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-s'\fB\-s, \-\-stable\fP\X'tty: link' +stabilize sort by disabling last\-resort comparison +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-S'\fB\-S, \-\-buffer\-size=\,SIZE\fP\X'tty: link'\/\fR +use SIZE for main memory buffer +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-t'\fB\-t, \-\-field\-separator=\,SEP\fP\X'tty: link'\/\fR +use SEP instead of non\-blank to blank transition +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-T'\fB\-T, \-\-temporary\-directory=\,DIR\fP\X'tty: link'\/\fR +use DIR for temporaries, not $TMPDIR or \fI\,/tmp\/\fP; +multiple options specify multiple directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort--parallel'\fB\-\-parallel=N\fP\X'tty: link' +change the number of sorts run concurrently to N +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-u'\fB\-u, \-\-unique\fP\X'tty: link' +output only the first of lines with equal keys; +with \fB\-c\fR, check for strict ordering +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sort-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sort#sort--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sort#sort--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +KEYDEF is F[.C][OPTS][,F[.C][OPTS]] for start and stop position, where F is a +field number and C a character position in the field; both are origin 1, and +the stop position defaults to the line's end. If neither \fB\-t\fR nor \fB\-b\fR is in +effect, characters in a field are counted from the beginning of the preceding +whitespace. OPTS is one or more single\-letter ordering options [bdfgiMhnRrV], +which override global ordering options for that key. If no key is given, use +the entire line as the key. Use \fB\-\-debug\fR to diagnose incorrect key usage. +.PP +SIZE may be followed by the following multiplicative suffixes: +% 1% of memory, b 1, K 1024 (default), and so on for M, G, T, P, E, Z, Y, R, Q. +.PP +*** WARNING *** +The locale specified by the environment affects sort order. +Set LC_ALL=C to get the traditional sort order that uses +native byte values. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Haertel 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" +\fBshuf\fP(1), \fBuniq\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sort> +.br +BNU documentation is available locally via: info \(aq(bnu) sort invocation\(aq diff --git a/man/split.1 b/man/split.1 new file mode 100644 index 0000000..8d64439 --- /dev/null +++ b/man/split.1 @@ -0,0 +1,117 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SPLIT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +split \- split a file into pieces +.SH SYNOPSIS +.B split +[\fI\,OPTION\/\fR]... [\fI\,FILE \/\fR[\fI\,PREFIX\/\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. +.PP +Output pieces of FILE to PREFIXaa, PREFIXab, ...; +default size is 1000 lines, and default PREFIX is 'x'. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-a'\fB\-a, \-\-suffix\-length=\,N\fP\X'tty: link'\/\fR +generate suffixes of length N (default 2) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split--additional-suffix'\fB\-\-additional\-suffix=SUFFIX\fP\X'tty: link' +append an additional SUFFIX to file names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-b'\fB\-b, \-\-bytes=\,SIZE\fP\X'tty: link'\/\fR +put SIZE bytes per output file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-C'\fB\-C, \-\-line\-bytes=\,SIZE\fP\X'tty: link'\/\fR +put at most SIZE bytes of records per output file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-d'\fB\-d\fP\X'tty: link' +use numeric suffixes starting at 0, not alphabetic +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split--numeric-suffixes'\fB\-\-numeric\-suffixes[=FROM]\fP\X'tty: link' +same as \fB\-d\fR, but allow setting the start value +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-x'\fB\-x\fP\X'tty: link' +use hex suffixes starting at 0, not alphabetic +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split--hex-suffixes'\fB\-\-hex\-suffixes[=FROM]\fP\X'tty: link' +same as \fB\-x\fR, but allow setting the start value +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-e'\fB\-e, \-\-elide\-empty\-files\fP\X'tty: link' +do not generate empty output files with '\-n' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split--filter'\fB\-\-filter=COMMAND\fP\X'tty: link' +write to shell COMMAND; file name is $FILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-l'\fB\-l, \-\-lines=\,NUMBER\fP\X'tty: link'\/\fR +put NUMBER lines/records per output file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-n'\fB\-n, \-\-number=\,CHUNKS\fP\X'tty: link'\/\fR +generate CHUNKS output files; see explanation below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-t'\fB\-t, \-\-separator=\,SEP\fP\X'tty: link'\/\fR +use SEP instead of newline as the record separator; +\&'\e0' (zero) specifies the NUL character +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split-u'\fB\-u, \-\-unbuffered\fP\X'tty: link' +immediately copy input to output with '\-n r/...' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#split--verbose'\fB\-\-verbose\fP\X'tty: link' +print a diagnostic just before each output file is opened +.TP +\X'tty: link https://www.gnu.org/software/coreutils/split#split--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/split#split--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SS "CHUNKS may be:" +.TP +N +split into N files based on size of input +.TP +K/N +output Kth of N to standard output +.TP +l/N +split into N files without splitting lines/records +.TP +l/K/N +output Kth of N to standard output without splitting lines/records +.TP +r/N +like 'l' but use round robin distribution +.TP +r/K/N +likewise but only output Kth of N to standard output +.PP +\fB\-n\fR (except \fB\-nr\fR) will buffer to $TMPDIR, defaulting to \fI\,/tmp\/\fP, +if the input size cannot easily be determined. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Torbjorn Granlund and Richard M. Stallman. +.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/split> +.br +BNU documentation is available locally via: info \(aq(bnu) split invocation\(aq diff --git a/man/stat.1 b/man/stat.1 new file mode 100644 index 0000000..398b9b9 --- /dev/null +++ b/man/stat.1 @@ -0,0 +1,230 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH STAT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +stat \- display file or file system status +.SH SYNOPSIS +.B stat +[\fI\,OPTION\/\fR]... \fI\,FILE\/\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. +.PP +Display file or file system status. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-L'\fB\-L, \-\-dereference\fP\X'tty: link' +follow links +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-f'\fB\-f, \-\-file\-system\fP\X'tty: link' +display file system status instead of file status +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat--cached'\fB\-\-cached=MODE\fP\X'tty: link' +specify how to use cached attributes; +useful on remote file systems. See MODE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-c'\fB\-c, \-\-format=\,FORMAT\fP\X'tty: link'\/\fR +use the specified FORMAT instead of the default; +output a newline after each use of FORMAT +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat--printf'\fB\-\-printf=FORMAT\fP\X'tty: link' +like \fB\-\-format\fR, but interpret backslash escapes, +and do not output a mandatory trailing newline; +if you want a newline, include \en in FORMAT +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-t'\fB\-t, \-\-terse\fP\X'tty: link' +print the information in terse form +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stat#stat--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stat#stat--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The MODE argument of \fB\-\-cached\fR can be: always, never, or default. +\&'always' will use cached attributes if available, while +\&'never' will try to synchronize with the latest attributes, and +\&'default' will leave it up to the underlying file system. +.PP +The valid format sequences for files (without \fB\-\-file\-system\fR): +.TP +%a +permission bits in octal (see '#' and '0' printf flags) +.TP +%A +permission bits and file type in human readable form +.TP +%b +number of blocks allocated (see %B) +.TP +%B +the size in bytes of each block reported by %b +.TP +%C +SELinux security context string +.TP +%d +device number in decimal (st_dev) +.TP +%D +device number in hex (st_dev) +.TP +%Hd +major device number in decimal +.TP +%Ld +minor device number in decimal +.TP +%f +raw mode in hex +.TP +%F +file type +.TP +%g +group ID of owner +.TP +%G +group name of owner +.TP +%h +number of hard links +.TP +%i +inode number +.TP +%m +mount point +.TP +%n +file name +.TP +%N +quoted file name with dereference if symbolic link +.TP +%o +optimal I/O transfer size hint +.TP +%s +total size, in bytes +.TP +%r +device type in decimal (st_rdev) +.TP +%R +device type in hex (st_rdev) +.TP +%Hr +major device type in decimal, for character/block device special files +.TP +%Lr +minor device type in decimal, for character/block device special files +.TP +%t +major device type in hex, for character/block device special files +.TP +%T +minor device type in hex, for character/block device special files +.TP +%u +user ID of owner +.TP +%U +user name of owner +.TP +%w +time of file birth, human\-readable; \- if unknown +.TP +%W +time of file birth, seconds since Epoch; 0 if unknown +.TP +%x +time of last access, human\-readable +.TP +%X +time of last access, seconds since Epoch +.TP +%y +time of last data modification, human\-readable +.TP +%Y +time of last data modification, seconds since Epoch +.TP +%z +time of last status change, human\-readable +.TP +%Z +time of last status change, seconds since Epoch +.PP +Valid format sequences for file systems: +.TP +%a +free blocks available to non\-superuser +.TP +%b +total data blocks in file system +.TP +%c +total file nodes in file system +.TP +%d +free file nodes in file system +.TP +%f +free blocks in file system +.TP +%i +file system ID in hex +.TP +%l +maximum length of filenames +.TP +%n +file name +.TP +%s +block size (for faster transfers) +.TP +%S +fundamental block size (for block counts) +.TP +%t +file system type in hex +.TP +%T +file system type in human readable form +.SS "--terse is equivalent to the following FORMAT:" +.IP +%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o %C +.SS "--terse --file-system is equivalent to the following FORMAT:" +.IP +%n %i %l %t %s %S %b %f %a %c %d +.PP +Your shell may have its own version of stat, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Michael Meskes. +.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" +\fBstat\fP(2), \fBstatfs\fP(2), \fBstatx\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/stat> +.br +BNU documentation is available locally via: info \(aq(bnu) stat invocation\(aq diff --git a/man/stdbuf.1 b/man/stdbuf.1 new file mode 100644 index 0000000..ae7e371 --- /dev/null +++ b/man/stdbuf.1 @@ -0,0 +1,88 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH STDBUF "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +stdbuf \- +Run COMMAND, with modified buffering operations for its standard streams. +.SH SYNOPSIS +.B stdbuf +\fI\,OPTION\/\fR... \fI\,COMMAND\/\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. +.PP +Run COMMAND, with modified buffering operations for its standard streams. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stdbuf-i'\fB\-i, \-\-input=\,MODE\fP\X'tty: link'\/\fR +adjust standard input stream buffering +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stdbuf-o'\fB\-o, \-\-output=\,MODE\fP\X'tty: link'\/\fR +adjust standard output stream buffering +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stdbuf-e'\fB\-e, \-\-error=\,MODE\fP\X'tty: link'\/\fR +adjust standard error stream buffering +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stdbuf#stdbuf--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stdbuf#stdbuf--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If MODE is 'L' the corresponding stream will be line buffered. +This option is invalid with standard input. +.PP +If MODE is '0' the corresponding stream will be unbuffered. +.PP +Otherwise MODE is a number which may be followed by one of the following: +KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G,T,P,E,Z,Y,R,Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +In this case the corresponding stream will be fully buffered with the buffer +size set to MODE bytes. +.PP +NOTE: If COMMAND adjusts the buffering of its standard streams ('tee' does +for example) then that will override corresponding changes by 'stdbuf'. +Also some filters (like 'dd' and 'cat' etc.) don't use streams for I/O, +and are thus unaffected by 'stdbuf' settings. +.SS "Exit status:" +.TP +125 +if the stdbuf command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH EXAMPLES +.B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq +.br +This will immediately display unique entries from access.log +.SH BUGS +On GLIBC platforms, specifying a buffer size, i.e., using fully buffered mode +will result in undefined operation. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady. +.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/stdbuf> +.br +BNU documentation is available locally via: info \(aq(bnu) stdbuf invocation\(aq diff --git a/man/stty.1 b/man/stty.1 new file mode 100644 index 0000000..d4b53cf --- /dev/null +++ b/man/stty.1 @@ -0,0 +1,420 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH STTY "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +stty \- change and print terminal line settings +.SH SYNOPSIS +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,SETTING\/\fR]... +.br +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-a|--all\/\fR] +.br +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-g|--save\/\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. +.PP +Print or change terminal characteristics. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stty-a'\fB\-a, \-\-all\fP\X'tty: link' +print all current settings in human\-readable form +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stty-g'\fB\-g, \-\-save\fP\X'tty: link' +print all current settings in a stty\-readable form +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stty-F'\fB\-F, \-\-file=\,DEVICE\fP\X'tty: link'\/\fR +open and use DEVICE instead of standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stty#stty--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/stty#stty--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Optional \- before SETTING indicates negation. An * marks non\-POSIX +settings. The underlying system defines which settings are available. +.SS "Special characters:" +.TP +* discard CHAR +CHAR will toggle discarding of output +.TP +eof CHAR +CHAR will send an end of file (terminate the input) +.TP +eol CHAR +CHAR will end the line +.TP +* eol2 CHAR +alternate CHAR for ending the line +.TP +erase CHAR +CHAR will erase the last character typed +.TP +intr CHAR +CHAR will send an interrupt signal +.TP +kill CHAR +CHAR will erase the current line +.TP +* lnext CHAR +CHAR will enter the next character quoted +.TP +quit CHAR +CHAR will send a quit signal +.TP +* rprnt CHAR +CHAR will redraw the current line +.TP +start CHAR +CHAR will restart the output after stopping it +.TP +stop CHAR +CHAR will stop the output +.TP +susp CHAR +CHAR will send a terminal stop signal +.TP +* swtch CHAR +CHAR will switch to a different shell layer +.TP +* werase CHAR +CHAR will erase the last word typed +.SS "Special settings:" +.TP +N +set the input and output speeds to N bauds +.TP +cols N +tell the kernel that the terminal has N columns +.TP +* columns N +same as cols N +.TP +* [\-]drain +wait for transmission before applying settings (on by default) +.TP +ispeed N +set the input speed to N +.TP +* line N +use line discipline N +.TP +min N +with \fB\-icanon\fR, set N characters minimum for a completed read +.TP +ospeed N +set the output speed to N +.TP +rows N +tell the kernel that the terminal has N rows +.TP +size +print the number of rows and columns according to the kernel +.TP +speed +print the terminal speed +.TP +time N +with \fB\-icanon\fR, set read timeout of N tenths of a second +.SS "Control settings:" +.TP +[\-]clocal +disable modem control signals +.TP +[\-]cread +allow input to be received +.TP +* [\-]crtscts +enable RTS/CTS handshaking +.TP +csN +set character size to N bits, N in [5..8] +.TP +[\-]cstopb +use two stop bits per character (one with '\-') +.TP +[\-]hup +send a hangup signal when the last process closes the tty +.TP +[\-]hupcl +same as [\-]hup +.TP +[\-]parenb +generate parity bit in output and expect parity bit in input +.TP +[\-]parodd +set odd parity (or even parity with '\-') +.TP +* [\-]cmspar +use "stick" (mark/space) parity +.SS "Input settings:" +.TP +[\-]brkint +breaks cause an interrupt signal +.TP +[\-]icrnl +translate carriage return to newline +.TP +[\-]ignbrk +ignore break characters +.TP +[\-]igncr +ignore carriage return +.TP +[\-]ignpar +ignore characters with parity errors +.TP +* [\-]imaxbel +beep and do not flush a full input buffer on a character +.TP +[\-]inlcr +translate newline to carriage return +.TP +[\-]inpck +enable input parity checking +.TP +[\-]istrip +clear high (8th) bit of input characters +.TP +* [\-]iutf8 +assume input characters are UTF\-8 encoded +.TP +* [\-]iuclc +translate uppercase characters to lowercase +.TP +* [\-]ixany +let any character restart output, not only start character +.TP +[\-]ixoff +enable sending of start/stop characters +.TP +[\-]ixon +enable XON/XOFF flow control +.TP +[\-]parmrk +mark parity errors (with a 255\-0\-character sequence) +.TP +[\-]tandem +same as [\-]ixoff +.SS "Output settings:" +.TP +* bsN +backspace delay style, N in [0..1] +.TP +* crN +carriage return delay style, N in [0..3] +.TP +* ffN +form feed delay style, N in [0..1] +.TP +* nlN +newline delay style, N in [0..1] +.TP +* [\-]ocrnl +translate carriage return to newline +.TP +* [\-]ofdel +use delete characters for fill instead of NUL characters +.TP +* [\-]ofill +use fill (padding) characters instead of timing for delays +.TP +* [\-]olcuc +translate lowercase characters to uppercase +.TP +* [\-]onlcr +translate newline to carriage return\-newline +.TP +* [\-]onlret +newline performs a carriage return +.TP +* [\-]onocr +do not print carriage returns in the first column +.TP +[\-]opost +postprocess output +.TP +* tabN +horizontal tab delay style, N in [0..3] +.TP +* tabs +same as tab0 +.TP +* \fB\-tabs\fR +same as tab3 +.TP +* vtN +vertical tab delay style, N in [0..1] +.SS "Local settings:" +.TP +[\-]crterase +echo erase characters as backspace\-space\-backspace +.TP +* crtkill +kill all line by obeying the echoprt and echoe settings +.TP +* \fB\-crtkill\fR +kill all line by obeying the echoctl and echok settings +.TP +* [\-]ctlecho +echo control characters in hat notation ('^c') +.TP +[\-]echo +echo input characters +.TP +* [\-]echoctl +same as [\-]ctlecho +.TP +[\-]echoe +same as [\-]crterase +.TP +[\-]echok +echo a newline after a kill character +.TP +* [\-]echoke +same as [\-]crtkill +.TP +[\-]echonl +echo newline even if not echoing other characters +.TP +* [\-]echoprt +echo erased characters backward, between '\e' and '/' +.TP +* [\-]extproc +enable "LINEMODE"; useful with high latency links +.TP +* [\-]flusho +discard output +.TP +[\-]icanon +enable special characters: erase, kill, werase, rprnt +.TP +[\-]iexten +enable non\-POSIX special characters +.TP +[\-]isig +enable interrupt, quit, and suspend special characters +.TP +[\-]noflsh +disable flushing after interrupt and quit special characters +.TP +* [\-]prterase +same as [\-]echoprt +.TP +* [\-]tostop +stop background jobs that try to write to the terminal +.TP +* [\-]xcase +with icanon, escape with '\e' for uppercase characters +.SS "Combination settings:" +.TP +* [\-]LCASE +same as [\-]lcase +.TP +cbreak +same as \fB\-icanon\fR +.TP +\fB\-cbreak\fR +same as icanon +.TP +cooked +same as brkint ignpar istrip icrnl ixon opost isig +icanon, eof and eol characters to their default values +.TP +\fB\-cooked\fR +same as raw +.TP +crt +same as echoe echoctl echoke +.TP +dec +same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177 +kill ^u +.TP +* [\-]decctlq +same as [\-]ixany +.TP +ek +erase and kill characters to their default values +.TP +evenp +same as parenb \fB\-parodd\fR cs7 +.TP +\fB\-evenp\fR +same as \fB\-parenb\fR cs8 +.TP +* [\-]lcase +same as xcase iuclc olcuc +.TP +litout +same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8 +.TP +\fB\-litout\fR +same as parenb istrip opost cs7 +.TP +nl +same as \fB\-icrnl\fR \fB\-onlcr\fR +.TP +\fB\-nl\fR +same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR +.TP +oddp +same as parenb parodd cs7 +.TP +\fB\-oddp\fR +same as \fB\-parenb\fR cs8 +.TP +[\-]parity +same as [\-]evenp +.TP +pass8 +same as \fB\-parenb\fR \fB\-istrip\fR cs8 +.TP +\fB\-pass8\fR +same as parenb istrip cs7 +.TP +raw +same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR +\fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR \fB\-ixon\fR \fB\-ixoff\fR \fB\-icanon\fR \fB\-opost\fR +\fB\-isig\fR \fB\-iuclc\fR \fB\-ixany\fR \fB\-imaxbel\fR \fB\-xcase\fR min 1 time 0 +.TP +\fB\-raw\fR +same as cooked +.TP +sane +same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl +icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR +\fB\-ixoff\fR \fB\-iutf8\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel \fB\-xcase\fR \fB\-olcuc\fR \fB\-ocrnl\fR +opost \fB\-ofill\fR onlcr \fB\-onocr\fR \fB\-onlret\fR nl0 cr0 tab0 bs0 vt0 ff0 +isig \fB\-tostop\fR \fB\-ofdel\fR \fB\-echoprt\fR echoctl echoke \fB\-extproc\fR \fB\-flusho\fR, +all special characters to their default values +.PP +Handle the tty line connected to standard input. Without arguments, +prints baud rate, line discipline, and deviations from stty sane. In +settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or +127; special values ^\- or undef used to disable special characters. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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/stty> +.br +BNU documentation is available locally via: info \(aq(bnu) stty invocation\(aq diff --git a/man/sum.1 b/man/sum.1 new file mode 100644 index 0000000..096f7d6 --- /dev/null +++ b/man/sum.1 @@ -0,0 +1,49 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SUM "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sum \- checksum and count the blocks in a file +.SH SYNOPSIS +.B sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print or check BSD (16\-bit) checksums. +Legacy interface to the cksum utility. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sum-r'\fB\-r\fP\X'tty: link' +use BSD sum algorithm (the default), use 1K blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sum-s'\fB\-s, \-\-sysv\fP\X'tty: link' +use System V sum algorithm, use 512 bytes blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sum#sum--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sum#sum--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Kayvan Aghaiepour and David MacKenzie. +.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/sum> +.br +BNU documentation is available locally via: info \(aq(bnu) sum invocation\(aq diff --git a/man/sync.1 b/man/sync.1 new file mode 100644 index 0000000..096a5ae --- /dev/null +++ b/man/sync.1 @@ -0,0 +1,55 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH SYNC "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +sync \- Synchronize cached writes to persistent storage +.SH SYNOPSIS +.B sync +[\fI\,OPTION\/\fR] [\fI\,FILE\/\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. +.PP +Synchronize cached writes to persistent storage +.PP +If one or more files are specified, sync only them, +or their containing file systems. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sync-d'\fB\-d, \-\-data\fP\X'tty: link' +sync only file data, no unneeded metadata +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#sync-f'\fB\-f, \-\-file\-system\fP\X'tty: link' +sync the file systems that contain the files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sync#sync--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/sync#sync--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH BUGS +Persistence guarantees vary per system. +See the system calls below for more details. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering and Giuseppe Scrivano. +.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" +\fBfdatasync\fP(2), \fBfsync\fP(2), \fBsync\fP(2), \fBsyncfs\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/sync> +.br +BNU documentation is available locally via: info \(aq(bnu) sync invocation\(aq diff --git a/man/tac.1 b/man/tac.1 new file mode 100644 index 0000000..b74dd2d --- /dev/null +++ b/man/tac.1 @@ -0,0 +1,58 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TAC "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tac \- concatenate and print files in reverse +.SH SYNOPSIS +.B tac +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Write each FILE to standard output, last line first. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tac-b'\fB\-b, \-\-before\fP\X'tty: link' +attach the separator before instead of after +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tac-r'\fB\-r, \-\-regex\fP\X'tty: link' +interpret the separator as a regular expression +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tac-s'\fB\-s, \-\-separator=\,STRING\fP\X'tty: link'\/\fR +use STRING as the separator instead of newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tac#tac--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tac#tac--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Non\-seekable input is buffered to $TMPDIR, defaulting to \fI\,/tmp\/\fP. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jay Lepreau and David MacKenzie. +.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" +\fBcat\fP(1), \fBrev\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/tac> +.br +BNU documentation is available locally via: info \(aq(bnu) tac invocation\(aq diff --git a/man/tail.1 b/man/tail.1 new file mode 100644 index 0000000..02d3e32 --- /dev/null +++ b/man/tail.1 @@ -0,0 +1,108 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TAIL "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tail \- output the last part of files +.SH SYNOPSIS +.B tail +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print the last 10 lines of each FILE to standard output. +With more than one FILE, precede each with a header giving the file name. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-c'\fB\-c, \-\-bytes=\,[+]NUM\fP\X'tty: link'\/\fR +output the last NUM bytes; +or use \fB\-c\fR +NUM to output starting with byte NUM of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail--debug'\fB\-\-debug\fP\X'tty: link' +indicate which \fB\-\-follow\fR implementation is used +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-f'\fB\-f, \-\-follow[=\,{name|descriptor}]\fP\X'tty: link'\/\fR +output appended data as the file grows; +an absent option argument means 'descriptor' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-F'\fB\-F\fP\X'tty: link' +same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-n'\fB\-n, \-\-lines=\,[+]NUM\fP\X'tty: link'\/\fR +output the last NUM lines, instead of the last 10; +or use \fB\-n\fR +NUM to skip NUM\-1 lines at the start +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail--max-unchanged-stats'\fB\-\-max\-unchanged\-stats=N\fP\X'tty: link' +with \fB\-\-follow\fR=\fI\,name\/\fR, reopen a FILE which has not +changed size after N (default 5) iterations +to see if it has been unlinked or renamed +(this is the usual case of rotated log files); +with inotify, this option is rarely useful +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail--pid'\fB\-\-pid=PID\fP\X'tty: link' +with \fB\-f\fR, exit after PID no longer exists; +can be repeated to watch multiple processes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-q'\fB\-q, \-\-quiet, \-\-silent\fP\X'tty: link' +never output headers giving file names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail--retry'\fB\-\-retry\fP\X'tty: link' +keep trying to open a file if it is inaccessible +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-s'\fB\-s, \-\-sleep\-interval=\,N\fP\X'tty: link'\/\fR +with \fB\-f\fR, sleep for approximately N seconds +(default 1.0) between iterations; +with inotify and \fB\-\-pid\fR=\fI\,P\/\fR, +check process P at least once every N seconds +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-v'\fB\-v, \-\-verbose\fP\X'tty: link' +always output headers giving file names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tail-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tail#tail--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tail#tail--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +NUM may have a multiplier suffix: +b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024, +GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +With \fB\-\-follow\fR (\fB\-f\fR), tail defaults to following the file descriptor, which +means that even if a tail'ed file is renamed, tail will continue to track +its end. This default behavior is not desirable when you really want to +track the actual name of the file, not the file descriptor (e.g., log +rotation). Use \fB\-\-follow\fR=\fI\,name\/\fR in that case. That causes tail to track the +named file in a way that accommodates renaming, removal and creation. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin, David MacKenzie, Ian Lance Taylor, +and Jim Meyering. +.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" +\fBhead\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/tail> +.br +BNU documentation is available locally via: info \(aq(bnu) tail invocation\(aq diff --git a/man/tee.1 b/man/tee.1 new file mode 100644 index 0000000..0f2c2ba --- /dev/null +++ b/man/tee.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TEE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tee \- read from standard input and write to standard output and files +.SH SYNOPSIS +.B tee +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Copy standard input to each FILE, and also to standard output. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tee-a'\fB\-a, \-\-append\fP\X'tty: link' +append to the given FILEs, do not overwrite +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tee-i'\fB\-i, \-\-ignore\-interrupts\fP\X'tty: link' +ignore interrupt signals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tee-p'\fB\-p\fP\X'tty: link' +operate in a more appropriate MODE with pipes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tee--output-error'\fB\-\-output\-error[=MODE]\fP\X'tty: link' +set behavior on write error. See MODE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tee#tee--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tee#tee--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "MODE determines behavior with write errors on the outputs:" +.TP +warn +diagnose errors writing to any output +.TP +warn\-nopipe +diagnose errors writing to any output not a pipe +.TP +exit +exit on error writing to any output +.TP +exit\-nopipe +exit on error writing to any output not a pipe +.PP +The default MODE for the \fB\-p\fR option is 'warn\-nopipe'. +With "nopipe" MODEs, exit immediately if all outputs become broken pipes. +The default operation when \fB\-\-output\-error\fR is not specified, is to +exit immediately on error writing to a pipe, and diagnose errors +writing to non pipe outputs. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Parker, Richard M. Stallman, and David MacKenzie. +.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/tee> +.br +BNU documentation is available locally via: info \(aq(bnu) tee invocation\(aq diff --git a/man/test.1 b/man/test.1 new file mode 100644 index 0000000..2a82aec --- /dev/null +++ b/man/test.1 @@ -0,0 +1,191 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TEST "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +test \- check file types and compare values +.SH SYNOPSIS +.B test +.I EXPRESSION +.br +.B test +.br +.\" \& tells doclifter the brackets are literal (Bug#31803). +.B [\& +.I EXPRESSION +.B ]\& +.br +.B "[\& ]\&" +.br +.B [\& +.I OPTION +.SH DESCRIPTION +.\" This page is derived from GNU Coreutils documentation. +This page documents BNU, an independent Bun implementation compatible with +GNU Coreutils 9.11. +.PP +Exit with the status determined by EXPRESSION. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/test#test--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/test#test--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +An omitted EXPRESSION defaults to false. Otherwise, +EXPRESSION is true or false and sets exit status. It is one of: +.TP +( EXPRESSION ) +EXPRESSION is true +.TP +! EXPRESSION +EXPRESSION is false +.TP +EXPRESSION1 \fB\-a\fR EXPRESSION2 +both EXPRESSION1 and EXPRESSION2 are true +.TP +EXPRESSION1 \fB\-o\fR EXPRESSION2 +either EXPRESSION1 or EXPRESSION2 is true +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-n'\fB\-n STRING\fP\X'tty: link' +the length of STRING is nonzero +.TP +STRING +equivalent to \fB\-n\fR STRING +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-z'\fB\-z STRING\fP\X'tty: link' +the length of STRING is zero +.TP +STRING1 = STRING2 +the strings are equal +.TP +STRING1 != STRING2 +the strings are not equal +.TP +STRING1 > STRING2 +STRING1 is greater than STRING2 in the current locale +.TP +STRING1 < STRING2 +STRING1 is less than STRING2 in the current locale +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-eq'\fBINTEGER1 \-eq INTEGER2\fP\X'tty: link' +INTEGER1 is equal to INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-ge'\fBINTEGER1 \-ge INTEGER2\fP\X'tty: link' +INTEGER1 is greater than or equal to INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-gt'\fBINTEGER1 \-gt INTEGER2\fP\X'tty: link' +INTEGER1 is greater than INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-le'\fBINTEGER1 \-le INTEGER2\fP\X'tty: link' +INTEGER1 is less than or equal to INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-lt'\fBINTEGER1 \-lt INTEGER2\fP\X'tty: link' +INTEGER1 is less than INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-ne'\fBINTEGER1 \-ne INTEGER2\fP\X'tty: link' +INTEGER1 is not equal to INTEGER2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-ef'\fBFILE1 \-ef FILE2\fP\X'tty: link' +FILE1 and FILE2 have the same device and inode numbers +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-nt'\fBFILE1 \-nt FILE2\fP\X'tty: link' +FILE1 is newer (modification date) than FILE2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-ot'\fBFILE1 \-ot FILE2\fP\X'tty: link' +FILE1 is older than FILE2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-b'\fB\-b FILE\fP\X'tty: link' +FILE exists and is block special +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-c'\fB\-c FILE\fP\X'tty: link' +FILE exists and is character special +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-d'\fB\-d FILE\fP\X'tty: link' +FILE exists and is a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-e'\fB\-e FILE\fP\X'tty: link' +FILE exists +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-f'\fB\-f FILE\fP\X'tty: link' +FILE exists and is a regular file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-g'\fB\-g FILE\fP\X'tty: link' +FILE exists and is set\-group\-ID +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-G'\fB\-G FILE\fP\X'tty: link' +FILE exists and is owned by the effective group ID +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-h'\fB\-h FILE\fP\X'tty: link' +FILE exists and is a symbolic link (same as \fB\-L\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-k'\fB\-k FILE\fP\X'tty: link' +FILE exists and has its sticky bit set +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-L'\fB\-L FILE\fP\X'tty: link' +FILE exists and is a symbolic link (same as \fB\-h\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-N'\fB\-N FILE\fP\X'tty: link' +FILE exists and has been modified since it was last read +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-O'\fB\-O FILE\fP\X'tty: link' +FILE exists and is owned by the effective user ID +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-p'\fB\-p FILE\fP\X'tty: link' +FILE exists and is a named pipe +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-r'\fB\-r FILE\fP\X'tty: link' +FILE exists and the user has read access +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-s'\fB\-s FILE\fP\X'tty: link' +FILE exists and has a size greater than zero +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-S'\fB\-S FILE\fP\X'tty: link' +FILE exists and is a socket +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-t'\fB\-t FD\fP\X'tty: link' +file descriptor FD is opened on a terminal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-u'\fB\-u FILE\fP\X'tty: link' +FILE exists and its set\-user\-ID bit is set +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-w'\fB\-w FILE\fP\X'tty: link' +FILE exists and the user has write access +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#test-x'\fB\-x FILE\fP\X'tty: link' +FILE exists and the user has execute (or search) access +.PP +Except for \fB\-h\fR and \fB\-L\fR, all FILE\-related tests dereference symbolic links. +Beware that parentheses need to be escaped (e.g., by backslashes) for shells. +INTEGER may also be \fB\-l\fR STRING, which evaluates to the length of STRING. +.PP +Binary \fB\-a\fR and \fB\-o\fR are ambiguous. Use 'test EXPR1 && test EXPR2' +or 'test EXPR1 || test EXPR2' instead. +.PP +\&'[' honors \fB\-\-help\fR and \fB\-\-version\fR, but 'test' treats them as STRINGs. +.PP +Your shell may have its own version of test and/or [, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Kevin Braunsdorf and Matthew Bradburn. +.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" +\fBaccess\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/test> +.br +BNU documentation is available locally via: info \(aq(bnu) test invocation\(aq diff --git a/man/timeout.1 b/man/timeout.1 new file mode 100644 index 0000000..1a93b7e --- /dev/null +++ b/man/timeout.1 @@ -0,0 +1,95 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TIMEOUT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +timeout \- run a command with a time limit +.SH SYNOPSIS +.B timeout +[\fI\,OPTION\/\fR]... \fI\,DURATION COMMAND \/\fR[\fI\,ARG\/\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. +.PP +Start COMMAND, and kill it if still running after DURATION. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#timeout-f'\fB\-f, \-\-foreground\fP\X'tty: link' +when not running timeout directly from a shell prompt, +allow COMMAND to read from the TTY and get TTY signals; +in this mode, children of COMMAND will not be timed out +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#timeout-k'\fB\-k, \-\-kill\-after=\,DURATION\fP\X'tty: link'\/\fR +also send a KILL signal if COMMAND is still running +this long after the initial signal was sent +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#timeout-p'\fB\-p, \-\-preserve\-status\fP\X'tty: link' +exit with the same status as COMMAND, +even when the command times out +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#timeout-s'\fB\-s, \-\-signal=\,SIGNAL\fP\X'tty: link'\/\fR +specify the signal to be sent on timeout; +SIGNAL may be a name like 'HUP' or a number; +see 'kill \fB\-l\fR' for a list of signals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#timeout-v'\fB\-v, \-\-verbose\fP\X'tty: link' +diagnose to standard error any signal sent upon timeout +.TP +\X'tty: link https://www.gnu.org/software/coreutils/timeout#timeout--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/timeout#timeout--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +DURATION is a floating point number with an optional suffix: +\&'s' for seconds (the default), 'm' for minutes, 'h' for hours or 'd' for days. +A duration of 0 disables the associated timeout. +.PP +Upon timeout, send the TERM signal to COMMAND, if no other SIGNAL specified. +The TERM signal kills any process that does not block or catch that signal. +It may be necessary to use the KILL signal, since this signal can't be caught. +.SS "Exit status:" +.TP +124 +if COMMAND times out, and \fB\-\-preserve\-status\fR is not specified +.TP +125 +if the timeout command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +137 +if COMMAND (or timeout itself) is sent the KILL (9) signal (128+9) +.TP +\- +the exit status of COMMAND otherwise +.SH BUGS +Some platforms don't currently support timeouts beyond the year 2038. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady. +.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" +\fBkill\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/timeout> +.br +BNU documentation is available locally via: info \(aq(bnu) timeout invocation\(aq diff --git a/man/touch.1 b/man/touch.1 new file mode 100644 index 0000000..95314cd --- /dev/null +++ b/man/touch.1 @@ -0,0 +1,89 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TOUCH "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +touch \- create file, or change file timestamps +.SH SYNOPSIS +.B touch +[\fI\,OPTION\/\fR]... \fI\,FILE\/\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. +.PP +Update the access and modification times of each FILE to the current time. +.PP +A FILE argument that does not exist is created empty, unless \fB\-c\fR or \fB\-h\fR +is supplied. +.PP +A FILE argument string of \- is handled specially and causes touch to +change the times of the file associated with standard output. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-a'\fB\-a\fP\X'tty: link' +change only the access time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-c'\fB\-c, \-\-no\-create\fP\X'tty: link' +do not create any files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-d'\fB\-d, \-\-date=\,STRING\fP\X'tty: link'\/\fR +parse STRING and use it instead of current time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-f'\fB\-f\fP\X'tty: link' +(ignored) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-h'\fB\-h, \-\-no\-dereference\fP\X'tty: link' +affect each symbolic link instead of any referenced file; +useful only on systems that can change the timestamps of a symlink +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-m'\fB\-m\fP\X'tty: link' +change only the modification time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-r'\fB\-r, \-\-reference=\,FILE\fP\X'tty: link'\/\fR +use this file's times instead of current time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch-t'\fB\-t [[CC]YY]MMDDhhmm[.ss]\fP\X'tty: link' +use specified time instead of current time, +with a date\-time format that differs from \fB\-d\fR's +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#touch--time'\fB\-\-time=WORD\fP\X'tty: link' +specify which time to change: +access time (\fB\-a\fR): 'access', 'atime', 'use'; +modification time (\fB\-m\fR): 'modify', 'mtime' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/touch#touch--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/touch#touch--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH "DATE STRING" +.\" NOTE: keep this paragraph in sync with the one in date.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin, Arnold Robbins, Jim Kingdon, +David MacKenzie, and Randy Smith. +.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/touch> +.br +BNU documentation is available locally via: info \(aq(bnu) touch invocation\(aq diff --git a/man/tr.1 b/man/tr.1 new file mode 100644 index 0000000..6bf656c --- /dev/null +++ b/man/tr.1 @@ -0,0 +1,151 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tr \- translate or delete characters +.SH SYNOPSIS +.B tr +[\fI\,OPTION\/\fR]... \fI\,STRING1 \/\fR[\fI\,STRING2\/\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. +.PP +Translate, squeeze, and/or delete characters from standard input, +writing to standard output. STRING1 and STRING2 specify arrays of +characters ARRAY1 and ARRAY2 that control the action. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tr-c'\fB\-c, \-C, \-\-complement\fP\X'tty: link' +use the complement of ARRAY1 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tr-d'\fB\-d, \-\-delete\fP\X'tty: link' +delete characters in ARRAY1, do not translate +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tr-s'\fB\-s, \-\-squeeze\-repeats\fP\X'tty: link' +replace each sequence of a repeated character +that is listed in the last specified ARRAY, +with a single occurrence of that character +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tr-t'\fB\-t, \-\-truncate\-set1\fP\X'tty: link' +first truncate ARRAY1 to length of ARRAY2 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tr#tr--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tr#tr--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +ARRAYs are specified as strings of characters. Most represent themselves. +Interpreted sequences are: +.TP +\eNNN +character with octal value NNN (1 to 3 octal digits) +.TP +\e\e +backslash +.TP +\ea +audible BEL +.TP +\eb +backspace +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +CHAR1\-CHAR2 +all characters from CHAR1 to CHAR2 in ascending order +.TP +[CHAR*] +in ARRAY2, copies of CHAR until length of ARRAY1 +.TP +[CHAR*REPEAT] +REPEAT copies of CHAR, REPEAT octal if starting with 0 +.TP +[:alnum:] +all letters and digits +.TP +[:alpha:] +all letters +.TP +[:blank:] +all horizontal whitespace +.TP +[:cntrl:] +all control characters +.TP +[:digit:] +all digits +.TP +[:graph:] +all printable characters, not including space +.TP +[:lower:] +all lower case letters +.TP +[:print:] +all printable characters, including space +.TP +[:punct:] +all punctuation characters +.TP +[:space:] +all horizontal or vertical whitespace +.TP +[:upper:] +all upper case letters +.TP +[:xdigit:] +all hexadecimal digits +.TP +[=CHAR=] +all characters which are equivalent to CHAR +.PP +Translation occurs if \fB\-d\fR is not given and both STRING1 and STRING2 appear. +\fB\-t\fR is only significant when translating. ARRAY2 is extended to length of +ARRAY1 by repeating its last character as necessary. Excess characters +of ARRAY2 are ignored. Character classes expand in unspecified order; +while translating, '[:lower:]' and '[:upper:]' may be used in pairs to +specify case conversion. Squeezing occurs after translation or deletion. +Arguments like '[...]' should be quoted, to avoid potential shell globbing. +.SH BUGS +.PP +Full support is available only for safe single-byte locales, +in which every possible input byte represents a single character. +The C locale is safe in GNU systems, so you can avoid this issue +in the shell by running +.B "LC_ALL=C tr" +instead of plain +.BR tr . +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/tr> +.br +BNU documentation is available locally via: info \(aq(bnu) tr invocation\(aq diff --git a/man/true.1 b/man/true.1 new file mode 100644 index 0000000..46d6bf2 --- /dev/null +++ b/man/true.1 @@ -0,0 +1,47 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TRUE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +true \- do nothing, successfully +.SH SYNOPSIS +.B true +[\fI\,ignored command line arguments\/\fR] +.br +.B true +\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. +.PP +Exit with a status code indicating success. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/true#true--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/true#true--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +Your shell may have its own version of true, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Jim Meyering. +.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/true> +.br +BNU documentation is available locally via: info \(aq(bnu) true invocation\(aq diff --git a/man/truncate.1 b/man/truncate.1 new file mode 100644 index 0000000..b6fc045 --- /dev/null +++ b/man/truncate.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TRUNCATE "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +truncate \- shrink or extend the size of a file to the specified size +.SH SYNOPSIS +.B truncate +\fI\,OPTION\/\fR... \fI\,FILE\/\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. +.PP +Shrink or extend the size of each FILE to the specified size +.PP +A FILE argument that does not exist is created. +.PP +If a FILE is larger than the specified size, the extra data is lost. +If a FILE is shorter, it is extended and the sparse extended part (hole) +reads as zero bytes. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#truncate-c'\fB\-c, \-\-no\-create\fP\X'tty: link' +do not create any files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#truncate-o'\fB\-o, \-\-io\-blocks\fP\X'tty: link' +treat SIZE as number of IO blocks instead of bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#truncate-r'\fB\-r, \-\-reference=\,RFILE\fP\X'tty: link'\/\fR +base size on RFILE +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#truncate-s'\fB\-s, \-\-size=\,SIZE\fP\X'tty: link'\/\fR +set or adjust the file size by SIZE bytes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/truncate#truncate--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/truncate#truncate--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +SIZE may also be prefixed by one of the following modifying characters: +\&'+' extend by, '\-' reduce by, '<' at most, '>' at least, +\&'/' round down to multiple of, '%' round up to multiple of. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Padraig Brady. +.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" +\fBdd\fP(1), \fBtruncate\fP(2), \fBftruncate\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/truncate> +.br +BNU documentation is available locally via: info \(aq(bnu) truncate invocation\(aq diff --git a/man/tsort.1 b/man/tsort.1 new file mode 100644 index 0000000..70e3558 --- /dev/null +++ b/man/tsort.1 @@ -0,0 +1,42 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TSORT "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tsort \- perform topological sort +.SH SYNOPSIS +.B tsort +[\fI\,OPTION\/\fR] [\fI\,FILE\/\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. +.PP +Write totally ordered list consistent with the partial ordering in FILE. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tsort#tsort--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tsort#tsort--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mark Kettenis. +.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/tsort> +.br +BNU documentation is available locally via: info \(aq(bnu) tsort invocation\(aq diff --git a/man/tty.1 b/man/tty.1 new file mode 100644 index 0000000..c3e20cb --- /dev/null +++ b/man/tty.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH TTY "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +tty \- print the file name of the terminal connected to standard input +.SH SYNOPSIS +.B tty +[\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. +.PP +Print the file name of the terminal connected to standard input. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#tty-s'\fB\-s, \-\-silent, \-\-quiet\fP\X'tty: link' +print nothing, only return an exit status +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tty#tty--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/tty#tty--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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/tty> +.br +BNU documentation is available locally via: info \(aq(bnu) tty invocation\(aq diff --git a/man/uname.1 b/man/uname.1 new file mode 100644 index 0000000..669cc05 --- /dev/null +++ b/man/uname.1 @@ -0,0 +1,71 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH UNAME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +uname \- print system information +.SH SYNOPSIS +.B uname +[\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. +.PP +Print certain system information. With no OPTION, same as \fB\-s\fR. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-a'\fB\-a, \-\-all\fP\X'tty: link' +print all information, in the following order, +except omit \fB\-p\fR and \fB\-i\fR if unknown +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-s'\fB\-s, \-\-kernel\-name\fP\X'tty: link' +print the kernel name +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-n'\fB\-n, \-\-nodename\fP\X'tty: link' +print the network node hostname +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-r'\fB\-r, \-\-kernel\-release\fP\X'tty: link' +print the kernel release +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-v'\fB\-v, \-\-kernel\-version\fP\X'tty: link' +print the kernel version +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-m'\fB\-m, \-\-machine\fP\X'tty: link' +print the machine hardware name +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-p'\fB\-p, \-\-processor\fP\X'tty: link' +print the processor type (non\-portable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-i'\fB\-i, \-\-hardware\-platform\fP\X'tty: link' +print the hardware platform (non\-portable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uname-o'\fB\-o, \-\-operating\-system\fP\X'tty: link' +print the operating system +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uname#uname--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uname#uname--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBarch\fP(1), \fBuname\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/uname> +.br +BNU documentation is available locally via: info \(aq(bnu) uname invocation\(aq diff --git a/man/unexpand.1 b/man/unexpand.1 new file mode 100644 index 0000000..873df3c --- /dev/null +++ b/man/unexpand.1 @@ -0,0 +1,64 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH UNEXPAND "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +unexpand \- convert spaces to tabs +.SH SYNOPSIS +.B unexpand +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Convert blanks in each FILE to tabs, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#unexpand-a'\fB\-a, \-\-all\fP\X'tty: link' +convert all blanks, instead of just initial blanks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#unexpand--first-only'\fB\-\-first\-only\fP\X'tty: link' +convert only leading sequences of blanks (overrides \fB\-a\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#unexpand-t'\fB\-t, \-\-tabs=\,N\fP\X'tty: link'\/\fR +have tabs N characters apart instead of 8 (enables \fB\-a\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#unexpand-t'\fB\-t, \-\-tabs=\,LIST\fP\X'tty: link'\/\fR +use comma separated list of tab positions. +The last specified position can be prefixed with '/' +to specify a tab size to use after the last +explicitly specified tab stop. Also a prefix of '+' +can be used to align remaining tab stops relative to +the last specified tab stop instead of the first column +.TP +\X'tty: link https://www.gnu.org/software/coreutils/unexpand#unexpand--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/unexpand#unexpand--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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" +\fBexpand\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/unexpand> +.br +BNU documentation is available locally via: info \(aq(bnu) unexpand invocation\(aq diff --git a/man/uniq.1 b/man/uniq.1 new file mode 100644 index 0000000..40da474 --- /dev/null +++ b/man/uniq.1 @@ -0,0 +1,89 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH UNIQ "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +uniq \- report or omit repeated lines +.SH SYNOPSIS +.B uniq +[\fI\,OPTION\/\fR]... [\fI\,INPUT \/\fR[\fI\,OUTPUT\/\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. +.PP +Filter adjacent matching lines from INPUT (or standard input), +writing to OUTPUT (or standard output). +.PP +With no options, matching lines are merged to the first occurrence. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-c'\fB\-c, \-\-count\fP\X'tty: link' +prefix lines by the number of occurrences +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-d'\fB\-d, \-\-repeated\fP\X'tty: link' +only print duplicate lines, one for each group +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-D'\fB\-D\fP\X'tty: link' +print all duplicate lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq--all-repeated'\fB\-\-all\-repeated[=METHOD]\fP\X'tty: link' +like \fB\-D\fR, but allow separating groups with an empty line; +METHOD={none(default),prepend,separate} +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-f'\fB\-f, \-\-skip\-fields=\,N\fP\X'tty: link'\/\fR +avoid comparing the first N fields +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq--group'\fB\-\-group[=METHOD]\fP\X'tty: link' +show all items, separating groups with an empty line; +METHOD={separate(default),prepend,append,both} +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-i'\fB\-i, \-\-ignore\-case\fP\X'tty: link' +ignore differences in case when comparing +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-s'\fB\-s, \-\-skip\-chars=\,N\fP\X'tty: link'\/\fR +avoid comparing the first N characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-u'\fB\-u, \-\-unique\fP\X'tty: link' +only print unique lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link' +line delimiter is NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#uniq-w'\fB\-w, \-\-check\-chars=\,N\fP\X'tty: link'\/\fR +compare no more than N characters in lines +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uniq#uniq--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uniq#uniq--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +A field is a run of blanks (usually spaces and/or TABs), then non\-blank +characters. Fields are skipped before chars. +.PP +\&'uniq' does not detect repeated lines unless they are adjacent. +You may want to sort the input first, or use 'sort \fB\-u\fR' without 'uniq'. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.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" +\fBcomm\fP(1), \fBjoin\fP(1), \fBsort\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/uniq> +.br +BNU documentation is available locally via: info \(aq(bnu) uniq invocation\(aq diff --git a/man/unlink.1 b/man/unlink.1 new file mode 100644 index 0000000..07a4bbc --- /dev/null +++ b/man/unlink.1 @@ -0,0 +1,46 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH UNLINK "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +unlink \- call the unlink function to remove the specified file +.SH SYNOPSIS +.B unlink +\fI\,FILE\/\fR +.br +.B unlink +\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. +.PP +Call the unlink function to remove the specified FILE. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/unlink#unlink--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/unlink#unlink--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Michael Stone. +.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" +\fBunlink\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/unlink> +.br +BNU documentation is available locally via: info \(aq(bnu) unlink invocation\(aq diff --git a/man/uptime.1 b/man/uptime.1 new file mode 100644 index 0000000..1d62585 --- /dev/null +++ b/man/uptime.1 @@ -0,0 +1,44 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH UPTIME "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +uptime \- tell how long the system has been running +.SH SYNOPSIS +.B uptime +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Print the current time, the length of time the system has been up, +the number of users on the system, and the average number of jobs +in the run queue over the last 1, 5 and 15 minutes. Processes in +an uninterruptible sleep state also contribute to the load average. +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uptime#uptime--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/uptime#uptime--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Joseph Arceneaux, David MacKenzie, and Kaveh Ghazi. +.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/uptime> +.br +BNU documentation is available locally via: info \(aq(bnu) uptime invocation\(aq diff --git a/man/users.1 b/man/users.1 new file mode 100644 index 0000000..74f53ce --- /dev/null +++ b/man/users.1 @@ -0,0 +1,44 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH USERS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +users \- print the user names of users currently logged in to the current host +.SH SYNOPSIS +.B users +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +Output who is currently logged in according to FILE. +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/users#users--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/users#users--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Joseph Arceneaux and David MacKenzie. +.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" +\fBgetent\fP(1), \fBwho\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/users> +.br +BNU documentation is available locally via: info \(aq(bnu) users invocation\(aq diff --git a/man/vdir.1 b/man/vdir.1 new file mode 100644 index 0000000..4903faf --- /dev/null +++ b/man/vdir.1 @@ -0,0 +1,271 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH VDIR "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +vdir \- list directory contents +.SH SYNOPSIS +.B vdir +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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. +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-a'\fB\-a, \-\-all\fP\X'tty: link' +do not ignore entries starting with . +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-A'\fB\-A, \-\-almost\-all\fP\X'tty: link' +do not list implied . and .. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--author'\fB\-\-author\fP\X'tty: link' +with \fB\-l\fR, print the author of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-b'\fB\-b, \-\-escape\fP\X'tty: link' +print C\-style escapes for nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--block-size'\fB\-\-block\-size=SIZE\fP\X'tty: link' +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-B'\fB\-B, \-\-ignore\-backups\fP\X'tty: link' +do not list implied entries ending with ~ +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-c'\fB\-c\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, ctime +(time of last change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-C'\fB\-C\fP\X'tty: link' +list entries by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--color'\fB\-\-color[=WHEN]\fP\X'tty: link' +color the output WHEN; more info below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-d'\fB\-d, \-\-directory\fP\X'tty: link' +list directories themselves, not their contents +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-D'\fB\-D, \-\-dired\fP\X'tty: link' +generate output designed for Emacs' dired mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-f'\fB\-f\fP\X'tty: link' +same as \fB\-a\fR \fB\-U\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-F'\fB\-F, \-\-classify[=\,WHEN]\fP\X'tty: link'\/\fR +append indicator (one of */=>@|) to entries WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--file-type'\fB\-\-file\-type\fP\X'tty: link' +like \fB\-F\fR, except do not append '*' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--format'\fB\-\-format=WORD\fP\X'tty: link' +across,horizontal (\fB\-x\fR), commas (\fB\-m\fR), long (\fB\-l\fR), +single\-column (\fB\-1\fR), verbose (\fB\-l\fR), vertical (\fB\-C\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--full-time'\fB\-\-full\-time\fP\X'tty: link' +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-g'\fB\-g\fP\X'tty: link' +like \fB\-l\fR, but do not list owner +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--group-directories-first'\fB\-\-group\-directories\-first\fP\X'tty: link' +group directories before files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-G'\fB\-G, \-\-no\-group\fP\X'tty: link' +in a long listing, don't print group names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--si'\fB\-\-si\fP\X'tty: link' +likewise, but use powers of 1000 not 1024 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-H'\fB\-H, \-\-dereference\-command\-line\fP\X'tty: link' +follow symbolic links listed on the command line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--dereference-command-line-symlink-to-dir'\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fP\X'tty: link' +follow each command line symbolic link that points to a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hide'\fB\-\-hide=PATTERN\fP\X'tty: link' +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hyperlink'\fB\-\-hyperlink[=WHEN]\fP\X'tty: link' +hyperlink file names WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--indicator-style'\fB\-\-indicator\-style=WORD\fP\X'tty: link' +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-i'\fB\-i, \-\-inode\fP\X'tty: link' +print the index number of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-I'\fB\-I, \-\-ignore=\,PATTERN\fP\X'tty: link'\/\fR +do not list implied entries matching shell PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-k'\fB\-k, \-\-kibibytes\fP\X'tty: link' +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-l'\fB\-l\fP\X'tty: link' +use a long listing format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-L'\fB\-L, \-\-dereference\fP\X'tty: link' +when showing file information for a symbolic link, +show information for the file the link references +rather than for the link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-m'\fB\-m\fP\X'tty: link' +fill width with a comma separated list of entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-n'\fB\-n, \-\-numeric\-uid\-gid\fP\X'tty: link' +like \fB\-l\fR, but list numeric user and group IDs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-N'\fB\-N, \-\-literal\fP\X'tty: link' +print entry names without quoting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-o'\fB\-o\fP\X'tty: link' +like \fB\-l\fR, but do not list group information +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-p'\fB\-p, \-\-indicator\-style=\,slash\fP\X'tty: link'\/\fR +append / indicator to directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-q'\fB\-q, \-\-hide\-control\-chars\fP\X'tty: link' +print ? instead of nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--show-control-chars'\fB\-\-show\-control\-chars\fP\X'tty: link' +show nongraphic characters as\-is; +the default, unless program is 'ls' and output is a terminal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Q'\fB\-Q, \-\-quote\-name\fP\X'tty: link' +enclose entry names in double quotes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--quoting-style'\fB\-\-quoting\-style=WORD\fP\X'tty: link' +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-r'\fB\-r, \-\-reverse\fP\X'tty: link' +reverse order while sorting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-R'\fB\-R, \-\-recursive\fP\X'tty: link' +list subdirectories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-s'\fB\-s, \-\-size\fP\X'tty: link' +print the allocated size of each file, in blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-S'\fB\-S\fP\X'tty: link' +sort by file size, largest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--sort'\fB\-\-sort=WORD\fP\X'tty: link' +change default 'name' sort to WORD: +none (\fB\-U\fR), size (\fB\-S\fR), time (\fB\-t\fR), +version (\fB\-v\fR), extension (\fB\-X\fR), name, width +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time'\fB\-\-time=WORD\fP\X'tty: link' +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time-style'\fB\-\-time\-style=TIME_STYLE\fP\X'tty: link' +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-t'\fB\-t\fP\X'tty: link' +sort by time, newest first; see \fB\-\-time\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-T'\fB\-T, \-\-tabsize=\,COLS\fP\X'tty: link'\/\fR +assume tab stops at each COLS instead of 8 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-u'\fB\-u\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-U'\fB\-U\fP\X'tty: link' +do not sort directory entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-v'\fB\-v\fP\X'tty: link' +natural sort of (version) numbers within text +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-w'\fB\-w, \-\-width=\,COLS\fP\X'tty: link'\/\fR +set output width to COLS. 0 means no limit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-x'\fB\-x\fP\X'tty: link' +list entries by lines instead of by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-X'\fB\-X\fP\X'tty: link' +sort alphabetically by entry extension +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Z'\fB\-Z, \-\-context\fP\X'tty: link' +print any security context of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--zero'\fB\-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-1'\fB\-1\fP\X'tty: link' +list one file per line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.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" +\fBdircolors\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/vdir> +.br +BNU documentation is available locally via: info \(aq(bnu) vdir invocation\(aq diff --git a/man/wc.1 b/man/wc.1 new file mode 100644 index 0000000..957a07b --- /dev/null +++ b/man/wc.1 @@ -0,0 +1,77 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH WC "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +wc \- print newline, word, and byte counts for each file +.SH SYNOPSIS +.B wc +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B wc +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\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. +.PP +Print newline, word, and byte counts for each FILE, and a total line if +more than one FILE is specified. A word is a nonempty sequence of non white +space delimited by white space characters or by start or end of input. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +The options below may be used to select which counts are printed, always in +the following order: newline, word, character, byte, maximum line length. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc-c'\fB\-c, \-\-bytes\fP\X'tty: link' +print the byte counts +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc-m'\fB\-m, \-\-chars\fP\X'tty: link' +print the character counts +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc-l'\fB\-l, \-\-lines\fP\X'tty: link' +print the newline counts +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc--debug'\fB\-\-debug\fP\X'tty: link' +indicate what line count acceleration is used +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc--files0-from'\fB\-\-files0\-from=F\fP\X'tty: link' +read input from the files specified by +NUL\-terminated names in file F; +If F is \-, read names from standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc-L'\fB\-L, \-\-max\-line\-length\fP\X'tty: link' +print the maximum display width +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc-w'\fB\-w, \-\-words\fP\X'tty: link' +print the word counts +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#wc--total'\fB\-\-total=WHEN\fP\X'tty: link' +when to print a line with total counts; +WHEN can be: auto, always, only, never +.TP +\X'tty: link https://www.gnu.org/software/coreutils/wc#wc--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/wc#wc--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Paul Rubin and David MacKenzie. +.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/wc> +.br +BNU documentation is available locally via: info \(aq(bnu) wc invocation\(aq diff --git a/man/who.1 b/man/who.1 new file mode 100644 index 0000000..ed683a1 --- /dev/null +++ b/man/who.1 @@ -0,0 +1,91 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH WHO "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +who \- show who is logged on +.SH SYNOPSIS +.B who +[\fI\,OPTION\/\fR]... [ \fI\,FILE | ARG1 ARG2 \/\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. +.PP +Print information about users who are currently logged in. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-a'\fB\-a, \-\-all\fP\X'tty: link' +same as \fB\-b\fR \fB\-d\fR \fB\-\-login\fR \fB\-p\fR \fB\-r\fR \fB\-t\fR \fB\-T\fR \fB\-u\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-b'\fB\-b, \-\-boot\fP\X'tty: link' +time of last system boot +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-d'\fB\-d, \-\-dead\fP\X'tty: link' +print dead processes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-H'\fB\-H, \-\-heading\fP\X'tty: link' +print line of column headings +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-l'\fB\-l, \-\-login\fP\X'tty: link' +print system login processes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who--lookup'\fB\-\-lookup\fP\X'tty: link' +attempt to canonicalize hostnames via DNS +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-m'\fB\-m\fP\X'tty: link' +only hostname and user associated with standard input +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-p'\fB\-p, \-\-process\fP\X'tty: link' +print active processes spawned by init +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-q'\fB\-q, \-\-count\fP\X'tty: link' +all login names and number of users logged on +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-r'\fB\-r, \-\-runlevel\fP\X'tty: link' +print current runlevel +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-s'\fB\-s, \-\-short\fP\X'tty: link' +print only name, line, and time (default) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-t'\fB\-t, \-\-time\fP\X'tty: link' +print last system clock change +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-T'\fB\-T, \-w, \-\-mesg\fP\X'tty: link' +add user's message status as +, \- or ? +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who-u'\fB\-u, \-\-users\fP\X'tty: link' +list users logged in, including idle time +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who--message'\fB\-\-message\fP\X'tty: link' +same as \fB\-T\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#who--writable'\fB\-\-writable\fP\X'tty: link' +same as \fB\-T\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/who#who--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/who#who--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +If ARG1 ARG2 given, \fB\-m\fR presumed: 'am i' or 'mom likes' are usual. +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Joseph Arceneaux, David MacKenzie, and Michael Stone. +.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/who> +.br +BNU documentation is available locally via: info \(aq(bnu) who invocation\(aq diff --git a/man/whoami.1 b/man/whoami.1 new file mode 100644 index 0000000..d4b6b91 --- /dev/null +++ b/man/whoami.1 @@ -0,0 +1,41 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH WHOAMI "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +whoami \- print effective user name +.SH SYNOPSIS +.B whoami +[\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. +.PP +Print the user name associated with the current effective user ID. +Same as id \fB\-un\fR. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/whoami#whoami--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/whoami#whoami--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard Mlynarik. +.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/whoami> +.br +BNU documentation is available locally via: info \(aq(bnu) whoami invocation\(aq diff --git a/man/yes.1 b/man/yes.1 new file mode 100644 index 0000000..c5cc35d --- /dev/null +++ b/man/yes.1 @@ -0,0 +1,43 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH YES "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +yes \- output a string repeatedly until killed +.SH SYNOPSIS +.B yes +[\fI\,STRING\/\fR]... +.br +.B yes +\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. +.PP +Repeatedly output a line with all specified STRING(s), or 'y'. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/yes#yes--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/yes#yes--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by David MacKenzie. +.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/yes> +.br +BNU documentation is available locally via: info \(aq(bnu) yes invocation\(aq |
