UP

Section: User Commands (1)
Updated: 23 October 1989
Index Return to Main Contents

NAME

up - convert conforming PostScript files to print n-up
makeup - create numbered test pages for up

SYNOPSIS

up [ -f config_file ] [ -n name ] [ file ... ]

makeup count

DESCRIPTION

Up reads a conforming PostScript file, and performs translation, rotation, and scaling operations to print several pages on one sheet of paper. It uses a human-readable configuration file to determine how to arrange pages, and selects named layouts based on the name the program was called by (see also the -f option). The output is also conforming, which means that it can be fed back through for further reduction.

The configuration file is slightly magical, but easy to use for simple layouts. Quite complicated effects are possible by embedding arbitrary PostScript commands. See spiral, in the supplied configuration file. The format is completely described in uprc(5).

Makeup is a simple utility that generates count pages of conforming PostScript to stdout, with each page containing a 10.5x8 inch box, and a large page number. Its main excuse for existence is debugging new layouts, although the enterprising could set up calendar formats.

OPTIONS

-f: config_file Use an alternate configuration file. Normally, it uses the last of the following that is found: /usr/local/lib/up.rc, ~/.uprc ./up.rc.
-n: name Explicitly specify what page layout to use, no matter what name the program was called by. This is handy for testing new layouts, and configurations that you haven't created links for yet.

FILES

/usr/local/lib/up.rc: global configuration
~/.uprc: user's personal configuration
./up.rc: current directory's configuration

AUTHOR

J Greely (jgreely@cis.ohio-state.edu), Ohio State University, Department of Computer and Information Science, etc. Laws warranted where voided by Prohibition.

STATUS

Highly experimental, and dangerous in the wrong hands. Not to be used while under the influence of whimsy.

BUGS

Doesn't seem to work with psdvi output, although dvips (3.4) works.

The configuration file parsing is less than robust.

Some would say that the use of Perl is a bug.

The way I test for conformance with Adobe's document structuring conventions is iffy. I don't apologize for it, but I don't like it, either. Eventually, I'll break down and do proper checking, probably when I convert it all to C.

Makeup's page numbering doesn't fit within the margins after page 999. I have no intention of fixing this.

This document was created by man2html, using the manual pages.
Time: 07:18:29 GMT, May 19, 2025

UP