# NUML v1.00 - number lines

#### Revised 8-Mar-97. Copyright (c) 1996-97 by Rune Berg. TextTools Freeware.

Usage - Description - Options - Examples

### USAGE

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

### DESCRIPTION

numl copies infile to outfile, preceeding every line with a lines number.

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

-f[-][0]W[S] : Line number format.

Optional - : left justify.
Optional 0 : pad with zeros.
W : width, 1 .. 99.
Optional S : separator string (max. 10 chars).

-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.

### 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

##### End of document