Usage - Description - Options - Examples - Return codes
numl [log logfile] [options] [infile] [to outfile]
numl copies infile to outfile, preceeding every line with a line number (1, 2, ...).
If you don't specify infile, numl reads from standard input.
If you don't specify outfile, numl writes to standard output.
If you don't specify logfile, numl writes error messages to standard
error.
numl recognizes the following command line options:
Option | Function |
---|---|
-f[-][0]W[S] | Specify line number format.
[] denotes an optional item.
- : left justify line number. |
-sN | Start numbering with number N. |
-nw | Don't number lines containing only whitespace. |
-ne | Don't number empty lines. |
-cw | Don't count or number lines containing only whitespace. |
-ce | Don't count or number empty lines. |
-v | Print version banner and usage info to standard error (or logfile, if given), then exit. |
An empty line is a line containing only newline.
Consider the example file "mydata.txt", containing four lines:
this is the first line and this is the second and this is the last
The command:
numl mydata.txt
prints:
1 this is the first line 2 and this is the second 3 4 and this is the last
The command:
numl -s0 -nw "-f03 : " mydata.txt
prints:
0000 : this is the first line 0001 : and this is the second 0003 : and this is the last
The command:
numl -cw mydata.txt
prints:
1 this is the first line 2 and this is the second 3 and this is the last
numl returns with one of the following codes ("error levels"):
Code | Meaning |
---|---|
0 | Success |
102 | Incorrect command line arguments |
104 | Error opening file |
105 | I/O error |
107 | File name clash |