Index: g-x3d.xml
===================================================================
--- g-x3d.xml	(revision 0)
+++ g-x3d.xml	(revision 0)
@@ -0,0 +1,113 @@
+<?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='gx3d1'>
+<refmeta>
+<refentrytitle>G-X3D</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-x3d</refname>
+<refpurpose>Perform Boolean evaluations to produce an X3D facetted model</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-x3d</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-d <replaceable>calc_dist_tol</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tess_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tess_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tess_tol</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>librt_debug_flag</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>NMG_debug_flag</replaceable></arg>
+    <arg choice='opt'>-u <replaceable>units_name</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>outfile</replaceable></arg>
+    <arg choice='plain'><replaceable>infile.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>g-x3d</command>
+performs the Boolean operations specified in any regions in the specified
+<emphasis remap='I'>object(s)</emphasis>
+and writes the resulting facetted objects to
+<emphasis remap='I'>outfile</emphasis>
+or to
+<emphasis remap='I'>stdout</emphasis>
+if the
+<option>-o</option>
+option is not used. The output is in X3D facetted format. The
+<option>-v</option>
+option requests verbose output while the conversion is taking place. The
+<option>-d</option>
+option specifies a calculational distance tolerance (in millimeters). This
+tolerance is used to distinguish neighboring vertices. Any two vertices less than
+this tolerance distance apart will be considered the same vertex. The default value
+is 0.005mm.
+Prior to performing the Boolean operations for each region, the involved primitive solids
+are converted to a planar facetted approximation and stored as NMG solids. This tessellation
+can be controlled using the tessellation tolerances. The
+<option>-a</option>
+option may be used to specify an absolute tessellation tolerance (in millimeters). This
+requires that the maximum absolute error from the tessellated surface to the actual
+surface must not be greater than
+<emphasis remap='I'>abs_tess_tol.</emphasis>
+The
+<option>-n</option>
+option specifies a surface normal error tolerance (in degrees) for the tessellation.
+The
+<option>-r</option>
+option may be used to set a relative error tolerance. This effectively
+sets an absolute tolerance for each primitive solid by multiplying the
+overall size of the solid by
+<emphasis remap='I'>rel_tess_tol.</emphasis>
+The
+<option>-x</option>
+and
+<option>-X</option>
+options are used to set debug flags for
+<emphasis remap='I'>librt</emphasis>
+and the
+<emphasis remap='I'>NMG</emphasis>
+routines respectively. The definitions of these flags may be found in
+<emphasis remap='I'>raytrace.h</emphasis>
+and
+<emphasis remap='I'>nmg.h.</emphasis>
+The
+<option>-u</option>
+option can be used to set the units for the resulting X3D file (the default is mm).
+Any units name that MGED accepts will work here.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-x3d &thinsp;-o shell.x3d &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>Robert Parker (The SURVICE Engineering Co., Aberdeen, MD)</para>
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2002-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: dbclean.xml
===================================================================
--- dbclean.xml	(revision 0)
+++ dbclean.xml	(revision 0)
@@ -0,0 +1,91 @@
+<?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='dbclean1'>
+<refmeta>
+<refentrytitle>DBCLEAN</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dbclean</refname>
+<refpurpose> a shell script for compacting mged databases.</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>dbclean</command>    
+    <arg choice='plain'><replaceable>in_model.g</replaceable></arg>
+    <arg choice='plain'><replaceable>out_model.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Dbclean</emphasis>
+operates on the indicated input database
+<emphasis remap='I'>in_model.g</emphasis>
+and produces a compacter version of the same
+<emphasis remap='I'>out_model.g.</emphasis></para>
+
+<para>The objective is to remove ``holes" left in the original database by using
+the <emphasis remap='I'>kill/killall</emphasis> command in
+<citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+Note that when a database is compacted in this manner, the compacting is
+dependent on the successful completion of the converters
+<citerefentry><refentrytitle>g2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and
+<citerefentry><refentrytitle>asc2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+The compacting will only be aborted if one of the conversions fails.  Thus,
+when either converter ``skips" solids, <command>dbclean</command> will continue, and
+<emphasis remap='I'>out_model.g</emphasis>
+will be written, albeit, without the skipped solids.  This will also
+result in a smaller database.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<para>This section will acquaint the user with the ordinary usage of <command>dbclean</command>.</para>
+
+<literallayout remap='.nf'>
+<emphasis remap='I'>dbclean in_model.g out_model.g</emphasis>
+</literallayout> <!-- .fi -->
+
+<para>This will result in a compacted version of the input.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Numerous error conditions are possible, usually due to errors in
+the geometry database.
+Descriptive messages are printed on standard error (file descriptor 2).</para>
+</refsect1>
+
+<refsect1 id='bugs'><title>BUGS</title>
+<para>Most deficiencies observed while using the
+<command>dbclean</command>
+program are usually with the
+<citerefentry><refentrytitle>g2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and
+<citerefentry><refentrytitle>asc2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+packages instead.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Susanne Muuss, J.D.</para>
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1991-2012 United States Government as
+represented by the U.S. Army Research Laboratory. All rights reserved.</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: nastran-g.xml
===================================================================
--- nastran-g.xml	(revision 0)
+++ nastran-g.xml	(revision 0)
@@ -0,0 +1,82 @@
+<?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='nastrang1'>
+<refmeta>
+<refentrytitle>NASTRAN-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>nastran-g</refname>
+<refpurpose>NASTRAN Translator (NASTRAN to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>nastran-g</command>    
+    <arg choice='opt'>-t <replaceable>tolerance</replaceable></arg>
+    <arg choice='opt'>-t <replaceable>tolerance_distance</replaceable></arg>
+    <arg choice='opt'>-n </arg>
+    <arg choice='opt'>-m </arg>
+    <arg choice='plain'>-i <replaceable>nastran_input_file</replaceable></arg>
+    <arg choice='plain'>-o <replaceable>database.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>nastran-g</emphasis>
+converts the specified
+<emphasis remap='I'>nastran_input_file</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file. The
+<emphasis remap='I'>tolerance_distance</emphasis>
+provided is the maximum distance (in mm) between two
+vertices at which they will be considered to be the same vertex. The
+<option>-n</option>
+option requests that the output solids created from
+<emphasis remap='I'>NASTRAN CQUAD4</emphasis>
+or
+<emphasis remap='I'>CTRIA3</emphasis>
+elements be stored in the BRL-CAD file as NMG solids rather than the default BOT solids. The
+<option>-m</option>
+option indicates that the units of the NASTRAN file are millimeters, rather than the default
+inches. The converter currently only handles the
+<emphasis remap='I'>CROD, CBAR, CTRIA3,</emphasis>
+and
+<emphasis remap='I'>CQUAD4</emphasis>
+elements.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>nastran-g &thinsp;-i nastran.file &thinsp;-o sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</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: enf-g.xml
===================================================================
--- enf-g.xml	(revision 0)
+++ enf-g.xml	(revision 0)
@@ -0,0 +1,82 @@
+<?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='enfg1'>
+<refmeta>
+<refentrytitle>ENF-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>enf-g</refname>
+<refpurpose>Elysium Neutral Format Translator (ENF to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>enf-g</command>    
+    <arg choice='opt'>-t <replaceable>tolerance</replaceable></arg>
+    <arg choice='opt'>-i <replaceable>starting_ident_number</replaceable></arg>
+    <arg choice='opt'>-l <replaceable>name_length_limit</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>part_number_to_name_mapping</replaceable></arg>
+    <arg choice='plain'><replaceable>input_enf_facet_file</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>enf-g</emphasis>
+converts the specified
+<emphasis remap='I'>input_enf_facet_file</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file. This input file is expected to be the ASCII output from the Elysium enf2mxp tessellator. The
+<emphasis remap='I'>tolerance</emphasis>
+provided is the maximum distance (in mm) between two
+vertices at which they will be considered to be the same vertex. The
+<emphasis remap='I'>starting_ident_number</emphasis>
+is the ident number to use for the first region created, each succeeding region will have their
+ident numbers incremented by one.
+If a
+<emphasis remap='I'>name_length_limit</emphasis>
+is provided, then the resulting names in the BRL-CAD model will not be longer than
+that limit. If a
+<emphasis remap='I'>part_number_to_name_mapping</emphasis>
+file is provided, then that file will be read and used to convert part numbers in the
+<emphasis remap='I'>input_enf_facet_file</emphasis>
+to the corresponding names in the mapping. This file is expected to consist of a series
+of lines of text with each line having a part number and a legal BRL-CAD object name separated
+by a tab.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>enf-g &thinsp;sample.enf &thinsp;sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2001-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: dbupgrade.xml
===================================================================
--- dbupgrade.xml	(revision 0)
+++ dbupgrade.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='dbupgrade1'>
+<refmeta>
+<refentrytitle>DBUPGRADE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>dbupgrade</refname>
+<refpurpose> a program to upgrade BRL-CAD mged geometry databases files to the current version.</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>dbupgrade</command>    
+    <arg choice='plain'><replaceable>input.g</replaceable></arg>
+    <arg choice='plain'><replaceable>output.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>dbupgrade</command>
+operates on the indicated input geometry database
+<emphasis remap='I'>input.g</emphasis>
+recognizing the version of the BRL-CAD database provided as input and
+then converting it to the current database version.  Output is then saved to the specified
+<emphasis remap='I'>output.g</emphasis>
+file.</para>
+
+<para>Note that this tool does not automatically &ldquo;fix&rdquo; an existing (v4
+format) binary database that was transferred from a
+binary-incompatible platform.  However, if you run
+<command>dbupgrade</command>
+on the file before transferring from that platform, the upgraded
+output file will be platform independent.</para>
+
+<para>Running
+<command>dbupgrade</command>
+removes the need to run
+<citerefentry><refentrytitle>g2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+and
+<citerefentry><refentrytitle>asc2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+on a database.  The latest BRL-CAD geometry database format is
+platform independent.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>g2asc</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>asc2g</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Numerous error conditions are possible, usually due to errors in
+the geometry database.
+Descriptive messages are printed on standard error (file descriptor 2).</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) 2006-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: g-nff.xml
===================================================================
--- g-nff.xml	(revision 0)
+++ g-nff.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='gnff1'>
+<refmeta>
+<refentrytitle>G-NFF</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-nff</refname>
+<refpurpose>NFF Translator (BRL-CAD to NFF)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-nff</command>    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-i </arg>
+    <arg choice='opt'>-xX <replaceable>lvl</replaceable></arg>
+    <arg choice='opt'>-e <replaceable>error_file</replaceable></arg>
+    <arg choice='opt'>-D <replaceable>calculation_tolerance</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tol</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>output.nff</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>g-nff</emphasis>
+converts the specified
+<emphasis remap='I'>object(s)</emphasis>
+from a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file to the
+<emphasis remap='I'>NFF</emphasis>
+file format.
+The
+<option>-x</option>
+option specifies an RT debug flag and the
+<option>-X</option>
+option specifies an NMG debug flag. The
+<option>-a</option>
+,
+<option>-r</option>
+, and
+<option>-n</option>
+options specify tesselation tolerances.
+The
+<option>-D</option>
+option specifies a calculational distance tolerance (mm). Any two vertices
+that are less than this distance apart will be treated as the same vertex.
+The
+<option>-v</option>
+option requests verbose output.
+The
+<option>-i</option>
+option requests the output file units to be inches (the default is mm).
+The
+<option>-o</option>
+option specifies the name of the file to receive the output
+(stdout is the default).
+The
+<option>-e</option>
+option specifies a file for receiving the error messages.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-nff &thinsp;-o sample.nff &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2003-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: g-obj.xml
===================================================================
--- g-obj.xml	(revision 0)
+++ g-obj.xml	(revision 0)
@@ -0,0 +1,116 @@
+<?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='gobj1'>
+<refmeta>
+<refentrytitle>G-OBJ</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-obj</refname>
+<refpurpose>BRL-CAD to Wavefront Object File converter</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-obj</command>    <arg choice='opt'>-mviu </arg>
+    <arg choice='opt'>-xX <replaceable>lvl</replaceable></arg>
+    <arg choice='opt'>-e <replaceable>error_file</replaceable></arg>
+    <arg choice='opt'>-D <replaceable>calculation_tolerance</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tol</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>output.obj</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>g-obj</emphasis>
+converts the specified
+<emphasis remap='I'>object(s)</emphasis>
+from a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file to the
+<emphasis remap='I'>Wavefront</emphasis>
+<emphasis remap='I'>OBJ</emphasis>
+file format.
+The
+<option>-x</option>
+option specifies an RT debug flag and the
+<option>-X</option>
+option specifies an NMG debug flag. The
+<option>-a</option>
+,
+<option>-r</option>
+, and
+<option>-n</option>
+options specify tesselation tolerances.
+The
+<option>-D</option>
+option specifies a calculational distance tolerance (mm). Any two vertices
+that are less than this distance apart will be treated as the same vertex.
+The
+<option>-u</option>
+option specifies that vertex normals are desired.
+The
+<option>-v</option>
+option requests verbose output.
+The
+<option>-i</option>
+option requests the output file units to be inches (the default is mm).
+The
+<option>-o</option>
+option specifies the name of the file to receive the output
+(stdout is the default).
+The
+<option>-m</option>
+option will result in 'usemtl' statements in the output file. These statements are fictional
+(they do not refer to any material database). The materials named provide information about
+the material codes assigned to the objects in the BRL-CAD database. The material names will be
+of the form 'aircode_los_material', where
+<emphasis remap='I'>aircode</emphasis>
+is the code number for the air represented by that region, if it does represent air,
+otherwise this will be zero. The
+<emphasis remap='I'>los</emphasis>
+is the Line Of Sight thickness (0-100) assigned to the region, and the
+<emphasis remap='I'>material</emphasis>
+is the material code number assigned.
+The
+<option>-e</option>
+option specifies a file for receiving the error messages.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-obj &thinsp;-o sample.obj &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1997-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 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: cy-g.xml
===================================================================
--- cy-g.xml	(revision 0)
+++ cy-g.xml	(revision 0)
@@ -0,0 +1,66 @@
+<?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='cyg1'>
+<refmeta>
+<refentrytitle>CY-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>cy-g</refname>
+<refpurpose>Cyberware Echo file format to BRL-CAD converter</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>cy-g</command>    
+    <arg choice='plain'><replaceable>input_cy_file</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>cy-g</emphasis>
+converts the specified
+<emphasis remap='I'>input_cy_file</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file. The input data must be Cyberware digitizer data in the Cyberware
+Echo (.cy) file format.  Support is limited to scans in cylindrical
+scan format.  The result of the conversion is a single
+<emphasis remap='I'>ARS</emphasis>
+(Arbitrary faceted solid) solid.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>cy-g &thinsp;sample.cy &thinsp;sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</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: poly-bot.xml
===================================================================
--- poly-bot.xml	(revision 0)
+++ poly-bot.xml	(revision 0)
@@ -0,0 +1,69 @@
+<?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='polybot1'>
+<refmeta>
+<refentrytitle>POLY-BOT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>poly-bot</refname>
+<refpurpose>Polysolid to BOT translator</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>poly-bot</command>    
+    <arg choice='opt'><arg choice='plain'><replaceable>input_file.g</replaceable></arg><arg choice='plain'><replaceable>output_file.g</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>poly-bot</emphasis>
+converts all the polysolids in the specified
+<emphasis remap='I'>input_file.g</emphasis>
+(or standard input, if no files are specified)
+to
+<emphasis remap='I'>BOT</emphasis>
+solids and writes them to the
+<emphasis remap='I'>output_file.g</emphasis>
+( or standard out, if no files are specified on the command line).
+All other records (except
+<emphasis remap='I'>FREE</emphasis>
+records) are copied verbatim.
+This command will only work with database version "v4" (BRL-CAD releases 5.3 and earlier).</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>poly-bot &thinsp;polys.g &thinsp;bots.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2000-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+
+</refsect1>
+
+<refsect1 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: fast4-g.xml
===================================================================
--- fast4-g.xml	(revision 0)
+++ fast4-g.xml	(revision 0)
@@ -0,0 +1,156 @@
+<?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='fast4g1'>
+<refmeta>
+<refentrytitle>FAST4-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>fast4-g</refname>
+<refpurpose>FASTGEN4 Translator (FASTGEN4 to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>fast4-g</command>    
+    <arg choice='opt'>-dwq </arg>
+    <arg choice='opt'>-o <replaceable>plot_file</replaceable></arg>
+    <arg choice='opt'>-m <replaceable>muves_warnings</replaceable></arg>
+    <arg choice='opt'>-c <replaceable>id_list</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>RT_DEBUG_FLAG</replaceable></arg>
+    <arg choice='opt'>-b <replaceable>BU_DEBUG_FLAG</replaceable></arg>
+    <arg choice='plain'><replaceable>file.fastgen4</replaceable></arg>
+    <arg choice='plain'><replaceable>file.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>fast4-g</emphasis>
+converts the specified
+<emphasis remap='I'>file.fastgen4</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>file.g</emphasis>
+file.</para>
+
+<para>The
+<option>-d</option>
+option prints debugging information and the
+<option>-w</option>
+option prints warnings whenever an object is assigned a default name (no
+name specified in the FASTGEN4 file).</para>
+
+<para>The
+<option>-q</option>
+option requests quiet mode, so that nothing will be printed except errors.</para>
+
+<para>The
+<option>-b</option>
+option specifies a value for a debug flag for libbu and the
+<option>-x</option>
+option specifies a value for the librt debug flag.</para>
+
+<para>The
+<option>-o</option>
+option indicates that all CTRI and CQUAD elements that get processed should be output to the
+specified plot_file in libplot3 format.  This plot file can be viewed in MGED using the
+<emphasis remap='I'>overlay</emphasis>
+command.</para>
+
+<para>The
+<option>-m</option>
+option requests that information about any CHGCOMP and CBACKING elements be output in the specified
+<emphasis remap='I'>muves_warnings</emphasis>
+file.</para>
+
+<para>The
+<option>-c</option>
+option allows the user to specify a restricted set of components to process from the
+input file. The
+<emphasis remap='I'>id_list</emphasis>
+may be a comma separated list of ident numbers and ranges. For example,
+<option>-c 3002,5678,9213,1002-1100</option>
+will convert only the regions with idents of 3002,5678,9213, and everything from 1002 through 1100.</para>
+
+<para>If you have a FASTGEN2 or FASTGEN3 format file, they can be converted by processing them with
+<emphasis remap='I'>rpatch</emphasis>
+and then providing the resulting rpatch file to the
+<emphasis remap='I'>patch-g</emphasis>
+converter.  See their respective manual pages for more information.</para>
+
+<para>The
+<emphasis remap='I'>file.fastgen4</emphasis>
+file is expected to be in the FASTGEN 4.1 format as defined in the
+FASTGEN 4.1 User Manual.</para>
+
+<para><emphasis remap='I'>CCONE1, CCONE2,</emphasis>
+and
+<emphasis remap='I'>CCONE3</emphasis>
+elements are converted to BRL-CAD truncated right cylinders
+<emphasis remap='I'>(TRC). CHEX2</emphasis>
+elements are converted to BRL-CAD arbitrary convex polyhedrons
+<emphasis remap='I'>(ARB8).</emphasis>
+<emphasis remap='I'>CLINE</emphasis>
+elements are converted to BRL-CAD cline solids.
+<emphasis remap='I'>CQUAD</emphasis>
+,
+<emphasis remap='I'>CTRI</emphasis>
+, and
+<emphasis remap='I'>CHEX1</emphasis>
+elements are converted to faces of a BRL-CAD BOT (Bag Of Triangles).
+<emphasis remap='I'>CSPHERE</emphasis>
+elements are converted to BRL-CAD sphere
+<emphasis remap='I'>(SPH)</emphasis>
+solids. BRL-CAD region ident numbers are assigned by combining the
+FASTGEN4 group and component numbers:</para>
+
+<literallayout remap='.nf'>
+	ident = group x 1000 + component
+</literallayout> <!-- .fi -->
+
+<para>and object names are assigned from the FASTGEN4
+<emphasis remap='I'>$NAME</emphasis>
+elements using an algorithm to create unique BRL-CAD names.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>fast4-g &thinsp;sample.fastgen4 &thinsp;sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>rpatch</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>patch-g</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+<!-- .br -->
+<emphasis remap='I'>FASTGEN 4.1 User's Manual,</emphasis>
+XRESV Tech Note 94-01,
+Hugh Griffis and Maty Lentz,
+April 1994</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>BRL-CAD Team</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: viewpoint-g.xml
===================================================================
--- viewpoint-g.xml	(revision 0)
+++ viewpoint-g.xml	(revision 0)
@@ -0,0 +1,85 @@
+<?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='viewpointg1'>
+<refmeta>
+<refentrytitle>VIEWPOINT-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>viewpoint-g</refname>
+<refpurpose>VIEWPOINT Translator (VIEWPOINT to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>viewpoint-g</command>    
+    <arg choice='opt'>-t <replaceable>tolerance</replaceable></arg>
+    <arg choice='plain'>-c <replaceable>input_coordinates_file</replaceable></arg>
+    <arg choice='plain'>-e <replaceable>input_elements_file</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>database.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>viewpoint-g</emphasis>
+converts the specified input files to a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file. The
+<emphasis remap='I'>tolerance</emphasis>
+provided is the maximum distance (in mm) between two
+vertices at which they will be considered to be the same vertex. The
+<emphasis remap='I'>input_coordinates_file</emphasis>
+and the
+<emphasis remap='I'>input_elements_file</emphasis>
+are expected to be in the
+<emphasis remap='I'>VIEWPOINT</emphasis>
+triangulated format as provided by
+<emphasis remap='I'>Viewpoint Datalabs.</emphasis>
+In this format each object is represented as a group of
+elements, and each element is a group of triangular facets.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>viewpoint-g &thinsp;-e viewpoint.elems &thinsp;-c viewpoint.coords &thinsp;-o sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<literallayout remap='.nf'>
+Viewpoint Dataset Catalog
+Viewpoint Datalabs Int'l
+625 South State Street
+Orem, UT     84058
+(801)229-3000
+</literallayout> <!-- .fi -->
+
+</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>BRL-CAD Team</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: conv-vg2g.xml
===================================================================
--- conv-vg2g.xml	(revision 0)
+++ conv-vg2g.xml	(revision 0)
@@ -0,0 +1,66 @@
+<?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='convvg2g1'>
+<refmeta>
+<refentrytitle>CONV-VG2G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>conv-vg2g</refname>
+<refpurpose>upgrade old to new format binary MGED database</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>conv-vg2g</command>    
+    <arg choice='plain'><replaceable>file.vg</replaceable></arg>
+    <arg choice='plain'><replaceable>file.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>Conv-vg2g</emphasis>
+converts several older forms of binary
+<citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+databases to the current form.</para>
+
+<para>The conversion from version 3 to version 4 (the current version)
+is fairly straightforward.
+Conversion from older versions requires additional information,
+for which the user is prompted.  The units of the database must
+be specified as:
+1=mm, 2=cm, 3=meters, 4=inches, 5=feet.
+A title for the database is also requested.</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>mged</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libged</refentrytitle><manvolnum>3</manvolnum></citerefentry></para>
+</refsect1>
+
+<refsect1 id='diagnostics'><title>DIAGNOSTICS</title>
+<para>Error messages are intended to be self-explanatory,
+and usually indicate errors in the input database.
+It may be possible to rescue a damaged old database
+by suitably modifying the source code to the converter.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Keith A. Applin</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: bot_dump.xml
===================================================================
--- bot_dump.xml	(revision 0)
+++ bot_dump.xml	(revision 0)
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE book 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="bot_dump1">
+	<refmeta>
+		<refentrytitle>BOT_DUMP</refentrytitle>
+		<manvolnum>1</manvolnum>
+		<refmiscinfo class="source">BRL-CAD</refmiscinfo>
+	</refmeta>
+	<refnamediv>
+		<refname>bot_dump</refname>
+		<refpurpose>export polygonal BoT primitives without performing evaluation</refpurpose>
+	</refnamediv>
+	<!-- body begins here -->
+	<refsynopsisdiv id="synopsis">
+		<cmdsynopsis>
+			<command>bot_dump</command>
+			<arg choice="opt">-b </arg>
+			<arg choice="opt">-n </arg>
+			<arg choice="opt">-m <replaceable>directory</replaceable></arg>
+			<arg choice="opt">-o <replaceable>file</replaceable></arg>
+			<group choice="opt">
+				<arg choice="plain">-t <replaceable>dxf</replaceable></arg>
+				<arg choice="plain">
+					<replaceable>obj</replaceable>
+				</arg>
+				<arg choice="plain">
+					<replaceable>sat</replaceable>
+				</arg>
+				<arg choice="plain">
+					<replaceable>stl</replaceable>
+				</arg>
+			</group>
+			<arg choice="opt">-u <replaceable>units</replaceable></arg>
+			<arg choice="opt">-v </arg>
+			<arg choice="plain">
+				<replaceable>geom.g</replaceable>
+			</arg>
+			<arg choice="opt">
+				<arg choice="plain">
+					<replaceable>bot1</replaceable>
+				</arg>
+				<arg choice="plain" rep="repeat">
+					<replaceable>bot2</replaceable>
+				</arg>
+			</arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+	<refsect1 id="description">
+		<title>DESCRIPTION</title>
+		<para>
+			<command>bot_dump</command>
+		</para>
+		<para>The
+			<option>-b</option>
+			option may be specified to indicate that the output file should be in
+			a binary format (e.g., for formats that support ascii and binary
+			formats like stl).</para>
+		<para>If the
+			<option>-n</option>
+			option is specified, BoT surface normals will be included in the output
+			of
+			<emphasis remap="I">obj</emphasis>
+			files. This option is specific to
+			<emphasis remap="I">obj</emphasis>
+			file generation since normal vector outputs are already an integral
+			part of the
+			<emphasis remap="I">stl</emphasis>
+			file outputs and both the
+			<emphasis remap="I">dxf</emphasis>
+			and
+			<emphasis remap="I">sat</emphasis>
+			file formats do not support or require surface normal generation.</para>
+		<para>If the
+			<option>-m</option>
+			option is specified, then BoTs will be output to the directory name
+			specified with one BoT per file.</para>
+		<para>The
+			<option>-o</option>
+			option specifies what output file the BoT data should be dumped to.</para>
+		<para>The
+			<option>-t</option>
+			is used to specify the desired output file type.  The default output
+			type is STL in ASCII format.</para>
+		<para>The
+			<option>-u</option>
+			option takes a units string that indicates the unit conversion to
+			perform during output (converting from internal millimeter values to
+			the unit type specified).</para>
+	</refsect1>
+	<refsect1 id="example">
+		<title>EXAMPLE</title>
+		<literallayout remap="RS">
+			<synopsis>
+				$ &thinsp;<emphasis remap="I">bot_dump &thinsp; -o some_bot_dump.dxf &thinsp; -t dxf &thinsp; sample.g &thinsp; some_bot</emphasis>
+			</synopsis>
+		</literallayout>
+		<!-- remap='RE' -->
+	</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>BRL-CAD Team</para>
+	</refsect1>
+	<refsect1 id="copyright">
+		<title>COPYRIGHT</title>
+		<para>This software is Copyright (c) 2008-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: g-acad.xml
===================================================================
--- g-acad.xml	(revision 0)
+++ g-acad.xml	(revision 0)
@@ -0,0 +1,99 @@
+<?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='gacad1'>
+<refmeta>
+<refentrytitle>G-ACAD</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-acad</refname>
+<refpurpose>Convert from BRL-CAD format to Lockheed Martin's ACAD format</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-acad</command>    <arg choice='opt'>-vi </arg>
+    <arg choice='opt'>-xX <replaceable>lvl</replaceable></arg>
+    <arg choice='opt'>-e <replaceable>error_file</replaceable></arg>
+    <arg choice='opt'>-D <replaceable>calculation_tolerance</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tol</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>ACAD_file</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>g-acad</emphasis>
+converts the specified
+<emphasis remap='I'>object(s)</emphasis>
+from a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file to the in-house Lockheed Martin's Advanced Computer-Aided Design
+<emphasis remap='I'>(ACAD)</emphasis>
+file format (formerly the General Dynamics ACAD file format).  This converter has NOT connected with Autodesk Inc.'s AutoCAD file format.
+The
+<option>-x</option>
+option specifies an RT debug flag and the
+<option>-X</option>
+option specifies an NMG debug flag. The
+<option>-a</option>
+,
+<option>-r</option>
+, and
+<option>-n</option>
+options specify tesselation tolerances.
+The
+<option>-D</option>
+option specifies a calculational distance tolerance (mm). Any two vertices
+that are less than this distance apart will be treated as the same vertex.
+The
+<option>-v</option>
+option requests verbose output.
+The
+<option>-i</option>
+option requests the output file units to be inches (the default is mm).
+The
+<option>-o</option>
+option specifies the name of the file to receive the output
+(stdout is the default).
+The
+<option>-e</option>
+option specifies a file for receiving the error messages.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-acad &thinsp;-o sample.ACAD &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 1997-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 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: CMakeLists.txt
===================================================================
--- CMakeLists.txt	(revision 53825)
+++ CMakeLists.txt	(working copy)
@@ -1,18 +1,39 @@
 set(docbook_man1_EN
   asc2dsp.xml
+  bot_dump.xml
+  bot_shell-vtk.xml
   bwscale.xml
   coil.xml
+  conv-vg2g.xml
+  cy-g.xml
   db.xml
+  dbclean.xml
+  dbupgrade.xml
+  enf-g.xml
+  fast4-g.xml
+  g-acad.xml
+  g-egg.xml
+  g-nff.xml
+  g-obj.xml
+  g-shell-rect.xml
+  g-var.xml
+  g-vrml.xml
+  g-x3d.xml
   gqa.xml
   mged.xml
+  nastran-g.xml
   nirt.xml
   obj-g.xml
+  ply-g.xml
+  poly-bot.xml
+  proe-g.xml
   rt.xml
   rtarea.xml
   rtcheck.xml
   rtedge.xml
   rtwizard.xml
   tire.xml
+  viewpoint-g.xml
   )
 
 DOCBOOK_TO_HTML(man1 docbook_man1_EN html/man1/en "")
Index: g-egg.xml
===================================================================
--- g-egg.xml	(revision 0)
+++ g-egg.xml	(revision 0)
@@ -0,0 +1,98 @@
+<?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='gegg1'>
+<refmeta>
+<refentrytitle>G-EGG</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-egg</refname>
+<refpurpose>Panda3D Translator (BRL-CAD to EGG)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-egg</command><arg choice='opt'>-8 </arg>
+    <arg choice='opt'>-xX <replaceable>lvl</replaceable></arg>
+    <arg choice='opt'>-D <replaceable>calculation_tolerance</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tol</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>EGG_file</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>g-egg</emphasis>
+converts the specified
+<emphasis remap='I'>object(s)</emphasis>
+from a BRL-CAD
+<emphasis remap='I'>database.g</emphasis>
+file to the
+<emphasis remap='I'>panda3d</emphasis>
+file format.
+The
+<option>-x</option>
+option specifies an RT debug flag and the
+<option>-X</option>
+option specifies an NMG debug flag. The
+<option>-a</option>
+,
+<option>-r</option>
+, and
+<option>-n</option>
+options specify tesselation tolerances.
+The
+<option>-D</option>
+option specifies a calculational distance tolerance (mm). Any two vertices
+that are less than this distance apart will be treated as the same vertex.
+The
+<option>-v</option>
+option requests verbose output.
+The
+<option>-i</option>
+option requests the output file units to be inches (the default is mm).
+The
+The
+<option>-o</option>
+option specifies the name of the file to receive the output
+(stdout is the default).
+<option>-8</option>
+option tells the facetizer to use the marching cubes algorithm.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-egg &thinsp;-o sample.egg &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2009-2012 by the United States
+Government as represented by U.S. Army Research Laboratory.</para>
+</refsect1>
+
+<refsect1 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: g-shell-rect.xml
===================================================================
--- g-shell-rect.xml	(revision 0)
+++ g-shell-rect.xml	(revision 0)
@@ -0,0 +1,128 @@
+<?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='gshellrect1'>
+<refmeta>
+<refentrytitle>G-SHELL-RECT</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-shell-rect</refname>
+<refpurpose>Produce triangulated shell from BRL-CAD model</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-shell-rect</command>    
+    <arg choice='opt'>-d <replaceable>debug_level</replaceable></arg>
+    <arg choice='opt'>-n </arg>
+    <arg choice='opt'>-g <replaceable>cell_size</replaceable></arg>
+    <arg choice='opt'>-i <replaceable>initial_ray_dir</replaceable></arg>
+    <arg choice='opt'>-d <replaceable>debug_level</replaceable></arg>
+    <arg choice='plain'>-o <replaceable>brlcad_output_file</replaceable></arg>
+    <arg choice='plain'><replaceable>database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>g-shell-rect</emphasis>
+converts the specified
+<emphasis remap='I'>objects(s)</emphasis>
+from a BRL-CAD model
+<emphasis remap='I'>database.g</emphasis>
+to a single NMG solid using raytracing. Rays are fired in a uniform grid.
+The direction for the first set of rays is chosen by calculating
+the presented area of the bounding box of the
+<emphasis remap='I'>object(s)</emphasis>
+and selecting the direction with the largest area. The user may override this
+by specifying a desired initial ray direction using the
+<option>-i</option>
+option (see below).
+The initial shell is constructed using only the first and last
+intersections with the
+<emphasis remap='I'>object(s).</emphasis>
+This will typically result in some rather large faces with normals at right angles
+to the ray direction. Unless the
+<option>-n</option>
+option is specified, these faces are then subdivided (according to the
+<emphasis remap='I'>cell_size</emphasis>
+) and additional rays fired from the other two directions are used to refine their
+shape.
+The resulting NMG solid
+will be named
+<emphasis remap='I'>shell</emphasis>
+and will be written to the specified
+<emphasis remap='I'>brlcad_output_file.</emphasis></para>
+
+
+<para>The following command line options are recognized:</para>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-g </option><emphasis remap='I'>cell_size</emphasis></term>
+  <listitem>
+<para>Specify the dimensions (in millimeters) of the grid spacing.  The default is 50mm.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-i </option><emphasis remap='I'>initial_ray_dir</emphasis></term>
+  <listitem>
+<para>Specify the initial ray direction.  Valid values are X, Y, or Z.
+The best results are usually obtained by raytracing in the direction that produces the
+most hits first.</para>
+
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-d </option><emphasis remap='I'>debug_level</emphasis></term>
+  <listitem>
+<para>Set the debugging level.  Higher values produce more debugging information.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-n</option></term>
+  <listitem>
+<para>Suppresses the refinement stage (firing rays from the secondary and tertiary axis directions).</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o </option><emphasis remap='I'>output.g</emphasis></term>
+  <listitem>
+<para>Specifies the name of the BRL-CAD geometry file to create.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-shell-rect &thinsp;-o shell.g &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</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: ply-g.xml
===================================================================
--- ply-g.xml	(revision 0)
+++ ply-g.xml	(revision 0)
@@ -0,0 +1,79 @@
+<?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='plyg1'>
+<refmeta>
+<refentrytitle>PLY-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>ply-g</refname>
+<refpurpose>Stanford PLY format Translator (PLY to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>ply-g</command>    
+    <arg choice='opt'>-s <replaceable>scale_factor</replaceable></arg>
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-d </arg>
+    <arg choice='plain'><replaceable>file.ply</replaceable></arg>
+    <arg choice='plain'><replaceable>file.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>ply-g</command>
+converts the specified
+<emphasis remap='I'>file.ply</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>file.g</emphasis>
+file. The
+<option>-v</option>
+option (verbose) prints much information about what the process is doing.
+The
+<option>-d</option>
+option sets a debug flag which will cause a core dump on error.
+The
+<option>-s</option>
+option specifies a scale factor to be applied to the PLY data. By convention, PLY data is typically in meters,
+so the default scale factor is 1000. The scale factor supplied on the command line will replace the default
+scale factor. So, for example, specifying a scale factor of 500 will halve the size of the resulting BRL-CAD
+model as compared to converting it without specifying a scale factor.
+The
+<emphasis remap='I'>file.ply</emphasis>
+file is expected to be in the Stanford PLY format (ASCII or binary).</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>ply-g &thinsp;sample.ply &thinsp;sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2003-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: proe-g.xml
===================================================================
--- proe-g.xml	(revision 0)
+++ proe-g.xml	(revision 0)
@@ -0,0 +1,124 @@
+<?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='proeg1'>
+<refmeta>
+<refentrytitle>PROE-G</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>proe-g</refname>
+<refpurpose>Pro/Engineer Translator (Pro/Engineer to BRL-CAD)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>proe-g</command>    
+    <arg choice='opt'>-darS </arg>
+    <arg choice='opt'>-i <replaceable>initial_ident</replaceable></arg>
+    <arg choice='opt'>-I <replaceable>constant_ident</replaceable></arg>
+    <arg choice='opt'>-m <replaceable>material_code</replaceable></arg>
+    <arg choice='opt'>-u <replaceable>reg_exp</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>RT_DEBUG_FLAG</replaceable></arg>
+    <arg choice='plain'><replaceable>file.brl</replaceable></arg>
+    <arg choice='plain'><replaceable>file.g</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis remap='I'>proe-g</emphasis>
+converts the specified
+<emphasis remap='I'>file.brl</emphasis>
+to a BRL-CAD
+<emphasis remap='I'>file.g</emphasis>
+file.
+The
+<option>-d</option>
+option prints debugging information.
+The
+<option>-a</option>
+option implies that all the parts in the Pro/E model should be converted to
+BRL-CAD
+<emphasis remap='I'>air</emphasis>
+regions.
+The
+<option>-i</option>
+option sets the starting ident number for the regions created. As each
+new region is created, this number will be incremented before assigning
+the next ident number (conflicts with
+<option>-I</option>
+). The
+<option>-I</option>
+option sets a constant ident number that will be assigned to all the regions created (conflicts with
+<option>-i</option>
+).
+The
+<option>-m</option>
+option sets a material code that will be assigned to all the regions created (default is 1).
+The
+<option>-r</option>
+flag indicates that the model should not be rotated, translated, or scaled, but left in
+the same orientation and size as it was created in
+<emphasis remap='I'>Pro/E.</emphasis>
+This allows the user to convert parts that are referenced by previously converted
+assemblies, so that the transformation matrix in the referencing assembly will
+size and position the part.
+The
+<option>-x</option>
+option sets an RT debug flags (see raytrace.h).
+The
+<emphasis remap='I'>file.brl</emphasis>
+file is expected to be output from the
+<emphasis remap='I'>BRL-CAD</emphasis>
+menu option of the Pro/Engineer
+<emphasis remap='I'>EXPORT</emphasis>
+menu. This menu option is a Pro/Develop application produced by the USARL.</para>
+
+<para>Note that the routine documented here is obsolete, and only maintained for compatibility with
+older versions of Pro/Engineer. The current method of converting from Pro/Engineer to BRL-CAD
+is still a two step process, but a newer Pro/Toolkit application must be installed (see &ldquo;install.doc&rdquo;
+in the &ldquo;pro-engineer&rdquo; directory of the BRL-CAD distribution). From within Pro/Engineer, the &ldquo;proe-brl&rdquo;
+option must be selected from the &ldquo;File&rdquo; menu, and the user will be prompted for an output file name,
+a starting ident number, a maximum tessellation error, and an additional curvature correction.
+The output from this new routine, is a Tcl script that may be converted to a BRL-CAD model using &ldquo;asc2g&rdquo;
+or by sourcing the file during an MGED session.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>proe-g &thinsp;sample.brl &thinsp;sample.g</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><emphasis remap='I'>Pro/Engineer Modeling User's Guide,</emphasis>
+Version 13.0,
+Parametric Technology Corporation</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>BRL-CAD Team</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: g-vrml.xml
===================================================================
--- g-vrml.xml	(revision 0)
+++ g-vrml.xml	(revision 0)
@@ -0,0 +1,115 @@
+<?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='gvrml1'>
+<refmeta>
+<refentrytitle>G-VRML</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-vrml</refname>
+<refpurpose>Perform Boolean evaluations to produce a VRML version 2.0 file</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-vrml</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-d <replaceable>calc_dist_tol</replaceable></arg>
+    <arg choice='opt'>-a <replaceable>abs_tess_tol</replaceable></arg>
+    <arg choice='opt'>-n <replaceable>norm_tess_tol</replaceable></arg>
+    <arg choice='opt'>-r <replaceable>rel_tess_tol</replaceable></arg>
+    <arg choice='opt'>-x <replaceable>librt_debug_flag</replaceable></arg>
+    <arg choice='opt'>-X <replaceable>NMG_debug_flag</replaceable></arg>
+    <arg choice='opt'>-u <replaceable>units_name</replaceable></arg>
+    <arg choice='opt'>-o <replaceable>outfile</replaceable></arg>
+    <arg choice='plain'><replaceable>infile.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object(s)</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>g-vrml</command>
+performs the Boolean operations specified in any regions in the specified
+<emphasis remap='I'>object(s)</emphasis>
+and writes the resulting NMG objects to
+<emphasis remap='I'>outfile</emphasis>
+or to
+<emphasis remap='I'>stdout</emphasis>
+if the
+<option>-o</option>
+option is not used. The output is in VRML version 2.0 format. The
+<option>-v</option>
+option requests verbose output while the conversion is taking place. The
+<option>-d</option>
+option specifies a calculational distance tolerance (in millimeters). This
+tolerance is used to distinguish neighboring vertices. Any two vertices less than
+this tolerance distance apart will be considered the same vertex. The default value
+is 0.005mm.
+Prior to performing the Boolean operations for each region, the involved primitive solids
+are converted to a planar facetted approximation and stored as NMG solids. This tessellation
+can be controlled using the tessellation tolerances. The
+<option>-a</option>
+option may be used to specify an absolute tessellation tolerance (in millimeters). This
+requires that the maximum absolute error from the tessellated surface to the actual
+surface must not be greater than
+<emphasis remap='I'>abs_tess_tol.</emphasis>
+The
+<option>-n</option>
+option specifies a surface normal error tolerance (in degrees) for the tessellation.
+The
+<option>-r</option>
+option may be used to set a relative error tolerance. This effectively
+sets an absolute tolerance for each primitive solid by multiplying the
+overall size of the solid by
+<emphasis remap='I'>rel_tess_tol.</emphasis>
+The
+<option>-x</option>
+and
+<option>-X</option>
+options are used to set debug flags for
+<emphasis remap='I'>librt</emphasis>
+and the
+<emphasis remap='I'>NMG</emphasis>
+routines respectively. The definitions of these flags may be found in
+<emphasis remap='I'>raytrace.h</emphasis>
+and
+<emphasis remap='I'>nmg.h.</emphasis>
+The
+<option>-u</option>
+option can be used to set the units for the resulting VRML file (the default is mm).
+Any units name that MGED accepts will work here.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-vrml &thinsp;-o shell.wrl &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</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: g-var.xml
===================================================================
--- g-var.xml	(revision 0)
+++ g-var.xml	(revision 0)
@@ -0,0 +1,111 @@
+<?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='gvar1'>
+<refmeta>
+<refentrytitle>G-VAR</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>g-var</refname>
+<refpurpose>Produce (OpenGL) Vertex Arrays from BOT BRL-CAD geometry</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>g-var</command>    
+    <arg choice='opt'>-v </arg>
+    <arg choice='opt'>-y </arg>
+    <arg choice='opt'>-s <replaceable>scale</replaceable></arg>
+    <arg choice='opt'>-f </arg>
+    <arg choice='opt'>-o <replaceable>outfile</replaceable></arg>
+    <arg choice='plain'><replaceable>infile.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>g-var</command>
+writes the bag of triangle (BOT) primitives of the specified
+<emphasis remap='I'>object</emphasis>
+in a binary array format to
+<emphasis remap='I'>outfile</emphasis>
+or to
+<emphasis remap='I'>stdout.</emphasis></para>
+</refsect1>
+
+<refsect1 id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-v</option></term>
+  <listitem>
+<para>Request verbose output.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-y</option></term>
+  <listitem>
+<para>Transform the coordinate system from xyz to xzy.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-s scale</option></term>
+  <listitem>
+<para>Scale the output geometry by factor
+<emphasis remap='B'>scale</emphasis>
+. By default the scale factor is 0.001 (standard transformation
+from meters to millimeters.)</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-f</option></term>
+  <listitem>
+<para>Flip face normals. This changes both the vertex order and the output normals.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o outfile</option></term>
+  <listitem>
+<para>The output will be written to
+<emphasis remap='B'>outfile</emphasis>
+. By default the output is written to stdout.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='file_format'><title>FILE FORMAT</title>
+<para><emphasis remap='I'>TODO</emphasis></para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>g-var &thinsp;-o sample.mesh &thinsp;sample.g &thinsp;sample_object</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>Prasad Silva</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2006-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: bot_shell-vtk.xml
===================================================================
--- bot_shell-vtk.xml	(revision 0)
+++ bot_shell-vtk.xml	(revision 0)
@@ -0,0 +1,95 @@
+<?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='bot_shellvtk1'>
+<refmeta>
+<refentrytitle>BOT_SHELL-VTK</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>BRL-CAD</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>bot_shell-vtk</refname>
+<refpurpose>VTK polydata converter (BRL-CAD to VTK)</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>bot_shell-vtk</command>    <arg choice='opt'>-m </arg>
+    <arg choice='opt'>-n </arg>
+    <arg choice='opt'>-d <replaceable>debug_level</replaceable></arg>
+    <arg choice='opt'>-g <replaceable>cell_size</replaceable></arg>
+    <arg choice='plain'>-o <replaceable>vtk_polydata_output</replaceable></arg>
+    <arg choice='plain'><replaceable>brlcad_database.g</replaceable></arg>
+    <arg choice='plain'><replaceable>object1</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><replaceable>object2</replaceable></arg><arg choice='plain' rep='repeat'><replaceable>object3</replaceable></arg></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><command>bot_shell-vtk</command>
+uses raytracing to extract the exterior triangles from a model made up
+of BOT primitives. The default operation is to fire a single ray at each
+triangle of each BOT primitive in the specified objects. The rays are fired
+anti-normalward towards the center of each triangle from outside the model
+bounding box. If the triangle currently under consideration appears as the
+first object hit along the ray, then that triangle is included in the
+VTK polydata output (thus retaining only exterior triangles). Non-BOT
+primitives encountered along the rays may hide BOT triangles, but non-BOT
+primitives do not contribute to the output.
+The
+<option>-m</option>
+option may be specified to enable both the first and last triangles along
+each ray to be added to the output. This can improve performance, by reducing
+the number of rays fired, but may reduce performance for complex models
+because it requires processing each ray completely through the model.
+If the
+<option>-n</option>
+option is specified, the output will include vertex normals in the
+VTK output. If the BOT primitives of the input BRL-CAD model do not
+have vertex normal information, this option will not add any information
+to the output, but will greatly increase the size of the output file.
+If the
+<option>-g</option>
+option is specified, then the rays are fired from a uniform grid for
+three orthogonal directions rather than at each individual triangle. This
+can give a fairly rapid result for larger cell sizes, but is likely to miss
+some triangles. The
+<emphasis remap='I'>cell_size</emphasis>
+must be specified in millimeters.
+The
+<option>-d</option>
+option may be used to get debug output during processing. This is likely to
+only be useful for developers.</para>
+</refsect1>
+
+<refsect1 id='example'><title>EXAMPLE</title>
+<literallayout remap='RS'>
+<synopsis>
+$ &thinsp;<emphasis remap='I'>bot_shell-vtk &thinsp; -o output.vtk &thinsp; sample.g &thinsp; the_exterior</emphasis>
+</synopsis>
+</literallayout> <!-- remap='RE' -->
+</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>BRL-CAD Team</para>
+
+</refsect1>
+
+<refsect1 id='copyright'><title>COPYRIGHT</title>
+<para>This software is Copyright (c) 2003-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>
+
