aboutsummaryrefslogtreecommitdiff
path: root/man/nl.1
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-07-28 16:08:14 +1000
committerSoccera1 <[email protected]>2026-07-28 16:08:48 +1000
commit9846f087eb28bf11df740675ef487657ded39b69 (patch)
treee91dbd19b524f9432da6bcb86b1fc193e0d02e26 /man/nl.1
parent7fa396c9ef22b32a0b05e94aaa0266dd3e7515f8 (diff)
parent6a2f098e72e71437154ec00506e8e736aa8e1026 (diff)
downloadbnu-9846f087eb28bf11df740675ef487657ded39b69.tar.gz
bnu-9846f087eb28bf11df740675ef487657ded39b69.zip
Merge branch 'master' into refactor/single-call-commandsrefactor/single-call-commands
# Conflicts: # README.md
Diffstat (limited to 'man/nl.1')
-rw-r--r--man/nl.1110
1 files changed, 110 insertions, 0 deletions
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