Imported Upstream version 20061224

1 files changed, 324 insertions, 0 deletions

diff --git a/foo2oak.1in b/foo2oak.1in
new file mode 100644
index 0000000..070be43
--- /dev/null
+++ b/foo2oak.1in
@@ -0,0 +1,324 @@
+.TH foo2oak 1 "${MODpage}" "foo2oak ${MODver}"
+'\"==========================================================================
+'\"	STRINGS and MACROS
+'\"==========================================================================
+'\"
+'\"	Define strings for special characters that nroff doesn't have
+'\"
+'\"	N.B. using .if cua to test for special characters did not work.
+'\"
+.if !'\*[.T]'ps' .ds ua up
+.if  '\*[.T]'ps' .ds ua \(ua
+.if !'\*[.T]'ps' .ds da down
+.if  '\*[.T]'ps' .ds da \(da
+.if !'\*[.T]'ps' .ds <- left
+.if  '\*[.T]'ps' .ds <- \(<-
+.if !'\*[.T]'ps' .ds -> right
+.if  '\*[.T]'ps' .ds -> \(->
+'\"
+'\"     bx - box a Courier string for making keycaps
+'\"
+'\"	N.B. this mess is to make the line drawing come out only
+'\"	if we are really generating postscript
+'\"
+.de bx
+.ie !'\*[.T]'ps' \{\
+.	RB [ \\$1 ]\\$2
+.\}
+.el \{\
+.	ie !r ps4html \{\
+'\" \(br\|\s-1\f(CB\\$1\fP\s+1\|\(br\l'|0\(rn'\l'|0\(ul'
+.		ft CW
+.		nr par*bxw \w'\\$1'+.4m 
+\Z'\v'.25m'\D'l 0 -1m'\D'l \\n[par*bxw]u 0'\D'l 0 1m'\D'l -\\n[par*bxw]u 0''\
+\Z'\h'.2m'\s-1\\$1\s+1'\
+\h'\\n[par*bxw]u'\\$2
+.		ft P
+.	\}
+.	el \{\
+.		RB [ \\$1 ]\\$2
+.	\}
+.\}
+..
+'\"
+'\" strings to set current color (null with old groff)
+'\"
+.if mred .ds red \m[red]
+.if mgreen .ds green \m[green]
+.if mblue .ds blue \m[blue]
+.if mblack .ds black \m[black]
+.if mblack .ds mP \mP
+'\"
+'\" fix for grotty + xterm. We call for orange, grotty outputs yellow,
+'\" but xterm displays yellow as orange.  The cycle is complete.
+'\"
+.if n .defcolor orange rgb #ffff00
+'\"
+'\" color <color> - set the current color (ignores request with old groff)
+'\"
+.de color
+.if mred \m[\\$1]\c
+..
+'\"
+'\" colorword <color> <word> - colorize a word (ignored by old groff)
+'\"
+.de colorword
+.ie m\\$1 \m[\\$1]\\$2\mP\c
+.el \\$2\c
+..
+'\"
+'\" colbox <fg> <bg> <word> - colorize a word in a filled box
+'\"
+.de colbox
+.ie mred \M[\\$2]\
+\v'+.167v'\
+\D'P 0 -0.9v  \w'\\$3'u 0  0 +0.9v   -\w'\\$3'u 0'\
+\v'-.167v'\
+\m[\\$1]\\$3\mP\MP
+.el \\$3\c
+..
+'\"
+'\"	Macros for doing pdfmarks
+'\"
+.de specialps
+\\k_\X'ps: \\$*'\h'|\\n_u'\c
+..
+'\"
+'\" pdfmark PDFMARKCODE
+'\"
+.ds pdfmarks
+.if d pdfmarks \{\
+.de pdfmark
+.	specialps exec [\\$1 pdfmark
+..
+'\"
+'\" pdfdest LINKNAME
+'\"
+.de pdfdest
+.pdfmark "/Dest /\\$1 /View [/XYZ -5 PL null] /DEST"
+..
+'\"
+'\" pdfbookmark COUNT LINKNAME STRING
+'\"
+.de pdfbookmark
+.   pdfmark "/View [/XYZ 44 730 1.0] /Count \\$1 /Dest /\\$2 /Title (\\$3) /OUT"
+..
+'\"
+'\"	Define the SH and SS macros to save pdfmark information
+'\"	in "arrays" of numbers and strings.
+'\"
+.if !r rr_n \{\
+.nr rr_n 0 1
+.am SH
+.	nr rr_levels!\\n+[rr_n] 2
+.	ds rr_labels!\\n[rr_n] \\$*
+.	pdfdest Link\\n[rr_n]
+..
+.am SS
+.	nr rr_levels!\\n+[rr_n] 3
+.	ds rr_labels!\\n[rr_n] \\$*
+.	pdfdest Link\\n[rr_n]
+..
+.\}
+'\"
+'\"	Called at the end of the document to generate the pdfmark outline
+'\"
+.de pdf_outline
+.nr rr_levels!\\n+[rr_n] 1
+.nr rr_i 0 1
+.while \\n+[rr_i]<\\n[rr_n] \{\
+.   nr rr_ip1 \\n[rr_i]+1
+.   nr rr_count 0
+.   if \\n[rr_levels!\\n[rr_ip1]]>\\n[rr_levels!\\n[rr_i]] \{\
+.       nr rr_j \\n[rr_i] 1
+.       while \\n+[rr_j]<\\n[rr_n] \{\
+.           if \\n[rr_levels!\\n[rr_j]]<=\\n[rr_levels!\\n[rr_i]] \{\
+.               break
+.           \}
+.           if \\n[rr_levels!\\n[rr_j]]==(\\n[rr_levels!\\n[rr_i]]+1) \{\
+.               nr rr_count \\n[rr_count]+1
+.           \}
+.       \}
+.   \}
+.   ds hhh \\*[rr_labels!\\n[rr_i]]
+.   pdfbookmark \\n[rr_count] Link\\n[rr_i] "\\*[hhh]"
+.\}
+..
+'\"
+'\" Some postscript to make pdfmarks harmless on old interpreters...
+'\"
+.specialps "def /pdfmark where {pop} {userdict /pdfmark /cleartomark load put} ifelse"
+'\"
+'\" Force display of Bookmarks in Acrobat when document is viewed.
+'\"
+.pdfmark "[/PageMode /UseOutlines /Page 1 /View [/XYZ null null null] /DOCVIEW"
+'\"
+'\" Output the document info in pdfmarks
+'\"
+.pdfmark "\
+	/Title (\*[an-title](\*[an-section])) \
+	/Subject (foo2oak Manual Page) \
+	/Author (Rick Richardson) \
+	/Keywords (printing, OAKT) \
+	/Creator (groff \n(.x.\n(.y.\n(.Y -man) \
+	/CreationDate (\*[an-extra1]) \
+	/ModDate (\*[an-extra1]) \
+	/DOCINFO"
+\}
+'\"
+'\" The manual page name is only 1st level mark
+'\"
+.nr rr_levels!\n+[rr_n] 1
+.ds rr_labels!\n[rr_n] \*[an-title](\*[an-section])
+.pdfdest Link\n[rr_n]
+'\"==========================================================================
+'\"	MANUAL PAGE SOURCE
+'\"==========================================================================
+.SH NAME
+foo2oak \- Convert Ghostscript pbmraw, pgmraw or bitcmyk format into an
+OAKT printer stream
+.SH SYNOPSIS
+.B foo2oak
+.RI [ options "] <" pbmraw-file " >" OAKT-file
+.sp 1
+.B foo2oak
+.RI [ options "] <" pgmraw-file " >" OAKT-file
+.sp 1
+.B foo2oak
+.RI [ options "] <" bitcmyk-file " >" OAKT-file
+.SH DESCRIPTION
+.B foo2oak
+converts Ghostscript pbmraw or bitcmyk output formats to monochrome
+or color OAKT streams,
+for driving the HP color Laserjet 1500 laser printer
+and other OAKT-based printers.
+
+.SH COMMAND LINE OPTIONS
+.SS Normal Options
+These are the options used to select the parameters of a
+print job that are usually controlled on a per job basis.
+.TP
+.BI \-c
+Force color mode if autodetect doesn't work.
+.TP
+.BI \-g\0 xpix x ypix
+Set page dimensions in pixels [10200x6600].
+.TP
+.BI \-m\0 media
+Media code to send to printer [1].
+.TS
+| n l | n l .
+1	standard	259	letterhead
+2	transparency	261	thickstock
+3	glossy	262	postcard
+257	envelope	263	labels
+.TE
+.TP
+.BI \-p\0 paper
+Paper code to send to printer [1].
+.TS
+| n l | n l.
+1	letter	9	A4
+5	legal	11	A5
+7	executive	13	B5
+.TE
+.TP
+.BI \-n\0 copies
+Number of copies [1].
+.TP
+.BI \-r\0 xres x yres
+Set device resolution in pixels/inch [600x600].
+.TP
+.BI \-s\0 source
+Source (InputSlot) code to send to printer [7].
+.TS
+| n l | n l.
+1	tray1	4	manual
+7	auto
+.TE
+.TP
+.BI \-J\0 filename
+Filename string to send to printer.
+.TP
+.BI \-U\0 username
+Username string to send to printer.
+.SS Printer Tweaking Options
+These are the options used to customize the operation of \fBfoo2oak\fP
+for a particular printer.
+.TP
+.BI \-u\0 xoff x yoff
+Set the offset of the start of the printable region from the
+upper left corner, in pixels [0x0].
+.TP
+.BI \-l\0 xoff x yoff
+Set the offset of the end of the printable region from the
+lower right corner, in pixels [0x0].
+.TP
+.BI \-L\0 mask
+Send logical clipping amounts implied by -u/-l in the OAKT stream [3].
+.TS
+l l.
+0	don't send any logical clipping amounts
+1	only send Y clipping amount
+2	only send X clipping amount
+3	send both X and Y clipping amounts
+.TE
+.TP
+.BI \-A
+Turn off: conversion of C=1,M=1,Y=1 to pure black.
+.TP
+.BI \-B
+Turn off: K=1 forces C,M,Y to 0.
+.SS Debugging Options
+These options are used for debugging \fBfoo2oak\fP.
+.TP
+.BI \-S\0 plane
+Output just a single color plane from a color print and print it
+on the black plane.  The default is to output all color planes.
+.TS
+l l.
+1	Cyan
+2	Magenta
+3	Yellow
+4	Black
+.TE
+.TP
+.BI \-D\0 level
+Set Debug level [0].
+
+.SH EXAMPLES
+Create a black and white OAKT stream:
+
+.RS
+.nf
+gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE \ 
+    -sPAPERSIZE=letter -r600x600 -sDEVICE=pbmraw \ 
+    -sOutputFile=- - < testpage.ps \ 
+| foo2oak -r600x600 -g5100x6600 -p1 >testpage.oak
+.fi
+.RE
+.P
+Create a color OAKT stream:
+
+.RS
+.nf
+gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE \ 
+    -sPAPERSIZE=letter -g5100x6600 -r600x600 -sDEVICE=bitcmyk \ 
+    -sOutputFile=- - < testpage.ps \ 
+| foo2oak -r600x600 -g5100x6600 -p1 >testpage.oak
+.fi
+.RE
+
+.SH FILES
+.BR /usr/bin/foo2oak
+.SH SEE ALSO
+.BR foo2oak-wrapper (1),
+.BR oakdecode (1)
+.SH "AUTHOR"
+Rick Richardson <rick.richardson@comcast.net>
+.br
+${URLOAK}/
+'/"
+'/"
+'/"
+.em pdf_outline