Index: brlcad/doc/docbook/system/man1/en/CMakeLists.txt
===================================================================
--- brlcad/doc/docbook/system/man1/en/CMakeLists.txt	(revision 53937)
+++ brlcad/doc/docbook/system/man1/en/CMakeLists.txt	(working copy)
@@ -1,105 +1,198 @@
 set(docbook_man1_EN
-  g2asc.xml
-  pix2asc.xml
-  asc2dsp.xml
-  bot_dump.xml
-  bot_shell-vtk.xml
-  bwscale.xml
-  coil.xml
-  comgeom-g.xml
-  conv-vg2g.xml
-  cy-g.xml
-  db.xml
-  dbclean.xml
-  dbupgrade.xml
-  dxf-g.xml
-  g-dxf.xml
-  enf-g.xml
-  euclid-g.xml
-  g-euclid.xml
-  fast4-g.xml
-  g-acad.xml
-  g-egg.xml
-  g-nff.xml
-  g-obj.xml
-  g-shell-rect.xml
-  g-var.xml
-  g-vrml.xml
-  g-x3d.xml
-  gqa.xml
-  g-iges.xml
-  iges-g.xml
-  mged.xml
-  nastran-g.xml
-  nirt.xml
-  asc-nmg.xml
-  g-nmg.xml
-  nmg-bot.xml
-  nmg-rib.xml
-  obj-g.xml
-  patch-g.xml
-  rpatch.xml
-  ply-g.xml
-  poly-bot.xml
-  proe-g.xml
-  rt.xml
-  rtarea.xml
-  rtcheck.xml
-  rtedge.xml
-  rtwizard.xml
-  g-stl.xml
-  stl-g.xml
-  g-tankill.xml
-  tankill-g.xml
-  tire.xml
-  vdeck.xml
-  viewpoint-g.xml
-  cmap-fb.xml
-  fb-cmap.xml
-  fbanim.xml
-  fb-bw.xml
-  fbcbars.xml 
-  fbclear.xml
-  fbcmap.xml
-  fbcmrot.xml
-  fbcolor.xml
-  fbfade.xml
-  fb-fb.xml
-  fbframe.xml
-  fbfree.xml
-  fbgamma.xml
-  fbgrid.xml
-  fbhelp.xml
-  fblabel.xml
-  fbline.xml
-  fb-pix.xml
-  fb-png.xml
-  fbpoint.xml
-  fb-rle.xml
-  fbscanplot.xml 
-  fbstretch.xml
-  fbzoom.xml
-  gif2fb.xml
-  gif-fb.xml
-  orle-fb.xml
-  pixautosize.xml
-  pix-fb.xml
-  pl-fb.xml
-  png-fb.xml
-  polar-fb.xml 
-  pp-fb.xml 
-  rle-fb.xml 
-  bw-fb.xml 
-  cell-fb.xml
-  fb-orle.xml
+ap-pix.xml
+asc-nmg.xml
+asc-pl.xml
+asc2dsp.xml
+azel.xml
+bary.xml
+bot_dump.xml
+bot_shell-vtk.xml
+brlcad.xml
+buffer.xml
+bw-imp.xml
+bw-pix.xml
+bw-png.xml
+bw-ps.xml
+bw-rle.xml
+bw3-pix.xml
+bwcrop.xml
+bwdiff.xml
+bwfilter.xml
+bwhist.xml
+bwhisteq.xml
+bwmod.xml
+bwrect.xml
+bwrot.xml
+bwscale.xml
+bwshrink.xml
+bwstat.xml
+bwthresh.xml
+coil.xml
+comgeom-g.xml
+conv-vg2g.xml
+cv.xml
+cy-g.xml
+db.xml
+dbclean.xml
+dbcp.xml
+dbupgrade.xml
+decimate.xml
+dpix-pix.xml
+dunncolor.xml
+dunnsnap.xml
+dxf-g.xml
+enf-g.xml
+euclid-g.xml
+fast4-g.xml
+g-acad.xml
+g-dxf.xml
+g-egg.xml
+g-euclid.xml
+g-iges.xml
+g-nff.xml
+g-nmg.xml
+g-obj.xml
+g-shell-rect.xml
+g-stl.xml
+g-tankill.xml
+g-var.xml
+g-vrml.xml
+g-x3d.xml
+g2asc.xml
+gencolor.xml
+gqa.xml
+hex.xml
+iges-g.xml
+imgdims.xml
+loop.xml
+mac-pix.xml
+mged.xml
+morphedit.xml
+nastran-g.xml
+nirt.xml
+nmg-bot.xml
+nmg-rib.xml
+obj-g.xml
+orle-pix.xml
+patch-g.xml
+pix-alias.xml
+pix-bw.xml
+pix-bw3.xml
+pix-orle.xml
+pix-png.xml
+pix-ppm.xml
+pix-ps.xml
+pix-rle.xml
+pix-sun.xml
+pix2asc.xml
+pixbackgnd.xml
+pixbgstrip.xml
+pixblend.xml
+pixborder.xml
+pixbustup.xml
+pixclump.xml
+pixcolors.xml
+pixcut.xml
+pixdiff.xml
+pixdsplit.xml
+pixfade.xml
+pixfilter.xml
+pixhalve.xml
+pixhist.xml
+pixhist3d-pl.xml
+pixhist3d.xml
+pixinterp2x.xml
+pixmatte.xml
+pixmerge.xml
+pixmorph.xml
+pixrect.xml
+pixrot.xml
+pixsaturate.xml
+pixscale.xml
+pixshrink.xml
+pixstat.xml
+pixsubst.xml
+pixtile.xml
+pixuntile.xml
+pl-X.xml
+pl-asc.xml
+pl-hpgl.xml
+pl-pl.xml
+pl-ps.xml
+pl-tek.xml
+plcolor.xml
+pldebug.xml
+plgetframe.xml
+plline2.xml
+plrot.xml
+ply-g.xml
+png-bw.xml
+png-pix.xml
+png_info.xml
+poly-bot.xml
+proe-g.xml
+random.xml
+rle-pix.xml
+rpatch.xml
+rt.xml
+rtarea.xml
+rtcheck.xml
+rtedge.xml
+rtwizard.xml
+stl-g.xml
+sun-pix.xml
+tankill-g.xml
+terrain.xml
+tire.xml
+vdeck.xml
+viewpoint-g.xml
+wavelet.xml
+cmap-fb.xml
+fb-cmap.xml
+fbanim.xml
+fb-bw.xml
+fbcbars.xml 
+fbclear.xml
+fbcmap.xml
+fbcmrot.xml
+fbcolor.xml
+fbfade.xml
+fb-fb.xml
+fbframe.xml
+fbfree.xml
+fbgamma.xml
+fbgrid.xml
+fbhelp.xml
+fblabel.xml
+fbline.xml
+fb-pix.xml
+fb-png.xml
+fbpoint.xml
+fb-rle.xml
+fbscanplot.xml 
+fbstretch.xml
+fbzoom.xml
+gif2fb.xml
+gif-fb.xml
+orle-fb.xml
+pixautosize.xml
+pix-fb.xml
+pl-fb.xml
+png-fb.xml
+polar-fb.xml 
+pp-fb.xml 
+rle-fb.xml 
+bw-fb.xml 
+cell-fb.xml
+fb-orle.xml
   )
 
 # Some DocBook man pages generate multiple output files, if they
 # describe more than one command.  Those files need special
 # handling, since the CMake logic has no way to know about the
 # extra outputs without being told.
-set_source_files_properties(g2asc.xml PROPERTIES EXTRA_MAN_OUTPUTS "asc2g.1")
-set_source_files_properties(pix2asc.xml PROPERTIES EXTRA_MAN_OUTPUTS "asc2pix.1")
+set_source_files_properties(g2asc.xml PROPERTIES EXTRA_MAN_OUTPUTS "asc2g")
+set_source_files_properties(pix2asc.xml PROPERTIES EXTRA_MAN_OUTPUTS "asc2pix")
 
 DOCBOOK_TO_HTML(man1 docbook_man1_EN html/man1/en "")
 DOCBOOK_TO_MAN(man1 docbook_man1_EN 1 1 man1 "")
Index: brlcad/doc/docbook/system/man1/en/ap-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/ap-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/ap-pix.xml	(working copy)
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='appix1'>
+<refmeta>
+<refentrytitle>AP-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>ap-pix</refname>
+<refpurpose>convert Applicon files to pix files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>ap-pix</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>file.ap</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Ap-pix</emphasis>
+converts an
+<emphasis remap='I'>Applicon</emphasis>
+drum plotter image file into a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file.</para>
+
+<para>The
+<emphasis remap='I'>Applicon</emphasis>
+file is assumed to consist of a number lines each 3456 bits long, the
+resulting
+<emphasis remap='I'>pix</emphasis>
+file thus has scanlines of 3456 pixels.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/asc-pl.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/asc-pl.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/asc-pl.xml	(working copy)
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='ascpl1'>
+<refmeta>
+<refentrytitle>ASC-PL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>asc-pl</refname>
+<refpurpose>produce Plot3 instructions from ASCII representation</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>asc-pl</command>    
+    <arg choice='opt'><arg choice='plain'><replaceable>file.asc</replaceable></arg><arg choice='opt'><replaceable>unix_plot</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Reads a stream of ASCII data representing Plot3 instructions
+and converts it to
+<citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.
+<emphasis remap='I'>Asc-pl</emphasis>
+reads from standard input and writes to standard output
+if file names are not supplied.</para>
+
+<para>The input should consist of lines of the form</para>
+
+<literallayout remap='.nf'>
+c arg arg ...
+</literallayout> <!-- .fi -->
+
+<para>where
+<emphasis remap='I'>c</emphasis>
+is one of the single-character Plot3 command names,
+and it is followed by white-space-separated arguments
+of appropriate number and types for that command.
+Optional white space and lines beginning with the comment character
+`#' are ignored.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/azel.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/azel.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/azel.xml	(working copy)
@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='azel1'>
+<refmeta>
+<refentrytitle>AZEL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>azel</refname>
+<refpurpose>rotate 3-D Cartesian data in azimuth and elevation</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>azel</command>    <arg choice='opt'><replaceable>options</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>infile</replaceable></arg><arg choice='opt'><replaceable>outfile</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Azel</emphasis>
+converts between right-handed Cartesian coordinate systems,
+an application-geometry system
+<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>, <emphasis remap='I'>z</emphasis>
+and a viewer-embedded system
+<emphasis remap='I'>d</emphasis>, <emphasis remap='I'>h</emphasis>, <emphasis remap='I'>v</emphasis>.
+These systems differ by rotation in azimuth and elevation
+about their common origin.
+Input comes from
+<emphasis remap='I'>infile</emphasis>
+and output goes to
+<emphasis remap='I'>outfile</emphasis>
+if they are specified, otherwise
+<command>azel</command>
+uses stdin and stdout, respectively.
+Each line of input must contain three numbers separated by
+white space.
+Unless the
+<option>-i</option>
+option (q.v.) is specified,
+<command>azel</command>
+interprets each triple as the
+<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>, <emphasis remap='I'>z</emphasis>
+coordinates of a vector, and prints out its
+<emphasis remap='I'>d</emphasis>, <emphasis remap='I'>h</emphasis>, <emphasis remap='I'>v</emphasis>
+coordinates.
+Any other text on the input line beyond the triple is copied verbatim.</para>
+
+<refsect2 xml:id='options'><title>Options</title>
+<para>The command-line options and their meanings are given below.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-a</option><replaceable> azim</replaceable></term>
+  <listitem>
+<para>Specifies azimuthal rotation of
+<emphasis remap='I'>azim</emphasis>
+degrees.
+Default is 0.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-e</option><replaceable> elev</replaceable></term>
+  <listitem>
+<para>Specifies elevation rotation of
+<emphasis remap='I'>elev</emphasis>
+degrees.
+Default is 0.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option><replaceable> celsiz</replaceable></term>
+  <listitem>
+<para>Specifies a cell size of
+<emphasis remap='I'>celsiz.</emphasis>
+Output vectors are scalar multiplied by
+1/<emphasis remap='I'>celsiz.</emphasis>
+Default is 1.
+Useful with the
+<option>-r</option>
+option to bin output data into cells.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i</option></term>
+  <listitem>
+<para>Causes
+<command>azel</command>
+to perform the inverse rotation.
+The input is transformed from viewer to application-geometry coordinates
+(i.e., from
+<emphasis remap='I'>d</emphasis>, <emphasis remap='I'>h</emphasis>, <emphasis remap='I'>v</emphasis>
+to
+<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>, <emphasis remap='I'>z</emphasis>).
+Incompatible with the
+<option>-p</option>
+option.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-p</option></term>
+  <listitem>
+<para>Causes
+<command>azel</command>
+to project the output vectors onto the <emphasis remap='I'>hv</emphasis> plane.
+This gives grid-plane coordinates.
+Incompatible with the
+<option>-i</option>
+option.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-r</option></term>
+  <listitem>
+<para>Causes
+<command>azel</command>
+to round each coordinate of the output vectors to the nearest integer.
+Useful with the
+<option>-c</option>
+option to bin output data into cells.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 xml:id='definitions'><title>DEFINITIONS</title>
+<para>The viewer coordinates are defined so that
+positive <emphasis remap='I'>d</emphasis> points toward the viewer,
+positive <emphasis remap='I'>h</emphasis> (horizontal) points to the viewer's right, and
+positive <emphasis remap='I'>v</emphasis> (vertical) points up.
+When <emphasis remap='I'>azim</emphasis> = <emphasis remap='I'>elev</emphasis> =0 ,
+the two coordinate systems coincide, in which case
+<command>azel</command>
+performs the identity transformation.
+Azimuth is the angle in the <emphasis remap='I'>dh</emphasis> plane
+from positive <emphasis remap='I'>h</emphasis> to positive <emphasis remap='I'>y</emphasis>,
+measured toward positive <emphasis remap='I'>d</emphasis>.
+Elevation is the angle in the <emphasis remap='I'>dv</emphasis> plane
+from positive <emphasis remap='I'>v</emphasis> to positive <emphasis remap='I'>z</emphasis>,
+measured toward positive <emphasis remap='I'>d</emphasis>.
+In the forward direction
+the azimuthal rotation is performed before the elevation,
+while in the inverse direction, the elevation is undone before the azimuth.
+Thus, the <emphasis remap='I'>z</emphasis> axis is always normal to the <emphasis remap='I'>h</emphasis> axis.
+When <emphasis remap='I'>azim</emphasis> = 90 and <emphasis remap='I'>elev</emphasis> = 0,
+<emphasis remap='I'>x</emphasis> = -<emphasis remap='I'>h</emphasis>,
+<emphasis remap='I'>y</emphasis> = <emphasis remap='I'>d</emphasis>, and
+<emphasis remap='I'>z</emphasis> = <emphasis remap='I'>v</emphasis>.
+When <emphasis remap='I'>azim</emphasis> = 0 and <emphasis remap='I'>elev</emphasis> = 90,
+<emphasis remap='I'>x</emphasis> = -<emphasis remap='I'>v</emphasis>,
+<emphasis remap='I'>y</emphasis> = <emphasis remap='I'>h</emphasis>, and
+<emphasis remap='I'>z</emphasis> = <emphasis remap='I'>d</emphasis>.</para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>The exit status is 0 if all input was successfully transformed,
+1 otherwise.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bary.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bary.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bary.xml	(working copy)
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bary1'>
+<refmeta>
+<refentrytitle>BARY</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bary</refname>
+<refpurpose>compute weighted sums of points</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bary</command>    <arg choice='opt'>-nt </arg>
+    <arg choice='opt'><arg choice='plain'>-s <replaceable>'x</replaceable></arg><arg choice='plain'><replaceable>y</replaceable></arg><arg choice='plain'><replaceable>z'</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bary</emphasis>
+computes weighted sums of a set of sites in Euclidean 3-space,
+writing them on the standard output.
+The site weights are read from
+<emphasis remap='I'>file</emphasis>
+if it is specified;
+otherwise,
+<command>bary</command>
+reads from the standard input.
+A line of input must be either
+(1) entirely white space,
+(2) white space followed by a comment (begun with the '#' character),
+or (3) white-space-separated weights, one per site.</para>
+
+<para>By default,
+<command>bary</command>
+uses the three sites (1, 0, 0), (0, 1, 0), and (0, 0, 1).
+One or more occurrences of the
+<option>-s</option>
+option cause
+<command>bary</command>
+to replace
+the default sites with all the sites
+(<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>, <emphasis remap='I'>z</emphasis>)
+<!-- .RI "(" "x" ", " "y" ", " "z" ")" " " "huh?" -->
+so specified.</para>
+
+<para>The
+<option>-n</option>
+option causes
+<command>bary</command>
+to normalize each tuple of weights to sum to one.
+This has the effect of computing
+barycentric combinations of the sites.</para>
+
+<para>If any line of weights in the input stream
+contains more fields than the number of sites,
+<command>bary</command>
+will, by default,
+ignore the excess fields.
+The
+<option>-t</option>
+option causes
+<command>bary</command>
+to copy all such trailing fields verbatim onto the tail of
+the corresponding line of output.</para>
+
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para>The command</para>
+
+<literallayout remap='.nf'>
+<!-- .in +4 -->
+bary -tn -s '0 0 0' -s '1 0 0' -s '0.5 0.866 0' &lt;&lt;EOF
+#------------------------------
+# x   y   z     aux. data
+#------------------------------
+ 1.0 2.5 3.6    58 alpha
+ 0.0 1.0 2.0    37 bravo
+13.0 9.2 6.3    69 charlie delta
+EOF
+<!-- .in &bsol;-4 -->
+</literallayout> <!-- .fi -->
+
+<para>maps the triples to points in an equilateral triangle in the <emphasis remap='I'>xy</emphasis>-plane,
+producing the following output:</para>
+
+<literallayout remap='.nf'>
+<!-- .in +4 -->
+0.605634 0.439099 0    58 alpha
+0.666667 0.577333 0    37 bravo
+0.433333 0.191432 0    69 charlie delta
+<!-- .in &bsol;-4 -->
+</literallayout> <!-- .fi -->
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Paul Tanenbaum</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1995-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/brlcad.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/brlcad.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/brlcad.xml	(working copy)
@@ -0,0 +1,439 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='brlcad1'>
+<refmeta>
+<refentrytitle>BRLCAD</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>brlcad</refname>
+<refpurpose>BRL-CAD programs for solid modeling, raytracing, graphics, and image processing</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>The BRL-CAD Distribution contains many directories of materials.
+The major categories of programs are:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='B'>mged</emphasis></term>
+  <listitem>
+<para>A multi-device interactive editor for constructing and updating
+combinatorial solid geometry (CSG)
+models.
+See
+<citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+and
+<emphasis remap='I'>Understanding the Preparation and Analysis of Solid Models</emphasis>
+by Michael John Muuss (enclosed, in the "paper") directory.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>librt</emphasis></term>
+  <listitem>
+<para>A library of functions suitable for interrogation of a
+CSG solid model, utilizing ray-tracing techniques.
+See
+<citerefentry><refentrytitle>librt</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>rt</emphasis></term>
+  <listitem>
+<para>A ray-tracing lighting model, for rendering pictures of
+<citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+CSG models.
+See
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>rtray</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>rtpp</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>conv</emphasis></term>
+  <listitem>
+<para>Programs to convert
+<citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+format binary files to a portable ASCII form, and back again.
+See
+<citerefentry><refentrytitle>asc2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>asc2pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>conv-vg2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>g2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>libpkg</emphasis></term>
+  <listitem>
+<para>A "message-passing" interface layered on top of TCP network links,
+to ease construction of network-distributed applications.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>libfb</emphasis></term>
+  <listitem>
+<para>A generic frame-buffer library which includes
+support for a number of display devices,
+as well as file, network, and debugging interfaces.
+Most programs which use this library have the letters "fb"
+in their names.  To override your system default frame-buffer,
+the environment variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+can be set.  In addition, some commands also support a
+<option>-F</option>
+<replaceable>framebuffer</replaceable>
+option.
+Note that the disk file format of
+<emphasis remap='I'>libfb</emphasis>
+is that of
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+allowing "framebuffer" files to be later processed by
+any of the "pix" family of programs.
+See
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+etc.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>fbserv</emphasis></term>
+  <listitem>
+<para>TCP-based network server which implements remote frame-buffer services.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>libsysv</emphasis></term>
+  <listitem>
+<para>Some System-V compatibility routines</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>libtermio</emphasis></term>
+  <listitem>
+<para>A library to handle terminal mode setting
+on both Berkeley or SystemV machines.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>libplot3</emphasis></term>
+  <listitem>
+<para>A public-domain version of the UNIX-Plot library
+which differs from that of the standard
+<citerefentry><refentrytitle>libplot</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+by the addition of 3-D primitives, color, floating point
+coordinate routines, and the use of a file pointer parameter.
+See
+<citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>librle</emphasis></term>
+  <listitem>
+<para>A Run-Length-Encoding (RLE) library,
+providing functions
+originally from the University of Utah in a library package.
+Note that the current version of this library reads
+Edition-3 RLE files.
+[Edition-1 and Edition-2 RLE files can be read and written
+with the
+<emphasis remap='B'>liborle</emphasis>
+and
+<emphasis remap='B'>orle</emphasis>
+programs.]
+See
+<citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>librle</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>util</emphasis></term>
+  <listitem>
+<para>A collection of image-handling utilities,
+each constructed as individual tools intended to be used in combination.
+See
+<citerefentry><refentrytitle>ap-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bw-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bw-imp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bw-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bw3-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwdiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwfilter</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwmod</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>dunncolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>dunnsnap</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fb-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fb-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbanim</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbclear</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbcmrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbcolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbframe</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbgrid</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>fbzoom</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>gencolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>loop</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-bw3</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixbackgnd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixbustup</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixdiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixfilter</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixhist3d-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixhist3d</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixinterp2x</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixtile</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pp-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>wavelet</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>fbed</emphasis></term>
+  <listitem>
+<para>An interactive, termcap-based frame-buffer image editor.
+See
+<citerefentry><refentrytitle>fbed</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>vdeck</emphasis></term>
+  <listitem>
+<para>A program to convert
+<emphasis remap='I'>mged(1)</emphasis>
+models to
+<emphasis remap='I'>gift(1)</emphasis>
+format card deck files.
+See
+<citerefentry><refentrytitle>vdeck</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='fb_file'><title>FB_FILE</title>
+<para>Whenever a framebuffer is needed, and the
+<option>-F</option>
+option has not been specified, the environment variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is checked for the device to use.  The format of this
+variable is either
+<emphasis remap='I'>[hostname:]</emphasis><filename>/dev/</filename><emphasis remap='I'>device_name[num]</emphasis>
+or
+<emphasis remap='I'>UNIX_path ,</emphasis>
+the pathname of a disk file to be used as a "virtual framebuffer."
+<emphasis remap='I'>Hostname</emphasis>
+is the name of a remote machine if the remote framebuffer interface
+is being used.
+When a local display device is being specified, the
+<emphasis remap='I'>hostname</emphasis>
+should not be specified, for performance reasons; just the
+special string
+<emphasis remap='I'>Device_name</emphasis>
+is used to select a particular type of framebuffer.
+<emphasis remap='I'>Num</emphasis>
+is type dependent and can either mean a display number or select
+some options for that type.
+Note that for security reasons, it is not permitted to access a
+disk file via the remote interface.</para>
+
+<para>If
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is not set, the default for you system will be used.</para>
+
+<para>The use of
+<filename>/dev/</filename>
+before the
+<emphasis remap='I'>device_name</emphasis>
+is simply to distinguish them from filenames.  See the end of the
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+manual page for a list of the device names and the meanings of
+any
+<emphasis remap='I'>num</emphasis>
+parameters they may take, and for a more detailed discussion.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<para>A convention exists for the options used on
+most of the utilities provided.
+Random options are usually lower case.
+Options which could specify either a screen or file size
+are, by convention, lower case for file information,
+and upper case for screen information.
+Here's a list of some of the common options you may encounter:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>The "high resolution" flag, increasing the default screen and file
+size of 512x512
+to 1024x1024.  Has same effect as
+<option>-s 1024 -S 1024</option>
+but exists as a convenient shorthand held over from the simple days
+when framebuffers where square, and only came in two resolutions.
+This historical usage unfortunately preempts this letter from use
+as a height specifier, forcing that function to relocate under
+protest to
+<option>-n</option>,
+which can be thought of as "number of scanlines", which isn't
+too bad a mnemonic.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i</option></term>
+  <listitem>
+<para>Inverse flag.  Pretend origin is in upper left corner of screen,
+for that good old-fashioned fourth-quadrant behavior.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>Various.  Typically means clear the screen first.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-z</option></term>
+  <listitem>
+<para>Various.  Typically means zoom-in on current area of display.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s </option><replaceable>square_file_size</replaceable></term>
+  <listitem>
+<para><emphasis remap='B'>WARNING:</emphasis>
+Behavior is undefined when the
+<option>-s</option>
+flag is used in conjunction with the
+<option>-w </option>or <option>-n</option>
+flags.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w </option><replaceable>file_width</replaceable></term>
+  <term><option>-n </option><replaceable>file_height</replaceable></term>
+  <term><option>-S </option><replaceable>square_screen_size</replaceable></term>
+  <listitem>
+<para><emphasis remap='B'>WARNING:</emphasis>
+Behavior is undefined when the
+<option>-S</option>
+flag is used in conjunction with the
+<option>-W </option>or <option>-N</option>
+flags.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W </option><replaceable>screen_width</replaceable></term>
+  <term><option>-N </option><replaceable>screen_height</replaceable></term>
+  <term><option>-x </option><replaceable>file_x_offset</replaceable></term>
+  <term><option>-y </option><replaceable>file_y_offset</replaceable></term>
+  <term><option>-X </option><replaceable>screen_x_offset</replaceable></term>
+  <term><option>-Y </option><replaceable>screen_y_offset</replaceable></term>
+  <term><option>-# </option><replaceable>bytes_per_sample</replaceable></term>
+  <listitem>
+<para>specifies the number of bytes per sample, where the
+flag, where the
+<emphasis remap='B'>#</emphasis>
+character is a literal "pound" or "sharp" sign character,
+typically found over the numeral "3" on ANSI keyboards.
+Several programs (like pixrect)
+can operate on data samples of arbitrary width.
+For example, a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file can often be treated like a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file with a width of three bytes per sample.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='tape_format'><title>TAPE FORMAT</title>
+<para>When dealing with large collections of images, as might be
+needed for making a movie,
+it frequently becomes desirable to deal with magnetic tapes.
+Some of the early
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+tools contained built-in knowledge of the tape format.
+While this aberrant early design has been corrected
+in favor of using tape-oriented programs such as
+<citerefentry><refentrytitle>dd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+in pipelines with the image tools, our "standard"
+image format remains.</para>
+
+<para>Regardless of image resolution, all tape records are 24k bytes long.
+If an image does not occupy an integral number of tape records,
+the last record is padded out.
+For example, NTSC images in 640x480 format use
+37.5 records per image.
+The
+<citerefentry><refentrytitle>files-tape</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+utility is helpful in performing this function.</para>
+
+<para>The capacity of an average 2400 foot reel of tape at 6250 is 6144 records
+of 24k bytes each.
+For the various combinations of density and image resolution,
+a convention for the number of frames/reel exists:</para>
+
+<para>Density  Resolution  Frames/reel</para>
+
+<para> 6250        1k          48</para>
+
+<para> 6250      640x480      160</para>
+
+<para> 6250       512         192</para>
+
+<para> 1600        1k          12</para>
+
+<para> 1600       512         48</para>
+<!-- B elided -->
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/buffer.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/buffer.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/buffer.xml	(working copy)
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='buffer1'>
+<refmeta>
+<refentrytitle>BUFFER</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>buffer</refname>
+<refpurpose>buffer data from stdin until EOF, then write to stdout</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>buffer</command>    
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Buffer</emphasis>
+is intended to be use as part of a complex pipeline.
+It serves somewhat the same purpose as the Prolog "cut" operator.
+Data from stdin is read and buffered until EOF is detected, and then
+all the buffered data is written to stdout.  An arbitrary amount of
+data may need to be buffered, so a combination of a 1 Mbyte memory buffer
+and a temporary file is used.
+This can be useful when context switching may need to be reduced,
+because of too many processes competing at the same time.
+This can also be useful when processing data from and to the
+same framebuffer with a pipeline, without interfering.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<literallayout remap='.nf'>
+munch | crunch | buffer | grind | package
+
+fb-pix | pixfilter -flo | buffer | pix-fb
+</literallayout> <!-- .fi -->
+
+</refsect1>
+
+<refsect1 xml:id='files'><title>FILES</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='I'> /usr/tmp/bufferXXXXXX </emphasis></term>
+  <listitem>
+<para>temporary file used to buffer piped data</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw-imp.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-imp.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-imp.xml	(working copy)
@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwimp1'>
+<refmeta>
+<refentrytitle>BW-IMP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw-imp</refname>
+<refpurpose>convert a black and white bw image file to imPRESS bitmap</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw-imp</command>    
+    <arg choice='opt'>-Dh </arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='opt'>-t <replaceable>thresh</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>page_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>page_yoff</replaceable></arg>
+    <arg choice='opt'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bw-imp</emphasis>
+converts an 8-bit monochrome
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format
+<emphasis remap='I'>file</emphasis>
+(read from the standard input if not specified)
+to
+<emphasis remap='I'>Imagen imPRESS</emphasis>
+language codes
+for plotting a gray-scale image on a 300dpi
+<emphasis remap='I'>Imagen</emphasis>
+laser printer.</para>
+
+<para>The gray level is plotted on the
+<emphasis remap='I'>Imagen</emphasis>
+as a small pattern of dots,
+by default using "ordered dither",
+magnifying each input pixel into multiple output pixels.
+The
+<option>-D</option>
+option causes the gray levels to instead be plotted using halftones,
+as in newspaper/magazine reproductions of photographs.
+The
+<option>-t</option>
+option turns off the dithering, and uses the supplied integer value
+as a threshold value.
+Input pixels with magnitude &gt;= thresh are output as white,
+otherwise they are output as black.
+Each input pixel produces exactly one output pixel.
+If the input file is already bi-level, such as might be produced by the
+<citerefentry><refentrytitle>halftone</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+program, then this is the option to be used.</para>
+
+<para>The
+<option>-h</option>
+option specifies a 1024x1024 image rather than the default of 512x512.
+Printing is done in portrait mode.
+The largest image which can generally be printed on an 8.5 by 11 inch
+piece of paper is 2240 by 3200 pixels,
+and the default page offsets are calculated for this size.
+For smaller images, such as 512 squared,
+<option>-X</option>750
+and
+<option>-Y</option>1200
+produce the image roughly centered on the page.</para>
+</refsect1>
+
+<refsect1 xml:id='caveats'><title>CAVEATS</title>
+<para><emphasis remap='I'>Bw-imp</emphasis>
+will take several CPU-minutes (on a VAX 780) to convert a single
+<emphasis remap='I'>file</emphasis>.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The following invocations are fairly typical:</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>pix-bw  -ntsc  image.pix  |  bw-imp  |   qpr  -qi300</emphasis>  &amp;
+</literallayout> <!-- remap='RE' -->
+
+<literallayout remap='RS'>
+<emphasis remap='I'>rle-pix  image.rle  |  pix-bw  -ntsc  |  bw-imp  |  qpr  -qi300</emphasis>  &amp;
+</literallayout> <!-- remap='RE' -->
+
+<para>The X and Y options in the bw-imp command below are to approximately
+center a 1024x1024 or 512x512
+figure on a 8.5 by 11 inch sheet of paper.
+As of release 4.0 the default margins on an output page resulting from
+a bw-imp usage are smaller.  This allows a larger image to be printed
+on one page.</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>rle-pix  image.rle  |  pix-bw  -ntsc  |  bw-imp -X 200 -Y 800  |  ipr -L impress -q i300 </emphasis>
+</literallayout> <!-- remap='RE' -->
+
+<para>To threshold and invert the black/white sense of a pix file, use:</para>
+  <blockquote remap='RS'>
+<para><emphasis remap='I'>bwmod  -m  -8  -a  255  image.pix  |  pix-bw  |  bw-imp  -t1  |
+ ttcp  -t  -p35 printhost </emphasis>
+  </para></blockquote> <!-- remap='RE' -->
+
+<para>To use the halftone package:</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>pix-bw  -ntsc  image.pix  |  halftone  |  bw-imp  |   qpr  -qi300</emphasis> &amp;
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-pix.xml	(working copy)
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwpix1'>
+<refmeta>
+<refentrytitle>BW-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw-pix</refname>
+<refpurpose>convert a black and white image to color format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw-pix</command>    
+    <arg choice='opt'><replaceable>in.bw</replaceable></arg>
+    <arg choice='opt'><replaceable>out.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bw-pix</emphasis>
+converts a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format
+file
+to a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+Each input value is replicated three times, thus the resulting
+output file has the same value in all three color planes.
+An input file name can be given, else input comes from stdin.
+Output will go to stdout unless an optional output file name
+is given.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw3</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw-png.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-png.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-png.xml	(working copy)
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwpng1'>
+<refmeta>
+<refentrytitle>BW-PNG</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw-png</refname>
+<refpurpose>convert a BRL BW(5) format image to a PNG (Portable Network Graphics) format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw-png</command>    
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-ssquaresize </arg>
+    <arg choice='opt'>-wfile_width </arg>
+    <arg choice='opt'>-nfile_height </arg>
+    <arg choice='opt'><replaceable>BRLbwfile</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>PNG_file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>bw-png</command>
+converts a
+<emphasis remap='I'>BRL BW(5)</emphasis>
+format file to a
+<emphasis remap='I'>PNG</emphasis>
+format file on the standard output. The PNG file created will be an Gray scale file with a bit-depth of 8 and a file gamma of 1.0.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-a</option></term>
+  <listitem>
+<para>autosize the input file to determine file image height and width</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n file_height</option></term>
+  <listitem>
+<para>tells
+<command>bw-png</command>
+that the input is
+<emphasis remap='I'>file_height</emphasis>
+scanlines tall</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s squaresize</option></term>
+  <listitem>
+<para>sets both the width and the height for the input to be
+<emphasis remap='I'>squaresize</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w file_width</option></term>
+  <listitem>
+<para>tells
+<command>bw-png</command>
+that the input is
+<emphasis remap='I'>file_width</emphasis>
+pixels wide</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1998-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw-ps.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-ps.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-ps.xml	(working copy)
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwps1'>
+<refmeta>
+<refentrytitle>BW-PS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw-ps</refname>
+<refpurpose>convert a black and white bw file to PostScript</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw-ps</command>    
+    <arg choice='opt'>-e </arg>
+    <arg choice='opt'>-c </arg>
+    <arg choice='opt'>-L </arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>input_squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>input_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>input_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>inches_square</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>inches_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>inches_height</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.ps</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bw-ps</emphasis>
+will take a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and produce a Postscript file
+on the standard output.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+The
+<option>-h</option>
+flag is a shorthand for an input image size of 1024 square.
+If no input size is given, defaults of 512 are assumed.</para>
+
+<para>By default the output PostScript image size is 6.75 inches.
+The
+<option>-c</option>
+option will center it on a 8.5 x 11 inch page.
+If a different output size is desired,
+<option>-S</option>
+<option>-W</option>
+and
+<option>-N</option>
+can be used to set the size in inches analogous to the input
+parameters.
+Finally,
+<option>-L</option>
+selects landscape mode, i.e. rotates the output image by ninety degrees.</para>
+
+<para>Encapsulated PostScript files can be generated via
+<option>-e.</option></para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>bw-ps -c image.bw &gt; image.ps</para>
+
+<para>Produces a 6.75 inch PostScript file from an 512 x512 input image
+and centers it on an 8.5 x 11 inch page.</para>
+
+
+<para>bw-ps -e -w 1024 -n 768 image.bw &gt; image.ps</para>
+
+<para>Takes the file image.bw which has the dimensions of 1024 pixels wide
+by 768 pixel high, and produces an Encapsulated Postscript version
+of it.</para>
+
+
+<para>bw-ps -L -c -W 5.2 &lt; image.bw &gt; image.ps</para>
+
+<para>Makes a PostScript file of the (assumed 512 square) image, with
+the output image 5.2 inches square, in landscape mode, centered
+on an 8.5 x 11 inch page.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw-rle.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-rle.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-rle.xml	(working copy)
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwrle1'>
+<refmeta>
+<refentrytitle>BW-RLE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw-rle</refname>
+<refpurpose>convert monochrome bw format image to Utah Raster Toolkit run-length encoded</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw-rle</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-C <replaceable>bg_val</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>square_file_size</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>file.bw</replaceable></arg><arg choice='opt'><replaceable>file.rle</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>bw-rle</command>
+reads a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file, converts it into a Utah Raster Toolkit
+Run-Length Encoded (RLE) format file format, and writes it to standard out.
+If
+<emphasis remap='I'>file.bw</emphasis>
+is not specified, standard input is read.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-C</option><replaceable>bg_val</replaceable></term>
+  <listitem>
+<para>This option permits
+the user to specify a background color
+as a decimal number in the range of 0 to 255.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.bw</emphasis></term>
+  <listitem>
+<para>Name of file to be read, in bw format.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Optional name of file to store RLE image in.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'> bw-rle  tank.bw   tank.rle</emphasis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Michael John Muuss</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1992-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bw3-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw3-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw3-pix.xml	(working copy)
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bw3pix1'>
+<refmeta>
+<refentrytitle>BW3-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw3-pix</refname>
+<refpurpose>merge black and white bw images into a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bw3-pix</command>    
+    <arg choice='plain'><replaceable>redinput</replaceable></arg>
+    <arg choice='plain'><replaceable>greeninput</replaceable></arg>
+    <arg choice='plain'><replaceable>blueinput</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bw3-pix</emphasis>
+merges (combines the colors of)
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format files into a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file.
+<emphasis remap='I'>Bw3-pix</emphasis>
+reads the specified input files
+and writes stdout until all files have been exhausted.
+The first file goes into the red color plane, the second green,
+the third blue.</para>
+
+<para><emphasis remap='I'>Bw3-pix</emphasis>
+accepts two special filename synonyms:
+``<emphasis remap='B'>-</emphasis>'',
+which stands for stdin, and
+``<literal>.</literal>'',
+which stands for
+<filename>/dev/null</filename>,
+the latter of which will write black into the corresponding color plane.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw3</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwcrop.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwcrop.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwcrop.xml	(working copy)
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwcrop1'>
+<refmeta>
+<refentrytitle>BWCROP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwcrop</refname>
+<refpurpose>crop black and white bw files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwcrop</command>    
+    <arg choice='plain'><replaceable>in.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>out.bw</replaceable></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>bwcrop</command>    
+    <arg choice='plain'><replaceable>in.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>out.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>inwidth</replaceable></arg>
+    <arg choice='plain'><replaceable>outwidth</replaceable></arg>
+    <arg choice='plain'><replaceable>outheight</replaceable></arg>
+    <arg choice='plain'><replaceable>ulx</replaceable></arg>
+    <arg choice='plain'><replaceable>uly</replaceable></arg>
+    <arg choice='plain'><replaceable>urx</replaceable></arg>
+    <arg choice='plain'><replaceable>ury</replaceable></arg>
+    <arg choice='plain'><replaceable>lrx</replaceable></arg>
+    <arg choice='plain'><replaceable>lry</replaceable></arg>
+    <arg choice='plain'><replaceable>llx</replaceable></arg>
+    <arg choice='plain'><replaceable>lly</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwcrop</emphasis>
+crops any quadrilateral out of an arbitrarily large
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+input file
+(<emphasis remap='I'>in.bw</emphasis>)<emphasis remap='I'>,</emphasis>
+squares that region to a given height and width output size,
+and writes the result to
+<emphasis remap='I'>out.bw</emphasis>.
+The first form of
+<command>bwcrop</command>
+prompts for all parameters it needs to do the cropping.
+All responses should be pixel counts or first
+quadrant coordinates.
+The second form allows all of the needed parameters to be given
+on the command line and is intended for use from shell scripts.
+The coordinate names stand for upper-left-x, lower-right-y, etc.</para>
+
+<para>The nearest input pixel is selected for each output pixel.  No
+interpolation is done by this program.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwdiff.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwdiff.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwdiff.xml	(working copy)
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwdiff1'>
+<refmeta>
+<refentrytitle>BWDIFF</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwdiff</refname>
+<refpurpose>compare two black and white files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwdiff</command>    
+    <arg choice='opt'><arg choice='plain'>- </arg><arg choice='opt'><replaceable>mglen</replaceable></arg></arg>
+    <arg choice='opt'>-b </arg>
+    <arg choice='plain'><replaceable>file1</replaceable></arg>
+    <arg choice='plain'><replaceable>file2</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwdiff</emphasis>
+compares two black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format files in one of several ways,
+and writes the results on standard out
+The default method of comparison is to record the differences
+as offsets from neutral, half-intensity grey (128).
+The value written will be brighter than this neutral grey
+by an amount proportional to the signed difference between
+the pixels in
+<emphasis remap='I'>file1</emphasis>
+and
+<emphasis remap='I'>file2</emphasis>.
+That is, pixels which are brighter in
+<emphasis remap='I'>file1</emphasis>
+than in
+<emphasis remap='I'>file2</emphasis>
+will be brighter than the neutral grey,
+while pixels which are dimmer in
+<emphasis remap='I'>file1</emphasis>
+than in
+<emphasis remap='I'>file2</emphasis>
+will be dimmer.
+This difference is divided by two so that the results will fit in
+the 0-&gt;255 output range.</para>
+
+<para>The
+<option>-m</option>
+flag takes the magnitude of the difference, thus no offset or
+divide is necessary.  Brighter pixels indicate larger differences
+in value.  Black indicates no difference in value.</para>
+
+<para>The flags
+<option>-g -l -e</option>
+and
+<option>-n</option>
+are relational operations, standing for greater-than, less-than,
+equal-to, and not-equal-to respectively.  Only one of these
+flags may be used at a time.  In this mode the value of a
+pixel in the first file is compared to the corresponding pixel
+in the second, and if the relation is true, a full-white (255)
+pixel is output.
+This mode is useful for producing masks
+showing pixels which satisfy the given condition.
+The default background is black, unless the
+<option>-b</option>
+option is specified, is which case the background is file1, with a
+lowered intensity.</para>
+
+<para><emphasis remap='I'>Bwdiff</emphasis>
+accepts
+``<option>-</option>''
+as a synonym for stdin, and
+``<literal>.</literal>''
+as a synonym for
+/<emphasis remap='I'>dev</emphasis>/<emphasis remap='I'>null</emphasis>.</para>
+
+<para>Note that this program also produces useful results on
+color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files.</para>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para>Suppose you ran
+<citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+on a file and found the modes to be red=107, green=93, blue=70.
+You could display those pixels whose colors are at these values by:
+<!-- .br -->
+<emphasis remap='I'>gencolor 107 93 70 | bwdiff -e file.pix - | pix-fb</emphasis></para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixdiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwfilter.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwfilter.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwfilter.xml	(working copy)
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwfilter1'>
+<refmeta>
+<refentrytitle>BWFILTER</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwfilter</refname>
+<refpurpose>apply a 3x3 filter to a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwfilter</command>    
+    <arg choice='opt'>-f <replaceable>type</replaceable></arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-d <replaceable>div</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>offset</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='opt'><replaceable>file.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>newfile.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwfilter</emphasis>
+applies one of several 3x3 kernel filters to a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+It will take a file name or else read from standard input.
+The input file size will be assumed to be 512x512
+pixels unless the
+<option>-s</option>,
+<option>-w</option>,
+or
+<option>-n</option>
+flags are used to tell it otherwise (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+By default a low pass filter is used.  The
+<option>-f </option><replaceable>type</replaceable>
+flag can be used to specify a different type of filter.</para>
+
+<para>The
+<emphasis remap='I'>type</emphasis>
+choices include:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='B'>lo</emphasis></term>
+  <listitem>
+<para>low pass, the default.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>hi</emphasis></term>
+  <listitem>
+<para>high pass</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>vg</emphasis></term>
+  <listitem>
+<para>vertical gradient</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>hg</emphasis></term>
+  <listitem>
+<para>horizontal gradient</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>la</emphasis></term>
+  <listitem>
+<para>laplacian</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>b</emphasis></term>
+  <listitem>
+<para>boxcar low pass</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>Most filters divide the result of the kernel multiplication
+by some value about in order to scale it back to a 0-&gt;255 range.
+For example, the boxcar divides by nine.  The
+<option>-d</option>
+flag can be used to change this divisor.
+Some filters also add an offset to their results.  The output of
+a laplacian for example is "centered" about zero, thus it
+adds 128 to the answer to yield a difference from neutral grey.
+The
+<option>-o</option>
+flag can bw used to change this offset.</para>
+
+<para>The
+<option>-v</option>
+flag displays the kernel values on standard error.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This should allow any 3x3 kernel to be specified.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwhist.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwhist.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwhist.xml	(working copy)
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwhist1'>
+<refmeta>
+<refentrytitle>BWHIST</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwhist</refname>
+<refpurpose>display a histogram of a black and white bw file on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwhist</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>file.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwhist</emphasis>
+displays a histogram of the pixel values in a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.  If a file is not given, standard input is read.
+The output will be displayed on the frambuffer selected via the
+<!-- B elided -->
+<envar>FB_FILE</envar>
+environment variable (see
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>).</para>
+
+<para>The relative frequency is displayed on the x axis scaled so that
+the maximum is full screen.  The value 0 is at the bottom of the
+screen, 255 is at the top.
+<!-- .br -->
+The output is overlaid on whatever is currently on the display.</para>
+
+<para>The
+<option>-v</option>
+flag will output the histogram values on the terminal.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwhisteq</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This program assumes it has at least 512 lines in y to work with.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwhisteq.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwhisteq.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwhisteq.xml	(working copy)
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwhisteq1'>
+<refmeta>
+<refentrytitle>BWHISTEQ</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwhisteq</refname>
+<refpurpose>equalize the histogram of a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwhisteq</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>file.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.equalized</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwhisteq</emphasis>
+automatically equalizes the histogram of a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+It reads the file
+<emphasis remap='I'>file.bw</emphasis>
+and writes a "remapped" version of it on its standard output.
+The method used is to distribute the values of the histogram, as
+best as possible, in order to
+produce a constant average "density",
+while maintaining monotonicity.</para>
+
+<para>The
+<option>-v</option>
+flag will output the old and new histogram values on the terminal.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwmod.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwmod.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwmod.xml	(working copy)
@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwmod1'>
+<refmeta>
+<refentrytitle>BWMOD</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwmod</refname>
+<refpurpose>arithmetically modify pixel values in black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwmod</command>    
+    <arg choice='opt'>-c </arg>
+    <arg choice='opt' rep='repeat'><arg choice='plain'>-a <replaceable>add</replaceable></arg><arg choice='plain'>-s <replaceable>sub</replaceable></arg><arg choice='plain'>-m <replaceable>mult</replaceable></arg><arg choice='plain'>-d <replaceable>div</replaceable></arg><arg choice='plain'>-A </arg><arg choice='plain'>-e <replaceable>exp</replaceable></arg><arg choice='plain'>-r <replaceable>root</replaceable></arg></arg>
+    <arg choice='plain'><replaceable>.</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwmod</emphasis>
+will perform a series of arithmetic operations on each 8-bit pixel
+of its input/output stream.  This is a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file format.
+The pixel values range from 0 to 255 and are internally operated on
+in floating point form (unless the
+<option>-c</option>
+option has been specified) so that dynamic range, truncation, and sign,
+are not a problem.  On output they are converted back to 8-bit unsigned
+values clipping to 0 and 255 if necessary.  The number of pixels clipped
+high and low, if any, are reported to standard error on completion.</para>
+
+<para>If the
+<option>-c</option>
+option is specified, then intermediate results are stored as signed characters, though
+The command line arguments remain in floating point
+format.
+This is useful when one wishes to take advantage of wrap-around
+characteristics of binary mathematics.</para>
+
+<para>Any number of operations can be given and they are applied in order.
+The choices are:
+<!-- .br -->
+<option>-a </option><replaceable>val</replaceable>
+to add a value.
+<!-- .br -->
+<option>-s </option><replaceable>val</replaceable>
+to subtract a value.
+<!-- .br -->
+<option>-m </option><replaceable>val</replaceable>
+to multiply by a value.
+<!-- .br -->
+<option>-d </option><replaceable>val</replaceable>
+to divide by a value.
+<!-- .br -->
+<option>-A</option>
+to take to absolute value of each pixel.
+<!-- .br -->
+<option>-e </option><replaceable>val</replaceable>
+to exponentiate, i.e. raise each pixel to the power
+<emphasis remap='I'>val.</emphasis>
+<!-- .br -->
+<option>-r </option><replaceable>val</replaceable>
+to take the
+<emphasis remap='I'>val</emphasis>
+root of each pixel.</para>
+
+<para>All arguments can be floating point values.  Note that this command
+can be applied to color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files also,
+but no distinction can be made between color planes.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The command
+<!-- .br -->
+<userinput>bwmod -m-1 -a255 &lt; file.bw &gt; file2.bw</userinput>
+<!-- .br -->
+will produce the negative of a file by first multiplying by minus
+one, and then adding 255 to shift the pixels back into the 0-&gt;255 range.</para>
+
+<para>One can apply a gamma factor to a file as follows:
+<!-- .br -->
+<userinput>bwmod -d255 -r2.2 -m255 &lt; file.bw &gt; file2.bw</userinput>
+<!-- .br -->
+which will first normalize the pixel values, then take the 2.2 root
+of each pixel, and finally scale it back to 0-&gt;255.
+[Note however that applying gammas this way is not recommended since
+a function call per pixel results!]</para>
+
+<para>Suppose you ran bwstat on a file and found min=80, max=210, mean=100.
+If you wish to expand the range of intensities, while still preserving
+the mean, this can be done by:
+<userinput>bwmod -s100 -m1.409 -a100 &lt; file.bw &gt; file2.bw</userinput>
+<!-- .br -->
+Where 1.409 results from (255-100)/(210-100) which is what one would use
+by boost the max value (210) to full scale (255) after subtracting the
+mean (100).  Subtracting and adding 100 make the multiply occur
+"about that point", i.e value less than 100 will get smaller; those
+above, higher.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwrect.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwrect.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwrect.xml	(working copy)
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwrect1'>
+<refmeta>
+<refentrytitle>BWRECT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwrect</refname>
+<refpurpose>extract a rectangle from a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwrect</command>    
+    <arg choice='plain'><replaceable>infile</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwrect</emphasis>
+extracts a rectangular region from a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+The program prompts for the area to extract in x and y pixels,
+the scanline length of the input file in pixels, and the origin
+in the input file from which to extract.  First quadrant coordinates
+and file storage format are used.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>We ought to allow the questions to be answered on the command line
+so that shell scripts, etc., could use this.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwrot.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwrot.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwrot.xml	(working copy)
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwrot1'>
+<refmeta>
+<refentrytitle>BWROT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwrot</refname>
+<refpurpose>rotate, invert, or reverse a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwrot</command>    
+    <group choice='opt'><arg choice='plain'>-rifb </arg><arg choice='plain'>-a <replaceable>angle</replaceable></arg></group>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>out.bw</replaceable></arg>
+    <arg choice='opt'><replaceable>file.bw</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>&gt;</replaceable></arg><arg choice='plain'><replaceable>out.bw</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>bwrot</command>
+will rotate, vertically invert, and horizontally reverse a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file or read from standard input if a file name is not given.  The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to same value via
+<option>-s.</option></para>
+
+<para>The
+<option>-r</option>
+flag reverses the scan lines left to right.
+<!-- .br -->
+The
+<option>-i</option>
+flag inverts the image top to bottom.
+<!-- .br -->
+The
+<option>-f</option>
+and
+<option>-b</option>
+flag will rotate the image ninety degrees forward or backward respectively.
+The sense of the rotation is relative to a first quadrant coordinate
+system, i.e. origin lower left, where "forward" means clockwise.</para>
+
+<para>Note that a 180 degree rotation can be obtained by both reversing
+and inverting.</para>
+
+<para>If the
+<option>-a</option>
+flag is used, the image will be rotated counterclockwise by the specified
+arbitrary angle.</para>
+
+<para>The
+<option>-o</option>
+option can be used to specify an output file instead of redirecting
+standard out.</para>
+</refsect1>
+
+<refsect1 xml:id='method'><title>METHOD</title>
+<para>A fairly large buffer is kept in memory so that, file size permitting,
+the entire rotation can occur without seeking on input or output.
+In any event, the algorithm is designed to process the input sequentially,
+so that if any seeking is required, it will happen on output only.  If
+these seeks fail, e.g. the output is a pipe, the user will be told that
+it needs a file on output.
+A more general solution to this problem would be to see if seeks can
+be done on input instead, and switch the algorithm to seek on input
+only.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>If the file size is very large, excessive seeking may occur on output
+and the rotation will take a very long time.  More complicated
+algorithms could remedy this.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwshrink.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwshrink.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwshrink.xml	(working copy)
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwshrink1'>
+<refmeta>
+<refentrytitle>BWSHRINK</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwshrink</refname>
+<refpurpose>shrink a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwshrink</command>    
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>shrink_factor</replaceable></arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-u </arg>
+    <arg choice='opt'><replaceable>infile.bw</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwshrink</emphasis>
+will take a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and produce a smaller
+scaled version.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+Defaults of 512 are assumed for unspecified dimensions.
+The integer scaling factor is set with the
+<option>-f</option>
+flag.  By default, the factor is 2.</para>
+
+<para>The program reads the entire image into memory,
+and then scales the image down by
+to 1/factor the original size in both dimensions.</para>
+
+
+<para>By default, bwshrink uses boxcar averaging to produce the output pixels from
+the input.  The
+<option>-u</option>
+option causes bwshrink to use image undersampling instead.</para>
+
+<para>The
+<option>-h</option>
+flag causes the file to be
+read in high resolution mode (1024x1024).</para>
+
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>If the dimensions of the input image are not evenly divisible by the shrink
+factor, incorrect and bizarre output is generated.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwstat.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwstat.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwstat.xml	(working copy)
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwstat1'>
+<refmeta>
+<refentrytitle>BWSTAT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwstat</refname>
+<refpurpose>list statistics related to a black and white bw image.</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwstat</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>file.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwstat</emphasis>
+will take the given
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file,
+or read from standard in.  A collection of statistics
+related to the pixel intensities is produced.
+<!-- .br -->
+These include:
+<!-- .br -->
+The number of pixels (and the square root of this which is the
+file dimensions if square).
+<!-- .br -->
+The max and min values.
+<!-- .br -->
+The mean.
+<!-- .br -->
+The median (dividing line where half the pixels are above this
+value, half below).
+<!-- .br -->
+The mode (most frequently occurring value) and the number of pixels
+at this value.
+<!-- .br -->
+The variance, standard deviation, and skew.</para>
+
+<para>The
+<option>-v</option>
+flag will also dump a histogram of the pixel values.</para>
+</refsect1>
+
+<refsect1 xml:id='method'><title>METHOD</title>
+<para>Since the pixel values are quantized (have discrete values from
+0 to 255), the statistics can be computed from "lump sums" after
+building a histogram of the input.  This results in a fantastic
+savings in computation while also making a single pass over the input
+file sufficient.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/bwthresh.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bwthresh.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/bwthresh.xml	(working copy)
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='bwthresh1'>
+<refmeta>
+<refentrytitle>BWTHRESH</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bwthresh</refname>
+<refpurpose>threshold a black-and-white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>bwthresh</command>    
+    <arg choice='plain' rep='repeat'><replaceable>val</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bwthresh</emphasis>
+reads from standard input a stream of black-and-white data in
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format
+and thresholds it among the
+<emphasis remap='I'>vals,</emphasis>
+writing the resulting
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+data to standard output.
+The
+<emphasis remap='I'>vals</emphasis>
+must appear on the command line in strictly increasing order.</para>
+
+<para>The grey scale 0..255 is divided evenly into
+<emphasis remap='I'>n</emphasis>+1
+bins,
+and each pixel of input is compared to the
+<emphasis remap='I'>vals,</emphasis>
+to determine which of the
+<emphasis remap='I'>n</emphasis>+1
+grey levels should be output.</para>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para>The command</para>
+
+<!-- .in +5 -->
+<para><emphasis remap='I'>bwthresh 37 143 &lt; file.bw &gt; file2.bw</emphasis></para>
+<!-- .in &bsol;-5 -->
+
+<para>performs the following mapping:</para>
+
+<!-- .in +5 -->
+<para>if (pixel_in &lt; 37)
+<!-- .in +2 -->
+pixel_out = 0
+<!-- .in &bsol;-2 -->
+else if (pixel_in &lt; 143)
+<!-- .in +2 -->
+pixel_out = 128
+<!-- .in &bsol;-2 -->
+else
+<!-- .in +2 -->
+pixel_out = 255</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>bwmod</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/cv.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/cv.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/cv.xml	(working copy)
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='cv1'>
+<refmeta>
+<refentrytitle>CV</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>cv</refname>
+<refpurpose>convert binary data files between representation formats</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>cv</command>    
+    <arg choice='plain'><replaceable>in_pat</replaceable></arg>
+    <arg choice='plain'><replaceable>out_pat</replaceable></arg>
+    <arg choice='opt'><arg choice='opt'><replaceable>infile</replaceable></arg><arg choice='plain'><replaceable>outfile</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Convert a binary data file from one representation (format) to another.
+The particular representation desired is expressed as a set of choices
+from the pattern: [h|n][s|u] c|s|i|l|d|8|16|32|64.
+For example, "hui" is host unsigned int, "nl" is network (signed) long.
+The default is NETWORK format.</para>
+
+<para>Host specific format is the native internal number representation used
+inside the computer that
+<command>cv</command>
+is running on.
+There is great variation between vendors in the host-specific formats
+that they use.
+Especially for double-precision floating point,
+DEC, Cray, and IBM have peculiar formats and byte orderings.
+The network-independent byte orderings used within BRL-CAD is
+big-endian (most significant bit first, on the left side of the word),
+twos compliment.
+The network-independent double-precision floating point format used
+within BRL-CAD is 64-bit IEEE 754, transmitted in big-endian order.</para>
+
+<para>Signed or unsigned integer formats can be selected.
+This has no effect on the double-precision format.</para>
+
+<para>"char", "short", "int", "long", and "double" provide their C language
+equivalent on this processor when used in "h" host-specific mode.
+"8", "16", "32", and "64" allow more precise specification of
+datum sizes for "n" network-independent mode.</para>
+
+<para>For example, to change a file of host-specific (machine-specific) signed
+shorts to a file of network-independent 32-bit integers, the input
+format would be "hss", and the output format would be "n32".</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>dpix-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+<!-- .br -->
+M. J. Muuss,
+``<emphasis remap='I'>Workstations, Networking, Distributed Graphics, and Parallel Processing</emphasis>``
+in Computer Graphics Techniques:  Theory and Practice,
+edited by D. F. Rogers, R. A. Earnshaw, Springer-Verlag, 1990.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/dbcp.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/dbcp.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/dbcp.xml	(working copy)
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='dbcp1'>
+<refmeta>
+<refentrytitle>DBCP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dbcp</refname>
+<refpurpose>double buffered copy</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>dbcp</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>blocksize</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>infile</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>dbcp</command>
+is a program for copying data rapidly between devices.</para>
+
+<para>This command is DEPRECATED.  Use 'dd' instead.</para>
+
+<para>While the primary application is to move data between raw devices such as
+tape and disk, it can also be used with pipes.
+No special support is required from the operating system;
+<command>dbcp</command>
+forks into two processes which communicate over a pair of regular pipes
+using a token passing scheme to
+synchronize their reading and writing activities.  They continue
+copying until an end of file or error is detected.
+<command>dbcp</command>
+reads from the standard input and copies to the standard output.
+The argument
+<emphasis remap='I'>blocksize</emphasis>
+specifies the number of 512 byte "blocks" to be
+read or written in each record.</para>
+
+<para>If the
+<option>-v</option>
+flag is given,
+the number of records processed is printed upon exit.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>$ <emphasis remap='B'>dbcp 16 &lt; /dev/rdk1a &gt; /dev/rmt0</emphasis>
+<!-- .br -->
+<command>dbcp</command>
+copies the filesystem on dk1a to tape
+with a record size of 8K bytes (16 * 512).
+This allows "streaming" tape drives to operate a peak speed.</para>
+
+<para>$ <emphasis remap='B'>tar cf - . | dbcp 20 &gt; /dev/rmt0</emphasis>
+<!-- .br -->
+The
+<emphasis remap='I'>tar</emphasis>
+process runs independently of the
+<command>dbcp</command>,
+which rapidly copies the data to tape
+with the usual
+<emphasis remap='I'>tar</emphasis>
+tape record size of 10K bytes (20 * 512).</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>cp</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>dd</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Douglas P. Kingston III (Davis, Polk, and Wardwell,
+Chase Manhattan Building, New York, NY)</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1993-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/decimate.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/decimate.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/decimate.xml	(working copy)
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='decimate1'>
+<refmeta>
+<refentrytitle>DECIMATE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>decimate</refname>
+<refpurpose>Reduce image or data file of MxN tuples to one of size IxJ</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>decimate</command>    
+    <arg choice='plain'><replaceable>nbytes/pixel</replaceable></arg>
+    <arg choice='plain'><replaceable>width</replaceable></arg>
+    <arg choice='plain'><replaceable>height</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>outwidth</replaceable></arg><arg choice='plain'><replaceable>outheight</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>decimate</command>
+reads a file of
+<emphasis remap='B'>width</emphasis>
+by
+<emphasis remap='B'>height</emphasis>
+data items (each of which may be of arbitrary size
+as given by
+<emphasis remap='B'>nbytes/pixel</emphasis>
+),
+and discards enough of them to result in an output file of
+<emphasis remap='B'>outwidth</emphasis>
+by
+<emphasis remap='B'>outheight</emphasis>
+items, both of which default to 512.
+If the input image size is not an integer multiple of the output
+image size, then the decimated result will be padded with zero
+elements (pixels) on the right and top to achieve an output image
+of exactly the specified size.</para>
+
+<para>To process a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file, use a value of 1 for
+<emphasis remap='B'>nbytes/pixel</emphasis>.
+To process a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file, use a value of 3 for
+<emphasis remap='B'>nbytes/pixel</emphasis>.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1992-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/dpix-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/dpix-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/dpix-pix.xml	(working copy)
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='dpixpix1'>
+<refmeta>
+<refentrytitle>DPIX-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dpix-pix</refname>
+<refpurpose>convert a double precision dpix file to a pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>dpix-pix</command>    
+    <arg choice='plain'><replaceable>file.dpix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Outputs a dpix file to pix (see
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
+format.  If the
+<option>-v</option>
+option is given, a summary of plot command usage is given at the
+end of the file.  Standard input is read if a file name is not supplied.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/dunncolor.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/dunncolor.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/dunncolor.xml	(working copy)
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='dunncolor1'>
+<refmeta>
+<refentrytitle>DUNNCOLOR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dunncolor</refname>
+<refpurpose>set exposure values for a Dunn Model 631 camera</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>dunncolor</command>    
+    <arg choice='opt'>-p </arg>
+    <arg choice='plain'><replaceable>baseval</replaceable></arg>
+    <arg choice='plain'><replaceable>redval</replaceable></arg>
+    <arg choice='plain'><replaceable>greenval</replaceable></arg>
+    <arg choice='plain'><replaceable>blueval</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Dunncolor</emphasis>
+sets the exposure values in the Dunn Instruments Model 631 camera
+to the specified values.
+If the
+<option>-p</option>
+flag is used, the Polaroid (8X10) exposure values are set.
+Otherwise, the auxiliary camera exposure values are set.
+<emphasis remap='I'>baseval,</emphasis>
+<emphasis remap='I'>redval,</emphasis>
+<emphasis remap='I'>greenval,</emphasis>
+and
+<emphasis remap='I'>blueval,</emphasis>
+are values between 0 and 255 used to calculate the exposure times for
+the red, green, and blue filters. The final value for each color is the
+product of
+<emphasis remap='I'>baseval</emphasis>
+and the value for that color
+(<emphasis remap='I'>redval</emphasis>,
+<emphasis remap='I'>greenval,</emphasis>
+or
+<emphasis remap='I'>blueval</emphasis>).
+Exposure timing is based on the counting of vertical SYNC pulses.
+The final exposure value indicates the number of SYNC pulses for
+which the camera's monitor should be unblanked. At a 60 Hz rate,
+this means an exposure time of 1 second for every 60 SYNC pulses.
+<emphasis remap='I'>Dunncolor</emphasis>
+reads the old values from the camera and prints them before setting the new values.
+The new values are then read from the camera and printed to verify that they have
+been changed. The five values printed are the exposure values for base, red,
+green, blue and black/white.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>35mm Kodachrome 64 at f/4, shaded images</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>dunncolor 2 80 16 16</emphasis>
+</literallayout> <!-- remap='RE' -->
+<para>35mm Kodachrome 64 at f/4, single-pixel wireframes, hires</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>dunncolor 14 70 16 18</emphasis>
+</literallayout> <!-- remap='RE' -->
+<para>16mm Video News Film 7250, f/8</para>
+<literallayout remap='RS'>
+<emphasis remap='I'>dunncolor 1 56 14 14</emphasis>
+</literallayout> <!-- remap='RE' -->
+<para>Typically, red is 4X green and blue.</para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Diagnostics are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 xml:id='files'><title>FILES</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='I'> /dev/camera </emphasis></term>
+  <listitem>
+<para>camera device supported by the operating system</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>dunnsnap</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/dunnsnap.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/dunnsnap.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/dunnsnap.xml	(working copy)
@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='dunnsnap1'>
+<refmeta>
+<refentrytitle>DUNNSNAP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dunnsnap</refname>
+<refpurpose>expose film in a Dunn Model 631 camera</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>dunnsnap</command>    
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'>- </arg><arg choice='opt'><replaceable>sS</replaceable></arg><arg choice='plain'><replaceable>squarescrsize</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>- </arg><arg choice='opt'><replaceable>wW</replaceable></arg><arg choice='plain'><replaceable>scr_width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>- </arg><arg choice='opt'><replaceable>nN</replaceable></arg><arg choice='plain'><replaceable>scr_height</replaceable></arg></arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><replaceable>num_frames</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Dunnsnap</emphasis>
+checks the status of the Dunn Instruments Model 631 camera and
+then attempts to take
+<emphasis remap='I'>num_frames</emphasis>
+exposures.  If
+<emphasis remap='I'>num_frames</emphasis>
+is not supplied, the number of frames exposed defaults to one.
+Status of the camera is checked before every exposure.
+Limits on
+<emphasis remap='I'>num_frames</emphasis>
+include your film budget and the mean time between
+failures of your computer, framebuffer and camera.</para>
+
+<para>By default, the
+<command>dunnsnap</command>
+command operates independently of any framebuffer.
+The
+<option>-F</option>
+flag causes the named framebuffer to be opened before exposure,
+and closed afterwards.
+This is intended for use with display systems like the SGI 4-D,
+which always run a window manager.
+The particular framebuffer options used could, for example,
+cause the image to blanket the whole screen, or
+change the video output to some other frequency.
+The behavior of the framebuffer options are specific to the
+type of device being used.</para>
+
+<para>The
+<option>-w </option><replaceable>scr_width</replaceable>
+and
+<option>-W </option><replaceable>scr_width</replaceable>
+flags specifies the width of each scanline for the display device,
+in pixels.</para>
+
+<para>The
+<option>-n </option><replaceable>scr_height</replaceable>
+and
+<option>-N </option><replaceable>scr_height</replaceable>
+flags specifies the height of each scanline for the display device.</para>
+
+<para><option>-s </option><replaceable>squarescrsize</replaceable>
+and
+<option>-S </option><replaceable>squarescrsize</replaceable>
+set both the height and width to the size given.</para>
+
+<para>The
+<option>-h</option>
+flag causes the frame buffer to be
+used in high resolution mode (1024x1024).
+This is important for frame buffers such as the Adage which operate
+differently depending on the display size.  Without this flag
+the default size for the selected device will be used (usually
+the entire screen).</para>
+
+<para>The Dunn camera has been successfully operated while attached to
+an Adage (Ikonas) RDS-3000 framebuffer in both low-res (512<superscript>2</superscript> 60 Hz)
+and high-res (1024<superscript>2</superscript> 30 Hz) modes.
+The</para>
+
+<para>The Dunn camera has also been successfully operated while attached to
+an SGI 4-D with a 4-wire RS-343 connection when the video is operated
+at 30 Hz.
+The picture should be loaded into /dev/sgi5 (Full screen, Shared memory),
+and then exposed with:</para>
+
+<literallayout remap='.nf'>
+dunnsnap -F /dev/sgi13 1
+</literallayout> <!-- .fi -->
+
+<para>Where /dev/sgi13 represents 30 Hz, Full Screen, and Shared memory bits.
+This keeps the main SGI display watchable while the images are loaded.</para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Diagnostics are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 xml:id='files'><title>FILES</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='I'> /dev/camera </emphasis></term>
+  <listitem>
+<para>camera device supported by the operating system</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>dunncolor</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/gencolor.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/gencolor.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/gencolor.xml	(working copy)
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='gencolor1'>
+<refmeta>
+<refentrytitle>GENCOLOR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>gencolor</refname>
+<refpurpose>output a pattern of byte values</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>gencolor</command>    
+    <arg choice='opt'>-r# </arg>
+    <arg choice='opt'><arg choice='plain' rep='repeat'><replaceable>val1</replaceable></arg><arg choice='plain'><replaceable>valN</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Gencolor</emphasis>
+repeats a pattern of up to 8192 8-bit values on its standard output.
+The values, which range from 0 to 255, are taken either from the command
+line, or in binary from its standard input.  The
+<option>-r</option>
+flag can be used to specify the number of times to repeat the given
+pattern, the default being infinity.
+This program is useful for producing a given grey value or
+color. Note that
+<command>gencolor</command>
+will refuse to write its output to a window, you must redirect the output to a file.</para>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para><userinput>gencolor -r512 0 255 0 &gt; foo.pix</userinput>
+<!-- .br -->
+Will output 512 "green" pixels</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/hex.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/hex.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/hex.xml	(working copy)
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='hex1'>
+<refmeta>
+<refentrytitle>HEX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>hex</refname>
+<refpurpose>Hexadecimal and ASCII dump</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>hex</command>    
+    <arg choice='opt'>-o <replaceable>offset</replaceable></arg>
+    <arg choice='opt' rep='repeat'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Hex</emphasis>
+reads each
+<emphasis remap='I'>file</emphasis>
+in sequence and
+produces a dump on the standard output
+in hexadecimal and ASCII.  If no files are specified on the command
+line,
+<command>hex</command>
+checks to to be sure the standard input is not coming from a terminal
+before dumping from the standard input.</para>
+
+<para>Input is
+dumped 16 bytes at a time.  The program displays the offset
+from the beginning of the file/input
+in hexadecimal, followed by
+the hexadecimal representations for the
+next 16
+bytes of data, and their ASCII character representations.  Non-printing
+characters are displayed as a period (".") in the ASCII section.  Vertical
+bars delimit the ASCII section.</para>
+
+<para>If multiple files are specified on the command line, each file's name is
+printed before its dump.</para>
+
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-o offset</option></term>
+  <listitem>
+<para>start printing at byte position
+<emphasis remap='I'>offset</emphasis>
+instead of at the beginning of the data.
+<emphasis remap='I'>Offset</emphasis>
+is rounded down to a multiple of 16.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para>od</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/imgdims.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/imgdims.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/imgdims.xml	(working copy)
@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='imgdims1'>
+<refmeta>
+<refentrytitle>IMGDIMS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>imgdims</refname>
+<refpurpose>guess the width and height of an image file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>imgdims</command>    
+    <arg choice='opt'>-ns </arg>
+    <arg choice='opt'>-# <replaceable>bytes_per_pixel</replaceable></arg>
+    <arg choice='plain'><replaceable>file_name</replaceable></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>imgdims</command>    
+    <arg choice='opt'>-# <replaceable>bytes_per_pixel</replaceable></arg>
+    <arg choice='plain'><replaceable>num_bytes</replaceable></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Imgdims</emphasis>
+uses the autosizing capability of
+<citerefentry><refentrytitle>libbn</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+to guess the dimensions (in pixels)
+of an image.
+The image size may be expressed either implicitly,
+by specifying the name of the file,
+or explicitly,
+by specifying a number of bytes.</para>
+
+<para>The
+<option>-n</option>
+option
+specifies that
+the dimensions should be extracted directly from
+<emphasis remap='I'>file_name</emphasis>,
+in the form of any of the standard BRL-CAD command-line options.
+Given the
+<option>-s</option>
+option,
+<command>imgdims</command>
+ignores any dimensions encoded in
+<emphasis remap='I'>file_name</emphasis>
+and uses the size of the file in bytes
+to compute the number of pixels in the image
+and then guess the image's width and height.
+The
+<option>-#</option>
+option
+specifies the size of each pixel (in bytes).</para>
+
+<para>If
+<emphasis remap='I'>file_name</emphasis>
+is specified with neither of the
+<option>-s</option> and <option>-n</option>
+options,
+<command>imgdims</command>
+tries to extract the dimensions from
+<emphasis remap='I'>file_name,</emphasis>
+and if that fails
+it computes the image size and guesses the width and height.
+If the
+<option>-#</option>
+option is not specified,
+<command>imgdims</command>
+determines the pixel size based on the extension on
+<emphasis remap='I'>file_name.</emphasis>
+If, additionally,
+<emphasis remap='I'>num_bytes</emphasis>
+was specified or
+<emphasis remap='I'>file_name</emphasis>
+contains none of the recognized extensions,
+<command>imgdims</command>
+assumes that there are 3-byte-wide pixels.</para>
+
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>libbn</refentrytitle><manvolnum>3</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Paul Tanenbaum</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1997-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/loop.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/loop.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/loop.xml	(working copy)
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='loop1'>
+<refmeta>
+<refentrytitle>LOOP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>loop</refname>
+<refpurpose>generate numerical indices for shell loops, etc.</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>loop</command>    
+    <arg choice='plain'><replaceable>start</replaceable></arg>
+    <arg choice='plain'><replaceable>finish</replaceable></arg>
+    <arg choice='opt'><replaceable>increment</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Loop</emphasis>
+generates a sequence of numbers between
+<emphasis remap='I'>start</emphasis>
+and
+<emphasis remap='I'>finish</emphasis>
+inclusive, one per line, on stdout.
+This is mostly useful for driving loops when writing Shell programs
+<citerefentry><refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+The default increment is +1 when start&lt;finish, and -1 when start&gt;finish.
+An optional
+<emphasis remap='I'>increment</emphasis>
+may be specified.
+If
+<emphasis remap='I'>increment</emphasis>
+is zero, then the
+<emphasis remap='I'>start</emphasis>
+value will be generated continuously.</para>
+
+<para>Both floating point and integer arguments can be used.  On
+integer arguments, if leading zeros are specified, they will
+be preserver on output.  This is useful for generating sequences
+of file names which are numbered with leading zeros.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<literallayout remap='.nf'>
+for i in `loop 10 30 5`
+do
+  echo $i
+done
+</literallayout> <!-- .fi -->
+
+<para>Will display the values 10, 15, 20, 25, and 30.</para>
+
+
+<literallayout remap='.nf'>
+for i in `loop 008 005`
+do
+  echo $i
+done
+</literallayout> <!-- .fi -->
+
+<para>Will display the values 008, 007, 006, 005.</para>
+
+
+<literallayout remap='.nf'>
+for i in `loop 0.1 2.9 0.5`
+do
+  echo $i
+done
+</literallayout> <!-- .fi -->
+
+<para>Will display the values 0.1, 0.6, 1.1, 1.6, 2.1, 2.6.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This program just scratches the surface.
+The shells could benefit from a greater ability to perform math.
+Limitless opportunities for extensions exist, but
+this simple version is adequate for most shell scripts
+dealing with sequences of images, etc.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1986-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/mac-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/mac-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/mac-pix.xml	(working copy)
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='macpix1'>
+<refmeta>
+<refentrytitle>MAC-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>mac-pix</refname>
+<refpurpose>convert Apple MacPaint bitmap into pix(5) or bw(5) raster image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>mac-pix</command>    
+    <arg choice='opt'>-clb </arg>
+    <arg choice='opt'>-s <replaceable>squareMacSize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>Mac_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>Mac_height</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>Mac_xoff</replaceable></arg>
+    <arg choice='opt'>-y <replaceable>Mac_yoff</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>output_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>output_yoff</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareOutputSize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>output_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>output_height</replaceable></arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='opt'><replaceable>file.mac</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Mac-pix</emphasis>
+reads an Apple MacIntosh MacPaint bitmap file and generates a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+or
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+raster image file.
+While the MacPaint file is 720x576 pixels, it is possible to specify
+an alternate size input file with the
+<option>-s</option>
+<option>-w</option>
+and
+<option>-n</option>
+flags;  the usefulness of this is unknown.
+By default, the output
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file is 1024x1024 pixels, with the input image located in the lower
+left corner of the output (nearest the origin).  The default color for
+an "on" pixel is white (R=G=B=255); alternatively, the
+<option>-C r/g/b</option>
+flag can be used to specify intensities for each of the colors, in
+the range of [0..255].
+The
+<option>-b</option>
+flag will output a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+black and white file instead.
+By specifying the
+<option>-c</option>
+flag, the input image is centered in the middle of the output image.
+By specifying the
+<option>-l</option>
+flag, the default output size is changed to 512x512.
+Alternatively, the
+<option>-S</option>
+flag can be used to specify the square output size, or
+<option>-W</option>
+and
+<option>-N</option>
+flags can be used to specify the output width and height.
+If no input file is specified, standard input is read instead.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>Especially pleasing displays of MacPaint documents can be made by using
+<citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+to combine them with the output of
+<citerefentry><refentrytitle>pixbackgnd</refentrytitle><manvolnum>1</manvolnum></citerefentry>:
+<!-- .br -->
+pixbackgnd -h 160 200 &gt; bg.pix
+<!-- .br -->
+mac-pix -c file.mac | pixmerge - bg.pix | pix-fb</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/morphedit.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/morphedit.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/morphedit.xml	(working copy)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='morphedit1'>
+<refmeta>
+<refentrytitle>MORPHEDIT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>morphedit</refname>
+<refpurpose>set up line segment correspondences between pix(5) images</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>morphedit.tcl</command>    
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='plain'><replaceable>picA.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>picB.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>linesfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>morphedit</emphasis>
+allows the user to set up line segment correspondences to be used
+by the utility
+<emphasis remap='I'>pixmorph.</emphasis></para>
+
+<!-- .br -->
+<para>First, the program displays the two images and presents a dialog box
+in which the user can enter values for
+<emphasis remap='I'>a, b,</emphasis>
+and
+<emphasis remap='I'>p</emphasis>
+(see
+<emphasis remap='I'>pixmorph(1)</emphasis>
+for details on these constants.)
+[Note: after replacing these values, the user must press &lt;Enter&gt; for
+the new values to be recorded.]</para>
+
+<para>The user is now editing the lines file
+<emphasis remap='I'>linesfile.</emphasis>
+The purpose of writing a lines file is to set up correspondences between
+the two images to improve the quality of morphed images produced by
+utilities such as
+<emphasis remap='I'>pixmorph.</emphasis>
+To set up a correspondence, the user must create a (directed) line segment
+for each image that specifies which feature of the first image
+corresponds to which feature of the second.  These directed line segments
+are created in the following fashion.</para>
+
+<para>To create the first endpoint of a new line segment, the user presses
+the left mouse button
+at the desired location in either image.  The point appears at the same
+location in the other image.  While the mouse button is held down, the
+endpoint may be dragged to any location (including off of the image...please
+do not misplace endpoints in this fashion -- they are very difficult to
+recover.)  Releasing the mouse button deposits the endpoint at that location.</para>
+
+<para>To specify the second endpoint, the user presses the left mouse button at a
+location in the image currently unoccupied by endpoints.  The line segment
+is drawn between the first and second endpoints;  and, as before,
+this endpoint may be dragged to any location.</para>
+
+<para>Endpoints may be created in pairs in this fashion.  Additionally, endpoints
+and line segments can be selected (by pressing the left mouse button while in
+the vicinity of the point or segment) and moved (by moving the mouse
+while the button is held) in either image as desired.</para>
+
+<para>To display the orientation of a line segment, the user moves the mouse
+cursor until it is over the line segment in question.  The first endpoints
+of the segments of both images appear white, and the second endpoints of the
+segments of both images appear black.  Specifying the wrong orientation
+of a line segment usually results in a poor -- albeit somewhat
+psychedelic -- morphed image, so users are encouraged to take advantage
+of this feature to verify that their line segment correspondences make sense.</para>
+
+<para>The "Save" button writes the currently displayed line segment correspondence
+set, along with the constants
+<emphasis remap='I'>a, b,</emphasis>
+and
+<emphasis remap='I'>p,</emphasis>
+to the file
+<emphasis remap='I'>linesfile.</emphasis>
+The "Quit" button closes all associated windows and terminates the program.</para>
+
+<para>The "Preview" button, with corresponding
+<emphasis remap='I'>fraction</emphasis>
+entry box, spawns a process to display the morph specified by the
+given fraction and the last *saved* version of
+<emphasis remap='I'>linesfile.</emphasis>
+(Note: this currently uses the utilities
+<emphasis remap='I'>pixmorph</emphasis>
+and
+<emphasis remap='I'>pix-fb.</emphasis>
+If the "Preview" button fails, verify that the paths to these
+utilities (specified in the first few lines of
+<emphasis remap='I'>morphedit.tcl)</emphasis>
+are correct.</para>
+
+<para>Note:
+<command>morphedit.tcl</command>
+uses
+<emphasis remap='I'>bwish</emphasis>
+instead of the standard Tcl/Tk
+<emphasis remap='I'>wish,</emphasis>
+since
+<emphasis remap='I'>bwish</emphasis>
+supports
+<emphasis remap='I'>pix</emphasis>
+images while
+<emphasis remap='I'>wish</emphasis>
+does not.  If you have difficulty running
+<emphasis remap='I'>morphedit.tcl,</emphasis>
+make sure the first line of
+<command>morphedit.tcl</command>
+(giving the path to
+<emphasis remap='I'>bwish)</emphasis>
+is correct.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>      morphedit.tcl face1.pix face2.pix lf</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmorph</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>At this time, line segments cannot be deleted.
+Unwanted correspondences should be recycled elsewhere.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1996-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/orle-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/orle-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/orle-pix.xml	(working copy)
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='orlepix1'>
+<refmeta>
+<refentrytitle>ORLE-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>orle-pix</refname>
+<refpurpose>convert old run-length encoded image to RGB pixel format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>orle-pix</command>    
+    <arg choice='opt'>-dv </arg>
+    <arg choice='opt'><arg choice='plain'>-b </arg><arg choice='opt'><replaceable>rgbwBG</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>file.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>orle-fb</emphasis>
+decodes an old University of Utah standard (Edition-2)
+Run-Length Encoded (RLE) format file
+(saved with
+<citerefentry><refentrytitle>fb-orle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-orle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+or a similar program),
+converts it into
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format, and writes it to standard out.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, standard input is read.
+<emphasis remap='I'>orle-pix</emphasis>
+determines the type and size of the saved file (color or B&amp;W)
+and acts accordingly.
+If a non-linear colormap is stored in the RLE file,
+is is applied to the pixels as they are output.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>Debug option, provides verbose description of file structure and
+processes called, written on standard error.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Provides a verbose description of the parameters of the saved image
+on standard error.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-b</option><replaceable>x</replaceable></term>
+  <listitem>
+<para>The background of the image is
+normally set to the value recorded in the RLE file.
+This option permits
+the user to specify an alternate background color from a limited
+set of colors.
+The character
+<emphasis remap='I'>x</emphasis>
+can be any of
+<emphasis remap='B'>r</emphasis>
+(red),
+<emphasis remap='B'>g</emphasis>
+(green),
+<emphasis remap='B'>b</emphasis>
+(blue),
+<emphasis remap='B'>w</emphasis>
+(white),
+<emphasis remap='B'>B</emphasis>
+(black), or
+<emphasis remap='B'>G</emphasis>
+(18% grey).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Name of file to decode, in old RLE format.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'> orle-pix  tank.rle  &gt; tank.pix</emphasis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-orle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-alias.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-alias.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-alias.xml	(working copy)
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixalias1'>
+<refmeta>
+<refentrytitle>PIX-ALIAS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-alias</refname>
+<refpurpose>convert an image from pix format to Alias(tm) pix format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-alias</command>    
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-nfile_height </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>BRLpixfile</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>ALIASpixfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>pix-alias</emphasis>
+converts the
+<emphasis remap='I'>brl pix(5)</emphasis>
+format file on the standard input to an
+<emphasis remap='I'>Alias pix</emphasis>
+format file on the standard output.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-n </option><replaceable>file_height</replaceable></term>
+  <listitem>
+<para>tells
+<emphasis remap='I'>pix-alias</emphasis>
+that the input is
+<emphasis remap='I'>file_height</emphasis>
+scanlines tall</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s </option><replaceable>squaresize</replaceable></term>
+  <listitem>
+<para>sets both the width and the height for the input to be
+<emphasis remap='I'>squaresize</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w </option><replaceable>file_width</replaceable></term>
+  <listitem>
+<para>tells
+<emphasis remap='I'>pix-alias</emphasis>
+that the input is
+<emphasis remap='I'>file_width</emphasis>
+pixels wide</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-bw.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-bw.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-bw.xml	(working copy)
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixbw1'>
+<refmeta>
+<refentrytitle>PIX-BW</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-bw</refname>
+<refpurpose>combine pix color planes into a bw black and white image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-bw</command>    
+    <arg choice='opt'>-ntsc </arg>
+    <arg choice='opt'>-crt </arg>
+    <arg choice='opt'><arg choice='plain'>-R </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-G </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-B </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>in.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pix-bw</emphasis>
+will combine or select the color planes of a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format
+file from its standard input
+and produce a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file on its standard output.
+By default all three colors are weighted equally.  The
+<option>-ntsc</option>
+uses weighting based on the NTSC primaries and the D6500
+alignment white.  The
+<option>-crt</option>
+flag applies weights for "typical" CRT phosphor chromaticities
+and the D6500 white.</para>
+
+<para>Individual color plane(s) can be selected via the
+<option>-R -G</option>
+and
+<option>-B</option>
+flags.
+If one or more of these flags is followed by a value,
+the value will be treated as a weight
+to be applied to that color
+This value is implicitly 1.0 divided by
+the number of colors selected for the flags which are not followed
+by a value.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para><emphasis remap='I'>pix-bw -R -B &lt; file.pix &gt; file.bw</emphasis>
+<!-- .br -->
+will equally blend the red and blue color planes.</para>
+
+<para><emphasis remap='I'>pix-bw -R0.30 -G0.59 -B0.11 &lt; file.pix &gt; file.bw</emphasis>
+<!-- .br -->
+has the same effect as the
+<option>-ntsc</option>
+flag.
+<!-- .br -->
+[The
+<option>-crt</option>
+weights are: 0.26, 0.66, 0.08]</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw3</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-bw3.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-bw3.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-bw3.xml	(working copy)
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixbw31'>
+<refmeta>
+<refentrytitle>PIX-BW3</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-bw3</refname>
+<refpurpose>split up the color planes of a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-bw3</command>    
+    <arg choice='plain'><replaceable>redout</replaceable></arg>
+    <arg choice='plain'><replaceable>greenout</replaceable></arg>
+    <arg choice='plain'><replaceable>blueout</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pix-bw3</emphasis>
+reads a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file
+and outputs the red, green, and blue color planes into the given
+files.  These files will then be in
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw3-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-orle.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-orle.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-orle.xml	(working copy)
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixorle1'>
+<refmeta>
+<refentrytitle>PIX-ORLE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-orle</refname>
+<refpurpose>convert a pix format RGB file into old run-length encoded form</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-orle</command>    
+    <arg choice='opt'>-hdv </arg>
+    <arg choice='opt'>-s <replaceable>squarefilesize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+    <arg choice='opt'><replaceable>file.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>pix-orle</emphasis>
+saves a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format image in a
+Run-Length Encoded (RLE) form,
+using the old University of Utah standard (Edition-2) format.
+This program is provided for compatibility with the old RLE image
+tools, and generally should not be used for saving new images,
+except where compatibility with the old tools is a factor.
+The equivalent new tool is
+<emphasis remap='I'>pix-rle(1)</emphasis>.</para>
+
+<para>If
+<emphasis remap='I'>file.pix</emphasis>
+is not specified, the
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file is read from standard in.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, the encoded file is written to standard out.
+<emphasis remap='I'>pix-orle</emphasis>
+attempts to compress flat-colored areas
+as much as possible.
+This means that it is generally reasonable to save an entire image,
+since in RLE format it will not take up much more file space than
+extracting and saving only the
+interesting portion of the image.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-w </option><replaceable>file_width</replaceable></term>
+  <listitem>
+<para>Specify the width (in pixels) of the scanlines in the input file.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n </option><replaceable>file_height</replaceable></term>
+  <listitem>
+<para>Specify the number of scanlines of input to be encoded.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s </option><replaceable>squarefilesize</replaceable></term>
+  <listitem>
+<para>Specify both the number of pixels per scanline and the number of
+scanlines in the file to process.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>"hires" flag.
+Set both the height and width of the input to 1024.
+The default is 512x512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Verbose mode.
+The program will provide voluminous status information
+on standard error as it proceeds through encoding the image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>Debug mode.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+  <blockquote remap='RS'>
+<para>pix-orle  &lt;plane.pix  plane.rle
+<!-- .br -->
+pix-orle  -h  car.pix  car.rle
+<!-- .br -->
+pixfilter -f lo &lt;truck.pix | pix-orle &gt; truck-filt.rle
+  </para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>librle</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>liborle</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-png.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-png.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-png.xml	(working copy)
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixpng1'>
+<refmeta>
+<refentrytitle>PIX-PNG</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-png</refname>
+<refpurpose>convert a BRL-CAD PIX format image to a PNG format image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-png</command>    
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-ggamma </arg>
+    <arg choice='opt'>-ssquaresize </arg>
+    <arg choice='opt'>-wfile_width </arg>
+    <arg choice='opt'>-nfile_height </arg>
+    <arg choice='opt'>-oPNG_file </arg>
+    <arg choice='opt'><replaceable>PIX_file</replaceable></arg>
+    <arg choice='opt'><replaceable>&gt;PNG_file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pix-png</command>
+converts a
+<emphasis remap='I'>BRL PIX(5)</emphasis>
+format file to a
+<emphasis remap='I'>PNG</emphasis>
+(Portable Network Graphics) format file on the standard output. The
+PNG file created will be an RGB file with a bit-depth of 8 and a file
+gamma of 1.0.</para>
+
+<para>PIX image files do not contain information about their size.  The size
+of the input PIX image file must be specified if the dimensions are
+not the default 512x512 size.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-a</option></term>
+  <listitem>
+<para>autosize the input file to determine file image height and width</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-g gamma</option></term>
+  <listitem>
+<para>sets the specified gamma correction value into the created PNG file.
+A value of 0.6 is a close approximation of PC display monitors.  A
+negative gamma value disables writing a gAMA chunk out entirely (and
+is the default).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s squaresize</option></term>
+  <listitem>
+<para>sets both the width and the height for the input to be
+<emphasis remap='I'>squaresize</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w file_width</option></term>
+  <listitem>
+<para>tells
+<command>pix-png</command>
+that the input is
+<emphasis remap='I'>file_width</emphasis>
+pixels wide</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n file_height</option></term>
+  <listitem>
+<para>tells
+<command>pix-png</command>
+that the input is
+<emphasis remap='I'>file_height</emphasis>
+scanlines tall</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o PNG_file</option></term>
+  <listitem>
+<para>tells
+<command>pix-png</command>
+to write image data to the specified
+<emphasis remap='I'>PNG_file</emphasis>
+output file.  The
+<command>pix-png</command>
+command will not write out binary image data directly to a terminal
+device as a safeguard.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1998-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-ppm.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-ppm.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-ppm.xml	(working copy)
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixppm1'>
+<refmeta>
+<refentrytitle>PIX-PPM</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-ppm</refname>
+<refpurpose>convert a BRL-CAD PIX or BW format image to a PPM format image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-ppm</command>    
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-ssquaresize </arg>
+    <arg choice='opt'>-wfile_width </arg>
+    <arg choice='opt'>-nfile_height </arg>
+    <arg choice='opt'>-#bytes_per_pixel </arg>
+    <arg choice='opt'>-oPPM_file </arg>
+    <arg choice='opt'><replaceable>PIX_file</replaceable></arg>
+    <arg choice='opt'><replaceable>&gt;PPM_file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pix-ppm</command>
+converts a
+<emphasis remap='I'>BRL PIX(5)</emphasis>
+format file to a
+<emphasis remap='I'>PPM</emphasis>
+(Portable PixMap) format file on the standard output. The PPM file
+created will be either an RGB file with 3 bytes per pixel (default) or
+a B&amp;W file with 1 byte per pixel</para>
+
+<para>PIX image files do not contain information about their size.  The size
+of the input PIX image file must be specified if the dimensions are
+not the default 512x512 size.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-a</option></term>
+  <listitem>
+<para>autosize the input file to determine file image height and width</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s squaresize</option></term>
+  <listitem>
+<para>sets both the width and the height for the input to be
+<emphasis remap='I'>squaresize</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w file_width</option></term>
+  <listitem>
+<para>tells
+<command>pix-ppm</command>
+that the input is
+<emphasis remap='I'>file_width</emphasis>
+pixels wide</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n file_height</option></term>
+  <listitem>
+<para>tells
+<command>pix-ppm</command>
+that the input is
+<emphasis remap='I'>file_height</emphasis>
+scanlines tall</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-# bytes_per_pixel</option></term>
+  <listitem>
+<para>tells
+<command>pix-ppm</command>
+how many bytes there are per pixel in the input PIX or BW file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o PPM_file</option></term>
+  <listitem>
+<para>tells
+<command>pix-ppm</command>
+to write image data to the specified
+<emphasis remap='I'>PPM_file</emphasis>
+output file.  The
+<command>pix-ppm</command>
+command will not write out binary image data directly to a terminal
+device as a safeguard.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2009-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-ps.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-ps.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-ps.xml	(working copy)
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixps1'>
+<refmeta>
+<refentrytitle>PIX-PS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-ps</refname>
+<refpurpose>convert a color pix file to PostScript</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-ps</command>    
+    <arg choice='opt'>-e </arg>
+    <arg choice='opt'>-c </arg>
+    <arg choice='opt'>-L </arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>input_squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>input_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>input_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>inches_square</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>inches_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>inches_height</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.ps</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pix-ps</emphasis>
+will take a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and produce a Postscript file
+on the standard output.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+The
+<option>-h</option>
+flag is a shorthand for an input image size of 1024 square.
+If no input size is given, defaults of 512 are assumed.</para>
+
+<para>By default the output PostScript image size is 6.75 inches.
+The
+<option>-c</option>
+option will center it on a 8.5 x 11 inch page.
+If a different output size is desired,
+<option>-S</option>
+<option>-W</option>
+and
+<option>-N</option>
+can be used to set the size in inches analogous to the input
+parameters.
+Finally,
+<option>-L</option>
+selects landscape mode, i.e. rotates the output image by ninety degrees.</para>
+
+<para>Encapsulated PostScript files can be generated via
+<option>-e.</option></para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>pix-ps -c image.pix &gt; image.ps</para>
+
+<para>Produces a 6.75 inch PostScript file from an 512x512 input image
+and centers it on an 8.5 x 11 inch page.</para>
+
+
+<para>pix-ps -e -w 1024 -n 768 image.pix &gt; image.ps</para>
+
+<para>Takes the file image.pix which has the dimensions of 1024 pixels wide
+by 768 pixel high, and produces an Encapsulated Postscript version
+of it.</para>
+
+
+<para>pix-ps -L -c -W 5.2 &lt; image.pix &gt; image.ps</para>
+
+<para>Makes a PostScript file of the (assumed 512 square) image, with
+the output image 5.2 inches square, in landscape mode, centered
+on an 8.5 x 11 inch page.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-ps</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-rle.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-rle.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-rle.xml	(working copy)
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixrle1'>
+<refmeta>
+<refentrytitle>PIX-RLE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-rle</refname>
+<refpurpose>convert RGB pixel format image to Utah Raster Toolkit run-length encoded</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-rle</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>square_file_size</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>file.pix</replaceable></arg><arg choice='opt'><replaceable>file.rle</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pix-rle</command>
+decodes a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file, converts it into a Utah Raster Toolkit
+Run-Length Encoded (RLE) format file format, and writes it to standard out.
+If
+<emphasis remap='I'>file.pix</emphasis>
+is not specified, standard input is read.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-C</option><replaceable>r/g/b</replaceable></term>
+  <listitem>
+<para>This option permits
+the user to specify a background color
+as slash separated decimal numbers in the range of 0 to 255,
+one each for the red, green, and blue channels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.pix</emphasis></term>
+  <listitem>
+<para>Name of file to decode, in pix format.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Optional name of file to store RLE image in.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'> pix-rle  tank.pix   tank.rle</emphasis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Michael John Muuss</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pix-sun.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-sun.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-sun.xml	(working copy)
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixsun1'>
+<refmeta>
+<refentrytitle>PIX-SUN</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix-sun</refname>
+<refpurpose>convert a BRL PIX(5) format image to a Sun Rasterfile format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pix-sun</command>    
+    <arg choice='opt'>-d </arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>BRLpixfile</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>rasterfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pix-sun</command>
+converts the
+<emphasis remap='I'>BRL PIX(5)</emphasis>
+format file on the standard input to a
+<emphasis remap='I'>Sun Rasterfile</emphasis>
+format file on the standard output.  The rasterfile produced is a
+"standard" (as opposed to "byte encoded") image, with
+8 bits per pixel, with a palette of 256 colors.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>use a dither map</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n file_height</option></term>
+  <listitem>
+<para>tells
+<command>pix-sun</command>
+that the input is
+<emphasis remap='I'>file_height</emphasis>
+scanlines tall</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s squaresize</option></term>
+  <listitem>
+<para>sets both the width and the height for the input to be
+<emphasis remap='I'>squaresize</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w file_width</option></term>
+  <listitem>
+<para>tells
+<command>pix-sun</command>
+that the input is
+<emphasis remap='I'>file_width</emphasis>
+pixels wide</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixbackgnd.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixbackgnd.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixbackgnd.xml	(working copy)
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixbackgnd1'>
+<refmeta>
+<refentrytitle>PIXBACKGND</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixbackgnd</refname>
+<refpurpose>generate a pix(5) shaded background</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixbackgnd</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-i </arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='opt'>-t <replaceable>title_height</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>top_inten</replaceable></arg>
+    <arg choice='opt'>-b <replaceable>bottom_inten</replaceable></arg>
+    <arg choice='plain'><replaceable>hue</replaceable></arg>
+    <arg choice='plain'><replaceable>saturation</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>pixbackgnd</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-i </arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='opt'>-t <replaceable>title_height</replaceable></arg>
+    <arg choice='plain'><replaceable>red</replaceable></arg>
+    <arg choice='plain'><replaceable>green</replaceable></arg>
+    <arg choice='plain'><replaceable>blue</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixbackgnd</emphasis>
+generates a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format shaded background on stdout suitable for
+making slides for a presentation on.
+The upper portion of the screen is reserved for a title area,
+and is drawn at constant intensity 240,
+followed by a 4 scanline white bar,
+after which the intensity smoothly decreases from 240 to 50.
+<emphasis remap='I'>Hue</emphasis>
+and
+<emphasis remap='I'>saturation</emphasis>
+are values from 0 to 255 and can be selected via
+<citerefentry><refentrytitle>fbcolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+A hue of 160 is a pleasing blue.</para>
+
+<para>By default, the title height is
+80 scanlines, or 90 scanlines if the
+<option>-h</option>
+flag is set, but the
+<option>-t </option><replaceable>title_height</replaceable>
+option may be used to specify another value.
+If
+<emphasis remap='I'>title_height</emphasis>
+is set to zero, then the white bar
+is omitted as well, and the entire display is smoothly shaded.</para>
+
+<para>By default, the display is assumed to be 512x512 pixels;
+by specifying the
+<option>-h</option>
+flag, the output size is changed to 1024x1024.</para>
+
+<para>By specifying the
+<option>-i</option>
+flag, the scanlines will be written out in inverted order
+(i.e., top to bottom).
+This is mostly useful with programs like
+<citerefentry><refentrytitle>cat-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+<para>The
+<option>-a</option>
+and
+<option>-b</option>
+options can be used to set the top and bottom intensity,
+in the range of 0 to 255.
+By default, the top intensity is 240, and the bottom is 50.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>pixbackgnd 160 200  |   pixmerge fg.pix - | pix-fb
+<!-- .br -->
+pixbackgnd -t120 160 250
+<!-- .br -->
+pixbackgnd -i -t0 160 200   |   cat-fb -O file.troff</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>cat-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>The starting and ending intensities should probably be an option.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixbgstrip.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixbgstrip.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixbgstrip.xml	(working copy)
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixbgstrip1'>
+<refmeta>
+<refentrytitle>PIXBGSTRIP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixbgstrip</refname>
+<refpurpose>strip smooth shaded background from a pix(5) file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixbgstrip</command>    
+    <arg choice='opt'>-ah </arg>
+    <arg choice='opt'>-t <replaceable>thresh</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>x_offset_for_bg_pixel</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squarefilesize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixbgstrip</command>
+reads a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file from the named file, or from
+standard input if no file is specified.
+For each scanline read, all pixels that match the color of the
+background pixel are converted to black =0/0/0,
+and then the new scanline is written on stdout.</para>
+
+<para>The default X offset for the background pixel is zero (e.g.
+<option>-x 0</option>
+), but if the pixel at X offset zero is not the desired background
+(for example, if a border exists around the actual image), then
+another offset can be specified.</para>
+
+<para>By default, a pixel will be replaced with black only if it exactly
+matches the value of the background pixel
+(e.g., the matching threshold is zero
+<option>-t </option><literal>0</literal>
+).
+However, if the background is slightly noisy, it may be necessary to
+perform a slightly looser matching.  The threshold variable
+specifies how large a difference between an input pixel and the background
+pixel will still result in black being output.</para>
+
+<para>By default, the
+<emphasis remap='I'>pix</emphasis>
+file is assumed to be 512x512 pixels.
+Specifying the
+<option>-a</option>
+flag causes the program to attempt to autosize.
+A table of common image sizes is consulted, and if any match
+the size of the input file, then the width and height values
+associated with that size will be used.
+Specifying the
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-w </option><replaceable>file_width</replaceable>
+flag specifies the width of each scanline in the input file, in pixels.</para>
+
+<para>The
+<option>-n </option><replaceable>file_height</replaceable>
+flags specifies the height in scanlines of the input file.</para>
+
+<para><option>-s </option><replaceable>squarefilesize</replaceable>
+sets both the height and width to the size given.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pixbackgnd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>If the
+<emphasis remap='I'>pix</emphasis>
+file is shorter than expected, the program exits silently.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixblend.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixblend.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixblend.xml	(working copy)
@@ -0,0 +1,138 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixblend1'>
+<refmeta>
+<refentrytitle>PIXBLEND</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixblend</refname>
+<refpurpose>blend two pix(5) or bw(5) images</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixblend</command>    
+    <arg choice='opt'><arg choice='plain'>- </arg><group choice='opt'><arg choice='plain'><replaceable>r</replaceable></arg><arg choice='plain'><replaceable>i</replaceable></arg></group><arg choice='plain'><replaceable>value</replaceable></arg></arg>
+    <arg choice='opt'>-s <replaceable>seedval</replaceable></arg>
+    <arg choice='opt'>-S </arg>
+    <arg choice='plain'><replaceable>file1.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>file2.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixblend</command>
+Given two streams of data, typically
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+or
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+images,
+generate a "blended" output stream of the same size.
+This routine operates on a pixel-by-pixel basis, and thus
+is independent of the resolution of the image.
+The type of blending performed
+is determined by the following options:</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-r</option><replaceable> VALUE</replaceable></term>
+  <listitem>
+<para>This specifies random blending; for each pixel of the output stream,
+a number will be chosen uniformly from the interval [0, 1). If this
+number exceeds VALUE,
+then the pixel from the first image will be output; otherwise, the pixel
+from the second image will be output.  Note that if VALUE is 0, then
+the output will equal the first image; if VALUE is 1, then the output
+will equal the second image.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-i</option><replaceable> VALUE</replaceable></term>
+  <listitem>
+<para>This specifies linear interpolation; for each pixel of the output
+stream, the interpolated pixel
+((1.0 - VALUE) * pixel1 + VALUE * pixel2)
+will be output (where
+pixel1 and pixel2 are the corresponding pixels from file1 and file2,
+respectively.)  Note that if VALUE is 0, then the output will equal the
+first image; if VALUE is 1, then the output will equal the second
+image.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-s</option><replaceable> SEEDVAL</replaceable></term>
+  <listitem>
+<para>By default,
+<command>pixblend</command>
+uses the value 0 as the random number seed.
+With the -s option the user may set the random number seed to SEEDVAL.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-S</option></term>
+  <listitem>
+<para>Instructs
+<command>pixblend</command>
+to use bits from the clock as a random number seed.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-g</option><replaceable> GVALUE</replaceable></term>
+  <listitem>
+<para>Tells
+<command>pixblend</command>
+to "glitterize" the image; if the random draw for a pixel is below
+GVALUE, then the pixel output is white; otherwise, the pixel used is
+determined by the ratio set with the -r option (see above.)</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>      pixblend -i .25 source.pix destination.pix &gt; out.pix
+      pixblend -r .75 source.pix destination.pix &gt; out.pix
+      pixblend -r .5 -s source.pix destination.pix &gt; out.pix
+      pixblend -r .5 -s 23 source.pix destination.pix &gt; out.pix</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>gencolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1995-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixborder.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixborder.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixborder.xml	(working copy)
@@ -0,0 +1,143 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixborder1'>
+<refmeta>
+<refentrytitle>PIXBORDER</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixborder</refname>
+<refpurpose>add a 1-pixel-wide border to regions of a specified color</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixborder</command>    
+    <arg choice='opt'><arg choice='plain'>-b <replaceable>'R</replaceable></arg><arg choice='plain'><replaceable>G</replaceable></arg><arg choice='plain'><replaceable>B'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-e <replaceable>'R</replaceable></arg><arg choice='plain'><replaceable>G</replaceable></arg><arg choice='plain'><replaceable>B'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-i <replaceable>'R</replaceable></arg><arg choice='plain'><replaceable>G</replaceable></arg><arg choice='plain'><replaceable>B'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-t <replaceable>'R</replaceable></arg><arg choice='plain'><replaceable>G</replaceable></arg><arg choice='plain'><replaceable>B'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-B <replaceable>'H</replaceable></arg><arg choice='plain'><replaceable>S</replaceable></arg><arg choice='plain'><replaceable>V'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-E <replaceable>'H</replaceable></arg><arg choice='plain'><replaceable>S</replaceable></arg><arg choice='plain'><replaceable>V'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-I <replaceable>'H</replaceable></arg><arg choice='plain'><replaceable>S</replaceable></arg><arg choice='plain'><replaceable>V'</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-T <replaceable>'H</replaceable></arg><arg choice='plain'><replaceable>S</replaceable></arg><arg choice='plain'><replaceable>V'</replaceable></arg></arg>
+    <arg choice='opt'>-x <replaceable>left_edge</replaceable></arg>
+    <arg choice='opt'>-y <replaceable>bottom_edge</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>right_edge</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>top_edge</replaceable></arg>
+    <arg choice='opt'>-ah </arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixborder</emphasis>
+reads an input stream of
+<emphasis remap='I'>pix</emphasis>
+data,
+looking for maximal contiguous regions of
+a specified interior color,
+and writes out the
+<emphasis remap='I'>pix</emphasis>
+data
+with all pixels on the boundaries of these regions changed to
+a specified border color.</para>
+
+<para>The way
+<command>pixborder</command>
+decides if a given pixel is on the boundary
+depends on how the user specified the interior and exterior.
+The
+<option>-i</option>
+option causes
+<command>pixborder</command>
+to replace
+the default interior color of 255 255 255 by
+<emphasis remap='I'>R G B</emphasis>,
+while the
+<option>-I</option>
+replaces it by
+<emphasis remap='I'>H S V</emphasis>,
+which are reals,
+with
+<emphasis remap='I'>H</emphasis> in [0, 360)
+and
+<emphasis remap='I'>S</emphasis>, <emphasis remap='I'>V</emphasis> in [0, 1].
+Similarly,
+the
+<option>-e</option> and <option>-E</option>
+options
+replace the default exterior color of 1 1 1.
+If the user specified colors for both or neither
+of the interior and exterior,
+then a pixel is on the boundary provided that
+it has the interior color
+and at least one of its four neighbors
+(left, right, above, and below) has the exterior color.
+If,
+on the other hand,
+the user specified only the interior (exterior) color,
+then a pixel is on the boundary provided that
+it has the interior color (does not have the exterior color)
+and at least one of its neighbors
+does not have the interior color (has the exterior color).</para>
+
+<para>Variability in the interior and exterior colors
+may be accommodated by the
+<option>-t</option> and <option>-T</option>
+options,
+with which one specifies a symmetric tolerance
+for each of the red, green, and blue channels
+or hue, saturation, and value.
+Any color
+within the specified tolerance of the nominal interior (exterior) color
+is treated as though it were the nominal color.</para>
+
+<para>Changes are restricted to a specified rectangular portion of the image,
+which defaults to the entire image.
+The
+<option>-x</option>
+option sets the left edge of that rectangle:
+no pixels to the left of this edge are changed.
+The
+<option>-X</option>, <emphasis remap='B'>y</emphasis>,  and <emphasis remap='B'>Y</emphasis>
+options respectively
+set the right, bottom, and top edges
+in the same manner.</para>
+
+</refsect1>
+
+<refsect1 xml:id='hint'><title>HINT</title>
+<para>To obtain borders more than one pixel wide,
+one can run several copies of
+<command>pixborder</command>
+in a pipeline.
+In doing this
+to get, for instance, a border made up of constant-thickness
+segments of different colors,
+one should produce all the segments of a given layer
+before beginning any segments of the next inner layer.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Paul Tanenbaum</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1996-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixbustup.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixbustup.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixbustup.xml	(working copy)
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixbustup1'>
+<refmeta>
+<refentrytitle>PIXBUSTUP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixbustup</refname>
+<refpurpose>break up concatenated pix images into separate files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixbustup</command>    
+    <arg choice='plain'><replaceable>basename</replaceable></arg>
+    <arg choice='plain'><replaceable>width</replaceable></arg>
+    <arg choice='opt'><replaceable>image_offset</replaceable></arg>
+    <arg choice='opt'><replaceable>first_number</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>input.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixbustup</emphasis>
+takes input consisting of a concatenated collection of
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format files
+and breaks them up into separate files.  The output file names will be
+of the form
+<emphasis remap='I'>basename.num</emphasis>,
+where
+<emphasis remap='I'>basename</emphasis>
+is given on the command line, and
+<emphasis remap='I'>num</emphasis>
+is a consecutive series of integers.  By default the first image
+will be made number " 0 ", but an alternate
+<emphasis remap='I'>first_number</emphasis>
+can be given.
+The images must be square and the width (and height) is given by
+<emphasis remap='I'>width</emphasis>.
+The program keeps reading these small files until end of file
+is reached.
+If one does not wish to extract from the beginning of the input file an
+<emphasis remap='I'>image_offset</emphasis>
+can be given which will skip that number of images before beginning.</para>
+
+<para>This program is mostly a holdover from the days when
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+wrote animations into
+one huge file, but it is still sometimes useful.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixclump.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixclump.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixclump.xml	(working copy)
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixclump1'>
+<refmeta>
+<refentrytitle>PIXCLUMP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixclump</refname>
+<refpurpose>quantize the colors in a pix(5) stream</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixclump</command>    
+    <arg choice='opt'>-c <replaceable>R/G/B</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>color_file</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>debug_flags</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>infile.pix</replaceable></arg><arg choice='opt'><replaceable>outfile.pix</replaceable></arg></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixclump</emphasis>
+reads an input stream of
+<emphasis remap='I'>pix</emphasis>
+data,
+converts each pixel to one of a set of specified colors,
+and writes out these quantized pixels.</para>
+
+<para>The colors
+may be specified
+either on the command line,
+with one
+<option>-c</option>
+option per color,
+or in a file specified with the
+<option>-f</option>
+option.</para>
+
+<para>Each pixel in the input stream
+is compared to all of the specified colors
+and replaced on the output by the specified color most resembling it.
+<emphasis remap='I'>Pixclump</emphasis>
+computes the difference between an input pixel and a specified color
+as the sum of the squares of the differences in their respective
+red, green, and blue channels.</para>
+
+<para>The
+<option>-x</option>
+option may be used to selectively enable
+various diagnostic print statements.</para>
+
+</refsect1>
+
+<refsect1 xml:id='hint'><title>HINT</title>
+<para>A typical use for
+<command>pixclump</command>
+is in renormalizing an image.
+For example,
+if a tool such as
+<emphasis remap='I'>pixscale</emphasis>
+has been used to transform
+an image containing a relatively small number of colors,
+<command>pixclump</command>
+will change pixels whose colors have been interpolated
+back to one of the original colors.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Paul Tanenbaum</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1997-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixcolors.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixcolors.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixcolors.xml	(working copy)
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixcolors1'>
+<refmeta>
+<refentrytitle>PIXCOLORS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixcolors</refname>
+<refpurpose>Count/list color values used in a PIX(5) format image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixcolors</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>pixfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixcolors</emphasis>
+reports on the standard output the number of distinct colors used in the
+<emphasis remap='I'>pix(5)</emphasis>
+format file on the standard input.</para>
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Causes a sorted list of the unique colors
+used to be printed on standard output in addition to the count report.</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixcut.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixcut.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixcut.xml	(working copy)
@@ -0,0 +1,168 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixcut1'>
+<refmeta>
+<refentrytitle>PIXCUT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixcut</refname>
+<refpurpose>extract a pix file from another pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixcut</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-H </arg>
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-C <replaceable>red/green/blue</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>in_square_size</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>out_square_size</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>horizontal</replaceable></arg>
+    <arg choice='opt'>-y <replaceable>vertical</replaceable></arg>
+    <arg choice='opt'><replaceable>infile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixcut</emphasis>
+will extract a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file from another
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.</para>
+
+<para>The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+Unspecified dimensions default to 512 pixels.</para>
+
+<para>The
+<option>-W</option>
+and
+<option>-N</option>
+flags specify the output file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-S.</option>
+Unspecified dimensions default to 512 pixels.</para>
+
+<para>The
+<option>-h</option>
+and
+<option>-H</option>
+flags indicate that the input and/or output file is high
+resolution (1024x1024) respectfully.</para>
+
+<para>The
+<option>-a</option>
+flag requests that the program attempt to autosize the input file.  Autosizing
+only works with files, pipes can not be autosized.</para>
+
+<para>The
+<option>-v</option>
+flag requests verbose mode.  When verbose mode is selected the program
+will display information on default background output if any background
+is generated.</para>
+
+<para>The
+<option>-x</option>
+and
+<option>-y</option>
+flags set the horizontal and vertical offsets from the lower left corner
+to use for extracting
+the image.  By default both are set to 0 (zero).</para>
+
+<para>The
+<option>-C</option>
+flag is used to set the background color of the output file.  If the
+output file is larger than the input file or if the corners of the output
+file do not reside within the bounds of the input file, the program will
+output pixels of background color for those locations.</para>
+
+<para>First quadrant coordinates
+and file storage formats are used.</para>
+
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The command</para>
+
+<literallayout remap='.nf'>
+pixcut -S256 file1.pix &gt; file2.pix
+</literallayout> <!-- .fi -->
+
+<para>will extract the lower left quadrant of "file1.pix" and place it in
+file2.pix.</para>
+
+<para>The command</para>
+
+<literallayout remap='.nf'>
+pixcut -S256 -x128 -y128 file1.pix &gt;file2.pix
+</literallayout> <!-- .fi -->
+
+<para>will extract the center of the 512x512 input file (file1.pix) and place
+it in file2.pix.</para>
+
+<para>The command</para>
+
+<literallayout remap='.nf'>
+pixcut -x -1 file1.pix &gt;file2.pix
+</literallayout> <!-- .fi -->
+
+<para>will shift file1.pix one pixel to the right.  If a raytrace was done with
+default parameters, the background (rays which do not intersect the model)
+are set to 0/0/1.  Since
+<command>pixcut</command>
+will fill with 0/0/1 the net result is that the model image is shifted.</para>
+
+<para>The command</para>
+
+<literallayout remap='.nf'>
+pixcut -h -x128 -y256 background.pix |
+pixmatte -w512 -e image.pix =0/0/1 - image.pix |
+pixpaste -h -x128 -y256 background.pix - &gt;new.pix
+</literallayout> <!-- .fi -->
+
+<para>will extract the center 512x512 section of the 1024x1024 background image
+composite that section with a foreground image and the place the new
+composite image into the center of the background image.</para>
+
+<para>The
+<emphasis remap='I'>pixmatte</emphasis>
+command options instruct the program that for every pixel in image.pix
+which is equal (-e) to 0/0/1 to output the corresponding pixel from
+standard input and for all others, output the corresponding pixel from
+image.pix</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixpaste</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Christopher T. Johnson (Paladin Software, P.O. Box 187, Aberdeen, MD  21001-0187)</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1992-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixdiff.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixdiff.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixdiff.xml	(working copy)
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixdiff1'>
+<refmeta>
+<refentrytitle>PIXDIFF</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixdiff</refname>
+<refpurpose>highlight pixel colors which differ between two files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixdiff</command>    
+    <arg choice='plain'><replaceable>file1.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>file2.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixdiff</emphasis>
+highlights the pixels which differ between two color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format files.
+The input files are read pixel by pixel and if any of the color
+planes red, green, or blue differ, those colors are specially marked.
+Bytes that differ by +/-1 are drawn with intensity 192, bytes
+that differ more are displayed at
+full intensity of 255.  If none of the color values differ, an NTSC
+converted black
+and white equivalent at one half the original intensity is displayed.
+This is to aid in seeing where in the image the different pixels lie.
+Upon completion,
+<command>pixdiff</command>
+reports the number of bytes matching, the number off by 1, and the number
+off by many.</para>
+
+<para>Also see
+<citerefentry><refentrytitle>bwdiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+which can still be used on
+<emphasis remap='I'>pix</emphasis>
+files, yet can produce different kinds
+of output.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwdiff</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixdsplit.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixdsplit.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixdsplit.xml	(working copy)
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixdsplit1'>
+<refmeta>
+<refentrytitle>PIXDSPLIT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixdsplit</refname>
+<refpurpose>disentangle chars from doubles in a stream</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixdsplit</command>    <arg choice='opt'><replaceable>options</replaceable></arg>
+    <arg choice='opt'><replaceable>infile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixdsplit</emphasis>
+separates out interwoven characters and doubles
+from a single input stream.
+It treats the stream as consisting of successive "pixels",
+each of which is made up of
+<emphasis remap='I'>n</emphasis>
+unsigned chars
+followed by
+<emphasis remap='I'>m</emphasis>
+64-bit doubles,
+and writes the chars to one output stream
+and the doubles to another.
+The pixels are read from
+<emphasis remap='I'>infile</emphasis>
+if it is specified;
+otherwise,
+<command>pixdsplit</command>
+reads from the standard input.</para>
+
+
+<refsect2 xml:id='options'><title>Options</title>
+<para>The command-line options and their meanings are:</para>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-c</option><replaceable> charfile</replaceable></term>
+  <listitem>
+<para>Causes
+<command>pixdsplit</command>
+to write the chars to the specified file.
+If
+<emphasis remap='I'>charfile</emphasis>
+is the empty string,
+then
+<command>pixdsplit</command>
+does not write out the chars.
+Default is "-",
+so the chars are written to the standard output.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option><replaceable> doublefile</replaceable></term>
+  <listitem>
+<para>Causes
+<command>pixdsplit</command>
+to write the doubles to the specified file.
+If
+<emphasis remap='I'>doublefile</emphasis>
+is the empty string,
+then
+<command>pixdsplit</command>
+does not write out the doubles.
+Default is ``'',
+so the doubles are not output.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-#</option><replaceable> n.m</replaceable></term>
+  <listitem>
+<para>Defines a pixel to be made up of
+<emphasis remap='I'>n</emphasis>
+unsigned chars and
+<emphasis remap='I'>m</emphasis>
+64-bit doubles,
+where
+<emphasis remap='I'>n</emphasis> and <emphasis remap='I'>m</emphasis>
+are positive integers.
+Either of
+<emphasis remap='I'>n</emphasis> and <emphasis remap='I'>m</emphasis>
+(but not both)
+may be omitted
+and if
+<emphasis remap='I'>m</emphasis>
+is omitted,
+then the separating period, too, may be omitted.
+The variable for which a value was omitted
+retains its previous value.
+By default,
+<emphasis remap='I'>n</emphasis> = 3
+and
+<emphasis remap='I'>m</emphasis> = 1<emphasis remap='I'>,</emphasis>
+so
+the input stream is assumed to be in
+<citerefentry><refentrytitle>pixd</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format
+as produced by the
+<option>-d</option>
+option of
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The command</para>
+
+<literallayout remap='.nf'>
+<!-- .in +4 -->
+pixdsplit file.pixd | pix-fb
+<!-- .in &bsol;-4 -->
+</literallayout> <!-- .fi -->
+
+<para>extracts the
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+data from
+<emphasis remap='I'>file.pixd,</emphasis>
+sending it for display to
+<citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+while</para>
+
+<literallayout remap='.nf'>
+<!-- .in +4 -->
+pixdsplit -# 3.2 -c '' -d coords datafile
+<!-- .in &bsol;-4 -->
+</literallayout> <!-- .fi -->
+
+<para>ignores the RGB information in
+<emphasis remap='I'>datafile</emphasis>
+but writes its pairs of doubles to
+<emphasis remap='I'>coords.</emphasis></para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixd</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Paul Tanenbaum</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1996-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixfade.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixfade.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixfade.xml	(working copy)
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixfade1'>
+<refmeta>
+<refentrytitle>PIXFADE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixfade</refname>
+<refpurpose>darken a pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixfade</command>    
+    <arg choice='opt'>-f <replaceable>fraction</replaceable></arg>
+    <arg choice='opt'>-m <replaceable>max</replaceable></arg>
+    <arg choice='opt'>-p <replaceable>percentage</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixfade</command>
+darkens a color pix file by fading the entire image a fractional amount
+or by using a pixel value as a maximum level.</para>
+
+<para>The
+<option>-f</option>
+option specifies a nonnegative fractional multiplier which is used
+to scale the red, green, and blue values of each pixel.  In a similar
+way, the
+<option>-p</option>
+option is used to specify the multiplier as a nonnegative percentage.</para>
+
+<para>An alternative way to darken the image is to specify a ceiling pixel
+level (0 - 255) with the
+<option>-m</option>
+option.  The pixel plotted is the minimum of the ceiling value and the
+red, green, and blue levels of the pixel.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixfilter.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixfilter.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixfilter.xml	(working copy)
@@ -0,0 +1,131 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixfilter1'>
+<refmeta>
+<refentrytitle>PIXFILTER</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixfilter</refname>
+<refpurpose>apply a 3x3 filter to a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixfilter</command>    
+    <arg choice='opt'>-f <replaceable>type</replaceable></arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-d <replaceable>div</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>offset</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>newfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixfilter</emphasis>
+applies one of several 3x3 kernel filters to a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+It will take a file name or else read from standard input.
+The input file size will be assumed to be 512 by 512 pixels
+unless the
+<option>-w</option>,
+and/or
+<option>-n</option>,
+or the
+<option>-s</option>
+flags are used to tell it otherwise.
+By default a low pass filter is used.  The
+<option>-f </option><replaceable>type</replaceable>
+flag can be used to specify a different type of filter.</para>
+
+<para>The
+<emphasis remap='I'>type</emphasis>
+choices include:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='B'>lo</emphasis></term>
+  <listitem>
+<para>low pass, the default.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>hi</emphasis></term>
+  <listitem>
+<para>high pass</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>vg</emphasis></term>
+  <listitem>
+<para>vertical gradient</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>hg</emphasis></term>
+  <listitem>
+<para>horizontal gradient</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>la</emphasis></term>
+  <listitem>
+<para>laplacian</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>b</emphasis></term>
+  <listitem>
+<para>boxcar low pass</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>Most filters divide the result of the kernel multiplication
+by some value in order to scale it back to a 0-&gt;255 range.
+For example, the boxcar divides by nine.  The
+<option>-d</option>
+flag can be used to change this divisor.
+Some filters also add an offset to their results.  The output of
+a laplacian for example is "centered" about zero, thus it
+adds 128 to the answer to yield a difference from neutral grey.
+The
+<option>-o</option>
+flag can be used to change this offset.</para>
+
+<para>The
+<option>-v</option>
+flag displays the kernel values on standard error.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This should allow any 3x3 kernel to be specified.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixhalve.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixhalve.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixhalve.xml	(working copy)
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixhalve1'>
+<refmeta>
+<refentrytitle>PIXHALVE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixhalve</refname>
+<refpurpose>halve a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixhalve</command>    
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixhalve</emphasis>
+will take a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and reduce the resolution of the file
+by one half in each direction using a 5x5 pyramid filter.  If a file name
+is not given, standard input will be used.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+Defaults of 512 are assumed for unspecified dimensions.</para>
+
+<para>The
+<option>-h</option>
+flag indicates the input file is
+high resolution (1024x1024).</para>
+
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixinterp2x</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixhist.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixhist.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixhist.xml	(working copy)
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixhist1'>
+<refmeta>
+<refentrytitle>PIXHIST</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixhist</refname>
+<refpurpose>display a histogram of a color pix file on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixhist</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixhist</emphasis>
+displays a histogram of the pixel values of the given
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file, or, if no file is specified, will read from standard in.
+The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+If this variable is not set, the default device for your system will
+be used.</para>
+
+<para>The relative frequency is displayed on the x axis scaled so that
+the maximum is full screen.  The value 0 is at the bottom of the
+screen, 255 is at the top.
+All three colors will be drawn on each scan line, and all are scaled
+by the same factor.
+<!-- .br -->
+The output is overlaid on whatever is currently on the display.</para>
+
+<para>The
+<option>-v</option>
+flag will also output the histogram values on the terminal.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist3d</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This program assumes it has at least 512 lines in y to work with.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixhist3d-pl.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixhist3d-pl.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixhist3d-pl.xml	(working copy)
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixhist3dpl1'>
+<refmeta>
+<refentrytitle>PIXHIST3D-PL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixhist3d-pl</refname>
+<refpurpose>output RGB color space utilization in 3D unix-plot form</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixhist3d-pl</command>    
+    <group choice='plain'><arg choice='opt'><replaceable>file.pix</replaceable></arg><arg choice='plain'><replaceable>plot</replaceable></arg></group>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixhist3d-pl</emphasis>
+takes a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file
+and outputs points for each RGB color occurring in the image.
+The format of these points is the BRL extended three dimensional UNIX
+plot (see
+<citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>).
+A red, green, and blue line is drawn along the edges of the
+color space indicating the coordinate axis.  The resolution of the
+color space is 128x128x128, i.e. the least significant bit of each
+color plane is ignored.</para>
+
+<para>These plots are best viewed on an interactive 3D UNIX plot display
+program, so that the color cube can be viewed from all angles.
+Anomalies in the colors of an image can often be seen, e.g.
+oversaturation resulting in intensity clipping.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist3d</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-sgi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixhist3d.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixhist3d.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixhist3d.xml	(working copy)
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixhist3d1'>
+<refmeta>
+<refentrytitle>PIXHIST3D</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixhist3d</refname>
+<refpurpose>display RGB color space utilization</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixhist3d</command>    
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixhist3d</emphasis>
+builds up a count of color frequencies in the RGB color space and
+then displays three orthographic views of this color space.
+An RGB color cube with red, green, and blue values from 0 to 255
+form a right handed coordinate system.  Three faces of this cube
+are displayed where the intensity of the pixels shown for each face
+correspond to the integrated frequencies through the color cube
+perpendicular to that face.  These frequencies are scaled so that the
+maximum value is full white, and any non-zero scaled count less than
+30 is displayed at intensity 30 so as to be visible.</para>
+
+<para>The faces are:
+<!-- .br -->
+Lower left: red vertical, green horizontal
+<!-- .br -->
+Upper left: blue vertical, green horizontal
+<!-- .br -->
+Lower right: red vertical, blue horizontal</para>
+
+<para>The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+If this variable is not set, the default device for your system will
+be used.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist3d-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixstat</refentrytitle><manvolnum>1</manvolnum></citerefentry> <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixinterp2x.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixinterp2x.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixinterp2x.xml	(working copy)
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixinterp2x1'>
+<refmeta>
+<refentrytitle>PIXINTERP2X</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixinterp2x</refname>
+<refpurpose>interpolate a color pix file twice as large as the original</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixinterp2x</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>squarefilesize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixinterp2x</emphasis>
+does a bilinear interpolation between the pixels of the
+input
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file to create the output file.
+This program is most useful when creating images for photographing.
+Even though no additional image information is created,
+there may be significant photographic advantages to operating
+the display at its highest resolution.</para>
+
+<para>This is a very fast implementation of one special case of
+interpolation;  the general tool for interpolation is
+<citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>"hires" flag.
+Set both the height and width of the input to 1024.
+The default is 512x512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w </option><replaceable>file_width</replaceable></term>
+  <listitem>
+<para>Specify the width (in pixels) of the scanlines in the input file.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n </option><replaceable>file_height</replaceable></term>
+  <listitem>
+<para>Specify the number of scanlines of input to be processed.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s </option><replaceable>squarefilesize</replaceable></term>
+  <listitem>
+<para>Specify both the number of pixels per scanline and the number of
+scanlines in the file to process.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>The interpolated scanlines fall exactly half way between the input
+lines, and the input lines are exactly preserved.  Rather than extrapolate
+beyond the edges of the file, the first X and Y line is duplicated (left
+and bottom edge).  This differs from the behavior of
+<citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>More memory is used than is strictly necessary.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixmatte.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixmatte.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixmatte.xml	(working copy)
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixmatte1'>
+<refmeta>
+<refentrytitle>PIXMATTE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixmatte</refname>
+<refpurpose>matte (merge) two pix(5) or bw(5) images by a formula</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixmatte</command>    
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'>-w <replaceable>bytes_wide</replaceable></arg>
+    <arg choice='opt'>-glen </arg>
+    <arg choice='plain'><replaceable>in1</replaceable></arg>
+    <arg choice='plain'><replaceable>in2</replaceable></arg>
+    <arg choice='plain'><replaceable>true_out</replaceable></arg>
+    <arg choice='plain'><replaceable>false_out</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>output</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Given four streams of data elements,
+where element is of arbitrary width,
+typically
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+or
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+images,
+<command>pixmatte</command>
+outputs a stream of the same number of data elements.
+The value of the output stream is determined element-by-element,
+by comparing the
+first (foreground) input stream with the
+the second (background, or matte) input stream.
+If the formula holds true, the element from the
+true-output stream is written,
+otherwise, the element from the false-output stream is written.
+Each of these streams comes from a file, or is given as a constant.
+A particular file may be used to feed more than one stream,
+and the name '-' specifies stdin.
+For example, the foreground file may also be the true-output file.
+This routine operates on an element-by-element basis, and thus
+is independent of the resolution of the image.</para>
+
+<para>The formula can be any combination of
+<option>-g</option>
+(in1 greater than in2),
+<option>-l</option>
+(in1 less than in2),
+<option>-e</option>
+(in1 equal to in2),
+<option>-n</option>
+(in1 not equal to in2).
+For example,
+<option>-ge</option>
+specifies in1 greater than or equal to in2.</para>
+
+<para>The
+<option>-a</option>
+flag can be used with
+<option>-n</option>
+or
+<option>-e</option>
+to specify approximately equal or approximately not equal
+to match dithered backgrounds.
+Approximate equality exists when all bytes in the elements
+match to within plus or minus one.</para>
+
+<para>For example,
+<option>-le</option>
+is true when in1 is lexically less than or equal to in2,
+that is, when all bytes of the in1 element are less than
+or equal to the bytes of the in2 element.
+The
+<option>-w#</option>
+flag specifies the width (in bytes) of each element;  the default is
+3, <emphasis remap='I'>ie</emphasis>
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file format.  A width of 1 is used for processing
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files.  It is unclear if other widths are useful.</para>
+
+<para>A constant value is specified instead of a filename
+if the first character of the file name is a equal sign '='.
+The value is specified as a slash separated string of
+<emphasis remap='B'>width</emphasis>
+decimal numbers, with no separating white space.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>To compare all foreground
+pixels to black (all bytes zero),
+selecting the foreground pixels when true and a background elsewhere, specify:</para>
+
+<para>   pixmatte -g fg.pix =0/0/0 fg.pix bg.pix</para>
+
+<para>To keep all foreground pixels greater than 20/20/20, and replace
+all those less than or equal to it with 200/0/200, use:</para>
+
+<para>      pixmatte -g fg.pix =20/20/20 fg.pix =200/0/200</para>
+
+<para>To keep all foreground pixels which are not equal to 63/0/127,
+and to replace those which are equal with a generated background from
+stdin, use the following commands.
+This can be useful when compositing an
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+generated image on top of a nicer background.</para>
+
+<para>      pixbackgnd -t0 160 200 |
+<!-- .br -->
+      pixmatte -n fg.pix =63/0/127 fg.pix - |
+<!-- .br -->
+      pix-fb</para>
+
+<para>To produce a black-and-white stencil matte file for further processing,
+use:</para>
+
+<para>      pixmatte -n fg.pix bg.pix =255/255/255 =0/0/0</para>
+
+<para>To set to black all pixels that approximately match (by +/- 1)
+a given background file, use:</para>
+
+<para>      pixmatte -a -e fg.pix bg.pix =0/0/0 fg.pix</para>
+
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>gencolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixbackgnd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixmerge.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixmerge.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixmerge.xml	(working copy)
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixmerge1'>
+<refmeta>
+<refentrytitle>PIXMERGE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixmerge</refname>
+<refpurpose>merge two pix(5) or bw(5) images by a formula</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixmerge</command>    
+    <arg choice='opt'>-glen </arg>
+    <arg choice='opt'>-w <replaceable>bytes_wide</replaceable></arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='plain'><replaceable>foreground.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>background.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixmerge</command>
+Given two streams of data, typically
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+or
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+images,
+generate an output stream of the same size, where the value of
+the output is determined by a formula involving the first
+(foreground) stream and a constant, or the value of the second
+(background) stream.
+This routine operates on a pixel-by-pixel basis, and thus
+is independent of the resolution of the image.
+More sophisticated processing can be performed by the
+<emphasis remap='I'>pixmatte</emphasis>
+program.</para>
+
+<para>The formula can be any combination of
+<option>-g</option>
+(fg greater than bg),
+<option>-l</option>
+(fg less than bg),
+<option>-e</option>
+(fg equal to bg),
+<option>-n</option>
+(fg not equal to bg).
+For example,
+<option>-le</option>
+selects a foreground pixel when it
+is lexically less than or equal to the background pixel,
+that is, when all bytes of the foreground pixel are less than
+or equal to the background pixel.
+The
+<option>-w#</option>
+flag specifies the width (in bytes) of each "pixel";  the default is
+3, <emphasis remap='I'>ie</emphasis>
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file format.  A width of 1 is used for processing
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files.  It is unclear if other widths are useful.
+If the
+<option>-C r/g/b</option>
+option is specified, then the constant color specified by r/g/b
+is used in place of the appropriate background pixel values.
+It is expected that there will be up to
+<emphasis remap='B'>width</emphasis>
+slash-separated constants given as a single parameter here.</para>
+
+<para>If no formula is specified, the default is to take all foreground
+pixels greater than black (all bytes zero), which can be specified
+as:
+<!-- .br -->
+   pixmerge -g -C 0/0/0 fg.pix bg.pix</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>   gencolor 200 0 200 |
+      pixmerge -g -C 20/20/20 fg.pix - &gt; out.pix</para>
+
+<para>   pixbackgnd -t0 160 200 |
+      pixmerge -n -C 63/0/127 fg.pix - | pix-fb
+The second example is used to composite an
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+generated image on top of a shaded background.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>gencolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixbackgnd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmatte</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixmorph.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixmorph.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixmorph.xml	(working copy)
@@ -0,0 +1,346 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixmorph1'>
+<refmeta>
+<refentrytitle>PIXMORPH</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixmorph</refname>
+<refpurpose>morph two pix(5) images</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixmorph</command>    
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>height</replaceable></arg>
+    <arg choice='plain'><replaceable>picA.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>picB.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>linesfile</replaceable></arg>
+    <arg choice='plain'><replaceable>warpfrac</replaceable></arg>
+    <arg choice='plain'><replaceable>dissolvefrac</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixmorph</command>
+performs feature-based image metamorphosis between "picA.pix" and "picB.pix".
+The feature correspondences
+are specified in the file "linesfile", which can be created
+using a utility such as
+<emphasis remap='I'>morphedit.tcl</emphasis>
+(see
+<emphasis remap='I'>morphedit(1)).</emphasis></para>
+
+<!-- .br -->
+<para>The output image is computed in the following fashion.
+First, for each pixel in the output image, we choose a set
+<emphasis remap='I'>A</emphasis>
+of pixels
+(and associated weights) from "picA.pix" and another set
+<emphasis remap='I'>B</emphasis>
+of pixels
+from "picB.pix" (how these sets and weights
+are chosen will be described momentarily).
+The pixel values from
+<emphasis remap='I'>A</emphasis>
+are then averaged (using the associated weights)
+to determine the contribution
+<emphasis remap='I'>cA</emphasis>
+from the original image; the contribution
+<emphasis remap='I'>cB</emphasis>
+is computed similarly.  Then, the values
+<emphasis remap='I'>cA</emphasis>
+and
+<emphasis remap='I'>cB</emphasis>
+are interpolated by the value
+<emphasis remap='I'>dissolvefrac</emphasis>
+to compute the final value of the output pixel.</para>
+
+<para>Now, the contribution
+<emphasis remap='I'>cA</emphasis>
+from the original image is intended to be the value from
+<emphasis remap='I'>picA.pix</emphasis>
+that gets "warped to" the location in question.
+It is this computation (more specifically, the computation of
+<emphasis remap='I'>A</emphasis>
+and associated weights)
+that is the heart of the morphing algorithm,
+and is described briefly here.</para>
+
+<para>First, the linesfile is processed.  The linesfile
+is of the form
+<!-- .br -->
+ a b p n
+ lineseg1_initial lineseg1_final
+ lineseg2_initial lineseg2_final
+<!--    .
+   .
+   . -->
+ linesegn_initial linesegn_final
+<!-- .br -->
+where
+<emphasis remap='I'>n</emphasis>
+equals the number of line segments, and
+<emphasis remap='I'>a, b,</emphasis>
+and
+<emphasis remap='I'>p</emphasis>
+are constants that alter the nature of the morph.
+A line segment is represented as a list of four real numbers (and is
+interpreted as a directed line segment.)
+For example,
+<!-- .br -->
+ 0.1 2.0 0.2 2
+ 0.714844 0.560547 0.988281 0.277344 0.347656 0.646484 0.654297 0.896484
+ 0.341797 0.611328 0.757812 0.265625 0.628906 0.519531 0.925781 0.763672
+<!-- .br -->
+is a valid lines file.
+Typically, the pairs
+<emphasis remap='I'>linesegi_initial linesegi_final</emphasis>
+have been placed by the user in the lines file to match up
+particular features of
+<emphasis remap='I'>picA.pix</emphasis>
+and
+<emphasis remap='I'>picB.pix</emphasis>
+(the feature at
+<emphasis remap='I'>linesegi_initial</emphasis>
+in
+<emphasis remap='I'>picA.pix</emphasis>
+corresponds to the feature at
+<emphasis remap='I'>linesegi_final</emphasis>
+in
+<emphasis remap='I'>picB.pix.)</emphasis>
+For instance,
+<emphasis remap='I'>lineseg1_initial</emphasis>
+might be a line segment running down the length of the nose of a person
+displayed in
+<emphasis remap='I'>picA.pix;</emphasis>
+then
+<emphasis remap='I'>lineseg1_final</emphasis>
+would be a line segment running down the length of the nose of the person
+featured in
+<emphasis remap='I'>picB.pix.</emphasis>
+See
+<emphasis remap='I'>morphedit(1)</emphasis>
+for more information about creating a lines file.</para>
+
+<para>Now, for each line segment pair
+<emphasis remap='I'>(s,t),</emphasis>
+we perform the following procedure:
+We interpolate between
+<emphasis remap='I'>s</emphasis>
+and
+<emphasis remap='I'>t</emphasis>
+by factor
+<emphasis remap='I'>warpfrac</emphasis>
+to yield the interpolated line segment
+<emphasis remap='I'>s'.</emphasis>
+From the change in position, scale, and orientation of a line segment from
+its initial position
+<emphasis remap='I'>s</emphasis>
+to its interpolated counterpart
+<emphasis remap='I'>s'</emphasis>
+we may deduce a linear transformation in the image space.
+More specifically, if the line segment
+<emphasis remap='I'>s</emphasis>
+must undergo
+translation, stretching, and rotation
+to yield
+<emphasis remap='I'>s',</emphasis>
+we compute a linear transformation
+<emphasis remap='I'>T</emphasis>
+of the image space that
+performs the same translation, stretching, and rotation.
+(So
+<emphasis remap='I'>T</emphasis>
+applied to
+<emphasis remap='I'>s</emphasis>
+yields
+<emphasis remap='I'>s'.)</emphasis>
+The inverse
+<emphasis remap='I'>T*</emphasis>
+of this transformation maps
+<emphasis remap='I'>s'</emphasis>
+to
+<emphasis remap='I'>s;</emphasis>
+for instance,
+<emphasis remap='I'>T*</emphasis>
+will take an endpoint of
+<emphasis remap='I'>s'</emphasis>
+to the corresponding endpoint of
+<emphasis remap='I'>s,</emphasis>
+and will preserve the relationship of every other point
+to the line segment.
+We apply this inverse
+<emphasis remap='I'>T*</emphasis>
+to the coordinates
+<emphasis remap='I'>(x,y)</emphasis>
+to find an appropriate pixel in the original image.
+Along with this, we compute a weight based on the length of the line segment
+<emphasis remap='I'>s</emphasis>
+along with its distance from
+<emphasis remap='I'>(x,y).</emphasis>
+This weight is equal to
+<!-- .br -->
+       ( (length ** p) / (a + dist) ) ** b
+<!-- .br -->
+(where
+<emphasis remap='I'>**</emphasis>
+denotes exponentiation,
+<emphasis remap='I'>length</emphasis>
+is the length of
+<emphasis remap='I'>s,</emphasis>
+<emphasis remap='I'>dist</emphasis>
+is the distance from
+<emphasis remap='I'>s</emphasis>
+to
+<emphasis remap='I'>(x,y), and</emphasis>
+<emphasis remap='I'>a, b, p</emphasis>
+are constants chosen by the user and stored in the lines file.)</para>
+
+<para>The set
+<emphasis remap='I'>A</emphasis>
+of pixels is then collected by performing these computations for each
+line segment, and the resulting contribution
+<emphasis remap='I'>cA</emphasis>
+is then computed by averaging over
+<emphasis remap='I'>A</emphasis>
+with the appropriate weights.</para>
+
+<!-- .br -->
+<para>In practice,
+<emphasis remap='I'>a</emphasis>
+= 0.1,
+<emphasis remap='I'>b</emphasis>
+= 2.0, and
+<emphasis remap='I'>p</emphasis>
+= 0.2 seems to work well.</para>
+
+<!-- .br -->
+<para>In general, the user will wish to set
+<emphasis remap='I'>warpfrac</emphasis>
+=
+<emphasis remap='I'>dissolvefrac.</emphasis>
+Typically, a morph animation will be produced by computing a sequence
+of images using
+<emphasis remap='I'>pixmorph,</emphasis>
+each with slightly greater
+<emphasis remap='I'>warpfrac</emphasis>
+(and
+<emphasis remap='I'>dissolvefrac)</emphasis>
+(see the example.)
+<!-- .br -->
+For a clearer and more thorough explanation, see
+<!-- .br -->
+ T. Beier and S. Neely.
+ Feature-Based Image Metamorphosis.
+ "SIGGRAPH 1992 Computer Graphics Proceedings (volume 26 number 2)"
+ (Chicago, July 26-31, 1992). pp 35-42.
+<!-- .br -->
+which presents the algorithm used by
+<emphasis remap='I'>pixmorph.</emphasis></para>
+
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-w</option><replaceable> WIDTH</replaceable></term>
+  <listitem>
+<para>Tells
+<command>pixmorph</command>
+that the input images have width WIDTH.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-n</option><replaceable> HEIGHT</replaceable></term>
+  <listitem>
+<para>Tells
+<command>pixmorph</command>
+that the input images have height HEIGHT.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>      pixmorph face1.pix face2.pix lf 0.0 0.0 &gt; frame0.pix
+      pixmorph face1.pix face2.pix lf 0.2 0.2 &gt; frame1.pix
+      pixmorph face1.pix face2.pix lf 0.4 0.4 &gt; frame2.pix
+      pixmorph face1.pix face2.pix lf 0.6 0.6 &gt; frame3.pix
+      pixmorph face1.pix face2.pix lf 0.8 0.8 &gt; frame4.pix
+      pixmorph face1.pix face2.pix lf 1.0 1.0 &gt; frame5.pix</para>
+
+<!-- .br -->
+<para>Note that the example above will result in
+<emphasis remap='I'>frame0.pix</emphasis>
+=
+<emphasis remap='I'>face1.pix</emphasis>
+and
+<emphasis remap='I'>frame5.pix</emphasis>
+=
+<emphasis remap='I'>face2.pix.</emphasis></para>
+
+<!-- .br -->
+<para>      pixmorph face1.pix face2.pix lf 0.5 0.0 &gt; out.pix</para>
+
+<!-- .br -->
+<para>Note that in this example,
+<emphasis remap='I'>dissolvefrac</emphasis>
+= 0.
+This will warp
+<emphasis remap='I'>face1.pix</emphasis>
+and
+<emphasis remap='I'>face2.pix</emphasis>
+by the appropriate amount, but will ignore the contributions of
+<emphasis remap='I'>face2.pix</emphasis>
+at the cross-dissolve stage.
+So the final image
+<emphasis remap='I'>out.pix</emphasis>
+will consist entirely of values from
+<emphasis remap='I'>face1.pix</emphasis>
+warped 50% according to the linesfile
+<emphasis remap='I'>lf.</emphasis></para>
+
+<!-- .br -->
+<para>      pixmorph face1.pix face2.pix lf 0.0 0.5 &gt; out.pix</para>
+
+<!-- .br -->
+<para>In this example,
+<emphasis remap='I'>warpfrac</emphasis>
+= 0.
+This will perform a simple 50% cross-dissolve between
+<emphasis remap='I'>face1.pix</emphasis>
+and
+<emphasis remap='I'>face2.pix.</emphasis></para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>morphedit</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1996-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixrect.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixrect.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixrect.xml	(working copy)
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixrect1'>
+<refmeta>
+<refentrytitle>PIXRECT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixrect</refname>
+<refpurpose>extract a rectangle from a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixrect</command>    
+    <arg choice='opt'>-#bytes </arg>
+    <arg choice='plain'><replaceable>infile</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixrect</emphasis>
+extracts a rectangular region from a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+The program prompts for the area to extract in x and y pixels,
+the scanline length of the input file in pixels, and the origin
+in the input file from which to extract.  First quadrant coordinates
+and file storage formats are used.</para>
+
+<para>By default pixels of size three bytes are assumed as in the
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.  However, the
+<option>-#</option><replaceable>bytes</replaceable>
+flag can be used to specify some other pixel size, where
+<emphasis remap='I'>bytes</emphasis>
+is the number of bytes per pixel.  Thus this program
+can be used to extract rectangles of other data types, such as
+an array of floats, etc.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixrot.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixrot.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixrot.xml	(working copy)
@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixrot1'>
+<refmeta>
+<refentrytitle>PIXROT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixrot</refname>
+<refpurpose>rotate, invert, or reverse a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixrot</command>    
+    <arg choice='opt'>-#bytes </arg>
+    <arg choice='opt'>-rifb </arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>newfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixrot</emphasis>
+will rotate, invert, or reverse a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file or read from standard input if a file name is not given.  The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to same same value via
+<option>-s.</option></para>
+
+<para>The
+<option>-r</option>
+flag reverses the scan lines left to right.
+<!-- .br -->
+The
+<option>-i</option>
+flag inverts the image top to bottom.
+<!-- .br -->
+The
+<option>-f</option>
+and
+<option>-b</option>
+flag will rotate the image ninety degrees forward or backward respectively.
+The sense of the rotation is relative to a first quadrant coordinate
+system, i.e. origin lower left, where "forward" means clockwise.</para>
+
+<para>Note that a 180 degree rotation can be obtained by both reversing
+and inverting.</para>
+
+<para>By default three byte pixels are assumed as in the
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.  However, the
+<option>-#</option><replaceable>bytes</replaceable>
+flag can be used to specify some other pixel size, where
+<emphasis remap='I'>bytes</emphasis>
+is the number of bytes per pixel.  Thus this program
+can be used to manipulate rectangles of other data types, such as
+an array of floating point numbers, files of text, etc.</para>
+</refsect1>
+
+<refsect1 xml:id='method'><title>METHOD</title>
+<para>A fairly large buffer is kept in memory so that, file size permitting,
+the entire rotation can occur without seeking on input or output.
+In any event, the algorithm is designed to process the input sequentially,
+so that if any seeking is required, it will happen on output only.  If
+these seeks fail, e.g. the output is a pipe, the user will be told that
+it needs a file on output.
+A more general solution to this problem would be to see if seeks can
+be done on input instead, and switch the algorithm to seek on input
+only.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>If the file size is very large, excessive seeking may occur on output
+and the rotation will take a very long time.  More complicated
+algorithms could remedy this.
+<!-- .br -->
+Rotations of arbitrary angle are not supported.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixsaturate.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixsaturate.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixsaturate.xml	(working copy)
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixsaturate1'>
+<refmeta>
+<refentrytitle>PIXSATURATE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixsaturate</refname>
+<refpurpose>saturate a pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixsaturate</command>    
+    <arg choice='plain'><replaceable>saturation</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pixsaturate</command>
+saturates a color pix file using the
+<emphasis remap='B'>saturation</emphasis>
+value.  A value of 0 gives monochrome, 1.0 gives the original image,
+and values larger than 1.0 give a more saturated image.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixfade</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixscale.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixscale.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixscale.xml	(working copy)
@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixscale1'>
+<refmeta>
+<refentrytitle>PIXSCALE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixscale</refname>
+<refpurpose>change the size of a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixscale</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-r </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixscale</emphasis>
+will take a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and produce a larger or smaller
+scaled version.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+Similarly, the
+<option>-W</option>
+and
+<option>-N</option>
+flags specify the desired output file width and number of scan lines in
+pixels.  They can both be set to the same value via
+<option>-S.</option>
+Defaults of 512 are assumed for any unspecified dimensions.</para>
+
+<para>The algorithm used is bilinear interpolation if scaling up, and
+a box filter of arbitrary size if scaling down.  For the box filter a
+"square pixel" assumption is made; that is, all whole and fractional
+input pixels falling into a rectangle the size of an output pixel contribute
+equally according to the fraction of the output pixel area they cover.
+When interpolating, the edge pixels are preserved, i.e. all of the
+interpolated pixels fall inside of the edges.  This can be a bit surprising
+when say doubling the size of a file as only the edge pixels will fall
+at exactly the location of an output pixel.</para>
+
+<para>Specifying the
+<option>-r</option>
+flag changes from bilinear interpolation to
+nearest neighbor interpolation, i.e. it enlarges the image by
+pixel replication.</para>
+
+<para>For 2X interpolation, a much faster alternative is
+<citerefentry><refentrytitle>pixinterp2x</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+<para>The
+<option>-h</option>
+flag causes the frame buffer to be
+used in high resolution mode (1024x1024).
+This is important for frame buffers such as the Adage which operate
+differently depending on the display size.  Without this flag
+the default size for the selected device will be used (usually
+the entire screen).</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixinterp2x</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This program cannot scale up in one dimension and down in the other
+at the same time.
+<!-- .br -->
+The box filter used for scaling down results in the usual high-frequency
+ripple.
+<!-- .br -->
+Optional cubic interpolation would be nice.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixshrink.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixshrink.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixshrink.xml	(working copy)
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixshrink1'>
+<refmeta>
+<refentrytitle>PIXSHRINK</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixshrink</refname>
+<refpurpose>shrink a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixshrink</command>    
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>shrink_factor</replaceable></arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-u </arg>
+    <arg choice='opt'><replaceable>infile.pix</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>outfile.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixshrink</emphasis>
+will take a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file of given dimensions and produce a smaller
+scaled version.
+The
+<option>-w</option>
+and
+<option>-n</option>
+flags specify the input file width and number of scan lines in pixels.
+They can both be set to the same value via
+<option>-s.</option>
+Defaults of 512 are assumed for unspecified dimensions.
+The integer scaling factor is set with the
+<option>-w</option>
+flag.  By default, the factor is 2.  Thus, pixshrink forms the logical
+opposite of the
+<emphasis remap='B'>pixinterp2x (1)</emphasis>
+program.</para>
+
+<para>The program reads the entire image into memory,
+and then scales the image down by
+to 1/factor the original size in both dimensions.</para>
+
+
+<para>By default, pixshrink uses boxcar averaging to produce the output pixels from
+the input.  The
+<option>-u</option>
+option causes pixshrink to use image undersampling instead.</para>
+
+<para>The
+<option>-h</option>
+flag causes the frame buffer to be
+used in high resolution mode (1024x1024).
+This is important for frame buffers such as the Adage which operate
+differently depending on the display size.  Without this flag
+the default size for the selected device will be used (usually
+the entire screen).</para>
+
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixcrop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixinterp2x</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>If the dimensions of the input image are not evenly divisible by the shrink
+factor, incorrect and bizarre output is generated.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1990-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixstat.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixstat.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixstat.xml	(working copy)
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixstat1'>
+<refmeta>
+<refentrytitle>PIXSTAT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixstat</refname>
+<refpurpose>list statistics related to a color pix image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixstat</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixstat</emphasis>
+will take the given
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file,
+or read from standard in.  A collection of statistics
+related to the pixel intensities is produced for each color
+plane (red, green, and blue).
+<!-- .br -->
+These include:
+<!-- .br -->
+The number of pixels (and the square root of this which is the
+file dimensions if square).
+<!-- .br -->
+The max and min values.
+<!-- .br -->
+The mean.
+<!-- .br -->
+The median (dividing line where half the pixels are above this
+value, half below).
+<!-- .br -->
+The mode (most frequently occurring value) and
+the number of pixels at this value.
+<!-- .br -->
+The variance, standard deviation, and skew.</para>
+
+<para>The
+<option>-v</option>
+flag will also dump a histogram of the pixel values.</para>
+</refsect1>
+
+<refsect1 xml:id='method'><title>METHOD</title>
+<para>Since the pixel values are quantized (each color having discrete values
+from 0 to 255), the statistics can be computed from "lump sums" after
+building a histogram of the input.  This results in a fantastic
+savings in computation while also making a single pass over the input
+file sufficient.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixhist</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bwstat</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixsubst.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixsubst.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixsubst.xml	(working copy)
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixsubst1'>
+<refmeta>
+<refentrytitle>PIXSUBST</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixsubst</refname>
+<refpurpose>Change color values used in a PIX(5) format image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixsubst</command>    
+    <arg choice='opt'><arg choice='plain'><replaceable>R_in</replaceable></arg><arg choice='plain'><replaceable>G_in</replaceable></arg><arg choice='plain'><replaceable>B_in</replaceable></arg></arg>
+    <arg choice='plain'><replaceable>R_out</replaceable></arg>
+    <arg choice='plain'><replaceable>G_out</replaceable></arg>
+    <arg choice='plain'><replaceable>B_out</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>pixfile_in</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>pixfile_out</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixsubst</emphasis>
+reads
+<emphasis remap='I'>pix(5)</emphasis>
+format pixels on the standard input and converts all pixels matching
+the {R_in G_in B_in} to {R_out G_out B_out}. The pixels values are
+specified as integers from 0 to 255. If {R_in G_in B_in} is not specified,
+the first pixel in the input stream is used as the value to be changed.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1999-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixtile.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixtile.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixtile.xml	(working copy)
@@ -0,0 +1,246 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixtile1'>
+<refmeta>
+<refentrytitle>PIXTILE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixtile</refname>
+<refpurpose>paste small images together into one large image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixtile</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>startframe</replaceable></arg>
+    <arg choice='plain'><replaceable>basename</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>pixtile</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>file_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>file_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='plain'><replaceable>file1</replaceable></arg>
+    <arg choice='plain' rep='repeat'><replaceable>file2</replaceable></arg>
+    <arg choice='plain'><replaceable>fileN</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixtile</emphasis>
+takes a collection of numbered small images and places them side
+by side in one larger image.  The input and output files are
+assumed to be in
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.
+By default, the output file will be made 512x512 pixels in size.
+Specifying the
+<option>-h</option>
+flag, changes the default size to 1024x1024 pixels.</para>
+
+<para>The input files have a default width of 64 pixels per scanline
+and are usually square, i.e. have the same height as width.
+Specifying the
+<option>-s</option>
+flag, changes the default size to
+<emphasis remap='I'>squareinsize</emphasis>
+pixels per scanline and
+<emphasis remap='I'>squareinsize</emphasis>
+scanlines as given in the argument list.
+The
+<option>-w</option>
+flag can be used to specify the input file width in pixels and the
+<option>-n</option>
+flag can be used to specify the input file height in scanlines.</para>
+
+<para>If the
+<option>-S</option>
+flag is supplied, the output
+size is changed from the default value of 512 to
+<emphasis remap='I'>squareoutsize</emphasis>
+pixels per scanline and
+<emphasis remap='I'>squareoutsize</emphasis>
+scanlines.
+The
+<option>-W</option>
+flag sets the output width size to
+<emphasis remap='I'>out_width</emphasis>
+pixels per scanline.
+Similarly, the
+<option>-N</option>
+flag sets the output height size to
+<emphasis remap='I'>out_height</emphasis>
+scanlines.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>"hires" flag.
+Set both the height and width of the output to 1024.
+The default is 512x512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s </option><replaceable>squareinsize</replaceable></term>
+  <listitem>
+<para>Specify both the number of pixels per scanline and the number of
+scanlines in the input files.  The default is 64.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w </option><replaceable>file_width</replaceable></term>
+  <listitem>
+<para>Specify the width (in pixels) per scanline of the input file.
+The default is 64.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n </option><replaceable>file_height</replaceable></term>
+  <listitem>
+<para>Specify the number of scanlines to be read from the input file.
+The default is 64.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S </option><replaceable>squareoutsize</replaceable></term>
+  <listitem>
+<para>Specify both the number of pixels per scanline (width) and the number of
+scanlines (height) for the output file.  The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W </option><replaceable>out_width</replaceable></term>
+  <listitem>
+<para>Specify the width (in pixels) per scanline of the output file.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-N </option><replaceable>out_height</replaceable></term>
+  <listitem>
+<para>Specify the number of scanlines to be sent to the output file.
+The default is 512.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o </option><replaceable>startframe</replaceable></term>
+  <listitem>
+<para>Specify the starting frame number, where
+<emphasis remap='I'>startframe</emphasis>
+is substituted for
+<emphasis remap='I'>num</emphasis>
+in
+<emphasis remap='I'>basename.num</emphasis></para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>The files being pasted together should have names of the form
+<emphasis remap='I'>basename.num</emphasis>,
+where
+<emphasis remap='I'>basename</emphasis>
+is given on the command line, and
+<emphasis remap='I'>num</emphasis>
+is a consecutive series of integers.  By default the first image
+is assumed to be number " 0 ", but an alternate
+<emphasis remap='I'>startframe</emphasis>
+can be given by using the
+<option>-o</option>
+flag and supplying
+<emphasis remap='I'>startframe</emphasis>.
+The program keeps reading these small files until either the next
+frame does not exist, or the output file is full.
+They are placed in the output file from lower left to upper right.
+The progress
+of the composition is displayed on standard error.</para>
+
+<para>If the basename is given as "-" (a minus sign),
+preceded by a "--" (two minus signs) to terminate
+<citerefentry><refentrytitle>bu_getopt</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+processing,
+then the stream of images is read from stdin rather than a file, such as
+might be generated by a program like
+<citerefentry><refentrytitle>pcd-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Such a stream could also be processed into files by
+<citerefentry><refentrytitle>pixbustup</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+<para>Alternatively, if more than one
+<emphasis remap='I'>basename</emphasis>
+(filename) argument is supplied on the command line,
+the names of the files being pasted together are assumed
+to be explicitly stated and the
+<option>-o</option>
+flag is not valid.  This allows files with different names to be
+used without having to change the name of the files.</para>
+
+<para>This program is the companion of
+<citerefentry><refentrytitle>fbanim</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+which will step through these small images on a framebuffer capable
+of zooming and windowing.  Thus many small low resolution frames can
+be used as an animation "preview" for a higher resolution sequence,
+the latter of which would go onto video tape or film.</para>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para><userinput>pixtile -h -s 128 -o 2 anim &gt; out.pix</userinput>
+<!-- .br -->
+will read files
+<emphasis remap='I'>anim.2</emphasis>
+through
+<emphasis remap='I'>anim.65</emphasis>
+placing them from lower left to upper right in a 1024x1024 pixel
+file
+<emphasis remap='I'>out.pix</emphasis>.</para>
+
+<para><userinput>pixtile -s 256 lowerleft lowerright upperleft upperright &gt; out.pix</userinput>
+<!-- .br -->
+will read files
+<emphasis remap='I'>lowerleft</emphasis>,
+<emphasis remap='I'>lowerright</emphasis>,
+<emphasis remap='I'>upperleft</emphasis>,
+and
+<emphasis remap='I'>upperright</emphasis>
+placing them from lower left to upper right in a 512x512 file
+<emphasis remap='I'>out.pix</emphasis>.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbanim</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pixuntile.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixuntile.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixuntile.xml	(working copy)
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pixuntile1'>
+<refmeta>
+<refentrytitle>PIXUNTILE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixuntile</refname>
+<refpurpose>break small images up into separate files</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pixuntile</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>startframe</replaceable></arg>
+    <arg choice='plain'><replaceable>basename</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>pixuntile</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>squareinsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>in_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>in_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='plain'><replaceable>file1</replaceable></arg>
+    <arg choice='plain' rep='repeat'><replaceable>file2</replaceable></arg>
+    <arg choice='plain'><replaceable>fileN</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pixuntile</emphasis>
+performs the inverse operation of
+<citerefentry><refentrytitle>pixtile</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+It takes a large image composed of a collection of small images and
+places each of them in a separate file.
+The input and output files are
+assumed to be in
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format.
+By default, the input file is assumed to be 512x512 pixels in size.
+Specifying the
+<option>-h</option>
+flag, changes the default input size to 1024x1024 pixels.</para>
+
+<para>The output files have a default width of 64 pixels
+and are usually square, i.e. have the same height as width.
+Specifying the
+<option>-S</option>
+flag, changes the default size to
+<emphasis remap='I'>squareoutsize</emphasis>
+pixels in width and height.</para>
+
+<para>The files being produces as output will have names of the form
+<emphasis remap='I'>basename.num</emphasis>,
+where
+<emphasis remap='I'>basename</emphasis>
+is given on the command line, and
+<emphasis remap='I'>num</emphasis>
+is a consecutive series of integers.  By default the first image
+is assumed to be number " 0 ", but an alternate
+<emphasis remap='I'>startframe</emphasis>
+can be given by using the
+<option>-o </option><replaceable>startframe</replaceable>
+flag and specifying the starting output frame number, where
+<emphasis remap='I'>startframe</emphasis>
+is substituted for
+<emphasis remap='I'>num</emphasis>
+in
+<emphasis remap='I'>basename.num</emphasis></para>
+
+<para>Alternatively, if more than one
+<emphasis remap='I'>basename</emphasis>
+(filename) argument is supplied on the command line,
+the names of the files are used as the output file names.</para>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<para><userinput>pixuntile -h -S 128 out &lt; in.pix</userinput>
+<!-- .br -->
+will read the 1024x1024 file
+<emphasis remap='I'>in.pix</emphasis>
+and place the 128x128 chucks of that file from
+lower left to upper right in the files
+<emphasis remap='I'>out.0</emphasis>
+through
+<emphasis remap='I'>out.15</emphasis>.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pixtile</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-X.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-X.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-X.xml	(working copy)
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plx1'>
+<refmeta>
+<refentrytitle>PL-X</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-X</refname>
+<refpurpose>display UnixPlot in an X Window (X11)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-X</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pl-X</emphasis>
+displays an extended UnixPlot file on any workstation running the
+X Window System (X11R2).  As with all X programs, the selected
+display is determined from the
+<!-- B elided -->
+<acronym>DISPLAY</acronym>
+environment variable.</para>
+
+<para>The
+<option>-v</option>
+verbose option causes descriptions of the plot commands to be
+printed.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This is just the bare bones of a display program at the time
+of this writing.  It needs the ability to rotate, translate, zoom, etc.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para>pl-X<citerefentry><refentrytitle>10</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-sgi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-asc.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-asc.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-asc.xml	(working copy)
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plasc1'>
+<refmeta>
+<refentrytitle>PL-ASC</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-asc</refname>
+<refpurpose>convert a Plot3 stream to ASCII</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-asc</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Reads a stream in
+<citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format and converts it to an ASCII representation.
+Standard input is read if a file name is not supplied.
+If the
+<option>-v</option>
+option is given,
+the single-character command names
+are replaced with mnemonic strings
+and a summary of plot command usage is written to standard error.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>asc-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-hpgl.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-hpgl.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-hpgl.xml	(working copy)
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plhpgl1'>
+<refmeta>
+<refentrytitle>PL-HPGL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-hpgl</refname>
+<refpurpose>convert a Unix Plot file to HPGL commands</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-hpgl</command>    
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>hpgl_cmds</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Reads a Unix Plot file from standard input and
+converts it to of HPGL commands which are written to standard output.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-starbase</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Mark Huston Bowden</para>
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-pl.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-pl.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-pl.xml	(working copy)
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plpl1'>
+<refmeta>
+<refentrytitle>PL-PL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-pl</refname>
+<refpurpose>convert an extended to a simple UnixPlot file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-pl</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-S </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>UnixPlot is a simple machine and device independent plotting file
+format found on both System V and BSD Unix systems.  BRL has extended
+that format to include color, three dimensional plotting, machine
+independent floating point coordinates, and a flush command for
+interactive output.</para>
+
+<para><emphasis remap='I'>Pl-pl</emphasis>
+converts an extended UnixPlot file to the simpler format for
+use by older, and non-extended, programs.  It drops color and
+flush commands, strips the Z coordinate of 3D commands, and
+converts floating point coordinates to integer.  By default to
+integer conversion is done by simple truncation.  If the
+<option>-S</option>
+option is given, the "space" command in the plot file is used to
+center and scale the plot to the full 16 bit signed integer plotting
+space (-32767 to +32767).  This is particularly useful for converting
+floating point files.  The
+<option>-v</option>
+verbose option causes each plot command to be described as it is being
+converted.</para>
+</refsect1>
+
+<refsect1 xml:id='diagnostics'><title>DIAGNOSTICS</title>
+<para>A warning message is given if the input plot file did not contain
+a space command since most older UnixPlot programs require them.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>plot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pldebug</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-ps.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-ps.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-ps.xml	(working copy)
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plps1'>
+<refmeta>
+<refentrytitle>PL-PS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-ps</refname>
+<refpurpose>convert UnixPlot to PostScript file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-ps</command>    
+    <arg choice='opt'>-ec </arg>
+    <arg choice='opt'>-s <replaceable>square_output_size</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>output_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>output_height</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pl-ps</emphasis>
+converts an extended UnixPlot file to a PostScript file
+suitable for embedding in a larger PostScript document.
+This is especially useful for creating figures for inclusion in TeX
+documents.
+The
+<option>-e</option>
+option will produce and encapsulated PostScript file. The
+<option>-s</option>
+,
+<option>-w</option>
+, and
+<option>-n</option>
+options specify the size of the output image in inches (ignored when used with the
+<option>-e</option>
+option).</para>
+
+<para>All UnixPlot line types are supported.</para>
+
+<para>If no UnixPlot
+<emphasis remap='B'>space</emphasis>
+directive is seen, the default space ranges from
+(0, 0, 0) to (4096, 4096, 4096).</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>This is just the bare bones of a program at the time
+of this writing.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-sgi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, pl-X(1), <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='trademarks'><title>TRADEMARKS</title>
+<para>PostScript is a trademark of Adobe Systems Incorporated.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pl-tek.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-tek.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-tek.xml	(working copy)
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pltek1'>
+<refmeta>
+<refentrytitle>PL-TEK</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl-tek</refname>
+<refpurpose>convert UnixPlot to Tektronix 4014 command stream</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pl-tek</command>    
+    <arg choice='opt'>-e </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pl</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>&gt;</replaceable></arg><arg choice='plain'><replaceable>file.tek</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><command>pl-tek</command>
+converts an extended UnixPlot file to a Tektronix 4014 command stream
+suitable for viewing on a Tektronix display,
+or a Tektronix-compatible emulator.
+The (binary) Tektronix command stream is written to stdout.</para>
+
+<para>The
+<option>-e</option>
+option expands the drawing area on the Tektronix to the full 4096x4096,
+which is more than a real Tektronix can display.
+It it not known if this feature is useful.</para>
+
+<para>The
+<option>-v</option>
+option turns on <emphasis remap='I'>verbose</emphasis> mode, and each command is logged to stderr.
+Occasionally useful for debugging Tektronix emulator problems,
+but is very verbose.</para>
+
+<para>To send a Unix-plot to an Imagen printer, this command can be used:</para>
+
+<literallayout remap='.nf'>
+pl-tek &lt; file.pl | ipr -Ltektronix -q im101
+</literallayout> <!-- .fi -->
+
+
+<para>All UnixPlot line types are supported.</para>
+
+<para>If no UnixPlot
+<emphasis remap='B'>space</emphasis>
+directive is seen, the default space ranges from
+(-32767, -32767) to (32767, 32767).</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>Circle and arc directives are not supported.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pldebug</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-ps</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-sgi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, pl-X(1), <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/plcolor.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/plcolor.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/plcolor.xml	(working copy)
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plcolor1'>
+<refmeta>
+<refentrytitle>PLCOLOR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>plcolor</refname>
+<refpurpose>output a UnixPlot color command</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>color</command>    
+    <arg choice='plain'><replaceable>r</replaceable></arg>
+    <arg choice='plain'><replaceable>g</replaceable></arg>
+    <arg choice='plain'><replaceable>b</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>&lt;</replaceable></arg><arg choice='plain'><replaceable>unix_plot</replaceable></arg></arg>
+</cmdsynopsis>
+<para>&gt; unix_plot.</para>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Plcolor</emphasis>
+outputs a UnixPlot command to set the current drawing color to
+the given
+<emphasis remap='I'>r g</emphasis>
+and
+<emphasis remap='I'>b</emphasis>
+values.  These values should be numbers from 0 to 255 and represent
+black to full up Red, Green, and Blue values respectively.</para>
+
+<para>To allow this command to be used in pipelines, an optional input file
+can be given.  All of the input will be passed through until end of
+file, and then the color command will be appended to the end.</para>
+
+<para>This command exists mostly as an aid for making graphs and things
+from shell commands.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>plline2</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/pldebug.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pldebug.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/pldebug.xml	(working copy)
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pldebug1'>
+<refmeta>
+<refentrytitle>PLDEBUG</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pldebug</refname>
+<refpurpose>output a UnixPlot stream in ascii</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>pldebug</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>Outputs a UnixPlot (see
+<citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
+stream in ascii for debugging.  If the
+<option>-v</option>
+option is given, a summary of plot command usage is given at the
+end of the file.  Standard input is read if a file name is not supplied.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/plgetframe.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/plgetframe.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/plgetframe.xml	(working copy)
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plgetframe1'>
+<refmeta>
+<refentrytitle>PLGETFRAME</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>plgetframe</refname>
+<refpurpose>extract one frame from a UNIX plot file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>plgetframe</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>desired_frame</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Plgetframe</emphasis>
+extracts a single frame from a multi-frame UNIX plot file.
+Frames are separated by UNIX plot "erase" commands.
+Specifying the
+<option>-v</option>
+(verbose) flag causes the number of each frame being skipped to
+be printed on stderr.</para>
+
+<para>Note that BRL 3-D UNIX plot is a superset of the standard UNIX plot
+format, thus this program can process normal plot files as well.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/plline2.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/plline2.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/plline2.xml	(working copy)
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plline21'>
+<refmeta>
+<refentrytitle>PLLINE2</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>plline2</refname>
+<refpurpose>output a 2D UnixPlot line</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>plline2</command>    <arg choice='plain'><replaceable>x1</replaceable></arg>
+    <arg choice='plain'><replaceable>y1</replaceable></arg>
+    <arg choice='plain'><replaceable>x2</replaceable></arg>
+    <arg choice='plain'><replaceable>y2</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>r</replaceable></arg><arg choice='plain'><replaceable>g</replaceable></arg><arg choice='plain'><replaceable>b</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>&lt;</replaceable></arg><arg choice='plain'><replaceable>unix_plot</replaceable></arg></arg>
+</cmdsynopsis>
+<para>&gt; unix_plot.</para>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Plline2</emphasis>
+outputs a UnixPlot command to draw a line in the XY plane from
+the point
+(<emphasis remap='B'>x1 y1</emphasis>)
+to the point
+(<emphasis remap='B'>x2 y2</emphasis>).
+These points can be floating point and the output is always written
+as a floating point plotting command.  If you need an integer command
+then feed the output of this through
+<citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+If an optional
+[<emphasis remap='I'>r g b</emphasis>]
+is given, where
+<emphasis remap='I'>r, g,</emphasis>
+and
+<emphasis remap='I'>b</emphasis>
+are values from 0 to 255 representing Red, Green, and Blue color values,
+the line will be drawn in that color.  Otherwise the current drawing
+color (white by default) is used.</para>
+
+<para>To allow this command to be used in pipelines, an optional input file
+can be given.  All of the input will be passed through until end of
+file, and then the line will be appended to the end.</para>
+
+<para>This command exists mostly as an aid for making graphs and things
+from shell commands.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>plcolor</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot3</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/plrot.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/plrot.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/plrot.xml	(working copy)
@@ -0,0 +1,179 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='plrot1'>
+<refmeta>
+<refentrytitle>PLROT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>plrot</refname>
+<refpurpose>rotate, translate, or scale a UnixPlot file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>plrot</command>    
+    <arg choice='opt'><arg choice='plain'>-x# </arg><arg choice='plain'>-y# </arg><arg choice='plain'>-z# </arg></arg>
+    <arg choice='opt'><arg choice='plain'>-X# </arg><arg choice='plain'>-Y# </arg><arg choice='plain'>-Z# </arg></arg>
+    <arg choice='opt'>-s# </arg>
+    <arg choice='opt'><arg choice='plain'>-a# </arg><arg choice='plain'>-e# </arg></arg>
+    <arg choice='opt'>-g# </arg>
+    <arg choice='opt'>-M </arg>
+    <arg choice='opt'>-m# </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-S# </arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>unix_plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Plrot</emphasis>
+will rotate translate or scale a UnixPlot file (see
+<citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry>).
+Any number of the above options can be given.
+Each operation is performed left to right in the order in which they appear
+on the command line,
+and the operations are concatenated.
+It is important to note that rotations are not commutative,
+so the order they are specified in is important.
+Typing the command without any arguments
+gives a useful summary.</para>
+
+<para>The lower case
+<option>-x# -y# -z#</option>
+flags perform a rotation about the X, Y, and Z axis respectively by
+the given number of degrees.  A positive value indicates a right handed
+rotation.  Upper case
+<option>-X# -Y# -Z#</option>
+are translations along these axis in whatever units the plot file is in.
+The
+<option>-s#</option>
+flag applies a scale factor up (&gt; 1) or down (&lt; 1) to the plot.</para>
+
+<para>The
+<option>-a# -e#</option>
+flags are for azimuth and elevation about the center point.
+They are really shorthands for positive Z axis and negative X axis
+rotations respectively, and should be used in the order shown for
+the proper combined effect to occur.  These flags also cause
+the plot to auto-center based on the "space" command
+in the plot file, and the new "space" command will be shrunk to
+fit the rotated plot as tightly as possible.</para>
+
+<para>The
+<option>-M</option>
+flag causes
+the plot to auto-center based on the "space" command
+in the plot file in much the same way that the
+<citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ray tracer does to a model bounding box.  I.e. a sphere is fit to
+this space and the diameter and center of this sphere are used as
+the center and width of the plot in all three dimensions.  This has
+the advantage of keeping the entire model in view from any angle,
+and is invariant with respect to viewing direction.
+It has the disadvantage that the "space" will be enlarged on every
+cascaded pass through
+<citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+where the
+<option>-M</option>
+flag is used.</para>
+
+<para>The
+<option>-S#</option>
+flags takes a quoted string of 6 floating point numbers,
+which are immediately output as a "space" command,
+and which override any "space" commands found in the input file
+or which are computed by</para>
+
+<para>The
+<option>-v</option>
+flag signals that verbose mode is requested.
+When set, the initial transformation
+matrix is printed.
+In addition, every time a <emphasis remap='I'>space</emphasis> command is encountered in the
+input file, the old and new bounding RPP is printed.</para>
+
+<para>The
+<option>-m#</option>
+flag takes a quoted string of 16 floating point numbers as its parameter.
+This string is a 4x4 rotation matrix (see h/vmath.h for details).
+Note that when using this flag, do not use
+<option>-a#, -e#,</option>
+or
+<option>-g.</option></para>
+
+<para>UnixPlot is traditionally a first quadrant 2D plotting space with
+X increasing to the right of the plot, and Y increasing up the plot.
+The "front" of a solid model in the BRL-CAD Package is traditionally
+defined by the right handed system of X coming out of the screen
+toward you, Y increasing to the right, and Z increasing up the display
+(elevation above the XY ground plane).  The
+<option>-g</option>
+flag is a convenient shorthand to transform azimuths and elevations
+described in <emphasis remap='B'>gift</emphasis> notation (as degrees off the front or -X view)
+into the UnixPlot coordinate system for display.
+If used, this option should usually
+appear as the last argument, because it acts by modifying the rotation already
+established.
+The
+<option>-g</option>
+command has exactly the same effect as giving
+<option>-z-90 -x-90</option>
+in the same place.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The command</para>
+
+<literallayout remap='.nf'>
+plrot -z30 -x20 &lt; file.plot &gt; file2.plot
+</literallayout> <!-- .fi -->
+
+<para>performs a 30 degree positive rotation about the Z axis (counter
+clockwise as viewed from the top), and then translates by 20
+units
+<emphasis remap='B'>along this rotated axis.</emphasis>
+If the order of these arguments was reversed the effect would not
+be the same.</para>
+
+<para>To view a plot of a model the way one would see it from a
+ray trace command, you could use:</para>
+
+<literallayout remap='.nf'>
+rthide -a35 -e25 -o file.plot
+
+plrot -a35 -e25 -g &lt; file.plot | pl-fb
+</literallayout> <!-- .fi -->
+
+<para>The final
+<option>-g</option>
+converts the <emphasis remap='B'>gift</emphasis> style azimuth and elevations into the
+conventional UnixPlot (screen) X,Y coordinate system.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-pl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pldebug</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>plot</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1988-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/png-bw.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/png-bw.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/png-bw.xml	(working copy)
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pngbw1'>
+<refmeta>
+<refentrytitle>PNG-BW</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>png-bw</refname>
+<refpurpose>convert a Portable Networks Graphics (PNG) format file to a BW format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>png-bw</command>    
+    <arg choice='opt'>-ntsc </arg>
+    <arg choice='opt'>-crt </arg>
+    <arg choice='opt'><arg choice='plain'>-R </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-G </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-B </arg><arg choice='opt'><replaceable>num</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>in.png</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>out.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pix-bw</emphasis>
+will convert a
+<emphasis remap='I'>PNG</emphasis>
+format
+file from its standard input
+and produce a black and white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file on its standard output, If the PNG file contains a B/W image the conversion is direct, however, if the PNG file contains a color image, then
+by default all three colors are weighted equally.  The
+<option>-ntsc</option>
+uses weighting based on the NTSC primaries and the D6500
+alignment white.  The
+<option>-crt</option>
+flag applies weights for "typical" CRT phosphor chromaticities
+and the D6500 white.</para>
+
+<para>Individual color plane(s) can be selected via the
+<option>-R -G</option>
+and
+<option>-B</option>
+flags.
+If one or more of these flags is followed by a value,
+the value will be treated as a weight
+to be applied to that color
+This value is implicitly 1.0 divided by
+the number of colors selected for the flags which are not followed
+by a value.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para><emphasis remap='I'>png-bw -R -B &lt; file.png &gt; file.bw</emphasis>
+<!-- .br -->
+will equally blend the red and blue color planes.</para>
+
+<para><emphasis remap='I'>png-bw bw_file.png &lt; file.bw</emphasis>
+will convert a b/w PNG file to
+<emphasis remap='I'>bw(5)</emphasis>
+format.</para>
+
+<para><emphasis remap='I'>png-bw -R0.30 -G0.59 -B0.11 &lt; file.png &gt; file.bw</emphasis>
+<!-- .br -->
+has the same effect as the
+<option>-ntsc</option>
+flag.
+<!-- .br -->
+[The
+<option>-crt</option>
+weights are: 0.26, 0.66, 0.08]</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>John R. Anderson</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1998-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/png-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/png-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/png-pix.xml	(working copy)
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='pngpix1'>
+<refmeta>
+<refentrytitle>PNG-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>png-pix</refname>
+<refpurpose>convert Portable Network Graphics (PNG) encoded image to RGB pixel format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>png-pix</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>file.png</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>png-pix</emphasis>
+decodes a Portable Network Graphics (PNG) format file
+(saved with
+<citerefentry><refentrytitle>fb-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+or a similar program),
+converts it into
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format, and writes it to standard out.
+If
+<emphasis remap='I'>file.png</emphasis>
+is not specified, standard input is read. The
+<option>-v</option>
+option provide verbose information about the PNG file.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='I'>file.png</emphasis></term>
+  <listitem>
+<para>Name of file to decode, in PNG format.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.pix</emphasis></term>
+  <listitem>
+<para>Name of file to store PIX image in.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'> png-pix tank.png &gt; tank.pix</emphasis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>John R. Anderson</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1998-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/png_info.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/png_info.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/png_info.xml	(working copy)
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='png_info1'>
+<refmeta>
+<refentrytitle>PNG_INFO</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>png_info</refname>
+<refpurpose>Display the non-image information available in a Portable Networks Graphics (PNG) format file.</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>png_info</command>    
+    <arg choice='opt'><replaceable>in.png</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Png_info</emphasis>
+will print most of the information available from a PNG file other than the image itself.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para><command>png_info</command>
+file.png</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>png-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>John R. Anderson</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1998-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/random.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/random.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/random.xml	(working copy)
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='random1'>
+<refmeta>
+<refentrytitle>RANDOM</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>random</refname>
+<refpurpose>generates a random number between two specified values</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>random</command>    
+    <arg choice='opt'>-s <replaceable>seed</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'>-g </arg><arg choice='opt'>-c <replaceable>center</replaceable></arg></arg>
+    <arg choice='opt'>-u </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='plain'><replaceable>low</replaceable></arg>
+    <arg choice='plain'><replaceable>high</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>random</emphasis>
+generates a random number between the two values given.  The number
+can be uniform across the entire range or it can be a gaussian
+distribution around the center of the range (or a named center).</para>
+
+<para>The
+<option>-s</option>
+option specifies what integer seed to use to prime the random number
+generator.
+The
+<option>-u</option>
+option specifies that the random number distribution should be uniform
+across the low-to-high range.
+The
+<option>-g</option>
+option specifies that the random number distribution should be a
+gaussian distribution around a default or named center, specified with
+the
+<option>-c</option>
+option.
+The
+<option>-v</option>
+option specifies verbose diagnostic output.</para>
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<literallayout remap='.nf'>
+random 0 100
+random -g 40 2000
+</literallayout> <!-- .fi -->
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2010-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/rle-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/rle-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/rle-pix.xml	(working copy)
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='rlepix1'>
+<refmeta>
+<refentrytitle>RLE-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>rle-pix</refname>
+<refpurpose>convert Utah Raster Toolkit run-length encoded image to RGB pixel format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>rle-pix</command>    
+    <arg choice='opt'>-cdhH </arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squareoutsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>file.rle</replaceable></arg><arg choice='opt'><replaceable>file.pix</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>rle-fb</emphasis>
+decodes a Utah Raster Toolkit
+Run-Length Encoded (RLE) format file
+(saved with
+<citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pix-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+or a similar program),
+converts it into
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format, and writes it to standard out.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, standard input is read.
+<emphasis remap='I'>rle-pix</emphasis>
+determines the type and size of the saved file (color or B&amp;W)
+and acts accordingly.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>is the colormap <emphasis remap='I'>crunch</emphasis> flag.
+If the crunch flag has been specified and
+a non-linear colormap is stored in the RLE file,
+then the colormap is applied to the pixels as they are output.
+Otherwise, the encoded pixel values are output without being affected by
+any color map stored in the RLE file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>Debug option, provides a description of the parameters of the
+saved RLE image on standard error.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-C</option><replaceable>r/g/b</replaceable></term>
+  <listitem>
+<para>The background of the image is
+normally set to the value recorded in the RLE file.
+This option permits
+the user to specify an alternate background color
+as slash separated decimal numbers in the range of 0 to 255,
+one each for the red, green, and blue channels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Name of file to decode, in RLE format.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.pix</emphasis></term>
+  <listitem>
+<para>Optional name of file to store PIX image in.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 xml:id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'> rle-pix  tank.rle   tank.pix</emphasis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>Michael John Muuss</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/sun-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/sun-pix.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/sun-pix.xml	(working copy)
@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='sunpix1'>
+<refmeta>
+<refentrytitle>SUN-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>sun-pix</refname>
+<refpurpose>convert Sun bitmaps from screendump(1) into pix(5) or bw(5) raster image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>sun-pix</command>    
+    <arg choice='opt'>-b </arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-i </arg>
+    <arg choice='opt'>-P </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><replaceable>sun.bitmap</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Sun-pix</emphasis>
+is a program to take Sun bitmap files created with Sun's
+<citerefentry><refentrytitle>screendump</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+command, and convert them to a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.  If the
+<option>-b</option>
+flag is specified, a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file is created instead.
+The dimensions of the input file are the dimensions of the output
+file;  invoking
+<command>sun-pix</command>
+with the
+<option>-h</option>
+flag will cause the size of the image to be printed without further
+processing of the input, or generation of any other output.
+The image size is output as a pair
+of command line options (<emphasis remap='I'>ie,</emphasis><emphasis remap='B'> -w1152 -n900</emphasis>) suitable
+for use with other
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+tools such as
+<citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+When the
+<option>-v</option>
+flag is specified, all the fields of the header are printed on stderr,
+to aid debugging.  Note that the "encoded" format is not supported.</para>
+
+<para>Specifying the
+<option>-i</option>
+flag will invert the sense of a one-bit wide input image, <emphasis remap='I'>ie</emphasis>,
+exchanging black for white.  The default Sun image is black print on
+white background; the
+<option>-i</option>
+flag will give a white image on black background, which is often better
+for purposes of creating overlays to be composited with
+<citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+on top of color images.</para>
+
+<para>The
+<option>-P</option>
+flag indicates that the input is a pure bitmap with no Sun-style header
+on it.  The first bit to be processed will be the most significant bit (MSB),
+<emphasis remap='I'>ie</emphasis>, the left-most bit in the byte.</para>
+
+<para>Note that the input file is expected to be in Sun ("network") byte order
+(<emphasis remap='I'>ie</emphasis>, "big-endian", with byte 0 on the left), regardless
+of the byte order of the machine running this program.</para>
+</refsect1>
+
+<refsect1 xml:id='bugs'><title>BUGS</title>
+<para>24-bit images are not supported yet.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1989-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/terrain.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/terrain.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/terrain.xml	(working copy)
@@ -0,0 +1,194 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='terrain1'>
+<refmeta>
+<refentrytitle>TERRAIN</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>terrain</refname>
+<refpurpose>Generate terrain field from mathematical noise</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>terrain</command>    
+    <arg choice='opt'>-w <replaceable>x_postings</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>y_postings</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>xy_postings</replaceable></arg>
+    <arg choice='opt'>-L <replaceable>noise_Lacunarity</replaceable></arg>
+    <arg choice='opt'>-H <replaceable>noise_H_value</replaceable></arg>
+    <arg choice='opt'>-O <replaceable>noise_octaves</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>noise_offset</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>noise_scale</replaceable></arg>
+    <arg choice='opt'>-V <replaceable>noise_Vector_scale</replaceable></arg>
+    <arg choice='opt'>-D <replaceable>noise_Delta</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>noise_function</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'>-c <replaceable>host/net</replaceable></arg><arg choice='plain'><replaceable>format</replaceable></arg><arg choice='plain'><replaceable>conversion</replaceable></arg><arg choice='plain'><replaceable>off</replaceable></arg></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file.dsp</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>The
+<command>terrain</command>
+program produces pseudo-terrain from procedural noise suitable for use with a
+BRL-CAD dsp primitive.  Noise values are computed for the grid points of the
+lattice and the resultant values are output on the standard output as unsigned
+shorts in network byte order.  The size of the grid is specified with the
+<option>-w</option>
+and
+<option>-n</option>
+options.</para>
+
+
+</refsect1>
+
+<refsect1 xml:id='options'><title>OPTIONS</title>
+<!-- .PD 0 -->
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-w</option><replaceable>  grid_x_postings</replaceable></term>
+  <listitem>
+<para>Specifies the number of grid points in the X dimension.  Default is 256.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n</option><replaceable>  grid_y_postings</replaceable></term>
+  <listitem>
+<para>Specifies the number of grid points in the Y dimension.  Default is 256.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>Turns of the conversion of the data from host to network format.  This only
+has an effect on little-endian machines.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Turns on verbose mode.  Information about which filter is running is printed.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-f</option><replaceable>  noise_type</replaceable></term>
+  <listitem>
+<para>Selects the type of noise field to be used.  Options include</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>L</emphasis></term>
+  <listitem>
+<para>A lunar-like surface.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>f</emphasis></term>
+  <listitem>
+<para>Fractional Brownian motion (fBm).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>t</emphasis></term>
+  <listitem>
+<para>Turbulence.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>T</emphasis></term>
+  <listitem>
+<para>Turbulence inverted: 1.0 - turb(pt).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>m</emphasis></term>
+  <listitem>
+<para>A Multi-fractal.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>r</emphasis></term>
+  <listitem>
+<para>A Ridged multi-fractal.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+<!-- .PD -->
+
+
+<refsect2 xml:id='noise_options'><title>Noise Options</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-O</option><replaceable>  noise_octaves</replaceable></term>
+  <listitem>
+<para>Specifies the number of octaves of noise to layer.
+Typical values are 2 through 8.
+<emphasis remap='B'>$0</emphasis>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-L</option><replaceable>  noise_Lacunarity</replaceable></term>
+  <listitem>
+<para>Specifies the scaling factor between successive octaves of noise.  Practical
+values are non-integer numbers between 1.7 and 4.0.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-H</option><replaceable>  noise_H_val</replaceable></term>
+  <listitem>
+<para>Specifies the value of H in the noise equation.  Usually 1.0</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S</option><replaceable>  noise_scale</replaceable></term>
+  <listitem>
+<para>Scales the noise uniformly in X, Y and Z dimensions by the value
+<emphasis remap='I'>noise_scale.</emphasis>
+Values below 1.0 cause the noise pattern to become smaller. Values above 1.0 cause it to get bigger</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-V</option><replaceable>  scale_x,scale_y,scale_z</replaceable></term>
+  <listitem>
+<para>Allows non-uniform scaling of the X, Y and Z dimensions.  See
+<option>-S</option>
+above.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-D</option><replaceable>  delta_x,delta_y,delta_z</replaceable></term>
+  <listitem>
+<para>Specifies a translation in noise space to be</para>
+
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2000-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/wavelet.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/wavelet.xml	(revision 0)
+++ brlcad/doc/docbook/system/man1/en/wavelet.xml	(working copy)
@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- lifted from troff+man by doclifter -->
+<refentry xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en' xml:id='wavelet1'>
+<refmeta>
+<refentrytitle>WAVELET</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>wavelet</refname>
+<refpurpose>perform a haar wavelet decomposition/reconstruction</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv xml:id='synopsis'>
+<cmdsynopsis>
+  <command>wavelet</command>    
+    <arg choice='opt'>-1 </arg>
+    <arg choice='opt'>-2 </arg>
+    <arg choice='opt'>-d </arg>
+    <arg choice='opt'>-r </arg>
+    <arg choice='opt'>-# <replaceable>channels</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'>-t </arg><group choice='opt'><arg choice='plain'><replaceable>c</replaceable></arg><arg choice='plain'><replaceable>d</replaceable></arg><arg choice='plain'><replaceable>f</replaceable></arg><arg choice='plain'><replaceable>i</replaceable></arg><arg choice='plain'><replaceable>l</replaceable></arg><arg choice='plain'><replaceable>s</replaceable></arg></group></arg>
+    <arg choice='opt'>-w <replaceable>width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>scanlines</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squaresize</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>square_out_size</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>width_out</replaceable></arg>
+    <arg choice='plain'><replaceable>&lt;</replaceable></arg>
+    <arg choice='plain'><replaceable>file</replaceable></arg>
+    <arg choice='plain'><replaceable>&gt;</replaceable></arg>
+    <arg choice='plain'><replaceable>wavelet</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 xml:id='description'><title>DESCRIPTION</title>
+<para>The
+<command>wavelet</command>
+command
+will perform Haar wavelet decomposition or reconstruction
+transforms
+on the input dataset.
+The command line options are:</para>
+
+<para><option>-d</option>
+perform decomposition.</para>
+
+<para><option>-r</option>
+perform reconstruction.</para>
+
+<!-- .br -->
+<para><option>-1</option>
+perform a 1-dimensional (horizontal) transform.</para>
+
+<para><option>-2</option>
+perform a 1-dimensional (interleaved horizontal and vertical) transform.</para>
+
+<para><option>-# channels</option>
+Indicates the number of values in each sample point.  For example, to perform
+a transform on a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file properly, specify "-# 3".  This causes the red, green and blue channels
+to be transformed individually.</para>
+
+<para><option>-t {cdfils}</option>
+specifies the data type of the input, and hence the data type in which the
+wavelet calculations will be performed.
+The letters each stand for the first
+character of the C programming language data type:
+<emphasis remap='B'>c</emphasis>haracter,
+<emphasis remap='B'>d</emphasis>ouble,
+<emphasis remap='B'>f</emphasis>loat,
+<emphasis remap='B'>i</emphasis>nt,
+<emphasis remap='B'>l</emphasis>ong,
+<emphasis remap='B'>s</emphasis>hort.
+Note that if lossless decomposition
+and reconstruction are desired, then data sets should be converted to the next
+larger data type before being processed.</para>
+
+
+<para><option>-w width</option>
+Specify the number of samples per scanline.</para>
+
+<para><option>-n scanline</option>
+Specify the number of scanlines in the dataset</para>
+
+<para><option>-s squaresize</option>
+Specify both width and scanlines simultaneously (square image).</para>
+
+<para><option>-W width_out</option>
+Specifies the width of the output image.  Normally this is 1 for a full
+decomposition/reconstruction.  You may specify a width at which decomposition or reconstruction
+should stop. This number should be a power of 2.  The result will be an
+"average" image of the specified size, with the remainder of the original
+data width converted to "detail" coefficients.  See also: -R</para>
+
+<para><option>-R avg_size</option>
+Resumes a transform that left off with an average image of avg_size.</para>
+
+
+<para><option>-S square_out_size</option>
+This is the same as the
+<option>-W</option>
+option.  It implies the square size for a 2D decomposition limit.</para>
+
+
+</refsect1>
+
+<refsect1 xml:id='examples'><title>EXAMPLES</title>
+<para>The command
+<!-- .br -->
+<userinput>decompose -# 3 &lt; img.pix | pix-fb</userinput>
+<!-- .br -->
+will display the horizontal decomposition of the file img.pix.</para>
+
+<para>The command
+<!-- .br -->
+<userinput>decompose -# 3 -s 1024 -l 64 &lt; img.pix &gt;</userinput>
+<!-- .br -->
+will decompose a 1024x1024 image.  The decomposition will stop when the
+image has been decomposed to 64x64.  The output image will thus have a 64x64
+version of the original in the lower left corner of the image, with detail
+terms in the remainder.</para>
+</refsect1>
+
+<refsect1 xml:id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 xml:id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 xml:id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1999-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 xml:id='bug_reports'><title>BUG REPORTS</title>
+<para>Reports of bugs or problems should be submitted via electronic
+mail to &lt;devs@brlcad.org&gt;.</para>
+</refsect1>
+</refentry>
+
Index: brlcad/src/util/CMakeLists.txt
===================================================================
--- brlcad/src/util/CMakeLists.txt	(revision 53938)
+++ brlcad/src/util/CMakeLists.txt	(working copy)
@@ -176,102 +176,6 @@
 BRLCAD_ADDEXEC(roots_example roots_example.c "libbu;librt" NO_INSTALL)
 BRLCAD_ADDDATA(roots_example.c sample_applications)
 
-set(util_MANS
-  ap-pix.1
-  asc-pl.1
-  azel.1
-  bary.1
-  brlcad.1
-  buffer.1
-  bw-imp.1
-  bw-pix.1
-  bw-png.1
-  bw-ps.1
-  bw-rle.1
-  bw3-pix.1
-  bwcrop.1
-  bwdiff.1
-  bwfilter.1
-  bwhist.1
-  bwhisteq.1
-  bwmod.1
-  bwrect.1
-  bwrot.1
-  bwshrink.1
-  bwstat.1
-  bwthresh.1
-  cv.1
-  dbcp.1
-  decimate.1
-  dpix-pix.1
-  dunncolor.1
-  dunnsnap.1
-  gencolor.1
-  hex.1
-  imgdims.1
-  loop.1
-  mac-pix.1
-  morphedit.1
-  orle-pix.1
-  pix-alias.1
-  pix-bw.1
-  pix-bw3.1
-  pix-orle.1
-  pix-png.1
-  pix-ppm.1
-  pix-ps.1
-  pix-rle.1
-  pix-sun.1
-  pixbackgnd.1
-  pixbgstrip.1
-  pixblend.1
-  pixborder.1
-  pixbustup.1
-  pixclump.1
-  pixcolors.1
-  pixcut.1
-  pixdiff.1
-  pixdsplit.1
-  pixfade.1
-  pixfilter.1
-  pixhalve.1
-  pixhist.1
-  pixhist3d-pl.1
-  pixhist3d.1
-  pixinterp2x.1
-  pixmatte.1
-  pixmerge.1
-  pixmorph.1
-  pixrect.1
-  pixrot.1
-  pixsaturate.1
-  pixscale.1
-  pixshrink.1
-  pixstat.1
-  pixsubst.1
-  pixtile.1
-  pixuntile.1
-  pl-X.1
-  pl-asc.1
-  pl-hpgl.1
-  pl-pl.1
-  pl-ps.1
-  pl-tek.1
-  plcolor.1
-  pldebug.1
-  plgetframe.1
-  plline2.1
-  plrot.1
-  png-bw.1
-  png-pix.1
-  png_info.1
-  random.1
-  rle-pix.1
-  sun-pix.1
-  terrain.1
-  wavelet.1
-  )
-ADD_MAN_PAGES(1 util_MANS)
 CMAKEFILES(bombardier.h rle_args.h morphedit.tcl pldebug.c)
 CMAKEFILES(Makefile.am)
 
Index: brlcad/src/util/Makefile.am
===================================================================
--- brlcad/src/util/Makefile.am	(revision 53938)
+++ brlcad/src/util/Makefile.am	(working copy)
@@ -538,101 +538,6 @@
 yuv_pix_SOURCES = yuv-pix.c
 yuv_pix_LDADD = ${FB} ${BN} ${BU}
 
-man_MANS = \
-	ap-pix.1 \
-	asc-pl.1 \
-	azel.1 \
-	bary.1 \
-	brlcad.1 \
-	buffer.1 \
-	bw-imp.1 \
-	bw-pix.1 \
-	bw-png.1 \
-	bw-ps.1 \
-	bw-rle.1 \
-	bw3-pix.1 \
-	bwcrop.1 \
-	bwdiff.1 \
-	bwfilter.1 \
-	bwhist.1 \
-	bwhisteq.1 \
-	bwmod.1 \
-	bwrect.1 \
-	bwrot.1 \
-	bwshrink.1 \
-	bwstat.1 \
-	bwthresh.1 \
-	cv.1 \
-	dbcp.1 \
-	decimate.1 \
-	dpix-pix.1 \
-	dunncolor.1 \
-	dunnsnap.1 \
-	gencolor.1 \
-	hex.1 \
-	imgdims.1 \
-	loop.1 \
-	mac-pix.1 \
-	morphedit.1 \
-	orle-pix.1 \
-	pix-alias.1 \
-	pix-bw.1 \
-	pix-bw3.1 \
-	pix-orle.1 \
-	pix-png.1 \
-	pix-ppm.1 \
-	pix-ps.1 \
-	pix-rle.1 \
-	pix-sun.1 \
-	pixbackgnd.1 \
-	pixbgstrip.1 \
-	pixblend.1 \
-	pixborder.1 \
-	pixbustup.1 \
-	pixclump.1 \
-	pixcolors.1 \
-	pixcut.1 \
-	pixdiff.1 \
-	pixdsplit.1 \
-	pixfade.1 \
-	pixfilter.1 \
-	pixhalve.1 \
-	pixhist.1 \
-	pixhist3d-pl.1 \
-	pixhist3d.1 \
-	pixinterp2x.1 \
-	pixmatte.1 \
-	pixmerge.1 \
-	pixmorph.1 \
-	pixrect.1 \
-	pixrot.1 \
-	pixsaturate.1 \
-	pixscale.1 \
-	pixshrink.1 \
-	pixstat.1 \
-	pixsubst.1 \
-	pixtile.1 \
-	pixuntile.1 \
-	pl-X.1 \
-	pl-asc.1 \
-	pl-hpgl.1 \
-	pl-pl.1 \
-	pl-ps.1 \
-	pl-tek.1 \
-	plcolor.1 \
-	pldebug.1 \
-	plgetframe.1 \
-	plline2.1 \
-	plrot.1 \
-	png-bw.1 \
-	png-pix.1 \
-	png_info.1 \
-	random.1 \
-	rle-pix.1 \
-	sun-pix.1 \
-	terrain.1 \
-	wavelet.1
-
 sample_applicationsdir = $(SAMPLE_APPLICATIONS_DIR)
 
 sample_applications_DATA = \
@@ -640,7 +545,6 @@
 	roots_example.c
 
 EXTRA_DIST = \
-	$(man_MANS) \
 	$(sample_applications_DATA) \
 	${BOMBARDIER_EXTRA} \
 	${PC_TEST_EXTRA} \
Index: brlcad/src/util/ap-pix.1
===================================================================
--- brlcad/src/util/ap-pix.1	(revision 53937)
+++ brlcad/src/util/ap-pix.1	(working copy)
@@ -1,73 +0,0 @@
-.TH AP-PIX 1 BRL-CAD
-.\"                       A P - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-ap\(hypix \- convert Applicon files to pix files
-.SH SYNOPSIS
-.B ap-pix
-.RB [ \-v ]
-file.ap
-\>\ file.pix
-.SH DESCRIPTION
-.I Ap-pix
-converts an
-.I Applicon
-drum plotter image file into a
-.IR pix (5)
-file.
-.PP
-The
-.I Applicon
-file is assumed to consist of a number lines each 3456 bits long, the
-resulting
-.I pix
-file thus has scanlines of 3456 pixels.
-.SH "SEE ALSO"
-brlcad(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/asc-pl.1
===================================================================
--- brlcad/src/util/asc-pl.1	(revision 53937)
+++ brlcad/src/util/asc-pl.1	(working copy)
@@ -1,81 +0,0 @@
-.TH ASC-PL 1 BRL-CAD
-.\"                       A S C - P L . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-asc-pl \- produce Plot3 instructions from ASCII representation
-.SH SYNOPSIS
-.B asc-pl
-[file.asc [unix_plot]]
-.SH DESCRIPTION
-Reads a stream of ASCII data representing Plot3 instructions
-and converts it to
-.IR plot3 (5)
-format.
-.I Asc-pl
-reads from standard input and writes to standard output
-if file names are not supplied.
-.PP
-The input should consist of lines of the form
-
-.nf
-.RS
-c arg arg ...
-.RE
-.fi
-
-where
-.I c
-is one of the single-character Plot3 command names,
-and it is followed by white-space-separated arguments
-of appropriate number and types for that command.
-Optional white space and lines beginning with the comment character
-`#' are ignored.
-.SH "SEE ALSO"
-pl-asc(1), pl-pl(1), plrot(1), pl-fb(1), libplot3(3), plot3(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/azel.1
===================================================================
--- brlcad/src/util/azel.1	(revision 53937)
+++ brlcad/src/util/azel.1	(working copy)
@@ -1,190 +0,0 @@
-.TH AZEL 1 BRL-CAD
-.\"                         A Z E L . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\"  define new carat and tilde symbols
-.ds ^ \v'+.15v'\s+2^\s-2\v'-.15v'
-.ds ~ \v'-.1v'\s-4\(ap\s+4\v'+.1v'
-.\" \*^ and \*~ insert them into text
-.\" Define [nt]roff strings for Greek letters
-.if t .ds be \(*b
-.if n .ds be beta
-.if t .ds pi \(*p
-.if n .ds pi pi
-.if t .ds rh \(*r
-.if n .ds rh rho
-.if t .ds th \(*h
-.if n .ds th theta
-.\" Define upstart and upend macros for superscripts
-.\" to insert them, use \*(us and \*(ue, respectively
-.if t .ds us \v'-.4m'\s-3
-.if n .ds us \u
-.if t .ds ue \s0\v'.4m'
-.if n .ds ue \d
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.SH NAME
-azel \- rotate 3-D Cartesian data in azimuth and elevation
-.SH SYNOPSIS
-.BR "azel  [ " options " ] [ infile [ outfile ] ]"
-.SH DESCRIPTION
-.I Azel
-converts between right-handed Cartesian coordinate systems,
-an application-geometry system
-\fIx\fR, \fIy\fR, \fIz\fR
-and a viewer-embedded system
-\fId\fR, \fIh\fR, \fIv\fR.
-These systems differ by rotation in azimuth and elevation
-about their common origin.
-Input comes from
-.I infile
-and output goes to
-.I outfile
-if they are specified, otherwise
-.I azel
-uses stdin and stdout, respectively.
-Each line of input must contain three numbers separated by
-white space.
-Unless the
-.B -i
-option (q.v.) is specified,
-.I azel
-interprets each triple as the
-\fIx\fR, \fIy\fR, \fIz\fR
-coordinates of a vector, and prints out its
-\fId\fR, \fIh\fR, \fIv\fR
-coordinates.
-Any other text on the input line beyond the triple is copied verbatim.
-.SS Options
-The command-line options and their meanings are given below.
-.TP 12
-.BI -a " azim"
-Specifies azimuthal rotation of
-.I azim
-degrees.
-Default is 0.
-.TP 12
-.BI -e " elev"
-Specifies elevation rotation of
-.I elev
-degrees.
-Default is 0.
-.TP 12
-.BI -c " celsiz"
-Specifies a cell size of
-.I celsiz.
-Output vectors are scalar multiplied by
-.RI 1/ celsiz.
-Default is 1.
-Useful with the
-.B -r
-option to bin output data into cells.
-.TP 12
-.B -i
-Causes
-.I azel
-to perform the inverse rotation.
-The input is transformed from viewer to application-geometry coordinates
-(i.e., from
-\fId\fR, \fIh\fR, \fIv\fR
-to
-\fIx\fR, \fIy\fR, \fIz\fR).
-Incompatible with the
-.B -p
-option.
-.TP 12
-.B -p
-Causes
-.I azel
-to project the output vectors onto the \fIhv\fR plane.
-This gives grid-plane coordinates.
-Incompatible with the
-.B -i
-option.
-.TP 12
-.B -r
-Causes
-.I azel
-to round each coordinate of the output vectors to the nearest integer.
-Useful with the
-.B -c
-option to bin output data into cells.
-.SH DEFINITIONS
-The viewer coordinates are defined so that
-positive \fId\fR points toward the viewer,
-positive \fIh\fR (horizontal) points to the viewer's right, and
-positive \fIv\fR (vertical) points up.
-When \fIazim\fR\ =\ \fIelev\fR\ =\ 0,
-the two coordinate systems coincide, in which case
-.I azel
-performs the identity transformation.
-Azimuth is the angle in the \fIdh\fR plane
-from positive \fIh\fR to positive \fIy\fR,
-measured toward positive \fId\fR.
-Elevation is the angle in the \fIdv\fR plane
-from positive \fIv\fR to positive \fIz\fR,
-measured toward positive \fId\fR.
-In the forward direction
-the azimuthal rotation is performed before the elevation,
-while in the inverse direction, the elevation is undone before the azimuth.
-Thus, the \fIz\fR axis is always normal to the \fIh\fR axis.
-When \fIazim\fR\ =\ 90 and \fIelev\fR\ =\ 0,
-\fIx\fR\ =\ -\fIh\fR,
-\fIy\fR\ =\ \fId\fR, and
-\fIz\fR\ =\ \fIv\fR.
-When \fIazim\fR\ =\ 0 and \fIelev\fR\ =\ 90,
-\fIx\fR\ =\ -\fIv\fR,
-\fIy\fR\ =\ \fIh\fR, and
-\fIz\fR\ =\ \fId\fR.
-.SH DIAGNOSTICS
-The exit status is 0 if all input was successfully transformed,
-1 otherwise.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bary.1
===================================================================
--- brlcad/src/util/bary.1	(revision 53937)
+++ brlcad/src/util/bary.1	(working copy)
@@ -1,134 +0,0 @@
-.TH BARY 1 BRL-CAD
-.\"                         B A R Y . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1995-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.SH NAME
-bary \- compute weighted sums of points
-.SH SYNOPSIS
-.BR "bary  [ -nt ] [ -s " "'x y z'" " ] [ " "file" " ] "
-.SH DESCRIPTION
-.I Bary
-computes weighted sums of a set of sites in Euclidean 3-space,
-writing them on the standard output.
-The site weights are read from
-.I file
-if it is specified;
-otherwise,
-.I bary
-reads from the standard input.
-A line of input must be either
-(1) entirely white space,
-(2) white space followed by a comment (begun with the '#' character),
-or (3) white-space-separated weights, one per site.
-
-By default,
-.I bary
-uses the three sites (1, 0, 0), (0, 1, 0), and (0, 0, 1).
-One or more occurrences of the
-.B -s
-option cause
-.I bary
-to replace
-the default sites with all the sites
-(\fIx\fR, \fIy\fR, \fIz\fR)
-.\".RI "(" "x" ", " "y" ", " "z" ")" " " "huh?"
-so specified.
-
-The
-.B -n
-option causes
-.I bary
-to normalize each tuple of weights to sum to one.
-This has the effect of computing
-barycentric combinations of the sites.
-
-If any line of weights in the input stream
-contains more fields than the number of sites,
-.I bary
-will, by default,
-ignore the excess fields.
-The
-.B -t
-option causes
-.I bary
-to copy all such trailing fields verbatim onto the tail of
-the corresponding line of output.
-
-.SH EXAMPLE
-The command
-
-.nf
-.in +4
-bary -tn -s '0 0 0' -s '1 0 0' -s '0.5 0.866 0' <<EOF
-#------------------------------
-# x   y   z     aux. data
-#------------------------------
- 1.0 2.5 3.6    58 alpha
- 0.0 1.0 2.0    37 bravo
-13.0 9.2 6.3    69 charlie delta
-EOF
-.in -4
-.fi
-
-maps the triples to points in an equilateral triangle in the \fIxy\fR-plane,
-producing the following output:
-
-.nf
-.in +4
-0.605634 0.439099 0    58 alpha
-0.666667 0.577333 0    37 bravo
-0.433333 0.191432 0    69 charlie delta
-.in -4
-.fi
-
-.SH AUTHOR
-Paul Tanenbaum
-
-.SH COPYRIGHT
-This software is Copyright (c) 1995-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/brlcad.1
===================================================================
--- brlcad/src/util/brlcad.1	(revision 53937)
+++ brlcad/src/util/brlcad.1	(working copy)
@@ -1,393 +0,0 @@
-.TH BRLCAD 1 BRL-CAD
-.\"                       B R L C A D . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-brlcad \- BRL-CAD programs for solid modeling, raytracing,
-graphics, and image processing
-.SH DESCRIPTION
-The BRL-CAD Distribution contains many directories of materials.
-The major categories of programs are:
-.TP
-.B mged
-A multi-device interactive editor for constructing and updating
-combinatorial solid geometry (CSG)
-models.
-See
-.IR mged (1),
-and
-\fIUnderstanding the Preparation and Analysis of Solid Models\fR
-by Michael John Muuss (enclosed, in the ``paper'') directory.
-.TP
-.B librt
-A library of functions suitable for interrogation of a
-CSG solid model, utilizing ray-tracing techniques.
-See
-.IR librt (3).
-.TP
-.B rt
-A ray-tracing lighting model, for rendering pictures of
-.IR mged (1)
-CSG models.
-See
-.IR rt (1),
-.IR rtray (1),
-.IR rtpp (1).
-.TP
-.B conv
-Programs to convert
-.IR mged (1)
-and
-.IR pix (3)
-format binary files to a portable ASCII form, and back again.
-See
-.IR asc2g (1),
-.IR asc2pix (1),
-.IR conv-vg2g (1),
-.IR g2asc (1),
-.IR pix2asc (1).
-.TP
-.B libpkg
-A ``message-passing'' interface layered on top of TCP network links,
-to ease construction of network-distributed applications.
-.TP
-.B libfb
-A generic frame-buffer library which includes
-support for a number of display devices,
-as well as file, network, and debugging interfaces.
-Most programs which use this library have the letters ``fb''
-in their names.  To override your system default frame-buffer,
-the environment variable
-.B
-.SM FB_FILE
-can be set.  In addition, some commands also support a
-.B \-F
-.I framebuffer
-option.
-Note that the disk file format of
-.I libfb
-is that of
-.IR pix (5),
-allowing ``framebuffer'' files to be later processed by
-any of the ``pix'' family of programs.
-See
-.IR libfb (3),
-.IR pix-fb (3),
-.IR pix (5),
-etc.
-.TP
-.B fbserv
-TCP-based network server which implements remote frame-buffer services.
-.TP
-.B libsysv
-Some System-V compatibility routines
-.TP
-.B libtermio
-A library to handle terminal mode setting
-on both Berkeley or SystemV machines.
-.TP
-.B libplot3
-A public-domain version of the UNIX-Plot library
-which differs from that of the standard
-.IR libplot (3),
-by the addition of 3-D primitives, color, floating point
-coordinate routines, and the use of a file pointer parameter.
-See
-.IR libplot3 (3),
-.IR plot3 (5).
-.TP
-.B librle
-A Run-Length-Encoding (RLE) library,
-providing functions
-originally from the University of Utah in a library package.
-Note that the current version of this library reads
-Edition-3 RLE files.
-[Edition-1 and Edition-2 RLE files can be read and written
-with the
-.B liborle
-and
-.B orle
-programs.]
-See
-.IR rle-fb (1),
-.IR fb-rle (1),
-.IR rle-pix (1),
-.IR pix-rle (1),
-.IR librle (3).
-.TP
-.B util
-A collection of image-handling utilities,
-each constructed as individual tools intended to be used in combination.
-See
-.IR ap-pix (1),
-.IR bw-fb (1),
-.IR bw-imp (1),
-.IR bw-pix (1),
-.IR bw3-pix (1),
-.IR bwcrop (1),
-.IR bwdiff (1),
-.IR bwfilter (1),
-.IR bwhist (1),
-.IR bwmod (1),
-.IR bwrect (1),
-.IR bwrot (1),
-.IR bwscale (1),
-.IR bwstat (1),
-.IR dunncolor (1),
-.IR dunnsnap (1),
-.IR fb-bw (1),
-.IR fb-pix (1),
-.IR fb-rle (1),
-.IR fbanim (1),
-.IR fbclear (1),
-.IR fbcmap (1),
-.IR fbcmrot (1),
-.IR fbcolor (1),
-.IR fbframe (1),
-.IR fbgrid (1),
-.IR fbpoint (1),
-.IR fbzoom (1),
-.IR gencolor (1),
-.IR loop (1),
-.IR pix-bw (1),
-.IR pix-bw3 (1),
-.IR pix-fb (1),
-.IR pixbackgnd (1),
-.IR pixbustup (1),
-.IR pixdiff (1),
-.IR pixfilter (1),
-.IR pixhist (1),
-.IR pixhist3d-pl (1),
-.IR pixhist3d (1),
-.IR pixinterp2x (1),
-.IR pixrect (1),
-.IR pixrot (1),
-.IR pixscale (1),
-.IR pixstat (1),
-.IR pixtile (1),
-.IR pl-fb (1),
-.IR pp-fb (1),
-.IR rle-fb (1),
-.IR rle-pix (1),
-.IR wavelet (1),
-.IR bw (5),
-.IR pix (5),
-.IR plot3 (5).
-.TP
-.B fbed
-An interactive, termcap-based frame-buffer image editor.
-See
-.IR fbed (1).
-.TP
-.B vdeck
-A program to convert
-.I mged(1)
-models to
-.I gift(1)
-format card deck files.
-See
-.IR vdeck (1).
-.PD
-.SH FB_FILE
-Whenever a framebuffer is needed, and the
-.B \-F
-option has not been specified, the environment variable
-.B
-.SM FB_FILE
-is checked for the device to use.  The format of this
-variable is either
-.IB [hostname:] /dev/ device_name[num]
-or
-.I UNIX_path ,
-the pathname of a disk file to be used as a ``virtual framebuffer.''
-.I Hostname
-is the name of a remote machine if the remote framebuffer interface
-is being used.
-When a local display device is being specified, the
-.I hostname
-should not be specified, for performance reasons; just the
-special string
-.I Device_name
-is used to select a particular type of framebuffer.
-.I Num
-is type dependent and can either mean a display number or select
-some options for that type.
-Note that for security reasons, it is not permitted to access a
-disk file via the remote interface.
-.PP
-If
-.B
-.SM FB_FILE
-is not set, the default for you system will be used.
-.PP
-The use of
-.B /dev/
-before the
-.I device_name
-is simply to distinguish them from filenames.  See the end of the
-.IR libfb (3)
-manual page for a list of the device names and the meanings of
-any
-.I num
-parameters they may take, and for a more detailed discussion.
-.SH OPTIONS
-A convention exists for the options used on
-most of the utilities provided.
-Random options are usually lower case.
-Options which could specify either a screen or file size
-are, by convention, lower case for file information,
-and upper case for screen information.
-Here's a list of some of the common options you may encounter:
-.TP
-.B \-h
-The ``high resolution'' flag, increasing the default screen and file
-size of 512x512
-to 1024x1024.  Has same effect as
-.B \-s 1024 \-S 1024
-but exists as a convenient shorthand held over from the simple days
-when framebuffers where square, and only came in two resolutions.
-This historical usage unfortunately preempts this letter from use
-as a height specifier, forcing that function to relocate under
-protest to
-.BR \-n ,
-which can be thought of as ``number of scanlines'', which isn't
-too bad a mnemonic.
-.TP
-.B \-i
-Inverse flag.  Pretend origin is in upper left corner of screen,
-for that good old-fashioned fourth-quadrant behavior.
-.TP
-.B \-c
-Various.  Typically means clear the screen first.
-.TP
-.B \-z
-Various.  Typically means zoom-in on current area of display.
-.TP
-.BI \-s\  square_file_size
-.B WARNING:
-Behavior is undefined when the
-.B \-s
-flag is used in conjunction with the
-.BR \-w\  or\  \-n
-flags.
-.TP
-.BI \-w\  file_width
-.TP
-.BI \-n\  file_height
-.TP
-.BI \-S\  square_screen_size
-.B WARNING:
-Behavior is undefined when the
-.B \-S
-flag is used in conjunction with the
-.BR \-W\  or\  \-N
-flags.
-.TP
-.BI \-W\  screen_width
-.TP
-.BI \-N\  screen_height
-.TP
-.BI \-x\  file_x_offset
-.TP
-.BI \-y\  file_y_offset
-.TP
-.BI \-X\  screen_x_offset
-.TP
-.BI \-Y\  screen_y_offset
-.TP
-.BI \-#\  bytes_per_sample
-specifies the number of bytes per sample, where the
-flag, where the
-.B #
-character is a literal ``pound'' or ``sharp'' sign character,
-typically found over the numeral ``3'' on ANSI keyboards.
-Several programs (like pixrect)
-can operate on data samples of arbitrary width.
-For example, a
-.BR pix (5)
-format file can often be treated like a
-.BR bw (5)
-format file with a width of three bytes per sample.
-.SH "TAPE FORMAT"
-When dealing with large collections of images, as might be
-needed for making a movie,
-it frequently becomes desirable to deal with magnetic tapes.
-Some of the early
-.BR pix (5)
-tools contained built-in knowledge of the tape format.
-While this aberrant early design has been corrected
-in favor of using tape-oriented programs such as
-.BR dd (1)
-in pipelines with the image tools, our ``standard''
-image format remains.
-.PP
-Regardless of image resolution, all tape records are 24k bytes long.
-If an image does not occupy an integral number of tape records,
-the last record is padded out.
-For example, NTSC images in 640x480 format use
-37.5 records per image.
-The
-.IR files-tape (1)
-utility is helpful in performing this function.
-.PP
-The capacity of an average 2400 foot reel of tape at 6250 is 6144 records
-of 24k bytes each.
-For the various combinations of density and image resolution,
-a convention for the number of frames/reel exists:
-.br
-Density\ \ Resolution\ \ Frames/reel
-.br
-\ 6250\ \ \ \ \ \ \ \ 1k\ \ \ \ \ \ \ \ \ \ 48
-.br
-\ 6250\ \ \ \ \ \ 640x480\ \ \ \ \ \ 160
-.br
-\ 6250\ \ \ \ \ \ \ 512\ \ \ \ \ \ \ \ \ 192
-.br
-\ 1600\ \ \ \ \ \ \ \ 1k\ \ \ \ \ \ \ \ \ \ 12
-.br
-\ 1600\ \ \ \ \ \ \ 512\ \ \ \ \ \ \ \ \ 48
-.B
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/buffer.1
===================================================================
--- brlcad/src/util/buffer.1	(revision 53937)
+++ brlcad/src/util/buffer.1	(working copy)
@@ -1,89 +0,0 @@
-.TH BUFFER 1 BRL-CAD
-.\"                       B U F F E R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\"
-.\" File name macro to make listing files easier
-.\"
-.de FN
-\fI\|\\$1\|\fP
-..
-.\"
-.\" Begin actual content
-.\"
-.SH NAME
-buffer \- buffer data from stdin until EOF, then write to stdout
-.SH SYNOPSIS
-.B buffer
-.SH DESCRIPTION
-.I Buffer\^
-is intended to be use as part of a complex pipeline.
-It serves somewhat the same purpose as the Prolog "cut" operator.
-Data from stdin is read and buffered until EOF is detected, and then
-all the buffered data is written to stdout.  An arbitrary amount of
-data may need to be buffered, so a combination of a 1 Mbyte memory buffer
-and a temporary file is used.
-This can be useful when context switching may need to be reduced,
-because of too many processes competing at the same time.
-This can also be useful when processing data from and to the
-same framebuffer with a pipeline, without interfering.
-.SH EXAMPLES
-
-.nf
-.RS
-munch | crunch | buffer | grind | package
-
-fb-pix | pixfilter -flo | buffer | pix-fb
-.RE
-.fi
-
-.SH FILES
-.TP
-.FN /usr/tmp/bufferXXXXXX
-temporary file used to buffer piped data
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw-imp.1
===================================================================
--- brlcad/src/util/bw-imp.1	(revision 53937)
+++ brlcad/src/util/bw-imp.1	(working copy)
@@ -1,146 +0,0 @@
-.TH BW-IMP 1 BRL-CAD
-.\"                       B W - I M P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw\(hyimp \- convert a black and white bw image file to imPRESS bitmap
-.SH SYNOPSIS
-.B bw-imp
-.RB [ \-Dh ]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  width]
-.RB [ \-n\  height]
-.RB [ \-t\  thresh]
-.RB [ \-X\  page_xoff]
-.RB [ \-Y\  page_yoff]
-[file]
-.SH DESCRIPTION
-.I Bw-imp
-converts an 8-bit monochrome
-.IR bw (5)
-format
-.I file
-(read from the standard input if not specified)
-to
-.I Imagen imPRESS
-language codes
-for plotting a gray-scale image on a 300dpi
-.I Imagen
-laser printer.
-.PP
-The gray level is plotted on the
-.I Imagen
-as a small pattern of dots,
-by default using ``ordered dither'',
-magnifying each input pixel into multiple output pixels.
-The
-.B \-D
-option causes the gray levels to instead be plotted using halftones,
-as in newspaper/magazine reproductions of photographs.
-The
-.B \-t
-option turns off the dithering, and uses the supplied integer value
-as a threshold value.
-Input pixels with magnitude >= thresh are output as white,
-otherwise they are output as black.
-Each input pixel produces exactly one output pixel.
-If the input file is already bi-level, such as might be produced by the
-.IR halftone (1)
-program, then this is the option to be used.
-.P
-The
-.B \-h
-option specifies a 1024x1024 image rather than the default of 512x512.
-Printing is done in portrait mode.
-The largest image which can generally be printed on an 8.5 by 11 inch
-piece of paper is 2240 by 3200 pixels,
-and the default page offsets are calculated for this size.
-For smaller images, such as 512 squared,
-.BR \-X 750
-and
-.BR \-Y 1200
-produce the image roughly centered on the page.
-.SH CAVEATS
-.I Bw-imp
-will take several CPU-minutes (on a VAX 780) to convert a single
-.IR file .
-.SH EXAMPLES
-The following invocations are fairly typical:
-.RS
-\fIpix-bw\| -ntsc\| image.pix\| | \|bw-imp\| | \| qpr \|\-qi300\fP \|&
-.RE
-.sp
-.RS
-\fIrle-pix\| image.rle\| | \|pix-bw\| -ntsc\| | \|bw-imp\| | \|qpr \|\-qi300\fP \|&
-.RE
-.sp
-The X and Y options in the bw-imp command below are to approximately
-center a 1024x1024 or 512x512
-figure on a 8.5 by 11 inch sheet of paper.
-As of release 4.0 the default margins on an output page resulting from
-a bw-imp usage are smaller.  This allows a larger image to be printed
-on one page.
-.RS
-\fIrle-pix\| image.rle\| | \|pix-bw\| -ntsc\| | \|bw-imp -X 200 -Y 800\| | \|ipr -L impress -q i300 \fP
-.RE
-.sp
-To threshold and invert the black/white sense of a pix file, use:
-.RS
-\fIbwmod\| -m\| -8\| -a\| 255\| image.pix\| | \|pix-bw\| | \|bw-imp\| -t1\| |
- ttcp\| -t\| -p35 printhost \fP
-.RE
-.sp
-To use the halftone package:
-.RS
-\fIpix-bw\| -ntsc\| image.pix\| | \|halftone\| | \|bw-imp\| | \| qpr \|\-qi300\fP \|&
-.RE
-.SH "SEE ALSO"
-rle-pix(1), pix-bw(1), bw(5), pix(5)
-.SH DIAGNOSTICS
-Error messages are intended to be self-explanatory.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw-pix.1
===================================================================
--- brlcad/src/util/bw-pix.1	(revision 53937)
+++ brlcad/src/util/bw-pix.1	(working copy)
@@ -1,72 +0,0 @@
-.TH BW-PIX 1 BRL-CAD
-.\"                       B W - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw\(hypix \- convert a black and white image to color format
-.SH SYNOPSIS
-.B bw-pix
-[in.bw]
-[out.pix]
-.SH DESCRIPTION
-.I Bw-pix
-converts a black and white
-.IR bw (5)
-format
-file
-to a color
-.IR pix (5)
-format file.
-Each input value is replicated three times, thus the resulting
-output file has the same value in all three color planes.
-An input file name can be given, else input comes from stdin.
-Output will go to stdout unless an optional output file name
-is given.
-.SH "SEE ALSO"
-brlcad(1), pix-bw(1), pix-bw3(1), pix(5), bw(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw-png.1
===================================================================
--- brlcad/src/util/bw-png.1	(revision 53937)
+++ brlcad/src/util/bw-png.1	(working copy)
@@ -1,89 +0,0 @@
-.TH BW-PNG 1 BRL-CAD
-.\"                       B W - P N G . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1998-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw-png	\- convert a BRL BW(5) format image to a PNG (Portable Network Graphics) format
-.SH SYNOPSIS
-.B bw-png
-.RB [ \-a ]
-.RB [ \-s squaresize]
-.RB [ \-w file_width]
-.RB [ \-n file_height]
- [BRLbwfile] > PNG_file
-.SH DESCRIPTION
-.I bw-png
-converts a
-.I BRL BW(5)
-format file to a
-.I PNG
-format file on the standard output. The PNG file created will be an Gray scale file with a bit-depth of 8 and a file gamma of 1.0.
-.SH OPTIONS
-.TP
-.B \-a
-autosize the input file to determine file image height and width
-.TP
-.B \-n file_height
-tells
-.I bw-png
-that the input is
-.I file_height
-scanlines tall
-.TP
-.B \-s squaresize
-sets both the width and the height for the input to be
-.I squaresize
-.TP
-.B \-w file_width
-tells
-.I bw-png
-that the input is
-.I file_width
-pixels wide
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1998-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw-ps.1
===================================================================
--- brlcad/src/util/bw-ps.1	(revision 53937)
+++ brlcad/src/util/bw-ps.1	(working copy)
@@ -1,119 +0,0 @@
-.TH BW-PS 1 BRL-CAD
-.\"                        B W - P S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw-ps \- convert a black and white bw file to PostScript
-.SH SYNOPSIS
-.B bw-ps
-.RB [ \-e ]\ [ -c ]
-.RB [ \-L ]\ [ -h ]
-.RB [ \-s\  input_squaresize]
-.RB [ \-w\  input_width]
-.RB [ \-n\  input_height]
-.RB [ \-S\  inches_square]
-.RB [ \-W\  inches_width]
-.RB [ \-N\  inches_height]
-[infile.bw] \>\ outfile.ps
-.SH DESCRIPTION
-.I Bw-ps
-will take a black and white
-.IR bw (5)
-format file of given dimensions and produce a Postscript file
-on the standard output.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-The
-.I \-h
-flag is a shorthand for an input image size of 1024 square.
-If no input size is given, defaults of 512 are assumed.
-.PP
-By default the output PostScript image size is 6.75 inches.
-The
-.I \-c
-option will center it on a 8.5 x 11 inch page.
-If a different output size is desired,
-.I \-S
-.I \-W
-and
-.I \-N
-can be used to set the size in inches analogous to the input
-parameters.
-Finally,
-.I \-L
-selects landscape mode, i.e. rotates the output image by ninety degrees.
-.PP
-Encapsulated PostScript files can be generated via
-.I \-e.
-.SH EXAMPLES
-bw-ps -c image.bw > image.ps
-.sp
-Produces a 6.75 inch PostScript file from an 512 x512 input image
-and centers it on an 8.5 x 11 inch page.
-.PP
-.sp
-bw-ps -e -w 1024 -n 768 image.bw > image.ps
-.sp
-Takes the file image.bw which has the dimensions of 1024 pixels wide
-by 768 pixel high, and produces an Encapsulated Postscript version
-of it.
-.PP
-.sp
-bw-ps -L -c -W 5.2 < image.bw > image.ps
-.sp
-Makes a PostScript file of the (assumed 512 square) image, with
-the output image 5.2 inches square, in landscape mode, centered
-on an 8.5 x 11 inch page.
-.SH "SEE ALSO"
-brlcad(1), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw-rle.1
===================================================================
--- brlcad/src/util/bw-rle.1	(revision 53937)
+++ brlcad/src/util/bw-rle.1	(working copy)
@@ -1,84 +0,0 @@
-.TH BW-RLE 1 BRL-CAD
-.\"                       B W - R L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1992-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw-rle \- convert monochrome bw format image to Utah Raster Toolkit run-length encoded
-.SH SYNOPSIS
-.B bw-rle
-.RB [ \-h ]
-.RB [ \-C\ bg_val ]
-.RB [ \-s\  square_file_size]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-[file.bw [file.rle]]
-.SH DESCRIPTION
-.I bw-rle
-reads a
-.IR bw\^ (5)
-format file, converts it into a Utah Raster Toolkit
-Run-Length Encoded (RLE) format file format, and writes it to standard out.
-If
-.I file.bw\^
-is not specified, standard input is read.
-.TP
-.BI \-C bg_val\^
-This option permits
-the user to specify a background color
-as a decimal number in the range of 0 to 255.
-.TP
-.I file.bw\^
-Name of file to be read, in bw format.
-.TP
-.I file.rle\^
-Optional name of file to store RLE image in.
-.SH EXAMPLE
-.RS
-\fI\|bw-rle \|tank.bw \| tank.rle\fR
-.RE
-.SH "SEE ALSO"
-brlcad(1), fb-rle(1), rle-fb(1), bw-fb(1), bw-pix(1), rle-pix(1), bw(5).
-.SH AUTHOR
-Michael John Muuss
-.SH COPYRIGHT
-This software is Copyright (c) 1992-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bw3-pix.1
===================================================================
--- brlcad/src/util/bw3-pix.1	(revision 53937)
+++ brlcad/src/util/bw3-pix.1	(working copy)
@@ -1,76 +0,0 @@
-.TH BW3-PIX 1 BRL-CAD
-.\"                      B W 3 - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bw3\(hypix \- merge black and white bw images into a color pix file
-.SH SYNOPSIS
-.B bw3-pix
-redinput greeninput blueinput \>\ file.pix
-.SH DESCRIPTION
-.I Bw3-pix
-merges (combines the colors of)
-.IR bw (5)
-format files into a
-.IR pix (5)
-file.
-.I Bw3-pix
-reads the specified input files
-and writes stdout until all files have been exhausted.
-The first file goes into the red color plane, the second green,
-the third blue.
-.PP
-.I Bw3-pix
-accepts two special filename synonyms:
-.RB `` \- '',
-which stands for stdin, and
-.RB `` . '',
-which stands for
-.IR /dev/null ,
-the latter of which will write black into the corresponding color plane.
-.SH "SEE ALSO"
-brlcad(1), pix-bw3(1), pix(5), bw(5)
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwcrop.1
===================================================================
--- brlcad/src/util/bwcrop.1	(revision 53937)
+++ brlcad/src/util/bwcrop.1	(working copy)
@@ -1,81 +0,0 @@
-.TH BWCROP 1 BRL-CAD
-.\"                       B W C R O P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwcrop \- crop black and white bw files
-.SH SYNOPSIS
-.B bwcrop
-in.bw out.bw
-.br
-.sp
-.B bwcrop
-in.bw out.bw inwidth outwidth outheight
-ulx uly urx ury lrx lry llx lly
-.SH DESCRIPTION
-.I Bwcrop
-crops any quadrilateral out of an arbitrarily large
-.IR bw (5)
-input file
-.RI ( in.bw ) ,
-squares that region to a given height and width output size,
-and writes the result to
-.IR out.bw .
-The first form of
-.I bwcrop
-prompts for all parameters it needs to do the cropping.
-All responses should be pixel counts or first
-quadrant coordinates.
-The second form allows all of the needed parameters to be given
-on the command line and is intended for use from shell scripts.
-The coordinate names stand for upper-left-x, lower-right-y, etc.
-.PP
-The nearest input pixel is selected for each output pixel.  No
-interpolation is done by this program.
-.SH "SEE ALSO"
-brlcad(1), bwrect(1), bwscale(1), bw(5).
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwdiff.1
===================================================================
--- brlcad/src/util/bwdiff.1	(revision 53937)
+++ brlcad/src/util/bwdiff.1	(working copy)
@@ -1,129 +0,0 @@
-.TH BWDIFF 1 BRL-CAD
-.\"                       B W D I F F . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwdiff \- compare two black and white files
-.SH SYNOPSIS
-.B bwdiff
-.RB [ \- { mglen }]
-.RB [ \-b ]
-file1 file2
-.SH DESCRIPTION
-.I Bwdiff
-compares two black and white
-.IR bw (5)
-format files in one of several ways,
-and writes the results on standard out
-The default method of comparison is to record the differences
-as offsets from neutral, half-intensity grey (128).
-The value written will be brighter than this neutral grey
-by an amount proportional to the signed difference between
-the pixels in
-.I file1
-and
-.IR file2 .
-That is, pixels which are brighter in
-.I file1
-than in
-.I file2
-will be brighter than the neutral grey,
-while pixels which are dimmer in
-.I file1
-than in
-.I file2
-will be dimmer.
-This difference is divided by two so that the results will fit in
-the 0->255 output range.
-.PP
-The
-.B \-m
-flag takes the magnitude of the difference, thus no offset or
-divide is necessary.  Brighter pixels indicate larger differences
-in value.  Black indicates no difference in value.
-.PP
-The flags
-.B \-g \-l \-e
-and
-.B \-n
-are relational operations, standing for greater-than, less-than,
-equal-to, and not-equal-to respectively.  Only one of these
-flags may be used at a time.  In this mode the value of a
-pixel in the first file is compared to the corresponding pixel
-in the second, and if the relation is true, a full-white (255)
-pixel is output.
-This mode is useful for producing masks
-showing pixels which satisfy the given condition.
-The default background is black, unless the
-.B \-b
-option is specified, is which case the background is file1, with a
-lowered intensity.
-.PP
-.I Bwdiff
-accepts
-.RB `` \- ''
-as a synonym for stdin, and
-.RB `` . ''
-as a synonym for
-.RI / dev / null .
-.PP
-Note that this program also produces useful results on
-color
-.IR pix (5)
-files.
-.SH EXAMPLE
-Suppose you ran
-.IR pixstat (1)
-on a file and found the modes to be red=107, green=93, blue=70.
-You could display those pixels whose colors are at these values by:
-.br
-.I
-gencolor 107 93 70 | bwdiff \-e file.pix \- | pix-fb
-.SH "SEE ALSO"
-brlcad(1), pixdiff(1), bwstat(1), bw(5), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwfilter.1
===================================================================
--- brlcad/src/util/bwfilter.1	(revision 53937)
+++ brlcad/src/util/bwfilter.1	(working copy)
@@ -1,122 +0,0 @@
-.TH BWFILTER 1 BRL-CAD
-.\"                     B W F I L T E R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwfilter \- apply a 3x3 filter to a black and white bw file
-.SH SYNOPSIS
-.B bwfilter
-.RB [ \-f\  type]
-.RB [ \-v ]
-.RB [ \-d\  div]
-.RB [ \-o\  offset]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  width]
-.RB [ \-n\  height]
-[file.bw]
-\>\ newfile.bw
-.SH DESCRIPTION
-.I Bwfilter
-applies one of several 3x3 kernel filters to a black and white
-.IR bw (5)
-format file.
-It will take a file name or else read from standard input.
-The input file size will be assumed to be 512x512
-pixels unless the
-.BR \-s ,
-.BR \-w ,
-or
-.B \-n
-flags are used to tell it otherwise (see
-.IR brlcad (1)).
-By default a low pass filter is used.  The
-.BI \-f\  type
-flag can be used to specify a different type of filter.
-.PP
-The
-.I type
-choices include:
-.TP
-.B lo
-low pass, the default.
-.TP
-.B hi
-high pass
-.TP
-.B vg
-vertical gradient
-.TP
-.B hg
-horizontal gradient
-.TP
-.B la
-laplacian
-.TP
-.B b
-boxcar low pass
-.PP
-Most filters divide the result of the kernel multiplication
-by some value about in order to scale it back to a 0->255 range.
-For example, the boxcar divides by nine.  The
-.B -d
-flag can be used to change this divisor.
-Some filters also add an offset to their results.  The output of
-a laplacian for example is "centered" about zero, thus it
-adds 128 to the answer to yield a difference from neutral grey.
-The
-.B \-o
-flag can bw used to change this offset.
-.PP
-The
-.B \-v
-flag displays the kernel values on standard error.
-.SH BUGS
-This should allow any 3x3 kernel to be specified.
-.SH "SEE ALSO"
-brlcad(1), bwscale(1), bw(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwhist.1
===================================================================
--- brlcad/src/util/bwhist.1	(revision 53937)
+++ brlcad/src/util/bwhist.1	(working copy)
@@ -1,79 +0,0 @@
-.TH BWHIST 1 BRL-CAD
-.\"                       B W H I S T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwhist \- display a histogram of a black and white bw file on
-a framebuffer
-.SH SYNOPSIS
-.B bwhist
-.RB [ \-v ]
-[file.bw]
-.SH DESCRIPTION
-.I Bwhist
-displays a histogram of the pixel values in a
-.IR bw (5)
-format file.  If a file is not given, standard input is read.
-The output will be displayed on the frambuffer selected via the
-.B
-.SM FB_FILE
-environment variable (see
-.IR libfb (3)).
-.PP
-The relative frequency is displayed on the x axis scaled so that
-the maximum is full screen.  The value 0 is at the bottom of the
-screen, 255 is at the top.
-.br
-The output is overlaid on whatever is currently on the display.
-.PP
-The
-.B \-v
-flag will output the histogram values on the terminal.
-.SH "SEE ALSO"
-brlcad(1), bwhisteq(1), bwstat(1), bw(5)
-.SH BUGS
-This program assumes it has at least 512 lines in y to work with.
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwhisteq.1
===================================================================
--- brlcad/src/util/bwhisteq.1	(revision 53937)
+++ brlcad/src/util/bwhisteq.1	(working copy)
@@ -1,74 +0,0 @@
-.TH BWHISTEQ 1 BRL-CAD
-.\"                     B W H I S T E Q . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwhisteq \- equalize the histogram of a black and white bw file
-.SH SYNOPSIS
-.B bwhisteq
-.RB [ \-v ]
-file.bw > file.equalized
-.SH DESCRIPTION
-.I Bwhisteq
-automatically equalizes the histogram of a black and white
-.IR bw (5)
-format file.
-It reads the file
-.I file.bw
-and writes a "remapped" version of it on its standard output.
-The method used is to distribute the values of the histogram, as
-best as possible, in order to
-produce a constant average "density",
-while maintaining monotonicity.
-.PP
-The
-.B \-v
-flag will output the old and new histogram values on the terminal.
-.SH "SEE ALSO"
-brlcad(1), bwhist(1), bwstat(1), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwmod.1
===================================================================
--- brlcad/src/util/bwmod.1	(revision 53937)
+++ brlcad/src/util/bwmod.1	(working copy)
@@ -1,145 +0,0 @@
-.TH BWMOD 1 BRL-CAD
-.\"                        B W M O D . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwmod \- arithmetically modify pixel values in black and white bw file
-.SH SYNOPSIS
-.B bwmod
-.BR [\-c]
-.RB { \-a\ add
-.BR \-s\  sub
-.BR \-m\  mult
-.BR \-d\  div
-.B \-A
-.BR \-e\  exp
-.BR \-r\  root}
-\.\.\.\.
-\<\ file.bw
-.SH DESCRIPTION
-.I Bwmod
-will perform a series of arithmetic operations on each 8-bit pixel
-of its input/output stream.  This is a
-.IR bw (5)
-file format.
-The pixel values range from 0 to 255 and are internally operated on
-in floating point form (unless the
-.I \-c
-option has been specified) so that dynamic range, truncation, and sign,
-are not a problem.  On output they are converted back to 8-bit unsigned
-values clipping to 0 and 255 if necessary.  The number of pixels clipped
-high and low, if any, are reported to standard error on completion.
-.PP
-If the
-.I -c
-option is specified, then intermediate results are stored as signed characters, though
-The command line arguments remain in floating point
-format.
-This is useful when one wishes to take advantage of wrap-around
-characteristics of binary mathematics.
-.PP
-Any number of operations can be given and they are applied in order.
-The choices are:
-.br
-.BI \-a\  val
-to add a value.
-.br
-.BI \-s\  val
-to subtract a value.
-.br
-.BI \-m\  val
-to multiply by a value.
-.br
-.BI \-d\  val
-to divide by a value.
-.br
-.B \-A
-to take to absolute value of each pixel.
-.br
-.BI \-e\  val
-to exponentiate, i.e. raise each pixel to the power
-.I val.
-.br
-.BI \-r\  val
-to take the
-.I val
-root of each pixel.
-.PP
-All arguments can be floating point values.  Note that this command
-can be applied to color
-.IR pix (5)
-files also,
-but no distinction can be made between color planes.
-.SH EXAMPLES
-The command
-.br
-.I bwmod\ \-m\-1\ \-a255\ \<\ file.bw\ \>\ file2.bw
-.br
-will produce the negative of a file by first multiplying by minus
-one, and then adding 255 to shift the pixels back into the 0->255 range.
-.PP
-One can apply a gamma factor to a file as follows:
-.br
-.I bwmod\ \-d255\ \-r2.2\ \-m255\ \<\ file.bw\ \>\ file2.bw
-.br
-which will first normalize the pixel values, then take the 2.2 root
-of each pixel, and finally scale it back to 0->255.
-[Note however that applying gammas this way is not recommended since
-a function call per pixel results!]
-.PP
-Suppose you ran bwstat on a file and found min=80, max=210, mean=100.
-If you wish to expand the range of intensities, while still preserving
-the mean, this can be done by:
-.I bwmod\ \-s100\ \-m1.409\ \-a100\ \<\ file.bw \>\ file2.bw
-.br
-Where 1.409 results from (255-100)/(210-100) which is what one would use
-by boost the max value (210) to full scale (255) after subtracting the
-mean (100).  Subtracting and adding 100 make the multiply occur
-"about that point", i.e value less than 100 will get smaller; those
-above, higher.
-.SH "SEE ALSO"
-brlcad(1), pix(5), bw(5)
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwrect.1
===================================================================
--- brlcad/src/util/bwrect.1	(revision 53937)
+++ brlcad/src/util/bwrect.1	(working copy)
@@ -1,69 +0,0 @@
-.TH BWRECT 1 BRL-CAD
-.\"                       B W R E C T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwrect \- extract a rectangle from a black and white bw file
-.SH SYNOPSIS
-.B bwrect
-infile outfile
-.SH DESCRIPTION
-.I Bwrect
-extracts a rectangular region from a black and white
-.IR bw (5)
-format file.
-The program prompts for the area to extract in x and y pixels,
-the scanline length of the input file in pixels, and the origin
-in the input file from which to extract.  First quadrant coordinates
-and file storage format are used.
-.SH "SEE ALSO"
-brlcad(1), bwcrop(1), bwscale(1), pixrect(1), bw(5)
-.SH BUGS
-We ought to allow the questions to be answered on the command line
-so that shell scripts, etc., could use this.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwrot.1
===================================================================
--- brlcad/src/util/bwrot.1	(revision 53937)
+++ brlcad/src/util/bwrot.1	(working copy)
@@ -1,114 +0,0 @@
-.TH BWROT 1 BRL-CAD
-.\"                        B W R O T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwrot \- rotate, invert, or reverse a black and white bw file
-.SH SYNOPSIS
-.B bwrot
-.RB [ \-rifb\ |\ \-a\  angle]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-o\  out.bw]
-[file.bw] [\>\ out.bw]
-.SH DESCRIPTION
-.I bwrot
-will rotate, vertically invert, and horizontally reverse a black and white
-.IR bw (5)
-format file or read from standard input if a file name is not given.  The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to same value via
-.I \-s.
-.PP
-The
-.B \-r
-flag reverses the scan lines left to right.
-.br
-The
-.B \-i
-flag inverts the image top to bottom.
-.br
-The
-.B \-f
-and
-.B \-b
-flag will rotate the image ninety degrees forward or backward respectively.
-The sense of the rotation is relative to a first quadrant coordinate
-system, i.e. origin lower left, where "forward" means clockwise.
-.PP
-Note that a 180 degree rotation can be obtained by both reversing
-and inverting.
-.PP
-If the
-.B \-a
-flag is used, the image will be rotated counterclockwise by the specified
-arbitrary angle.
-.PP
-The
-.B \-o
-option can be used to specify an output file instead of redirecting
-standard out.
-.SH METHOD
-A fairly large buffer is kept in memory so that, file size permitting,
-the entire rotation can occur without seeking on input or output.
-In any event, the algorithm is designed to process the input sequentially,
-so that if any seeking is required, it will happen on output only.  If
-these seeks fail, e.g. the output is a pipe, the user will be told that
-it needs a file on output.
-A more general solution to this problem would be to see if seeks can
-be done on input instead, and switch the algorithm to seek on input
-only.
-.SH "SEE ALSO"
-brlcad(1), pixrot(1), bwscale(5), bwrect(1), bw(5)
-.SH BUGS
-If the file size is very large, excessive seeking may occur on output
-and the rotation will take a very long time.  More complicated
-algorithms could remedy this.
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwshrink.1
===================================================================
--- brlcad/src/util/bwshrink.1	(revision 53937)
+++ brlcad/src/util/bwshrink.1	(working copy)
@@ -1,99 +0,0 @@
-.TH BWSHRINK 1 BRL-CAD
-.\"                     B W S H R I N K . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwshrink \- shrink a black and white bw file
-.SH SYNOPSIS
-.B bwshrink
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-f\  shrink_factor]
-.RB [ \-h ]
-.RB [ \-u ]
-[infile.bw] \>\ outfile.bw
-.SH DESCRIPTION
-.I Bwshrink
-will take a black and white
-.IR bw (5)
-format file of given dimensions and produce a smaller
-scaled version.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-Defaults of 512 are assumed for unspecified dimensions.
-The integer scaling factor is set with the
-.I \-f
-flag.  By default, the factor is 2.
-.PP
-The program reads the entire image into memory,
-and then scales the image down by
-to 1/factor the original size in both dimensions.
-
-
-By default, bwshrink uses boxcar averaging to produce the output pixels from
-the input.  The
-.I \-u
-option causes bwshrink to use image undersampling instead.
-.PP
-The
-.B \-h
-flag causes the file to be
-read in high resolution mode (1024x1024).
-.PP
-.SH "SEE ALSO"
-brlcad(1), bwcrop(1), bwrect(1), bwscale(1), bw(5).
-.SH BUGS
-If the dimensions of the input image are not evenly divisible by the shrink
-factor, incorrect and bizarre output is generated.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwstat.1
===================================================================
--- brlcad/src/util/bwstat.1	(revision 53937)
+++ brlcad/src/util/bwstat.1	(working copy)
@@ -1,92 +0,0 @@
-.TH BWSTAT 1 BRL-CAD
-.\"                       B W S T A T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwstat \- list statistics related to a black and white bw image.
-.SH SYNOPSIS
-.B bwstat
-.RB [ \-v ]
-[file.bw]
-.SH DESCRIPTION
-.I Bwstat
-will take the given
-.IR bw (5)
-format file,
-or read from standard in.  A collection of statistics
-related to the pixel intensities is produced.
-.br
-These include:
-.br
-The number of pixels (and the square root of this which is the
-file dimensions if square).
-.br
-The max and min values.
-.br
-The mean.
-.br
-The median (dividing line where half the pixels are above this
-value, half below).
-.br
-The mode (most frequently occurring value) and the number of pixels
-at this value.
-.br
-The variance, standard deviation, and skew.
-.PP
-The
-.B \-v
-flag will also dump a histogram of the pixel values.
-.SH METHOD
-Since the pixel values are quantized (have discrete values from
-0 to 255), the statistics can be computed from "lump sums" after
-building a histogram of the input.  This results in a fantastic
-savings in computation while also making a single pass over the input
-file sufficient.
-.SH "SEE ALSO"
-brlcad(1), bwhist(1), pixstat(1), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/bwthresh.1
===================================================================
--- brlcad/src/util/bwthresh.1	(revision 53937)
+++ brlcad/src/util/bwthresh.1	(working copy)
@@ -1,100 +0,0 @@
-.TH BWTHRESH 1 BRL-CAD
-.\"                     B W T H R E S H . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-bwthresh \- threshold a black-and-white bw file
-.SH SYNOPSIS
-.B bwthresh
-val ... < file.bw
-.SH DESCRIPTION
-.I Bwthresh
-reads from standard input a stream of black-and-white data in
-.IR bw (5)
-format
-and thresholds it among the
-.I vals,
-writing the resulting
-.IR bw (5)
-data to standard output.
-The
-.I vals
-must appear on the command line in strictly increasing order.
-.PP
-The grey scale 0..255 is divided evenly into
-.IR n +1
-bins,
-and each pixel of input is compared to the
-.I vals,
-to determine which of the
-.IR n +1
-grey levels should be output.
-.SH EXAMPLE
-The command
-.sp
-.in +5
-.I "bwthresh 37 143 < file.bw > file2.bw"
-.in -5
-.sp
-performs the following mapping:
-.sp
-.in +5
-if (pixel_in < 37)
-.in +2
-pixel_out = 0
-.in -2
-else if (pixel_in < 143)
-.in +2
-pixel_out = 128
-.in -2
-else
-.in +2
-pixel_out = 255
-.SH "SEE ALSO"
-bwmod(1), bwstat(1), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/cv.1
===================================================================
--- brlcad/src/util/cv.1	(revision 53937)
+++ brlcad/src/util/cv.1	(working copy)
@@ -1,94 +0,0 @@
-.TH CV 1 BRL-CAD
-.\"                           C V . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-cv \- convert binary data files between representation formats
-.SH SYNOPSIS
-.B cv
-in_pat out_pat [[infile] outfile]
-.SH DESCRIPTION
-Convert a binary data file from one representation (format) to another.
-The particular representation desired is expressed as a set of choices
-from the pattern: [h|n][s|u] c|s|i|l|d|8|16|32|64.
-For example, "hui" is host unsigned int, "nl" is network (signed) long.
-The default is NETWORK format.
-.P
-Host specific format is the native internal number representation used
-inside the computer that
-.B cv
-is running on.
-There is great variation between vendors in the host-specific formats
-that they use.
-Especially for double-precision floating point,
-DEC, Cray, and IBM have peculiar formats and byte orderings.
-The network-independent byte orderings used within BRL-CAD is
-big-endian (most significant bit first, on the left side of the word),
-twos compliment.
-The network-independent double-precision floating point format used
-within BRL-CAD is 64-bit IEEE 754, transmitted in big-endian order.
-.P
-Signed or unsigned integer formats can be selected.
-This has no effect on the double-precision format.
-.P
-"char", "short", "int", "long", and "double" provide their C language
-equivalent on this processor when used in "h" host-specific mode.
-"8", "16", "32", and "64" allow more precise specification of
-datum sizes for "n" network-independent mode.
-.P
-For example, to change a file of host-specific (machine-specific) signed
-shorts to a file of network-independent 32-bit integers, the input
-format would be "hss", and the output format would be "n32".
-.SH "SEE ALSO"
-pix-bw(1), dpix-pix(1), bw-pix(1).
-.br
-M. J. Muuss,
-\'\'\fIWorkstations, Networking, Distributed Graphics, and Parallel Processing\fR\'\'
-in Computer Graphics Techniques:  Theory and Practice,
-edited by D. F. Rogers, R. A. Earnshaw, Springer-Verlag, 1990.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/dbcp.1
===================================================================
--- brlcad/src/util/dbcp.1	(revision 53937)
+++ brlcad/src/util/dbcp.1	(working copy)
@@ -1,101 +0,0 @@
-.TH DBCP 1 BRL-CAD
-.\"                         D B C P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1993-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-dbcp \- double buffered copy
-.SH SYNOPSIS
-.B dbcp
-.RB [ \-v ]
-\fIblocksize\fR
-< infile > outfile
-.SH DESCRIPTION
-.I dbcp
-is a program for copying data rapidly between devices.
-.PP
-This command is DEPRECATED.  Use 'dd' instead.
-.PP
-While the primary application is to move data between raw devices such as
-tape and disk, it can also be used with pipes.
-No special support is required from the operating system;
-.I dbcp
-forks into two processes which communicate over a pair of regular pipes
-using a token passing scheme to
-synchronize their reading and writing activities.  They continue
-copying until an end of file or error is detected.
-.I dbcp
-reads from the standard input and copies to the standard output.
-The argument
-.I blocksize
-specifies the number of 512 byte "blocks" to be
-read or written in each record.
-.PP
-If the
-.B \-v
-flag is given,
-the number of records processed is printed upon exit.
-.SH EXAMPLES
-$ \fBdbcp 16 < /dev/rdk1a > /dev/rmt0\fR
-.br
-.I dbcp
-copies the filesystem on dk1a to tape
-with a record size of 8K bytes (16 * 512).
-This allows ``streaming'' tape drives to operate a peak speed.
-.PP
-$ \fBtar cf - . | dbcp 20 > /dev/rmt0\fR
-.br
-The
-.I tar
-process runs independently of the
-.IR dbcp ,
-which rapidly copies the data to tape
-with the usual
-.I tar
-tape record size of 10K bytes (20 * 512).
-.SH SEE ALSO
-cp(1), dd(1)
-.SH AUTHOR
-Douglas P. Kingston III (Davis, Polk, and Wardwell,
-Chase Manhattan Building, New York, NY)
-.SH COPYRIGHT
-This software is Copyright (c) 1993-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/decimate.1
===================================================================
--- brlcad/src/util/decimate.1	(revision 53937)
+++ brlcad/src/util/decimate.1	(working copy)
@@ -1,85 +0,0 @@
-.TH DECIMATE 1 BRL-CAD
-.\"                     D E C I M A T E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1992-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-decimate \- Reduce image or data file of MxN tuples to one of size IxJ
-.SH SYNOPSIS
-.B decimate
-nbytes/pixel width height [outwidth outheight]
-.SH DESCRIPTION
-.I decimate
-reads a file of
-.B width
-by
-.B height
-data items (each of which may be of arbitrary size
-as given by
-.B nbytes/pixel
-),
-and discards enough of them to result in an output file of
-.B outwidth
-by
-.B outheight
-items, both of which default to 512.
-If the input image size is not an integer multiple of the output
-image size, then the decimated result will be padded with zero
-elements (pixels) on the right and top to achieve an output image
-of exactly the specified size.
-.PP
-To process a
-.IR bw (5)
-format file, use a value of 1 for
-.BR nbytes/pixel .
-To process a
-.IR pix (5)
-format file, use a value of 3 for
-.BR nbytes/pixel .
-.SH "SEE ALSO"
-brlcad(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1992-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/dpix-pix.1
===================================================================
--- brlcad/src/util/dpix-pix.1	(revision 53937)
+++ brlcad/src/util/dpix-pix.1	(working copy)
@@ -1,64 +0,0 @@
-.TH DPIX-PIX 1 BRL-CAD
-.\"                     D P I X - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-dpix-pix \- convert a double precision dpix file to a pix file
-.SH SYNOPSIS
-.B dpix-pix
-file.dpix \>\ file.pix
-.SH DESCRIPTION
-Outputs a dpix file to pix (see
-.IR pix (5))
-format.  If the
-.B \-v
-option is given, a summary of plot command usage is given at the
-end of the file.  Standard input is read if a file name is not supplied.
-.SH "SEE ALSO"
-pl-pl(1), plrot(1), pl-fb(1), libplot3(3), plot(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/dunncolor.1
===================================================================
--- brlcad/src/util/dunncolor.1	(revision 53937)
+++ brlcad/src/util/dunncolor.1	(working copy)
@@ -1,116 +0,0 @@
-.TH DUNNCOLOR 1 BRL-CAD
-.\"                    D U N N C O L O R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\"
-.\" File name macro to make listing files easier
-.\"
-.de FN
-\fI\|\\$1\|\fP
-..
-.\"
-.\" Begin actual content
-.\"
-.SH NAME
-dunncolor \- set exposure values for a Dunn Model 631 camera
-.SH SYNOPSIS
-.B dunncolor
-.RB [ \-p ]
-baseval redval greenval blueval
-.SH DESCRIPTION
-.I Dunncolor
-sets the exposure values in the Dunn Instruments Model 631 camera
-to the specified values.
-If the
-.I -p
-flag is used, the Polaroid (8X10) exposure values are set.
-Otherwise, the auxiliary camera exposure values are set.
-.I baseval,
-.I redval,
-.I greenval,
-and
-.I blueval,
-are values between 0 and 255 used to calculate the exposure times for
-the red, green, and blue filters. The final value for each color is the
-product of
-.I baseval
-and the value for that color
-.RI ( redval ,
-.I greenval,
-or
-.IR blueval ).
-Exposure timing is based on the counting of vertical SYNC pulses.
-The final exposure value indicates the number of SYNC pulses for
-which the camera's monitor should be unblanked. At a 60 Hz rate,
-this means an exposure time of 1 second for every 60 SYNC pulses.
-.I Dunncolor
-reads the old values from the camera and prints them before setting the new values.
-The new values are then read from the camera and printed to verify that they have
-been changed. The five values printed are the exposure values for base, red,
-green, blue and black/white.
-.SH EXAMPLES
-35mm Kodachrome 64 at f/4, shaded images
-.RS
-\fIdunncolor 2 80 16 16\fR
-.RE
-35mm Kodachrome 64 at f/4, single-pixel wireframes, hires
-.RS
-\fIdunncolor 14 70 16 18\fR
-.RE
-16mm Video News Film 7250, f/8
-.RS
-\fIdunncolor 1 56 14 14\fR
-.RE
-Typically, red is 4X green and blue.
-.SH DIAGNOSTICS
-Diagnostics are intended to be self-explanatory.
-.SH FILES
-.TP
-.FN /dev/camera
-camera device supported by the operating system
-.SH "SEE ALSO"
-brlcad(1), dunnsnap(1)
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/dunnsnap.1
===================================================================
--- brlcad/src/util/dunnsnap.1	(revision 53937)
+++ brlcad/src/util/dunnsnap.1	(working copy)
@@ -1,152 +0,0 @@
-.TH DUNNSNAP 1 BRL-CAD
-.\"                     D U N N S N A P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\"
-.\" File name macro to make listing files easier
-.\"
-.de FN
-\fI\|\\$1\|\fP
-..
-.\"
-.\" Begin actual content
-.\"
-.SH NAME
-dunnsnap \- expose film in a Dunn Model 631 camera
-.SH SYNOPSIS
-.B dunnsnap
-.RB [ \-F\  framebuffer]
-.RB [ \-{sS}\  squarescrsize]
-.RB [ \-{wW}\  scr_width]
-.RB [ \-{nN}\  scr_height]
-.RB [ \-h ]
-[num_frames]
-.SH DESCRIPTION
-.I Dunnsnap
-checks the status of the Dunn Instruments Model 631 camera and
-then attempts to take
-.I num_frames
-exposures.  If
-.I num_frames
-is not supplied, the number of frames exposed defaults to one.
-Status of the camera is checked before every exposure.
-Limits on
-.I num_frames
-include your film budget and the mean time between
-failures of your computer, framebuffer and camera.
-.PP
-By default, the
-.I dunnsnap
-command operates independently of any framebuffer.
-The
-.B \-F
-flag causes the named framebuffer to be opened before exposure,
-and closed afterwards.
-This is intended for use with display systems like the SGI 4-D,
-which always run a window manager.
-The particular framebuffer options used could, for example,
-cause the image to blanket the whole screen, or
-change the video output to some other frequency.
-The behavior of the framebuffer options are specific to the
-type of device being used.
-.PP
-The
-.BI \-w\  scr_width
-and
-.BI \-W\  scr_width
-flags specifies the width of each scanline for the display device,
-in pixels.
-.PP
-The
-.BI \-n\  scr_height
-and
-.BI \-N\  scr_height
-flags specifies the height of each scanline for the display device.
-.PP
-.BI \-s\  squarescrsize
-and
-.BI \-S\  squarescrsize
-set both the height and width to the size given.
-.PP
-The
-.B \-h
-flag causes the frame buffer to be
-used in high resolution mode (1024x1024).
-This is important for frame buffers such as the Adage which operate
-differently depending on the display size.  Without this flag
-the default size for the selected device will be used (usually
-the entire screen).
-.PP
-The Dunn camera has been successfully operated while attached to
-an Adage (Ikonas) RDS-3000 framebuffer in both low-res (512\u2\d 60 Hz)
-and high-res (1024\u2\d 30 Hz) modes.
-The
-.PP
-The Dunn camera has also been successfully operated while attached to
-an SGI 4-D with a 4-wire RS-343 connection when the video is operated
-at 30 Hz.
-The picture should be loaded into /dev/sgi5 (Full screen, Shared memory),
-and then exposed with:
-
-.nf
-.RS
-dunnsnap -F /dev/sgi13 1
-.RE
-.fi
-
-Where /dev/sgi13 represents 30 Hz, Full Screen, and Shared memory bits.
-This keeps the main SGI display watchable while the images are loaded.
-.SH DIAGNOSTICS
-Diagnostics are intended to be self-explanatory.
-.SH FILES
-.TP
-.FN /dev/camera
-camera device supported by the operating system
-.SH "SEE ALSO"
-brlcad(1), dunncolor(1)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/gencolor.1
===================================================================
--- brlcad/src/util/gencolor.1	(revision 53937)
+++ brlcad/src/util/gencolor.1	(working copy)
@@ -1,72 +0,0 @@
-.TH GENCOLOR 1 BRL-CAD
-.\"                     G E N C O L O R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-gencolor \- output a pattern of byte values
-.SH SYNOPSIS
-.B gencolor
-.RB [ \-r #]
-[ val1 ... valN ]
-.SH DESCRIPTION
-.I Gencolor
-repeats a pattern of up to 8192 8-bit values on its standard output.
-The values, which range from 0 to 255, are taken either from the command
-line, or in binary from its standard input.  The
-.B \-r
-flag can be used to specify the number of times to repeat the given
-pattern, the default being infinity.
-This program is useful for producing a given grey value or
-color. Note that
-.I gencolor
-will refuse to write its output to a window, you must redirect the output to a file.
-.SH EXAMPLE
-.I gencolor -r512\ 0\ 255\ 0 \>\ foo.pix
-.br
-Will output 512 "green" pixels
-.SH "SEE ALSO"
-brlcad(1), pix(5), bw(5)
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/hex.1
===================================================================
--- brlcad/src/util/hex.1	(revision 53937)
+++ brlcad/src/util/hex.1	(working copy)
@@ -1,94 +0,0 @@
-.TH HEX 1 BRL-CAD
-.\"                           H E X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-hex \- Hexadecimal and ASCII dump
-.SH SYNOPSIS
-.B hex
-.I
-[
-.I \-o offset
-]
-[
-.I file .\|.\|.
-]
-.SH DESCRIPTION
-.I Hex
-reads each
-.I file
-in sequence and
-produces a dump on the standard output
-in hexadecimal and ASCII.  If no files are specified on the command
-line,
-.I hex
-checks to to be sure the standard input is not coming from a terminal
-before dumping from the standard input.
-.LP
-Input is
-dumped 16 bytes at a time.  The program displays the offset
-from the beginning of the file/input
-in hexadecimal, followed by
-the hexadecimal representations for the
-next 16
-bytes of data, and their ASCII character representations.  Non-printing
-characters are displayed as a period (".") in the ASCII section.  Vertical
-bars delimit the ASCII section.
-.LP
-If multiple files are specified on the command line, each file's name is
-printed before its dump.
-.LP
-.SH OPTIONS
-.TP
-.B \-o offset
-start printing at byte position
-.I offset
-instead of at the beginning of the data.
-.I Offset
-is rounded down to a multiple of 16.
-.SH SEE ALSO
-od
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/imgdims.1
===================================================================
--- brlcad/src/util/imgdims.1	(revision 53937)
+++ brlcad/src/util/imgdims.1	(working copy)
@@ -1,126 +0,0 @@
-.TH IMGDIMS 1 BRL-CAD
-.\"                      I M G D I M S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1997-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.SH NAME
-imgdims \- guess the width and height of an image file
-.SH SYNOPSIS
-.B imgdims
-.RB [ -ns ]
-.RB [ \-#\  bytes_per_pixel]
-file_name
-.br
-.B imgdims
-.RB [ \-#\  bytes_per_pixel]
-num_bytes
-
-.SH DESCRIPTION
-.I Imgdims
-uses the autosizing capability of
-.IR libbn "(5)"
-to guess the dimensions (in pixels)
-of an image.
-The image size may be expressed either implicitly,
-by specifying the name of the file,
-or explicitly,
-by specifying a number of bytes.
-
-The
-.B -n
-option
-specifies that
-the dimensions should be extracted directly from
-.IR file_name ,
-in the form of any of the standard BRL-CAD command-line options.
-Given the
-.B -s
-option,
-.I imgdims
-ignores any dimensions encoded in
-.I file_name
-and uses the size of the file in bytes
-to compute the number of pixels in the image
-and then guess the image's width and height.
-The
-.B -#
-option
-specifies the size of each pixel (in bytes).
-
-If
-.I file_name
-is specified with neither of the
-.BR -s " and " -n
-options,
-.I imgdims
-tries to extract the dimensions from
-.I file_name,
-and if that fails
-it computes the image size and guesses the width and height.
-If the
-.B -#
-option is not specified,
-.I imgdims
-determines the pixel size based on the extension on
-.I file_name.
-If, additionally,
-.I num_bytes
-was specified or
-.I file_name
-contains none of the recognized extensions,
-.I imgdims
-assumes that there are 3-byte-wide pixels.
-
-.SH SEE ALSO
-.IR libbn "(3)"
-
-.SH AUTHOR
-Paul Tanenbaum
-
-.SH COPYRIGHT
-This software is Copyright (c) 1997-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/loop.1
===================================================================
--- brlcad/src/util/loop.1	(revision 53937)
+++ brlcad/src/util/loop.1	(working copy)
@@ -1,120 +0,0 @@
-.TH LOOP 1 BRL-CAD
-.\"                         L O O P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1986-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-loop \- generate numerical indices for shell loops, etc.
-.SH SYNOPSIS
-.B loop
-start finish [increment]
-.SH DESCRIPTION
-.I Loop\^
-generates a sequence of numbers between
-.I start
-and
-.I finish
-inclusive, one per line, on stdout.
-This is mostly useful for driving loops when writing Shell programs
-.IR sh (1).
-The default increment is +1 when start<finish, and -1 when start>finish.
-An optional
-.I increment
-may be specified.
-If
-.I increment
-is zero, then the
-.I start
-value will be generated continuously.
-.P
-Both floating point and integer arguments can be used.  On
-integer arguments, if leading zeros are specified, they will
-be preserver on output.  This is useful for generating sequences
-of file names which are numbered with leading zeros.
-.SH EXAMPLES
-
-.nf
-.RS
-for i in `loop 10 30 5`
-do
-  echo $i
-done
-.RE
-.fi
-
-Will display the values 10, 15, 20, 25, and 30.
-.P
-
-.nf
-.RS
-for i in `loop 008 005`
-do
-  echo $i
-done
-.RE
-.fi
-
-Will display the values 008, 007, 006, 005.
-.P
-
-.nf
-.RS
-for i in `loop 0.1 2.9 0.5`
-do
-  echo $i
-done
-.RE
-.fi
-
-Will display the values 0.1, 0.6, 1.1, 1.6, 2.1, 2.6.
-.SH BUGS
-This program just scratches the surface.
-The shells could benefit from a greater ability to perform math.
-Limitless opportunities for extensions exist, but
-this simple version is adequate for most shell scripts
-dealing with sequences of images, etc.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1986-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/mac-pix.1
===================================================================
--- brlcad/src/util/mac-pix.1	(revision 53937)
+++ brlcad/src/util/mac-pix.1	(working copy)
@@ -1,121 +0,0 @@
-.TH MAC-PIX 1 BRL-CAD
-.\"                      M A C - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-mac\(hypix \- convert Apple MacPaint bitmap into pix(5) or bw(5) raster image
-.SH SYNOPSIS
-.B mac-pix
-.RB [ \-clb ]
-.RB [ \-s\  squareMacSize]
-.RB [ \-w\  Mac_width]
-.RB [ \-n\  Mac_height]
-.RB [ \-x\  Mac_xoff]
-.RB [ \-y\  Mac_yoff]
-.RB [ \-X\  output_xoff]
-.RB [ \-Y\  output_yoff]
-.RB [ \-S\  squareOutputSize]
-.RB [ \-W\  output_width]
-.RB [ \-N\  output_height]
-.RB [ \-C\  r/g/b]
-[file.mac]
-.SH DESCRIPTION
-.I Mac-pix
-reads an Apple MacIntosh MacPaint bitmap file and generates a
-.IR pix (5)
-or
-.IR bw (5)
-raster image file.
-While the MacPaint file is 720x576 pixels, it is possible to specify
-an alternate size input file with the
-.B \-s
-.B \-w
-and
-.B \-n
-flags;  the usefulness of this is unknown.
-By default, the output
-.IR pix (5)
-file is 1024x1024 pixels, with the input image located in the lower
-left corner of the output (nearest the origin).  The default color for
-an "on" pixel is white (R=G=B=255); alternatively, the
-.B \-C r/g/b
-flag can be used to specify intensities for each of the colors, in
-the range of [0..255].
-The
-.B \-b
-flag will output a
-.IR bw (5)
-black and white file instead.
-By specifying the
-.B \-c
-flag, the input image is centered in the middle of the output image.
-By specifying the
-.B \-l
-flag, the default output size is changed to 512x512.
-Alternatively, the
-.B \-S
-flag can be used to specify the square output size, or
-.B \-W
-and
-.B \-N
-flags can be used to specify the output width and height.
-If no input file is specified, standard input is read instead.
-.SH "EXAMPLES"
-Especially pleasing displays of MacPaint documents can be made by using
-.IR pixmerge (1)
-to combine them with the output of
-.IR pixbackgnd (1):
-.br
-.ft I
-pixbackgnd -h 160 200 > bg.pix
-.br
-mac-pix -c file.mac | pixmerge \(em bg.pix | pix-fb
-.ft R
-.SH "SEE ALSO"
-brlcad(1), pixmerge(1), pix(5), bw(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/morphedit.1
===================================================================
--- brlcad/src/util/morphedit.1	(revision 53937)
+++ brlcad/src/util/morphedit.1	(working copy)
@@ -1,163 +0,0 @@
-.TH MORPHEDIT 1 BRL-CAD
-.\"                    M O R P H E D I T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1996-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-morphedit \-
-set up line segment correspondences between pix(5) images
-.SH SYNOPSIS
-.B morphedit.tcl
-.RB [ \-w\ width ]
-.RB [ \-n\ height ]
-picA.pix picB.pix linesfile
-.SH DESCRIPTION
-.I morphedit
-allows the user to set up line segment correspondences to be used
-by the utility
-.I pixmorph.
-
-.br
-First, the program displays the two images and presents a dialog box
-in which the user can enter values for
-.I a, b,
-and
-.I p
-(see
-.I pixmorph(1)
-for details on these constants.)
-[Note: after replacing these values, the user must press <Enter> for
-the new values to be recorded.]
-
-The user is now editing the lines file
-.I linesfile.
-The purpose of writing a lines file is to set up correspondences between
-the two images to improve the quality of morphed images produced by
-utilities such as
-.I pixmorph.
-To set up a correspondence, the user must create a (directed) line segment
-for each image that specifies which feature of the first image
-corresponds to which feature of the second.  These directed line segments
-are created in the following fashion.
-
-To create the first endpoint of a new line segment, the user presses
-the left mouse button
-at the desired location in either image.  The point appears at the same
-location in the other image.  While the mouse button is held down, the
-endpoint may be dragged to any location (including off of the image...please
-do not misplace endpoints in this fashion -- they are very difficult to
-recover.)  Releasing the mouse button deposits the endpoint at that location.
-
-To specify the second endpoint, the user presses the left mouse button at a
-location in the image currently unoccupied by endpoints.  The line segment
-is drawn between the first and second endpoints;  and, as before,
-this endpoint may be dragged to any location.
-
-Endpoints may be created in pairs in this fashion.  Additionally, endpoints
-and line segments can be selected (by pressing the left mouse button while in
-the vicinity of the point or segment) and moved (by moving the mouse
-while the button is held) in either image as desired.
-
-To display the orientation of a line segment, the user moves the mouse
-cursor until it is over the line segment in question.  The first endpoints
-of the segments of both images appear white, and the second endpoints of the
-segments of both images appear black.  Specifying the wrong orientation
-of a line segment usually results in a poor -- albeit somewhat
-psychedelic -- morphed image, so users are encouraged to take advantage
-of this feature to verify that their line segment correspondences make sense.
-
-The "Save" button writes the currently displayed line segment correspondence
-set, along with the constants
-.I a, b,
-and
-.I p,
-to the file
-.I linesfile.
-The "Quit" button closes all associated windows and terminates the program.
-
-The "Preview" button, with corresponding
-.I fraction
-entry box, spawns a process to display the morph specified by the
-given fraction and the last *saved* version of
-.I linesfile.
-(Note: this currently uses the utilities
-.I pixmorph
-and
-.I pix\-fb.
-If the "Preview" button fails, verify that the paths to these
-utilities (specified in the first few lines of
-.I morphedit.tcl)
-are correct.
-
-Note:
-.I morphedit.tcl
-uses
-.I bwish
-instead of the standard Tcl/Tk
-.I wish,
-since
-.I bwish
-supports
-.I pix
-images while
-.I wish
-does not.  If you have difficulty running
-.I morphedit.tcl,
-make sure the first line of
-.I morphedit.tcl
-(giving the path to
-.I bwish)
-is correct.
-.SH EXAMPLES
-.ft I
-      morphedit.tcl face1.pix face2.pix lf
-.SH "SEE ALSO"
-brlcad(1), pixmorph(1), pix(5)
-.SH BUGS
-At this time, line segments cannot be deleted.
-Unwanted correspondences should be recycled elsewhere.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1996-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/orle-pix.1
===================================================================
--- brlcad/src/util/orle-pix.1	(revision 53937)
+++ brlcad/src/util/orle-pix.1	(working copy)
@@ -1,117 +0,0 @@
-.TH ORLE-PIX 1 BRL-CAD
-.\"                     O R L E - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-orle\(hypix \- convert old run-length encoded image to RGB pixel format
-.SH SYNOPSIS
-.B orle-pix
-.RB [ \-dv ]
-.RB [ \-b
-{
-.B rgbwBG
-}] [file.rle]
-.SH DESCRIPTION
-.I orle-fb\^
-decodes an old University of Utah standard (Edition-2)
-Run-Length Encoded (RLE) format file
-(saved with
-.IR fb-orle\^ (1),
-.IR pix-orle (1),
-or a similar program),
-converts it into
-.IR pix\^ (5)
-format, and writes it to standard out.
-If
-.I file.rle\^
-is not specified, standard input is read.
-.I orle-pix\^
-determines the type and size of the saved file (color or B&W)
-and acts accordingly.
-If a non-linear colormap is stored in the RLE file,
-is is applied to the pixels as they are output.
-.TP
-.B \-d
-Debug option, provides verbose description of file structure and
-processes called, written on standard error.
-.TP
-.B \-v
-Provides a verbose description of the parameters of the saved image
-on standard error.
-.TP
-.BI \-b x\^
-The background of the image is
-normally set to the value recorded in the RLE file.
-This option permits
-the user to specify an alternate background color from a limited
-set of colors.
-The character
-.I x
-can be any of
-.B r
-(red),
-.B g
-(green),
-.B b
-(blue),
-.B w
-(white),
-.B B
-(black), or
-.B G
-(18% grey).
-.TP
-.I file.rle\^
-Name of file to decode, in old RLE format.
-.SH EXAMPLE
-.RS
-\fI\|orle-pix \|tank.rle \|> tank.pix\fR
-.RE
-.SH "SEE ALSO"
-brlcad(1), fb-orle(1), fb-rle(1), pix-fb(1), rle-pix(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-alias.1
===================================================================
--- brlcad/src/util/pix-alias.1	(revision 53937)
+++ brlcad/src/util/pix-alias.1	(working copy)
@@ -1,85 +0,0 @@
-.TH PIX-ALIAS 1 BRL-CAD
-.\"                    P I X - A L I A S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix\(hyalias \- convert an image from pix format to Alias(tm) pix format
-.SH SYNOPSIS
-.B pix-alias
-.RB [ \-s\  squaresize ]
-.RB [ \-w\  file_width ]
-.RB [ \-n file_height ]
-< BRLpixfile > ALIASpixfile
-.SH DESCRIPTION
-.I pix\(hyalias
-converts the
-.I brl pix(5)
-format file on the standard input to an
-.I Alias pix
-format file on the standard output.
-.SH OPTIONS
-.TP
-.BI \-n\  file_height
-tells
-.I pix\(hyalias
-that the input is
-.I file_height
-scanlines tall
-.TP
-.BI \-s\  squaresize
-sets both the width and the height for the input to be
-.I squaresize
-.TP
-.BI \-w\  file_width
-tells
-.I pix\(hyalias
-that the input is
-.I file_width
-pixels wide
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-bw.1
===================================================================
--- brlcad/src/util/pix-bw.1	(revision 53937)
+++ brlcad/src/util/pix-bw.1	(working copy)
@@ -1,105 +0,0 @@
-.TH PIX-BW 1 BRL-CAD
-.\"                       P I X - B W . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix\(hybw \- combine pix color planes into a bw black and white image
-.SH SYNOPSIS
-.B pix-bw
-.RB [ \-ntsc ]
-.RB [ \-crt ]
-.RB [ \-R [num]]
-.RB [ \-G [num]]
-.RB [ \-B [num]]
-[in.pix]
-\>\ out.bw
-.SH DESCRIPTION
-.I Pix-bw
-will combine or select the color planes of a
-.IR pix (5)
-format
-file from its standard input
-and produce a black and white
-.IR bw (5)
-file on its standard output.
-By default all three colors are weighted equally.  The
-.B \-ntsc
-uses weighting based on the NTSC primaries and the D6500
-alignment white.  The
-.B \-crt
-flag applies weights for "typical" CRT phosphor chromaticities
-and the D6500 white.
-.PP
-Individual color plane(s) can be selected via the
-.B \-R\ \-G
-and
-.B \-B
-flags.
-If one or more of these flags is followed by a value,
-the value will be treated as a weight
-to be applied to that color
-This value is implicitly 1.0 divided by
-the number of colors selected for the flags which are not followed
-by a value.
-.SH EXAMPLES
-.I pix-bw\ \-R\ \-B\ \<\ file.pix\ \>\ file.bw
-.br
-will equally blend the red and blue color planes.
-.PP
-.I pix-bw\ \-R0.30\ \-G0.59\ \-B0.11\ \<\ file.pix\ \>\ file.bw
-.br
-has the same effect as the
-.B \-ntsc
-flag.
-.br
-[The
-.B \-crt
-weights are: 0.26, 0.66, 0.08]
-.SH "SEE ALSO"
-brlcad(1), pix-bw3(1), bw-pix(1), pix(5), bw(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-bw3.1
===================================================================
--- brlcad/src/util/pix-bw3.1	(revision 53937)
+++ brlcad/src/util/pix-bw3.1	(working copy)
@@ -1,66 +0,0 @@
-.TH PIX-BW3 1 BRL-CAD
-.\"                      P I X - B W 3 . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix\(hybw3 \- split up the color planes of a color pix file
-.SH SYNOPSIS
-.B pix-bw3
-redout greenout blueout \<\ file.pix
-.SH DESCRIPTION
-.I Pix-bw3
-reads a color
-.IR pix (5)
-format file
-and outputs the red, green, and blue color planes into the given
-files.  These files will then be in
-.IR bw (5)
-format.
-.SH "SEE ALSO"
-brlcad(1), bw3-pix(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-orle.1
===================================================================
--- brlcad/src/util/pix-orle.1	(revision 53937)
+++ brlcad/src/util/pix-orle.1	(working copy)
@@ -1,126 +0,0 @@
-.TH PIX-ORLE 1 BRL-CAD
-.\"                     P I X - O R L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix\(hyorle \- convert a pix format RGB file into old run-length encoded form
-.SH SYNOPSIS
-.B pix-orle
-.RB [ \-hdv ]
-.RB [ \-s\  squarefilesize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-.RB [file.pix]
-.RB [file.rle]
-.SH DESCRIPTION
-.I pix-orle\^
-saves a
-.IR pix (5)
-format image in a
-Run-Length Encoded (RLE) form,
-using the old University of Utah standard (Edition-2) format.
-This program is provided for compatibility with the old RLE image
-tools, and generally should not be used for saving new images,
-except where compatibility with the old tools is a factor.
-The equivalent new tool is
-.IR pix-rle(1) .
-.PP
-If
-.I file.pix\^
-is not specified, the
-.IR pix (5)
-file is read from standard in.
-If
-.I file.rle\^
-is not specified, the encoded file is written to standard out.
-.I pix-orle\^
-attempts to compress flat-colored areas
-as much as possible.
-This means that it is generally reasonable to save an entire image,
-since in RLE format it will not take up much more file space than
-extracting and saving only the
-interesting portion of the image.
-.TP
-.BI \-w\  file_width
-Specify the width (in pixels) of the scanlines in the input file.
-The default is 512.
-.TP
-.BI \-n\  file_height
-Specify the number of scanlines of input to be encoded.
-The default is 512.
-.TP
-.BI \-s\  squarefilesize
-Specify both the number of pixels per scanline and the number of
-scanlines in the file to process.
-.TP
-.B \-h
-``hires'' flag.
-Set both the height and width of the input to 1024.
-The default is 512x512.
-.TP
-.B \-v
-Verbose mode.
-The program will provide voluminous status information
-on standard error as it proceeds through encoding the image.
-.TP
-.B \-d
-Debug mode.
-.SH EXAMPLE
-.RS
-.ft I
-pix-orle \|\<plane.pix \|plane.rle
-.br
-pix-orle \|\-h \|car.pix \|car.rle
-.br
-pixfilter -f lo <truck.pix | pix-orle > truck-filt.rle
-.ft R
-.RE
-.SH "SEE ALSO"
-brlcad(1), rle-pix(1), pix-fb(1), pix-rle(1), fb-pix(1),
-librle(3), liborle(3).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-png.1
===================================================================
--- brlcad/src/util/pix-png.1	(revision 53937)
+++ brlcad/src/util/pix-png.1	(working copy)
@@ -1,115 +0,0 @@
-.TH PIX-PNG 1 BRL-CAD
-.\"                      P I X - P N G . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1998-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix-png	\- convert a BRL-CAD PIX format image to a PNG format image
-.SH SYNOPSIS
-.B pix-png
-.RB [ \-a ]
-.RB [ \-g gamma ]
-.RB [ \-s squaresize ]
-.RB [ \-w file_width ]
-.RB [ \-n file_height ]
-.RB [ \-o PNG_file ]
- [PIX_file]
-.RB [ > PNG_file ]
-.SH DESCRIPTION
-.I pix-png
-converts a
-.I BRL PIX(5)
-format file to a
-.I PNG
-(Portable Network Graphics) format file on the standard output. The
-PNG file created will be an RGB file with a bit-depth of 8 and a file
-gamma of 1.0.
-.LP
-PIX image files do not contain information about their size.  The size
-of the input PIX image file must be specified if the dimensions are
-not the default 512x512 size.
-.SH OPTIONS
-.TP
-.B \-a
-autosize the input file to determine file image height and width
-.TP
-.B \-g gamma
-sets the specified gamma correction value into the created PNG file.
-A value of 0.6 is a close approximation of PC display monitors.  A
-negative gamma value disables writing a gAMA chunk out entirely (and
-is the default).
-.TP
-.B \-s squaresize
-sets both the width and the height for the input to be
-.I squaresize
-.TP
-.B \-w file_width
-tells
-.I pix-png
-that the input is
-.I file_width
-pixels wide
-.TP
-.B \-n file_height
-tells
-.I pix-png
-that the input is
-.I file_height
-scanlines tall
-.TP
-.B \-o PNG_file
-tells
-.I pix-png
-to write image data to the specified
-.I PNG_file
-output file.  The
-.I pix-png
-command will not write out binary image data directly to a terminal
-device as a safeguard.
-.SH "SEE ALSO"
-brlcad(1), png-pix(1), pix-fb(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1998-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-ppm.1
===================================================================
--- brlcad/src/util/pix-ppm.1	(revision 53937)
+++ brlcad/src/util/pix-ppm.1	(working copy)
@@ -1,114 +0,0 @@
-.TH PIX-PPM 1 BRL-CAD
-.\"                      P I X - P P M . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 2009-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix-ppm	\- convert a BRL-CAD PIX or BW format image to a PPM format image
-.SH SYNOPSIS
-.B pix-ppm
-.RB [ \-a ]
-.RB [ \-s squaresize ]
-.RB [ \-w file_width ]
-.RB [ \-n file_height ]
-.RB [ \-# bytes_per_pixel ]
-.RB [ \-o PPM_file ]
- [PIX_file]
-.RB [ > PPM_file ]
-.SH DESCRIPTION
-.I pix-ppm
-converts a
-.I BRL PIX(5)
-format file to a
-.I PPM
-(Portable PixMap) format file on the standard output. The PPM file
-created will be either an RGB file with 3 bytes per pixel (default) or
-a B&W file with 1 byte per pixel
-.LP
-PIX image files do not contain information about their size.  The size
-of the input PIX image file must be specified if the dimensions are
-not the default 512x512 size.
-.SH OPTIONS
-.TP
-.B \-a
-autosize the input file to determine file image height and width
-.TP
-.B \-s squaresize
-sets both the width and the height for the input to be
-.I squaresize
-.TP
-.B \-w file_width
-tells
-.I pix-ppm
-that the input is
-.I file_width
-pixels wide
-.TP
-.B \-n file_height
-tells
-.I pix-ppm
-that the input is
-.I file_height
-scanlines tall
-.TP
-.B \-# bytes_per_pixel
-tells
-.I pix-ppm
-how many bytes there are per pixel in the input PIX or BW file.
-.TP
-.B \-o PPM_file
-tells
-.I pix-ppm
-to write image data to the specified
-.I PPM_file
-output file.  The
-.I pix-ppm
-command will not write out binary image data directly to a terminal
-device as a safeguard.
-.SH "SEE ALSO"
-brlcad(1), pix-png(1), pix-bw(1), bw-pix(1), pix-fb(1), pix(5), bw(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 2009-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-ps.1
===================================================================
--- brlcad/src/util/pix-ps.1	(revision 53937)
+++ brlcad/src/util/pix-ps.1	(working copy)
@@ -1,119 +0,0 @@
-.TH PIX-PS 1 BRL-CAD
-.\"                       P I X - P S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix-ps \- convert a color pix file to PostScript
-.SH SYNOPSIS
-.B pix-ps
-.RB [ \-e ]\ [ -c ]
-.RB [ \-L ]\ [ -h ]
-.RB [ \-s\  input_squaresize]
-.RB [ \-w\  input_width]
-.RB [ \-n\  input_height]
-.RB [ \-S\  inches_square]
-.RB [ \-W\  inches_width]
-.RB [ \-N\  inches_height]
-[infile.pix] \>\ outfile.ps
-.SH DESCRIPTION
-.I Pix-ps
-will take a color
-.IR pix (5)
-format file of given dimensions and produce a Postscript file
-on the standard output.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-The
-.I \-h
-flag is a shorthand for an input image size of 1024 square.
-If no input size is given, defaults of 512 are assumed.
-.PP
-By default the output PostScript image size is 6.75 inches.
-The
-.I \-c
-option will center it on a 8.5 x 11 inch page.
-If a different output size is desired,
-.I \-S
-.I \-W
-and
-.I \-N
-can be used to set the size in inches analogous to the input
-parameters.
-Finally,
-.I \-L
-selects landscape mode, i.e. rotates the output image by ninety degrees.
-.PP
-Encapsulated PostScript files can be generated via
-.I \-e.
-.SH EXAMPLES
-pix-ps -c image.pix > image.ps
-.sp
-Produces a 6.75 inch PostScript file from an 512x512 input image
-and centers it on an 8.5 x 11 inch page.
-.PP
-.sp
-pix-ps -e -w 1024 -n 768 image.pix > image.ps
-.sp
-Takes the file image.pix which has the dimensions of 1024 pixels wide
-by 768 pixel high, and produces an Encapsulated Postscript version
-of it.
-.PP
-.sp
-pix-ps -L -c -W 5.2 < image.pix > image.ps
-.sp
-Makes a PostScript file of the (assumed 512 square) image, with
-the output image 5.2 inches square, in landscape mode, centered
-on an 8.5 x 11 inch page.
-.SH "SEE ALSO"
-brlcad(1), bw-ps(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-rle.1
===================================================================
--- brlcad/src/util/pix-rle.1	(revision 53937)
+++ brlcad/src/util/pix-rle.1	(working copy)
@@ -1,85 +0,0 @@
-.TH PIX-RLE 1 BRL-CAD
-.\"                      P I X - R L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix-rle \- convert RGB pixel format image to Utah Raster Toolkit run-length encoded
-.SH SYNOPSIS
-.B pix-rle
-.RB [ \-h ]
-.RB [ \-C\ r/g/b ]
-.RB [ \-s\  square_file_size]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-[file.pix [file.rle]]
-.SH DESCRIPTION
-.I pix-rle
-decodes a
-.IR pix\^ (5)
-format file, converts it into a Utah Raster Toolkit
-Run-Length Encoded (RLE) format file format, and writes it to standard out.
-If
-.I file.pix\^
-is not specified, standard input is read.
-.TP
-.BI \-C r/g/b\^
-This option permits
-the user to specify a background color
-as slash separated decimal numbers in the range of 0 to 255,
-one each for the red, green, and blue channels.
-.TP
-.I file.pix\^
-Name of file to decode, in pix format.
-.TP
-.I file.rle\^
-Optional name of file to store RLE image in.
-.SH EXAMPLE
-.RS
-\fI\|pix-rle \|tank.pix \| tank.rle\fR
-.RE
-.SH "SEE ALSO"
-brlcad(1), fb-rle(1), fb-rle(1), pix-fb(1), rle-pix(1), pix(5).
-.SH AUTHOR
-Michael John Muuss
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pix-sun.1
===================================================================
--- brlcad/src/util/pix-sun.1	(revision 53937)
+++ brlcad/src/util/pix-sun.1	(working copy)
@@ -1,91 +0,0 @@
-.TH PIX-SUN 1 BRL-CAD
-.\"                      P I X - S U N . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pix\(hysun	\- convert a BRL PIX(5) format image to a Sun Rasterfile format
-.SH SYNOPSIS
-.B pix-sun
-.RB [ \-d ]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-< BRLpixfile > rasterfile
-.SH DESCRIPTION
-.I pix-sun
-converts the
-.I BRL PIX(5)
-format file on the standard input to a
-.I Sun Rasterfile
-format file on the standard output.  The rasterfile produced is a
-"standard" (as opposed to "byte encoded") image, with
-8 bits per pixel, with a palette of 256 colors.
-.SH OPTIONS
-.TP
-.B \-d
-use a dither map
-.TP
-.B \-n file_height
-tells
-.I pix-sun
-that the input is
-.I file_height
-scanlines tall
-.TP
-.B \-s squaresize
-sets both the width and the height for the input to be
-.I squaresize
-.TP
-.B \-w file_width
-tells
-.I pix-sun
-that the input is
-.I file_width
-pixels wide
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixbackgnd.1
===================================================================
--- brlcad/src/util/pixbackgnd.1	(revision 53937)
+++ brlcad/src/util/pixbackgnd.1	(working copy)
@@ -1,135 +0,0 @@
-.TH PIXBACKGND 1 BRL-CAD
-.\"                   P I X B A C K G N D . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixbackgnd \- generate a pix(5) shaded background
-.SH SYNOPSIS
-.B pixbackgnd
-.RB [ \-h ]
-.RB [ \-i ]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  width]
-.RB [ \-n\  height]
-.RB [ \-t\  title_height]
-.RB [ \-a\  top_inten]
-.RB [ \-b\  bottom_inten]
-hue saturation
-\>
-file.pix
-.PP
-.B pixbackgnd
-.RB [ \-h ]
-.RB [ \-i ]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  width]
-.RB [ \-n\  height]
-.RB [ \-t\  title_height]
-red green blue
-\>
-file.pix
-.SH DESCRIPTION
-.I Pixbackgnd
-generates a
-.IR pix (5)
-format shaded background on stdout suitable for
-making slides for a presentation on.
-The upper portion of the screen is reserved for a title area,
-and is drawn at constant intensity 240,
-followed by a 4 scanline white bar,
-after which the intensity smoothly decreases from 240 to 50.
-.I Hue
-and
-.I saturation
-are values from 0 to 255 and can be selected via
-.IR fbcolor (1).
-A hue of 160 is a pleasing blue.
-.PP
-By default, the title height is
-80 scanlines, or 90 scanlines if the
-.B \-h
-flag is set, but the
-.BI \-t\  title_height
-option may be used to specify another value.
-If
-.I title_height
-is set to zero, then the white bar
-is omitted as well, and the entire display is smoothly shaded.
-.PP
-By default, the display is assumed to be 512x512 pixels;
-by specifying the
-.B \-h
-flag, the output size is changed to 1024x1024.
-.PP
-By specifying the
-.B \-i
-flag, the scanlines will be written out in inverted order
-(i.e., top to bottom).
-This is mostly useful with programs like
-.IR cat-fb (1)
-.PP
-The
-.B \-a
-and
-.B \-b
-options can be used to set the top and bottom intensity,
-in the range of 0 to 255.
-By default, the top intensity is 240, and the bottom is 50.
-.SH EXAMPLES
-.ft I
-pixbackgnd 160 200\| | \| pixmerge fg.pix \(em | pix-fb
-.br
-pixbackgnd -t120 160 250
-.br
-pixbackgnd -i -t0 160 200 \| | \| cat-fb -O file.troff
-.ft R
-.SH "SEE ALSO"
-brlcad(1), fbcolor(1), pix-fb(1), pixmerge(1), cat-fb(1).
-.SH BUGS
-The starting and ending intensities should probably be an option.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixbgstrip.1
===================================================================
--- brlcad/src/util/pixbgstrip.1	(revision 53937)
+++ brlcad/src/util/pixbgstrip.1	(working copy)
@@ -1,116 +0,0 @@
-.TH PIXBGSTRIP 1 BRL-CAD
-.\"                   P I X B G S T R I P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixbgstrip \- strip smooth shaded background from a pix(5) file
-.SH SYNOPSIS
-.B pixbgstrip
-.RB [ \-ah ]
-.RB [ \-t\  thresh]
-.RB [ \-x\  x_offset_for_bg_pixel]
-.RB [ \-s\  squarefilesize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-[file.pix]
-.SH DESCRIPTION
-.I pixbgstrip
-reads a
-.IR pix (5)
-format file from the named file, or from
-standard input if no file is specified.
-For each scanline read, all pixels that match the color of the
-background pixel are converted to black =0/0/0,
-and then the new scanline is written on stdout.
-.PP
-The default X offset for the background pixel is zero (e.g.
-.BI \-x\ 0
-), but if the pixel at X offset zero is not the desired background
-(for example, if a border exists around the actual image), then
-another offset can be specified.
-.PP
-By default, a pixel will be replaced with black only if it exactly
-matches the value of the background pixel
-(e.g., the matching threshold is zero
-.BI \-t\  0
-).
-However, if the background is slightly noisy, it may be necessary to
-perform a slightly looser matching.  The threshold variable
-specifies how large a difference between an input pixel and the background
-pixel will still result in black being output.
-.PP
-By default, the
-.I pix
-file is assumed to be 512x512 pixels.
-Specifying the
-.B \-a
-flag causes the program to attempt to autosize.
-A table of common image sizes is consulted, and if any match
-the size of the input file, then the width and height values
-associated with that size will be used.
-Specifying the
-.B \-h
-flag changes the size to 1024x1024.
-.PP
-The
-.BI \-w\  file_width
-flag specifies the width of each scanline in the input file, in pixels.
-.PP
-The
-.BI \-n\  file_height
-flags specifies the height in scanlines of the input file.
-.PP
-.BI \-s\  squarefilesize
-sets both the height and width to the size given.
-.SH "SEE ALSO"
-pixbackgnd(1), pix-fb(1), fb-pix(1), libfb(3), pix(5)
-.SH DIAGNOSTICS
-If the
-.I pix
-file is shorter than expected, the program exits silently.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixblend.1
===================================================================
--- brlcad/src/util/pixblend.1	(revision 53937)
+++ brlcad/src/util/pixblend.1	(working copy)
@@ -1,125 +0,0 @@
-.TH PIXBLEND 1 BRL-CAD
-.\"                     P I X B L E N D . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1995-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixblend \-
-blend two pix(5) or bw(5) images
-.SH SYNOPSIS
-.B pixblend
-.RB [ \-{r|i}\ value ]
-.RB [ -s\ seedval ]
-.RB [ -S ]
-file1.pix file2.pix > out.pix
-.SH DESCRIPTION
-.I pixblend
-Given two streams of data, typically
-.IR pix (5)
-or
-.IR bw (5)
-images,
-generate a "blended" output stream of the same size.
-This routine operates on a pixel-by-pixel basis, and thus
-is independent of the resolution of the image.
-The type of blending performed
-is determined by the following options:
-.SH OPTIONS
-.TP
-.BI \-r " VALUE"
-This specifies random blending; for each pixel of the output stream,
-a number will be chosen uniformly from the interval [0, 1). If this
-number exceeds VALUE,
-then the pixel from the first image will be output; otherwise, the pixel
-from the second image will be output.  Note that if VALUE is 0, then
-the output will equal the first image; if VALUE is 1, then the output
-will equal the second image.
-.PP
-.TP
-.BI \-i " VALUE"
-This specifies linear interpolation; for each pixel of the output
-stream, the interpolated pixel
-((1.0 - VALUE) * pixel1 + VALUE * pixel2)
-will be output (where
-pixel1 and pixel2 are the corresponding pixels from file1 and file2,
-respectively.)  Note that if VALUE is 0, then the output will equal the
-first image; if VALUE is 1, then the output will equal the second
-image.
-.PP
-.TP
-.BI \-s " SEEDVAL"
-By default,
-.I pixblend
-uses the value 0 as the random number seed.
-With the \-s option the user may set the random number seed to SEEDVAL.
-.PP
-.TP
-.BI \-S
-Instructs
-.I pixblend
-to use bits from the clock as a random number seed.
-.PP
-.TP
-.BI \-g " GVALUE"
-Tells
-.I pixblend
-to "glitterize" the image; if the random draw for a pixel is below
-GVALUE, then the pixel output is white; otherwise, the pixel used is
-determined by the ratio set with the \-r option (see above.)
-.PP
-.ft R
-.SH EXAMPLES
-.ft I
-      pixblend -i .25 source.pix destination.pix > out.pix
-.ft I
-      pixblend -r .75 source.pix destination.pix > out.pix
-.ft I
-      pixblend -r .5 -s source.pix destination.pix > out.pix
-.ft I
-      pixblend -r .5 -s 23 source.pix destination.pix > out.pix
-.SH "SEE ALSO"
-brlcad(1), gencolor(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1995-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixborder.1
===================================================================
--- brlcad/src/util/pixborder.1	(revision 53937)
+++ brlcad/src/util/pixborder.1	(working copy)
@@ -1,161 +0,0 @@
-.TH PIXBORDER 1 BRL-CAD
-.\"                    P I X B O R D E R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1996-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.SH NAME
-pixborder \- add a 1-pixel-wide border to regions of a specified color
-.SH SYNOPSIS
-.B pixborder
-.RB [ \-b\  "'R\ G\ B']"
-.RB [ \-e\  "'R\ G\ B']"
-.RB [ \-i\  "'R\ G\ B']"
-.RB [ \-t\  "'R\ G\ B']"
-.RB [ \-B\  "'H\ S\ V']"
-.RB [ \-E\  "'H\ S\ V']"
-.RB [ \-I\  "'H\ S\ V']"
-.RB [ \-T\  "'H\ S\ V']"
-.RB [ \-x\  left_edge]
-.RB [ \-y\  bottom_edge]
-.RB [ \-X\  right_edge]
-.RB [ \-Y\  top_edge]
-.RB [ \-ah ]
-.RB [ \-n\  file_height]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  file_width]
-[file.pix]
-.SH DESCRIPTION
-.I Pixborder
-reads an input stream of
-.I pix
-data,
-looking for maximal contiguous regions of
-a specified interior color,
-and writes out the
-.I pix
-data
-with all pixels on the boundaries of these regions changed to
-a specified border color.
-
-The way
-.I pixborder
-decides if a given pixel is on the boundary
-depends on how the user specified the interior and exterior.
-The
-.B -i
-option causes
-.I pixborder
-to replace
-the default interior color of 255 255 255 by
-.IR "R G B" ,
-while the
-.B -I
-replaces it by
-.IR "H S V" ,
-which are reals,
-with
-\fIH\fR in [0,\ 360)
-and
-\fIS\fR, \fIV\fR in [0,\ 1].
-Similarly,
-the
-.BR -e " and " -E
-options
-replace the default exterior color of 1 1 1.
-If the user specified colors for both or neither
-of the interior and exterior,
-then a pixel is on the boundary provided that
-it has the interior color
-and at least one of its four neighbors
-(left, right, above, and below) has the exterior color.
-If,
-on the other hand,
-the user specified only the interior (exterior) color,
-then a pixel is on the boundary provided that
-it has the interior color (does not have the exterior color)
-and at least one of its neighbors
-does not have the interior color (has the exterior color).
-
-Variability in the interior and exterior colors
-may be accommodated by the
-.BR -t " and " -T
-options,
-with which one specifies a symmetric tolerance
-for each of the red, green, and blue channels
-or hue, saturation, and value.
-Any color
-within the specified tolerance of the nominal interior (exterior) color
-is treated as though it were the nominal color.
-
-Changes are restricted to a specified rectangular portion of the image,
-which defaults to the entire image.
-The
-.B -x
-option sets the left edge of that rectangle:
-no pixels to the left of this edge are changed.
-The
-.BR -X ", " y ",  and " Y
-options respectively
-set the right, bottom, and top edges
-in the same manner.
-
-.SH HINT
-To obtain borders more than one pixel wide,
-one can run several copies of
-.I pixborder
-in a pipeline.
-In doing this
-to get, for instance, a border made up of constant-thickness
-segments of different colors,
-one should produce all the segments of a given layer
-before beginning any segments of the next inner layer.
-.SH AUTHOR
-Paul Tanenbaum
-
-.SH COPYRIGHT
-This software is Copyright (c) 1996-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixbustup.1
===================================================================
--- brlcad/src/util/pixbustup.1	(revision 53937)
+++ brlcad/src/util/pixbustup.1	(working copy)
@@ -1,88 +0,0 @@
-.TH PIXBUSTUP 1 BRL-CAD
-.\"                    P I X B U S T U P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixbustup \- break up concatenated pix images into separate files
-.SH SYNOPSIS
-.B pixbustup
-basename width
-[image_offset]
-[first_number]
-\<\ input.pix
-.SH DESCRIPTION
-.I Pixbustup
-takes input consisting of a concatenated collection of
-.IR pix (5)
-format files
-and breaks them up into separate files.  The output file names will be
-of the form
-.IR basename.num ,
-where
-.I basename
-is given on the command line, and
-.I num
-is a consecutive series of integers.  By default the first image
-will be made number `` 0 '', but an alternate
-.I first_number
-can be given.
-The images must be square and the width (and height) is given by
-.IR width .
-The program keeps reading these small files until end of file
-is reached.
-If one does not wish to extract from the beginning of the input file an
-.I image_offset
-can be given which will skip that number of images before beginning.
-.PP
-This program is mostly a holdover from the days when
-.IR rt (1)
-wrote animations into
-one huge file, but it is still sometimes useful.
-.SH "SEE ALSO"
-brlcad(1), rt(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixclump.1
===================================================================
--- brlcad/src/util/pixclump.1	(revision 53937)
+++ brlcad/src/util/pixclump.1	(working copy)
@@ -1,108 +0,0 @@
-.TH PIXCLUMP 1 BRL-CAD
-.\"                     P I X C L U M P . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1997-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.SH NAME
-pixclump \- quantize the colors in a pix(5) stream
-.SH SYNOPSIS
-.B pixclump
-.RB [ \-c\  R/G/B]
-.RB [ \-f\  color_file]
-.RB [ \-x\  debug_flags]
-[infile.pix [outfile.pix]]
-
-.SH DESCRIPTION
-.I Pixclump
-reads an input stream of
-.I pix
-data,
-converts each pixel to one of a set of specified colors,
-and writes out these quantized pixels.
-
-The colors
-may be specified
-either on the command line,
-with one
-.B -c
-option per color,
-or in a file specified with the
-.B -f
-option.
-
-Each pixel in the input stream
-is compared to all of the specified colors
-and replaced on the output by the specified color most resembling it.
-.I Pixclump
-computes the difference between an input pixel and a specified color
-as the sum of the squares of the differences in their respective
-red, green, and blue channels.
-
-The
-.B -x
-option may be used to selectively enable
-various diagnostic print statements.
-
-.SH HINT
-A typical use for
-.I pixclump
-is in renormalizing an image.
-For example,
-if a tool such as
-.I pixscale
-has been used to transform
-an image containing a relatively small number of colors,
-.I pixclump
-will change pixels whose colors have been interpolated
-back to one of the original colors.
-
-.SH AUTHOR
-Paul Tanenbaum
-
-.SH COPYRIGHT
-This software is Copyright (c) 1997-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixcolors.1
===================================================================
--- brlcad/src/util/pixcolors.1	(revision 53937)
+++ brlcad/src/util/pixcolors.1	(working copy)
@@ -1,67 +0,0 @@
-.TH PIXCOLORS 1 BRL-CAD
-.\"                    P I X C O L O R S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixcolors	\- Count/list color values used in a PIX(5) format image
-.SH SYNOPSIS
-.B pixcolors
-.RB [ \-v ]
-< pixfile
-.SH DESCRIPTION
-.I Pixcolors
-reports on the standard output the number of distinct colors used in the
-.I pix(5)
-format file on the standard input.
-.SH OPTIONS
-.TP
-.BI \-v
-Causes a sorted list of the unique colors
-used to be printed on standard output in addition to the count report.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixcut.1
===================================================================
--- brlcad/src/util/pixcut.1	(revision 53937)
+++ brlcad/src/util/pixcut.1	(working copy)
@@ -1,187 +0,0 @@
-.TH PIXCUT 1 BRL-CAD
-.\"                       P I X C U T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1992-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixcut \- extract a pix file from another pix file
-.SH SYNOPSIS
-.B pixcut
-.RB [ \-v]
-.RB [ \-h]
-.RB [ \-H]
-.RB [ \-a]
-.RB [ \-C\  red/green/blue]
-.RB [ \-s\  in_square_size]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-S\  out_square_size]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-.RB [ \-x\  horizontal]
-.RB [ \-y\  vertical]
-.RB [ infile]
-.SH DESCRIPTION
-.I Pixcut
-will extract a color
-.IR pix (5)
-format file from another
-.IR pix (5)
-format file.
-
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-Unspecified dimensions default to 512 pixels.
-.PP
-The
-.I \-W
-and
-.I \-N
-flags specify the output file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-S.
-Unspecified dimensions default to 512 pixels.
-.PP
-The
-.B \-h
-and
-.B \-H
-flags indicate that the input and/or output file is high
-resolution (1024x1024) respectfully.
-.PP
-The
-.B \-a
-flag requests that the program attempt to autosize the input file.  Autosizing
-only works with files, pipes can not be autosized.
-.PP
-The
-.B \-v
-flag requests verbose mode.  When verbose mode is selected the program
-will display information on default background output if any background
-is generated.
-.PP
-The
-.I \-x
-and
-.I \-y
-flags set the horizontal and vertical offsets from the lower left corner
-to use for extracting
-the image.  By default both are set to 0 (zero).
-.PP
-The
-.I \-C
-flag is used to set the background color of the output file.  If the
-output file is larger than the input file or if the corners of the output
-file do not reside within the bounds of the input file, the program will
-output pixels of background color for those locations.
-.PP
-First quadrant coordinates
-and file storage formats are used.
-.PP
-.SH EXAMPLES
-The command
-
-.nf
-.RS
-pixcut -S256 file1.pix > file2.pix
-.RE
-.fi
-
-will extract the lower left quadrant of "file1.pix" and place it in
-file2.pix.
-.PP
-The command
-
-.nf
-.RS
-pixcut -S256 -x128 -y128 file1.pix >file2.pix
-.RE
-.fi
-
-will extract the center of the 512x512 input file (file1.pix) and place
-it in file2.pix.
-.PP
-The command
-
-.nf
-.RS
-pixcut -x -1 file1.pix >file2.pix
-.RE
-.fi
-
-will shift file1.pix one pixel to the right.  If a raytrace was done with
-default parameters, the background (rays which do not intersect the model)
-are set to 0/0/1.  Since
-.I pixcut
-will fill with 0/0/1 the net result is that the model image is shifted.
-.PP
-The command
-
-.nf
-.RS
-pixcut -h -x128 -y256 background.pix |
-pixmatte -w512 -e image.pix =0/0/1 - image.pix |
-pixpaste -h -x128 -y256 background.pix - >new.pix
-.RE
-.fi
-
-will extract the center 512x512 section of the 1024x1024 background image
-composite that section with a foreground image and the place the new
-composite image into the center of the background image.
-.PP
-The
-.I pixmatte
-command options instruct the program that for every pixel in image.pix
-which is equal (-e) to 0/0/1 to output the corresponding pixel from
-standard input and for all others, output the corresponding pixel from
-image.pix
-.SH "SEE ALSO"
-brlcad(1), pixpaste(1), bwrect(1), pix(5), bw(5)
-.SH AUTHOR
-Christopher T. Johnson (Paladin Software, P.O. Box 187, Aberdeen, MD  21001-0187)
-.SH COPYRIGHT
-This software is Copyright (c) 1992-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixdiff.1
===================================================================
--- brlcad/src/util/pixdiff.1	(revision 53937)
+++ brlcad/src/util/pixdiff.1	(working copy)
@@ -1,81 +0,0 @@
-.TH PIXDIFF 1 BRL-CAD
-.\"                      P I X D I F F . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixdiff \- highlight pixel colors which differ between two files
-.SH SYNOPSIS
-.B pixdiff
-file1.pix file2.pix \>\ out.pix
-.SH DESCRIPTION
-.I Pixdiff
-highlights the pixels which differ between two color
-.IR pix (5)
-format files.
-The input files are read pixel by pixel and if any of the color
-planes red, green, or blue differ, those colors are specially marked.
-Bytes that differ by +/-1 are drawn with intensity 192, bytes
-that differ more are displayed at
-full intensity of 255.  If none of the color values differ, an NTSC
-converted black
-and white equivalent at one half the original intensity is displayed.
-This is to aid in seeing where in the image the different pixels lie.
-Upon completion,
-.I pixdiff
-reports the number of bytes matching, the number off by 1, and the number
-off by many.
-.PP
-Also see
-.IR bwdiff (1)
-which can still be used on
-.I pix
-files, yet can produce different kinds
-of output.
-.SH "SEE ALSO"
-brlcad(1), bwdiff(1), pix-fb(1), pixstat(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixdsplit.1
===================================================================
--- brlcad/src/util/pixdsplit.1	(revision 53937)
+++ brlcad/src/util/pixdsplit.1	(working copy)
@@ -1,177 +0,0 @@
-.TH PIXDSPLIT 1 BRL-CAD
-.\"                    P I X D S P L I T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1996-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\" Set the interparagraph spacing to 1 (default is 0.4)
-.PD 1v
-.\"
-.\" The man page begins...
-.\"
-.\"
-.SH NAME
-pixdsplit \- disentangle chars from doubles in a
-.IR pixd (5)
-stream
-.\"
-.SH SYNOPSIS
-.BR pixdsplit " [options] [infile]"
-.\"
-.SH DESCRIPTION
-.I Pixdsplit
-separates out interwoven characters and doubles
-from a single input stream.
-It treats the stream as consisting of successive ``pixels'',
-each of which is made up of
-.I n
-unsigned chars
-followed by
-.I m
-64-bit doubles,
-and writes the chars to one output stream
-and the doubles to another.
-The pixels are read from
-.I infile
-if it is specified;
-otherwise,
-.I pixdsplit
-reads from the standard input.
-
-.SS Options
-The command-line options and their meanings are:
-.\"
-.TP 12
-.BI -c " charfile"
-Causes
-.I pixdsplit
-to write the chars to the specified file.
-If
-.I charfile
-is the empty string,
-then
-.I pixdsplit
-does not write out the chars.
-Default is ``-'',
-so the chars are written to the standard output.
-.\"
-.TP 12
-.BI -d " doublefile"
-Causes
-.I pixdsplit
-to write the doubles to the specified file.
-If
-.I doublefile
-is the empty string,
-then
-.I pixdsplit
-does not write out the doubles.
-Default is ``'',
-so the doubles are not output.
-.\"
-.TP 12
-.BI -# " n.m"
-Defines a pixel to be made up of
-.I n
-unsigned chars and
-.IR m
-64-bit doubles,
-where
-.IR n " and " m
-are positive integers.
-Either of
-.IR n " and " m
-(but not both)
-may be omitted
-and if
-.I m
-is omitted,
-then the separating period, too, may be omitted.
-The variable for which a value was omitted
-retains its previous value.
-By default,
-.IR n " = 3"
-and
-.IR m " = 1",
-so
-the input stream is assumed to be in
-.IR pixd (5)
-format
-as produced by the
-.I "-d"
-option of
-.IR rt (1).
-.\"
-.SH EXAMPLES
-The command
-
-.nf
-.in +4
-pixdsplit file.pixd | pix-fb
-.in -4
-.fi
-
-extracts the
-.IR pix (5)
-data from
-.I file.pixd,
-sending it for display to
-.IR pix-fb (1),
-while
-
-.nf
-.in +4
-pixdsplit -# 3.2 -c '' -d coords datafile
-.in -4
-.fi
-
-ignores the RGB information in
-.I datafile
-but writes its pairs of doubles to
-.I coords.
-.SH SEE ALSO
-.IR rt "(1), " pix "(5), " pixd (5)
-.SH AUTHOR
-Paul Tanenbaum
-
-.SH COPYRIGHT
-This software is Copyright (c) 1996-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixfade.1
===================================================================
--- brlcad/src/util/pixfade.1	(revision 53937)
+++ brlcad/src/util/pixfade.1	(working copy)
@@ -1,78 +0,0 @@
-.TH PIXFADE 1 BRL-CAD
-.\"                      P I X F A D E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixfade \- darken a pix file
-.SH SYNOPSIS
-.B pixfade
-.RB [ \-f\  fraction]
-.RB [ \-m\  max]
-.RB [ \-p\  percentage]
-[infile.pix] \>\ outfile.pix
-.SH DESCRIPTION
-.I pixfade
-darkens a color pix file by fading the entire image a fractional amount
-or by using a pixel value as a maximum level.
-.PP
-The
-.B \-f
-option specifies a nonnegative fractional multiplier which is used
-to scale the red, green, and blue values of each pixel.  In a similar
-way, the
-.B \-p
-option is used to specify the multiplier as a nonnegative percentage.
-.PP
-An alternative way to darken the image is to specify a ceiling pixel
-level (0 - 255) with the
-.B \-m
-option.  The pixel plotted is the minimum of the ceiling value and the
-red, green, and blue levels of the pixel.
-.SH "SEE ALSO"
-brlcad(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixfilter.1
===================================================================
--- brlcad/src/util/pixfilter.1	(revision 53937)
+++ brlcad/src/util/pixfilter.1	(working copy)
@@ -1,121 +0,0 @@
-.TH PIXFILTER 1 BRL-CAD
-.\"                    P I X F I L T E R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixfilter \- apply a 3x3 filter to a color pix file
-.SH SYNOPSIS
-.B pixfilter
-.RB [ \-f\  type]
-.RB [ \-v ]
-.RB [ \-d\  div]
-.RB [ \-o\  offset]
-.RB [ \-w\  width]
-.RB [ \-n\  height]
-.RB [ \-s\  squaresize]
-[file.pix]
-\>\ newfile.pix
-.SH DESCRIPTION
-.I Pixfilter
-applies one of several 3x3 kernel filters to a color
-.IR pix (5)
-format file.
-It will take a file name or else read from standard input.
-The input file size will be assumed to be 512 by 512 pixels
-unless the
-.BR \-w ,
-and/or
-.BR \-n ,
-or the
-.B \-s
-flags are used to tell it otherwise.
-By default a low pass filter is used.  The
-.BI \-f\  type
-flag can be used to specify a different type of filter.
-.PP
-The
-.I type
-choices include:
-.TP
-.B lo
-low pass, the default.
-.TP
-.B hi
-high pass
-.TP
-.B vg
-vertical gradient
-.TP
-.B hg
-horizontal gradient
-.TP
-.B la
-laplacian
-.TP
-.B b
-boxcar low pass
-.PP
-Most filters divide the result of the kernel multiplication
-by some value in order to scale it back to a 0->255 range.
-For example, the boxcar divides by nine.  The
-.B -d
-flag can be used to change this divisor.
-Some filters also add an offset to their results.  The output of
-a laplacian for example is "centered" about zero, thus it
-adds 128 to the answer to yield a difference from neutral grey.
-The
-.B \-o
-flag can be used to change this offset.
-.PP
-The
-.B \-v
-flag displays the kernel values on standard error.
-.SH "SEE ALSO"
-brlcad(1), pixscale(1), pix(5)
-.SH BUGS
-This should allow any 3x3 kernel to be specified.
-
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixhalve.1
===================================================================
--- brlcad/src/util/pixhalve.1	(revision 53937)
+++ brlcad/src/util/pixhalve.1	(working copy)
@@ -1,83 +0,0 @@
-.TH PIXHALVE 1 BRL-CAD
-.\"                     P I X H A L V E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixhalve \- halve a color pix file
-.SH SYNOPSIS
-.B pixhalve
-.RB [ \-a ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-h ]
-[infile.pix] \>\ outfile.pix
-.SH DESCRIPTION
-.I Pixhalve
-will take a color
-.IR pix (5)
-format file of given dimensions and reduce the resolution of the file
-by one half in each direction using a 5x5 pyramid filter.  If a file name
-is not given, standard input will be used.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-Defaults of 512 are assumed for unspecified dimensions.
-.PP
-The
-.B \-h
-flag indicates the input file is
-high resolution (1024x1024).
-.PP
-.SH "SEE ALSO"
-brlcad(1), pixcrop(1), pixrect(1), pixinterp2x(1), pixscale(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixhist.1
===================================================================
--- brlcad/src/util/pixhist.1	(revision 53937)
+++ brlcad/src/util/pixhist.1	(working copy)
@@ -1,85 +0,0 @@
-.TH PIXHIST 1 BRL-CAD
-.\"                      P I X H I S T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixhist \- display a histogram of a color pix file on a framebuffer
-.SH SYNOPSIS
-.B pixhist
-.RB [ \-v ]
-.RB [file.pix]
-.SH DESCRIPTION
-.I Pixhist
-displays a histogram of the pixel values of the given
-.IR pix (5)
-format file, or, if no file is specified, will read from standard in.
-The environment
-variable
-.B
-.SM FB_FILE
-is used to select the display device (see
-.IR brlcad (1)).
-If this variable is not set, the default device for your system will
-be used.
-.PP
-The relative frequency is displayed on the x axis scaled so that
-the maximum is full screen.  The value 0 is at the bottom of the
-screen, 255 is at the top.
-All three colors will be drawn on each scan line, and all are scaled
-by the same factor.
-.br
-The output is overlaid on whatever is currently on the display.
-.PP
-The
-.B \-v
-flag will also output the histogram values on the terminal.
-.SH "SEE ALSO"
-brlcad(1), pixhist3d(1), pixstat(1), pix(5)
-.SH BUGS
-This program assumes it has at least 512 lines in y to work with.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixhist3d-pl.1
===================================================================
--- brlcad/src/util/pixhist3d-pl.1	(revision 53937)
+++ brlcad/src/util/pixhist3d-pl.1	(working copy)
@@ -1,76 +0,0 @@
-.TH PIXHIST3D-PL 1 BRL-CAD
-.\"                 P I X H I S T 3 D - P L . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixhist3d\(hypl \- output RGB color space utilization in 3D unix-plot
-form
-.SH SYNOPSIS
-.B pixhist3d-pl
-[file.pix] | plot
-.SH DESCRIPTION
-.I Pixhist3d-pl
-takes a color
-.IR pix (5)
-format file
-and outputs points for each RGB color occurring in the image.
-The format of these points is the BRL extended three dimensional UNIX
-plot (see
-.IR libplot3 (3)).
-A red, green, and blue line is drawn along the edges of the
-color space indicating the coordinate axis.  The resolution of the
-color space is 128x128x128, i.e. the least significant bit of each
-color plane is ignored.
-.PP
-These plots are best viewed on an interactive 3D UNIX plot display
-program, so that the color cube can be viewed from all angles.
-Anomalies in the colors of an image can often be seen, e.g.
-oversaturation resulting in intensity clipping.
-.SH "SEE ALSO"
-brlcad(1), pixhist3d(1), pixhist(1), libplot3(3), pl-fb(1), pl-sgi(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixhist3d.1
===================================================================
--- brlcad/src/util/pixhist3d.1	(revision 53937)
+++ brlcad/src/util/pixhist3d.1	(working copy)
@@ -1,85 +0,0 @@
-.TH PIXHIST3D 1 BRL-CAD
-.\"                    P I X H I S T 3 D . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixhist3d \- display RGB color space utilization
-.SH SYNOPSIS
-.B pixhist3d
-[file.pix]
-.SH DESCRIPTION
-.I Pixhist3d
-builds up a count of color frequencies in the RGB color space and
-then displays three orthographic views of this color space.
-An RGB color cube with red, green, and blue values from 0 to 255
-form a right handed coordinate system.  Three faces of this cube
-are displayed where the intensity of the pixels shown for each face
-correspond to the integrated frequencies through the color cube
-perpendicular to that face.  These frequencies are scaled so that the
-maximum value is full white, and any non-zero scaled count less than
-30 is displayed at intensity 30 so as to be visible.
-.PP
-The faces are:
-.br
-Lower left: red vertical, green horizontal
-.br
-Upper left: blue vertical, green horizontal
-.br
-Lower right: red vertical, blue horizontal
-.PP
-The environment
-variable
-.B
-.SM FB_FILE
-is used to select the display device (see
-.IR brlcad (1)).
-If this variable is not set, the default device for your system will
-be used.
-.SH "SEE ALSO"
-brlcad(1), pixhist3d-pl(1), pixhist(1), pixstat(1) pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixinterp2x.1
===================================================================
--- brlcad/src/util/pixinterp2x.1	(revision 53937)
+++ brlcad/src/util/pixinterp2x.1	(working copy)
@@ -1,101 +0,0 @@
-.TH PIXINTERP2X 1 BRL-CAD
-.\"                  P I X I N T E R P 2 X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixinterp2x \- interpolate a color pix file twice as large as the original
-.SH SYNOPSIS
-.B pixinterp2x
-.RB [ \-h ]
-.RB [ \-s\  squarefilesize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-[infile.pix]
-\>\ outfile.pix
-.SH DESCRIPTION
-.I Pixinterp2x
-does a bilinear interpolation between the pixels of the
-input
-.IR pix (5)
-file to create the output file.
-This program is most useful when creating images for photographing.
-Even though no additional image information is created,
-there may be significant photographic advantages to operating
-the display at its highest resolution.
-.PP
-This is a very fast implementation of one special case of
-interpolation;  the general tool for interpolation is
-.IR pixscale (1).
-.TP
-.B \-h
-``hires'' flag.
-Set both the height and width of the input to 1024.
-The default is 512x512.
-.TP
-.BI \-w\  file_width
-Specify the width (in pixels) of the scanlines in the input file.
-The default is 512.
-.TP
-.BI \-n\  file_height
-Specify the number of scanlines of input to be processed.
-The default is 512.
-.TP
-.BI \-s\  squarefilesize
-Specify both the number of pixels per scanline and the number of
-scanlines in the file to process.
-.PP
-The interpolated scanlines fall exactly half way between the input
-lines, and the input lines are exactly preserved.  Rather than extrapolate
-beyond the edges of the file, the first X and Y line is duplicated (left
-and bottom edge).  This differs from the behavior of
-.IR pixscale (1).
-.SH "SEE ALSO"
-brlcad(1), pixscale(1), pix(5).
-.SH BUGS
-More memory is used than is strictly necessary.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixmatte.1
===================================================================
--- brlcad/src/util/pixmatte.1	(revision 53937)
+++ brlcad/src/util/pixmatte.1	(working copy)
@@ -1,174 +0,0 @@
-.TH PIXMATTE 1 BRL-CAD
-.\"                     P I X M A T T E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixmatte \-
-matte (merge) two pix(5) or bw(5) images by a formula
-.SH SYNOPSIS
-.B pixmatte
-.RB [ \-a]
-.RB [ \-w\  bytes_wide]
-.RB [ \-glen ]
-in1 in2 true_out false_out > output
-.SH DESCRIPTION
-Given four streams of data elements,
-where element is of arbitrary width,
-typically
-.IR pix (5)
-or
-.IR bw (5)
-images,
-.I pixmatte
-outputs a stream of the same number of data elements.
-The value of the output stream is determined element-by-element,
-by comparing the
-first (foreground) input stream with the
-the second (background, or matte) input stream.
-If the formula holds true, the element from the
-true-output stream is written,
-otherwise, the element from the false-output stream is written.
-Each of these streams comes from a file, or is given as a constant.
-A particular file may be used to feed more than one stream,
-and the name '-' specifies stdin.
-For example, the foreground file may also be the true-output file.
-This routine operates on an element-by-element basis, and thus
-is independent of the resolution of the image.
-.PP
-The formula can be any combination of
-.B \-g
-(in1 greater than in2),
-.B \-l
-(in1 less than in2),
-.B \-e
-(in1 equal to in2),
-.B \-n
-(in1 not equal to in2).
-For example,
-.B \-ge
-specifies in1 greater than or equal to in2.
-.PP
-The
-.B \-a
-flag can be used with
-.B \-n
-or
-.B \-e
-to specify approximately equal or approximately not equal
-to match dithered backgrounds.
-Approximate equality exists when all bytes in the elements
-match to within plus or minus one.
-.PP
-For example,
-.B \-le
-is true when in1 is lexically less than or equal to in2,
-that is, when all bytes of the in1 element are less than
-or equal to the bytes of the in2 element.
-The
-.B \-w#
-flag specifies the width (in bytes) of each element;  the default is
-3, \fIie\fR
-.IR pix (5)
-file format.  A width of 1 is used for processing
-.IR bw (5)
-files.  It is unclear if other widths are useful.
-.PP
-A constant value is specified instead of a filename
-if the first character of the file name is a equal sign '='.
-The value is specified as a slash separated string of
-.B width
-decimal numbers, with no separating white space.
-.SH EXAMPLES
-.PP
-To compare all foreground
-pixels to black (all bytes zero),
-selecting the foreground pixels when true and a background elsewhere, specify:
-.sp .5
-.ft I
-   pixmatte -g fg.pix =0/0/0 fg.pix bg.pix
-.ft R
-.sp .5
-To keep all foreground pixels greater than 20/20/20, and replace
-all those less than or equal to it with 200/0/200, use:
-.sp .5
-.ft I
-      pixmatte -g fg.pix =20/20/20 fg.pix =200/0/200
-.ft R
-.sp .5
-To keep all foreground pixels which are not equal to 63/0/127,
-and to replace those which are equal with a generated background from
-stdin, use the following commands.
-This can be useful when compositing an
-.IR rt (1)
-generated image on top of a nicer background.
-.sp .5
-.ft I
-      pixbackgnd -t0 160 200 |
-.br
-      pixmatte -n fg.pix =63/0/127 fg.pix - |
-.br
-      pix-fb
-.ft R
-.sp .5
-To produce a black-and-white stencil matte file for further processing,
-use:
-.sp .5
-.ft I
-      pixmatte -n fg.pix bg.pix =255/255/255 =0/0/0
-.ft R
-.sp .5
-To set to black all pixels that approximately match (by +/- 1)
-a given background file, use:
-.sp .5
-.ft I
-      pixmatte -a -e fg.pix bg.pix =0/0/0 fg.pix
-.ft R
-.sp
-.SH "SEE ALSO"
-brlcad(1), gencolor(1), pixbackgnd(1), pixmerge(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixmerge.1
===================================================================
--- brlcad/src/util/pixmerge.1	(revision 53937)
+++ brlcad/src/util/pixmerge.1	(working copy)
@@ -1,127 +0,0 @@
-.TH PIXMERGE 1 BRL-CAD
-.\"                     P I X M E R G E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixmerge \-
-merge two pix(5) or bw(5) images by a formula
-.SH SYNOPSIS
-.B pixmerge
-.RB [ \-glen ]
-.RB [ \-w\  bytes_wide]
-.RB [ \-C\  r/g/b]
-foreground.pix background.pix > out.pix
-.SH DESCRIPTION
-.I pixmerge
-Given two streams of data, typically
-.IR pix (5)
-or
-.IR bw (5)
-images,
-generate an output stream of the same size, where the value of
-the output is determined by a formula involving the first
-(foreground) stream and a constant, or the value of the second
-(background) stream.
-This routine operates on a pixel-by-pixel basis, and thus
-is independent of the resolution of the image.
-More sophisticated processing can be performed by the
-.I pixmatte
-program.
-.PP
-The formula can be any combination of
-.B \-g
-(fg greater than bg),
-.B \-l
-(fg less than bg),
-.B \-e
-(fg equal to bg),
-.B \-n
-(fg not equal to bg).
-For example,
-.B \-le
-selects a foreground pixel when it
-is lexically less than or equal to the background pixel,
-that is, when all bytes of the foreground pixel are less than
-or equal to the background pixel.
-The
-.B \-w#
-flag specifies the width (in bytes) of each "pixel";  the default is
-3, \fIie\fR
-.IR pix (5)
-file format.  A width of 1 is used for processing
-.IR bw (5)
-files.  It is unclear if other widths are useful.
-If the
-.B \-C\ r/g/b
-option is specified, then the constant color specified by r/g/b
-is used in place of the appropriate background pixel values.
-It is expected that there will be up to
-.B width
-slash-separated constants given as a single parameter here.
-.PP
-If no formula is specified, the default is to take all foreground
-pixels greater than black (all bytes zero), which can be specified
-as:
-.br
-.ft I
-   pixmerge -g -C 0/0/0 fg.pix bg.pix
-.ft R
-.SH EXAMPLES
-.ft I
-   gencolor 200 0 200 |
-      pixmerge -g -C 20/20/20 fg.pix - > out.pix
-.sp .5
-   pixbackgnd -t0 160 200 |
-      pixmerge -n -C 63/0/127 fg.pix - | pix-fb
-.ft R
-The second example is used to composite an
-.IR rt (1)
-generated image on top of a shaded background.
-.SH "SEE ALSO"
-brlcad(1), gencolor(1), pixbackgnd(1), pixmatte(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixmorph.1
===================================================================
--- brlcad/src/util/pixmorph.1	(revision 53937)
+++ brlcad/src/util/pixmorph.1	(working copy)
@@ -1,347 +0,0 @@
-.TH PIXMORPH 1 BRL-CAD
-.\"                     P I X M O R P H . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1996-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixmorph \-
-morph two pix(5) images
-.SH SYNOPSIS
-.B pixmorph
-.RB [ \-w\ width ]
-.RB [ \-n\ height ]
-picA.pix picB.pix linesfile warpfrac dissolvefrac > out.pix
-.SH DESCRIPTION
-.I pixmorph
-performs feature-based image metamorphosis between "picA.pix" and "picB.pix".
-The feature correspondences
-are specified in the file "linesfile", which can be created
-using a utility such as
-.I morphedit.tcl
-(see
-.I morphedit(1)).
-
-.br
-The output image is computed in the following fashion.
-First, for each pixel in the output image, we choose a set
-.I A
-of pixels
-(and associated weights) from "picA.pix" and another set
-.I B
-of pixels
-from "picB.pix" (how these sets and weights
-are chosen will be described momentarily).
-The pixel values from
-.I A
-are then averaged (using the associated weights)
-to determine the contribution
-.I cA
-from the original image; the contribution
-.I cB
-is computed similarly.  Then, the values
-.I cA
-and
-.I cB
-are interpolated by the value
-.I dissolvefrac
-to compute the final value of the output pixel.
-
-Now, the contribution
-.I cA
-from the original image is intended to be the value from
-.I picA.pix
-that gets "warped to" the location in question.
-It is this computation (more specifically, the computation of
-.I A
-and associated weights)
-that is the heart of the morphing algorithm,
-and is described briefly here.
-
-First, the linesfile is processed.  The linesfile
-is of the form
-.br
- a b p n
- lineseg1_initial lineseg1_final
- lineseg2_initial lineseg2_final
-   .
-   .
-   .
- linesegn_initial linesegn_final
-.br
-where
-.I n
-equals the number of line segments, and
-.I a, b,
-and
-.I p
-are constants that alter the nature of the morph.
-A line segment is represented as a list of four real numbers (and is
-interpreted as a directed line segment.)
-For example,
-.br
- 0.1 2.0 0.2 2
- 0.714844 0.560547 0.988281 0.277344 0.347656 0.646484 0.654297 0.896484
- 0.341797 0.611328 0.757812 0.265625 0.628906 0.519531 0.925781 0.763672
-.br
-is a valid lines file.
-Typically, the pairs
-.I linesegi_initial linesegi_final
-have been placed by the user in the lines file to match up
-particular features of
-.I picA.pix
-and
-.I picB.pix
-(the feature at
-.I linesegi_initial
-in
-.I picA.pix
-corresponds to the feature at
-.I linesegi_final
-in
-.I picB.pix.)
-For instance,
-.I lineseg1_initial
-might be a line segment running down the length of the nose of a person
-displayed in
-.I picA.pix;
-then
-.I lineseg1_final
-would be a line segment running down the length of the nose of the person
-featured in
-.I picB.pix.
-See
-.I morphedit(1)
-for more information about creating a lines file.
-
-Now, for each line segment pair
-.I (s,t),
-we perform the following procedure:
-We interpolate between
-.I s
-and
-.I t
-by factor
-.I warpfrac
-to yield the interpolated line segment
-.I s'.
-From the change in position, scale, and orientation of a line segment from
-its initial position
-.I s
-to its interpolated counterpart
-.I s'
-we may deduce a linear transformation in the image space.
-More specifically, if the line segment
-.I s
-must undergo
-translation, stretching, and rotation
-to yield
-.I s',
-we compute a linear transformation
-.I T
-of the image space that
-performs the same translation, stretching, and rotation.
-(So
-.I T
-applied to
-.I s
-yields
-.I s'.)
-The inverse
-.I T*
-of this transformation maps
-.I s'
-to
-.I s;
-for instance,
-.I T*
-will take an endpoint of
-.I s'
-to the corresponding endpoint of
-.I s,
-and will preserve the relationship of every other point
-to the line segment.
-We apply this inverse
-.I T*
-to the coordinates
-.I (x,y)
-to find an appropriate pixel in the original image.
-Along with this, we compute a weight based on the length of the line segment
-.I s
-along with its distance from
-.I (x,y).
-This weight is equal to
-.br
-       ( (length ** p) / (a + dist) ) ** b
-.br
-(where
-.I **
-denotes exponentiation,
-.I length
-is the length of
-.I s,
-.I dist
-is the distance from
-.I s
-to
-.I (x,y), and
-.I a, b, p
-are constants chosen by the user and stored in the lines file.)
-
-The set
-.I A
-of pixels is then collected by performing these computations for each
-line segment, and the resulting contribution
-.I cA
-is then computed by averaging over
-.I A
-with the appropriate weights.
-
-.br
-In practice,
-.I a
-= 0.1,
-.I b
-= 2.0, and
-.I p
-= 0.2 seems to work well.
-
-.br
-In general, the user will wish to set
-.I warpfrac
-=
-.I dissolvefrac.
-Typically, a morph animation will be produced by computing a sequence
-of images using
-.I pixmorph,
-each with slightly greater
-.I warpfrac
-(and
-.I dissolvefrac)
-(see the example.)
-.br
-For a clearer and more thorough explanation, see
-.br
- T. Beier and S. Neely.
- Feature-Based Image Metamorphosis.
- "SIGGRAPH 1992 Computer Graphics Proceedings (volume 26 number 2)"
- (Chicago, July 26-31, 1992). pp 35-42.
-.br
-which presents the algorithm used by
-.I pixmorph.
-.PP
-.SH OPTIONS
-.TP
-.BI \-w " WIDTH"
-Tells
-.I pixmorph
-that the input images have width WIDTH.
-.PP
-.TP
-.BI \-n " HEIGHT"
-Tells
-.I pixmorph
-that the input images have height HEIGHT.
-.ft R
-.SH EXAMPLES
-.ft I
-      pixmorph face1.pix face2.pix lf 0.0 0.0 > frame0.pix
-      pixmorph face1.pix face2.pix lf 0.2 0.2 > frame1.pix
-      pixmorph face1.pix face2.pix lf 0.4 0.4 > frame2.pix
-      pixmorph face1.pix face2.pix lf 0.6 0.6 > frame3.pix
-      pixmorph face1.pix face2.pix lf 0.8 0.8 > frame4.pix
-      pixmorph face1.pix face2.pix lf 1.0 1.0 > frame5.pix
-
-.br
-.ft R
-Note that the example above will result in
-.I frame0.pix
-=
-.I face1.pix
-and
-.I frame5.pix
-=
-.I face2.pix.
-
-.br
-.ft I
-      pixmorph face1.pix face2.pix lf 0.5 0.0 > out.pix
-
-.br
-.ft R
-Note that in this example,
-.I dissolvefrac
-= 0.
-This will warp
-.I face1.pix
-and
-.I face2.pix
-by the appropriate amount, but will ignore the contributions of
-.I face2.pix
-at the cross-dissolve stage.
-So the final image
-.I out.pix
-will consist entirely of values from
-.I face1.pix
-warped 50% according to the linesfile
-.I lf.
-
-.br
-.ft I
-      pixmorph face1.pix face2.pix lf 0.0 0.5 > out.pix
-
-.br
-.ft R
-In this example,
-.I warpfrac
-= 0.
-This will perform a simple 50% cross-dissolve between
-.I face1.pix
-and
-.I face2.pix.
-.SH "SEE ALSO"
-brlcad(1), morphedit(1), pix(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1996-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixrect.1
===================================================================
--- brlcad/src/util/pixrect.1	(revision 53937)
+++ brlcad/src/util/pixrect.1	(working copy)
@@ -1,77 +0,0 @@
-.TH PIXRECT 1 BRL-CAD
-.\"                      P I X R E C T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixrect \- extract a rectangle from a color pix file
-.SH SYNOPSIS
-.B pixrect
-.RB [ \-# bytes]
-infile outfile
-.SH DESCRIPTION
-.I Pixrect
-extracts a rectangular region from a color
-.IR pix (5)
-format file.
-The program prompts for the area to extract in x and y pixels,
-the scanline length of the input file in pixels, and the origin
-in the input file from which to extract.  First quadrant coordinates
-and file storage formats are used.
-.PP
-By default pixels of size three bytes are assumed as in the
-.IR pix (5)
-format.  However, the
-.BI \-# bytes
-flag can be used to specify some other pixel size, where
-.I bytes
-is the number of bytes per pixel.  Thus this program
-can be used to extract rectangles of other data types, such as
-an array of floats, etc.
-.SH "SEE ALSO"
-brlcad(1), bwrect(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixrot.1
===================================================================
--- brlcad/src/util/pixrot.1	(revision 53937)
+++ brlcad/src/util/pixrot.1	(working copy)
@@ -1,118 +0,0 @@
-.TH PIXROT 1 BRL-CAD
-.\"                       P I X R O T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixrot \- rotate, invert, or reverse a color pix file
-.SH SYNOPSIS
-.B pixrot
-.RB [ \-# bytes]
-.RB [ \-rifb ]
-.RB [ \-s\  squaresize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-[file.pix] \>\ newfile.pix
-.SH DESCRIPTION
-.I Pixrot
-will rotate, invert, or reverse a color
-.IR pix (5)
-format file or read from standard input if a file name is not given.  The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to same same value via
-.I \-s.
-.PP
-The
-.B \-r
-flag reverses the scan lines left to right.
-.br
-The
-.B \-i
-flag inverts the image top to bottom.
-.br
-The
-.B \-f
-and
-.B \-b
-flag will rotate the image ninety degrees forward or backward respectively.
-The sense of the rotation is relative to a first quadrant coordinate
-system, i.e. origin lower left, where "forward" means clockwise.
-.PP
-Note that a 180 degree rotation can be obtained by both reversing
-and inverting.
-.PP
-By default three byte pixels are assumed as in the
-.IR pix (5)
-format.  However, the
-.BI \-# bytes
-flag can be used to specify some other pixel size, where
-.I bytes
-is the number of bytes per pixel.  Thus this program
-can be used to manipulate rectangles of other data types, such as
-an array of floating point numbers, files of text, etc.
-.SH METHOD
-A fairly large buffer is kept in memory so that, file size permitting,
-the entire rotation can occur without seeking on input or output.
-In any event, the algorithm is designed to process the input sequentially,
-so that if any seeking is required, it will happen on output only.  If
-these seeks fail, e.g. the output is a pipe, the user will be told that
-it needs a file on output.
-A more general solution to this problem would be to see if seeks can
-be done on input instead, and switch the algorithm to seek on input
-only.
-.SH "SEE ALSO"
-brlcad(1), pixscale(1), pixrect(1), pix(5).
-.SH BUGS
-If the file size is very large, excessive seeking may occur on output
-and the rotation will take a very long time.  More complicated
-algorithms could remedy this.
-.br
-Rotations of arbitrary angle are not supported.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixsaturate.1
===================================================================
--- brlcad/src/util/pixsaturate.1	(revision 53937)
+++ brlcad/src/util/pixsaturate.1	(working copy)
@@ -1,63 +0,0 @@
-.TH PIXSATURATE 1 BRL-CAD
-.\"                  P I X S A T U R A T E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixsaturate \- saturate a pix file
-.SH SYNOPSIS
-.B pixsaturate
-saturation \>\ outfile.pix
-.SH DESCRIPTION
-.I pixsaturate
-saturates a color pix file using the
-.B saturation
-value.  A value of 0 gives monochrome, 1.0 gives the original image,
-and values larger than 1.0 give a more saturated image.
-.SH "SEE ALSO"
-brlcad(1), pix(5), pixfade(1)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixscale.1
===================================================================
--- brlcad/src/util/pixscale.1	(revision 53937)
+++ brlcad/src/util/pixscale.1	(working copy)
@@ -1,122 +0,0 @@
-.TH PIXSCALE 1 BRL-CAD
-.\"                     P I X S C A L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixscale \- change the size of a color pix file
-.SH SYNOPSIS
-.B pixscale
-.RB [ \-h ]
-.RB [ \-r ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-[infile.pix] \>\ outfile.pix
-.SH DESCRIPTION
-.I Pixscale
-will take a color
-.IR pix (5)
-format file of given dimensions and produce a larger or smaller
-scaled version.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-Similarly, the
-.I \-W
-and
-.I \-N
-flags specify the desired output file width and number of scan lines in
-pixels.  They can both be set to the same value via
-.I \-S.
-Defaults of 512 are assumed for any unspecified dimensions.
-.PP
-The algorithm used is bilinear interpolation if scaling up, and
-a box filter of arbitrary size if scaling down.  For the box filter a
-"square pixel" assumption is made; that is, all whole and fractional
-input pixels falling into a rectangle the size of an output pixel contribute
-equally according to the fraction of the output pixel area they cover.
-When interpolating, the edge pixels are preserved, i.e. all of the
-interpolated pixels fall inside of the edges.  This can be a bit surprising
-when say doubling the size of a file as only the edge pixels will fall
-at exactly the location of an output pixel.
-.PP
-Specifying the
-.B \-r
-flag changes from bilinear interpolation to
-nearest neighbor interpolation, i.e. it enlarges the image by
-pixel replication.
-.PP
-For 2X interpolation, a much faster alternative is
-.IR pixinterp2x (1).
-.PP
-The
-.B \-h
-flag causes the frame buffer to be
-used in high resolution mode (1024x1024).
-This is important for frame buffers such as the Adage which operate
-differently depending on the display size.  Without this flag
-the default size for the selected device will be used (usually
-the entire screen).
-.SH "SEE ALSO"
-brlcad(1), pixcrop(1), pixrect(1), pixinterp2x(1), pix(5).
-.SH BUGS
-This program cannot scale up in one dimension and down in the other
-at the same time.
-.br
-The box filter used for scaling down results in the usual high-frequency
-ripple.
-.br
-Optional cubic interpolation would be nice.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixshrink.1
===================================================================
--- brlcad/src/util/pixshrink.1	(revision 53937)
+++ brlcad/src/util/pixshrink.1	(working copy)
@@ -1,106 +0,0 @@
-.TH PIXSHRINK 1 BRL-CAD
-.\"                    P I X S H R I N K . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1990-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixshrink \- shrink a color pix file
-.SH SYNOPSIS
-.B pixshrink
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-f\  shrink_factor]
-.RB [ \-h ]
-.RB [ \-u ]
-[infile.pix] \>\ outfile.pix
-.SH DESCRIPTION
-.I Pixshrink
-will take a color
-.IR pix (5)
-format file of given dimensions and produce a smaller
-scaled version.
-The
-.I \-w
-and
-.I \-n
-flags specify the input file width and number of scan lines in pixels.
-They can both be set to the same value via
-.I \-s.
-Defaults of 512 are assumed for unspecified dimensions.
-The integer scaling factor is set with the
-.I \-w
-flag.  By default, the factor is 2.  Thus, pixshrink forms the logical
-opposite of the
-.B pixinterp2x (1)
-program.
-.PP
-The program reads the entire image into memory,
-and then scales the image down by
-to 1/factor the original size in both dimensions.
-
-
-By default, pixshrink uses boxcar averaging to produce the output pixels from
-the input.  The
-.I \-u
-option causes pixshrink to use image undersampling instead.
-.PP
-The
-.B \-h
-flag causes the frame buffer to be
-used in high resolution mode (1024x1024).
-This is important for frame buffers such as the Adage which operate
-differently depending on the display size.  Without this flag
-the default size for the selected device will be used (usually
-the entire screen).
-.PP
-.SH "SEE ALSO"
-brlcad(1), pixcrop(1), pixrect(1), pixinterp2x(1), pixscale(1), pix(5).
-.SH BUGS
-If the dimensions of the input image are not evenly divisible by the shrink
-factor, incorrect and bizarre output is generated.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1990-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixstat.1
===================================================================
--- brlcad/src/util/pixstat.1	(revision 53937)
+++ brlcad/src/util/pixstat.1	(working copy)
@@ -1,93 +0,0 @@
-.TH PIXSTAT 1 BRL-CAD
-.\"                      P I X S T A T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixstat \- list statistics related to a color pix image
-.SH SYNOPSIS
-.B pixstat
-.RB [ \-v ]
-[file.pix]
-.SH DESCRIPTION
-.I Pixstat
-will take the given
-.IR pix (5)
-format file,
-or read from standard in.  A collection of statistics
-related to the pixel intensities is produced for each color
-plane (red, green, and blue).
-.br
-These include:
-.br
-The number of pixels (and the square root of this which is the
-file dimensions if square).
-.br
-The max and min values.
-.br
-The mean.
-.br
-The median (dividing line where half the pixels are above this
-value, half below).
-.br
-The mode (most frequently occurring value) and
-the number of pixels at this value.
-.br
-The variance, standard deviation, and skew.
-.PP
-The
-.B \-v
-flag will also dump a histogram of the pixel values.
-.SH METHOD
-Since the pixel values are quantized (each color having discrete values
-from 0 to 255), the statistics can be computed from "lump sums" after
-building a histogram of the input.  This results in a fantastic
-savings in computation while also making a single pass over the input
-file sufficient.
-.SH "SEE ALSO"
-brlcad(1), pixhist(1), bwstat(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixsubst.1
===================================================================
--- brlcad/src/util/pixsubst.1	(revision 53937)
+++ brlcad/src/util/pixsubst.1	(working copy)
@@ -1,64 +0,0 @@
-.TH PIXSUBST 1 BRL-CAD
-.\"                     P I X S U B S T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1999-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixsubst	\- Change color values used in a PIX(5) format image
-.SH SYNOPSIS
-.B pixsubst
-[R_in G_in B_in] R_out G_out B_out < pixfile_in > pixfile_out
-.SH DESCRIPTION
-.I Pixsubst
-reads
-.I pix(5)
-format pixels on the standard input and converts all pixels matching
-the {R_in G_in B_in} to {R_out G_out B_out}. The pixels values are
-specified as integers from 0 to 255. If {R_in G_in B_in} is not specified,
-the first pixel in the input stream is used as the value to be changed.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1999-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixtile.1
===================================================================
--- brlcad/src/util/pixtile.1	(revision 53937)
+++ brlcad/src/util/pixtile.1	(working copy)
@@ -1,230 +0,0 @@
-.TH PIXTILE 1 BRL-CAD
-.\"                      P I X T I L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixtile \- paste small images together into one large image
-.SH SYNOPSIS
-.B pixtile
-.RB [ \-h ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-.RB [ \-o\  startframe]
-basename
-\>
-file.pix
-.PP
-.B pixtile
-.RB [ \-h ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  file_width]
-.RB [ \-n\  file_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-file1 file2 ... fileN
-\>
-file.pix
-.SH DESCRIPTION
-.I Pixtile
-takes a collection of numbered small images and places them side
-by side in one larger image.  The input and output files are
-assumed to be in
-.IR pix (5)
-format.
-By default, the output file will be made 512x512 pixels in size.
-Specifying the
-.B \-h
-flag, changes the default size to 1024x1024 pixels.
-.PP
-The input files have a default width of 64 pixels per scanline
-and are usually square, i.e. have the same height as width.
-Specifying the
-.B \-s
-flag, changes the default size to
-.I squareinsize
-pixels per scanline and
-.I squareinsize
-scanlines as given in the argument list.
-The
-.B \-w
-flag can be used to specify the input file width in pixels and the
-.B \-n
-flag can be used to specify the input file height in scanlines.
-.PP
-If the
-.B \-S
-flag is supplied, the output
-size is changed from the default value of 512 to
-.I squareoutsize
-pixels per scanline and
-.I squareoutsize
-scanlines.
-The
-.B \-W
-flag sets the output width size to
-.I out_width
-pixels per scanline.
-Similarly, the
-.B \-N
-flag sets the output height size to
-.I out_height
-scanlines.
-.TP
-.B \-h
-``hires'' flag.
-Set both the height and width of the output to 1024.
-The default is 512x512.
-.TP
-.BI \-s\  squareinsize
-Specify both the number of pixels per scanline and the number of
-scanlines in the input files.  The default is 64.
-
-.TP
-.BI \-w\  file_width
-Specify the width (in pixels) per scanline of the input file.
-The default is 64.
-.TP
-.BI \-n\  file_height
-Specify the number of scanlines to be read from the input file.
-The default is 64.
-.TP
-.BI \-S\  squareoutsize
-Specify both the number of pixels per scanline (width) and the number of
-scanlines (height) for the output file.  The default is 512.
-.TP
-.BI \-W\  out_width
-Specify the width (in pixels) per scanline of the output file.
-The default is 512.
-.TP
-.BI \-N\  out_height
-Specify the number of scanlines to be sent to the output file.
-The default is 512.
-.TP
-.BI \-o\  startframe
-Specify the starting frame number, where
-.I startframe
-is substituted for
-.I num
-in
-.I basename.num
-.PP
-The files being pasted together should have names of the form
-.IR basename.num ,
-where
-.I basename
-is given on the command line, and
-.I num
-is a consecutive series of integers.  By default the first image
-is assumed to be number `` 0 '', but an alternate
-.I startframe
-can be given by using the
-.B \-o
-flag and supplying
-.IR startframe .
-The program keeps reading these small files until either the next
-frame does not exist, or the output file is full.
-They are placed in the output file from lower left to upper right.
-The progress
-of the composition is displayed on standard error.
-.PP
-If the basename is given as "\-" (a minus sign),
-preceded by a "\-\-" (two minus signs) to terminate
-.IR bu_getopt (3)
-processing,
-then the stream of images is read from stdin rather than a file, such as
-might be generated by a program like
-.IR pcd-pix (1).
-Such a stream could also be processed into files by
-.IR pixbustup (1).
-.PP
-Alternatively, if more than one
-.I basename
-(filename) argument is supplied on the command line,
-the names of the files being pasted together are assumed
-to be explicitly stated and the
-.B \-o
-flag is not valid.  This allows files with different names to be
-used without having to change the name of the files.
-.PP
-This program is the companion of
-.IR fbanim (1)
-which will step through these small images on a framebuffer capable
-of zooming and windowing.  Thus many small low resolution frames can
-be used as an animation "preview" for a higher resolution sequence,
-the latter of which would go onto video tape or film.
-.SH EXAMPLE
-.I
-pixtile \-h \-s 128 \-o 2 anim \>\ out.pix
-.br
-will read files
-.I anim.2
-through
-.I anim.65
-placing them from lower left to upper right in a 1024x1024 pixel
-file
-.IR out.pix .
-.PP
-.I
-pixtile \-s 256 lowerleft lowerright upperleft upperright \>\ out.pix
-.br
-will read files
-.IR lowerleft ,
-.IR lowerright ,
-.IR upperleft ,
-and
-.I upperright
-placing them from lower left to upper right in a 512x512 file
-.IR out.pix .
-.SH "SEE ALSO"
-brlcad(1), fbanim(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pixuntile.1
===================================================================
--- brlcad/src/util/pixuntile.1	(revision 53937)
+++ brlcad/src/util/pixuntile.1	(working copy)
@@ -1,135 +0,0 @@
-.TH PIXUNTILE 1 BRL-CAD
-.\"                    P I X U N T I L E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pixuntile \- break small images up into separate files
-.SH SYNOPSIS
-.B pixuntile
-.RB [ \-h ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-.RB [ \-o\  startframe]
-basename
-\<
-file.pix
-.PP
-.B pixuntile
-.RB [ \-h ]
-.RB [ \-s\  squareinsize]
-.RB [ \-w\  in_width]
-.RB [ \-n\  in_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-file1 file2 ... fileN
-\<
-file.pix
-.SH DESCRIPTION
-.I Pixuntile
-performs the inverse operation of
-.IR pixtile (1).
-It takes a large image composed of a collection of small images and
-places each of them in a separate file.
-The input and output files are
-assumed to be in
-.IR pix (5)
-format.
-By default, the input file is assumed to be 512x512 pixels in size.
-Specifying the
-.B \-h
-flag, changes the default input size to 1024x1024 pixels.
-.PP
-The output files have a default width of 64 pixels
-and are usually square, i.e. have the same height as width.
-Specifying the
-.B \-S
-flag, changes the default size to
-.I squareoutsize
-pixels in width and height.
-.PP
-The files being produces as output will have names of the form
-.IR basename.num ,
-where
-.I basename
-is given on the command line, and
-.I num
-is a consecutive series of integers.  By default the first image
-is assumed to be number `` 0 '', but an alternate
-.I startframe
-can be given by using the
-.BI \-o\  startframe
-flag and specifying the starting output frame number, where
-.I startframe
-is substituted for
-.I num
-in
-.I basename.num
-.PP
-Alternatively, if more than one
-.I basename
-(filename) argument is supplied on the command line,
-the names of the files are used as the output file names.
-.SH EXAMPLE
-.I
-pixuntile \-h \-S 128 out\ \<\ in.pix
-.br
-will read the 1024x1024 file
-.I in.pix
-and place the 128x128 chucks of that file from
-lower left to upper right in the files
-.I out.0
-through
-.IR out.15 .
-.SH "SEE ALSO"
-pixtile(1), brlcad(1), pix(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-X.1
===================================================================
--- brlcad/src/util/pl-X.1	(revision 53937)
+++ brlcad/src/util/pl-X.1	(working copy)
@@ -1,75 +0,0 @@
-.TH PL-X 1 BRL-CAD
-.\"                         P L - X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl\(hyX \- display UnixPlot in an X Window (X11)
-.SH SYNOPSIS
-.B pl-X
-.RB [ \-v ]
-< unix_plot
-.br
-.SH DESCRIPTION
-.I Pl-X
-displays an extended UnixPlot file on any workstation running the
-X Window System (X11R2).  As with all X programs, the selected
-display is determined from the
-.B
-.SM DISPLAY
-environment variable.
-.PP
-The
-.B \-v
-verbose option causes descriptions of the plot commands to be
-printed.
-.SH BUGS
-This is just the bare bones of a display program at the time
-of this writing.  It needs the ability to rotate, translate, zoom, etc.
-.SH "SEE ALSO"
-pl-X10(1), pl-fb(1), pl-sgi(1), pl-pl(1), plot3(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-asc.1
===================================================================
--- brlcad/src/util/pl-asc.1	(revision 53937)
+++ brlcad/src/util/pl-asc.1	(working copy)
@@ -1,68 +0,0 @@
-.TH PL-ASC 1 BRL-CAD
-.\"                       P L - A S C . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl-asc \- convert a Plot3 stream to ASCII
-.SH SYNOPSIS
-.B pl-asc
-.RB [ \-v ]
-[unix_plot]
-.SH DESCRIPTION
-Reads a stream in
-.IR plot3 (5)
-format and converts it to an ASCII representation.
-Standard input is read if a file name is not supplied.
-If the
-.B \-v
-option is given,
-the single-character command names
-are replaced with mnemonic strings
-and a summary of plot command usage is written to standard error.
-.SH "SEE ALSO"
-asc-pl(1), pl-pl(1), plrot(1), pl-fb(1), libplot3(3), plot3(5)
-
-.SH AUTHOR
-BRL-CAD Team
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-hpgl.1
===================================================================
--- brlcad/src/util/pl-hpgl.1	(revision 53937)
+++ brlcad/src/util/pl-hpgl.1	(working copy)
@@ -1,58 +0,0 @@
-.TH PL-HPGL 1 BRL-CAD
-.\"                      P L - H P G L . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl-hpgl \- convert a Unix Plot file to HPGL commands
-.SH SYNOPSIS
-.B pl-hpgl
-\<\ unix_plot \>\ hpgl_cmds
-.SH DESCRIPTION
-Reads a Unix Plot file from standard input and
-converts it to of HPGL commands which are written to standard output.
-.SH "SEE ALSO"
-pl-asc(1), pl-pl(1), plrot(1), pl-fb(1), pl-starbase(1), libplot3(3), plot(5)
-.SH AUTHOR
-Mark Huston Bowden
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-pl.1
===================================================================
--- brlcad/src/util/pl-pl.1	(revision 53937)
+++ brlcad/src/util/pl-pl.1	(working copy)
@@ -1,83 +0,0 @@
-.TH PL-PL 1 BRL-CAD
-.\"                        P L - P L . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl\(hypl \- convert an extended to a simple UnixPlot file
-.SH SYNOPSIS
-.B pl-pl
-.RB [ \-v ]
-.RB [ \-S ]
-< unix_plot > unix_plot
-.SH DESCRIPTION
-UnixPlot is a simple machine and device independent plotting file
-format found on both System V and BSD Unix systems.  BRL has extended
-that format to include color, three dimensional plotting, machine
-independent floating point coordinates, and a flush command for
-interactive output.
-.PP
-.I Pl-pl
-converts an extended UnixPlot file to the simpler format for
-use by older, and non-extended, programs.  It drops color and
-flush commands, strips the Z coordinate of 3D commands, and
-converts floating point coordinates to integer.  By default to
-integer conversion is done by simple truncation.  If the
-.B \-S
-option is given, the "space" command in the plot file is used to
-center and scale the plot to the full 16 bit signed integer plotting
-space (-32767 to +32767).  This is particularly useful for converting
-floating point files.  The
-.B \-v
-verbose option causes each plot command to be described as it is being
-converted.
-.SH DIAGNOSTICS
-A warning message is given if the input plot file did not contain
-a space command since most older UnixPlot programs require them.
-.SH "SEE ALSO"
-plot(1), plrot(1), pl-fb(1), pldebug(1), libplot3(3), plot(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-ps.1
===================================================================
--- brlcad/src/util/pl-ps.1	(revision 53937)
+++ brlcad/src/util/pl-ps.1	(working copy)
@@ -1,86 +0,0 @@
-.TH PL-PS 1 BRL-CAD
-.\"                        P L - P S . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl\(hyps \- convert UnixPlot to PostScript file
-.SH SYNOPSIS
-.B pl-ps
-[-ec] [-s square_output_size] [-w output_width] [-n output_height] < unix_plot
-.SH DESCRIPTION
-.I Pl-ps
-converts an extended UnixPlot file to a PostScript file
-suitable for embedding in a larger PostScript document.
-This is especially useful for creating figures for inclusion in TeX
-documents.
-The
-.I -e
-option will produce and encapsulated PostScript file. The
-.I -s
-,
-.I -w
-, and
-.I -n
-options specify the size of the output image in inches (ignored when used with the
-.I -e
-option).
-.P
-All UnixPlot line types are supported.
-.P
-If no UnixPlot
-.B space
-directive is seen, the default space ranges from
-(0, 0, 0) to (4096, 4096, 4096).
-.SH BUGS
-This is just the bare bones of a program at the time
-of this writing.
-.SH "SEE ALSO"
-pl-fb(1), pl-sgi(1), pl-pl(1), pl-X(1), plot3(5).
-.SH "TRADEMARKS"
-PostScript is a trademark of Adobe Systems Incorporated.
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pl-tek.1
===================================================================
--- brlcad/src/util/pl-tek.1	(revision 53937)
+++ brlcad/src/util/pl-tek.1	(working copy)
@@ -1,95 +0,0 @@
-.TH PL-TEK 1 BRL-CAD
-.\"                       P L - T E K . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1991-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pl\(hytek \- convert UnixPlot to Tektronix 4014 command stream
-.SH SYNOPSIS
-.B pl-tek
-.RB [ \-e ]
-.RB [ \-v ]
-< file.pl [ > file.tek ]
-.SH DESCRIPTION
-.I pl-tek
-converts an extended UnixPlot file to a Tektronix 4014 command stream
-suitable for viewing on a Tektronix display,
-or a Tektronix-compatible emulator.
-The (binary) Tektronix command stream is written to stdout.
-.P
-The
-.B -e
-option expands the drawing area on the Tektronix to the full 4096x4096,
-which is more than a real Tektronix can display.
-It it not known if this feature is useful.
-.P
-The
-.B -v
-option turns on \fIverbose\fR mode, and each command is logged to stderr.
-Occasionally useful for debugging Tektronix emulator problems,
-but is very verbose.
-.P
-To send a Unix-plot to an Imagen printer, this command can be used:
-
-.nf
-.RS
-pl-tek < file.pl | ipr -Ltektronix -q im101
-.RE
-.fi
-
-.P
-All UnixPlot line types are supported.
-.P
-If no UnixPlot
-.B space
-directive is seen, the default space ranges from
-(-32767, -32767) to (32767, 32767).
-.SH BUGS
-Circle and arc directives are not supported.
-.SH "SEE ALSO"
-pldebug(1), pl-fb(1), pl-ps(1), pl-sgi(1), pl-pl(1), pl-X(1), plot3(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1991-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/plcolor.1
===================================================================
--- brlcad/src/util/plcolor.1	(revision 53937)
+++ brlcad/src/util/plcolor.1	(working copy)
@@ -1,75 +0,0 @@
-.TH PLCOLOR 1 BRL-CAD
-.\"                      P L C O L O R . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-plcolor \- output a UnixPlot color command
-.SH SYNOPSIS
-.B color
-.I r g b
-[< unix_plot]
-> unix_plot.
-.SH DESCRIPTION
-.I Plcolor
-outputs a UnixPlot command to set the current drawing color to
-the given
-.I r g
-and
-.I b
-values.  These values should be numbers from 0 to 255 and represent
-black to full up Red, Green, and Blue values respectively.
-.PP
-To allow this command to be used in pipelines, an optional input file
-can be given.  All of the input will be passed through until end of
-file, and then the color command will be appended to the end.
-.PP
-This command exists mostly as an aid for making graphs and things
-from shell commands.
-.SH "SEE ALSO"
-plline2(1), pl-pl(1), plot3(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/pldebug.1
===================================================================
--- brlcad/src/util/pldebug.1	(revision 53937)
+++ brlcad/src/util/pldebug.1	(working copy)
@@ -1,65 +0,0 @@
-.TH PLDEBUG 1 BRL-CAD
-.\"                      P L D E B U G . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-pldebug \- output a UnixPlot stream in ascii
-.SH SYNOPSIS
-.B pldebug
-.RB [ \-v ]
-[unix_plot]
-.SH DESCRIPTION
-Outputs a UnixPlot (see
-.IR plot (5))
-stream in ascii for debugging.  If the
-.B \-v
-option is given, a summary of plot command usage is given at the
-end of the file.  Standard input is read if a file name is not supplied.
-.SH "SEE ALSO"
-pl-pl(1), plrot(1), pl-fb(1), libplot3(3), plot(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/plgetframe.1
===================================================================
--- brlcad/src/util/plgetframe.1	(revision 53937)
+++ brlcad/src/util/plgetframe.1	(working copy)
@@ -1,69 +0,0 @@
-.TH PLGETFRAME 1 BRL-CAD
-.\"                   P L G E T F R A M E . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-plgetframe \- extract one frame from a UNIX plot file
-.SH SYNOPSIS
-.B plgetframe
-.RB [ \-v ]
-desired_frame < unix_plot
-.SH DESCRIPTION
-.I Plgetframe
-extracts a single frame from a multi-frame UNIX plot file.
-Frames are separated by UNIX plot "erase" commands.
-Specifying the
-.B \-v
-(verbose) flag causes the number of each frame being skipped to
-be printed on stderr.
-.PP
-Note that BRL 3-D UNIX plot is a superset of the standard UNIX plot
-format, thus this program can process normal plot files as well.
-.SH "SEE ALSO"
-brlcad(1), libplot3(3).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/plline2.1
===================================================================
--- brlcad/src/util/plline2.1	(revision 53937)
+++ brlcad/src/util/plline2.1	(working copy)
@@ -1,86 +0,0 @@
-.TH PLLINE2 1 BRL-CAD
-.\"                      P L L I N E 2 . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-plline2 \- output a 2D UnixPlot line
-.SH SYNOPSIS
-.B plline2 x1 y1 x2 y2
-.RI [ r\ g\ b ]
-[< unix_plot]
-> unix_plot.
-.SH DESCRIPTION
-.I Plline2
-outputs a UnixPlot command to draw a line in the XY plane from
-the point
-.RB ( x1\ y1 )
-to the point
-.RB ( x2\ y2 ).
-These points can be floating point and the output is always written
-as a floating point plotting command.  If you need an integer command
-then feed the output of this through
-.IR pl\-pl (1).
-If an optional
-.RI [ r\ g\ b ]
-is given, where
-.I r, g,
-and
-.I b
-are values from 0 to 255 representing Red, Green, and Blue color values,
-the line will be drawn in that color.  Otherwise the current drawing
-color (white by default) is used.
-.PP
-To allow this command to be used in pipelines, an optional input file
-can be given.  All of the input will be passed through until end of
-file, and then the line will be appended to the end.
-.PP
-This command exists mostly as an aid for making graphs and things
-from shell commands.
-.SH "SEE ALSO"
-plcolor(1), pl-pl(1), plot3(5).
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/plrot.1
===================================================================
--- brlcad/src/util/plrot.1	(revision 53937)
+++ brlcad/src/util/plrot.1	(working copy)
@@ -1,191 +0,0 @@
-.TH PLROT 1 BRL-CAD
-.\"                        P L R O T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1988-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-plrot \- rotate, translate, or scale a UnixPlot file
-.SH SYNOPSIS
-.B plrot
-.RB [ \-x#\ \-y#\ \-z# ]
-.RB [ \-X#\ \-Y#\ \-Z# ]
-.RB [ \-s# ]
-.RB [ \-a#\ \-e# ]
-.RB [ \-g# ]
-.RB [ \-M ]
-.RB [ \-m# ]
-.RB [ \-v ]
-.RB [ \-S# ]
-< unix_plot > unix_plot
-.SH DESCRIPTION
-.I Plrot
-will rotate translate or scale a UnixPlot file (see
-.IR plot (5)).
-Any number of the above options can be given.
-Each operation is performed left to right in the order in which they appear
-on the command line,
-and the operations are concatenated.
-It is important to note that rotations are not commutative,
-so the order they are specified in is important.
-Typing the command without any arguments
-gives a useful summary.
-.PP
-The lower case
-.B \-x# \-y# \-z#
-flags perform a rotation about the X, Y, and Z axis respectively by
-the given number of degrees.  A positive value indicates a right handed
-rotation.  Upper case
-.B \-X# \-Y# \-Z#
-are translations along these axis in whatever units the plot file is in.
-The
-.B \-s#
-flag applies a scale factor up (> 1) or down (< 1) to the plot.
-.PP
-The
-.B \-a# \-e#
-flags are for azimuth and elevation about the center point.
-They are really shorthands for positive Z axis and negative X axis
-rotations respectively, and should be used in the order shown for
-the proper combined effect to occur.  These flags also cause
-the plot to auto-center based on the "space" command
-in the plot file, and the new "space" command will be shrunk to
-fit the rotated plot as tightly as possible.
-.PP
-The
-.B \-M
-flag causes
-the plot to auto-center based on the "space" command
-in the plot file in much the same way that the
-.IR rt (1)
-ray tracer does to a model bounding box.  I.e. a sphere is fit to
-this space and the diameter and center of this sphere are used as
-the center and width of the plot in all three dimensions.  This has
-the advantage of keeping the entire model in view from any angle,
-and is invariant with respect to viewing direction.
-It has the disadvantage that the "space" will be enlarged on every
-cascaded pass through
-.IR plrot (1)
-where the
-.B \-M
-flag is used.
-.PP
-The
-.B \-S#
-flags takes a quoted string of 6 floating point numbers,
-which are immediately output as a "space" command,
-and which override any "space" commands found in the input file
-or which are computed by
-.PP
-The
-.B \-v
-flag signals that verbose mode is requested.
-When set, the initial transformation
-matrix is printed.
-In addition, every time a \fIspace\fR command is encountered in the
-input file, the old and new bounding RPP is printed.
-.PP
-The
-.B \-m#
-flag takes a quoted string of 16 floating point numbers as its parameter.
-This string is a 4x4 rotation matrix (see h/vmath.h for details).
-Note that when using this flag, do not use
-.I \-a#, \-e#,
-or
-.I \-g.
-.PP
-UnixPlot is traditionally a first quadrant 2D plotting space with
-X increasing to the right of the plot, and Y increasing up the plot.
-The "front" of a solid model in the BRL-CAD Package is traditionally
-defined by the right handed system of X coming out of the screen
-toward you, Y increasing to the right, and Z increasing up the display
-(elevation above the XY ground plane).  The
-.B \-g
-flag is a convenient shorthand to transform azimuths and elevations
-described in \fBgift\fR notation (as degrees off the front or -X view)
-into the UnixPlot coordinate system for display.
-If used, this option should usually
-appear as the last argument, because it acts by modifying the rotation already
-established.
-The
-.B \-g
-command has exactly the same effect as giving
-.B \-z\-90\ \-x\-90
-in the same place.
-.SH EXAMPLES
-The command
-
-.nf
-.RS
-plrot -z30 -x20 < file.plot > file2.plot
-.RE
-.fi
-
-performs a 30 degree positive rotation about the Z axis (counter
-clockwise as viewed from the top), and then translates by 20
-units
-.B along this rotated axis.
-If the order of these arguments was reversed the effect would not
-be the same.
-.PP
-To view a plot of a model the way one would see it from a
-ray trace command, you could use:
-
-.nf
-.RS
-rthide -a35 -e25 -o file.plot
-
-plrot -a35 -e25 -g < file.plot | pl-fb
-.RE
-.fi
-
-The final
-.B \-g
-converts the \fBgift\fR style azimuth and elevations into the
-conventional UnixPlot (screen) X,Y coordinate system.
-.SH "SEE ALSO"
-pl-pl(1), pldebug(1), pl-fb(1), libplot3(3), plot(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1988-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/png-bw.1
===================================================================
--- brlcad/src/util/png-bw.1	(revision 53937)
+++ brlcad/src/util/png-bw.1	(working copy)
@@ -1,109 +0,0 @@
-.TH PNG-BW 1 BRL-CAD
-.\"                       P N G - B W . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1998-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-png-bw \- convert a Portable Networks Graphics (PNG) format file to a BW format
-.SH SYNOPSIS
-.B png-bw
-.RB [ \-ntsc ]
-.RB [ \-crt ]
-.RB [ \-R [num]]
-.RB [ \-G [num]]
-.RB [ \-B [num]]
-[in.png]
-> out.bw
-.SH DESCRIPTION
-.I Pix-bw
-will convert a
-.IR PNG
-format
-file from its standard input
-and produce a black and white
-.IR bw (5)
-file on its standard output, If the PNG file contains a B/W image the conversion is direct, however, if the PNG file contains a color image, then
-by default all three colors are weighted equally.  The
-.B \-ntsc
-uses weighting based on the NTSC primaries and the D6500
-alignment white.  The
-.B \-crt
-flag applies weights for "typical" CRT phosphor chromaticities
-and the D6500 white.
-.PP
-Individual color plane(s) can be selected via the
-.B \-R\ \-G
-and
-.B \-B
-flags.
-If one or more of these flags is followed by a value,
-the value will be treated as a weight
-to be applied to that color
-This value is implicitly 1.0 divided by
-the number of colors selected for the flags which are not followed
-by a value.
-.SH EXAMPLES
-.I png-bw -R -B < file.png > file.bw
-.br
-will equally blend the red and blue color planes.
-.PP
-.I png-bw bw_file.png < file.bw
-will convert a b/w PNG file to
-.I bw(5)
-format.
-.PP
-.I png-bw -R0.30 -G0.59 -B0.11 < file.png > file.bw
-.br
-has the same effect as the
-.B \-ntsc
-flag.
-.br
-[The
-.B \-crt
-weights are: 0.26, 0.66, 0.08]
-.SH "SEE ALSO"
-brlcad(1), png-pix(1), bw-png(1), pix-png(1), pix(5), bw(5).
-.SH AUTHOR
-John R. Anderson
-
-.SH COPYRIGHT
-This software is Copyright (c) 1998-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/png-pix.1
===================================================================
--- brlcad/src/util/png-pix.1	(revision 53937)
+++ brlcad/src/util/png-pix.1	(working copy)
@@ -1,82 +0,0 @@
-.TH PNG-PIX 1 BRL-CAD
-.\"                      P N G - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1998-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-png-pix \- convert Portable Network Graphics (PNG) encoded image to RGB pixel format
-.SH SYNOPSIS
-.B png-pix
-.RB [ \-v ]
-[file.png] > file.pix
-.SH DESCRIPTION
-.I png-pix\^
-decodes a Portable Network Graphics (PNG) format file
-(saved with
-.IR fb-png\^ (1),
-.IR pix-png (1),
-or a similar program),
-converts it into
-.IR pix\^ (5)
-format, and writes it to standard out.
-If
-.I file.png\^
-is not specified, standard input is read. The
-.BI \-v
-option provide verbose information about the PNG file.
-.TP
-.I file.png\^
-Name of file to decode, in PNG format.
-.TP
-.I file.pix\^
-Name of file to store PIX image in.
-.SH EXAMPLE
-.RS
-\fI\|png-pix tank.png > tank.pix\fR
-.RE
-.SH "SEE ALSO"
-brlcad(1), png-fb(1), fb-png(1), pix-png(1), png-bw(1), bw-png(1), pix(5).
-.SH AUTHOR
-John R. Anderson
-
-.SH COPYRIGHT
-This software is Copyright (c) 1998-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/png_info.1
===================================================================
--- brlcad/src/util/png_info.1	(revision 53937)
+++ brlcad/src/util/png_info.1	(working copy)
@@ -1,62 +0,0 @@
-.TH PNG_INFO 1 BRL-CAD
-.\"                     P N G _ I N F O . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1998-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-png_info \- Display the non-image information available in a Portable Networks Graphics (PNG) format file.
-.SH SYNOPSIS
-.B png_info
-[in.png]
-.SH DESCRIPTION
-.I Png_info
-will print most of the information available from a PNG file other than the image itself.
-.SH EXAMPLES
-.I png_info
-file.png
-.SH "SEE ALSO"
-brlcad(1), png-pix(1), bw-png(1), pix-png(1), png-bw(1), pix(5), bw(5).
-.SH AUTHOR
-John R. Anderson
-
-.SH COPYRIGHT
-This software is Copyright (c) 1998-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/random.1
===================================================================
--- brlcad/src/util/random.1	(revision 53937)
+++ brlcad/src/util/random.1	(working copy)
@@ -1,95 +0,0 @@
-.TH RANDOM 1 BRL-CAD
-.\"                       R A N D O M . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 2010-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.\"
-.\" Begin actual content
-.\"
-.SH NAME
-random \- generates a random number between two specified values
-.SH SYNOPSIS
-.B random
-.RB [\-s\ seed]
-.RB [\-g\ [\-c\ center]]
-.RB [\-u]
-.RB [\-v]
-low high
-.SH DESCRIPTION
-.I random\^
-generates a random number between the two values given.  The number
-can be uniform across the entire range or it can be a gaussian
-distribution around the center of the range (or a named center).
-.PP
-The
-.I \-s
-option specifies what integer seed to use to prime the random number
-generator.
-The
-.I \-u
-option specifies that the random number distribution should be uniform
-across the low-to-high range.
-The
-.I \-g
-option specifies that the random number distribution should be a
-gaussian distribution around a default or named center, specified with
-the
-.I \-c
-option.
-The
-.I \-v
-option specifies verbose diagnostic output.
-.SH EXAMPLES
-
-.nf
-.RS
-random 0 100
-random -g 40 2000
-.RE
-.fi
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 2010-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/rle-pix.1
===================================================================
--- brlcad/src/util/rle-pix.1	(revision 53937)
+++ brlcad/src/util/rle-pix.1	(working copy)
@@ -1,111 +0,0 @@
-.TH RLE-PIX 1 BRL-CAD
-.\"                      R L E - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-rle\(hypix \- convert Utah Raster Toolkit run-length encoded image to RGB pixel format
-.SH SYNOPSIS
-.B rle-pix
-.RB [ \-cdhH ]
-.RB [ \-C\ r/g/b ]
-.RB [ \-s\  squareoutsize]
-.RB [ \-w\  out_width]
-.RB [ \-n\  out_height]
-.RB [ \-S\  squareoutsize]
-.RB [ \-W\  out_width]
-.RB [ \-N\  out_height]
-[file.rle [file.pix]]
-.SH DESCRIPTION
-.I rle-fb\^
-decodes a Utah Raster Toolkit
-Run-Length Encoded (RLE) format file
-(saved with
-.IR fb-rle\^ (1),
-.IR pix-rle (1),
-or a similar program),
-converts it into
-.IR pix\^ (5)
-format, and writes it to standard out.
-If
-.I file.rle\^
-is not specified, standard input is read.
-.I rle-pix\^
-determines the type and size of the saved file (color or B&W)
-and acts accordingly.
-.TP
-.B \-c
-is the colormap \fIcrunch\fR flag.
-If the crunch flag has been specified and
-a non-linear colormap is stored in the RLE file,
-then the colormap is applied to the pixels as they are output.
-Otherwise, the encoded pixel values are output without being affected by
-any color map stored in the RLE file.
-.TP
-.B \-d
-Debug option, provides a description of the parameters of the
-saved RLE image on standard error.
-.TP
-.BI \-C r/g/b\^
-The background of the image is
-normally set to the value recorded in the RLE file.
-This option permits
-the user to specify an alternate background color
-as slash separated decimal numbers in the range of 0 to 255,
-one each for the red, green, and blue channels.
-.TP
-.I file.rle\^
-Name of file to decode, in RLE format.
-.TP
-.I file.pix\^
-Optional name of file to store PIX image in.
-.SH EXAMPLE
-.RS
-\fI\|rle-pix \|tank.rle \| tank.pix\fR
-.RE
-.SH "SEE ALSO"
-brlcad(1), fb-rle(1), fb-rle(1), pix-fb(1), rle-pix(1), pix(5).
-.SH AUTHOR
-Michael John Muuss
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/sun-pix.1
===================================================================
--- brlcad/src/util/sun-pix.1	(revision 53937)
+++ brlcad/src/util/sun-pix.1	(working copy)
@@ -1,114 +0,0 @@
-.TH SUN-PIX 1 BRL-CAD
-.\"                      S U N - P I X . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1989-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-sun\(hypix \-
-convert Sun bitmaps from screendump(1) into pix(5) or bw(5) raster image
-.SH SYNOPSIS
-.B sun-pix
-.RB [ \-b ]
-.RB [ \-h ]
-.RB [ \-i ]
-.RB [ \-P ]
-.RB [ \-v ]
-[sun.bitmap]
-.SH DESCRIPTION
-.I Sun-pix
-is a program to take Sun bitmap files created with Sun's
-.IR screendump (1)
-command, and convert them to a
-.IR pix (5)
-format file.  If the
-.B \-b
-flag is specified, a
-.IR bw (5)
-format file is created instead.
-The dimensions of the input file are the dimensions of the output
-file;  invoking
-.I sun-pix
-with the
-.B \-h
-flag will cause the size of the image to be printed without further
-processing of the input, or generation of any other output.
-The image size is output as a pair
-of command line options (\fIie,\fB -w1152 -n900\fR) suitable
-for use with other
-.IR brlcad (1)
-tools such as
-.IR pix-fb (1).
-When the
-.B \-v
-flag is specified, all the fields of the header are printed on stderr,
-to aid debugging.  Note that the ``encoded'' format is not supported.
-.PP
-Specifying the
-.B \-i
-flag will invert the sense of a one-bit wide input image, \fIie\fR,
-exchanging black for white.  The default Sun image is black print on
-white background; the
-.B \-i
-flag will give a white image on black background, which is often better
-for purposes of creating overlays to be composited with
-.IR pixmerge (1)
-on top of color images.
-.PP
-The
-.B \-P
-flag indicates that the input is a pure bitmap with no Sun-style header
-on it.  The first bit to be processed will be the most significant bit (MSB),
-\fIie\fR, the left-most bit in the byte.
-.PP
-Note that the input file is expected to be in Sun (``network'') byte order
-(\fIie\fR, ``big-endian'', with byte 0 on the left), regardless
-of the byte order of the machine running this program.
-.SH BUGS
-24-bit images are not supported yet.
-.SH "SEE ALSO"
-brlcad(1), pix-fb(1), pixmerge(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1989-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/terrain.1
===================================================================
--- brlcad/src/util/terrain.1	(revision 53937)
+++ brlcad/src/util/terrain.1	(working copy)
@@ -1,153 +0,0 @@
-.TH TERRAIN 1 BRL-CAD
-.\"                      T E R R A I N . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 2000-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-terrain \- Generate terrain field from mathematical noise
-.SH SYNOPSIS
-.B terrain
-.I [ -w x_postings]
-.I [ -n y_postings]
-.I [ -s xy_postings]
-.I [ -L noise_Lacunarity]
-.I [ -H noise_H_value]
-.I [ -O noise_octaves]
-.I [ -o noise_offset]
-.I [ -S noise_scale]
-.I [ -V noise_Vector_scale]
-.I [ -D noise_Delta]
-.I [ -f noise_function]
-.I [ -c host/net format conversion off]
-> file.dsp
-.SH DESCRIPTION
-The
-.I terrain
-program produces pseudo-terrain from procedural noise suitable for use with a
-BRL-CAD dsp primitive.  Noise values are computed for the grid points of the
-lattice and the resultant values are output on the standard output as unsigned
-shorts in network byte order.  The size of the grid is specified with the
-.I -w
-and
-.I -n
-options.
-
-
-.SH OPTIONS
-.PP
-.PD 0
-.TP 10
-.BI -w "\| grid_x_postings"
-Specifies the number of grid points in the X dimension.  Default is 256.
-.TP
-.BI -n "\| grid_y_postings"
-Specifies the number of grid points in the Y dimension.  Default is 256.
-.TP
-.B -c
-Turns of the conversion of the data from host to network format.  This only
-has an effect on little-endian machines.
-.TP
-.B -v
-Turns on verbose mode.  Information about which filter is running is printed.
-.TP
-.BI -f "\| noise_type"
-Selects the type of noise field to be used.  Options include
-.RS
-.TP
-.B L
-A lunar-like surface.
-.TP
-.B f
-Fractional Brownian motion (fBm).
-.TP
-.B t
-Turbulence.
-.TP
-.B T
-Turbulence inverted: 1.0 - turb(pt).
-.TP
-.B m
-A Multi-fractal.
-.TP
-.B r
-A Ridged multi-fractal.
-.RE
-.PD
-.PP
-.SS Noise Options
-.TP 10
-.TP
-.BI \-O "\| noise_octaves"
-Specifies the number of octaves of noise to layer.
-Typical values are 2 through 8.
-.BR $0 .
-.TP
-.BI \-L "\| noise_Lacunarity"
-Specifies the scaling factor between successive octaves of noise.  Practical
-values are non-integer numbers between 1.7 and 4.0.
-
-.TP
-.BI \-H "\| noise_H_val"
-Specifies the value of H in the noise equation.  Usually 1.0
-
-.TP
-.BI \-S "\| noise_scale"
-Scales the noise uniformly in X, Y and Z dimensions by the value
-.I noise_scale.
-Values below 1.0 cause the noise pattern to become smaller. Values above 1.0 cause it to get bigger
-
-.TP
-.BI \-V "\| scale_x,scale_y,scale_z"
-Allows non-uniform scaling of the X, Y and Z dimensions.  See
-.I -S
-above.
-
-.TP
-.BI \-D "\| delta_x,delta_y,delta_z"
-Specifies a translation in noise space to be
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 2000-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
Index: brlcad/src/util/wavelet.1
===================================================================
--- brlcad/src/util/wavelet.1	(revision 53937)
+++ brlcad/src/util/wavelet.1	(working copy)
@@ -1,156 +0,0 @@
-.TH WAVELET 1 BRL-CAD
-.\"                      W A V E L E T . 1
-.\" BRL-CAD
-.\"
-.\" Copyright (c) 1999-2012 United States Government as represented by
-.\" the U.S. Army Research Laboratory.
-.\"
-.\" Redistribution and use in source (Docbook format) and 'compiled'
-.\" forms (PDF, PostScript, HTML, RTF, etc.), with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code (Docbook format) must retain the
-.\" above copyright notice, this list of conditions and the following
-.\" disclaimer.
-.\"
-.\" 2. Redistributions in compiled form (transformed to other DTDs,
-.\" converted to PDF, PostScript, HTML, RTF, and other formats) must
-.\" reproduce the above copyright notice, this list of conditions and
-.\" the following disclaimer in the documentation and/or other
-.\" materials provided with the distribution.
-.\"
-.\" 3. The name of the author may not be used to endorse or promote
-.\" products derived from this documentation without specific prior
-.\" written permission.
-.\"
-.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY
-.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
-.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-.\" USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\".\".\"
-.SH NAME
-wavelet \- perform a haar wavelet decomposition/reconstruction
-.SH SYNOPSIS
-.B wavelet
-.BR [\-1]
-.BR [\-2]
-.BR [\-d]
-.BR [\-r]
-.BR [\-#\ channels ]
-.BR [\-t\ {c | d | f | i | l | s}]
-.BR [\-w\ width]
-.BR [\-n\ scanlines ]
-.BR [\-s\ squaresize ]
-.BR [\-S\ square_out_size ]
-.BR [\-W\ width_out ]
-\<\ file > wavelet
-.SH DESCRIPTION
-The
-.I wavelet
-command
-will perform Haar wavelet decomposition or reconstruction
-transforms
-on the input dataset.
-The command line options are:
-
-.BI \-d
-perform decomposition.
-
-.BI \-r
-perform reconstruction.
-
-.br
-.BI \-1
-perform a 1-dimensional (horizontal) transform.
-
-.BI \-2
-perform a 1-dimensional (interleaved horizontal and vertical) transform.
-
-.BI \-#\ channels
-Indicates the number of values in each sample point.  For example, to perform
-a transform on a
-.IR pix (5)
-file properly, specify ``-# 3''.  This causes the red, green and blue channels
-to be transformed individually.
-
-.BI \-t\ {cdfils}
-specifies the data type of the input, and hence the data type in which the
-wavelet calculations will be performed.
-The letters each stand for the first
-character of the C programming language data type:
-\fBc\fRharacter,
-\fBd\fRouble,
-\fBf\fRloat,
-\fBi\fRnt,
-\fBl\fRong,
-\fBs\fRhort.
-Note that if lossless decomposition
-and reconstruction are desired, then data sets should be converted to the next
-larger data type before being processed.
-
-
-.BI \-w\ width
-Specify the number of samples per scanline.
-
-.BI \-n\ scanline
-Specify the number of scanlines in the dataset
-
-.BI \-s\ squaresize
-Specify both width and scanlines simultaneously (square image).
-
-.BI \-W\ width_out
-Specifies the width of the output image.  Normally this is 1 for a full
-decomposition/reconstruction.  You may specify a width at which decomposition or reconstruction
-should stop. This number should be a power of 2.  The result will be an
-``average'' image of the specified size, with the remainder of the original
-data width converted to ``detail'' coefficients.  See also: -R
-
-.BI \-R\ avg_size
-Resumes a transform that left off with an average image of avg_size.
-
-
-.BI \-S\ square_out_size
-This is the same as the
-.B \-W
-option.  It implies the square size for a 2D decomposition limit.
-
-
-.SH EXAMPLES
-
-
-The command
-.br
-.I decompose -# 3 < img.pix | pix-fb
-.br
-will display the horizontal decomposition of the file img.pix.
-
-The command
-.br
-.I decompose -# 3 -s 1024 -l 64 < img.pix >
-.br
-will decompose a 1024x1024 image.  The decomposition will stop when the
-image has been decomposed to 64x64.  The output image will thus have a 64x64
-version of the original in the lower left corner of the image, with detail
-terms in the remainder.
-.SH "SEE ALSO"
-brlcad(1), pix(5), bw(5)
-
-.SH AUTHOR
-BRL-CAD Team
-
-.SH COPYRIGHT
-This software is Copyright (c) 1999-2012 by the United States
-Government as represented by U.S. Army Research Laboratory.
-.SH "BUG REPORTS"
-Reports of bugs or problems should be submitted via electronic
-mail to <devs@brlcad.org>.
