summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/psnup.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/psnup.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/psnup.1133
1 files changed, 54 insertions, 79 deletions
diff --git a/Master/texmf-dist/doc/man/man1/psnup.1 b/Master/texmf-dist/doc/man/man1/psnup.1
index 06922e43575..8b6e8a0e4d8 100644
--- a/Master/texmf-dist/doc/man/man1/psnup.1
+++ b/Master/texmf-dist/doc/man/man1/psnup.1
@@ -1,140 +1,115 @@
-.TH PSNUP 1 "PSUtils Release 1 Patchlevel 17"
+.TH PSNUP 1 "PSUtils"
.SH NAME
psnup \- multiple pages per sheet
.SH SYNOPSIS
.B psnup
-[
-.B \-w\fIwidth\fR
-] [
-.B \-h\fIheight\fR
-] [
-.B \-p\fIpaper\fR
-] [
-.B \-W\fIwidth\fR
-] [
-.B \-H\fIheight\fR
-] [
-.B \-P\fIpaper\fR
-] [
-.B \-l
-] [
-.B \-r
-] [
-.B \-f
-] [
-.B \-c
-] [
-.B \-m\fImargin\fR
-] [
-.B \-b\fIborder\fR
-] [
-.B \-d\fIlwidth\fR
-] [
-.B \-s\fIscale\fR
-] [
-.B \-\fInup\fR
-] [
-.B \-q
-] [
-.I infile
-[
-.I outfile
-] ]
+.RB [ \-w\fIwidth\fR ]
+.RB [ \-h\fIheight\fR ]
+.RB [ \-p\fIpaper\fR ]
+.RB [ \-W\fIwidth\fR ]
+.RB [ \-H\fIheight\fR ]
+.RB [ \-P\fIpaper\fR ]
+.RB [ \-l | \-r | \-f ]
+.RB [ \-c ]
+.RB [ \-m\fImargin\fR ]
+.RB [ \-b\fIborder\fR ]
+.RB [ \-d [ \fIlwidth\fR ]]
+.RB [ \-s\fIscale\fR ]
+.RB [ \-\fInup\fR ]
+.RB [ \-q ]
+.RI [ infile
+.RI [ outfile ]]
.SH DESCRIPTION
-.I Psnup
+.B Psnup
puts multiple logical pages onto each physical sheet of paper.
The input PostScript file should follow the Adobe Document Structuring
Conventions.
.PP
The
-.I \-w
+.B \-w
option gives the paper width, and the
-.I \-h
-option gives the paper height,
-normally specified in
-.B "cm"
+.B \-h
+option gives the paper height, specified in
+.BR pt ,
+.BR mm ,
+.BR cm ,
or
-.B "in"
-to convert
-PostScript's points (1/72 of an inch)
-to centimeters or inches.
+.BR in .
The
-.I \-p
-option can be used as an alternative, to set the paper size to
-.B a3, a4, a5, b5, letter, legal, tabloid, statement, executive, folio, quarto
-or
-.B 10x14.
-The default paper size is
-.B a4.
+.B \-p
+option can be used instead, to set the paper size; otherwise a default value is used.
+See
+.BR paper (1).
The
-.I \-W, \-H,
+.BR \-W ,
+.BR \-H ,
and
-.I \-P
+.B \-P
options set the input paper size, if it is different from the output
size. This makes it easy to impose pages of one size on a different size of
paper.
.PP
The
-.I \-l
+.B \-l
option should be used for pages which are in landscape orientation (rotated 90
degrees anticlockwise). The
-.I \-r
+.B \-r
option should be used for pages which are in seascape orientation (rotated 90
degrees clockwise), and the
-.I \-f
+.B \-f
option should be used for pages which have the width and height interchanged,
but are not rotated.
.PP
-.I Psnup
+.B Psnup
normally uses `row-major' layout, where adjacent pages are placed in rows
across the paper.
The
-.I \-c
+.B \-c
option changes the order to `column-major', where successive pages are placed
in columns down the paper.
.PP
A margin to leave around the whole page can be specified with the
-.I \-m
+.B \-m
option. This is useful for sheets of `thumbnail' pages, because the normal
page margins are reduced by putting multiple pages on a single sheet.
.PP
The
-.I \-b
+.B \-b
option is used to specify an additional margin around each page on a sheet.
.PP
The
-.I \-d
+.B \-d
option draws a line around the border of each page, of the specified width.
If the \fIlwidth\fR parameter is omitted, a default linewidth of 1 point is
assumed. The linewidth is relative to the original page dimensions,
-\fIi.e.\fR it is scaled down with the rest of the page.
+i.e., it is scaled down with the rest of the page.
.PP
The scale chosen by
-.I psnup
+.B psnup
can be overridden with the
-.I \-s
+.B \-s
option. This is useful to merge pages which are already reduced.
.PP
The
-.I \-\fInup\fR
+.BI \- nup
option selects the number of logical pages to put on each sheet of paper. This
can be any whole number;
-.I psnup
+.B psnup
tries to optimise the layout so that the minimum amount of space is wasted. If
-.I psnup
+.B psnup
cannot find a layout within its tolerance limit, it will abort with an error
message. The alternative form
-.I \i \fInup\fR
+.BI \-n nup
can also be used, for compatibility with other n-up programs.
.PP
-.I Psnup
+.B Psnup
normally prints the page numbers of the pages re-arranged; the
-.I \-q
+.B \-q
option suppresses this.
.SH EXAMPLES
The potential use of this utility is varied but one particular
use is in conjunction with
-.I psbook(1).
+.BR psbook (1).
For example, using groff to create a PostScript document and lpr as
the
.SM UNIX
@@ -142,19 +117,19 @@ print spooler a typical command line might look like this:
.sp
groff -Tps -ms \fIfile\fP | psbook | psnup -2 | lpr
.sp
-Where file is a 4 page document this command will result in a
+where file is a 4 page document this command will result in a
two page document printing two pages of \fIfile\fP per page and
rearranges the page order to match the input pages 4 and 1
on the first output page and
pages 2 then 3 of the input document
on the second output page.
.SH AUTHOR
-Copyright (C) Angus J. C. Duggan 1991-1995
+Written by Angus J. C. Duggan.
.SH "SEE ALSO"
-epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1)
+.Br psutils (1)
.SH TRADEMARKS
.B PostScript
is a trademark of Adobe Systems Incorporated.
.SH BUGS
-.I Psnup
+.B Psnup
does not accept all DSC comments.