# NUML v1.10 - number lines

#### Revised 23-Aug-97. Copyright (c) 1996-97 by Rune Berg. TextTools Freeware.

Usage - Description - Options - Examples - Return codes

### USAGE

numl [log logfile] [options] [infile] [to outfile]

### DESCRIPTION

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.

### OPTIONS

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. 0 : pad line number with zeros. W : print line number in field of width W (1..99). S : use string S (max. 10 chars) to separate line number and line content.
-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.

### EXAMPLES

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

### RETURN CODES

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

##### End of document