1PSNUP(1)                    General Commands Manual                   PSNUP(1)
2
3
4

NAME

6       psnup - multiple pages per sheet
7

SYNOPSIS

9       psnup  [  -wwidth ] [ -hheight ] [ -ppaper ] [ -Wwidth ] [ -Hheight ] [
10       -Ppaper ] [ -l ] [ -r ] [ -f ] [ -c ] [  -mmargin  ]  [  -bborder  ]  [
11       -dlwidth ] [ -sscale ] [ -nup ] [ -q ] [ infile [ outfile ] ]
12

DESCRIPTION

14       Psnup  puts  multiple  logical pages onto each physical sheet of paper.
15       The input PostScript file should follow the Adobe Document  Structuring
16       Conventions.
17
18       The  -w option gives the paper width, and the -h option gives the paper
19       height, normally specified in cm or in to convert  PostScript's  points
20       (1/72  of an inch) to centimeters or inches.  The -p option can be used
21       as an alternative, to set the paper size to a3,  a4,  a5,  b5,  letter,
22       legal,  tabloid,  statement, executive, folio, quarto, 10x14 or _glibc,
23       where latter one means the format of the current locale.   The  default
24       paper  size  is _glibc.  The -W, -H, and -P options set the input paper
25       size, if it is different from the output size. This makes  it  easy  to
26       impose pages of one size on a different size of paper.
27
28       The  -l option should be used for pages which are in landscape orienta‐
29       tion (rotated 90 degrees anticlockwise). The -r option should  be  used
30       for  pages which are in seascape orientation (rotated 90 degrees clock‐
31       wise), and the -f option should be used for pages which have the  width
32       and height interchanged, but are not rotated.
33
34       Psnup normally uses `row-major' layout, where adjacent pages are placed
35       in rows across the paper.  The -c option changes the order to  `column-
36       major', where successive pages are placed in columns down the paper.
37
38       A  margin  to  leave around the whole page can be specified with the -m
39       option. This is useful for sheets of  `thumbnail'  pages,  because  the
40       normal  page  margins are reduced by putting multiple pages on a single
41       sheet.
42
43       The -b option is used to specify an additional margin around each  page
44       on a sheet.
45
46       The -d option draws a line around the border of each page, of the spec‐
47       ified width.  If the lwidth parameter is omitted, a  default  linewidth
48       of  1  point is assumed. The linewidth is relative to the original page
49       dimensions, i.e. it is scaled down with the rest of the page.
50
51       The scale chosen by psnup can be overridden with the -s option. This is
52       useful to merge pages which are already reduced.
53
54       The  -nup  option  selects  the  number of logical pages to put on each
55       sheet of paper. This can be any whole number; psnup tries  to  optimise
56       the layout so that the minimum amount of space is wasted. If psnup can‐
57       not find a layout within its tolerance limit, it  will  abort  with  an
58       error message. The alternative form i nup can also be used, for compat‐
59       ibility with other n-up programs.
60
61       Psnup normally prints the page numbers of the pages re-arranged; the -q
62       option suppresses this.
63

EXAMPLES

65       The  potential  use of this utility is varied but one particular use is
66       in conjunction with psbook(1).  For example, using groff  to  create  a
67       PostScript document and lpr as the UNIX print spooler a typical command
68       line might look like this:
69
70       groff -Tps -ms file | psbook | psnup -2 | lpr
71
72       Where file is a 4 page document this command will result in a two  page
73       document  printing  two  pages of file per page and rearranges the page
74       order to match the input pages 4 and 1 on the  first  output  page  and
75       pages 2 then 3 of the input document on the second output page.
76

ENVIRONMENT VARIABLES

78       LC_ALL, LC_PAPER
79              These  variables are specifying the papertype when used paper is
80              _glibc.  For details see the locale(7) manpage.
81

AUTHOR

83       Copyright (C) Angus J. C. Duggan 1991-1995
84

SEE ALSO

86       psbook(1), psselect(1), pstops(1), epsffit(1),  psnup(1),  psresize(1),
87       psmerge(1), fixscribeps(1), getafm(1), fixdlsrps(1), fixfmps(1), fixps‐
88       ditps(1), fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1),
89       extractres(1), includeres(1)
90

TRADEMARKS

92       PostScript is a trademark of Adobe Systems Incorporated.
93

BUGS

95       Psnup does not accept all DSC comments.
96
97
98
99                        PSUtils Release 1 Patchlevel 17               PSNUP(1)
Impressum