diff --git a/pages/common/nl.md b/pages/common/nl.md index 719d1098b6..6f37cedb06 100644 --- a/pages/common/nl.md +++ b/pages/common/nl.md @@ -1,24 +1,36 @@ # nl -> A utility for numbering lines, either from a file, or from `stdin`. -> More information: . +> Number lines from a file or from `stdin`. +> More information: . - 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}}` diff --git a/pages/linux/nl.md b/pages/linux/nl.md new file mode 100644 index 0000000000..81ee812997 --- /dev/null +++ b/pages/linux/nl.md @@ -0,0 +1,36 @@ +# nl + +> Number lines from a file or from `stdin`. +> More information: . + +- 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}}`