Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
PR(1)				 User Commands				 PR(1)

       pr - convert text files for printing

       pr [OPTION]... [FILE]...

       Paginate	or columnate FILE(s) for printing.

       With no FILE, or	when FILE is -,	read standard input.

       Mandatory  arguments  to	 long  options are mandatory for short options

	      begin [stop] printing with page FIRST_[LAST_]PAGE

       -COLUMN,	--columns=COLUMN
	      output COLUMN columns and	print columns down, unless -a is used.
	      Balance number of	lines in the columns on	each page

       -a, --across
	      print  columns across rather than	down, used together with -COL-

       -c, --show-control-chars
	      use hat notation (^G) and	octal backslash	notation

       -d, --double-space
	      double space the output

       -D, --date-format=FORMAT
	      use FORMAT for the header	date

       -e[CHAR[WIDTH]],	--expand-tabs[=CHAR[WIDTH]]
	      expand input CHARs (TABs)	to tab WIDTH (8)

       -F, -f, --form-feed
	      use form feeds instead of	 newlines  to  separate	 pages	(by  a
	      3-line  page header with -F or a 5-line header and trailer with-
	      out -F)

       -h, --header=HEADER
	      use a centered HEADER instead of filename	in page	header,	-h  ""
	      prints a blank line, don't use -h""

       -i[CHAR[WIDTH]],	--output-tabs[=CHAR[WIDTH]]
	      replace spaces with CHARs	(TABs) to tab WIDTH (8)

       -J, --join-lines
	      merge full lines,	turns off -W line truncation, no column	align-
	      ment, --sep-string[=STRING] sets separators

       -l, --length=PAGE_LENGTH
	      set the page length to PAGE_LENGTH (66) lines (default number of
	      lines of text 56,	and with -F 63).  implies -t if	PAGE_LENGTH <=

       -m, --merge
	      print all	files in parallel, one in each column, truncate	lines,
	      but join lines of	full length with -J

       -n[SEP[DIGITS]],	--number-lines[=SEP[DIGITS]]
	      number  lines,  use  DIGITS  (5) digits, then SEP	(TAB), default
	      counting starts with 1st line of input file

       -N, --first-line-number=NUMBER
	      start counting with NUMBER at 1st	line  of  first	 page  printed
	      (see +FIRST_PAGE)

       -o, --indent=MARGIN
	      offset  each line	with MARGIN (zero) spaces, do not affect -w or
	      -W, MARGIN will be added to PAGE_WIDTH

       -r, --no-file-warnings
	      omit warning when	a file cannot be opened

       -s[CHAR], --separator[=CHAR]
	      separate columns by a single character, default for CHAR is  the
	      <TAB>  character	without	 -w  and  'no char' with -w.  -s[CHAR]
	      turns off	line truncation	of all 3  column  options  (-COLUMN|-a
	      -COLUMN|-m) except -w is set

       -S[STRING], --sep-string[=STRING]
	      separate	columns	by STRING, without -S: Default separator <TAB>
	      with -J and <space> otherwise (same as -S" "), no	effect on col-
	      umn options

       -t, --omit-header
	      omit page	headers	and trailers; implied if PAGE_LENGTH <=	10

       -T, --omit-pagination
	      omit page	headers	and trailers, eliminate	any pagination by form
	      feeds set	in input files

       -v, --show-nonprinting
	      use octal	backslash notation

       -w, --width=PAGE_WIDTH
	      set page	width  to  PAGE_WIDTH  (72)  characters	 for  multiple
	      text-column output only, -s[char]	turns off (72)

       -W, --page-width=PAGE_WIDTH
	      set  page	 width	to PAGE_WIDTH (72) characters always, truncate
	      lines, except -J option is set, no interference with -S or -s

       --help display this help	and exit

	      output version information and exit

       Written by Pete TerMaat and Roland Huebner.

       GNU coreutils online help: <>
       Report any translation bugs to <>

       Copyright (C) 2020 Free Software	Foundation, Inc.  License GPLv3+:  GNU
       GPL version 3 or	later <>.
       This  is	 free  software:  you  are free	to change and redistribute it.
       There is	NO WARRANTY, to	the extent permitted by	law.

       Full documentation <>
       or available locally via: info '(coreutils) pr invocation'

GNU coreutils 8.32		  March	2020				 PR(1)


Want to link to this manual page? Use this URL:

home | help