GopherProxy

	nl.1 - sbase - suckless unix tools
	git clone git://git.suckless.org/sbase
	Log
	Files
	Refs
	README
	LICENSE
	---
	nl.1 (2261B)
	---
	1 .Dd May 15, 2020
	2 .Dt NL 1
	3 .Os sbase
	4 .Sh NAME
	5 .Nm nl
	6 .Nd line numbering filter
	7 .Sh SYNOPSIS
	8 .Nm
	9 .Op Fl p
	10 .Op Fl b Ar type
	11 .Op Fl d Ar delim
	12 .Op Fl f Ar type
	13 .Op Fl h Ar type
	14 .Op Fl i Ar num
	15 .Op Fl l Ar num
	16 .Op Fl n Ar format
	17 .Op Fl s Ar sep
	18 .Op Fl v Ar num
	19 .Op Fl w Ar num
	20 .Op Ar file
	21 .Sh DESCRIPTION
	22 .Nm
	23 reads lines from
	24 .Ar file
	25 and writes them to stdout, numbering non-empty lines.
	26 If no
	27 .Ar file
	28 is given
	29 .Nm
	30 reads from stdin.
	31 .Pp
	32 .Nm
	33 treats the input text as a collection of logical pages divided into
	34 logical page sections.
	35 Each logical page consists of a header section, a body
	36 section and a footer section.
	37 Sections may be empty.
	38 The start of each section is indicated by a single delimiting line, one …
	39 .Bl -column "\e:\e:\e: " "header " -offset indent
	40 .It Em "Line" Ta Em "Start of"
	41 .It \e:\e:\e: header
	42 .It \e:\e: body
	43 .It \e: footer
	44 .El
	45 .Pp
	46 If the input text contains no delimiting line then all of the input text
	47 belongs to a single logical page body section.
	48 .Sh OPTIONS
	49 .Bl -tag -width Ds
	50 .It Fl p
	51 Do not reset line number for logical pages.
	52 .It Fl h Ar type \| Fl b Ar type \| Fl f Ar type
	53 Define which lines to number in the head \| body \| footer section:
	54 .Bl -tag -width pstringXX
	55 .It a
	56 All lines.
	57 .It n
	58 No lines.
	59 .It t
	60 Only non-empty lines.
	61 This is the default.
	62 .It p Ns Ar expr
	63 Only lines matching
	64 .Ar expr
	65 according to
	66 .Xr regex 7 or
	67 .Xr re_format 7 .
	68 .El
	69 .It Fl d Ar delim
	70 Set
	71 .Ar delim
	72 as the delimiter for logical pages.
	73 If
	74 .Ar delim
	75 is only one character,
	76 .Nm
	77 appends ":" to it.
	78 The default is "\e:".
	79 .It Fl i Ar num
	80 Set the increment between numbered lines to
	81 .Ar num .
	82 .It Fl l Ar num
	83 Set the number of adjacent blank lines to be considered as one to
	84 .Ar num .
	85 The default is 1.
	86 .It Fl n Ar format
	87 Set the line number output
	88 .Ar format
	89 to one of:
	90 .Bl -tag -width pstringXX
	91 .It ln
	92 Left justified.
	93 .It rn
	94 Right justified.
	95 This is the default.
	96 .It rz
	97 Right justified with leading zeroes.
	98 .El
	99 .It Fl s Ar sep
	100 Use
	101 .Ar sep
	102 to separate line numbers and lines.
	103 The default is "\et".
	104 .It Fl v Ar num
	105 Start counting lines from
	106 .Ar num .
	107 The default is 1.
	108 .It Fl w Ar num
	109 Set the width of the line number to
	110 .Ar num .
	111 The default is 6.
	112 .El
	113 .Sh SEE ALSO
	114 .Xr pr 1
	115 .Sh STANDARDS
	116 The
	117 .Nm
	118 utility is compliant with the
	119 .St -p1003.1-2013
	120 specification.