diff options
| author | Soccera1 <[email protected]> | 2026-07-28 15:54:54 +1000 |
|---|---|---|
| committer | Soccera1 <[email protected]> | 2026-07-28 15:54:54 +1000 |
| commit | 6a2f098e72e71437154ec00506e8e736aa8e1026 (patch) | |
| tree | 63e9f5596be38558dbeb40bb566735759a3ccabb /man/nl.1 | |
| parent | a753f669c9bedfccb9f7f400da018bb487dca5d0 (diff) | |
| download | bnu-6a2f098e72e71437154ec00506e8e736aa8e1026.tar.gz bnu-6a2f098e72e71437154ec00506e8e736aa8e1026.zip | |
Add docs
Diffstat (limited to 'man/nl.1')
| -rw-r--r-- | man/nl.1 | 110 |
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 |
