Index: brlcad/doc/docbook/system/man1/en/fbcmrot.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbcmrot.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbcmrot.xml (revision 0)
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbcmrot1'>
+<refmeta>
+<refentrytitle>FBCMROT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbcmrot</refname>
+<refpurpose>rotate the color map</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbcmrot</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-i <replaceable>increment</replaceable></arg>
+    <arg choice='plain'><replaceable>steps_per_second</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbcmrot</emphasis>
+rotates the color map, cycling each color map entry through all of the
+color map positions.
+The
+<emphasis remap='I'>frames_per_second</emphasis>
+is the number of shifts per second to generate.
+This value can be fractional.
+An unspecified frame rate causes the program to cycle through
+the color maps as fast as possible.
+A
+<emphasis remap='I'>frames_per_second</emphasis>
+of zero causes the program to make one step and then exit.</para>
+
+<para>Each step shifts the colormap one position toward smaller
+values (with a linear colormap this would cause displayed pixels
+to get brighter).  The
+<option>-i&nbsp;</option>increment
+option allows a shift of more than one position.  If
+<emphasis remap='I'>increment</emphasis>
+is negative, the colormap will be shifted the opposite
+direction (toward larger values).</para>
+
+<para>By default, the framebuffer is assumed to be 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag changes this to 1024x1024.
+This is only important for devices such as the Adage framebuffers
+which operate differently depending on the display size.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbgrid.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbgrid.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbgrid.xml (revision 0)
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbgrid1'>
+<refmeta>
+<refentrytitle>FBGRID</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbgrid</refname>
+<refpurpose>draw a grid on a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbgrid</command>    
+    <arg choice='opt'>-hcbdo </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</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>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbgrid</emphasis>
+is used to generate a grid on a frame buffer.
+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.
+If the
+<option>-h</option>
+option is used, a
+1024x1024 grid is written;
+alternatively, the
+<option>-SWN</option>
+options can all be used in the normal way to specify the size of
+the grid (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+The default grid size is 512x512.
+The framebuffer can be declared with the
+<option>-F</option>
+flag.
+<!-- .br -->
+<option>-c</option>
+will clear the screen before drawing.</para>
+
+<para>The available patterns are:
+<!-- .br -->
+<option>-b</option>
+for binary spacing with lines at 8, 64, and 128 line intervals.
+<!-- .br -->
+<option>-d</option>
+for decimal spacing with lines at 10, 50, and 100 line intervals
+(the default).
+<!-- .br -->
+<option>-o</option>
+for the old cross grid pattern.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbzoom</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbframe</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/bw-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/bw-fb.xml (revision 0)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='bwfb1'>
+<refmeta>
+<refentrytitle>BW-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bw&hyphen;fb</refname>
+<refpurpose>display a black and white bw image on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>bw-fb</command>    
+    <arg choice='opt'>-ahiczRGB </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</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'>-S <replaceable>squarescrsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>scr_height</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>file_xoff</replaceable></arg>
+    <arg choice='opt'>-y <replaceable>file_yoff</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>scr_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>src_yoff</replaceable></arg>
+    <arg choice='opt'><replaceable>infile.bw</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Bw-fb</emphasis>
+reads a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file
+from standard input if an input file is not given, and displays the
+image on the currently selected framebuffer.
+The environment variable
+<emphasis remap='I'>FB_FILE</emphasis>
+specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the
+<emphasis remap='I'>bw</emphasis>
+file, and the requested framebuffer size, 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 both of these sizes to 1024x1024.</para>
+
+<para>If the
+<option>-i</option>
+flag is specified, the image is output from top to bottom.
+Customarily,
+<emphasis remap='I'>bw</emphasis>
+files are stored bottom to top, so this
+inverts the image.</para>
+
+<para>The
+<option>-c</option>
+flag causes the screen to be cleared before the image is displayed.
+The default behavior is to overwrite the current image
+with the new image without clearing the screen.</para>
+
+<para>The
+<option>-z</option>
+flag will zoom and center on the image being displayed
+to make it fill the display area.</para>
+
+<para>The flags
+<option>-R</option>,<emphasis remap='B'>&nbsp;-G</emphasis>,&nbsp;and<emphasis remap='B'>&nbsp;-B</emphasis>
+select individual color planes into which the image will be loaded.
+One or more can be given.  By default all three colors are written
+with the
+<emphasis remap='I'>bw</emphasis>
+pixel value.</para>
+
+<para>The
+<option>-w&nbsp;</option>file_width
+flag specifies the width of each scanline in the input file, in pixels.
+<option>-W&nbsp;</option>scr_width
+does the same for the display device.</para>
+
+<para>The
+<option>-n&nbsp;</option>file_height
+and
+<option>-N&nbsp;</option>scr_height
+flags specify the height in scanlines of the input file or display device
+respectively.</para>
+
+<para><option>-s&nbsp;</option>squarefilesize
+and
+<option>-S&nbsp;</option>squarescrsize
+set both the height and width to the size given.</para>
+
+<para><option>-x&nbsp;</option>file_xoff,
+<option>-y&nbsp;</option>file_yoff,
+<option>-X&nbsp;</option>scr_xoff,
+and
+<option>-Y&nbsp;</option>scr_yoff
+will offset into the file or onto the screen by the given amounts.
+The coordinate system for these offsets is first quadrant, with
+the origin at the lower left corner of the image.</para>
+</refsect1>
+
+<refsect1 id='format'><title>FORMAT</title>
+<para>A
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file contains sequences of pixels.
+Each pixel is stored as one
+<emphasis remap='B'>unsigned char</emphasis>
+The first pixel in a
+<emphasis remap='I'>bw</emphasis>
+file is the lower left corner of the image.
+The pixels proceed from left-to-right across each scanline,
+with scanlines being written from the bottom to the top of the image.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>fb-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbclear.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbclear.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbclear.xml (revision 0)
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbclear1'>
+<refmeta>
+<refentrytitle>FBCLEAR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbclear</refname>
+<refpurpose>clear a frame buffer image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbclear</command>    
+    <arg choice='opt'><arg choice='plain'>-h </arg><arg choice='plain'>-c </arg></arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>red</replaceable></arg><arg choice='plain'><replaceable>green</replaceable></arg><arg choice='plain'><replaceable>blue</replaceable></arg></arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>fbclear</command>    
+    <arg choice='opt'><arg choice='plain'>-h </arg><arg choice='plain'>-c </arg></arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'><replaceable>gray_value</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbclear</emphasis>
+is used to erase a frame buffer using whatever method is efficient for the
+device being accessed.
+By default, the selected color will be flooded into the color planes.
+If the
+<option>-c</option>
+option is used,
+a standard linear colormap will be loaded and the pan and zoom values
+will be reset.</para>
+
+<para>If the optional color values are given,
+<command>fbclear</command>
+writes the specified color over the entire
+image.
+The color values must be in the range 0 to 255.
+In the second form shown above, the single gray_value is written into
+all three color channels.</para>
+
+<para>The frame buffer to be cleared is determined from the
+<option>-F</option>
+option if given.
+Otherwise 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.
+If the
+<option>-h</option>
+option is used on those devices where it makes a difference (e.g. Adage),
+the
+<!-- SM elided -->
+<emphasis remap='B'>HIRES</emphasis>
+(1024x1024x24) memory is cleared; otherwise a
+<!-- SM elided -->
+<emphasis remap='B'>LORES</emphasis>
+(512x512x24) device is assumed.</para>
+
+<para>In addition to those flags shown above, the
+<option>-W&nbsp;</option><replaceable>width</replaceable>
+<option>-N&nbsp;</option><replaceable>height</replaceable>
+and
+<option>-S&nbsp;</option><replaceable>square_size</replaceable>
+flags can be used to set the size of the output frame buffer.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbhelp</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbhelp.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbhelp.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbhelp.xml (revision 0)
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbhelp1'>
+<refmeta>
+<refentrytitle>FBHELP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbhelp</refname>
+<refpurpose>provide information on frame buffer selections</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbhelp</command>    
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbhelp</emphasis>
+displays information about the selection of frame buffer devices
+available to the
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+frame buffer library and the whole family of
+<emphasis remap='B'>fb&lowast;</emphasis>
+programs in the BRL-CAD package, for the machine
+<command>fbhelp</command>
+is run on.</para>
+
+<para>The display device used by a program is taken first from a
+<option>-F&nbsp;</option><replaceable>framebuffer</replaceable>
+option if given, else from the environment variable
+<!-- B elided -->
+<emphasis remap='SM'>FB_FILE,</emphasis>
+or finally from whatever the default display is for that system.
+<emphasis remap='I'>Fbhelp</emphasis>
+will tell you what the available choices of frame buffers are,
+as well as detailed information about any options the currently
+selected device may have.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/cell-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/cell-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/cell-fb.xml (revision 0)
@@ -0,0 +1,495 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='cellfb1'>
+<refmeta>
+<refentrytitle>CELL-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>cell-fb</refname>
+<refpurpose>display cell-by-cell data on a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>cell-fb</command>    
+    <arg choice='opt' rep='repeat'><replaceable>options</replaceable></arg>
+    <arg choice='opt'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Cell-fb</emphasis>
+reads a stream of cell-by-cell data
+and displays the data, one view at a time, on a frame buffer.
+If
+<emphasis remap='I'>file</emphasis>
+is specified, then
+<command>cell-fb</command>
+tries to read the data from it.
+Otherwise, the standard input is read.</para>
+
+<refsect2 id='options'><title>Options</title>
+<para>The command-line options and their meanings are given below.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-C</option></term>
+  <listitem>
+<para>Interpret the first three fields for each cell as an explicit color
+(see the
+<link linkend="definitions">DEFINITIONS</link>
+section below).
+The default behavior is to interpret a specified field as an indirect
+reference, which, through a color map, corresponds to a color.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-F</option><replaceable>fbfile</replaceable></term>
+  <listitem>
+<para>Write graphics output to
+<emphasis remap='I'>fbfile,</emphasis>
+which may be any UNIX file (or frame-buffer device).
+In the absence of the
+<option>-F</option>
+option,
+if the shell variable
+<emphasis remap='B'>FB_FILE</emphasis>
+is defined,
+its value is used
+(see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+Otherwise, the host's default frame buffer is used
+(see
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3B</manvolnum></citerefentry>).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-N</option><replaceable>scr_height</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) height to
+<emphasis remap='I'>scr_height</emphasis>
+pixels.
+<emphasis remap='I'>Scr_height</emphasis>
+may legally be any integer greater than -2.
+See the discussion of autosizing below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S</option><replaceable>scr_size</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) width and height to
+<emphasis remap='I'>scr_size</emphasis>
+pixels.
+<emphasis remap='I'>Scr_size</emphasis>
+may legally be any integer greater than -2.
+See the discussion of autosizing below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W</option><replaceable>scr_width</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) width to
+<emphasis remap='I'>scr_width</emphasis>
+pixels.
+<emphasis remap='I'>Scr_width</emphasis>
+may legally be any integer greater than -2.
+See the discussion of autosizing below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-X</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Set the local debug flag to the hexadecimal value
+<emphasis remap='I'>n.</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-a</option><replaceable>&ldquo;h v&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Do not display the data,
+simply print out the frame-buffer coordinates of the grid-plane point
+(<emphasis remap='I'>h, v</emphasis>).
+This option is useful for outboard manipulation of the
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+data created by
+<emphasis remap='I'>cell-fb.</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-b</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Ignore values not equal to
+<emphasis remap='I'>n.</emphasis>
+All other cell-data values are mapped to the background color.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Assume a cell size of
+<emphasis remap='I'>n</emphasis>
+user units.
+The default cell size is 100 user units.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option><replaceable>&ldquo;m n&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Scale the data values from the interval
+[<emphasis remap='I'>m, n</emphasis>]
+into the unit interval [0, 1].
+The scaling is performed before values are mapped to colors,
+so the
+<option>-i,</option>
+<option>-k,</option>
+and
+<option>-m</option>
+options always deal with the
+discrete values listed in the description below of the
+<option>-k</option>
+option.
+The default domain is [0, 1],
+for which no scaling is necessary.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-e</option></term>
+  <listitem>
+<para>Erase the frame buffer before displaying each view.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-f</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Display field number
+<emphasis remap='I'>n</emphasis>
+of the cell-by-cell data
+(see the
+<link linkend="definitions">DEFINITIONS</link>
+section below).
+By default, field 1 is displayed.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-g</option></term>
+  <listitem>
+<para>Display the grid.
+Causes a 1-pixel spacing between cells in the output.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>Force high-resolution display (1024&times;1024 pixels).
+See the discussion of autosizing below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i</option></term>
+  <listitem>
+<para>Round values to the nearest discrete value
+listed in the description of the
+<option>-k</option>
+option below.
+By default, output colors are chosen by interpolation between
+those values.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-k</option></term>
+  <listitem>
+<para>Display the color key.
+This option displays the color mappings for 11 discrete values underneath
+the picture.
+The values represented are, from left to right:
+0.0, 0.1, 0.2, ..., 0.9, and 1.0.
+Given this option
+and snug-fit autosizing for height,
+the frame buffer that
+<command>cell-fb</command>
+opens will be taller to accommodate the key.
+See the discussion of autosizing below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-l</option><replaceable>&ldquo;az el&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Write log information to the standard output.
+When given this option,
+<command>cell-fb</command>
+produces a header comment and one line each reporting
+an azimuth/elevation pair (viz.
+(<emphasis remap='I'>az</emphasis>, <emphasis remap='I'>el</emphasis>)
+) to associate with this view;
+the coordinates (in user units) of
+the lower-left and upper-right corners of the frame buffer;
+and the width and height (in pixels) of the frame buffer.
+This information may be useful in registering other images
+on top of a cell plot.
+If a single view has not been specified,
+this option causes an implicit
+<option>-v</option> 1,
+which may, of course, be overridden explicitly.
+N.B.&mdash;<emphasis remap='I'>Cell-fb</emphasis>
+makes no use whatever of the values
+<emphasis remap='I'>az</emphasis> and <emphasis remap='I'>el</emphasis>,
+it merely writes them to the log.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-m</option><replaceable>&ldquo;n color&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Map cell data value
+<emphasis remap='I'>n</emphasis>
+to
+<emphasis remap='I'>color.</emphasis>
+The value
+<emphasis remap='I'>n</emphasis>
+will be truncated, if necessary, to
+the nearest lower of the discrete values listed in the description of the
+<option>-k</option>
+option above.
+The background color can be indexed by specifying the value 1.1 for
+<emphasis remap='I'>n.</emphasis>
+For the meaning and format of
+<emphasis remap='I'>color,</emphasis>
+see the
+<link linkend="definitions">DEFINITIONS</link>
+section below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-M</option><replaceable>&ldquo;color1 color2&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Define the color map
+to be a ramp between
+<emphasis remap='I'>color1</emphasis> and <emphasis remap='I'>color2.</emphasis>
+This allows frugality with the colors in an image:
+if, for example, cell data is plotted in gray scale,
+then many other colors remain for use in
+text, call outs, and sundry markings on top of the cell data.
+The default color map
+is a typical cold-to-hot, blue-to-red scale,
+excepting that the smallest value in the input domain
+is mapped to white.
+For the meaning and format of
+<emphasis remap='I'>color1</emphasis> and <emphasis remap='I'>color2,</emphasis>
+see the
+<link linkend="definitions">DEFINITIONS</link>
+section below.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-p</option><replaceable>&ldquo;h v&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Offset the picture from the lower-left corner of the frame buffer display
+by
+<emphasis remap='I'>h</emphasis>
+pixels horizontally, and
+<emphasis remap='I'>v</emphasis>
+pixels vertically.
+If this option is specified with only one argument,
+then the horizontal and vertical offsets are both set to this value.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s</option><replaceable>&ldquo;w h&rdquo;</replaceable><emphasis remap='B'></emphasis></term>
+  <listitem>
+<para>Plot each cell as a rectangle of width
+<emphasis remap='I'>w</emphasis>
+pixels and height
+<emphasis remap='I'>h</emphasis>pixels.
+This option has the effect of scaling the picture independently in the
+horizontal and vertical dimensions.
+The default is 10 pixels per cell in each dimension, not including the
+grid.
+If this option is specified with only one argument,
+then the width and height are both set to this value.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Display only view number
+<emphasis remap='I'>n.</emphasis>
+Views are numbered starting at 1.
+If
+<emphasis remap='I'>n</emphasis> = 0,
+all views are displayed sequentially,
+which is the default behavior.
+The option
+<option>-v</option> 0
+implicitly turns off logging.
+(see the
+<option>-l</option>
+option above).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-x</option><replaceable>n</replaceable></term>
+  <listitem>
+<para>Set the
+<citerefentry><refentrytitle>libbu</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+debug flag to the hexadecimal value
+<emphasis remap='I'>n.</emphasis>
+This option is useful primarily in debugging
+memory allocation.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 id='hint'><title>HINT</title>
+<para>If multiple views are input,
+the user will be asked between views whether he wants to see the next view.
+While being prompted, the user can save the previous image by using a
+utility such as
+<citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='discussion'><title>DISCUSSION</title>
+<para><emphasis remap='I'>Cell-fb</emphasis>
+determines the appropriate width and height of the frame buffer
+independently.
+For each there are three methods.
+If the sizes are provided explicitly, with the
+<option>-N,</option>
+<option>-S,</option>
+or
+<option>-W</option>
+options,
+<command>cell-fb</command>
+will use exactly the specified values.
+Otherwise,
+it performs autosizing for each view.
+<emphasis remap='I'>Cell-fb</emphasis>'s
+original behavior is called loose-fit autosizing.
+In that case, a frame-buffer dimension will be set to 512 pixels
+unless the image will not fit,
+in which case a 1024-pixel dimension is used.
+Loose-fit autosizing may be specified by any of
+<option>-N</option>0,
+<option>-S</option>0,
+or
+<option>-W</option>0.
+The third method is another form of autosizing,
+called snug-fit.
+For this method,
+<command>cell-fb</command>
+computes the minimum measurement required to display the plot,
+given the data and whatever values have been specified for the
+<option>-c,</option>
+<option>-g,</option>
+<option>-k,</option>
+<option>-p,</option>
+and
+<option>-s</option>
+options.
+Snug-fit autosizing is the default method for both width and height
+of the frame buffer,
+and it may be explicitly specified by any of
+<option>-N</option>-1,
+<option>-S</option>-1,
+or
+<option>-W</option>-1.
+Whenever autosizing is performed,
+<command>cell-fb</command>
+prints to the standard error the actual width and height used for each view.</para>
+</refsect1>
+
+<refsect1 id='definitions'><title>DEFINITIONS</title>
+<para>A stream of cell-by-cell data contains one or more views,
+each of which may start with view-header information and contains
+one line of data for each cell in the view.
+Each line of cell data must be in the following format:</para>
+
+  <blockquote remap='RS'>
+<para><emphasis remap='I'>coords fields</emphasis>
+  </para></blockquote> <!-- remap='RE' -->
+
+<para>where
+<emphasis remap='I'>coords</emphasis>
+is two real numbers and
+<emphasis remap='I'>fields</emphasis>
+is one or more real numbers.
+All the numbers on a line of cell data are separated by
+non-empty strings of white space (blanks and tabs)
+and there may be leading white space on the line.
+<emphasis remap='I'>Coords</emphasis>
+are the grid-plane coordinates of the cell,
+which must be spaced consistently with the cell size,
+and
+<emphasis remap='I'>fields</emphasis>
+may have arbitrary significance.
+If the
+<option>-f</option><replaceable>n</replaceable>
+option is specified, then there must be at least
+<emphasis remap='I'>n</emphasis>
+fields of cell data,
+and if the
+<option>-C</option>
+option is specified, then there must be at least three fields of cell data.
+The view-header information may span multiple lines, and the only restriction
+on its format is that it not pass for data.</para>
+
+<para>A color is specified as a triple</para>
+
+  <blockquote remap='RS'>
+<para><emphasis remap='I'>r g b</emphasis>
+  </para></blockquote> <!-- remap='RE' -->
+
+<para>of integers, each between 0 and 255 (inclusive).
+These values represent intensities of red, green, and blue, respectively.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>The following invocation will display the cell-by-cell data from
+<emphasis remap='I'>inputs</emphasis>
+on the default frame buffer on the network host
+<emphasis remap='I'>fictitious.brlcad.org</emphasis>.
+It will display all views with the grid turned
+on (space between cells),
+positioned with the left-most cell 20 cells to the right
+of the display origin (lower left),
+and the lowest cell 30 cells above the display origin,
+the color key will appear underneath the
+grid of cells, and the display will be erased before each view is drawn.</para>
+
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>cell-fb &thinsp;-F &thinsp;fictitious.brlcad.org: &thinsp;-gek &thinsp;-p &thinsp;&ldquo;20 30&rdquo; &thinsp;inputs
+</synopsis>
+</emphasis></literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rtregis</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='authors'><title>AUTHORS</title>
+<itemizedlist remap='TP'>
+
+  <listitem><para>Gary S. Moss, BRL/VLD-VMB</para></listitem>
+  <listitem><para>Paul J. Tanenbaum, BRL/VLD-GSB</para></listitem>
+
+
+</itemizedlist>
+</refsect1>
+
+<refsect1 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 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/cmap-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/cmap-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/cmap-fb.xml (revision 0)
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='cmapfb1'>
+<refmeta>
+<refentrytitle>CMAP-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>cmap&hyphen;fb</refname>
+<refpurpose>load a colormap into a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>cmap-fb</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-o </arg>
+    <arg choice='opt'><replaceable>colormap</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Cmap-fb</emphasis>
+loads a colormap into a framebuffer.  A colormap
+file can be specified on the command line, otherwise standard
+input will be read.
+The format of the colormap input is described in
+<citerefentry><refentrytitle>cmap</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+<para>Any colormap entries not listed in the input will be set to
+zero (black), unless the
+<option>-o</option>
+flag is specified in which case the values currently in
+the framebuffer will be retained (one can view this as
+"overlaying" the existing colormap).</para>
+
+<para>By default, the display is assumed to be 512x512 pixels;
+by specifying the
+<option>-h</option>
+flag, the size is changed to 1024x1024.
+This size distinction is important for devices like the Adage
+framebuffers which have different operating modes based on the
+display size.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-cmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>cmap</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1987-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 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/fb-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-fb.xml (revision 0)
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbfb1'>
+<refmeta>
+<refentrytitle>FB-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb-fb</refname>
+<refpurpose>copy an image on one frame buffer to another</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-fb</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-F <replaceable>output_framebuffer</replaceable></arg>
+    <arg choice='plain'><replaceable>input_framebuffer</replaceable></arg>
+    <arg choice='opt'><replaceable>output_framebuffer</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fb-fb</emphasis>
+copies an image from the input frame buffer onto the output frame
+buffer.
+The framebuffer may also be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>The
+<option>-v</option>
+flag sets verbose mode.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</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>fb-orle</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/CMakeLists.txt
===================================================================
--- brlcad/doc/docbook/system/man1/en/CMakeLists.txt (revision 53906)
+++ brlcad/doc/docbook/system/man1/en/CMakeLists.txt (working copy)
@@ -54,6 +54,43 @@
   tire.xml
   vdeck.xml
   viewpoint-g.xml
+  cmap-fb.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
Index: brlcad/doc/docbook/system/man1/en/fbstretch.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbstretch.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbstretch.xml (revision 0)
@@ -0,0 +1,227 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbstretch1'>
+<refmeta>
+<refentrytitle>FBSTRETCH</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbstretch</refname>
+<refpurpose>stretch a frame buffer image</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbstretch</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><arg choice='plain'>-f </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>image</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-s </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>square</replaceable></arg><arg choice='plain'><replaceable>size</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-w </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <sbr/>
+    <arg choice='opt'><arg choice='plain'>-n </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <arg choice='opt'>-a </arg>
+    <arg choice='opt'><arg choice='plain'>-x </arg><arg choice='plain'><replaceable>horizontal</replaceable></arg><arg choice='plain'><replaceable>scale</replaceable></arg><arg choice='plain'><replaceable>factor</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-y </arg><arg choice='plain'><replaceable>vertical</replaceable></arg><arg choice='plain'><replaceable>scale</replaceable></arg><arg choice='plain'><replaceable>factor</replaceable></arg></arg>
+    <sbr/>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><arg choice='plain'>-S </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>square</replaceable></arg><arg choice='plain'><replaceable>size</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-W </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-N </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <sbr/>
+    <arg choice='opt'><arg choice='opt'>-F </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>frame</replaceable></arg><arg choice='plain'><replaceable>buffer</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<!-- .lg 0  IGNORED -->
+<para>&shy;fbstretch
+<!-- .lg  IGNORED -->
+expands or compresses a frame buffer image,
+in either or both the horizontal and vertical directions.
+The image scaling origin (fixed point) is
+the lower left-hand corner of the display.
+When expanding (scale factor greater than 1), pixels are simply replicated;
+when compressing (scale factor less than 1), pixel averaging is performed
+unless sampling is explicitly requested by the
+<!-- .lg 0  IGNORED -->
+&shy;-a
+<!-- .lg  IGNORED -->
+option.</para>
+
+<refsect2 id='options'><title>Options</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term>&shy;-h</term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;high resolution&rdquo;)Assumes 1024 by 1024 pixels for default input image size
+instead of 512 by 512.
+Explicitly specified sizes override the default,
+and if actual input image size is smaller than requested,
+the actual size will be used.
+If not specified,
+requested output frame buffer size will be the stretched revised input size.
+If there are margins within the requested output beyond the stretched image,
+they will be cleared to background;
+if the stretched image would extend beyond the requested output size,
+it will be clipped to fit,
+even if there is room for it in the actual frame buffer.
+Actual sizes depend on details of specific frame buffers.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-f <emphasis remap='I'>input image name</emphasis></term>
+  <listitem>
+<para>Inputs the image to be displayed
+from the specified frame buffer or <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry> file,
+instead of modifying the output frame buffer in place.
+This option may not work if input and output frame buffers are the same device.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-s<emphasis remap='P->I'> input square size</emphasis></term>
+  <listitem>
+<para>Specifies input image width and height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-w<emphasis remap='P->I'> input width</emphasis></term>
+  <listitem>
+<para>Specifies input image width.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-n<emphasis remap='P->I'> input height</emphasis></term>
+  <listitem>
+<para>Specifies input image height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-a<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;no averaging&rdquo;)Specifies that output pixels will be sampled from the input,
+instead of being computed by averaging RGB values.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-v<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;verbose&rdquo;)Causes actual sizes and scale factors used
+to be printed on the standard error output.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-x<emphasis remap='P->I'> horizontal scale factor</emphasis></term>
+  <listitem>
+<para>Scales the image by the specified factor in the horizontal direction;
+the default is the ratio of requested output to input widths,
+if specified,
+otherwise 1.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-y<emphasis remap='P->I'> vertical scale factor</emphasis></term>
+  <listitem>
+<para>Scales the image by the specified factor in the vertical direction;
+the default is the ratio of requested output to input heights,
+if specified,
+otherwise 1.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-S<emphasis remap='P->I'> output square size</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer width and height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-W<emphasis remap='P->I'> output width</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer width.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-N<emphasis remap='P->I'> output height</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-F<emphasis remap='P->I'> output frame buffer name</emphasis></term>
+  <listitem>
+<para>Outputs to the specified frame buffer
+instead of the one specified by the
+<!-- .lg 0  IGNORED -->
+&shy;FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+environment variable
+(or the default, if
+<!-- .lg 0  IGNORED -->
+&shy;</emphasis>FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+is not set).
+If this is the last option specified, the
+<!-- .lg 0  IGNORED -->
+&shy;</emphasis>-F<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+is optional.</emphasis></para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 id='discussion'><title>DISCUSSION</title>
+<para>Pixel averaging may be meaningless for some images or color maps,
+in which case sampling should be specified.
+Images of the Mandelbrot set (see <citerefentry><refentrytitle>mandel</refentrytitle><manvolnum>1</manvolnum></citerefentry>)
+are a good example of this.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>The following procedure enlarges an image,
+obtained from a personal computer
+<emphasis remap='I'>via</emphasis>
+the
+<!-- .lg 0  IGNORED -->
+&shy;gif-fb<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+utility,
+to fill a 1280-by-1024 frame buffer.</emphasis></para>
+  <blockquote remap='RS'>
+<para><emphasis remap='I'>$</emphasis> &thinsp;gif-fb &thinsp;image.gif	# <emphasis remap='P->I'>displays the 320x200 PC image</emphasis>
+<!-- .br -->
+<emphasis remap='I'>$</emphasis> &thinsp;fbstretch &thinsp;-w 320 &thinsp;-n 200 &thinsp;-W 1280 &thinsp;-N 1024</para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>gif-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>mandel</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Douglas A. Gwyn, BRL/VLD-VMB</para>
+
+</refsect1>
+
+<refsect1 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 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/fb-pix.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-pix.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-pix.xml (revision 0)
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbpix1'>
+<refmeta>
+<refentrytitle>FB-PIX</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb&hyphen;pix</refname>
+<refpurpose>save a framebuffer image in a color pix file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-pix</command>    
+    <arg choice='opt'>-hic </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</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.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fb-pix</emphasis>
+will take a region of a framebuffer display and save it as a color
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If this variable is not set, the default device for your system will
+be used.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the output
+<emphasis remap='I'>pix</emphasis>
+file, and the requested framebuffer size, is assumed to be 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag, changes the default to 1024x1024.
+The
+<option>-s</option>
+flag will set both the file height and width to be the given size, while
+<option>-w</option>
+and
+<option>-n</option>
+sets them individually.</para>
+
+<para>A first quadrant coordinate system is used (origin in lower left of
+screen), and the area saved is normally from this origin.
+The
+<option>-i</option>
+flag switches to a fourth quadrant system, both in the storage order as
+well as the origin offset coordinates (i.e. origin is now the upper left
+corner of the screen).</para>
+
+<para>The
+<option>-c</option>
+flag specifies that the color map in the frame buffer should
+be applied to the pixel values (&ldquo;crunched&rdquo;) before they are written to the
+output file.</para>
+</refsect1>
+
+<refsect1 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>fb-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/orle-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/orle-fb.xml (revision 0)
@@ -0,0 +1,175 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='orlefb1'>
+<refmeta>
+<refentrytitle>ORLE-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>orle&hyphen;fb</refname>
+<refpurpose>decode old run-length encoded image onto a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>orle-fb</command>    
+    <arg choice='opt'>-Otdv </arg>
+    <arg choice='opt'><arg choice='plain'>-b </arg><arg choice='opt'><replaceable>rgbwBG</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-F </arg><arg choice='plain'><replaceable>framebuffer</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-p </arg><arg choice='plain'><replaceable>x</replaceable></arg><arg choice='plain'><replaceable>y</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>file.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>orle-fb</emphasis>
+decodes an old, Edition-2
+University of Utah standard Run-Length Encoded (RLE) format file
+(saved with
+<citerefentry><refentrytitle>fb-orle</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+or a similar program)
+to a frame buffer device or a file.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, standard input is read.
+<emphasis remap='I'>orle-fb</emphasis>
+determines the type and size of the saved file (color or B&amp;W)
+and acts accordingly.
+The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If this variable is not set, the default device for your system will
+be used.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-t</option></term>
+  <listitem>
+<para>Alters the normal bottom-up display order to be top-down.
+This option can be useful when the image contains accompanying text.
+Note that the image is inverted in memory, using as large a buffer as
+<emphasis remap='I'>malloc(3)</emphasis>
+will permit.  This means that the entire image will be decoded
+before output will begin appearing.</para>
+  </listitem>
+  </varlistentry>
+  <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>-O</option></term>
+  <listitem>
+<para>Restores the image data in <emphasis remap='I'>overlay</emphasis> mode.
+Only areas of the original image which were not the background color are
+decoded.  The rest of the image already in the frame buffer is undisturbed.
+Note that this mode uses twice as many DMAs to the frame buffer as
+the normal mode, as the previous image must be read back into the host.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-b</option><replaceable>x</replaceable></term>
+  <listitem>
+<para>If the image is not being decoded in overlay mode, the background 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><option>-p</option><replaceable>x y</replaceable></term>
+  <listitem>
+<para>Reposition the image.
+The original lower left corner is positioned at
+(<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>)
+before restoring the image.
+Warning:
+a saved image should not be
+repositioned so that any saved data wraps around the X borders.  If the
+input image is 512x512,
+and it is repositioned, the framebuffer will be opened in
+1024x1024 mode.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-F&nbsp;framebuffer</option></term>
+  <listitem>
+<para>indicates that the output should be sent to the indicated framebuffer.
+See
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+for more details on the specification of a framebuffer.</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 id='examples'><title>EXAMPLES</title>
+  <blockquote remap='RS'>
+<para>&thinsp;orle-fb &thinsp;truck.rle
+<!-- .br -->
+&thinsp;orle-fb &thinsp;-Ot &thinsp;text.rle
+<!-- .br -->
+&thinsp;orle-fb &thinsp;-bG &thinsp;&lt;car.rle
+  </para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <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>,
+<citerefentry><refentrytitle>liborle</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fb-orle.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-orle.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-orle.xml (revision 0)
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fborle1'>
+<refmeta>
+<refentrytitle>FB-ORLE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb&hyphen;orle</refname>
+<refpurpose>save a frame buffer image in old run-length encoded form</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-orle</command>    
+    <arg choice='opt'>-CShvw </arg>
+    <arg choice='opt'><arg choice='plain'>-c </arg><arg choice='opt'><replaceable>rgbwBG</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-l </arg><arg choice='plain'><replaceable>x</replaceable></arg><arg choice='plain'><replaceable>y</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-p </arg><arg choice='plain'><replaceable>x</replaceable></arg><arg choice='plain'><replaceable>y</replaceable></arg></arg>
+    <arg choice='opt'><replaceable>file.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>fb-orle</emphasis>
+saves a frame buffer image in a file, using the
+old University of Utah standard (Edition-2)
+Run-Length Encoded (RLE) 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'>fb-rle(1)</emphasis>.</para>
+
+<para>The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If this variable is not set, the default device for your system will
+be used.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, the encoded file is written to standard output.
+<emphasis remap='I'>fb-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.
+The default action is to encode only data
+pixels and to save the background color separately, so that when the image
+is restored all non-image pixels will be set to the background pixel value
+stored in the RLE header.
+Images saved in this mode may be displayed normally, or in &ldquo;overlay&rdquo;
+mode by the RLE decoder program (see
+<citerefentry><refentrytitle>orle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>).
+Alternatively, the
+<option>-S</option>
+option may be used to RLE encode the background as well (recommended only
+if you don't have a flat background).</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-C</option></term>
+  <listitem>
+<para>Convert (&ldquo;crunch&rdquo;) an image with a non-standard color map so that the
+RLE file created will redisplay with a standard color map.
+Useful to preserve dramatic images created with weird color maps
+so that Gamma correction (for film) can then also be applied.
+This option is recommended when producing images for export to other
+display systems, so that variations in the interpretation of color maps
+between different types of display hardware do
+not affect the displayed image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w</option></term>
+  <listitem>
+<para>Convert the color image to black and white, and RLE encode that.
+The red, green, and blue components of each
+pixel are combined via the NTSC transform to get an intensity value (Y) which
+is saved.  A more versatile tool for this is
+<citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S</option></term>
+  <listitem>
+<para>Save all data in RLE format,
+irrespective of whether it is background or not (&ldquo;straight box save&rdquo;).
+It is not possible to
+restore a file saved with
+<option>-S</option>
+as an overlay.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option><replaceable>x</replaceable></term>
+  <listitem>
+<para>Specify a color to use as the &ldquo;background&rdquo;.
+The character
+<emphasis remap='I'>x</emphasis>
+is selected from the set
+<emphasis remap='B'>rgbwBG</emphasis>
+(red, green, blue, white, Black, 18% Grey).
+If this option is not specified, the pixel in the lower left corner
+of the region being saved is used as the background color.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-l</option><replaceable>x y</replaceable></term>
+  <listitem>
+<para>Specify the size of the saved box.
+This is useful if only a portion of the image is to be saved.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-p</option><replaceable>x y</replaceable></term>
+  <listitem>
+<para>Specify the upper left corner of the saved portion
+of the image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Verbose mode.
+The program will provide voluminous status information
+on its standard error as it proceeds through encoding the image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>&ldquo;hires&rdquo; flag.  Set both the height and width of the framebuffer
+to 1024.  The default is 512x512.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<emphasis remap='I'>fb-orle &thinsp;-h &thinsp;tank.rle</emphasis>
+</literallayout> <!-- remap='RE' -->
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fblabel.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fblabel.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fblabel.xml (revision 0)
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fblabel1'>
+<refmeta>
+<refentrytitle>FBLABEL</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fblabel</refname>
+<refpurpose>display a text string on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fblabel</command>    
+    <arg choice='opt'>-hca </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>fontname</replaceable></arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='plain'><replaceable>x_position</replaceable></arg>
+    <arg choice='plain'><replaceable>y_position</replaceable></arg>
+    <arg choice='plain'><replaceable>text_string</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fblabel</emphasis>
+writes a text string to
+the image on the currently selected framebuffer.
+The text string will be filtered to the image currently
+displayed.
+Use
+<citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+to determine where to position the text string.
+The lower left corner of the text string starts
+displaying at the x and y position given.
+The environment variable FB_FILE specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the
+requested framebuffer size, is assumed to be 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-c</option>
+flag causes the screen to be cleared before the text string is displayed.
+The default behavior is to label the current image
+without clearing the screen.</para>
+
+<para>The
+<option>-a</option>
+The flag causes the text not to be filtered against the frame buffer image.</para>
+
+<para>The
+<option>-C r/g/b</option>
+specifies red, green, and blue rgb values [0..255] for the text.
+The default color is white.</para>
+
+<para>The
+<option>-f fontname</option>
+flag will change the current default
+font from nonie.r.12 to "/usr/lib/vfont/fontname".</para>
+</refsect1>
+
+<refsect1 id='fonts'><title>FONTS</title>
+<para><emphasis remap='I'>Fblabel</emphasis>
+expects the Berkley fonts in the directory /usr/lib/vfont.
+The fonts are expected to be in Vax byte order,
+even if that is not the natural byte order of the machine,
+to avoid having to create a font converter.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>fblabel -h -f "oldenglish.14" `fbpoint -h` "Hello"</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbed</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbfree.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbfree.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbfree.xml (revision 0)
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbfree1'>
+<refmeta>
+<refentrytitle>FBFREE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbfree</refname>
+<refpurpose>free any frame buffer resources</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbfree</command>    
+    <arg choice='opt'><arg choice='plain'>-F </arg><arg choice='plain'><replaceable>framebuffer</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbfree</emphasis>
+is used to free any resources associated with a frame buffer.
+Its most common use is to close down an
+<citerefentry><refentrytitle>fbserv</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+process and its associated frame buffer.
+This command can also be used to free any shared memory segments
+on e.g. Sun and SGI frame buffers.</para>
+
+<para>This program simply calls the fb_free() routine in
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbclear</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fb-bw.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-bw.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-bw.xml (revision 0)
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbbw1'>
+<refmeta>
+<refentrytitle>FB-BW</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb&hyphen;bw</refname>
+<refpurpose>save a framebuffer image in a black and white bw file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-bw</command>    
+    <arg choice='opt'>-hi </arg>
+    <arg choice='opt'>-Fframebuffer </arg>
+    <arg choice='opt'>-X <replaceable>scr_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>scr_yoff</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>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fb-bw</emphasis>
+will take a region of a framebuffer display and save it as a black and
+white
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file.
+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.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the output file will be made size 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag, changes the default to 1024x1024.
+The
+<option>-s</option>
+flag will set both the file height and width to be the given size, while
+<option>-w</option>
+and
+<option>-n</option>
+sets them individually.</para>
+
+<para>A first quadrant coordinate system is used (origin in lower left of
+screen), and the area saved is normally from this origin.  The
+<option>-X</option>
+and
+<option>-Y</option>
+flags can be used to move the origin to an offset position on the screen.
+The
+<option>-i</option>
+flag switches to a fourth quadrant system, both in the storage order as
+well as the origin offset coordinates (i.e. origin is now the upper left
+corner of the screen).</para>
+
+<para>An equal blending of red, green, and blue is done.  For more complicated
+black and white conversion use
+<citerefentry><refentrytitle>fb-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and
+<citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/gif2fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/gif2fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/gif2fb.xml (revision 0)
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='gif2fb1'>
+<refmeta>
+<refentrytitle>GIF2FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>gif2fb</refname>
+<refpurpose>display GIF file on frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>gif2fb</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'><arg choice='plain'>-F <replaceable>"frame</replaceable></arg><arg choice='plain'><replaceable>buffer</replaceable></arg><arg choice='plain'><replaceable>name"</replaceable></arg></arg>
+    <arg choice='plain'><replaceable>"GIF</replaceable></arg>
+    <arg choice='plain'><replaceable>file</replaceable></arg>
+    <arg choice='plain'><replaceable>name"</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>gif2fb</command>
+displays on a frame buffer the images described by a
+CompuServe GIF (Graphics Interchange Format) file.
+The
+<option>-F</option>
+option outputs to the specified frame buffer
+instead of the one specified by the
+<emphasis remap='I'>FB_FILE</emphasis>
+environment variable
+(or the default frame buffer, if
+<emphasis remap='I'>FB_FILE</emphasis>
+is not set).
+The frame buffer size requested will be the same as
+the input GIF screen size.
+The actual size obtained depends on details of the specific frame buffer.
+The
+<option>-h</option>
+option prints the GIF screen size on stderr. The
+<option>-v</option>
+option printd additional information about the GIF file on stderr.
+The
+<emphasis remap='I'>GIF file name</emphasis>
+Specifies the GIF input file to be translated,
+rather than reading the file from the standard input.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para>&ldquo;A Standard Defining a Mechanism for the Storage and Transmission of
+Raster-Based Graphics Information&rdquo;,
+June 15, 1987 (CompuServe Incorporated).
+<!-- .br -->
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>,<citerefentry><refentrytitle>gif-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Christopher T. Johnson</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1994-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 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/polar-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/polar-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/polar-fb.xml (revision 0)
@@ -0,0 +1,295 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='polarfb1'>
+<refmeta>
+<refentrytitle>POLAR-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>polar-fb</refname>
+<refpurpose>produce polar plots on a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>polar-fb</command>    
+    <arg choice='opt'><replaceable>options</replaceable></arg>
+    <arg choice='opt'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Polar-fb</emphasis>
+reads data for a normalized polar function (npf)
+from
+<emphasis remap='I'>file,</emphasis>
+and produces the graph on a frame buffer.
+If
+<emphasis remap='I'>file</emphasis>
+is not specified, the standard input is read.
+The input should be a sequence of numbers;
+it is interpreted as pairs of polar coordinates.
+The first number in each pair is interpreted as a value of theta,
+the second as a value of rho.</para>
+
+<para>An npf is a function,
+<!-- .sp
+.ce -->
+phi&nbsp;:&nbsp;[0,&nbsp;2pi)&nbsp;&rarr;&nbsp;[0,&nbsp;1],
+<!-- .sp -->
+that maps angles between 0 and 2pi (i.e., between 0 and 360 degrees)
+into the unit interval.
+A typical application for an npf
+is to describe some attribute of an MGED model
+as a function of the direction from which the geometry is viewed.</para>
+
+<para>In the absence of command-line options,
+<command>polar-fb</command>
+fills the default area of the frame buffer
+(typically 512&times;512 pixels)
+with a background color
+and displays the interior of the npf
+(i.e., {(theta,&nbsp;rho)&nbsp;|&nbsp;rho&nbsp;&lt;=&nbsp;phi(theta)}).
+The graph is positioned with its origin
+<emphasis remap='I'>O,</emphasis>
+at the center of the frame-buffer,
+oriented with theta&nbsp;&equals;&nbsp;0 at the bottom,
+and scaled so that the unit circle just fits in the frame buffer.
+The graph consists of concentric regions colored
+blue, green, yellow, orange, or red,
+depending on distance from
+<emphasis remap='I'>O.Finally,</emphasis>
+<command>polar-fb</command>
+superimposes a polar grid in black.</para>
+
+<para>In the description that follows of the valid options,
+``<emphasis remap='I'>r&nbsp;g&nbsp;b</emphasis>''
+is a triplet of integers in {0,&nbsp;...,&nbsp;255}
+that specifies a color in terms of
+intensities for red, green, and blue, respectively.
+The options and their meanings are:</para>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-F</option><replaceable>&nbsp;fbfile</replaceable></term>
+  <listitem>
+<para>Send the results to the frame buffer
+<emphasis remap='I'>fbfile.In the absence of the</emphasis>
+<option>-F</option>
+option, if the shell variable
+<emphasis remap='B'>FB_FILE</emphasis>
+is defined, its value is used.
+Otherwise, the host's default frame buffer is used.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-N</option><replaceable>&nbsp;scr_height</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) height to
+<emphasis remap='I'>scr_height</emphasis>
+pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S</option><replaceable>&nbsp;scr_size</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) height and width to
+<emphasis remap='I'>scr_size</emphasis>
+pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W</option><replaceable>&nbsp;scr_width</replaceable></term>
+  <listitem>
+<para>Set screen (frame-buffer) width to
+<emphasis remap='I'>scr_width</emphasis>
+pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-a</option><replaceable>&nbsp;u&nbsp;v</replaceable></term>
+  <listitem>
+<para>Plot only the portion of the npf between <emphasis remap='I'>u</emphasis> and <emphasis remap='I'>v</emphasis> degrees
+(i.e., <emphasis remap='I'>u</emphasis>&nbsp;&lt;=&nbsp;theta&nbsp;&lt;=&nbsp;<emphasis remap='I'>v</emphasis>).
+Default is <emphasis remap='I'>u</emphasis>&nbsp;&equals;&nbsp;0, <emphasis remap='I'>v</emphasis>&nbsp;&equals;&nbsp;360.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-b</option><replaceable>&nbsp;r&nbsp;g&nbsp;b</replaceable></term>
+  <listitem>
+<para>Set the background color to
+(<emphasis remap='I'>r</emphasis>,&nbsp;<emphasis remap='I'>g</emphasis>,&nbsp;<emphasis remap='I'>b</emphasis>).
+Default is (255,&nbsp;255,&nbsp;255) (i.e., white).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>Clear the frame buffer to the background color.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-e</option></term>
+  <listitem>
+<para>Use empty-interior mode.
+This is useful with the
+<option>-p</option>
+option.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-g</option></term>
+  <listitem>
+<para>Do not plot the polar grid.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>Use high-resolution mode.
+The frame buffer is 1024&times;1024 pixels.
+This has the same effect as
+<option>-S 1024 .</option></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i</option><replaceable>&nbsp;r&nbsp;g&nbsp;b</replaceable></term>
+  <listitem>
+<para>Display the interior of the npf with constant color
+(<emphasis remap='I'>r</emphasis>,&nbsp;<emphasis remap='I'>g</emphasis>,&nbsp;<emphasis remap='I'>b</emphasis>).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-l</option><replaceable>&nbsp;r&nbsp;g&nbsp;b</replaceable></term>
+  <listitem>
+<para>Display the interior of the npf in annular regions
+whose colors are a linear ramp from (0,&nbsp;0,&nbsp;0) at
+<emphasis remap='I'>O,</emphasis>
+to
+(<emphasis remap='I'>r</emphasis>,&nbsp;<emphasis remap='I'>g</emphasis>,&nbsp;<emphasis remap='I'>b</emphasis>)
+at rho&nbsp;&equals;&nbsp;1.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-m</option></term>
+  <listitem>
+<para>Merge the graph with the current contents of the frame buffer.
+Given this option,
+<command>polar-fb</command>
+does not modify the area of the frame buffer outside the npf.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n</option></term>
+  <listitem>
+<para>Use no-warning mode.
+If this option is specified,
+<command>polar-fb</command>
+will abort if it detects any irregularities in the input stream.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o</option><replaceable>&nbsp;x&nbsp;y</replaceable></term>
+  <listitem>
+<para>Translate the graph, putting
+<emphasis remap='I'>O</emphasis>
+at frame-buffer location (<emphasis remap='I'>x</emphasis>, <emphasis remap='I'>y</emphasis>).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-p</option><replaceable>&nbsp;r&nbsp;g&nbsp;b</replaceable></term>
+  <listitem>
+<para>Plot the perimeter of the npf in the color
+(<emphasis remap='I'>r</emphasis>,&nbsp;<emphasis remap='I'>g</emphasis>,&nbsp;<emphasis remap='I'>b</emphasis>).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-q</option><replaceable>&nbsp;q</replaceable></term>
+  <listitem>
+<para>Set the angular quantum to
+<emphasis remap='I'>q</emphasis>&nbsp;degrees.
+The graph will consist of circular sectors, with the arc of each sector
+subtending an angle of
+<emphasis remap='I'>q.Default is 1.</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-r</option></term>
+  <listitem>
+<para>Interpret the theta values on the input in radians.
+Default is degrees.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s</option><replaceable>&nbsp;s</replaceable></term>
+  <listitem>
+<para>Scale the graph so that the unit radius is
+<emphasis remap='I'>s</emphasis>
+pixels.
+The dimensions of the background region of the graph will be
+2<emphasis remap='I'>s</emphasis>&times;2<emphasis remap='I'>s</emphasis>
+pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-t</option><replaceable>&nbsp;t</replaceable></term>
+  <listitem>
+<para>Rotate (twist) the npf
+<emphasis remap='I'>t</emphasis>
+degrees clockwise.
+Negative values of
+<emphasis remap='I'>t</emphasis>
+specify counterclockwise rotation.
+Any bounds specified with the
+<option>-a</option>
+option are applied before the npf is rotated.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w</option></term>
+  <listitem>
+<para>Display the interior of the npf in angular wedges
+colored blue, green, yellow, orange, or red, depending on radius.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-z</option><replaceable>&nbsp;side</replaceable></term>
+  <listitem>
+<para>Plot only one half of the graph.
+<emphasis remap='I'>Side</emphasis>
+may be either of the characters `l' or `r',
+which specify the left and right halves of the graph, respectively.
+This functionality could be duplicated through judicious combination
+of the
+<option>-a</option> and <option>-t</option>
+options.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Paul J. Tanenbaum, BRL/VLD-GSB</para>
+
+</refsect1>
+
+<refsect1 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 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/fbfade.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbfade.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbfade.xml (revision 0)
@@ -0,0 +1,179 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbfade1'>
+<refmeta>
+<refentrytitle>FBFADE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbfade</refname>
+<refpurpose>fade a frame buffer image in or out</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbfade</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><arg choice='plain'>-f </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>image</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-s </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>square</replaceable></arg><arg choice='plain'><replaceable>size</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-w </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <sbr/>
+    <arg choice='opt'><arg choice='plain'>-n </arg><arg choice='plain'><replaceable>input</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-S </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>square</replaceable></arg><arg choice='plain'><replaceable>size</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-W </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-N </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <sbr/>
+    <arg choice='opt'><arg choice='opt'>-F </arg><arg choice='plain'><replaceable>output</replaceable></arg><arg choice='plain'><replaceable>frame</replaceable></arg><arg choice='plain'><replaceable>buffer</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<!-- .lg 0  IGNORED -->
+<para>&shy;fbfade
+<!-- .lg  IGNORED -->
+gradually displays an image on a frame buffer,
+one randomly chosen pixel at a time.</para>
+
+<refsect2 id='options'><title>Options</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term>&shy;-h</term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;high resolution&rdquo;)Assumes 1024 by 1024 pixels for default input image size
+instead of 512 by 512.
+Explicitly specified sizes override the default,
+and if actual input image size is smaller than requested,
+the actual size will be used.
+If output frame buffer size is not specified,
+the revised input size will be requested for output.
+If actual output frame buffer size is greater than requested,
+only the lower-left portion of the frame buffer will be used.
+Actual sizes depend on details of specific frame buffers.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-f <emphasis remap='I'>input image name</emphasis></term>
+  <listitem>
+<para>Inputs the image to be displayed
+from the specified frame buffer or <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry> file,
+instead of using pure background
+(which fades out the image already
+on the output frame buffer).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-s<emphasis remap='P->I'> input square size</emphasis></term>
+  <listitem>
+<para>Specifies input image width and height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-w<emphasis remap='P->I'> input width</emphasis></term>
+  <listitem>
+<para>Specifies input image width.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-n<emphasis remap='P->I'> input height</emphasis></term>
+  <listitem>
+<para>Specifies input image height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-S<emphasis remap='P->I'> output square size</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer width and height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-W<emphasis remap='P->I'> output width</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer width.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-N<emphasis remap='P->I'> output height</emphasis></term>
+  <listitem>
+<para>Specifies output frame buffer height.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-F<emphasis remap='P->I'> output frame buffer name</emphasis></term>
+  <listitem>
+<para>Outputs to the specified frame buffer
+instead of the one specified by the
+<!-- .lg 0  IGNORED -->
+&shy;FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+environment variable
+(or the default, if
+<!-- .lg 0  IGNORED -->
+&shy;</emphasis>FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+is not set).
+If this is the last option specified, the
+<!-- .lg 0  IGNORED -->
+&shy;</emphasis>-F<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+is optional.</emphasis></para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 id='caveat'><title>CAVEAT</title>
+<!-- .lg 0  IGNORED -->
+<para>&shy;fbfade<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+works best in conjunction with a frame buffer having very fast access to pixels.</emphasis></para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>The following shell script can be used to produce a slick &ldquo;slide show&rdquo;:</para>
+  <blockquote remap='RS'>
+<para>fbclear
+<!-- .br -->
+for &thinsp;i &thinsp;in &thinsp;*.pix
+<!-- .br -->
+do	fbfade &thinsp;-f $i
+<!-- .br -->
+	sleep &thinsp;15
+<!-- .br -->
+done
+<!-- .br -->
+fbfade</para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 id='authors'><title>AUTHORS</title>
+<para>Douglas A. Gwyn, BRL/VLD-VMB
+<!-- .br -->
+Gary S. Moss, BRL/VLD-VMB</para>
+
+</refsect1>
+
+<refsect1 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 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/fb-png.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-png.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-png.xml (revision 0)
@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbpng1'>
+<refmeta>
+<refentrytitle>FB-PNG</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb-png</refname>
+<refpurpose>save a framebuffer image in a color Portable Network Graphics (PNG) file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-png</command>    
+    <arg choice='opt'>-hic </arg>
+    <arg choice='opt'>-ggamma </arg>
+    <arg choice='opt'>-Fframebuffer </arg>
+    <arg choice='opt'>-ssquaresize </arg>
+    <arg choice='opt'>-wwidth </arg>
+    <arg choice='opt'>-nheight </arg>
+    <arg choice='opt'><replaceable>file.png</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fb-png</emphasis>
+will take a region of a framebuffer display and save it as a color
+<emphasis remap='I'>png</emphasis>
+format file.
+The environment
+variable
+<!-- I elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If this variable is not set, the default device for your system will
+be used.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the output
+<emphasis remap='I'>png</emphasis>
+file, and the requested framebuffer size, is assumed to be 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag, changes the default to 1024x1024.
+The
+<option>-s</option>
+flag will set both the file height and width to be the given size, while
+<option>-w</option>
+and
+<option>-n</option>
+sets them individually.</para>
+
+<para>A first quadrant coordinate system is used (origin in lower left of
+screen), and the area saved is normally from this origin.
+The
+<option>-i</option>
+flag switches to a fourth quadrant system, both in the storage order as
+well as the origin offset coordinates (i.e. origin is now the upper left
+corner of the screen).</para>
+
+<para>The
+<option>-c</option>
+flag specifies that the color map in the frame buffer should
+be applied to the pixel values (&ldquo;crunched&rdquo;) before they are written to the
+output file.</para>
+
+<para>The
+<option>-g gamma</option>
+flag 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>
+</refsect1>
+
+<refsect1 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-bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>John R. Anderson</para>
+
+</refsect1>
+
+<refsect1 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 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/pixautosize.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pixautosize.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/pixautosize.xml (revision 0)
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='pixautosize1'>
+<refmeta>
+<refentrytitle>PIXAUTOSIZE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pixautosize</refname>
+<refpurpose>determine if a file size or byte count is a standard image size</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>pixautosize</command>    
+    <arg choice='opt'>-b <replaceable>bytes_per_sample</replaceable></arg>
+    <arg choice='opt'>-f <replaceable>file_name</replaceable></arg>
+    <arg choice='opt'>-l <replaceable>file_length</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>pixautosize</command>
+determines if a given file is one of the &ldquo;standard&rdquo; sizes used in the
+BRL-CAD package, <emphasis remap='I'>i.e.</emphasis> one of the sizes recognized by the
+<option>-a</option>
+option on
+<citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+If the dimensions are recognized, it prints a string suitable for use in
+a Bourne shell
+<citerefentry><refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+script to set the variables WIDTH and HEIGHT, <emphasis remap='I'>e.g.</emphasis></para>
+
+<para>   WIDTH=512; HEIGHT=512</para>
+
+<para>The file name can be specified by using the
+<option>-f&nbsp;</option><replaceable>file_name</replaceable>
+commandline option, or the file length (in bytes) can be
+specified by using the
+<option>-l&nbsp;</option><replaceable>file_length</replaceable>
+commandline option.
+One of these two options must be present.
+In either case, the
+<option>-b&nbsp;</option><replaceable>bytes_per_sample</replaceable>
+option can be used to specify the number of bytes which are used
+for each sample (pixel) in the file.
+The default value is three (3), which is appropriate for use
+with
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files.
+This should be changed to one with
+<option>-b&nbsp;</option><literal>1</literal>
+when processing a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file.
+Similarly, the proper value for a
+<citerefentry><refentrytitle>dbw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file is 8 (1 channel of 8 byte samples),
+and the value for
+<citerefentry><refentrytitle>dpix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+files is 24 (3 channels of 8 byte samples)</para>
+</refsect1>
+
+<refsect1 id='examples'><title>EXAMPLES</title>
+<para>These two examples both give the result of</para>
+
+<para>   WIDTH=50; HEIGHT=50;</para>
+
+<para>the first could be for a
+<citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file and the second for a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file:</para>
+
+<para>   pixautosize -b 1 -l 2500
+<!-- .br -->
+   pixautosize -b 3 -l 7500</para>
+
+<para>This example shows how to determine the size of a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file by giving the file name:</para>
+
+<para>   pixautosize -b 3 -f ../pix/moss.pix</para>
+
+<para>   WIDTH=512; HEIGHT=512</para>
+
+<para>This command can be used easily in shell scripts with a line like this:</para>
+
+<para>   eval `pixautosize -b 3 -f $FILE`	# sets WIDTH, HEIGHT</para>
+
+<para>For a major shell script which uses this program, examine
+<citerefentry><refentrytitle>pixinfo.sh</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para>pixinfo.<citerefentry><refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>bw</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>If the file or file_length specified does not match any
+of the standard sizes, one of these messages is printed on standard error:
+<!-- .br -->
+   pixautosize: unable to autosize nsamples=999
+<!-- .br -->
+   pixautosize: unable to autosize file '/dev/null'
+<!-- .br -->
+In this case, the string printed on standard output is:</para>
+
+<para>   WIDTH=0; HEIGHT=0</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbcolor.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbcolor.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbcolor.xml (revision 0)
@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbcolor1'>
+<refmeta>
+<refentrytitle>FBCOLOR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbcolor</refname>
+<refpurpose>interactively pick colors</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbcolor</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><arg choice='plain'>-S <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>squaresize</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-W <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-N <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbcolor</emphasis>
+is an interactive color picking facility.
+It allows you to pick and display colors, by varying parameters in
+either RGB (red, green, blue)
+or HSI (hue, saturation, intensity) space.
+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.
+If the
+<option>-h</option>
+option is used,
+1024x1024 resolution is used.
+Alternatively, the
+<option>-SWN</option>
+options can all be used in the normal way to specify the size of
+the screen (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).</para>
+
+<para><emphasis remap='I'>Fbcolor</emphasis>
+draws a set of color bars in the lower left corner of the display,
+sets the remainder of the display to the current color,
+then starts reading standard in for color editing commands.
+As you change the various parameters which specify
+the color, the color bars grow and shrink to show the relative red, green
+and blue intensities.</para>
+
+<para>At the same time,
+<command>fbcolor</command>
+displays the current RGB and HSI values on your terminal.  This
+allows you to record the RGB or HSI values of the colors you
+select for later use.</para>
+
+<para><emphasis remap='I'>Fbcolor</emphasis>
+recognizes two main sets of commands; those which select which parameter to
+edit, and those which vary the value of the selected parameter.
+``<emphasis remap='B'>r</emphasis>'',
+``<emphasis remap='B'>g</emphasis>'',
+and
+``<emphasis remap='B'>b</emphasis>''
+selects the red, green, or blue color for editing, while
+``<emphasis remap='B'>h</emphasis>'',
+``<emphasis remap='B'>s</emphasis>'',
+and
+``<emphasis remap='B'>i</emphasis>'',
+(or
+``<emphasis remap='B'>v</emphasis>'')
+selects the hue, saturation, or intensity for editing.
+There is one other parameter selection character, the
+``<emphasis remap='B'>/</emphasis>'',
+which steps through the list of color parameters in the order
+given above.</para>
+
+<para>``<emphasis remap='B'>+</emphasis>''
+and
+``<literal>.</literal>''
+both increment the currently selected parameter by one;
+``<emphasis remap='B'>-</emphasis>''
+and
+``<emphasis remap='B'>,</emphasis>''
+both decrement by one, and
+``<emphasis remap='B'>&gt;</emphasis>''
+and
+``<emphasis remap='B'>&lt;</emphasis>''
+increments and decrements by 16.
+The value of each of the parameters
+can range from 0 to 255
+and all parameters wrap in both directions.</para>
+
+<para>A
+``<emphasis remap='B'>?</emphasis>''
+prints a short command summary,
+and typing
+``<emphasis remap='B'>q</emphasis>'',
+``<emphasis remap='B'>Q</emphasis>'',
+``<emphasis remap='B'>&lt;CR&gt;</emphasis>'',
+or
+``<emphasis remap='B'>&lt;LF&gt;</emphasis>''
+exits the program.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbclear</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbcmap.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbcmap.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbcmap.xml (revision 0)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbcmap1'>
+<refmeta>
+<refentrytitle>FBCMAP</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbcmap</refname>
+<refpurpose>change the color map of a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbcmap</command>    
+    <arg choice='opt'>-h </arg>
+    <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'><replaceable>map_number</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbcmap</emphasis>
+is used to change the color map of a frame buffer.
+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 requested framebuffer size will be the default size for the
+selected device (often 512x512 pixels).
+Specifying the
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-w&nbsp;</option><replaceable>scr_width</replaceable>
+and
+<option>-W&nbsp;</option><replaceable>scr_width</replaceable>
+flags specifies the width of each scanline for the display device,
+in pixels.</para>
+
+<para>The
+<option>-n&nbsp;</option><replaceable>scr_height</replaceable>
+and
+<option>-N&nbsp;</option><replaceable>scr_height</replaceable>
+flags specifies the height of each scanline for the display device.</para>
+
+<para><option>-s&nbsp;</option><replaceable>squarescrsize</replaceable>
+and
+<option>-S&nbsp;</option><replaceable>squarescrsize</replaceable>
+set both the height and width to the size given.
+This size distinction is important only for devices like the Adage
+framebuffers which have different operating modes based on the
+display size.</para>
+
+<para>If an optional color
+<emphasis remap='I'>map_number</emphasis>
+is given, that map is used;
+the default is the standard linear map.
+There are currently six other maps supplied
+numbered 1 through 6 as follows:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term>1</term>
+  <listitem>
+<para>reverse-linear (negative) map.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>2</term>
+  <listitem>
+<para>one corrected for Polaroid 809/891 film.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>3</term>
+  <listitem>
+<para>a linear mapping in which the first 100 values are black.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>4</term>
+  <listitem>
+<para>a linear map with values 1-&gt;191 incremented by 64 to boost dim pictures.
+The values at 191 and above are all full on.  Zero remains at zero.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>5</term>
+  <listitem>
+<para>a gamma correcting color map used by the University of Utah Alpha_1 project.
+A better source of gamma correction is the
+<citerefentry><refentrytitle>fbgamma</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+utility.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>6</term>
+  <listitem>
+<para>a map with a series of color deltas.
+This map is mostly black with the following colors,
+appearing at multiples of 32,
+having values full on:
+white (0), magenta (32), red (64), yellow (96), green (128),
+cyan (160), blue (192).  This map is most useful in conjunction
+with
+<citerefentry><refentrytitle>fbcmrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and will show which pixels have the same intensities in one, two, or
+all three color planes.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>There are also three special maps used to quickly change the display
+to a solid color for adjusting a camera without losing image memory,
+numbered 10 through 12 for
+black,
+white,
+and 18% neutral grey, respectively.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbgamma</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>cmap-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-cmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>cmap</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbzoom.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbzoom.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbzoom.xml (revision 0)
@@ -0,0 +1,222 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbzoom1'>
+<refmeta>
+<refentrytitle>FBZOOM</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbzoom</refname>
+<refpurpose>modify zoom and window parameters of a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbzoom</command>    
+    <arg choice='opt'>-F <replaceable>frame_buffer</replaceable></arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-s <replaceable>image_sqrsize</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>image_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>image_height</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para>Using
+<citerefentry><refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and/or
+<citerefentry><refentrytitle>emacs</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+-like keystrokes,
+<command>fbzoom</command>
+allows interactive zooming and panning of a frame buffer.  Using the
+optional command line arguments,</para>
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-F&nbsp; frame_buffer</option></term>
+  <listitem>
+<para>explicitly specifies the frame buffer.  Otherwise, the environment variable
+<emphasis remap='I'>FB_FILE</emphasis>
+specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>changes the frame buffer size to 1024x1024.
+By default, it is assumed to be 512x512 pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s&nbsp; image_sqrsize</option></term>
+  <listitem>
+<para>displays the image file as a square,
+<emphasis remap='B'>image_sqrsize</emphasis>
+pixels per side (default is 512x512).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w&nbsp; image_width</option></term>
+  <listitem>
+<para>displays the image
+<emphasis remap='B'>image_width</emphasis>
+pixels wide (default is 512).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n&nbsp; image_height</option></term>
+  <listitem>
+<para>displays the image
+<emphasis remap='B'>image_height</emphasis>
+pixels high (default is 512).</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para><emphasis remap='I'>Fbzoom</emphasis>
+will display the image currently in the frame buffer and then act on commands
+entered by the user.  Available commands are:</para>
+
+
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><emphasis remap='B'>b ^V</emphasis></term>
+  <listitem>
+<para>zoom Bigger (*2)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>s</emphasis></term>
+  <listitem>
+<para>zoom Smaller (*0.5)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>+</emphasis></term>
+  <listitem>
+<para>zoom Bigger (+1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>-</emphasis></term>
+  <listitem>
+<para>zoom Smaller (-1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>h B</emphasis></term>
+  <listitem>
+<para>pan Left (1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>j N</emphasis></term>
+  <listitem>
+<para>pan Down (1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>k P</emphasis></term>
+  <listitem>
+<para>pan Up (1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>l F</emphasis></term>
+  <listitem>
+<para>pan Right (1)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>H ^B</emphasis></term>
+  <listitem>
+<para>pan Left (many)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>J ^N</emphasis></term>
+  <listitem>
+<para>pan Down (many)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>K ^P</emphasis></term>
+  <listitem>
+<para>pan Up (many)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>L ^F</emphasis></term>
+  <listitem>
+<para>pan Right (many)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>T</emphasis></term>
+  <listitem>
+<para>toggle sense of pan commands</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>c</emphasis></term>
+  <listitem>
+<para>goto Center</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>z</emphasis></term>
+  <listitem>
+<para>zoom 1 1</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>r</emphasis></term>
+  <listitem>
+<para>Reset to normal</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>q</emphasis></term>
+  <listitem>
+<para>Exit</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>RETURN</emphasis></term>
+  <listitem>
+<para>Exit</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>Note that these commands change the way the frame buffer is viewed
+but not the image in the frame buffer.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>bw-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>gif-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbanim.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbanim.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbanim.xml (revision 0)
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbanim1'>
+<refmeta>
+<refentrytitle>FBANIM</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbanim</refname>
+<refpurpose>animate small images on framebuffer using hardware pan and zoom</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbanim</command>    
+    <arg choice='opt'>-hirv </arg>
+    <arg choice='opt'><arg choice='plain'>-S <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>squaresize</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-W <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-N <replaceable>screen</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-s <replaceable>file</replaceable></arg><arg choice='plain'><replaceable>squaresize</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-w <replaceable>file</replaceable></arg><arg choice='plain'><replaceable>width</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-n <replaceable>file</replaceable></arg><arg choice='plain'><replaceable>height</replaceable></arg></arg>
+    <arg choice='opt'>-p <replaceable>npasses</replaceable></arg>
+    <arg choice='plain'><replaceable>width</replaceable></arg>
+    <arg choice='plain'><replaceable>nframes</replaceable></arg>
+    <arg choice='opt'><replaceable>fps</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbanim</emphasis>
+assumes that the current framebuffer (determined by environment variable
+FB_FILE) contains a collection of small square
+images &ldquo;tiled&rdquo; together by
+<citerefentry><refentrytitle>pixtile</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+This permits a limited sequence of low resolution images to be viewed at
+various speeds, to create the sensation of motion, or to highlight
+the differences between the frames.
+The typical use of this program is to animate sequences of 64x64 or 128x128
+tiles generated by animation studies.
+It can also be used to create &ldquo;blink comparisons&rdquo; between a small number
+of large images.</para>
+
+<para>The width of each tile is specified by the
+<emphasis remap='I'>width</emphasis>
+argument, and the number of tiles is specified by the
+<emphasis remap='I'>nframes</emphasis>
+argument.
+The optional argument
+<emphasis remap='I'>fps</emphasis>
+specifies the number of frames (tiles) per second to be displayed.
+24 fps is the standard movie rate, 30 the standard video rate.
+Slower rates may also be used.  The default is 8 frames/second.</para>
+
+<para>By default, the framebuffer is assumed to be
+loaded with a 512x512 pixel image.
+Specifying the
+<option>-h</option>
+flag, changes the default to 1024x1024.  Alternatively, the
+<option>-SWN</option>
+flags can be used in the normal way to specify the size of
+the screen (see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>).</para>
+
+<para>By default, the sequence of tiles is considered to be a circular (repeating)
+sequence, i.e., the first tile immediately follows the last one.
+If this is not the case, the
+<option>-r</option>
+flag will cause the sequence to &ldquo;rock&rdquo; from beginning to end to beginning,
+which is sometimes more pleasing.</para>
+
+<para>The
+<option>-v</option>
+flag will cause the frame number and
+center coordinates of each frame to be printed
+as they are passed to fb_window(), for debugging purposes.</para>
+
+<para>By default, the
+<command>fbanim</command>
+program repeats for 100 passes.  When creating demonstration scripts,
+it may be desirable to specify the number of passes through the animation.
+The
+<option>-p&nbsp;</option><replaceable>npasses</replaceable>
+option is used to indicate this.</para>
+
+<para>For compatibility with old animation images which were generated by
+fourth-quadrant programs, where the first image starts in the upper left
+corner of the screen rather than the lower left corner, the
+<option>-i</option>
+flag is used to indicate this inverse order.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixtile</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 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbline.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbline.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbline.xml (revision 0)
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbline1'>
+<refmeta>
+<refentrytitle>FBLINE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbline</refname>
+<refpurpose>draw a colored line on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbline</command>    
+    <arg choice='opt'>-hc </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>red</replaceable></arg>
+    <arg choice='opt'>-g <replaceable>green</replaceable></arg>
+    <arg choice='opt'>-b <replaceable>blue</replaceable></arg>
+    <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>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbline</emphasis>
+draws a line on the currently selected framebuffer
+between the points (x1, y1) and (x2, y2).
+The points must be within the bounds of the framebuffer, or they
+are silently limited to an edge.
+Use
+<citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+to determine where to position the points.
+The environment variable FB_FILE specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the
+requested framebuffer size is typically 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-c</option>
+flag causes the screen to be cleared before the line is displayed.
+The default behavior is to draw the line on the current image
+without clearing the screen.</para>
+
+<para>The
+<option>-r red</option>
+<option>-g green</option>
+<option>-b blue</option>
+flags specify alternate red, green, and blue rgb values for the
+line color. The default color is white.  Thus, a green line is
+created by turning off the red and green components, i.e., with
+<option>-r 0</option>
+<option>-b 0</option>
+options.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>fbline -h -c -r0 -b0 82 11 300 472</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbed</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fblabel</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbpoint</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pl-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbframe.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbframe.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbframe.xml (revision 0)
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbframe1'>
+<refmeta>
+<refentrytitle>FBFRAME</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbframe</refname>
+<refpurpose>place a colored frame around a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbframe</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-w <replaceable>frame_width</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>frame_height</replaceable></arg>
+    <arg choice='opt'>-s <replaceable>squareframesize</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbframe</emphasis>
+places a colored frame around the edge pixels of a framebuffer.
+It is mostly for purposes of framebuffer alignment.
+The
+<option>-F</option>
+option can be used to specify the framebuffer.
+If this option is omitted,
+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 the variable is not set, the default device for your system will
+be used.</para>
+
+<para>The frame starts in the lower left with a red line running to the
+right to the next to last pixel.  Next, a green line from there up to the next
+to top scan line is drawn.  Then blue across the top scan line to the next to
+first column.  Finally a white line down the left edge stopping just
+above the red line.</para>
+
+<para>By default, the dimensions of the frame will be taken from the framebuffer
+used.  Alternatively, one or more of the options
+<option>-h -s -w -n</option>
+may be used to set the dimensions of the frame drawn.</para>
+
+<para>The
+<option>-h</option>
+option sets the frame dimensions to
+1024x1024.
+The options
+<option>-w&nbsp;</option><replaceable>frame_width</replaceable>
+and
+<option>-n&nbsp;</option><replaceable>frame_height</replaceable>
+are used to
+specify the width and height in scanlines of the frame on the framebuffer
+respectively.
+The
+<option>-s&nbsp;</option><replaceable>squareframesize</replaceable>
+option specifies both the height and width of the frame to be drawn.</para>
+
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbgrid</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pix-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/pix-fb.xml (revision 0)
@@ -0,0 +1,177 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='pixfb1'>
+<refmeta>
+<refentrytitle>PIX-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pix&hyphen;fb</refname>
+<refpurpose>display a pix format RGB image file on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>pix-fb</command>    
+    <arg choice='opt'>-ahicz1 </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-m <replaceable>#lines</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'>-S <replaceable>squarescrsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>scr_height</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>file_xoff</replaceable></arg>
+    <arg choice='opt'>-y <replaceable>file_yoff</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>scr_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>scr_yoff</replaceable></arg>
+    <arg choice='opt'><replaceable>file.pix</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pix-fb</emphasis>
+reads a
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+format file from the named file, or from
+standard in if no file is specified, and displays the
+image on the currently selected framebuffer.
+The environment variable FB_FILE specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the
+<emphasis remap='I'>pix</emphasis>
+file, and the requested framebuffer size, 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>If the
+<option>-i</option>
+flag is specified, the image is output from top to bottom.
+Customarily,
+<emphasis remap='I'>pix</emphasis>
+files are stored bottom to top, so this flag
+inverts the image.</para>
+
+<para>The
+<option>-c</option>
+flag causes the screen to be cleared before the image is displayed.
+The default behavior is to overwrite the current image
+with the new image without clearing the screen.</para>
+
+<para>The
+<option>-z</option>
+flag will zoom and center on the image being displayed
+to make it fill the display area, using the libfb fb_zoom() routine.
+fb_zoom only offers integer zoom factors, so displays with non-square
+screens (such as the SGI 3D machines) may find this option of limited
+usefulness.</para>
+
+<para>The
+<option>-w&nbsp;</option><replaceable>file_width</replaceable>
+flag specifies the width of each scanline in the input file, in pixels.
+<option>-W&nbsp;</option><replaceable>scr_width</replaceable>
+does the same for the display device.</para>
+
+<para>The
+<option>-n&nbsp;</option><replaceable>file_height</replaceable>
+and
+<option>-N&nbsp;</option><replaceable>scr_height</replaceable>
+flags specifies the height in scanlines of the input file or display device
+respectively.</para>
+
+<para><option>-s&nbsp;</option><replaceable>squarefilesize</replaceable>
+and
+<option>-S&nbsp;</option><replaceable>squarescrsize</replaceable>
+set both the height and width to the size given.</para>
+
+<para><option>-x&nbsp;</option><replaceable>file_xoff&nbsp;</replaceable><option>-y&nbsp;</option><replaceable>file_yoff</replaceable>
+and
+<option>-X&nbsp;</option><replaceable>scr_xoff&nbsp;</replaceable><option>-Y&nbsp;</option><replaceable>scr_yoff</replaceable>
+will offset into the file or onto the screen by the given amounts.
+The coordinate system for these offsets is first quadrant, with
+the origin at the lower left corner of the image.</para>
+
+<para>The
+<option>-1</option>
+flag causes the image to be written to the framebuffer one line at
+a time, using the
+<citerefentry><refentrytitle>fb_write</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+routine.  This is the default behavior.
+The
+<option>-m&nbsp;</option><replaceable>#lines</replaceable>
+flag can be used to specify the number of lines to be written to the
+framebuffer in rectangular blocks of scanlines, using the
+<citerefentry><refentrytitle>fb_writerect</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+routine.
+In some circumstances, this can result in significantly faster image
+display, at the expense of the image being written less smoothly.
+If both
+<option>-m</option>
+and
+<option>-1</option>
+are specified,
+<option>-1</option>
+wins.</para>
+</refsect1>
+
+<refsect1 id='format'><title>FORMAT</title>
+<para>A
+<citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+file contains sequences of pixels.
+Each pixel is stored as three <emphasis remap='B'>unsigned char</emphasis>s,
+first red, then green, then blue.
+The first pixel in a
+<emphasis remap='I'>pix</emphasis>
+file is the lower left corner of the image.
+The pixels proceed from left-to-right across each scanline,
+with scanlines being written from the bottom to the top of the image.
+By convention
+<emphasis remap='I'>pix</emphasis>
+images are usually square.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>rt</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 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 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbgamma.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbgamma.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbgamma.xml (revision 0)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbgamma1'>
+<refmeta>
+<refentrytitle>FBGAMMA</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbgamma</refname>
+<refpurpose>load a gamma correcting colormap</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbgamma</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-o </arg>
+    <arg choice='opt'>-i </arg>
+    <arg choice='opt'>-Fframebuffer </arg>
+    <arg choice='plain'><replaceable>val</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>gval</replaceable></arg><arg choice='plain'><replaceable>bval</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbgamma</emphasis>
+loads a gamma correcting colormap into a framebuffer.
+If a single value is given, that number is used for
+all three color channels.  If three values are specified,
+they will be applied to the red, green, and blue channels
+respectively.</para>
+
+<para>Gamma values larger than one will boost dim pixels with respect
+to bright ones.  Values less than one will exaggerate the
+difference in brightness.  The former has the effect of desaturating
+the displayed colors ("washing them out"), the latter will
+saturate the colors.  An uncorrected monitor is usually too
+saturated.</para>
+
+<para>Note that since this program is intended for gamma
+<emphasis remap='I'>correction</emphasis>
+the exponent to which pixel values are raised is the inverse
+of the given value.  To linearize a display then, the given
+value will be equal to the gamma of the display (typically
+2.0-3.0, see below).  If you wish to directly apply an
+exponent to a picture (rather than its inverse), this can be
+done by giving a negative value (which means reciprocal in the
+usual mathematical sense).</para>
+
+<para>By default, this program will "correct to linear", that is to say,
+it will apply correction to a standard linear ramp.  If you
+wish to "correct" some other colormap, e.g. an inverse video
+map, the
+<option>-o</option>
+overlay option can be used.  This will read whatever colormap
+is currently in the framebuffer and operate on it.  One useful
+result of this is the ability saturate or desaturate an arbitrary
+colormap.</para>
+
+<para>By default, the display is assumed to be 512x512 pixels;
+by specifying the
+<option>-h</option>
+flag, the size is changed to 1024x1024.
+This size distinction is important for devices like the Adage
+framebuffers which have different operating modes based on the
+display size.
+In general, the
+<command>fbgamma</command>
+manipulates the RGB color maps in the graphics hardware, and
+has effect on the entire screen, not just the portion containing
+the current framebuffer display.
+As such, there is no need to match the display size on the
+command line.</para>
+
+<para>A framebuffer may be explicitly selected with the
+<option>-F</option>
+option, followed by the name of the desired framebuffer.</para>
+
+<para>The
+<option>-i</option>
+option requests that a standard gamma calibration image be displayed on the
+framebuffer.
+This image consists of intensity ramps with
+patches of solid color, and vertically adjacent patches containing
+alternating black and colored scanlines.
+When using gamma to compensate for non-linearity of a display, the gamma
+values should be adjusted until vertically adjacent ramps of the same color
+appear equal in intensity for all patches.</para>
+</refsect1>
+
+<refsect1 id='theory'><title>THEORY</title>
+<para>The response of a typical monitor is non-linear with respect to
+input voltage.  To a fairly high degree of accuracy, the response
+can be expressed as:</para>
+
+<para>display_intensity = input_voltage ^ gamma,</para>
+
+<para>where gamma will usually lie in the 2.0 to 3.0 range (2.2 is the
+<emphasis remap='B'>NTSC</emphasis>
+standard gamma, 2.5 is a commonly used "typical" value).
+Most of the time, pixel values of images have been computed
+assuming a linear mapping between pixel value and displayed
+intensity.  This linear mapping can be approximated by loading
+a colormap into the display which raises the pixel values to
+the inverse gamma power.</para>
+
+<para>It should be noted that getting the gamma values "right" involves
+careful calibration and measurement or your display device.
+The values are likely to be different for each color channel,
+will depend of the brightness setting, etc. (increasing the monitor
+brightness often lowers the gammas, due to overdriving the high
+end of the display).  Also note that getting the correct colors
+from a display requires knowledge of the phosphor chromaticities.</para>
+
+<para>If possible one should gamma correct a picture before loading it
+into a display or saving it as eight bit linear data.  This is
+because the response of the human visual system to brightness
+is also exponential in nature, and thus having "smaller steps"
+and the dark end of the display and larger ones near full bright
+(as an uncorrected display will have), fits this response well.
+Gamma correction via the colormap cannot exploit this.</para>
+
+<para>A gamma value greater than unity will saturate colors by pushing them
+away from the white point and closer to the primaries (as viewed
+on a chromaticity diagram).  A gamma less than unity will desaturate
+colors by moving them closer to the white point.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbcmap</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>cmap-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-cmap</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1987-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 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;.
+w</para>
+</refsect1>
+</refentry>
+
Index: brlcad/doc/docbook/system/man1/en/gif-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/gif-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/gif-fb.xml (revision 0)
@@ -0,0 +1,167 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='giffb1'>
+<refmeta>
+<refentrytitle>GIF-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>gif-fb</refname>
+<refpurpose>display GIF file on frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>gif-fb</command>    
+    <arg choice='opt'><arg choice='plain'>-F </arg><arg choice='plain'><replaceable>frame</replaceable></arg><arg choice='plain'><replaceable>buffer</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+    <arg choice='opt'>-c </arg>
+    <arg choice='opt'><arg choice='plain'>-i </arg><arg choice='plain'><replaceable>image</replaceable></arg><arg choice='plain'><replaceable>number</replaceable></arg></arg>
+    <arg choice='opt'>-o </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-z </arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>GIF</replaceable></arg><arg choice='plain'><replaceable>file</replaceable></arg><arg choice='plain'><replaceable>name</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<!-- .lg 0  IGNORED -->
+<para>&shy;gif-fb
+<!-- .lg  IGNORED -->
+displays on a frame buffer the images described by a
+CompuServe GIF (Graphics Interchange Format) file.</para>
+
+<refsect2 id='options'><title>Options</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term>-F <emphasis remap='I'>frame buffer name</emphasis></term>
+  <listitem>
+<para>Outputs to the specified frame buffer
+instead of the one specified by the
+<!-- .lg 0  IGNORED -->
+&shy;FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+environment variable
+(or the default frame buffer, if
+<!-- .lg 0  IGNORED -->
+&shy;</emphasis>FB_FILE<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+is not set).
+The frame buffer size requested will be the same as
+the input GIF screen size.
+The actual size obtained depends on details of the specific frame buffer.</emphasis></para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-c<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>Uses all 8 bits per channel for color maps supplied in the GIF file,
+overriding the color resolution specified in the GIF file.
+(While technically a violation of the GIF &ldquo;standard&rdquo;,
+apparently some GIF implementations assume this interpretation.)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>-i<emphasis remap='P->I'> image number</emphasis></term>
+  <listitem>
+<para>Displays just the specified image
+(starting counting with 1),
+rather than displaying all images as the GIF specification requires.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-o<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;overlay&rdquo;)Skips the initial clearing of the frame buffer
+to the background color specified in the GIF file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-v<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;verbose&rdquo;)Also prints information about the GIF images
+on the standard error output.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&shy;-z<emphasis remap='P->I'></emphasis></term>
+  <listitem>
+<!-- .lg  IGNORED -->
+<para>(&ldquo;zoom&rdquo;)Uses the zoom capability of the current framebuffer to
+make the image as large as possible on the screen while
+preserving a square aspect ratio to the pixels.
+This means that the zoom factor in X and Y will be equal to
+the smaller of the two possible zooms.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>GIF file name</emphasis></term>
+  <listitem>
+<para>Specifies the GIF input file to be translated,
+rather than reading the file from the standard input.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+
+<refsect1 id='discussion'><title>DISCUSSION</title>
+<para>The GIF &ldquo;standard&rdquo; is far from an ideal specification for frame buffer images,
+but it has been widely accepted in the personal computer arena,
+and consequently there are a large number of images stored in GIF format
+on bulletin-board systems and other information services.
+Since most personal computer systems have GIF translators available for them,
+<!-- .lg 0  IGNORED -->
+&shy;gif-fb<emphasis remap='P->I'>
+<!-- .lg  IGNORED -->
+provides a means of converting most images from such systems
+into a form suitable for processing with other BRL-CAD utilities.</emphasis></para>
+
+<para>Notice that multiple images within a single GIF file
+can achieve animation effects.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>The following is a typical invocation:</para>
+<literallayout remap='RS'>
+<synopsis>
+<emphasis remap='I'>$</emphasis> &thinsp;gif-fb &thinsp;image.gif<emphasis remap='P->I'>
+</synopsis>
+</emphasis></literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para>&ldquo;A Standard Defining a Mechanism for the Storage and Transmission of
+Raster-Based Graphics Information&rdquo;,
+June 15, 1987 (CompuServe Incorporated).
+<!-- .br -->
+<citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Douglas A. Gwyn, BRL/VLD-VMB</para>
+
+</refsect1>
+
+<refsect1 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 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/fbscanplot.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbscanplot.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbscanplot.xml (revision 0)
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbscanplot1'>
+<refmeta>
+<refentrytitle>FBSCANPLOT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbscanplot</refname>
+<refpurpose>plot the intensities of a framebuffer scanline</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbscanplot</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-o </arg>
+    <arg choice='opt'>-c </arg>
+    <arg choice='opt'>-r </arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-F <replaceable>outframebuffer</replaceable></arg>
+    <arg choice='plain'><replaceable>yline</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbscanplot</emphasis>
+will plot the red, green, and blue, pixel intensities of a selected
+scanline of a framebuffer.  The line to be plotted has a first quadrant
+y coordinate of
+<emphasis remap='I'>yline</emphasis>,
+i.e. a value of zero indicates the bottom line of the display.
+The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the input 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.
+The output will appear on this same device unless a
+<option>-F&nbsp;</option><replaceable>outframebuffer</replaceable>
+flag is given to redirect the output.</para>
+
+<para>If no size if specified the selected device(s) will be opened at its
+default size (usually the full screen).  The flag
+<option>-W&nbsp;</option><replaceable>scr_width</replaceable>
+can be used to set a screen width (scanline length) other than this
+default.
+The
+<option>-h</option>
+flag is a shorthand for a size of 1024x1024.</para>
+
+<para>Either the bottom 256 or top 256 scanlines will be used to
+output the plot; whichever will not cover the selected line.
+A black background is drawn with horizontal grey lines
+at intervals of 16 and 64 scanlines in order to provide a scale.
+The intensities of the selected line are then plotted, the
+bottom of the graph being intensity zero; the top 255.</para>
+
+<para>The
+<option>-o</option>
+flag will plot the scanline in overlay mode.  With this flag no background
+or grid lines are drawn, and the output always appears in the
+bottom 256 scanlines of the display.  Using this option more of the
+image will remain visible, and multiple scanlines can be plotted
+on top of each other for comparison.  The image may make the plot
+harder to see however.</para>
+
+<para>If the
+<option>-r</option>
+flag is given, a reverse image of the selected scanline is
+drawn, i.e. the intensities from 0-&gt;255 become 255-&gt;0.  This is
+simply to highlight the line selected.  The plot will still be
+of the non-reversed values.</para>
+
+<para>The
+<option>-v</option>
+flag causes the pixel values to be output to the terminal as
+well as displayed.</para>
+
+<para>The
+<option>-c</option>
+flag causes the current colormap of the framebuffer to be applied
+to the pixel values ("crunched") before plotting them.
+This allows the effects of the color map to be readily viewed.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para><userinput>fbscanplot -r 37</userinput>
+<!-- .br -->
+will plot the intensities of the scanline 37 up from the bottom.
+This line will be highlighted by replacing it with its negative.
+The output will appear in the top 256 scanlines so as not to cover
+the selected line.</para>
+
+<para><userinput>fbscanplot -v -W512 -o `fbpoint -y` &gt; scan.out</userinput>
+<!-- .br -->
+will use
+<emphasis remap='I'>fbpoint</emphasis>
+to select a y scanline, then plot 512 pixel values
+in overlay mode.  These values will also be saved in the file
+<emphasis remap='I'>scan.out</emphasis>
+for closer examination.</para>
+
+<para>A handy C-shell alias is:
+<!-- .br -->
+<emphasis remap='I'>alias fbsp 'fbscanplot -r `fbpoint -y`'</emphasis></para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbgrid</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbzoom</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pl-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/pl-fb.xml (revision 0)
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='plfb1'>
+<refmeta>
+<refentrytitle>PL-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pl&hyphen;fb</refname>
+<refpurpose>display 3-D UNIX plot on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>pl-fb</command>    
+    <arg choice='opt'>-hoid </arg>
+    <arg choice='opt'>-t <replaceable>line_thickness</replaceable></arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</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.plot</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pl-fb</emphasis>
+displays a BRL extended three dimensional UNIX plot file on a framebuffer.
+The environment
+variable
+<!-- B elided -->
+<envar>FB_FILE</envar>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If this variable is not set, the default device for your system will
+be used.
+By default, the display size is assumed to be 512x512 pixels.
+Specifying the
+<option>-h</option>
+flag, changes the output size to 1024x1024.
+The
+<option>-S&nbsp;</option><replaceable>squaresize</replaceable>
+<option>-W&nbsp;</option><replaceable>width</replaceable>
+and
+<option>-N&nbsp;</option><replaceable>height</replaceable>
+flags allow different screen sizes to be set.  The plotting space
+will fill the given screen dimensions.  No attempt is made at present
+to preserve aspect.</para>
+
+<para>The
+<option>-o</option>
+flag is for overlay mode, where the current framebuffer image will
+be left in the background.
+The
+<option>-i</option>
+flag causes the rasterized image to be plotted immediately, rather
+than buffering up rasterized data into bands.  While useful for
+quick feedback on small plots, this mode is generally more expensive
+in CPU time.
+The
+<option>-d</option>
+flag outputs a very verbose debugging stream to standard error
+listing every UNIX plot command
+and the corresponding framebuffer coordinates.
+The
+<option>-t</option>
+flag causes all lines to be thickened perpendicular to their length,
+to the given number of pixels.
+This is especially useful when making images for recording on videotape,
+as single pixel lines are difficult to resolve.
+The thickening will be reduced so that a
+line will never be wider than it is long.</para>
+
+<para>If
+<emphasis remap='I'>file.plot</emphasis>
+is not specified,
+the plot commands are read from standard in.</para>
+
+<para>Note that 3-D UNIX plot is a superset of the standard UNIX plot
+format, thus this program can display normal plot files as well.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>pl-sgi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>plrot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pldebug</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libplot3</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbpoint.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbpoint.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbpoint.xml (revision 0)
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbpoint1'>
+<refmeta>
+<refentrytitle>FBPOINT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbpoint</refname>
+<refpurpose>point at and identify screen coordinates</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbpoint</command>    
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'><arg choice='plain'>-x </arg><arg choice='opt'><replaceable>prefix</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>-y </arg><arg choice='opt'><replaceable>prefix</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>initx</replaceable></arg><arg choice='plain'><replaceable>inity</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Fbpoint</emphasis>
+allows you to move a non-destructive cursor around on the display.
+As the cursor is moved around,
+<command>fbpoint</command>
+writes the coordinates of the pixel pointed
+at by the cursor, and the red, green, and blue values of that
+pixel, on standard error
+<command>fbpoint</command>
+also writes the last set of coordinates pointed to on standard out on exit.
+The starting position is center-screen unless an optional
+<emphasis remap='I'>initx inity</emphasis>
+is given.</para>
+
+<para>The
+``<emphasis remap='B'>h</emphasis>'',
+``<emphasis remap='B'>j</emphasis>'',
+``<emphasis remap='B'>k</emphasis>'',
+and
+``<emphasis remap='B'>l</emphasis>'',
+commands step the cursor one pixel left, down, up, or right respectively, and
+the
+``<emphasis remap='B'>H</emphasis>'',
+``<emphasis remap='B'>J</emphasis>'',
+``<emphasis remap='B'>K</emphasis>'',
+and
+``<emphasis remap='B'>L</emphasis>'',
+commands step the cursor in the corresponding direction in big increments.
+The
+``<emphasis remap='B'>B</emphasis>'',
+``<emphasis remap='B'>N</emphasis>'',
+``<emphasis remap='B'>P</emphasis>''.
+and
+``<emphasis remap='B'>L</emphasis>'',
+and
+``<emphasis remap='B'>^B</emphasis>'',
+(control-B),
+``<emphasis remap='B'>^N</emphasis>'',
+``<emphasis remap='B'>^P</emphasis>'',
+and
+``<emphasis remap='B'>^F</emphasis>'',
+are also little and big (respectively) cursor movement commands.</para>
+
+<para>A
+``<emphasis remap='B'>?</emphasis>''
+prints a short command summary,
+and typing
+``<emphasis remap='B'>q</emphasis>'',
+or
+``<emphasis remap='B'>Q</emphasis>'',
+exits the program.</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>Using this program with grave accents in a shell script in order to
+interactively grab a pair of coordinates is one of its main
+intentions.  This is the reason for the feedback on standard error and the
+final coordinate pair on standard out.
+By default, both the x and y coordinates are written.  If the
+<option>-x</option>
+or
+<option>-y</option>
+flags are given only those coordinates will be written.  In these
+cases an optional
+<emphasis remap='I'>prefix</emphasis>
+can follow the flag which will be appended to the output coordinate.
+This is to facilitate passing the output of this program as
+arguments to another.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para><command>fbpoint</command>
+<!-- .br -->
+by itself is used to pick coordinates or pixel values from a display.</para>
+
+<para><emphasis remap='I'>fbscanplot `fbpoint -y`</emphasis>
+<!-- .br -->
+allows you to choose the scanline to plot using fbpoint.</para>
+
+<para><emphasis remap='I'>pix-fb `fbpoint -x-X -y-Y` file.pix</emphasis>
+<!-- .br -->
+will allow you to select an x, y screen coordinate and then
+place the lower left corner of the image
+<emphasis remap='I'>file.pix</emphasis>
+at that location.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbgrid</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fbzoom</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fbcbars.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fbcbars.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fbcbars.xml (revision 0)
@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbcbars1'>
+<refmeta>
+<refentrytitle>FBCBARS</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fbcbars</refname>
+<refpurpose>display standard color bars on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fbcbars</command>    
+    <arg choice='opt'>-e </arg>
+    <arg choice='opt'>-f </arg>
+    <arg choice='opt'>-s </arg>
+    <arg choice='opt'>-h </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squarescrsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>scr_height</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>fbcbars</command>
+displays a color bar scale on the currently selected framebuffer.
+The default pattern is the standard SMPTE color bars.</para>
+
+<para>With the
+<option>-f</option>
+flag, FCC/EBU color bars are made.
+The entire screen will contain 8 colors:
+100% white, 75% yellow, 75% cyan, 75% green, 75% magenta, 75% red, 75% blue,
+and black.</para>
+
+<para>By specifying the
+<option>-e</option>
+flag, the standard EIA color bars are displayed,
+arranged horizontally on screen.
+The bottom quarter of the screen will be
+-I, 100% white, Q, black.
+The upper portion of the screen will be
+seven colors at 75% intensity:
+grey, yellow, cyan, green, magenta, red, blue.</para>
+
+<para>By specifying the
+<option>-s</option>
+flag, SMPTE color bars are displayed.  This is the EIA pattern
+with the upper quarter of the bottom quarter of the screen containing
+a reversed and shifted version of the upper pattern, which is very
+useful for aligning color demodulators in monitors.
+Using a dichroic blue filter,
+observe the magenta and cyan bars on the NTSC monitor.
+Adjust the phase of the chroma demodulator until they have visually
+equal intensity.
+At this point, all the other color bars will display the correct chroma.</para>
+
+<para>The environment variable FB_FILE specifies
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>Ordinarily, the requested framebuffer size is the device default.
+Specifying the
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-W&nbsp;</option><replaceable>scr_width</replaceable>
+flag specifies the width of each output scanline, in pixels.</para>
+
+<para>The
+<option>-N&nbsp;</option><replaceable>scr_height</replaceable>
+flag specifies the desired height in scanlines of the display device.</para>
+
+<para><option>-S&nbsp;</option><replaceable>squarescrsize</replaceable>
+set both the height and width to the size given.</para>
+</refsect1>
+
+<refsect1 id='inspirations'><title>INSPIRATIONS</title>
+<para>Mike Pique, University of North Carolina
+<!-- .br -->
+Doris Kochanek, National Film Board of Canada</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Michael John Muuss</para>
+</refsect1>
+
+<refsect1 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 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/pp-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/pp-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/pp-fb.xml (revision 0)
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='ppfb1'>
+<refmeta>
+<refentrytitle>PP-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pp&hyphen;fb</refname>
+<refpurpose>display a GIFT pretty-picture file on a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>pp-fb</command>    
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>out_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>out_height</replaceable></arg>
+    <arg choice='plain'><replaceable>file.pp</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Pp-fb</emphasis>
+reads
+<emphasis remap='I'>file.pp</emphasis>,
+determines the size,
+and displays a color shaded image represented therein
+on a frame buffer.
+The
+<markup>.pp</markup>
+files are the output of the pretty-picture option of the
+<citerefentry><refentrytitle>gift</refentrytitle><manvolnum>1V</manvolnum></citerefentry>
+ray-tracing program.
+The options are standard
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+options specifying framebuffer, output width, and output height.
+Some information pertaining to the color assignment of region identification
+numbers and the background color is prompted for on the standard input.
+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.
+Commands for manipulating the display are documented on-line.
+The file format is not documented anywhere.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>gift</refentrytitle><manvolnum>1V</manvolnum></citerefentry>, <citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 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 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/fb-rle.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/fb-rle.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/fb-rle.xml (revision 0)
@@ -0,0 +1,217 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='fbrle1'>
+<refmeta>
+<refentrytitle>FB-RLE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fb&hyphen;rle</refname>
+<refpurpose>save frame buffer image in a run-length encoded file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fb-rle</command>    
+    <arg choice='opt'>-cdh </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squarescrsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>scr_height</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>scr_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>scr_yoff</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.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>fb-rle</emphasis>
+saves an image from a frame buffer in the University of Utah
+standard (Edition-3, or "Utah Raster Toolkit")
+Run-Length Encoded (RLE) format file
+(these files can be displayed with
+<citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+or a similar program).
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, standard output is written.</para>
+
+<para>The size of the image to be saved can be set with the
+<option>-s</option>
+or
+<option>-n</option>
+and
+<option>-w</option>
+command line options.  If these are omitted, the entire
+screen area will be saved.
+The image rectangle to be saved
+can be repositioned on the screen with the
+<option>-X</option>
+and
+<option>-Y</option>
+command line options.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>changes the screen size to 1024x1024.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W&nbsp;</option><replaceable>scr_width</replaceable></term>
+  <listitem>
+<para>specifies the desired width of the screen, in pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-N&nbsp;</option><replaceable>scr_height</replaceable></term>
+  <listitem>
+<para>specifies the desired height of the screen, in scanlines.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S&nbsp;</option><replaceable>squarescrsize</replaceable></term>
+  <listitem>
+<para>sets the screen width and height to the indicated value.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-F&nbsp;</option><replaceable>framebuffer</replaceable></term>
+  <listitem>
+<para>This option specifies which framebuffer the image is to be saved from.
+If not given, the environment variable
+<acronym></acronym><emphasis remap='B'>FB_FILE</emphasis>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If
+<acronym></acronym><emphasis remap='B'>FB_FILE</emphasis>
+has not been set, the default device for your system will
+be used.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-w&nbsp;</option><replaceable>file_width</replaceable></term>
+  <listitem>
+<para>specifies the desired width of the saved image, in pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n&nbsp;</option><replaceable>file_height</replaceable></term>
+  <listitem>
+<para>specifies the desired height of the saved image, in scanlines.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s&nbsp;</option><replaceable>squarefilesize</replaceable></term>
+  <listitem>
+<para>sets the saved image width and height to the indicated value.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>The &ldquo;crunch colormap&rdquo; option.
+If the frame buffer contains a non standard (i.e. non linear) colormap,
+rather than saving that colormap in the RLE file
+this option causes the colormap to be applied
+to the pixel data before it is saved in the file.
+This can be useful to preserve dramatic images created with weird color maps
+such that Gamma correction (e.g., for film) can also be applied.
+This option is recommended when producing images for export to other
+display systems, so that variations in the interpretation of color maps
+between different types of display hardware do
+not affect the displayed image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>Debug option, provides a verbose description of the input file structure and
+image decoding process, written on standard error.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-C&nbsp;</option><replaceable>r/g/b</replaceable></term>
+  <listitem>
+<para>The background value to be recorded in the RLE file is normally
+automatically selected from the display.
+This option permits
+the user to specify an alternate background color
+as a red/green/blue triple, separated by slashes (&ldquo;/&rdquo;).
+The color intensity in each channel ranges from 0 (dark) to 255 (bright).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-X&nbsp;</option><replaceable>scr_xoff</replaceable></term>
+  <listitem>
+<para>Specify a screen X offset, which will offset the saved area onto the screen
+by the given amount.  (i.e.,
+<option>-X&nbsp;</option><literal>10</literal>
+would place (0,10) on the screen in the RLE image rectangle coordinate (0,0).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-Y&nbsp;</option><replaceable>scr_yoff</replaceable></term>
+  <listitem>
+<para>Specify a screen Y offset, which will offset the saved area onto the screen
+by the given amount.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Name of file to be written, in RLE format.
+If not specified, standard output is used instead.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>The run length encoded image format is best used for the long-term
+storage of images, as it uses less disk storage than a
+<emphasis remap='I'>pix(5)</emphasis>
+file, at the expense of requiring more processing
+for the encoding and decoding.
+This program is also useful when using the Utah Raster Toolkit
+utilities, which only operate on RLE encoded files.</para>
+</refsect1>
+
+<refsect1 id='examples'><title>EXAMPLES</title>
+  <blockquote remap='RS'>
+<para>&thinsp;fb-rle &thinsp;truck.rle
+<!-- .br -->
+&thinsp;fb-rle &thinsp;-C 0/255/0 &thinsp;&gt;car.rle
+<!-- .br -->
+&thinsp;fb-rle &thinsp;-h &thinsp;-s 512 &thinsp;&gt;lowerleft.rle
+  </para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rle-fb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-pix</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>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>comp</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>crop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>repos</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rlepatch</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rlebox</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>librle</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/rle-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/rle-fb.xml (revision 0)
@@ -0,0 +1,310 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='rlefb1'>
+<refmeta>
+<refentrytitle>RLE-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>rle&hyphen;fb</refname>
+<refpurpose>decode run-length encoded image onto a frame buffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>rle-fb</command>    
+    <arg choice='opt'>-Ocdh </arg>
+    <arg choice='opt'>-F <replaceable>framebuffer</replaceable></arg>
+    <arg choice='opt'>-C <replaceable>r/g/b</replaceable></arg>
+    <arg choice='opt'>-S <replaceable>squarescrsize</replaceable></arg>
+    <arg choice='opt'>-W <replaceable>scr_width</replaceable></arg>
+    <arg choice='opt'>-N <replaceable>scr_height</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>scr_xoff</replaceable></arg>
+    <arg choice='opt'>-Y <replaceable>scr_yoff</replaceable></arg>
+    <arg choice='opt'><replaceable>file.rle</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>rle-fb</emphasis>
+decodes a University of Utah
+standard (Edition-3, or "Utah Raster Toolkit")
+Run-Length Encoded (RLE) format file
+(saved with
+<citerefentry><refentrytitle>fb-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+or a similar program)
+to a frame buffer.
+If
+<emphasis remap='I'>file.rle</emphasis>
+is not specified, standard input is read.</para>
+
+<para>Each RLE file contains an <emphasis remap='I'>image rectangle</emphasis>.
+The Utah Raster Toolkit semantics specify that the
+<command>rle-fb</command>
+program is to clip the RLE image rectangle to the screen of the current
+framebuffer, only modifying pixels in that area.
+In the case where the RLE file contains a rectangle of size greater
+than or equal to that of the current screen, then all pixels on the screen
+are modified.
+In the case where the RLE file contains a rectangle smaller than the
+screen, or where a portion of that rectangle has been positioned
+outside the bounds of the screen, then this program will only modify those
+screen pixels underneath the RLE image rectangle.
+While this is behavior can be a great boon when creating a montage of
+smaller images, it behooves the user to arrange for a suitable background.</para>
+
+<para>If the screen size is explicitly specified by a command line option,
+the framebuffer is opened with exactly that size, and the RLE image
+rectangle is clipped to that size, even if the framebuffer hardware
+could support a larger size.
+If the screen size is not specified, then this program attempts to
+open the framebuffer with a size large enough to hold the entire
+RLE image rectangle.  If the open succeeds, but the full size request
+is not honored, then the RLE image rectangle is silently clipped to
+the available screen.
+The RLE image rectangle can be repositioned on the screen with the
+<option>-X</option>
+and
+<option>-Y</option>
+command line options, as well as by using
+<emphasis remap='I'>repos(1)</emphasis>.</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-h</option></term>
+  <listitem>
+<para>changes the screen size to 1024x1024.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-W&nbsp;</option><replaceable>scr_width</replaceable></term>
+  <listitem>
+<para>specifies the desired width of the screen, in pixels.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-N&nbsp;</option><replaceable>scr_height</replaceable></term>
+  <listitem>
+<para>specifies the desired height of the screen, in scanlines.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-S&nbsp;</option><replaceable>squarescrsize</replaceable></term>
+  <listitem>
+<para>sets the screen width and height to the indicated value.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-F&nbsp;</option><replaceable>framebuffer</replaceable></term>
+  <listitem>
+<para>This option specifies which framebuffer the image is to be displayed on.
+If not given, the environment variable
+<acronym></acronym><emphasis remap='B'>FB_FILE</emphasis>
+is used to select the display device (see
+<emphasis remap='I'>brlcad(1)</emphasis>).
+If
+<acronym></acronym><emphasis remap='B'>FB_FILE</emphasis>
+has not been set, the default device for your system will
+be used.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-c</option></term>
+  <listitem>
+<para>The &ldquo;crunch colormap&rdquo; option.
+If the RLE file contains a colormap, rather than loading that colormap
+into the framebuffer and allowing the framebuffer to apply the colormap
+to produce the final image, this option causes the colormap to be applied
+to the pixel data before it is sent to the framebuffer.
+In this case, the colormap in the framebuffer is undisturbed.
+This can be useful to preserve dramatic images created with weird color maps
+such that Gamma correction (e.g., for film) can also be applied.
+This option is recommended when producing images for export to other
+display systems, so that variations in the interpretation of color maps
+between different types of display hardware do
+not affect the displayed image.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d</option></term>
+  <listitem>
+<para>Debug option, provides a verbose description of the input file structure and
+image decoding process, written on standard error.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-O</option></term>
+  <listitem>
+<para>Restores the image data in <emphasis remap='I'>overlay</emphasis> mode.
+Only areas of the original image which were not the background color are
+decoded.  The rest of the image already in the frame buffer is undisturbed.
+That this mode uses twice as many DMAs to the frame buffer as
+the normal mode.
+This is because each scanline of the
+previous image must be read from the framebuffer,
+the overlay portions of the new image written on top,
+and the composite scanline must be written back to the framebuffer.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-C&nbsp;</option><replaceable>r/g/b</replaceable></term>
+  <listitem>
+<para>If the image is not being decoded in overlay mode, the background is
+normally set to the value recorded in the RLE file.
+This option permits
+the user to specify an alternate background color
+as a red/green/blue triple, separated by slashes (&ldquo;/&rdquo;).
+The color intensity in each channel ranges from 0 (dark) to 255 (bright).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-X&nbsp;</option><replaceable>scr_xoff</replaceable></term>
+  <listitem>
+<para>Specify a screen X offset, which will offset the file onto the screen
+by the given amount.  (i.e.,
+<option>-X&nbsp;</option><literal>10</literal>
+would place (0,0) in the RLE image rectangle at screen coordinate (10,0).
+The offset may be negative or positive.
+The RLE image rectangle will be clipped to the screen, as required.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-Y&nbsp;</option><replaceable>scr_yoff</replaceable></term>
+  <listitem>
+<para>Specify a screen Y offset, which will offset the file onto the screen
+by the given amount.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='I'>file.rle</emphasis></term>
+  <listitem>
+<para>Name of file to decode, in RLE format.
+If not specified, standard input is used instead.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+
+<para>The run length encoded image format is best used for the long-term
+storage of images, as it uses less disk storage than a
+<emphasis remap='I'>pix(5)</emphasis>
+file, at the expense of requiring more processing
+for the encoding and decoding.
+This program is also useful when using the Utah Raster Toolkit
+utilities, which only operate on RLE encoded files;
+this program will display their results on a framebuffer.</para>
+
+<para>Simple compositing of images can be done with the
+<option>-O</option>
+overlay flag on
+<emphasis remap='I'>rle-fb(1)</emphasis>.
+More sophisticated compositing can be achieved using some of the
+other tools.
+For RLE files,
+<emphasis remap='I'>comp(1)</emphasis>,
+<emphasis remap='I'>crop(1)</emphasis>,
+<emphasis remap='I'>repos(1)</emphasis>,
+<emphasis remap='I'>rlepatch(1)</emphasis>,
+and
+<emphasis remap='I'>rlebox(1)</emphasis>
+can be used.
+For
+<emphasis remap='I'>pix(5)</emphasis>
+files,
+<emphasis remap='I'>pixrect(1)</emphasis>,
+<emphasis remap='I'>pixscale(1)</emphasis>,
+and
+<emphasis remap='I'>pixmerge(1)</emphasis>
+are used.</para>
+</refsect1>
+
+<refsect1 id='examples'><title>EXAMPLES</title>
+  <blockquote remap='RS'>
+<para>&thinsp;rle-fb &thinsp;truck.rle
+<!-- .br -->
+&thinsp;rle-fb &thinsp;-O &thinsp;text.rle
+<!-- .br -->
+&thinsp;rle-fb &thinsp;-C 0/255/0 &thinsp;&lt;car.rle
+  </para></blockquote> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term>&ldquo;rle-fb: excess arguments ignored&rdquo;.</term>
+  <listitem>
+<para>More than one RLE file name was specified.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&ldquo;rle-fb: Error reading setup information&rdquo;.</term>
+  <listitem>
+<para>The subroutine
+<function>rle_get_setup()</function>
+returned an error code.
+Either the file is not in Edition-2 or Edition-3 RLE format,
+or the file has been damaged or truncated.
+If the file is in Edition-1 RLE format, the
+<emphasis remap='I'>orle-fb(1)</emphasis>
+program can be used to display the file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&ldquo;rle-fb: Warning: RLE image rectangle entirely off screen&rdquo;</term>
+  <listitem>
+<para>The combined effects of the RLE image rectangle definition stored in the
+RLE file and any
+<option>-X</option>
+and
+<option>-Y</option>
+command line options have resulted in the RLE image rectangle being
+shifted entirely off the screen.
+While this is not an error, no screen pixels were changed.
+This may not have been the intent of the user, so the message is printed.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term>&ldquo;rle-fb: correcting for old style colormap&rdquo;.</term>
+  <listitem>
+<para>The only change between the Edition-2 and Edition-3 RLE file formats
+that is not upwards compatible is the format of the colormap.
+Edition-2 stored eight bits of data right justified in a 16-bit field,
+while Edition-3 stores a full 16-bit field.
+In order to allow this program to decode images stored in the Edition-2
+format, any colormap which has the upper eight bits all zero in all
+colormap entries is assumed to be an Edition-2 colormap, and is adjusted
+for suitable display.
+While this heuristic may be &ldquo;tricked&rdquo; with an Edition-3 colormap
+with degenerate values, the picture would have been very dark,
+and the benefits of full upwards compatibility from Edition-2 format files
+were deemed worth this risk.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 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-pix</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix-rle</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>pixrect</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixscale</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>pixmerge</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>comp</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>crop</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>repos</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rlepatch</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>rlebox</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>librle</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>BRL-CAD Team</para>
+</refsect1>
+
+<refsect1 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 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-fb.xml
===================================================================
--- brlcad/doc/docbook/system/man1/en/png-fb.xml (revision 0)
+++ brlcad/doc/docbook/system/man1/en/png-fb.xml (revision 0)
@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='pngfb1'>
+<refmeta>
+<refentrytitle>PNG-FB</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>png-fb</refname>
+<refpurpose>display a Portable Network Graphics (PNG) image file on a framebuffer</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>png-fb</command>    
+    <arg choice='opt'>-Hhicvz1 </arg>
+    <arg choice='opt'>-gscreen_gamma </arg>
+    <arg choice='opt'>-Fframebuffer </arg>
+    <arg choice='opt'>-m#lines </arg>
+    <arg choice='opt'>-Ssquarescrsize </arg>
+    <arg choice='opt'>-Wscr_width </arg>
+    <arg choice='opt'>-Nscr_height </arg>
+    <arg choice='opt'>-xfile_xoff </arg>
+    <arg choice='opt'>-yfile_yoff </arg>
+    <arg choice='opt'>-Xscr_xoff </arg>
+    <arg choice='opt'>-Yscr_yoff </arg>
+    <arg choice='opt'><replaceable>file.png</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Png-fb</emphasis>
+reads a
+<emphasis remap='I'>PNG</emphasis>
+format file from the named file, or from
+standard in if no file is specified, and displays the
+image on the currently selected framebuffer.
+The environment variable FB_FILE may be used to specify
+the current framebuffer, see
+<citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Alternatively, the framebuffer may be explicitly specified
+by using the
+<option>-F</option>
+flag.</para>
+
+<para>By default, the requested framebuffer size, is assumed to be 512x512 pixels.
+<option>-h</option>
+flag changes the size to 1024x1024.</para>
+
+<para>The
+<option>-g</option>
+option specifies the gamma value for the screen where the image is to be displayed.
+Larger values will produce lighter colored display.</para>
+
+<para>If the
+<option>-i</option>
+flag is specified, the image is inverted.</para>
+
+<para>The
+<option>-c</option>
+flag causes the screen to be cleared before the image is displayed.
+The default behavior is to overwrite the current image
+with the new image without clearing the screen.</para>
+
+<para>The
+<option>-v</option>
+option will print verbose information about the PNG file.</para>
+
+<para>The
+<option>-H</option>
+option will print a single line on standard output providing
+the dimensions of the image in a format readily usable in shell scripts,
+e.g. WIDTH=42 HEIGHT=17.</para>
+
+<para>The
+<option>-z</option>
+flag will zoom and center on the image being displayed
+to make it fill the display area, using the libfb fb_zoom() routine.
+fb_zoom only offers integer zoom factors, so displays with non-square
+screens (such as the SGI 3D machines) may find this option of limited
+usefulness.</para>
+
+<para>The
+<option>-W scr_width</option>
+flag specifies the width of each scanline in the display device, in pixels.</para>
+
+<para>The
+<option>-N scr_height</option>
+flag specifies the height in scanlines of the display device.</para>
+
+<para><option>-S squarescrsize</option>
+set both the height and width to the size given.</para>
+
+<para><option>-x file_xoff -y file_yoff</option>
+and
+<option>-X scr_xoff -Y scr_yoff</option>
+will offset into the file or onto the screen by the given amounts.
+The coordinate system for these offsets is first quadrant, with
+the origin at the lower left corner of the image.</para>
+
+<para>The
+<option>-1</option>
+flag causes the image to be written to the framebuffer one line at
+a time, using the
+<citerefentry><refentrytitle>fb_write</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+routine.  This is the default behavior.
+The
+<option>-m #lines</option>
+flag can be used to specify the number of lines to be written to the
+framebuffer in rectangular blocks of scanlines, using the
+<citerefentry><refentrytitle>fb_writerect</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+routine.
+In some circumstances, this can result in significantly faster image
+display, at the expense of the image being written less smoothly.
+If both
+<option>-m</option>
+and
+<option>-1</option>
+are specified,
+<option>-1</option>
+wins.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>rt</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>fb-png</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libfb</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>pix</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>John R. Anderson</para>
+
+</refsect1>
+
+<refsect1 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 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>
+
