texk/psutils: New convention

git-svn-id: svn://tug.org/texlive/trunk@39834 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 135 insertions, 0 deletions

diff --git a/Build/source/texk/psutils/psutils-src/psnup.1 b/Build/source/texk/psutils/psutils-src/psnup.1
new file mode 100644
index 00000000000..8b6e8a0e4d8
--- /dev/null
+++ b/Build/source/texk/psutils/psutils-src/psnup.1
@@ -0,0 +1,135 @@
+.TH PSNUP 1 "PSUtils"
+.SH NAME
+psnup \- multiple pages per sheet
+.SH SYNOPSIS
+.B psnup
+.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
+.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
+.B \-w
+option gives the paper width, and the
+.B \-h
+option gives the paper height, specified in
+.BR pt ,
+.BR mm ,
+.BR cm ,
+or
+.BR in .
+The 
+.B \-p
+option can be used instead, to set the paper size; otherwise a default value is used.
+See
+.BR paper (1).
+The
+.BR \-W ,
+.BR \-H ,
+and
+.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
+.B \-l
+option should be used for pages which are in landscape orientation (rotated 90
+degrees anticlockwise). The
+.B \-r
+option should be used for pages which are in seascape orientation (rotated 90
+degrees clockwise), and the
+.B \-f
+option should be used for pages which have the width and height interchanged,
+but are not rotated.
+.PP
+.B Psnup
+normally uses `row-major' layout, where adjacent pages are placed in rows
+across the paper.
+The
+.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
+.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
+.B \-b
+option is used to specify an additional margin around each page on a sheet.
+.PP
+The
+.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,
+i.e., it is scaled down with the rest of the page.
+.PP
+The scale chosen by
+.B psnup
+can be overridden with the
+.B \-s
+option. This is useful to merge pages which are already reduced.
+.PP
+The
+.BI \- nup
+option selects the number of logical pages to put on each sheet of paper. This
+can be any whole number;
+.B psnup
+tries to optimise the layout so that the minimum amount of space is wasted. If
+.B psnup
+cannot find a layout within its tolerance limit, it will abort with an error
+message. The alternative form
+.BI \-n nup
+can also be used, for compatibility with other n-up programs.
+.PP
+.B Psnup
+normally prints the page numbers of the pages re-arranged; the
+.B \-q
+option suppresses this.
+.SH EXAMPLES
+The potential use of this utility is varied but one particular 
+use is in conjunction with 
+.BR psbook (1).
+For example, using groff to create a PostScript document and lpr as 
+the 
+.SM UNIX 
+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 
+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
+Written by Angus J. C. Duggan.
+.SH "SEE ALSO"
+.Br psutils (1)
+.SH TRADEMARKS
+.B PostScript
+is a trademark of Adobe Systems Incorporated.
+.SH BUGS
+.B Psnup
+does not accept all DSC comments.