ipfe.1

早期freebsd实现

.\" (c) Copyright 1986 Xerox Corporation
.\" All rights reserved.
.TH IPFE 1 6/16/86
.UC 4
.SH NAME
IPFE \- Interpress File Editor
.SH SYNOPSIS
\fBipfe\fR [ \fIoptions\fR ] \fIinfile\fR [ \fIpagerange\fR ] ...
[ \fIinfile\fR [ \fIpagerange\fR ] ... ]
.sp 1
Options:  [\fB\-l \fIlogfile\fR ]  [\fB\-dDiLqrRsSY ]  [\fB\-a 
\fIalias:actual\fR [\fB\-a \fIalias:actual\fR ] ...]  [\fB\-b 
\fIbinding-offset:unit\fR ]  [\fB\-c 
\fIchapterize-count:unit\fR ]  [\fB\-o \fIoutfile\fR ]  [\fB\-p 
\fIlevel:propfile\fR ]  [\fB\-S \fIscale-factor\fR ]  [\fB\-X 
\fIX-offset:unit\fR ]  [\fB\-Y \fIY-offset:unit\fR ]
.SH DESCRIPTION
\fBIPFE\fR performs editing functions on Interpress masters. It
reads the specified input Interpress files and writes the
designated output file(s). By using page ranges and other options,
pagebodies in Interpress masters may be concatenated, merged,
split into several output files (i.e., chapterized), etc.
.PP
Concatenation is accomplished by specifying more than one input
master with no pageranges.
.PP
Page selection and merging is accomplished by specifying more
than one master with a pagerange specification for at least one
of the masters. This accomplishes simple merging, such as pages 1,
2, and 4 of Master1 merged with pages 2, 4, and 5 of Master2.
.PP
In addition, a page from one master may be overlaid with pages
from other masters to create a single output page. The overlay
pages may be repositioned by specifying an xOffset and yOffset.
In this manner, graphics or images may be created as Interpress
"pages" and then merge/overlaid onto a text page of a different
master, with an option to reposition the images.
See the \fIinfile\fR [ \fIpagerange\fR ] discussion below, following
the options specifications, for syntax details.
.PP
The following options can be used with \fBipfe\fR:
.PP
.RS
(\fINote:\fR Any option with one or more arguments may be
specified as a single option, with no space between the
switch and the [first] argument, or as two options, with an
unquoted space between the switch and the [first] argument. If
there is more than one argument, they must be specified together
as a single option, separated by an [usually] optional colon. When
the colon is required, it is so indicated in the option description.)
.RE
.TP
\fB\-a \fIalias:actual\fR
(alias). If the \fB\-s\fR option is specified, replace any SIF
references matching the string \fIalias\fR with the string
\fIactual\fR before attempting to satisfy the SIF. The colon
between \fIalias\fR and \fIactual\fR is required. There may be
spaces and colons in \fIalias\fR (if there are spaces, \fIalias\fR
itself must be quoted). However, there must be no colons in
\fIactual\fR, because IPFE searches from the end of \fIactual\fR
to find the colon separating \fIalias\fR and \fIactual\fR.
There may be multiple \fB\-a\fR options. However, if there is no
\fB\-s\fR option specified, none of the alias options has any
effect.
If there is a match on any \fIalias\fR, and the corresponding
file \fIactual\fR is not found or there is some error, the
original SIF reference, \fIalias\fR, is preserved, unless the
\fB\-r\fR option is also specified. In the latter case, the SIF
reference is removed.
.TP
\fB\-b \fIoffset:unit\fR
(binding offset). Shift the image \fIoffset units\fR in the
x-direction, where \fIunit\fR may be none (default centimeters),
\fBc\fR (centimeters), \fBi\fR (inches), \fBp\fR (points), or
\fBP\fR(Picas). \fIOffset\fR may be a negative value. If the
\fB\-L\fR option is also specified, the image shift is in the
y-direction.
.TP
\fB\-c \fIcount:unit\fR
(chapterize). If the size of the output file is larger than
\fIcount units\fR, split the output file into multiple files.
Chapterization occurs only on page boundaries, every time
\fIcount units\fR is reached [where \fIunit\fR may be \fBp\fR
(pages), \fBk\fR (kilobytes), or \fBm\fR (megabytes)], and
there is no look-ahead. Therefore, if a byte specification
is used, the size of each output file may actually be larger
than \fIcount units\fR. Output file names are generated
by appending "1", "2", etc. to the file extension of
\fIoutfile\fR. (\fINote\fR that this is in \fIaddition\fR
to the possibility of an integer being appended to the output
filename if no \fB\-o\fR option is specified.)
.TP
\fB\-d\fR
(duplex). If the \fB\-b\fR option (binding offset) is specified,
apply the offset for duplex (two-sided) printing of the output
master. That is, for odd-numbered pages, the offset is applied
as specified; for even-numbered pages, the negative of the offset
is applied. If there is no binding offset specified, the duplex
option has no effect.
.IP
\fIExample:\fR
If there is a binding offset of 2P and the duplex option
is specified, odd-numbered pages are shifted 2 Picas to the right,
even-numbered pages 2 Picas to the left. If the binding offset is
-2P and duplex is specified, odd-numbered pages are shifted 2
Picas to the left, even-numbered pages 2 Picas to the right.
.TP
\fB\-D\fR
(Debug). If the \fB\-p\fR option is specified, write to the
properties file the offset within the input stream of each
skeleton-level token, in addition to the properties information
detailed in the \fB\-p\fR option. If there is no \fB\-p\fR
option specified, the Debug option has no effect.
.TP
\fB\-i\fR
(insert SIF for overlay). Insert (create) a SIF reference for
any unresolvable overlays. (See the discussion on overlays in
the \fIinfile\fR [ \fIpagerange\fR ] section below, following
the options specifications.) \fINote\fR that if an overlay is
unresolvable and the overlay specification includes a pageNum
greater than 1, no SIF reference will be created, even if the
\fB\-i\fR option is specified.
.TP
\fB\-l \fIlogfile\fR
(log). Open the file \fIlogfile\fR and record a transcript of
IPFE actions, error reports, etc. The logfile is opened
immediately upon encountering the \fB\-l\fR option in the
command line. Therefore, to record errors in the command line
specification, the \fB\-l\fR option must be the \fIfirst\fR
option specified. If no \fIlogfile\fR is specified, the default
filename "ipfe.log" is used.
.TP
\fB\-L\fR
(Landscape). Rotate every output page 90 degrees counterclockwise.
IPFE automatically applies an x- and y-image shift to preserve
the upper left corner of the image. This option is intended for
printing text pages in a landscape orientation.
.TP
\fB\-o \fIoutfile\fR
(output). Write the output Interpress master to the file
\fIoutfile\fR. If the \fB\-o \fIoutfile\fR option is \fInot\fR
specified, the following algorithm determines the output
filename (with one exception, noted below): remove the extension
from the filespec of the first \fIinfile\fR and append ".ip",
as long as \fIinfilename\fR.ip does not already exist. If it
\fIdoes\fR exist, then append "\fIn\fR.ip", where
\fIn\fR is the lowest integer that will not cause an existing
file to be overwritten.
.IP
\fINote:\fR
If the \fB\-p\fR option is specified with no \fB\-o\fR option,
then the properties
file is written with no Interpress output master. This allows
you to get information about the input stream without the
overhead of creating the Interpress output master.
.TP
\fB\-p \fIlevel:propfile\fR
(properties). Open the file \fIpropfile\fR and write the
following information about the properties of each input
master: the skeleton structure and the number of blocks,
pages, and sequenceInsertFile (SIF) references. If there
is more than one input file, the total number of blocks,
pages, and SIF references are also written. \fILevel\fR
may be \fI0\fR (default) or \fI1\fR (verbose); if \fI1\fR,
each valid pageBody and endpageBody token is indicated and
numbered.
In addition, the \fB\-D\fR (Debug) option causes the file
position of each skeleton-level token to be written.
.IP
\fINote\fR that the properties are an accounting of the
\fIinput\fR stream.
If the properties of the \fIoutput\fR stream are desired, it is
necessary to execute a second invocation of \fBipfe\fR on
the output file(s) with just the \fB\-p\fR option specified.
.TP
\fB\-q\fR
(quiet). Don't write information and error messages to STDERR.
.TP
\fB\-r\fR
(remove SIFS). Remove sequenceInsertFile (SIF) references
from the input stream. If the \fB\-s\fR option is also
specified, the \fB\-s\fR option takes precedence, and a SIF
reference is removed only if it is either unresolvable
or there is some error, such as an invalid header.
.TP
\fB\-R\fR
(Rotate). Rotate every output page 90 degrees clockwise. IPFE
automatically applies an x- and y-image shift to preserve
the center point of the image. This option is intended for
printing an image created for a "landscape printer" in portrait
orientation.
.TP