.TH pstokenize 1 "13 Feb 1989" "Adobe Systems"
.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
.SH NAME
pstokenize \- encode \*(PS programs as binary tokens
.SH SYNOPSIS
.B pstokenize
[\fB\-c\fR]
[{\fB\-h\fR\ |\ \fB\-l\fR}]
[{\fB\-i\fR\ |\ \fB\-n\fR}]
[\fB\-o\ \fIoutputfile\fR]
.I inputfile
.SH DESCRIPTION
.I pstokenize
translates the encoding of \*(PS language code from ASCII into binary
tokens as specified in the \*(PS Language Reference Manual, Second Edition.
If no
.I inputfile
is specified, input is taken from stdin.

The binary token encoding is disabled by the \*(PS structuring comment:
.br
.B	%%BeginBinary:
.I number
.br
where
.I number
specifies the number of bytes after the comment that are to be passed through
unexamined.  The closing comment:
.br
.B	%%EndBinary
.br
is ignored.
.SH OPTIONS
.TP
.B \-c
specifies that comments at the beginning of source file lines are to be
retained instead of stripped.  This enables document structuring
comments to be retained.
.B %%Notice
comments are always retained because they may carry essential copyright
information that should not be removed by re-encoding with binary tokens.
.TP
.B \-h
specifies that multi-byte numbers are to be output with the high-byte-first
encoding.  This is default on big-endian machines.  Only one of
.B \-h
or
.B \-l
may be specified.
.TP
.B \-i
specifies that floating point numbers are to be output in 32-bit IEEE format.
IEEE is the default floating point token format.  Only one of
.B \-i
or
.B \-n
may be specified.
.TP
.B \-l
specifies that multi-byte numbers are to be output with the low-byte-first
encoding.  This is default on little-endian machines.  Only one of
.B \-h
or
.B \-l
may be specified.
.TP
.B \-n
specifies that floating point numbers are to be output in native format.
.I Beware that native format floating point
.I tokens are not portable.
\*(PS Level 2 or Display \*(PS interpreters will convert IEEE format numbers
to its native format automatically.
Only one of
.B -i
or
.B -n
may be specified.
.TP
.BI \-o\ outputfile
directs output to the named file instead of stdout.
.SH EXAMPLE
pstokenize -o test.tokens test.ps
.br
mydriver | pstokenize -l -i > myfile.ps
.SH BUGS
When IEEE format numbers are requested on a machine that does not use IEEE
format, numbers are output in ASCII.  Because IEEE format is default,
.I -n
must be specified to generate binary tokens for real numbers on machines that 
do not use IEEE format.
.PP
Comments that are passed through to the output file are both preceded and
followed by newlines.  This is necessary to ensure that they start at the
beginning of an output line.  This will introduce whitespace between
individual comments in a sequence that previously had none.
.SH SEE ALSO
.I \*(PS Language Reference Manual, Second Edition
.SH AUTHOR
Adobe Systems Incorporated.
.PP
\*(PS and Display \*(PS are trademarks of Adobe Systems Incorporated registered
in the United States.