man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

nl (1g)

Name

nl - number lines of files

Synopsis

nl [OPTION]... [FILE]...

Description




User Commands                                               NL(1)



NAME
     nl - number lines of files

SYNOPSIS
     nl [OPTION]... [FILE]...

DESCRIPTION
     Write each FILE to standard output, with line numbers added.
     With no FILE, or when FILE is -, read standard input.

     Mandatory arguments to long options are mandatory for  short
     options too.

     -b, --body-numbering=STYLE
          use STYLE for numbering body lines

     -d, --section-delimiter=CC
          use CC for separating logical pages

     -f, --footer-numbering=STYLE
          use STYLE for numbering footer lines

     -h, --header-numbering=STYLE
          use STYLE for numbering header lines

     -i, --line-increment=NUMBER
          line number increment at each line

     -l, --join-blank-lines=NUMBER
          group of NUMBER empty lines counted as one

     -n, --number-format=FORMAT
          insert line numbers according to FORMAT

     -p, --no-renumber
          do not reset line numbers at logical pages

     -s, --number-separator=STRING
          add STRING after (possible) line number

     -v, --starting-line-number=NUMBER
          first line number on each logical page

     -w, --number-width=NUMBER
          use NUMBER columns for line numbers

     --help
          display this help and exit

     --version
          output version information and exit




GNU coreutils 8.16   Last change: March 2012                    1






User Commands                                               NL(1)



     By  default, selects -v1 -i1 -l1 -sTAB -w6 -nrn -hn -bt -fn.
     CC are  two  delimiter  characters  for  separating  logical
     pages, a missing second character implies :.  Type \\ for \.
     STYLE is one of:

     a    number all lines

     t    number only nonempty lines

     n    number no lines

     pBRE number only lines that contain a match  for  the  basic
          regular expression, BRE

     FORMAT is one of:

     ln   left justified, no leading zeros

     rn   right justified, no leading zeros

     rz   right justified, leading zeros

AUTHOR
     Written by Scott Bartram and David MacKenzie.

REPORTING BUGS
     Report nl bugs to bug-coreutils@gnu.org
     GNU  coreutils home page: <http://www.gnu.org/software/core-
     utils/>
     General help using GNU  software:  <http://www.gnu.org/geth-
     elp/>
     Report   nl   translation  bugs  to  <http://translationpro-
     ject.org/team/>

COPYRIGHT
     Copyright (C) 2012 Free Software Foundation,  Inc.   License
     GPLv3+:      GNU      GPL     version     3     or     later
     <http://gnu.org/licenses/gpl.html>.
     This is free software: you are free  to  change  and  redis-
     tribute  it.   There is NO WARRANTY, to the extent permitted
     by law.


ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:









GNU coreutils 8.16   Last change: March 2012                    2






User Commands                                               NL(1)



     +---------------+--------------------+
     |ATTRIBUTE TYPE |  ATTRIBUTE VALUE   |
     +---------------+--------------------+
     |Availability   | file/gnu-coreutils |
     +---------------+--------------------+
     |Stability      | Uncommitted        |
     +---------------+--------------------+
SEE ALSO
     The  full  documentation  for  nl is maintained as a Texinfo
     manual.  If the info and nl programs are properly  installed
     at your site, the command

          info coreutils 'nl invocation'

     should give you access to the complete manual.



NOTES
     This   software   was   built   from   source  available  at
     https://java.net/projects/solaris-userland.   The   original
     community       source       was       downloaded       from
     http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz

     Further information about this software can be found on  the
     open  source  community  website at http://www.gnu.org/soft-
     ware/coreutils/.




























GNU coreutils 8.16   Last change: March 2012                    3