common/nl: update page; linux/nl: add page (#12163)

* common/nl: update page; linux/nl: add page

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

pages/common/nl.md

@@ -1,24 +1,36 @@
 # nl
 
-> A utility for numbering lines, either from a file, or from `stdin`.
-> More information: <https://www.gnu.org/software/coreutils/nl>.
+> Number lines from a file or from `stdin`.
+> More information: <https://manned.org/nl.1p>.
 
 - Number non-blank lines in a file:
 
 `nl {{path/to/file}}`
 
-- Read from `stdout`:
+- Read from `stdin`:
 
-`cat {{path/to/file}} | nl {{options}} -`
+`{{command}} | nl -`
 
-- Number only the lines with printable text:
+- Number [a]ll [b]ody lines including blank lines or do [n]ot number body lines:
 
-`nl -t {{path/to/file}}`
+`nl -b {{a|n}} {{path/to/file}}`
 
-- Number all lines including blank lines:
-
-`nl -b a {{path/to/file}}`
-
-- Number only the body lines that match a basic regular expression (BRE) pattern:
+- Number only the [b]ody lines that match a basic regular expression (BRE) [p]attern:
 
 `nl -b p'FooBar[0-9]' {{path/to/file}}`
+
+- Use a specific [i]ncrement for line numbering:
+
+`nl -i {{increment}} {{path/to/file}}`
+
+- Specify the line numbering format to [r]ight or [l]eft justified, keeping leading [z]eros or [n]ot:
+
+`nl -n {{rz|ln|rn}}`
+
+- Specify the line numbering's [w]idth (6 by default):
+
+`nl -w {{col_width}} {{path/to/file}}`
+
+- Use a specific string to [s]eparate the line numbers from the lines (TAB by default):
+
+`nl -s {{separator}} {{path/to/file}}`

pages/linux/nl.md

@@ -0,0 +1,36 @@
+# nl
+
+> Number lines from a file or from `stdin`.
+> More information: <https://manned.org/nl.1p>.
+
+- Number non-blank lines in a file:
+
+`nl {{path/to/file}}`
+
+- Read from `stdin`:
+
+`{{command}} | nl -`
+
+- Number [a]ll [b]ody lines including blank lines or do not [n]umber [b]ody lines:
+
+`nl --body-numbering {{a|n}} {{path/to/file}}`
+
+- Number only the [b]ody lines that match a basic regular expression (BRE) [p]attern:
+
+`nl --body-numbering p'FooBar[0-9]' {{path/to/file}}`
+
+- Use a specific [i]ncrement for line numbering:
+
+`nl --line-increment {{increment}} {{path/to/file}}`
+
+- Specify the line numbering format to [r]ight or [l]eft justified, keeping leading [z]eros or [n]ot:
+
+`nl --number-format {{rz|ln|rn}}`
+
+- Specify the line numbering's width (6 by default):
+
+`nl --number-width {{col_width}} {{path/to/file}}`
+
+- Use a specific string to separate the line numbers from the lines (TAB by default):
+
+`nl --number-separator {{separator}} {{path/to/file}}`