User Commands                                               PR(1)



NAME
     pr - convert text files for printing

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

DESCRIPTION
     Paginate or columnate FILE(s) for printing.

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

     ]FIRSTPAGE[:LASTPAGE], --pages=FIRSTPAGE[:LASTPAGE]
          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 -COLUMN

     -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 without -F)

     -h HEADER, --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 alignment, --sep-string[=STRING] sets separators




pr 6.7             Last change: December 2006                   1






User Commands                                               PR(1)



     -l PAGELENGTH, --length=PAGELENGTH
          set the page length to PAGELENGTH (66) lines  (default
          number of lines of text 56, and with -F 63)

     -m, --merge
          print all files in parallel, one in each column,  trun-
          cate 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 NUMBER, --first-line-number=NUMBER
          start counting with NUMBER at 1st line  of  first  page
          printed (see ]FIRSTPAGE)

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

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

     -STRING, --sep-string[=STRING]
          separate columns by STRING, without -S: Default separa-
          tor    with  -J and  otherwise (same as -S"
          "), no effect on column options

     -t, --omit-header
          omit page headers and trailers

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

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

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

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



pr 6.7             Last change: December 2006                   2






User Commands                                               PR(1)



     --help
          display this help and exit

     --version
          output version information and exit

     -T implied by -l nn when nn <= 10 or <= 3 with -F.  With  no
     FILE, or when FILE is -, read standard input.

AUTHOR
     Written by Pete TerMaat and Roland Huebner.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright O 2006 Free Software Foundation, Inc.
     This is free software.  You may redistribute  copies  of  it
     under   the   terms   of  the  GNU  General  Public  License
     .  There  is  NO  WAR-
     RANTY, to the extent permitted by law.

SEE ALSO
     The full documentation for pr is  maintained  as  a  Texinfo
     manual.   If the info and pr programs are properly installed
     at your site, the command

          info pr

     should give you access to the complete manual.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE      ATRIBUTE VALUE  
    
     Availability         SUNWgnu-coreutils 
    
     Interface Stability  Uncommitted       
    

NOTES
     Source    for    GNU    coreutils    is     available     on
     http:/opensolaris.org.









pr 6.7             Last change: December 2006                   3