saved work added here as a patch in trunk - this branch is no longer needed (svn branch delete)

svn:revision:63044
svn:branch:surfacetree
svn:account:starseeker

.gitignore

@@ -0,0 +1,2 @@
+/bin
+/lib

AUTHORS

@@ -37,7 +37,7 @@ contributor credits are organized into the following general
 categories depending on the level and type of involvement:
 
   * Mathematical, Algorithmic, and Geometric Support
-  * Documentation, Artwork, and Website Contributors
+  * Documentation and Website Contributors
   * Code Contributors
   * Special Thanks
 
@@ -218,23 +218,6 @@ nicknames r_weiss
 2008 December
 U.S. Army Research Laboratory
 
-Browder, Thomas M. Jr.  **
-nicknames tbrowder2
-2008 June
-ManTech International Corporation
-Open Source
-
-Reed, Nicholas  **
-nicknames n_reed
-2008 July
-ARL Student Hire / University of Maryland, Baltimore County
-Quantum Research International, Inc.
-
-Moore, Jr., Carl G.  **
-nicknames cmoore, carlmoore
-2011 October
-U.S. Army Research Laboratory
-
 
 MATHEMATICAL, ALGORITHMIC, AND GEOMETRIC SUPPORT
 ------------------------------------------------
@@ -246,7 +229,7 @@ U.S. Army Ballistic Research Laboratory
 Davisson, Edwin O. **
 U.S. Army Research Laboratory
 
-Rogers, David
+Rodgers, David
 U.S. Naval Academy
 
 Stiller, Peter
@@ -268,8 +251,8 @@ Weaver, Stephanie 'Rain'  **
 ARL Student Hire / Bridgewater College
 
 
-DOCUMENTATION, ARTWORK, AND WEBSITE CONTRIBUTORS
-------------------------------------------------
+DOCUMENTATION AND WEBSITE CONTRIBUTORS
+--------------------------------------
 
 Weaver, Earl P.
 1980
@@ -334,25 +317,6 @@ Perez, Alex
 2012 November
 Open Source (GCI)
 
-Tannous, Marc
-2014 December
-Open Source (GCI)
-
-Chiplunkar, Shardul
-nicknames microchip, shardulc
-2014 December
-Open Source (GCI)
-
-Juvekar, Mandar
-nicknames mandarj
-2014 December
-Open Source (GCI)
-
-Sofat, Hitesh
-nicknames sofat
-2015 June
-Open Source (GSoC)
-
 
 CODE CONTRIBUTIONS
 ------------------
@@ -481,9 +445,7 @@ nicknames mjgillich mgillich
 U.S. Army Research Laboratory
 
 Howard, Doug
-nicknames dhoward
 SURVICE Engineering, Inc.
-2006 April
 
 Silva, Prasad Prometheus
 nicknames prasad_silva
@@ -536,8 +498,19 @@ nicknames homovulgaris, madant
 2008 June
 Open Source (GSoC)
 
+Browder, Thomas M. Jr.
+nicknames tbrowder2
+2008 June
+ManTech International Corporation
+Open Source
+
+Reed, Nicholas
+nicknames n_reed
+2008 July
+ARL Student Hire / University of Maryland, Baltimore County
+
 Saunders, Benjamin
-nicknames Ralith, ralith
+nicknames Ralith
 2008 July
 Open Source
 
@@ -577,10 +550,6 @@ Jain, Sachin
 2011 April
 Open Source
 
-Gerstner, Nick
-2011 May
-SURVICE Engineering, Inc.
-
 Easterbrook, Zach
 nicknames lainiwakurax
 2011 July
@@ -591,6 +560,11 @@ nicknames abhi2011
 2011 July
 Open Source (SOCIS)
 
+Moore, Jr., Carl G.
+nicknames cmoore, carlmoore
+2011 October
+U.S. Army Research Laboratory
+
 Silvko, Ksenija
 nicknames ksuzee
 2012 March
@@ -677,7 +651,6 @@ Calle, Adrián Arroyo
 Open Source (GCI)
 
 Keesing, Aaron
-nicknames agkphysics
 2012 December
 Open Source (GCI)
 
@@ -690,11 +663,6 @@ nicknames ncsaba
 2013 April
 Open Source
 
-Check, Nyah
-nicknames Ch3ck
-2013 July
-Open Source (GSoC)
-
 Shah, Kesha
 nicknames keshashah
 2013 April
@@ -711,114 +679,19 @@ nicknames avneetkhalsa
 Open Source (GSoC)
 
 Daga, Mohit
-nicknames zero_level, mohitdaga
+nicknames zero_level
 2013 June
 Open Source (GSoC)
 
-Kamga, Isaac
-nicknames Izak, iiizzzaaakkk
-2013 July
-Open Source (GSoC)
-
-Singh, Harmanpreet
-nicknames harmanpreet
-2013 May
-Open Source (GSoC)
-
 Huff, Emory
 nicknames hknoll
 2013 July
-ARL Student Hire
+U.S. Army Research Laboratory (SEAP)
 
 Engbert, Jonathan
 nicknames ejno
 2013 July
 Open Source
-ARL Student Hire / University of Maryland, Baltimore County
-
-Andrew
-2013 November
-Open Source (GCI)
-
-Schulte, Johannes
-2013 November
-Open Source (GCI)
-
-Amidon, Peter
-nicknames peter-sa, Andromeda Galaxy
-2013 November
-Open Source (GCI)
-
-Chiplunkar, Shardul
-nicknames microchip
-2013 November
-Open Source (GCI)
-
-Берегов, Станислав
-2013 December
-Open Source (GCI)
-
-nicknames huskmate13
-2014 January
-Open Source
-
-Gustave Granroth
-2014 May
-Open Source
-
-Jain, Rishub
-2014 July
-ARL Student Hire
-
-Roberts, Mitchell
-2014 July
-ARL Student Hire
-
-Bayes, Matthew
-nicknames klinger4077
-2014 July
-ARL Student Hire / University of Maryland College Park
-
-Mirea, Ștefan-Gabriel
-2014 October
-Open Source
-
-Krishna
-2015 January
-Open Source (GCI)
-
-Konrad, Djimeli
-2015 February
-Open Source
-
-Alexandre da Silva Costa, Vasco
-nicknames vasco_costa
-2015 April
-Open Source (GSoC)
-
-Thakkar, Kalpit
-nicknames dracarys983
-2015 May
-Open Source (GSoC)
-
-Ilinca, Andrei
-nicknames andrei_il
-2015 June
-Open Source (GSoC)
-
-Sofat, Hitesh
-nicknames sofat
-2015 June
-Open Source (GSoC)
-
-Hollister, Brad
-nicknames bhollister
-2015 July
-Open Source (GSoC)
-
-Hanji, Param
-2016 March
-Open Source (GSoC)
 
 
 SPECIAL THANKS
@@ -951,7 +824,7 @@ Thomas, Balbir
 Open Source
 
 Remenak, Daniel T.
-nicknames DTRemenak, Erroneous, dtremenak
+nicknames DTRemenak, Erroneous
 2005 July
 California Institute of Technology
 Open Source
@@ -1093,39 +966,6 @@ nicknames talwindersaini
 2013 July
 Open Source
 
-YuGin, Tan
-2013 November
-Open Source (GCI)
-
-nicknames mandar
-2013 December
-Open Source (GCI)
-
-Lotsu, Alexander
-nicknames Alex
-2013 December
-Open Source (GCI)
-
-Hyams, Daniel
-nicknames dhyams
-2014 February
-Open Source
-
-Reddy, Raj
-nicknames raj12lnm
-2014 May
-Open Source
-
-Malhotra, Shivoam
-nicknames shiv05
-2015 March
-Open Source
-
-Chepkwony, Benson
-nicknames bchepkwny
-2015 December
-Open Source
-
 
 CORPORATE AND ORGANIZATION SUPPORT
 ----------------------------------

BUGS

@@ -15,47 +15,6 @@ on-going issues.
 Recent Bugs
 -----------
 
-* rtedge's overlay mode appears to be generating different results on
-  Windows and Linux for the m35 steering wheel (rtwizard rendering
-  mode D.)
-
-* pixdiff on Windows is reporting no differences with a pair of files
-  that pixcmp can see differences in.
-
-* fblabel seems quite busted, at least talking to a /dev/X fbserv, in
-  that it only draws the first character and eventually displays
-  rem_read() failures when run in -d debug mode.
-
-* rtedge doesn't refresh a /dev/X fbserv (presumably double-buffered)
-  after doing an overlay render.  it does draw, though, as confirmed
-  by a forced fb-fb refresh.
-
-* pixborder doesn't account for an edge case where the right edge of
-  an image is expected to be colored (except for one pixel on the top
-  edge).  Example:
-
-  pixborder -b "255 0 0" -t "255 255 255" < pix/moss.pix | pix-fb
-
-* report that attempting to change units on a read-only file in MGED
-  will not change the units in the file but changes them in MGED,
-  resulting in problems with nirt missing geometry it shouldn't miss.
-
-* typing 'comb -f -r assembly_name' shuts down mged with the error:
-  ERROR: bad pointer 0000000000B4CA50: s/b bu_external(x768dbbd0), was bu_vls(x89333bbb), file ..\..\..\brlcad_src\src\libbu\parse.c, line 2443"
-  And on the mged command line:
-  rt_db_cvt_to_external5 expecting non-NULL name parameter
-  wdb_export((null)): solid export failure
-
-* report of mged command history not working with the down arrow key
-  in 7.25.0 (on Windows, unknown on other platforms).  Up arrow works
-  fine.
-
-* wgl framebuffer is not lingering on windows (regardless of using
-  wgll or default) when it should
-
-* nirt -e "xyz val val val" doesn't work due to the space after the -e
-  and how the nirt/rt commands parse quoted args.
-
 * calling "attr set obj key value" should always result in key getting
   set to value, no matter what, as it is the lowest-level attribute
   management interface and what the command (correctly) documents.
@@ -113,6 +72,11 @@ Recent Bugs
 * idents command is reporting a bogus region count in the region
   output table listing (first column).
 
+* yacc 1.9 will not output a header if a path is given to the -o
+  option.  yacc should be run from the binary directory instead of the
+  source directory so that the command may be simply yacc -d -o
+  points_parse.c ${CMAKE_SOURCE_DIRECTORY}/points_parse.y
+
 * src/librt/primitives/bot/g_bot_include.c:rt_bot_bbox() routine isn't
   calculating the bbox correctly
 
@@ -146,8 +110,8 @@ Recent Bugs
 * bu_log() with a width specifier does not align like printf().
   Example: bu_log("%24s", str);
 
-* report that "keep" sometimes results in a .g file with unknown units;
-  dbconcat also is reported to set the units to unknown if concatting
+* report that keep sometimes results in a .g file with unknown units
+  dbconcat also is reported to set the units to unknown if concating
   a file with unknown units.
 
 * infinite loop in rt_find_backing_dist() raytracing a BoT (without
@@ -305,6 +269,9 @@ Recent Bugs
   bogus lists visible with nirt in mged, entirely missing the bot, or
   mismatched entry/exit/overlap segments.
 
+* nirt -e "xyz val val val" doesn't work due to the space after the -e
+  and how the nirt/rt commands parse quoted args.
+
 * tab completion in classic/command mode sometimes doesn't work
   (presumably if mged can't find tcl resources).  was finally able to
   reproduce this with the result given as:
@@ -547,12 +514,6 @@ Recent Bugs
   line (infinite loop).  also gives infinite areas when presented with
   an empty .density file.
 
-* rtarea gives incorrect areas when using -H hypersample flag
-
-* rtweight/gqa volumes seem wrong with simple sphere test case, with
-  values consistently and quickly converging less than the actual
-  volume regardless of the grid size.
-
 * setting src/librt/db5_io.c's AVS_ADD off in db5_import_attributes
   causes bad things to happen and it really shouldn't.
 

CHANGES

@@ -8,7 +8,7 @@ include developer application programming interface (API) calls as
 well as user application command-line interface (CLI) and graphical
 user interface (GUI) behaviors.  Changes are characterized as:
 
-    1) those affecting a new interface,
+    1) changing a new interface,
     2) being minimally impacting, or
     3) requiring adherence to deprecation policy.
 
@@ -23,11 +23,10 @@ NEW INTERFACE
 -------------
 
 Changes to interfaces that have been recently introduced are often
-subject to further change and should not yet be relied upon by
-application developers or users until they stabilize.  They are
-allowed to change from release to release and are not subject to
-change policy restrictions until they have been included in at least
-TWO releases without any change.
+subject to change and should not yet be relied upon by application
+developers or users.  They may be changed as needed from release to
+release and are not subject to change policy restrictions until they
+have been included in at least TWO releases without change.
 
 
 MINIMALLY IMPACTING
@@ -36,21 +35,20 @@ MINIMALLY IMPACTING
 If a change to an interface has a suitable and completely equivalent
 alternative, the change is deemed to be "minimally impacting" and can
 be made during any release.  Examples of such changes include renaming
-an interface, reordering parameters, adding optional parameters,
-adding additional parameters for previously implicit behavior, and
-removing unused parameters.
+an interface, reordering parameters, adding additional parameters for
+previously implicit behavior, and removing unused parameters.
 
-Generally, the impact can usually be considered minimally impacting if
+Basically, the impact can usually be considered minimally impacting if
 a static regular expression search-and-replace is all that is needed
-to update calling code, and no manual intervention is required.
+to update calling code, and no change is imposed on the user.
 
 
 DEPRECATION POLICY
 ------------------
 
-If a change will intentionally alter, replace, or remove functionality
-that has been documented and published in at least TWO releases, it
-must first be announced as DEPRECATED.  Otherwise, changes to
+If a change will intentionally change, replace, or remove
+functionality that has been documented and published in at least TWO
+releases should be first marked as DEPRECATED.  Otherwise, changes to
 interfaces that have not been publicly announced or are not publicly
 documented for at least two releases may be changed without notice.
 
@@ -77,7 +75,7 @@ and with @DEPRECATED in source code comments.  Where users are not
 adversely affected, a run-time DEPRECATION statement may be printed.
 
 Whenever published functionality is finally removed, move its entry
-from the DEPRECATED section below to the REMOVED section for the
+from the DEPRECATED section below to the OBSOLETE section for the
 version in which it was removed.  Make sure the entry retains a
 reference to the version in which the item was marked as deprecated.
 
@@ -112,131 +110,19 @@ calls that can be updated must be updated at that time.
 The items listed below are interfaces that are deprecated.  They are
 categorized by the release in which the change was made.  If the
 change involved a removal of a command or function, both the original
-and new names should be listed for reference.  If an item is marked
-with a "'" (single quote), that means it was not documented and may be
-removed at any time.
+and new names should be listed for reference.
 
 
-7.26
-----
-ray tracing tools
-	lgt : functionally replaced by nirt
-	rtcell', rtfrac', rtpp, rtrad', rtrange, rtray, rtregis, rtsil'
-	Removed as part of distillation effort [deprecated 7.26]
-converter tools
-	cy-g, euclid-g, euclid_format', euclid_unformat', g-euclid,
-	g-euclid1', g-tankill, intaval-g.py, viewpoint-g : obsolete formats
-	plot3-X, plot3-hpgl, plot3-tek : obsolete interface, see overlay command
-	plot3debug, xyz-plot3 : see plot3-asc,asc-plot3
-	bot-bldxf', bot_shell-vtk, g-nmg, nmg-bot, nmg-rib, nmg-sgp',
-	poly-bot, rt_bot_faces, : primitive-specific converters
-	Removed as part of distillation effort [deprecated 7.26]
-image tools
-	cmap-fb, fb-cmap, fbcmrot : colormap support obsolete
-	fbed, cell-fb : outside scope
-	fbscanplot, polar-fb, pp-fb, bw-imp, pixinfo.sh : obsolete
-	png_info : incorporating into icv
-	pixpaste : outside scope, license
-	alias-pix' : incorporating into icv
-	asc2pix' : incorporating into icv
-	pix-yuv', yuv-pix' : obsolete non-standard format
-	texturescale : obsolete implementation
-	Removed as part of distillation effort [deprecated 7.26]
-video & animation tools
-	anim_*', fbanim, chan_add', chan_mult, chan_permute,
-	pixflip-fb' : outside scope
-	pixfields', pixfieldsep' : outside scope
-	orbit.sh, rtwalk, scriptsort, script-tab', tabinterp, tabsup,
-	azel, bary
-	Removed as part of distillation effort [deprecated 7.26]
-signal analysis tools
-	a-d', d-a', bw-a', i-a', u-a' : incorporating into cv
-	d-a', d-bw', d-f', d-i', d-u' : incorporating into cv
-	a-d', bw-d', c-d', f-d', i-d', u-d' : incorporating into cv
-	f-d', f-i', d-f', i-f', u-f', u-bw' : incorporating into cv
-	d2-c', double-asc' : incorporating into cv
-	Removed as part of distillation effort [deprecated 7.26]
-infrared & shapefactor tools
-	all_sf', if-X, ifdisp, pictx, showterm, firpass, secpass, shapefact
-	ssamp-bw, ssampview', ssampview.tcl'
-	Removed as part of distillation effort [deprecated 7.26]
-misc tools
-	fix_polysolids' : obsolete primitive
-	remapid : superseded by reid+remat
-	buffer : unnecesary network/stream buffering tool
-	hex : superseded by hexdump
-	Removed as part of distillation effort [deprecated 7.26]
-include/bu/ptbl.h
-        BU_PTBL_BASEADDR, BU_PTBL_LASTADDR, BU_PTBL_END
-        Removed as private implementation detail [deprecated 7.26
-include/bu/hash.h
-	bu_hash_tbl_find, bu_set_hash_value, bu_get_hash_value, bu_get_hash_key,
-	bu_hash_tbl_add, bu_hash_tbl_print, bu_hash_tbl_free, bu_hash_tbl_first,
-	bu_hash_tbl_next, bu_hash_tbl_traverse, public structs bu_hash_entry and
-	bu_hash_tbl will be made private.
-	Replaced with new API [deprecated 7.26]
-include/bu/cmd.h
-	remove struct bu_cmdhist and struct bu_cmdhist_obj [deprecated 7.26]
-	BU_CMDHIST_NULL, BU_CMDHIST_OBJ_NULL, bu_cmdhist_histor, bu_cmdhist_add,
-	bu_cmdhist_curr, bu_cmdhist_nest, bu_cmdhist_prev [deprecated 7.26]
-fb-rle, rle-fb, bw-rle, pix-rle, rle-pix
-	All tools focused specifically on the RLE image format. [deprecated 7.26]
-nirt
-	-T - use LIBRT_BOT_MINTIE environment variable instead [deprecated 7.26]
-all global variables
-	global variables are no longer considered published public API [deprecated 7.26]
-	bn_mat_identity -> MAT_INIT_IDN or MAT_IDN() or NULL
-include/bn.h
-	tp_setup, no longer needs to be public API [deprecated 7.26]
-include/raytrace.h
-	curve_to_tcl_list
-	db_full_path_appendresult tcl_obj_to_int_array
-	tcl_obj_to_fastf_array tcl_list_to_int_array
-	tcl_list_to_fastf_array *_tcl_*, removal of all tcl-specific
-	API functions [deprecated 7.26]
-	db_regexp_match_all() -> db_ls() [deprecated 7.26]
-include/rt/solid.h
-	shouldn't be public API - this level of detail belongs inside the display
-        manager [deprecated 7.26]
-include/ged/defines.h
-	remove struct ged_drawable -  shouldn't be public API [deprecated 7.26]
-	remove freesolid from struct ged - exposes struct solid [deprecated 7.26]
-include/ged/view.h
-	remove current forms of dl_erasePathFromDisplay and invent_solid - they
-	expose the struct solid type [deprecated 7.26]
-include/tclcad.h
-	tclcad_bn_mat_print tclcad_rt_parse_ray tclcad_rt_pr_cutter
-	tclcad_rt_pr_hit tclcad_rt_rt tclcad_rt_import_from_path, removal of all
-	tcl-specific API functions [deprecated 7.26]
-pixcut, pixpaste
-	copyright cleanup [deprecated 7.26]
-librt, fast4-g
-	removal of CLINE entity support [deprecated 7.26]
-mged
-	kill, killtree, killall, killrefs - replaced with rm command [deprecated 7.26]
-
-	rm comb obj1 obj2 comb1 ... -> new behavior: remove objects and empty combs from .g
-	original functionality replaced with rm comb/obj* comb/comb1 ... syntax [deprecated 7.26]
-
-	expand -> replaced by search -name <pattern> (previous docs indicating matching of
-	expand was regex were wrong - uses bu_fnmatch.) [deprecated 7.26]
-
-	pathlist, paths -> replaced by search [deprecated 7.26]
-burst
-	remove termlib-based interactive menu interface [deprecated 7.26]
-
 7.24
 ----
-fbed, pp-fb
-	removes termcap use, no known users [deprecated 7.24]
 include/raytrace librt
-	db_full_path_list_add(), db_free_full_path_list() [deprecated 7.24]
-	db_search_formplan(), db_search_freeplan(), db_search_full_paths() [deprecated 7.24]
-	db_search_unique_objects(), struct db_full_path_list [deprecated 7.24]
+        db_full_path_list_add(), db_free_full_path_list() [deprecated 7.24]
+        db_search_formplan(), db_search_freeplan(), db_search_full_paths() [deprecated 7.24]
+        db_search_unique_objects(), struct db_full_path_list [deprecated 7.24]
 src/irprep
-	all_sf, firpass, ir-X, irdisp, pictx, secpass, shapefact, showterm [deprecated 7.24]
+        all_sf, firpass, ir-X, irdisp, pictx, secpass, shapefact, showterm [deprecated 7.24]
 include/raytrace.h librt
-	RT_DBHASH and RT_DBNHASH [deprecated 7.24]
+        RT_DBHASH and RT_DBNHASH [deprecation 7.24]
 
 7.22
 ----
@@ -245,14 +131,17 @@ include/raytrace.h librt
 	RT_GET_TREE -> BU_GET [deprecation 7.22]
 	RT_FREE_TREE -> BU_PUT [deprecation 7.22]
 include/bu.h
-	bu_parse_mm() [deprecated 7.22]
+        bu_parse_mm() [deprecated 7.22]
 librtserver
-	becoming stand-alone project, removes optional java dependency [deprecated 7.22]
+        becoming stand-alone project, removes optional java dependency [deprecated 7.22]
 mged
 	em, e_muves, l_muves, lm, read_muves, and t_muves MUVES-specific commands [deprecated 7.22]
 
 7.20
 ----
+liborle
+	remove liborle and the tools using it, fb-orle, orle-fb, orle-pix and
+	pix-orle [deprecated 7.20]
 tclscripts/lib
 	Mged, Database, Db, Dm, Drawable, Display, QuadDisplay, View -> Ged [deprecated 7.20]
 librt
@@ -261,7 +150,8 @@ librt
 	hf primitive [deprecated 7.20]
 include/bu.h
 	bu_vls_init_if_uninit() -> bu_vls_init() [deprecated 7.20]
-GNU Autotools configure compatibility script
+autogen.sh && configure
+	GNU Autotools build system -> CMake build system [deprecated 7.20]
 	./configure -> cmake . [deprecated 7.20]
 include/raytrace.h
 	rt_load_attrs() -> rt_gettrees_and_attrs() or db5_import_attributs() [deprecated 7.20]
@@ -287,6 +177,8 @@ db.h
 	rt_fastf_float() -> ntohf() [deprecated 7.18]
 	rt_mat_dbmat() -> htonf() [deprecated 7.18]
 	rt_dbmat_mat() -> ntohf() [deprecated 7.18]
+dbcp
+	dbcp -> dd [deprecated 7.18]
 mged
 	?(*) -> ? -(*) [deprecated 7.18]
 	apropos(*) -> apropos -(*) [deprecated 7.18]
@@ -324,6 +216,12 @@ mged
 ----
 struct bu_structparse 'i' format
        'i' -> '%p' [deprecated 7.16]
+SGI-specific tools
+	pl-sgi -> pl-fb [ deprecated 7.16 ]
+Dunn camera and Canon printer tools
+	dunncolor [ deprecated 7.16 ]
+	dunnsnap [ deprecated 7.16 ]
+	canonize [ deprecated 7.16 ]
 reserved attributes and case-sensitivity
 	id -> region_id [deprecated 7.16]
 	GIFTmater -> material_id [deprecated 7.16]
@@ -332,101 +230,8 @@ reserved attributes and case-sensitivity
 	AIRCODE -> air [deprecated 7.16]
 	rgb -> color [deprecated 7.16]
 	oshader -> shader [deprecated 7.16]
-include/raytrace.h
-	rt_prep_timer() -> bu_timer() [deprecated 7.16]
-	rt_get_timer() -> bu_elapsed() [deprecated 7.16]
-
-7.14
-----
-mged
-	src/tclscripts/mged/bots.tcl [deprecated 7.14]
-
-7.12
-----
-include/raytrace.h
-	rt_functab size -> growing ft_label and new callbacks [deprecated 7.12]
-src/rt/viewarea.c
-	terminology and output format [deprecated 7.12]
-
-pre 7.0
--------
-include/raytrace.h
-	struct hit.hit_point -> RT_HIT_POINT [deprecated pre-7.0]
-	struct hit.hit_normal -> RT_HIT_NORMAL [deprecated pre-7.0]
-
-
-***********
-* REMOVED *
-***********
-
-Below are the interfaces that have followed deprecation policy or were
-deemed minimally impacting and, regardless, are now no longer a part
-of BRL-CAD.
-
-7.26.0
-------
-dbcp
-	dbcp -> dd [deprecated 7.18]
-pov (mged)
-	removed, undocumented command with many alternatives [minimally impacting]
-polybinout (mged)
-	removed, undocumented command, use plot [minimally impacting]
-pl (mged)
-	removed, use plot [minimally impacting]
-conf.h
-	removed - replaced with common.h [deprecated 7.0]
-UtahRLE image tools
-	no longer installed by default with BRL-CAD - not used directly by
-	BRL-CAD tools [minimally impacting]
-Tcl in libbu and libbn
-	no longer utilize or require Tcl [dependency eliminated]
-Tcl/Tk man pages
-	no longer installed by default with BRL-CAD when the bundled Tcl/Tk is used
-	to build [minimally impacting]
-include/dg.h
-	implementation detail no longer being exposed, use libged [deprecated 7.22]
-autogen.sh && configure
-	GNU Autotools build system -> CMake build system [deprecated 7.20]
-Dunn camera and Canon printer tools
-	dunncolor [deprecated 7.16]
-	dunnsnap [deprecated 7.16]
-	canonize [deprecated 7.16]
 genptr_t/GENPTR_NULL
 	genptr_t -> void* [deprecated 7.16]
-include/bu.h
-	bu_argv0() -> bu_basename(bu_argv0_full_path()); [deprecated 7.16]
-include/dm_color.h
-	dm_color.h -> dm.h [deprecated 7.14]
-include/fb.h
-	FB_WPIXEL -> fb_wpixel [deprecated 7.14]
-include/raytrace.h
-	rt_fdiff -> NEAR_ZERO [deprecated 7.14]
-	rt_reldiff -> NEAR_ZERO [deprecated 7.14]
-	DIR_* -> RT_DIR_* [deprecated 7.14]
-	RT_HIT_NORM -> RT_HIT_NORMAL [deprecated 7.12]
-include/vmath.h
-	VADD2_2D -> V2ADD2 [deprecated 7.14]
-	VSUB2_2D -> V2SUB2 [deprecated 7.14]
-	MAGSQ_2D -> MAG2SQ [deprecated 7.14]
-	VDOT_2D -> V2DOT [deprecated 7.14]
-	VMOVE_2D -> V2MOVE [deprecated 7.14]
-	VSCALE_2D -> V2SCALE [deprecated 7.14]
-	VJOIN1_2D -> V2JOIN1 [deprecated 7.14]
-liborle
-include/orle.h
-	remove liborle and the tools using it, fb-orle, orle-fb, orle-pix and
-	pix-orle [deprecated 7.20]
-mged
-	make_bb -> bb [deprecated 7.16]
-	tops -g -u -> now default behavior [deprecated 7.14]
-	-n option -> -c option [deprecated 7.14]
-	per_line [deprecated 7.14]
-SGI-specific tools
-	pl-sgi -> pl-fb [deprecated 7.16]
-src/gtools
-	g_[toolname] -> g[toolname] [deprecated 7.14]
-src/librt/cmd.c
-	rt_split_cmd() -> bu_argv_from_string() [deprecated 7.12]
 any-png.sh
 	use pix tools [deprecated 7.16]
 cadbug.sh
@@ -439,9 +244,64 @@ pixread.sh
 	obsolete hardware [deprecated 7.16]
 sgisnap.sh
 	obsolete hardware [deprecated 7.16]
-librtserver and Java Native Interface (JNI) bindings
-	removed, unused and undocumented, modern approach would be to
-	use a tool such as swig to generate bindings [minimally impacting]
+include/bu.h
+	bu_argv0() -> bu_basename(bu_argv0_full_path()); [deprecated 7.16]
+include/raytrace.h
+	rt_prep_timer() -> bu_timer() [deprecated 7.16]
+	rt_get_timer() -> bu_elapsed() [deprecated 7.16]
+mged
+	make_bb -> bb [deprecated 7.16]
+
+7.14
+----
+include/dm_color.h
+	dm_color.h -> dm.h [deprecated 7.14]
+include/fb.h
+	FB_WPIXEL -> fb_wpixel [deprecated 7.14]
+src/gtools
+	g_[toolname] -> g[toolname] [deprecated 7.14]
+include/raytrace.h
+	rt_fdiff -> NEAR_ZERO [deprecated 7.14]
+	rt_reldiff -> NEAR_ZERO [deprecated 7.14]
+	DIR_* -> RT_DIR_* [deprecated 7.14]
+mged
+	tops -g -u -> now default behavior [deprecated 7.14]
+	-n option -> -c option [deprecated 7.14]
+	bots, per_line [deprecated 7.14]
+include/vmath.h
+	VADD2_2D -> V2ADD2 [deprecated 7.14]
+	VSUB2_2D -> V2SUB2 [deprecated 7.14]
+	MAGSQ_2D -> MAG2SQ [deprecated 7.14]
+	VDOT_2D -> V2DOT [deprecated 7.14]
+	VMOVE_2D -> V2MOVE [deprecated 7.14]
+	VSCALE_2D -> V2SCALE [deprecated 7.14]
+	VJOIN1_2D -> V2JOIN1 [deprecated 7.14]
+
+7.12
+----
+include/raytrace.h
+	rt_functab size -> growing ft_label and new callbacks [deprecated 7.12]
+srt/librt/cmd.c
+	rt_split_cmd() -> bu_argv_from_string() [deprecated 7.12]
+src/rt/viewarea.c
+	terminology and output format [deprecated 7.12]
+include/raytrace.h
+	RT_HIT_NORM -> RT_HIT_NORMAL [deprecated 7.12]
+
+pre 7.0
+-------
+include/raytrace.h
+	struct hit.hit_point -> RT_HIT_POINT [deprecated pre-7.0]
+	struct hit.hit_normal -> RT_HIT_NORMAL [deprecated pre-7.0]
+
+
+************
+* OBSOLETE *
+************
+
+Below are the interfaces that have followed deprecation policy and are
+now no longer a part of BRL-CAD.
+
 
 7.24.2
 ------
@@ -617,8 +477,6 @@ may need adjustment (particularly quoting of '(', ')', and '|'
 characters) for other environments.  Most expressions will apply with:
 	perl -0777 -pi -e 'EXPRESSION' FILE
 
-To apply them to an entire SVN checkout, the following pattern is useful:
-find . -type f -not -path "*.svn/*" -regex '.*\(c\|cpp\|cxx\|h\|hpp\)$' -exec perl -0777 -pi -e 'EXPRESSION' {} \;
 
 6.0 (sed lines)
 ---
@@ -1075,138 +933,20 @@ s/bu_count_path(.*)\);/bu_dir_list\1, NULL);/g
 	made bu_dir_list() return the number of entries [7.21]
 s/bu_strcmpm\((.*),([^,]*)\)/bu_strcmp(\1)/g
 	no use for label parameter, convert to bu_strcmp() [7.21]
-	bu_set_realtime() [deprecated 7.22]
+        bu_set_realtime() [deprecated 7.22]
 
 7.24
 ----
-s/bu_set_realtime\([[:space:]]\);//g
-	didn't do anything [7.23]
-s/.*bu_cpulimit_[sg]et\([[:space:]]\);//g
-	didn't do anything [7.23]
+s/bu_set_realtime([[:space:]]);//g
+        didn't do anything [7.23]
+s/.*bu_cpulimit_[sg]et([[:space:]]);//g
+        didn't do anything [7.23]
 s/rt_g\./RTG\./g
-	renamed rt_g global to RTG so it doesn't match the struct name [7.24]
+        renamed rt_g global to RTG so it doesn't match the struct name [7.24]
 s/rt_functab\[/OBJ\[/g
-	renamed rt_functab global to OBJ so it doesn't match the struct name [7.24]
+        renamed rt_functab global to OBJ so it doesn't match the struct name [7.24]
 s/redraw_vlist/draw/g
-	removed redraw_vlist mged command, just call draw or refresh [7.24]
+        removed redraw_vlist mged command, just call draw or refresh [7.24]
 s/RT_BADNUM/INVALID/g
 s/RT_BADVAL/VINVALID/g
-	moved RT_BADNUM and RT_BADVEC to vmath.h as INVALID and VINVALID [7.24]
-s/bu_create_hash_tbl/bu_hash_tbl_create/g
-s/bu_find_hash_entry/bu_hash_tbl_find/g
-s/bu_hash_add_entry/bu_hash_tbl_add/g
-s/bu_hash_tbl_pr/bu_hash_tbl_print/g
-	renamed for better consistency in hash table API and with other libbu API [7.24]
-s/dm_applicationfocus\([[:space:]]*\);//g
-	only useful in older os x versions, users can now do the same thing via XQuartz preferences [7.24]
-s/bu_vls_trunc2/bu_vls_trunc/g
-	removed duplicitous function in favor of more general version [7.24]
-s/bn_pi/M_PI/g
-s/bn_twopi/M_2PI/g
-s/bn_halfpi/M_PI_2/g
-s/bn_quarterpi/M_PI_4/g
-s/bn_invpi/M_1_PI/g
-s/bn_inv2pi/M_1_2PI/g
-s/bn_inv4pi/M_1_4PI)/g
-s/bn_inv255/(1.0 \/ 255.0)/g
-s/bn_degtorad/DEG2RAD/g
-s/bn_radtodeg/RAD2DEG/g
-s/bn_sin_scale/(BN_SINTABSIZE \/ M_2PI)/g
-	eliminated a number of libbn globals in favor of existing constants [7.24]
-s/(#[[:space:]]*include[[:space:]]+["<])vfont-if\.h/\1bu\/vfont.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])cmd\.h/\1bu\/cmd.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])hist\.h/\1bu\/hist.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])magic\.h/\1bu\/magic.h/g
-	library-specific public headers moved into a subdir [7.24]
-s/([^_])([nh]to[hn][fd])/\1bu_cv_\2/g
-	ntohf, ntohd, htonf, htond renamed with bu_cv_ prefix [7.24]
-
-7.26
-----
-s/bu_kill_parallel\([[:space:]]*\);//g
-	didn't do anything unless called from forked process, use bu_terminate() [7.25]
-s/bu_jmpbuf/bu_jmpbuf[0]/g
-s/bu_setjmp_valid/bu_setjmp_valid[0]/g
-	can replace 0 with bu_parallel_id() to get thread-safe jumping [7.25]
-s/bu_semaphore_reinit/bu_semaphore_init/g
-	no longer need to manually reinitialize (or initialize) semaphores [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])fbio\.h/\1bu\/fb.h/g
-	fbio.h is now part of fb.h [7.25]
-s/UNION/'u'/g
-s/SUBTRACT/'-'/g
-s/INTERSECT/'+'/g
-	old db.h db4 preprocessor symbols removed, use char or DB_OP_* [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])bselect\.h/\1bsocket.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])bin\.h/\1bnetwork.h/g
-	rename bselect.h and bin.h public headers to be more declaratively named [7.25]
-s/db5_enc_len\[(.*)\]/DB5_ENC_LEN(\1)/g
-	replaced db5_enc_len[] global array with DB5_ENC_LEN() macro [7.25]
-s/db_normalize/bu_normalize/g
-	move the path normalization routine to libbu [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])bot\.h/\1rt\/primitives\/bot.h/g
-	consolidate bot header contents [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])anim\.h/\1bn\/anim.h/g
-	consolidate anim header contents [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])plot3\.h/\1bn.h/g
-	plot3 implementation is in libbn, move header and replace plot3.h with bn.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])vectfont\.h/#define LAST -128\n\1bn\/vectfont.h/g
-	consolidate vectfont.h files [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])spm\.h/\1bn\/spm.h/g
-	move spm.h into bn subheader directory [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])dvec\.h/\1bn\/dvec.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])vector_fpu\.h/\1bn\/vector_fpu.h/g
-s/(#[[:space:]]*include[[:space:]]+["<])vector_x86\.h/\1bn\/vector_x86.h/g
-	move dvec.h and friends into bn subheader directory [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])db\.h/\1rt\/db4.h/g
-	move db.h to rt/db4.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])db5\.h/\1rt\/db5.h/g
-	move db5.h to rt/db5.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])mater\.h/\1raytrace.h/g
-	merge mater.h with rt/mater.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])nurb\.h/#include "raytrace.h"\n\1rt\/nurb.h/g
-	move nurb.h to rt/nurb.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])rtfunc\.h/#include "raytrace.h"\n\1rt\/func.h/g
-	move rtfunc.h to rt/func.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])tol\.h/#include "bn.h"\n#include "raytrace.h"\n\1rt\/tol.h/g
-	consolidate tol.h and rt/tol.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])tie\.h/\1rt\/tie.h/g
-	move tie.h to rt/tie.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])solid\.h/#include "raytrace.h"\n\1rt\/solid.h/g
-	move solid.h to rt/solid.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])shadework\.h/\1optical\/shadework.h/g
-	move shadework.h to optical/shadework.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])shadefuncs\.h/\1optical.h/g
-	move shadefuncs.h to optical/shadefuncs.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])light\.h/#include "bn.h"\n#include "raytrace.h"\n\1optical\/light.h/g
-	move light.h to optical/light.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])plastic\.h/\1optical\/plastic.h/g
-	move plastic.h to optical/plastic.h [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])rtgeom\.h/\1rt\/geom.h/g
-	move rtgeom.h to rt/geom.h [7.25]
-s/rt_vlist_get_cmd_description/bn_vlist_get_cmd_description/g
-s/rt_ck_vlist/bn_ck_vlist/g
-s/rt_vlist_export/bn_vlist_export/g
-s/rt_vlblock_free/bn_vlblock_free/g
-s/rt_vlblock_find/bn_vlblock_find/g
-	move vlist functions from librt to libbn [7.25]
-s/([[:space:],\(,"])bn_tcl/\1tclcad_bn/g
-s/([[:space:],\(,"])rt_tcl_rt/\1tclcad_rt/g
-s/([[:space:],\(,"])rt_tcl/\1tclcad_rt/g
-	tcl library registrations moved to libtclcad [7.25]
-s/rt_grow_boolstack/rt_bool_growstack/g
-	rename with consistent prefixes [7.25]
-s/(#[[:space:]]*include[[:space:]]+["<])obj\.h/\1dm\/bview.h/g
-s/GED_VIEW_OBJ_NULL/VIEW_OBJ_NULL/g
-	move view_obj to dm/bview.h [7.25]
-s/BU_PTBL_CLEAR_I\((.*)\)/BU_PTBL_SET(\1, (long*)0)/g
-	replace BU_PTBL_CLEAR_I into the BU_PTBL_SET command [7.25]
-s/BU_PTBL_END\(([^\)]*)\)/(\1)->end/g
-        replace BU_PTBL_END with direct ptbl peek or BU_PTBL_LEN [7.25]
-s/bu_free_argv/bu_argv_free/g
-s/bu_dup_argv/bu_argv_dup/g
-s/bu_dupinsert_argv/bu_argv_dupinsert/g
-	bu_*_argv -> bu_argv_* [7.25]
-s/bu_dir_list/bu_file_list/g
-	bu_dir_list -> bu_file_list [7.25]
-s/BU_FNMATCH_NOMATCH/1/g
-	don't use an explicit define for the non-matching case [7.25]
+        moved RT_BADNUM and RT_BADVEC to vmath.h as INVALID and VINVALID [7.24]

COPYING

@@ -101,7 +101,7 @@ arranged.  This includes an implicit assignment of copyright for any
 and all contributions being made.  The following notice should be
 prominent in the BRL-CAD sources:
 
-  Copyright (c) 1984-2016 United States Government as represented by
+  Copyright (c) 1984-2013 United States Government as represented by
   the U.S. Army Research Laboratory.
 
 Contact

CTestConfig.cmake

@@ -1,15 +0,0 @@
-## This file should be placed in the root directory of your project.
-## Then modify the CMakeLists.txt file in the root directory of your
-## project to incorporate the testing dashboard.
-##
-## # The following are required to submit to the CDash dashboard:
-##   ENABLE_TESTING()
-##   INCLUDE(CTest)
-
-set(CTEST_PROJECT_NAME "BRL-CAD")
-set(CTEST_NIGHTLY_START_TIME "06:00:00 UTC")
-
-set(CTEST_DROP_METHOD "http")
-set(CTEST_DROP_SITE "brlcad.org")
-set(CTEST_DROP_LOCATION "/CDash/submit.php?project=BRL-CAD")
-set(CTEST_DROP_SITE_CDASH TRUE)

HACKING

@@ -240,28 +240,18 @@ accuracy-oriented ray intersection, geometric analysis, and geometry
 representation library that supports a wide variety of geometric
 forms.  Geometry can be grouped into combinations and regions using
 CSG boolean operations.
-	Depends on: libbn libbu libregex libm (openNURBS)
+	Depends on: libbn libbu libtcl libregex libm (openNURBS)
 
 libbu: The BRL-CAD Utility library contains a wide variety of routines
 for memory allocation, threading, string handling, argument support,
 linked lists, and more.
-	Depends on: (threading) (malloc)
-
-libbg: The BRL-CAD Geometry library implements generic algorithms
-widely used in computational geometry, such as convex hull and
-triangle/triangle intersection calculations.
-	Depends on: libbn libbu
+	Depends on: libtcl (threading) (malloc)
 
 libbn: The BRL-CAD Numerics library provides many floating-point math
 manipulation routines for vector and matrix math, a polynomial
 equation solver, noise functions, random number generators, complex
 number support, and more as well.
-	Depends on: libbu libm
-
-libbrep: The BRL-CAD Boundary Representation library implements
-routines needed for the manipulation and analysis of Non-Uniform
-Rational BSpline based boundary representations.
-	Depends on: libbg libbn libbu OpenNURBS
+	Depends on: libbu libtcl libm
 
 libcursor: The cursor library is a lightweight cursor manipulation
 library similar to curses but with less overhead.
@@ -298,12 +288,30 @@ models, as well as various visual effects such as texturing, marble,
 wood graining, air, gravel, grass, clouds, fire, and more.
 	Depends on: librt libbn libbu libtcl
 
+liborle: The "old" run-length encoding library that will decode and
+encode University of Utah Raster Toolkit format Run-Length Encoded
+data.
+	Depends on nothing
+
 libpkg: The "Package" library is a network communications library that
 supports multiplexing and demultiplexing synchronous and asynchronous
 messages across stream connections.  The library supports a
 client-server communication model.
 	Depends on: libbu
 
+librtserver: The ray-trace server library is a thin interface over
+librt that simplifies the process of applying individual ray
+intersection tests against a given set of geometry.  The library
+supports communication with a BRL-CAD geometry repository and
+multithreaded ray dispatch.
+	Depends on: librt libbn libbu libtcl
+	Includes dependent libraries as part of this library
+
+libsysv: The System 5 compatibility library exists to support legacy
+systems that lack functionality required by BRL-CAD.  This library is
+deprecated and should generally not be used for new development.
+	Depends on nothing
+
 libtclcad: The Tcl-CAD library is a thin interface that assists in the
 binding of an image to a Tk graphics context.
 	Depends on: libbn libbu libfb libtcl libtk
@@ -424,15 +432,14 @@ compiler conformance with the ANSI C standard (c89).
 There is currently no C++ interface to the core BRL-CAD libraries.
 There are a few tools and enhancements to libraries that are
 implemented in C++ (the new BREP object type in librt, for example),
-and C++ is used underneath quite a number of libraries, but there is
-presently no public C++ API in use outside of OpenNURBS.
-
-While C++ as an implementation language of new tools and new library
-interfaces is not prohibited, the mixing of C++ semantics and C++ code
-(including simple // style comments) in the existing C files is not
-allowed.  As new interfaces are developed, new contributors become
-involved, and C++ code integration becomes more prevalent, the
-contributor guidelines will become reinforced with more details.
+but there are presently no C++ bindings available beyond experimental
+developments.  While C++ as an implementation language of new tools
+and new library interfaces is not prohibited, the mixing of C++
+semantics and C++ code (including simple // style comments) in the
+existing C files is not allowed.  As new interfaces are developed, new
+contributors become involved, and C++ code integration becomes more
+prevalent, the contributor guidelines will become reinforced with more
+details.
 
 
 CODING STYLE & STANDARDS
@@ -552,12 +559,12 @@ bn.h, part of libbn).  Examples:
 
   For known tolerances:
 
-  * instead of "foo == 2.0" use "NEAR_EQUAL(foo, 2.0, tol)"
-  * instead of "foo != 0.0" use "foo !NEAR_ZERO(foo, tol)"
+  * instead of "foo == 2.0" use "NEAR_EQUAL(foo,2.0,tol)"
+  * instead of "foo != 0.0" use "foo !NEAR_ZERO(foo,tol)"
 
   For indeterminate tolerances:
 
-  * instead of "foo == 2.0" use "EQUAL(foo, 2.0)"
+  * instead of "foo == 2.0" use "EQUAL(foo,2.0)"
   * instead of "foo != 0.0" use "foo !ZERO(foo)"
 
 There are several functions whose functionality are either wrapped or
@@ -580,7 +587,6 @@ variables should be utilized instead of the standard C facility:
   bu_optind instead of optind
   bu_optopt instead of optopt
   bu_optarg instead of optarg
-  bu_strdup() instead of strdup()
   bu_strlcat() instead of strcat(), strncat(), and strlcat()
   bu_strlcpy() instead of strcpy(), strncpy(), and strlcpy()
   bu_strcmp() and BU_STR_EQUAL() instead of strcmp()
@@ -588,7 +594,6 @@ variables should be utilized instead of the standard C facility:
   bu_strncmp() instead of strncmp()
   bu_strcasecmp() instead of strnicmp()/strncasecmp()
   bu_file_delete() instead of unlink(), rmdir(), and remove()
-  bu_sort() instead of qsort()
 
 Similarly, ANSI C functions are preferred over the BSD and POSIX
 interfaces.  The following functions should be used:
@@ -643,7 +648,7 @@ main(int ac, char *av[])
 ....int i;
 ....int foo = 0;
 
-....for (i = 0 ; i < 10; i++) {
+....for (i=0; i<10; i++) {
 [      ]foo += 1;
 [      ]if (foo % 2) {
 [      ]....printf("hello\n");
@@ -671,12 +676,6 @@ Commas and semicolons are followed by whitespace.
   int main(int argc, char *argv[]); /* ok */
   for (i = 0; i < max; i++) { ...   /* ok */
 
-Operators and arguments generally are separated with whitespace.
-  if (FLAG & MORE_FLAGS) { ...      /* ok */
-  for (i = 0; i < max; i++) { ...   /* ok */
-  if (FLAG&MORE_FLAGS) { ...        /* discouraged */
-  for (i=0; i<max; i++) { ...       /* discouraged */
-
 No space on arrow operators.
   structure->member = 5;            /* ok */
   structure -> member = 5;          /* bad */
@@ -707,8 +706,7 @@ braces should line up with that same statement.  Functions, however,
 are treated specially and we place their opening braces on separate
 lines.  See http://en.wikipedia.org/wiki/Indent_style for details.
 
-  int
-  some_function(char *j)
+  int some_function(char *j)
   {
       for (i = 0; i < 100; i++) {
 	  if (i % 10 == 0) {
@@ -753,20 +751,6 @@ other familiar programming construct (e.g., bu_malloc()+bu_free()),
 but care should otherwise be taken to be as consistent as possible
 within a file and across a library's API.
 
-Here are some naming convention pairings commonly used:
-
-  Allocation   => alloc()
-  Deallocation => free()
-
-  Initialization      => init()
-  De/Reinitialization => clear()
-
-  Allocation + Init      => create()   (new for C++)
-  Deinitialize + Dealloc => destroy()  (delete for C++)
-
-  Resource acquire => open()
-  Resource release => close()
-
 5) Debugging
 
 Compilation preprocessor defines should never change the size of
@@ -875,10 +859,6 @@ Note that changes to publicly documented tools and library APIs must
 adhere to BRL-CAD's change policy.  This means changes to any tests
 may require thoughtful deployment.  See the CHANGES file for details.
 
-These tests are run nightly on BRL-CAD's server to catch problems
-quickly - developers should be aware of the status of BRL-CAD's tests
-as seen at http://brlcad.org/CDash
-
 To add new regression tests, look at regress/weight.sh for an
 integration test example and src/libbu/tests/bu_vls_vprintf.c for an
 API unit test example.  See their corresponding CMakeLists.txt build
@@ -958,32 +938,36 @@ BUGS & UNEXPECTED BEHAVIOR
 --------------------------
 
 When a bug or unexpected behavior is encountered that cannot be
-quickly fixed, it needs to be documented in our BUGS file or more
-formally reported to the SourceForge bug tracker at:
+quickly fixed, it minimally needs to be documented.  If you are
+already a BRL-CAD contributor, this means either making a comment in
+the BUGS file or by making a formal report to the SourceForge bug
+tracker at:
 
 http://sourceforge.net/tracker/?atid=640802&group_id=105292&func=browse
 
-The tracker is the main source for user-reported bugs and/or any
-issues that require significant discussion or benefit from having
-their status publicly announced.  Issues listed in BUGS file are not
-necessarily listed in the tracker, and vice-versa.  The BUGS file is
-also a convenience notepad of long and short term development issues.
+If the bug is complicated, will require significant discussion or
+collaboration, cannot be fixed any time soon, or if you do not have
+commit access, the issue should be reported to the SourceForge bug
+tracker.  The issues listed in BUGS are not necessarily listed in bug
+tracker, and vice-versa.  The BUGS file is merely maintained as a
+convenience notepad of long and short term issues for the developers
+only.
 
 
 COMMIT ACCESS
 -------------
 
 Commit access is evaluated on a person-to-person basis at the
-discretion of existing contributors.  Commit access is generally
-granted after a contributor demonstrates strong competency with our
-developer guidelines and an existing developer with commit access
-vouches for the new developer.
+discretion of existing contributors, but generally readily granted so
+long as there is an existing developer with commit access willing to
+mentor the new developer.  If you would like to have commit access,
+there is usually no need to ask -- they will ask you.  Getting
+involved with the other contributors and making patches will generally
+result in automatic consideration for commit access.  If you have to
+ask for it, you probably won't get it.
 
-If you would like to have commit access, do not ask for it.  Getting
-involved with the other contributors and making patches will result in
-automatic consideration for commit access.  That said, the following
-steps represent a minimum that needs to occur in order for commit
-access to be granted:
+That said, the following steps represent a minimum that needs to occur
+in order for commit access to be granted:
 
 1) Read this file completely.
 
@@ -991,19 +975,25 @@ access to be granted:
 
 3) Join the brlcad-devel developer mailing list, introduce yourself.
 
-4) Create a SourceForge account, submit at least two patches that
+4) Create a SourceForge account, submit two or more patches that
 demonstrate competency with our coding style, apply flawlessly, and
-provide some significant improvement.
+provide significant improvements to the existing code.
 
-5) Get to know the other developers.  One of them will need to vouch
-for your commit access.
-
-*) Be a nice person.  ;)
+5) Be a nice person.  We're here to have fun and do cool things.  ;)
 
 Those with commit access have a responsibility to ensure that other
 developers are following the guidelines that have been described in
 this developer's guide within reasonable expectations.  A basic rule
-of thumb is:  don't break anything.
+of thumb is: don't break anything.
+
+While the testing process will strive to ensure consistent behavior as
+changes are made, the responsibility still remains with the individual
+contributors to ensure that everything still compiles and runs as it
+should.  At any given time, BRL-CAD should compile on all of the
+primary platforms and (minimally) pass the BRL-CAD Benchmark
+successfully.  If changes are made that are not exercised by the
+Benchmark suite, testing should be manually performed in a manner that
+exercises those particular changes.
 
 
 CONTRIBUTOR RESPONSIBILITIES
@@ -1079,8 +1069,7 @@ number follows a common convention where the three numbers represent:
     {MAJOR_VERSION}.{MINOR_VERSION}.{PATCH_VERSION}
 
 All "development" builds use an odd number for the minor version.  All
-"release" builds use an even number for the minor version.  Patched
-versions should include a release count:
+"release" builds use an even number for the minor version.  Patched versions should include a release count:
 
     {MAJOR_VERSION}.{MINOR_VERSION}.{PATCH_VERSION}[-{RELEASE_COUNT}]
 
@@ -1200,164 +1189,108 @@ necessary convention by a binary package management system.  Examples:
   zip
 
 
-PATCHING A RELEASE
-------------------
-
-Should it become necessary to patch a release that has already been
-posted and announced, the mechanism is to post patch files for the
-source release and update the uploaded release notes README file.
-
-Example: stop_rt_crashing-0.patch and fix_fbserv-1.patch
-
-It's expected that all patch files are independent and will be applied
-sequentially.  They should be consistently and incrementally numbered.
-Users should be instructed in the release notes README to download and
-apply all available patch files.
-
-For binary releases, it's recommended to just "move on" and let issues
-become resolved in the next release unless there's a critical security
-or significant data corruption issue involved.  If it becomes
-necessary to repost a release, use the RELEASE_COUNT file name
-convention described in VERSION NUMBERS & COMPATIBILITY.
-
-Example:  BRL-CAD-7.12.2.dmg is superseded by BRL-CAD-7.12.2-1.dmg
-
-Patched binary releases may be moved to the hidden attic folder if
-critical, though not necessary or recommended.  They are preserved for
-historic record and should never be deleted once announced.  Releases
-not yet been announced may be updated within two days of being posted
-without involving a patch.
-
-
 MAKING A RELEASE
 ----------------
 
-BRL-CAD is developed on a monthly iteration development schedule with
-a release planned (not always actualized) at the end of every month.
-
 In order to make a release, the sources need to be appropriately
-documented, tested, synchronized, and tagged.  BRL-CAD releases must
-pass strict verification and validation testing.
+verified, validated, documented, synchronized, and tagged:
 
-Any developer may cause a release to be made provided testing passes
-and the appropriate release steps are taken.
+  * Required verification and validation actions include compiling
+    successfully, passing regression tests, a successful benchmark,
+    and passing distcheck on at least two different platforms.
+    Compile with both default settings and all dependencies enabled.
 
-When a release intention is announced, it is recommended to sync the
-trunk sources to the RELEASE branch so appropriate review testing,
-repairs, and release steps can occur without being impacted by other
-development activity.
+  * All user-visible changes should be documented in the NEWS file;
+    all API changes should be noted in the CHANGES file (or reverted).
+    The release number should appropriately reflect the type of
+    changes being released.  See the more specific release steps noted
+    below and VERSION NUMBERS & COMPATIBILITY.
 
-Release steps are as follows:
+  * After successfully compiling and passing tests on at least two
+    platforms, the sources get merged to the STABLE branch and tagged
+    as tags/rel-MAJOR-MINOR-PATCH allowing for minor changes until
+    sources are posted and an announcement is posted.
 
-#####################################################################
-# 00: Notify developer mailing list of intention to release.
+Any developer may cause a release to be made provided all of the
+appropriate steps are taken.
 
-    echo "Release preparations are under way.  Trunk sources merged to the RELEASE branch will be reviewed for sync to STABLE and release tagging.  Please help test by compiling distcheck-full and running benchmark, mged, and archer." | mail -s "Release preparations commencing" brlcad-devel@lists.sourceforge.net -r "your@subscribed.address"
+When a release intention is announced, contributors are expected to
+"settle down" for two days (at most) so that the source code may be
+verified, tested, and released.  As BRL-CAD strives for a monthly
+iteration development cycle, this is often done at the end of a month.
 
-#####################################################################
-# 01: Sync trunk to RELEASE branch.
+Only minor bug fixes, documentation changes, and build system fixes
+should be performed after release intention is announced.   Major
+changes to the source code and documentation should not occur while
+release testing is being performed.
 
-    # NON-AUTO: Review the log and obtain the last trunk merge
-    # revision number from comments.
-    svn log --stop-on-copy https://svn.code.sf.net/p/brlcad/code/brlcad/branches/RELEASE | grep -E 'r[0-9]{5}'
-    PREV=[[last_trunk_rev]]
-    echo "PREV=$PREV"
+Steps to take for performing an appropriately verified, validated,
+documented, synchronized, and tagged release are as follows:
 
-    svn co svn://svn.code.sf.net/p/brlcad/code/brlcad/branches/RELEASE brlcad.RELEASE
-    cd brlcad.RELEASE
-    svn merge https://svn.code.sf.net/p/brlcad/code/brlcad/trunk@$PREV https://svn.code.sf.net/p/brlcad/code/brlcad/trunk@HEAD .
+0) All code is committed to SVN.  All commits have been reviewed.
+Notify developer mailing list of intention to release.
 
-#####################################################################
-# 02: Test the merge.
+    echo "Release preparations have begun.  Please refrain from disruptive commits until the release is tagged or 24-hours have passed, whichever first.  Ensure API changes are in CHANGES, user-visible changes are in NEWS, and help with release testing." | mail -s "Release preparations commencing" brlcad-devel@lists.sourceforge.net -r "your@subscribed.address"
 
-    mkdir -p .build && cd .build
-    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make
+1) Update TODO and BUGS.  Verify all user-visible changes are in NEWS.
+Verify CHANGES reflects all API and application changes.  Make sure
+changes to usage/options are reflected in manual pages.
 
-    # Manually check rt, mged, and archer.
-    bin/rt        # should report usage with correct library versions
-    bin/mged -c test.g "make sph sph ; draw sph ; rt"   # pops up a sphere
-    bin/mged      # displays gui, run: opendb test.g ; draw sph ; rt
-    bin/archer    # displays gui, run: opendb test.g ; draw sph ; rt
+2) Update or verify the version numbers in the include/conf version
+files, NEWS, and README.  Commit the changes to the source repository.
+See VERSION NUMBERS & COMPATIBILITY for versioning requirements.
 
-    # clean up
-    cd .. && rm -rf .build
-
-#####################################################################
-# 03: Commit the merge.
-
-    CURR=`svn log --xml https://svn.code.sf.net/p/brlcad/code/brlcad/trunk | grep 'revision=' | head -n 1 | sed 's/.*="\([0-9][0-9]*\)".*/\1/g'`
-    echo "CURR=$CURR"
-
-    svn commit -m "merge of trunk to RELEASE branch, r$PREV through r$CURR"
-
-#####################################################################
-# 04: Reprioritize or address remaining TODO items.
-
-    # NON-AUTO: Do what's necessary to release, update priorities.
-
-#####################################################################
-# 05: Review all commits.
-
-    # NON-AUTO: Verify all user-visible changes are in NEWS.
-    # NON-AUTO: Verify all interface changes are in CHANGES.
-    # NON-AUTO: Verify usage/options are documented in doc/.
-
-#####################################################################
-# 06: Update the version numbers.
-
-    # NON-AUTO: NEWS
-    # NON-AUTO: README
-    # NON-AUTO: include/conf/PATCH
-    # NON-AUTO: include/conf/MINOR (See VERSION NUMBERS & COMPATIBILITY section.)
-    # NON-AUTO: misc/debian/changelog
-    # NON-AUTO: misc/macosx/Resources/ReadMe.rtfd/TXT.rtf
-    # NON-AUTO: misc/macosx/Resources/Welcome.rtfd/TXT.rtf
-
-#####################################################################
-# 07: Update ChangeLog.  Use the YYYY-MM-DD of previous NEWS entry.
+3) Update the ChangeLog with entries since the last release; commit
+the updated ChangeLog.  Use the YYYY-MM-DD of the previous release.
+Get the date from the NEWS file.
 
     LAST=`grep -E "\--- [0-9]{4}-[0-9]{2}-[0-9]{2}" NEWS | head -n 2 | tail -n 1 | awk '{print $2}'`
     echo "LAST=$LAST"
-    LAST=r57446
     svn2cl --break-before-msg --include-rev --stdout -r HEAD:{$LAST} > ChangeLog
     svn commit -m "update log with commits through $LAST" ChangeLog
 
-#####################################################################
-# 08: Run distcheck-full on at least two platforms.
+4) Verify a successful build and distcheck ON AT LEAST TWO PLATFORMS.
+Passing regression tests, benchmark, and two build configurations are
+required for syncing to STABLE.  Manually test mged and archer.
 
-    mkdir -p .build && cd .build && cmake .. && make distcheck-full
+    mkdir -p .verify && cd .verify
+    cmake .. && make distcheck && rm -rf ../.verify/*
+    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make distcheck && make
 
-#####################################################################
-# 09: Sync RELEASE to STABLE branch:
+    # manually test
+    bin/rt        # should report usage with correct library versions
+    bin/benchmark run TIMEFRAME=1            # completes without ERROR
+    bin/mged -c test.g "make sph sph ; rt"   # pops up a sphere
+    bin/rtwizard  # displays gui
+    bin/mged      # displays gui, run: opendb test2.g ; make sph sph ; rt
 
-    # NON-AUTO: Review the log and obtain the last merge revision
-    # number from comments.
-    svn log --stop-on-copy https://svn.code.sf.net/p/brlcad/code/brlcad/branches/STABLE | less
+    # clean up
+    cd .. && rm -rf .verify
+
+5) Sync trunk onto the STABLE branch.  Make sure all changes since the
+previous sync are included and that STABLE matches trunk.
+
+    # review the log and obtain the last trunk merge revision number from comments
+    svn log --stop-on-copy https://svn.code.sf.net/p/brlcad/code/brlcad/branches/STABLE . | more
     PREV=[[last_trunk_rev]]
-	### OR ###
+	*** OR ***
     PREV=`svn log --xml --stop-on-copy https://svn.code.sf.net/p/brlcad/code/brlcad/branches/STABLE | grep 'revision=' | head -n 1 | sed 's/.*revision="\([0-9][0-9]*\)".*/\1/g'`
     echo "PREV=$PREV"
 
-    # merge that range of changes into STABLE
+    # merge that range of changes into STABLE and make sure it works
     svn co https://svn.code.sf.net/p/brlcad/code/brlcad/branches/STABLE brlcad.STABLE && cd brlcad.STABLE
-    svn merge https://svn.code.sf.net/p/brlcad/code/brlcad/branches/RELEASE@$PREV https://svn.code.sf.net/p/brlcad/code/brlcad/branches/RELEASE@HEAD .
-
-#####################################################################
-# 10: Test the merge.
+    svn merge https://svn.code.sf.net/p/brlcad/code/brlcad/trunk@$PREV https://svn.code.sf.net/p/brlcad/code/brlcad/trunk@HEAD .
 
+    # compile the merge
     mkdir .merge && cd .merge
-    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make distcheck-full && cd .. && rm -rf .merge
+    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make && cd .. && rm -rf .merge
 
-#####################################################################
-# 11: Commit the merge.
-
-    CURR=`svn log --xml https://svn.code.sf.net/p/brlcad/code/brlcad/branches/RELEASE | grep 'revision=' | head -n 1 | sed 's/.*="\([0-9][0-9]*\)".*/\1/g'`
+    # commit the merge
+    CURR=`svn log --xml https://svn.code.sf.net/p/brlcad/code/brlcad/trunk | grep 'revision=' | head -n 1 | sed 's/.*="\([0-9][0-9]*\)".*/\1/g'`
     echo "CURR=$CURR"
+    svn commit -m "merging trunk to STABLE from r$PREV to HEAD r$CURR"
 
-    svn commit -m "merging RELEASE branch to STABLE branch, r$PREV through r$CURR"
-
-#####################################################################
-# 12: Tag the release using "rel-MAJOR-MINOR-PATCH" format:
+6) Tag the release using "rel-MAJOR-MINOR-PATCH" format:
 
     MAJOR=`awk '{print $1}' include/conf/MAJOR`
     MINOR=`awk '{print $1}' include/conf/MINOR`
@@ -1365,13 +1298,11 @@ Release steps are as follows:
     echo "Tagging rel-$MAJOR-$MINOR-$PATCH"
     svn cp https://svn.code.sf.net/p/brlcad/code/brlcad/branches/STABLE https://svn.code.sf.net/p/brlcad/code/brlcad/tags/rel-$MAJOR-$MINOR-$PATCH
 
-#####################################################################
-# 13: Increment and commit the next BRL-CAD release numbers to SVN.
-
-    # Update the include/conf/(MAJOR|MINOR|PATCH) version files
-    # immediately to odd-numbered minor version or new patch developer
-    # version (e.g. 7.11.0 or 7.34.1).  Update README and NEWS version
-    # to next *expected* release number (e.g. 7.12.0 or 7.34.2).
+7) Increment and commit the next BRL-CAD release numbers to SVN.
+Update the include/conf/(MAJOR|MINOR|PATCH) version files immediately
+to an odd-numbered minor version or a new patch developer version
+(e.g. 7.11.0 or 7.4.1).  Update README and NEWS version to next
+_expected_ release number (e.g. 7.12.0 or 7.4.2).
 
     echo "`expr $PATCH + 1`" > include/conf/PATCH
     NEXT="`expr $PATCH + 2`"
@@ -1380,22 +1311,16 @@ Release steps are as follows:
     cat NEWS | tr '\n' '@' | perl -pi -e "$EXPR" | tr '@' '\n' > NEWS
     svn commit -m "bump to next development revision after tagging the $MAJOR.$MINOR.$PATCH release" ../include/conf/PATCH
 
-#####################################################################
-# 14: Sync RELEASE changes back to trunk.
-
-    # Work-in-progress
-
-#####################################################################
-# 15: Obtain a tagged version of the sources from the repository, make
-# final distribution tarballs:
+8) Obtain a tagged version of the sources from the repository, make
+final distribution tarballs:
 
     svn checkout https://svn.code.sf.net/p/brlcad/code/brlcad/tags/rel-$MAJOR-$MINOR-$PATCH brlcad-$MAJOR.$MINOR.$PATCH
     cd brlcad-$MAJOR.$MINOR.$PATCH-build && mkdir .build && cd .build
-    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make distcheck-full
+    cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && make distcheck
 
-#####################################################################
-# 16: Upload the source distributions and release notes.  Use source
-# tarballs to create binaries.
+9) Upload the source distributions and release notes.  Use source
+tarballs to create binaries.  Use the NAMING A BINARY RELEASE section
+above to name them.
 
     # create a shell session and source dir
     SFUSERNAME=`ls ~/.subversion/auth/svn.simple/* | xargs -n 1 grep -A4 sourceforge | tail -1`
@@ -1419,27 +1344,23 @@ Release steps are as follows:
     cat README-$MAJOR-$MINOR-$PATCH.txt && echo "==="
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ Source/$MAJOR.$MINOR.$PATCH/."
 
-    # NON-AUTO: Following the NAMING A BINARY RELEASE convention,
-    # upload any release binaries and platform-specific release notes.
-
+    # upload release notes to binary dirs (as needed)
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ Runtime\ Libraries/$MAJOR.$MINOR.$PATCH/."
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ for\ BSD/$MAJOR.$MINOR.$PATCH/."
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ for\ Linux/$MAJOR.$MINOR.$PATCH/."
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ for\ Mac\ OS\ X/$MAJOR.$MINOR.$PATCH/."
     scp README-$MAJOR-$MINOR-$PATCH.txt "$SFUSERNAME,brlcad@shell.sf.net:/home/frs/project/b/br/brlcad/BRL-CAD\ for\ Windows/$MAJOR.$MINOR.$PATCH/."
 
-    # NON-AUTO: Be sure to mark binaries as default download, then
-    # close shell session
+    # be sure to mark binaries as default download, then close shell session
     ssh -v $SFUSERNAME,brlcad@shell.sf.net shutdown
 
-#####################################################################
-# 17: Notify binary platform maintainers:
+10) Notify binary platform maintainers:
 
     T2 package maintainer
 	http://t2-project.org/packages/brlcad.html
 
     OpenSUSE package maintainer
-        https://build.opensuse.org/package/users/Education/brlcad
+	https://build.opensuse.org/package/users?package=brlcad&project=Education
 
     FreeBSD ports maintainer
 	http://www.freebsd.org/cgi/cvsweb.cgi/ports/cad/brlcad/
@@ -1456,8 +1377,7 @@ Release steps are as follows:
     Slackware maintainer
 	http://slackbuilds.org/result/?search=brlcad
 
-#####################################################################
-# 18: Announce the new release.
+11) Announce the new release.
 
 The NEWS file should generally be used as a basis for making release
 announcements though the announcements almost always require
@@ -1473,6 +1393,10 @@ audience.  Always notify the following when a release is made:
     BRL-CAD SourceForge NEWS  (authorized can submit)
 	https://sourceforge.net/p/brlcad/news/new
 
+    Freshmeat  (anyone can submit update)
+	http://freecode.com/projects/BRL-CAD/
+	short summary without news details (sentence format)
+
     BRL-CAD on Facebook  (authorized can submit)
 	http://www.facebook.com/pages/BRL-CAD/387112738872
 	short summary without news details (sentence format)
@@ -1515,6 +1439,10 @@ Mac OS X release:
 
 Multiple platform major release and announcements:
 
+    upFront.ezine, Ralph Grabowski
+	ralphg@upfrontezine.com
+	with news details
+
     CADinfo.NET
 	copyboy@cadinfo.net
 	with news details
@@ -1535,10 +1463,37 @@ Multiple platform major release and announcements:
 	http://cadcam-insider.com/index.php/News-submission-guidelines.html
 	copyboy@cadcam-insider.com
 
-#####################################################################
-# 19: Sit back and enjoy a beverage for a job well done.
+12) Sit back and enjoy a beverage for a job well done.
 
 
+PATCHING A RELEASE
+------------------
+
+Should it become necessary to patch a release that has already been
+posted and announced, the mechanism is to post patch files for the
+source release and update the uploaded release notes README file.
+
+Example: stop_rt_crashing-0.patch and fix_fbserv-1.patch
+
+It's expected that all patch files are independent and will be applied
+sequentially.  They should be consistently and incrementally numbered.
+Users should be instructed in the release notes README to download and
+apply all available patch files.
+
+For binary releases, it's recommended to just "move on" and let issues
+become resolved in the next release unless there's a critical security
+or significant data corruption issue involved.  If it becomes
+necessary to repost a release, use the RELEASE_COUNT file name
+convention described in VERSION NUMBERS & COMPATIBILITY.
+
+Example:  BRL-CAD-7.12.2.dmg is superseded by BRL-CAD-7.12.2-1.dmg
+
+Patched binary releases may be moved to the hidden attic folder if
+critical, though not necessary or recommended.  They are preserved for
+historic record and should never be deleted once announced.  Releases
+not yet been announced may be updated within two days of being posted
+without involving a patch.
+
 
 GETTING HELP
 ------------

INSTALL

@@ -405,51 +405,40 @@ mode.
 Aliases:  ENABLE_STRICT, ENABLE_STRICT_COMPILE, ENABLE_STRICT_COMPILE_FLAGS
 
 
---- ENABLE_ALL_CXX_COMPILE ---
-
-Build all C and C++ files with a C++ compiler.  Defaults to OFF.
-
-EXPERIMENTAL!
-
-Aliases:  ENABLE_ALL_CXX
-
-
---- ENABLE_POSIX_COMPLIANCE ---
-
-Build with strict POSIX compliance checking.  Defaults to OFF.
-
-Causes compiler options to be set for strict compliance with the
-minimum C and C++ standards acceptable according to current BRL-CAD
-policy.  The current minimum C standard is ??.
-There is no currently defined minimum C++ standard.
-
-Aliases:  ENABLE_POSIX
-
-
---- ENABLE_STRICT_COMPILER_STANDARD_COMPLIANCE ---
-
-Build with strict ISO C compliance checking.  Defaults to OFF.
-
-Causes C compiler options to be set for strict compliance with the
-appropriate ISO C standard.
-
-Aliases:  STRICT_ISO_C
-
-
 --- BRLCAD_EXTRADOCS ---
 
-The core option that enables and disables building of BRL-CAD's
-DocBook based documentation (includes manuals and man pages for
-commands, among other things).  Defaults to ON, but only HTML and MAN
-formats are enabled by default - PDF must be enabled separately by use
-of this option or one of its aliases.  Note that you may set
-environment variable APACHE_FOP to point to your locally installed fop
-executable file (which on Linux is usually a shell script with 0755
-permissions).
+The core option that enables and disables building of BRL-CAD's DocBook
+based documentation (includes manuals and man pages for commands, among
+other things.)  Defaults to ON, but only HTML and MAN formats are enabled
+by default - PDF must be enabled separately by use of this option or one
+of its aliases.  Note that you may set environment variable APACHE_FOP
+to point to your locally installed fop executable file (which on Linux is
+usually a shell script with 0755 permissions).
 
 Aliases:  ENABLE_DOCS, ENABLE_EXTRA_DOCS, ENABLE_DOCBOOK
 
 
+--- BRLCAD_REGEX ---
+
+Option for enabling and disabling compilation of the Regular
+Expression Library provided with BRL-CAD's source distribution.
+Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option
+and testing first for a system version if BRLCAD_BUNDLED_LIBS is also
+AUTO.
+
+Aliases:  ENABLE_REGEX
+
+
+--- BRLCAD_ZLIB ---
+
+Option for enabling and disabling compilation of the zlib library
+provided with BRL-CAD's source distribution.  Default is AUTO,
+responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
+first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
+
+Aliases:  ENABLE_ZLIB, ENABLE_LIBZ
+
+
 --- BRLCAD_LEMON ---
 
 Option for enabling and disabling compilation of the lemon parser
@@ -481,17 +470,6 @@ AUTO.  perplex requires a working re2c.
 Aliases:  ENABLE_PERPLEX
 
 
---- BRLCAD_ASTYLE ---
-
-Option for enabling and disabling compilation of the Artistic Style
-(astyle) utility provided with BRL-CAD's source distribution.  Default is
-AUTO,
-responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
-first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_ASTYLE
-
-
 --- BRLCAD_XSLTPROC ---
 
 Option for enabling and disabling compilation of the xsltproc XML
@@ -515,47 +493,6 @@ version if BRLCAD_BUNDLED_LIBS is also AUTO.
 Aliases:  ENABLE_XMLLINT
 
 
---- BRLCAD_REGEX ---
-
-Option for enabling and disabling compilation of the Regular
-Expression Library provided with BRL-CAD's source distribution.
-Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option
-and testing first for a system version if BRLCAD_BUNDLED_LIBS is also
-AUTO.
-
-Aliases:  ENABLE_REGEX
-
-
---- BRLCAD_ZLIB ---
-
-Option for enabling and disabling compilation of the zlib library
-provided with BRL-CAD's source distribution.  Default is AUTO,
-responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
-first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_ZLIB, ENABLE_LIBZ
-
-
---- BRLCAD_TINYCTHREAD ---
-
-Option for enabling and disabling compilation of the tinycthread library
-provided with BRL-CAD's source distribution.  Default is AUTO,
-responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
-first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_TINYCTHREAD
-
-
---- BRLCAD_FREETYPE ---
-
-Option for enabling and disabling compilation of the FreeType
-libraries provided with BRL-CAD's source code.  Default is AUTO, responsive to
-the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
-version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_FREETYPE
-
-
 --- BRLCAD_TERMLIB ---
 
 Option for enabling and disabling compilation of the termlib library
@@ -568,16 +505,6 @@ disabled. Windows does not support the termlib API.)
 Aliases:  ENABLE_TERMLIB
 
 
---- BRLCAD_NETPBM ---
-
-Option for enabling and disabling compilation of the netpbm library
-provided with BRL-CAD's source code.  Default is AUTO, responsive to
-the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
-version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_NETPBM
-
-
 --- BRLCAD_PNG ---
 
 Option for enabling and disabling compilation of the Portable Network
@@ -712,17 +639,7 @@ version if BRLCAD_BUNDLED_LIBS is also AUTO.
 Aliases:  ENABLE_OPENNURBS
 
 
---- BRLCAD_SPR ---
-
-Option for enabling and disabling compilation of the PoissonRecon library
-provided with BRL-CAD's source code.  Default is AUTO, responsive to
-the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
-version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_SPR
-
-
---- BRLCAD_SC ---
+--- BRLCAD_SCL ---
 
 Option for enabling and disabling compilation of the NIST Step Class
 Libraries provided with BRL-CAD's source code.  Default is AUTO,
@@ -732,17 +649,7 @@ first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
 Aliases:  ENABLE_SCL, ENABLE_STEP, ENABLE_STEP_CLASS_LIBRARIES
 
 
---- BRLCAD_GECODE ---
-
-Option for enabling and disabling compilation of the Gecode Constraint
-Solving Libraries provided with BRL-CAD's source code.  Default is AUTO,
-responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
-first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_GECODE
-
-
---- BRLCAD_VDS ---
+--- BRLCAD_LIBVDS ---
 
 Option for enabling and disabling compilation of the libvds triangle
 simplification library provided with BRL-CAD's source code.  Default
@@ -753,17 +660,7 @@ AUTO.
 Aliases:  ENABLE_VDS
 
 
---- BRLCAD_OSG ---
-
-Option for enabling and disabling compilation of the OpenSceneGraph
-libraries provided with BRL-CAD's source code.  Default is AUTO, responsive to
-the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
-version if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_OPENSCENEGRAPH
-
-
---- BRLCAD_GDIAM ---
+--- BRLCAD_LIBGDIAM ---
 
 Option for enabling and disabling compilation of the libgdiam approximate
 tight bounding box library provided with BRL-CAD's source code.  Default
@@ -774,17 +671,6 @@ AUTO.
 Aliases:  ENABLE_GDIAM
 
 
---- BRLCAD_BULLET ---
-
-Option for enabling and disabling compilation of the Bullet Realtime
-Physics Simulation Libraries provided with BRL-CAD's source
-distribution.  Default is AUTO, responsive to the toplevel
-BRLCAD_BUNDLED_LIBS option and testing first for a system version
-if BRLCAD_BUNDLED_LIBS is also AUTO.
-
-Aliases:  ENABLE_BULLET
-
-
 
 *** Note - Do not add or edit configuration option descriptions and alias
    lists in this file - those entries are auto-generated from information in

NEWS

@@ -10,218 +10,27 @@ descriptive text that emphasizes or further describes significant
 changes made.  See document footer for additional details.
 
 ----------------------------------------------------------------------
---- 2016-07-XX  Release 7.26.2                                     ---
+--- 2013-0X-XX  Release 7.24.2                                     ---
 ----------------------------------------------------------------------
 
-
-
-----------------------------------------------------------------------
---- 2016-06-XX  Release 7.26.0                                     ---
-----------------------------------------------------------------------
-
-This major release update of BRL-CAD culminates several years of
-development efforts to provide robust boundary representation (BREP)
-NURBS import and ray tracing support.  Our NURBS capability gets us a
-step closer to full hybrid representation modeling, supporting
-seamless transitioning and mixing of boundary representation geometry
-(e.g., NURBS or polygonal meshes) with implicit representation
-geometry (e.g., primitives with CSG).
-
-* added manual page for lt comb child listing command - Cliff Yapp
-* added lt -c option for specifying separation character - Bob Parker
-* mass-deprecation of 121 command-line utilities - BRL-CAD Developers
-* improved hierarchy preservation in 3dm-g importer - Jon Engbert
-* fixed upside down 'screengrab' images on some platforms - Nick Reed
-* updated wireframe drawing to respect primitive colors - Cliff Yapp
-* updated pixdiff & pixcmp to only compare same sizes - Cliff Yapp
-* fixed running archer from read-only filesystems - Cliff Yapp
-* fixed patch-g tool and E command infinite loop bug - Sean Morrison
-* improved NMG ray tracing fault tolerance - Sean Morrison
-* added 3dm-g support for layers and names - Keith Bowman
-* fixed color/shader preservation issue with 3dm-g importer - Jon Engbert
-* added 3dm-g support for mesh objects - Jon Engbert
-* added csg implicit hierarchy conversion to brep command - Cliff Yapp
-* fixed crash in clone when told to make zero copies - Cliff Yapp
-* fixed crash in search when using -above option - Cliff Yapp
-* extended nirt to list current and available formats - Sean Morrison
-* fixed NURBS wireframe drawing crash - Cliff Yapp
-* fixed firing of single rays using the rtshot tool - Sean Morrision
-* improved rcodes command feedback in the no changes case - Cliff Yapp
-* added brlman -S option to specify man page section  - Cliff Yapp
-* modified rtg3 to avoid outputting excessive LOS - Nick Gerstner
-* extended burst and rtg3 to output 5 digit ID numbers - Nick Gerstner
-* improved draw command manual page documenation - Cliff Yapp
-* added lc -m option to report multi-material/los regions - Cliff Yapp
-* added new 'icv' image conversion tool w/ pix, bw, dpix, png, ppm
-	- Mohit Daga, Cliff Yapp, Sean Morrison, Erik Greenwald
-* ported 'burst' tool (batch mode only) to Windows - Cliff Yapp
-* removed mged pl command, use plot command instead - Sean Morrison
-* improved datum wireframes (yellow) and fixed arrowheads - Cliff Yapp
-* added initial manual page for 'burst' ray dispatch tool - Cliff Yapp
-* improved wireframe display list performance - Keith Bowman
-* added draw -S for simplied wireframes, no subtractions - Cliff Yapp
-* added draw -L# to draw bounding boxes for large objects - Cliff Yapp
-* added 3dm-g instance reference and definition import - Jon Engbert
-* minor rtwizard graphical user interface reorganization - Cliff Yapp
-* ported 'brlman' manual page viewer with GUI to Windows - Cliff Yapp
-* added gdiff -h help command-line option - Cliff Yapp
-* added facetize -m marching cubes option - Erik Greenwald
-* removed -I interactive option from rt/rtedge/remrt - Sean Morrison
-* improved pix-bw intensity averaging to closest integer - Cliff Yapp
-* removed pix-bw3 & bw3-pix tools, see pix-bw & bw-pix - Cliff Yapp
-* fixed pix-ppm to write out all image data - Sean Morrision
-* added libnetpbm for ppm image format support in icv - Cliff Yapp
-* added new algorithm to bot_decimate (via -f option) - Jon Engbert
-* fixed benchmark bug running from paths with spaces - Sean Morrison
-* fixed adjust command crash when working with BoTs - Daniel Roßberg
-* removed support for RLE v1 and v2 ('orle') image format - Cliff Yapp
-* fixed datum type 'in' command unit conversion bug - Cliff Yapp
-* fixed rpatch / patch-g line handling on Windows - Daniel Roßberg
-* added 'arb8' surface area value to analyze command - Kalpit Thakkar
-* added 'part' centroid reporting to analyze command - Brad Hollister
-* added new pixcrop utility for cropping pix images - Carl Moore
-* preliminary OpenCL-accelerated coherent ray tracing pipeline
-	- Jon Engbert, Vasco Costa
-* improved point cloud plot visualization - Sean Morrison
-* fixed program freezing bug in MGED grouper command - Bob Parker
-* added 'rhc' reporting to analyze command - Kalpit Thakkar
-* improved help option consistency across numerous tools - Carl Moore
-* added prefatory FASTGEN4 geometry export support - Jon Engbert
-* improved option parsing and output options for gencolor - Carl Moore
-* fixed saveview usage help string and running from archer - Nick Reed
-* fixed and improved killtree man page - Nick Reed
-* fixed composition bugs in pixmatte and pixmerge - Carl Moore
-* fixed definition of "light year" in unit conversions - Cliff Yapp
-* modernized documents and improved infrastructure - Hitesh Sofat
-* added mirroring support for hrt primitive objects - Isaac Kamga
-* ported the mged Overlap Tool to Windows - Sean Morrison
-* improved NURBS prep performance for UV-remapped surfaces - Nick Reed
-* fixed dbconcat -c crash when color table does not exist - Nick Reed
-* swapped meanings of search's -above/-below options - Sean Morrison
-* upgraded freetype to version 2.5.5 - Cliff Yapp
-* updated libregex to apply a fix for CVE-2015-2305 - Cliff Yapp
-* upgraded libpng to version 1.6.20 - Cliff Yapp
-* added command window option for pasting tree view paths - Nick Reed
-* improved robustness of bb command oriented box option - Peter Amidon
-* added example NURBS B-Rep geometry files from NIST - Cliff Yapp
-* removed "high resolution" options from all commands - Carl Moore
-* improved performance of archer loading large BoT models - Nick Reed
-* added evaluated shaded drawing preference mode and menu - Nick Reed
-* extensive improvements to NURBS Boolean evaluation - Nick Reed
-* added 'bot chull' for creating convex hull envelopes - Cliff Yapp
-* new manual page for the g-voxel exporter - Mandarj
-* improved performance of lc command - Peter Amidon
-* updated manual page for MGED's brep command - Peter Amidon
-* new manual page for the g-dot exporter - Shardul Chiplunkar
-* added sketch centroid support the analyze command - Peter Amidon
-* new Think. Invent. Create. splash screen for archer - Marc Tannous
-* improved pix-bw to support dual output streams - Carl Moore
-* added list option to attr command - Cliff Yapp
-* added globbing support to attr command - Cliff Yapp
-* added lc -0 option to return objects in tree order - Sean Morrison
-* fixed crash in iges-g importer due to parsing error - Ștefan Mirea
-* fixed corrupt output generated by iges-g importer - Ștefan Mirea
-* gqa respects LIBRT_BOT_MINTIE environment variable - Ștefan Mirea
-* improved behavior of mged's draw command - Ștefan Mirea
-* fixed handling of extra whitespace in nirt commands - Ștefan Mirea
-* renamed 'make_bb' mged command name to 'bb' - Cliff Yapp
-* added g-ply exporter for Stanford PLY geometry format - Rishub Jain
-* added ply-g importer for Stanford PLY geometry format - Rishub Jain
-* fixed texture mapping crash with bad image dimensions - Ștefan Mirea
-* fixed g2asc and asc2g handling of dsp primitive - Cliff Yapp
-* rewrote gdiff with improved output & reporting options - Cliff Yapp
-* fixed pix-ps -S -W -N output size options being ignored - Carl Moore
-* fixed crash exporting mixed mode merged BoT meshes - Sean Morrison
-* fixed submodel primitive crash - Cliff Yapp, Sean Morrison
-* support non-.g file import in Archer's file open dialog - Cliff Yapp
-* added brep support to g2asc and asc2g - Cliff Yapp
-* fixed a CPU affinity locking bug on Linux platforms - Sean Morrison
-* renamed g_diff/g_lint/g_qa/g_transfer sans underscore - Cliff Yapp
-* removed mged -n option, use mged -c for classic mode - Cliff Yapp
-* fixed mged -c crash running view-modifying commands - Sean Morrison
-* improved kill, killall, killtree documentation - Sean Morrison
-* added killtree -f force flag to kill unconditionally - Sean Morrison
-* killtree now defaults to skipping referenced objects - Sean Morrison
-* nirt -h option is now help, old -h is -H - Carl Moore
-* implemented preliminary NURBS geometry Boolean evaluation
-	- Wu Jianbang, Nick Reed, Cliff Yapp
-* improved step-g assembly hierarchy import support - Keith Bowman
-* fixed rtweight when using the -G grid spacing option - Sean Morrison
-* fixed memory leaks in a number of pix utilities - Cezar Elnazli
-* improved NURBS ray tracing & tessellation robustness - Keith Bowman
-* improved step-g NURBS geometry import robustness - Keith Bowman
-* added -v verbose output option to mged 'search' command - Cliff Yapp
-* fixed g_lint and pixcount red-black tree memory leaks - Tom Browder
-* fixed crash of extrude with special case bezier curves - huskmate13
-* improved performance of 'terrain' & numerous shaders - Sean Morrison
-* new manual pages for rtexample and brep_simple - Shardul Chiplunkar
-* added key binding to reopen/focus mged command window - Emory Huff
-* added menu option to restore mged command window - Cezar Elnazli
-* search command now recognizes hyp and metaball types - Cliff Yapp
-* added -depth option to mged 'search' command - Cliff Yapp
-* initial support for rigging joints and constrained articulation
-	- Nick Reed, Keith Bowman, Cliff Yapp, Sean Morrison
+* added -depth option to MGED 'search' command - Cliff Yapp
 * improved 'search' with 'flat' search path modifier - Cliff Yapp
 * improved 'search' with above/equal/below depth limits - Cliff Yapp
-* added comb -S option to stop when object already exists - Cliff Yapp
-* improved comb command documentation with many examples - Cliff Yapp
-* implemented new 'hrt' heart-shaped primitive object - Isaac Kamga
-
-
-----------------------------------------------------------------------
---- 2015-08-31  Release 7.24.4                                     ---
-----------------------------------------------------------------------
-
-* initial support for datum points, lines, and planes - Sean Morrison
-
-
-----------------------------------------------------------------------
---- 2014-06-02  Release 7.24.2                                     ---
-----------------------------------------------------------------------
-
-This patch release includes a plethora of significant bug fixes and
-improvements to BRL-CAD including fixing ADRT/TIE fast triangle ray
-tracing on 32-bit platforms, fixing an issue in our FASTGEN converter
-that affected the import of very complex geometry models, upgrading
-one of our third-party dependencies (libpng) in response to a
-vulnerability report, and improving the 'comb' and 'search' commands
-with new options for restructuring and searching geometry.
-Enhancements continue to be made to our boundary representation (BREP)
-NURBS infrastructure in support of hybrid representation modeling and
-improved geometry interchange with other CAD systems.
-
-* improved rcodes output to inform user what changed - Cliff Yapp
-* fixed inside command for ellipsoid primitives - Cliff Yapp
-* restored suppressed mged output after some commands - Cliff Yapp
-* added rtwizard -s square image size option - Cliff Yapp
-* documented image size options in rtwizard man page - Cliff Yapp
-* added view center specification dialog to rtwizard - Cliff Yapp
-* increased rtwizard window size for button visibility - Cliff Yapp
-* image conversion -R/-G/-B options now require weight - Mohit Daga
-* improved option consistency for image processing tools - Mohit Daga
-* improved pipe ray tracing grazing hit behavior - Keith Bowman
-* upgraded libpng, now at version 1.6.10 - Erik Greenwald, Cliff Yapp
-* improved solid NURBS geometry ray tracing behavior - Keith Bowman
-* fix z-clipping bug in mged's X display manager - Cliff Yapp
 * added attribute sorting option to the 'attr' command - Tom Browder
 * changed 'bwfilter' tool offset option from -o to -O - Mohit Daga
 * gattributes section 5 man page renamed to attributes - Tom Browder
 * changed 'benchmark' defaults: 2% deviation, 5 frames - Sean Morrison
 * improved bwrect to handle redirected input and output - Mohit Daga
-* upgraded boost to version 1.55.0 - Tom Browder
 * fixed TIE mesh raytrace crashes on 32-bit platforms - Sean Morrison
 * fixed pixscale and bwscale to not output ioctl error - Mohit Daga
-* improved fast4-g import of numerous region groups - Richard Weiss
-* fixed archer hidden line edit getting redrawn as shaded - Nick Reed
 * fixed adrt/TIE polygonal mesh memory management bug - Richard Weiss
 * fixed fast4-g importer parsing of blank input lines - Richard Weiss
 * added -o flag to 'bb' command for oriented bounding box - Cliff Yapp
 * allow search to see hidden combs with the -a flag - Cliff Yapp
 * added comb -l lift option to change region designation - Cliff Yapp
-* improved NURBS ray tracing grazing hit behavior - Keith Bowman
 * print current grid information in gqa output - Cliff Yapp
 * added -f option for flattening combs to 'comb' command - Cliff Yapp
-* added support for -bool operation filtering in search - Cliff Yapp
+* added support for boolean op filtering in search - Cliff Yapp
 * added new g-raw geometry converter - Jon Engbert, Daniel Roßberg
 * improved g-stl usage and documentation - Jon Engbert
 * added -c and -r region flag options to the comb command - Cliff Yapp
@@ -237,6 +46,7 @@ improved geometry interchange with other CAD systems.
 * pipe centroid, volume, & surface area analyze reporting - Csaba Nagy
 * added ebm centroid 'analyze' command reporting - Michael Huang
 * improved help option consistency across numerous tools - Carl Moore
+* upgraded libpng to 1.6.3 - Erik Greenwald
 
 
 ----------------------------------------------------------------------
@@ -327,7 +137,6 @@ including the STEP, Patch, and 3DM importers.
 * improved documentation consistency and authorship info - Tom Browder
 * new mouse-input unpushed matrix edit option in archer - Bob Parker
 * fixed bug during pipe editing with working units set - Bob Parker
-* added experimental 'bot_fuse' command to heal BoTs - Richard Weiss
 
 
 ----------------------------------------------------------------------
@@ -441,7 +250,7 @@ received corrections and improvements.  The introductory article
 * "About BRL-CAD" article translation to Armenian - Karen Mgebrova
 * "About BRL-CAD" article translation to Italian
 	- Unknown Contributor, Tom Browder
-* improved 'adjust' command rgb/color attribute handling - Cliff Yapp
+* improved handling of rgb/color attributes by adjust cmd - Cliff Yapp
 * added initial support for step-g import of assemblies - Keith Bowman
 * added a basic SWIG spec file - Erik Greenwald
 * fixed referenced object highlighting in archer treeview - Bob Parker
@@ -472,7 +281,7 @@ received corrections and improvements.  The introductory article
 * improved tessellation of pipe bends for conversion - Richard Weiss
 * fixed keypoint vertex bug when editing extrude objects - Nick Reed
 * fixed eto error converting hyp objects with asc2g tool - Nick Reed
-* fixed mged bug processing edcodes command arguments - Bob Parker
+# fixed mged bug processing edcodes command arguments - Bob Parker
 * various improvements to NMG polygonal mesh processing robustness
 	- Nick Reed, Sean Morrison, Richard Weiss
 * improved bad face handling within the obj-g importer - Nick Reed
@@ -1183,7 +992,7 @@ invalid geometry is now more robust.
 * added new -c character option to the loop command - Dawn Thomas
 * tire now checks for files instead of overwriting - Cliff Yapp
 * add new nirt formatting options, -L listing option - C. Yapp
-* fixed nirt 'dest' command file name string handling - Cliff Yapp
+* fixed nirt's dest cmd's handling of file name string - Cliff Yapp
 * modified mged nirt command to include air in results - Bob Parker
 
 
@@ -1775,7 +1584,7 @@ The rtarea command was added to MGED as well, along with rtweight.
 * added a -noleaf option to the mged pathlist command - Bob Parker
 * fixed potential infinite loop bug in BoT primitive - Bob Parker
 * no longer install tclsh/wish, use btclsh/bwish - Sean Morrison
-* added 'bot_merge' mged command (combine 2 bots into 1) - Lee Butler
+* added bot_merge mged cmd (combine 2 bots into 1) - Lee Butler
 
 ----------------------------------------------------------------------
 --- 2005-06-07  Release 7.2.6                                      ---

README

@@ -1,5 +1,5 @@
 			    BRL-CAD
-			 Release 7.26.2
+			 Release 7.24.2
 		       http://brlcad.org/
 
 BRL-CAD is a powerful cross-platform open source combinatorial

bench/CMakeLists.txt

@@ -6,55 +6,40 @@ add_definitions(
   -DHAVE_CONFIG_H
   -DBRLCADBUILD
   -DCONSOLE
-  )
+)
 
 BRLCAD_ADDEXEC(pixcmp pixcmp.c libbu)
 
-configure_file(run.sh "${CMAKE_CURRENT_BINARY_DIR}/benchmark" COPYONLY)
-install(PROGRAMS "${CMAKE_CURRENT_BINARY_DIR}/benchmark" DESTINATION ${BIN_DIR})
+configure_file(run.sh ${CMAKE_CURRENT_BINARY_DIR}/benchmark COPYONLY)
+install(PROGRAMS ${CMAKE_CURRENT_BINARY_DIR}/benchmark DESTINATION ${BIN_DIR})
 if(CMAKE_CONFIGURATION_TYPES)
-  foreach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
-    string(TOUPPER "${CFG_TYPE}" CFG_TYPE_UPPER)
-    configure_file(run.sh ${CMAKE_BINARY_DIR_${CFG_TYPE_UPPER}}/bin/benchmark COPYONLY)
-  endforeach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
+   foreach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
+     string(TOUPPER "${CFG_TYPE}" CFG_TYPE_UPPER)
+     configure_file(run.sh ${CMAKE_BINARY_DIR_${CFG_TYPE_UPPER}}/bin/benchmark COPYONLY)
+   endforeach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
 else(CMAKE_CONFIGURATION_TYPES)
   configure_file(run.sh ${CMAKE_BINARY_DIR}/bin/benchmark COPYONLY)
 endif(CMAKE_CONFIGURATION_TYPES)
 
-file(WRITE  "${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake" "message(\"---\")\n")
-file(APPEND "${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake" "message(\"Run 'make benchmark-clean' in the bench directory to delete the logic\")\n")
-file(APPEND "${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake" "message(\"and image files generated during the benchmark analysis.\")\n")
+file(WRITE ${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake "message(\"---\")\n")
+file(APPEND ${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake "message(\"Run 'make benchmark-clean' in the bench directory to delete the logic\")\n")
+file(APPEND ${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake "message(\"and image files generated during the benchmark analysis.\")\n")
 
 CMAKEFILES(lgt.sh run.sh try.sh viewdiff.sh)
 
 if(SH_EXEC)
-  # CTest enabled short run of the benchmark suite
-  add_test(NAME benchmark COMMAND ${SH_EXEC} "${CMAKE_BINARY_DIR}/bin/benchmark" run TIMEFRAME=1)
-  set_tests_properties(benchmark PROPERTIES LABELS "Benchmark")
-  add_custom_target(benchmark-check
-    COMMAND ${CMAKE_CTEST_COMMAND} -L Benchmark --output-on-failure
-    DEPENDS rt pixcmp BENCHMARK_PIX_cp PIX_LOG_cp
-    )
-  add_dependencies(benchmark-check bldg391.g m35.g moss.g sphflake.g star.g world.g)
-  if(TARGET check)
-    add_dependencies(check benchmark-check)
-  endif(TARGET check)
-
-  # Full run of the benchmark suite
-  add_custom_target(benchmark
-    COMMAND ${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark run
-    COMMAND ${CMAKE_COMMAND} -P "${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake"
-    DEPENDS rt pixcmp BENCHMARK_PIX_cp PIX_LOG_cp
-    )
-  add_dependencies(benchmark bldg391.g m35.g moss.g sphflake.g star.g world.g)
-
-  # benchmark cleanup targets
-  add_custom_target(benchmark-clean
-    ${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark clean
-    )
-  add_custom_target(benchmark-clobber
-    ${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark clobber
-    )
+	add_custom_target(benchmark
+		COMMAND ${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark run
+		COMMAND ${CMAKE_COMMAND} -P ${CMAKE_BINARY_DIR}/CMakeTmp/benchmsg.cmake
+		DEPENDS rt pixcmp BENCHMARK_PIX_cp PIX_LOG_cp
+		)
+	add_dependencies(benchmark bldg391.g m35.g moss.g sphflake.g star.g world.g)
+	add_custom_target(benchmark-clean
+		${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark clean
+		)
+	add_custom_target(benchmark-clobber
+		${SH_EXEC} ${CMAKE_BINARY_DIR}/bin/benchmark clobber
+		)
 endif(SH_EXEC)
 
 # Local Variables:

bench/lgt.sh

@@ -2,7 +2,7 @@
 #                          L G T . S H
 # BRL-CAD
 #
-# Copyright (c) 2004-2016 United States Government as represented by
+# Copyright (c) 2004-2013 United States Government as represented by
 # the U.S. Army Research Laboratory.
 #
 # Redistribution and use in source and binary forms, with or without

bench/pixcmp.c

@@ -1,7 +1,7 @@
 /*                        P I X C M P . C
  * BRL-CAD
  *
- * Copyright (c) 2004-2016 United States Government as represented by
+ * Copyright (c) 2004-2013 United States Government as represented by
  * the U.S. Army Research Laboratory.
  *
  * This program is free software; you can redistribute it and/or
@@ -31,15 +31,13 @@
 
 #include <stdlib.h>
 #include <string.h>
-#ifdef HAVE_SYS_STAT_H
-#  include <sys/stat.h>
+#ifdef HAVE_UNISTD_H
+#  include <unistd.h>
 #endif
 #include "bio.h"
 
-#include "bu/getopt.h"
-#include "bu/log.h"
-#include "bu/file.h"
-#include "bu/str.h"
+#include "bu.h"
+
 
 /* exit codes for argument processing errors */
 #define OPTS_ERROR 127
@@ -120,7 +118,6 @@ main(int argc, char *argv[])
 {
     FILE *f1 = NULL;
     FILE *f2 = NULL;
-    struct stat sf1, sf2;
 
     long matching = 0;
     long off1 = 0;
@@ -202,13 +199,6 @@ main(int argc, char *argv[])
 	exit(FILE_ERROR);
     }
 
-    stat(argv[0], &sf1);
-    stat(argv[1], &sf2);
-
-    if (sf1.st_size != sf2.st_size) {
-	bu_exit(FILE_ERROR, "Different file sizes found: %s(%d) and %s(%d).  Cannot perform pixcmp.\n", argv[0], sf1.st_size, argv[1], sf2.st_size);
-    }
-
     if (!print_bytes) {
 	f1_skip *= 3;
 	f2_skip *= 3;

bench/run.sh

@@ -2,7 +2,7 @@
 #                          R U N . S H
 # BRL-CAD
 #
-# Copyright (c) 2004-2016 United States Government as represented by
+# Copyright (c) 2004-2013 United States Government as represented by
 # the U.S. Army Research Laboratory.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -51,7 +51,7 @@
 export PATH || (echo "This isn't sh."; sh $0 $*; kill $$)
 
 # save the precious args
-ARGS="$@"
+ARGS="$*"
 NAME_OF_THIS="`basename \"$0\"`"
 PATH_TO_THIS="`dirname \"$0\"`"
 THIS="$PATH_TO_THIS/$NAME_OF_THIS"
@@ -159,59 +159,66 @@ booleanize ( ) {
 }
 
 
-# any unrecognized args are assumed to be RT args (e.g., -P4)
-RTARGS=""
-
 # process the argument list for commands
-while test $# -gt 0 ; do
-
-    arg="$1"
-    shift
-
+NEWARGS=""
+for arg in $ARGS ; do
     case "x$arg" in
 	x*[cC][lL][eE][aA][nN])
 	    CLEAN=1
+	    shift
 	    ;;
 	x*[cC][lL][oO][bB][bB][eE][rR])
 	    CLEAN=1
 	    CLOBBER=1
+	    shift
 	    ;;
 	x*[hH])
 	    HELP=1
+	    shift
 	    ;;
 	x*[hH][eE][lL][pP])
 	    HELP=1
+	    shift
 	    ;;
 	x*[iI][nN][sS][tT][rR][uU][cC][tT]*)
 	    INSTRUCTIONS=1
+	    shift
 	    ;;
 	x*[sS][tT][aA][rR][tT])
+	    shift
 	    ;;
 	x*[qQ][uU][iI][eE][tT])
 	    QUIET=1
+	    shift
 	    ;;
 	x*[vV][eE][rR][bB][oO][sS][eE])
 	    VERBOSE=1
+	    shift
 	    ;;
 	x*[rR][uU][nN])
 	    RUN=1
+	    shift
 	    ;;
 	x*=*)
 	    VAR=`echo $arg | sed 's/=.*//g'`
 	    if test ! "x$VAR" = "x" ; then
 		VAL=`echo $arg | sed 's/.*=//g'`
-		CMD="$VAR=\"$VAL\""
+		CMD="$VAR=$VAL"
 		eval $CMD
 		export $VAR
 	    fi
+	    shift
 	    ;;
 	x*)
-	    echo "WARNING: Passing unknown option [$arg] to RT"
-	    RTARGS="$RTARGS $arg"
+	    echo "WARNING: Passing unknown option [$1] to RT"
+	    NEWARGS="$NEWARGS $arg"
 	    ;;
     esac
 done
 
+# reload post-shifting
+ARGS="$NEWARGS"
+
 # validate and clean up options (all default to 0)
 booleanize CLOBBER HELP INSTRUCTIONS QUIET VERBOSE RUN
 
@@ -424,13 +431,13 @@ $ECHO
 ########################
 look_for ( ) {
 
-
     # utility function to search for a certain filesystem object in a
     # list of paths.
 
     look_for_type="$1" ; shift
     look_for_label="$1" ; shift
     look_for_var="$1" ; shift
+    look_for_dirs="$*"
 
     if test "x$look_for_label" != "x" ; then
 	$VERBOSE_ECHO  "Looking for $look_for_label"
@@ -438,11 +445,11 @@ look_for ( ) {
 
     # get the value of the variable
     look_for_var_var="echo \"\$$look_for_var\""
-    look_for_var_val="`eval \"${look_for_var_var}\"`"
+    look_for_var_val="`eval ${look_for_var_var}`"
 
     if test "x${look_for_var_val}" = "x" ; then
-	for look_for_dir in "$@" ; do
-	    shift
+	for look_for_dir in $look_for_dirs ; do
+
 	    opts="-r"
 	    case "x$look_for_type" in
 		xfile)
@@ -453,10 +460,10 @@ look_for ( ) {
 		    opts="-d -x"
 		    ;;
 		xexe*)
-		    opts="$opts -f -x"
+		    opts="$opts -f -r -x"
 		    ;;
 		xscr*)
-		    opts="$opts -f -x"
+		    opts="$opts -f -r -x"
 		    ;;
 	    esac
 	    look_for_failed=no
@@ -484,61 +491,61 @@ look_for ( ) {
 }
 
 look_for executable "the BRL-CAD raytracer" RT \
-    "${PATH_TO_THIS}/rt" \
-    "${PATH_TO_THIS}/../bin/rt" \
-    "${PATH_TO_THIS}/../src/rt/rt" \
-    "${PATH_TO_THIS}/src/rt/rt" \
+    ${PATH_TO_THIS}/rt \
+    ${PATH_TO_THIS}/../bin/rt \
+    ${PATH_TO_THIS}/../src/rt/rt \
+    ${PATH_TO_THIS}/src/rt/rt \
     ./rt \
     ../brlcadInstall/bin/rt.exe \
     ../src/rt/rt
 
 look_for file "a benchmark geometry directory" DB \
-    "${PATH_TO_THIS}/../share/brlcad/*.*.*/db/moss.g" \
-    "${PATH_TO_THIS}/share/brlcad/*.*.*/db/moss.g" \
-    "${PATH_TO_THIS}/../share/brlcad/db/moss.g" \
-    "${PATH_TO_THIS}/share/brlcad/db/moss.g" \
-    "${PATH_TO_THIS}/../share/db/moss.g" \
-    "${PATH_TO_THIS}/share/db/moss.g" \
-    "${PATH_TO_THIS}/../db/moss.g" \
-    "${PATH_TO_THIS}/db/moss.g" \
+    ${PATH_TO_THIS}/../share/brlcad/*.*.*/db/moss.g \
+    ${PATH_TO_THIS}/share/brlcad/*.*.*/db/moss.g \
+    ${PATH_TO_THIS}/../share/brlcad/db/moss.g \
+    ${PATH_TO_THIS}/share/brlcad/db/moss.g \
+    ${PATH_TO_THIS}/../share/db/moss.g \
+    ${PATH_TO_THIS}/share/db/moss.g \
+    ${PATH_TO_THIS}/../db/moss.g \
+    ${PATH_TO_THIS}/db/moss.g \
     ./db/moss.g \
     ../brlcadInstall/share/brlcad/*.*.*/db/moss.g \
     ../db/moss.g
-DB="`echo $DB | sed 's,/moss.g$,,'`"
+DB=`echo $DB | sed 's,/moss.g$,,'`
 
 look_for directory "a benchmark reference image directory" PIX \
-    "${PATH_TO_THIS}/../share/brlcad/*.*.*/pix" \
-    "${PATH_TO_THIS}/share/brlcad/*.*.*/pix" \
-    "${PATH_TO_THIS}/../share/brlcad/pix" \
-    "${PATH_TO_THIS}/share/brlcad/pix" \
-    "${PATH_TO_THIS}/../share/pix" \
-    "${PATH_TO_THIS}/share/pix" \
-    "${PATH_TO_THIS}/ref" \
+    ${PATH_TO_THIS}/../share/brlcad/*.*.*/pix \
+    ${PATH_TO_THIS}/share/brlcad/*.*.*/pix \
+    ${PATH_TO_THIS}/../share/brlcad/pix \
+    ${PATH_TO_THIS}/share/brlcad/pix \
+    ${PATH_TO_THIS}/../share/pix \
+    ${PATH_TO_THIS}/share/pix \
+    ${PATH_TO_THIS}/ref \
     ./ref
 
 look_for directory "a benchmark reference log directory" LOG \
-    "$PIX" \
-    "${PATH_TO_THIS}/../share/brlcad/*.*.*/pix" \
-    "${PATH_TO_THIS}/share/brlcad/*.*.*/pix" \
-    "${PATH_TO_THIS}/../share/brlcad/pix" \
-    "${PATH_TO_THIS}/share/brlcad/pix" \
-    "${PATH_TO_THIS}/../share/pix" \
-    "${PATH_TO_THIS}/share/pix" \
-    "${PATH_TO_THIS}/ref" \
+    $PIX \
+    ${PATH_TO_THIS}/../share/brlcad/*.*.*/pix \
+    ${PATH_TO_THIS}/share/brlcad/*.*.*/pix \
+    ${PATH_TO_THIS}/../share/brlcad/pix \
+    ${PATH_TO_THIS}/share/brlcad/pix \
+    ${PATH_TO_THIS}/../share/pix \
+    ${PATH_TO_THIS}/share/pix \
+    ${PATH_TO_THIS}/ref \
     ./ref
 
 look_for executable "a pixel comparison utility" CMP \
-    "${PATH_TO_THIS}/pixcmp" \
-    "${PATH_TO_THIS}/../bin/pixcmp" \
-    "${PATH_TO_THIS}/../bench/pixcmp" \
+    ${PATH_TO_THIS}/pixcmp \
+    ${PATH_TO_THIS}/../bin/pixcmp \
+    ${PATH_TO_THIS}/../bench/pixcmp \
     ../brlcadInstall/bin/pixcmp.exe \
     ./pixcmp
 
 look_for script "a time elapsed utility" ELP \
-    "${PATH_TO_THIS}/elapsed.sh" \
-    "${PATH_TO_THIS}/../bin/elapsed.sh" \
-    "${PATH_TO_THIS}/sh/elapsed.sh" \
-    "${PATH_TO_THIS}/../sh/elapsed.sh" \
+    ${PATH_TO_THIS}/elapsed.sh \
+    ${PATH_TO_THIS}/../bin/elapsed.sh \
+    ${PATH_TO_THIS}/sh/elapsed.sh \
+    ${PATH_TO_THIS}/../sh/elapsed.sh \
     ./elapsed.sh
 
 
@@ -585,12 +592,9 @@ else
 fi
 
 # more sanity checks, make sure the binaries and scripts run
-eval \"$RT\" -s1 -F/dev/debug \"${DB}/moss.g\" LIGHT > /dev/null 2>&1
+$RT -s1 -F/dev/debug ${DB}/moss.g LIGHT > /dev/null 2>&1
 ret=$?
 if test ! "x${ret}" = "x0" ; then
-    $ECHO
-    $ECHO "Running \"$RT\":"
-    "$RT"
     $ECHO
     $ECHO "ERROR:  RT does not seem to work as expected"
     exit 2
@@ -599,7 +603,7 @@ fi
 # create a temporary file named "null", fopen("/dev/null") does not work on
 # windows (using cygwin), so punt.
 > null
-eval \"$CMP\" null null >/dev/null 2>&1
+$CMP null null >/dev/null 2>&1
 rm -f null
 
 ret=$?
@@ -608,7 +612,7 @@ if test ! "x${ret}" = "x0" ; then
     $ECHO "ERROR:  CMP does not seem to work as expected"
     exit 2
 fi
-eval \"$ELP\" 0 > /dev/null 2>&1
+$ELP 0 > /dev/null 2>&1
 if test ! "x${ret}" = "x0" ; then
     $ECHO
     $ECHO "ERROR:  ELP does not seem to work as expected"
@@ -676,12 +680,12 @@ if test "x`expr 1 - 1 2>/dev/null`" = "x0" ; then
     if test $mintime -lt 1 ; then
 	mintime=0 # zero is okay
     fi
-    $ECHO "Minimum run time is `\"$ELP\" $mintime`"
+    $ECHO "Minimum run time is `$ELP $mintime`"
     maxtime="`expr 6 \* $MAXTIME`"
     if test $maxtime -lt 1 ; then
 	maxtime=1 # zero would be misleading
     fi
-    $ECHO "Maximum run time is `\"$ELP\" $maxtime`"
+    $ECHO "Maximum run time is `$ELP $maxtime`"
     estimate="`expr 3 \* $mintime`"
     if test $estimate -lt 1 ; then
 	estimate=1 # zero would be misleading
@@ -689,7 +693,7 @@ if test "x`expr 1 - 1 2>/dev/null`" = "x0" ; then
     if test $estimate -gt $maxtime ; then
 	estimate="$maxtime"
     fi
-    $ECHO "Estimated time is `eval \\\"$ELP\\\" $estimate`"
+    $ECHO "Estimated time is `$ELP $estimate`"
     $ECHO
 else
     $ECHO "WARNING: expr is unavailable, unable to compute statistics"
@@ -719,9 +723,9 @@ run ( ) {
 
     $VERBOSE_ECHO "DEBUG: Running $RT -B -M -s512 -H${run_hypersample} -J0 ${run_args} -o ${run_geomname}.pix ${DB}/${run_geomname}.g ${run_geometry}"
 
-    eval \"$RT\" -B -M -s512 -H${run_hypersample} -J0 ${run_args} \
+    $RT -B -M -s512 -H${run_hypersample} -J0 ${run_args} \
 	-o ${run_geomname}.pix \
-	\"${DB}/${run_geomname}.g\" ${run_geometry} 1>&2 <<EOF
+	${DB}/${run_geomname}.g ${run_geometry} 1>&2 <<EOF
 $run_view
 EOF
     retval=$?
@@ -995,7 +999,7 @@ EOF
 
 	    # compute how long we took, rounding up to at least one
 	    # second to prevent division by zero.
-	    bench_elapsed="`eval \\\"$ELP\\\" --seconds $bench_frame_start_time`"
+	    bench_elapsed="`$ELP --seconds $bench_frame_start_time`"
 	    if test "x$bench_elapsed" = "x" ; then
 		bench_elapsed=1
 	    fi
@@ -1063,7 +1067,7 @@ EOF
 	    fi
 
 	    # see if we need to break out early
-	    bench_overall_elapsed="`eval \\\"$ELP\\\" --seconds $bench_start_time`"
+	    bench_overall_elapsed="`$ELP --seconds $bench_start_time`"
 	    if test $bench_overall_elapsed -ge $MAXTIME ; then
 		break;
 	    fi
@@ -1101,7 +1105,7 @@ EOF
 	    break
 	fi
 
-	bench_overall_elapsed="`eval \\\"$ELP\\\" --seconds $bench_start_time`"
+	bench_overall_elapsed="`$ELP --seconds $bench_start_time`"
 
 	# undo the hypersample increase back one step
 	bench_hypersample="`expr \( \( $bench_hypersample + 1 \) / 2 \) - 1`"
@@ -1122,7 +1126,7 @@ EOF
 	ls -la *.pix*
     fi
     $VERBOSE_ECHO "DEBUG: $CMP $PIX/${bench_testname}.pix ${bench_testname}.pix"
-    cmp_result="`eval \\\"${CMP}\\\" \\\"${PIX}/${bench_testname}.pix\\\" ${bench_testname}.pix 2>&1`"
+    cmp_result="`${CMP} ${PIX}/${bench_testname}.pix ${bench_testname}.pix 2>&1`"
     ret=$?
 
     $ECHO "$cmp_result"
@@ -1177,8 +1181,8 @@ perf ( ) {
     perf_ref_files=""
     perf_cur_files=""
     for perf_test in $perf_tests ; do
-	perf_ref_log="${LOG}/${perf_test}.log"
-	perf_cur_log="${perf_test}.log"
+	perf_ref_log=${LOG}/${perf_test}.log
+	perf_cur_log=${perf_test}.log
 	for perf_log in "$perf_cur_log" "$perf_ref_log" ; do
 	    if test ! "x$perf_log" = "x" ; then
 		if test ! -f "$perf_log" ; then
@@ -1186,7 +1190,7 @@ perf ( ) {
 		fi
 	    fi
 	done
-	perf_ref_files="$perf_ref_files \"$perf_ref_log\""
+	perf_ref_files="$perf_ref_files $perf_ref_log"
 	perf_cur_files="$perf_cur_files $perf_cur_log"
     done
 
@@ -1196,8 +1200,8 @@ perf ( ) {
     #
     # FIXME: should really iterate one file at a time so we don't
     # just zero-pad at the end
-    perf_VGRREF="`eval grep RTFM $perf_ref_files | sed -n -e 's/^.*= *//' -e 's/ rays.*//p' | tr '\012' '\011' `"
-    perf_CURVALS="`eval grep RTFM $perf_cur_files | sed -n -e 's/^.*= *//' -e 's/ rays.*//p' | tr '\012' '\011' `"
+    perf_VGRREF=`grep RTFM $perf_ref_files | sed -n -e 's/^.*= *//' -e 's/ rays.*//p' | tr '\012' '\011' `
+    perf_CURVALS=`grep RTFM $perf_cur_files | sed -n -e 's/^.*= *//' -e 's/ rays.*//p' | tr '\012' '\011' `
 
     # if there were no reference values, we cannot compute timings
     if test "x$perf_VGRREF" = "x" ; then
@@ -1292,7 +1296,7 @@ $ECHO "Running the BRL-CAD Benchmark tests... please wait ..."
 $ECHO
 ret=0
 
-bench moss all.g $RTARGS << EOF
+bench moss all.g $ARGS << EOF
 viewsize 1.572026215e+02;
 eye_pt 6.379990387e+01 3.271768951e+01 3.366661453e+01;
 viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
@@ -1302,7 +1306,7 @@ viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
 EOF
 ret=`expr $ret + $?`
 
-bench world all.g $RTARGS << EOF
+bench world all.g $ARGS << EOF
 viewsize 1.572026215e+02;
 eye_pt 6.379990387e+01 3.271768951e+01 3.366661453e+01;
 viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
@@ -1312,7 +1316,7 @@ viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
 EOF
 ret=`expr $ret + $?`
 
-bench star all $RTARGS << EOF
+bench star all $ARGS << EOF
 viewsize 2.500000000e+05;
 eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04;
 viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00
@@ -1322,7 +1326,7 @@ viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00
 EOF
 ret=`expr $ret + $?`
 
-bench bldg391 all.g $RTARGS << EOF
+bench bldg391 all.g $ARGS << EOF
 viewsize 1.800000000e+03;
 eye_pt 6.345012207e+02 8.633251343e+02 8.310771484e+02;
 viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
@@ -1332,7 +1336,7 @@ viewrot -5.735764503e-01 8.191520572e-01 0.000000000e+00 0.000000000e+00
 EOF
 ret=`expr $ret + $?`
 
-bench m35 all.g $RTARGS <<EOF
+bench m35 all.g $ARGS <<EOF
 viewsize 6.787387985e+03;
 eye_pt 3.974533127e+03 1.503320754e+03 2.874633221e+03;
 viewrot -5.527838919e-01 8.332423558e-01 1.171090926e-02 0.000000000e+00
@@ -1342,7 +1346,7 @@ viewrot -5.527838919e-01 8.332423558e-01 1.171090926e-02 0.000000000e+00
 EOF
 ret=`expr $ret + $?`
 
-bench sphflake scene.r $RTARGS <<EOF
+bench sphflake scene.r $ARGS <<EOF
 viewsize 2.556283261452611e+04;
 orientation 4.406810841785839e-01 4.005093234738861e-01 5.226451688385938e-01 6.101102288499644e-01;
 eye_pt 2.418500583758302e+04 -3.328563644344796e+03 8.489926952850350e+03;
@@ -1352,7 +1356,7 @@ ret=`expr $ret + $?`
 $ECHO
 $ECHO "... Done."
 $ECHO
-$ECHO "Total testing time elapsed: `eval \\\"$ELP\\\" $start`"
+$ECHO "Total testing time elapsed: `$ELP $start`"
 
 # see if we fail
 if test ! "x$ret" = "x0" ; then
@@ -1361,7 +1365,7 @@ if test ! "x$ret" = "x0" ; then
     $ECHO
     $ECHO "A benchmark failure means this is not a viable install of BRL-CAD.  This may be"
     $ECHO "a new bug or (more likely) is a compilation configuration error.  Ensure your"
-    $ECHO "compiler has strict aliasing disabled, compilation is optimized, and you have"
+    $ECHO "compiler has strict aliasing disabled, compilation is unoptimized, and you have"
     $ECHO "installed BRL-CAD (some platforms require this).  If you still get a failure,"
     $ECHO "please report your configuration information to benchmark@brlcad.org"
     $ECHO
@@ -1376,8 +1380,8 @@ fi
 # compute and output results #
 ##############################
 
-performance="`perf 'moss world star bldg391 m35 sphflake' $RTARGS 2>&1`"
 
+performance="`perf 'moss world star bldg391 m35 sphflake' $ARGS`"
 if test $? = 0 ; then
     cat >> summary <<EOF
 $performance
@@ -1492,8 +1496,8 @@ else
     $ECHO
     blankit=no
 
-    # BSD+
-    look_for executable "a sysctl command" SYSCTL_CMD `echo "$PATH" | tr ":" "\n" | tr " " "\ " | sed 's/$/\/sysctl/g'`
+    # BSD
+    look_for executable "a sysctl command" SYSCTL_CMD `echo "$PATH" | tr ":" "\n" | sed 's/$/\/sysctl/g'`
     if test ! "x$SYSCTL_CMD" = "x" ; then
 	$ECHO "Collecting system state information (via $SYSCTL_CMD)"
 	preQUIET="$QUIET"
@@ -1508,7 +1512,7 @@ else
     fi
 
     # Solaris
-    look_for executable "a prtdiag command" PRTDIAG_CMD `echo "$PATH" | tr ":" "\n" | tr " " "\ " | sed 's/$/\/prtdiag/g'`
+    look_for executable "a prtdiag command" PRTDIAG_CMD `echo "$PATH" | tr ":" "\n" | sed 's/$/\/prtdiag/g'`
     if test ! "x$PRTDIAG_CMD" = "x" ; then
 	$ECHO "Collecting system diagnostics information (via $PRTDIAG_CMD)"
 	preQUIET="$QUIET"
@@ -1521,7 +1525,7 @@ else
     fi
 
     # AIX
-    look_for executable "a prtconf command" PRTCONF_CMD `echo "$PATH" | tr ":" "\n" | tr " " "\ " | sed 's/$/\/prtconf/g'`
+    look_for executable "a prtconf command" PRTCONF_CMD `echo "$PATH" | tr ":" "\n" | sed 's/$/\/prtconf/g'`
     if test ! "x$PRTCONF_CMD" = "x" ; then
 	$ECHO "Collecting system configuration information (via $PRTCONF_CMD)"
 	preQUIET="$QUIET"
@@ -1534,7 +1538,7 @@ else
     fi
 
     # SGI
-    look_for executable "an hinv command" HINV_CMD `echo "$PATH" | tr ":" "\n" | tr " " "\ " | sed 's/$/\/hinv/g'`
+    look_for executable "an hinv command" HINV_CMD `echo "$PATH" | tr ":" "\n" | sed 's/$/\/hinv/g'`
     if test ! "x$HINV_CMD" = "x" ; then
 	$ECHO "Collecting system configuration information (via $HINV_CMD)"
 	preQUIET="$QUIET"
@@ -1559,19 +1563,6 @@ else
 	blankit=yes
     fi
 
-    # Linux+
-    look_for executable "an lscpu command" LSCPU_CMD `echo "$PATH" | tr ":" "\n" | tr " " "\ " | sed 's/$/\/lscpu/g'`
-    if test ! "x$LSCPU_CMD" = "x" ; then
-	$ECHO "Collecting system CPU information (via $LSCPU_CMD)"
-	preQUIET="$QUIET"
-	QUIET=1
-	$ECHO "==============================================================================="
-	$ECHO "`$LSCPU_CMD 2>&1`"
-	$ECHO
-	QUIET="$preQUIET"
-	blankit=yes
-    fi
-
     if test "x$blankit" = "xyes" ; then
 	$ECHO
     fi
@@ -1579,12 +1570,12 @@ fi
 
 # tell about the benchmark document
 look_for file "" BENCHMARK_TR \
-    "${PATH_TO_THIS}/../share/brlcad/*.*.*/doc/benchmark.tr" \
-    "${PATH_TO_THIS}/share/brlcad/*.*.*/doc/benchmark.tr" \
-    "${PATH_TO_THIS}/share/brlcad/doc/benchmark.tr" \
-    "${PATH_TO_THIS}/share/doc/benchmark.tr" \
-    "${PATH_TO_THIS}/doc/benchmark.tr" \
-    "${PATH_TO_THIS}/../doc/benchmark.tr" \
+    ${PATH_TO_THIS}/../share/brlcad/*.*.*/doc/benchmark.tr \
+    ${PATH_TO_THIS}/share/brlcad/*.*.*/doc/benchmark.tr \
+    ${PATH_TO_THIS}/share/brlcad/doc/benchmark.tr \
+    ${PATH_TO_THIS}/share/doc/benchmark.tr \
+    ${PATH_TO_THIS}/doc/benchmark.tr \
+    ${PATH_TO_THIS}/../doc/benchmark.tr \
     ./benchmark.tr
 
 $ECHO "Read the benchmark.tr document for more details on the BRL-CAD Benchmark."

bench/try.sh

@@ -2,7 +2,7 @@
 #                          T R Y . S H
 # BRL-CAD
 #
-# Copyright (c) 2004-2016 United States Government as represented by
+# Copyright (c) 2004-2013 United States Government as represented by
 # the U.S. Army Research Laboratory.
 #
 # Redistribution and use in source and binary forms, with or without

bench/viewdiff.sh

@@ -2,7 +2,7 @@
 #                    V I E W D I F F . S H
 # BRL-CAD
 #
-# Copyright (c) 2004-2016 United States Government as represented by
+# Copyright (c) 2004-2013 United States Government as represented by
 # the U.S. Army Research Laboratory.
 #
 # Redistribution and use in source and binary forms, with or without

configure

@@ -66,18 +66,6 @@ do
                                   shift;;
      --disable-strict-compile-flags)                options="$options -DBRLCAD_ENABLE_STRICT=OFF";
                                   shift;;
-     --enable-all-cxx)                options="$options -DENABLE_ALL_CXX_COMPILE=ON";
-                                  shift;;
-     --disable-all-cxx)                options="$options -DENABLE_ALL_CXX_COMPILE=OFF";
-                                  shift;;
-     --enable-posix)                options="$options -DENABLE_POSIX_COMPLIANCE=ON";
-                                  shift;;
-     --disable-posix)                options="$options -DENABLE_POSIX_COMPLIANCE=OFF";
-                                  shift;;
-     --strict-iso-c)                options="$options -DENABLE_STRICT_COMPILER_STANDARD_COMPLIANCE=ON";
-                                  shift;;
-     --strict-iso-c)                options="$options -DENABLE_STRICT_COMPILER_STANDARD_COMPLIANCE=OFF";
-                                  shift;;
      --enable-docs)                options="$options -DBRLCAD_EXTRADOCS=ON";
                                   shift;;
      --disable-docs)                options="$options -DBRLCAD_EXTRADOCS=OFF";
@@ -90,30 +78,6 @@ do
                                   shift;;
      --disable-docbook)                options="$options -DBRLCAD_EXTRADOCS=OFF";
                                   shift;;
-     --enable-lemon)                options="$options -DBRLCAD_LEMON=BUNDLED";
-                                  shift;;
-     --disable-lemon)                options="$options -DBRLCAD_LEMON=SYSTEM";
-                                  shift;;
-     --enable-re2c)                options="$options -DBRLCAD_RE2C=BUNDLED";
-                                  shift;;
-     --disable-re2c)                options="$options -DBRLCAD_RE2C=SYSTEM";
-                                  shift;;
-     --enable-perplex)                options="$options -DBRLCAD_PERPLEX=BUNDLED";
-                                  shift;;
-     --disable-perplex)                options="$options -DBRLCAD_PERPLEX=SYSTEM";
-                                  shift;;
-     --enable-astyle)                options="$options -DBRLCAD_ASTYLE=BUNDLED";
-                                  shift;;
-     --disable-astyle)                options="$options -DBRLCAD_ASTYLE=SYSTEM";
-                                  shift;;
-     --enable-xsltproc)                options="$options -DBRLCAD_XSLTPROC=BUNDLED";
-                                  shift;;
-     --disable-xsltproc)                options="$options -DBRLCAD_XSLTPROC=SYSTEM";
-                                  shift;;
-     --enable-xmllint)                options="$options -DBRLCAD_XMLLINT=BUNDLED";
-                                  shift;;
-     --disable-xmllint)                options="$options -DBRLCAD_XMLLINT=SYSTEM";
-                                  shift;;
      --enable-regex)                options="$options -DBRLCAD_REGEX=BUNDLED";
                                   shift;;
      --disable-regex)                options="$options -DBRLCAD_REGEX=SYSTEM";
@@ -126,22 +90,30 @@ do
                                   shift;;
      --disable-libz)                options="$options -DBRLCAD_ZLIB=SYSTEM";
                                   shift;;
-     --enable-tinycthread)                options="$options -DBRLCAD_TINYCTHREAD=BUNDLED";
+     --enable-lemon)                options="$options -DBRLCAD_LEMON=BUNDLED";
                                   shift;;
-     --disable-tinycthread)                options="$options -DBRLCAD_TINYCTHREAD=SYSTEM";
+     --disable-lemon)                options="$options -DBRLCAD_LEMON=SYSTEM";
                                   shift;;
-     --enable-freetype)                options="$options -DBRLCAD_FREETYPE=BUNDLED";
+     --enable-re2c)                options="$options -DBRLCAD_RE2C=BUNDLED";
                                   shift;;
-     --disable-freetype)                options="$options -DBRLCAD_FREETYPE=SYSTEM";
+     --disable-re2c)                options="$options -DBRLCAD_RE2C=SYSTEM";
+                                  shift;;
+     --enable-perplex)                options="$options -DBRLCAD_PERPLEX=BUNDLED";
+                                  shift;;
+     --disable-perplex)                options="$options -DBRLCAD_PERPLEX=SYSTEM";
+                                  shift;;
+     --enable-xsltproc)                options="$options -DBRLCAD_XSLTPROC=BUNDLED";
+                                  shift;;
+     --disable-xsltproc)                options="$options -DBRLCAD_XSLTPROC=SYSTEM";
+                                  shift;;
+     --enable-xmllint)                options="$options -DBRLCAD_XMLLINT=BUNDLED";
+                                  shift;;
+     --disable-xmllint)                options="$options -DBRLCAD_XMLLINT=SYSTEM";
                                   shift;;
      --enable-termlib)                options="$options -DBRLCAD_TERMLIB=BUNDLED";
                                   shift;;
      --disable-termlib)                options="$options -DBRLCAD_TERMLIB=SYSTEM";
                                   shift;;
-     --enable-netpbm)                options="$options -DBRLCAD_NETPBM=BUNDLED";
-                                  shift;;
-     --disable-netpbm)                options="$options -DBRLCAD_NETPBM=SYSTEM";
-                                  shift;;
      --enable-png)                options="$options -DBRLCAD_PNG=BUNDLED";
                                   shift;;
      --disable-png)                options="$options -DBRLCAD_PNG=SYSTEM";
@@ -186,41 +158,25 @@ do
                                   shift;;
      --disable-opennurbs)                options="$options -DBRLCAD_OPENNURBS=SYSTEM";
                                   shift;;
-     --enable-spr)                options="$options -DBRLCAD_SPR=BUNDLED";
+     --enable-scl)                options="$options -DBRLCAD_SCL=BUNDLED";
                                   shift;;
-     --disable-spr)                options="$options -DBRLCAD_SPR=SYSTEM";
+     --disable-scl)                options="$options -DBRLCAD_SCL=SYSTEM";
                                   shift;;
-     --enable-scl)                options="$options -DBRLCAD_SC=BUNDLED";
+     --enable-step)                options="$options -DBRLCAD_SCL=BUNDLED";
                                   shift;;
-     --disable-scl)                options="$options -DBRLCAD_SC=SYSTEM";
+     --disable-step)                options="$options -DBRLCAD_SCL=SYSTEM";
                                   shift;;
-     --enable-step)                options="$options -DBRLCAD_SC=BUNDLED";
+     --enable-step-class-libraries)                options="$options -DBRLCAD_SCL=BUNDLED";
                                   shift;;
-     --disable-step)                options="$options -DBRLCAD_SC=SYSTEM";
+     --disable-step-class-libraries)                options="$options -DBRLCAD_SCL=SYSTEM";
                                   shift;;
-     --enable-step-class-libraries)                options="$options -DBRLCAD_SC=BUNDLED";
+     --enable-vds)                options="$options -DBRLCAD_LIBVDS=BUNDLED";
                                   shift;;
-     --disable-step-class-libraries)                options="$options -DBRLCAD_SC=SYSTEM";
+     --disable-vds)                options="$options -DBRLCAD_LIBVDS=SYSTEM";
                                   shift;;
-     --enable-gecode)                options="$options -DBRLCAD_GECODE=BUNDLED";
+     --enable-gdiam)                options="$options -DBRLCAD_LIBGDIAM=BUNDLED";
                                   shift;;
-     --disable-gecode)                options="$options -DBRLCAD_GECODE=SYSTEM";
-                                  shift;;
-     --enable-vds)                options="$options -DBRLCAD_VDS=BUNDLED";
-                                  shift;;
-     --disable-vds)                options="$options -DBRLCAD_VDS=SYSTEM";
-                                  shift;;
-     --enable-openscenegraph)                options="$options -DBRLCAD_OSG=BUNDLED";
-                                  shift;;
-     --disable-openscenegraph)                options="$options -DBRLCAD_OSG=SYSTEM";
-                                  shift;;
-     --enable-gdiam)                options="$options -DBRLCAD_GDIAM=BUNDLED";
-                                  shift;;
-     --disable-gdiam)                options="$options -DBRLCAD_GDIAM=SYSTEM";
-                                  shift;;
-     --enable-bullet)                options="$options -DBRLCAD_BULLET=BUNDLED";
-                                  shift;;
-     --disable-bullet)                options="$options -DBRLCAD_BULLET=SYSTEM";
+     --disable-gdiam)                options="$options -DBRLCAD_LIBGDIAM=SYSTEM";
                                   shift;;
      --prefix=*)   	          inputstr=$1;
 				  options="$options -DCMAKE_INSTALL_PREFIX=${inputstr#--prefix=}";

db/CMakeLists.txt

@@ -8,6 +8,7 @@ set(G_BENCHMARK_MODELS
 )
 
 set(G_SAMPLE_MODELS
+  ${G_BENCHMARK_MODELS}
   axis.asc
   boolean-ops.asc
   castle.asc
@@ -36,26 +37,6 @@ set(G_SAMPLE_MODELS
   xmp.asc
 )
 
-macro(ADD_G_TARGET g_model folder)
-  string(REGEX REPLACE "([0-9a-z]*).asc" "\\1" g_model_root "${g_model}")
-  set(output_file ${bin_root}/${DATA_DIR}/db/${g_model_root}.g)
-  add_custom_command(
-    OUTPUT ${output_file}
-    COMMAND asc2g "${CMAKE_CURRENT_SOURCE_DIR}/${g_model}" ${output_file}
-    DEPENDS asc2g "${CMAKE_CURRENT_SOURCE_DIR}/${g_model}"
-  )
-  add_custom_target(${g_model_root}.g ALL DEPENDS ${output_file})
-  set_target_properties(${g_model_root}.g PROPERTIES FOLDER "${folder}")
-  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
-    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
-  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
-endmacro(ADD_G_TARGET g_model folder)
-
-
 # Get our root path
 if(CMAKE_CONFIGURATION_TYPES)
   set(bin_root "${CMAKE_BINARY_DIR}/${CMAKE_CFG_INTDIR}")
@@ -66,27 +47,32 @@ endif(CMAKE_CONFIGURATION_TYPES)
 # Make sure the db directories are there
 if(CMAKE_CONFIGURATION_TYPES)
   foreach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
-     file(MAKE_DIRECTORY "${CMAKE_BINARY_DIR}/${CFG_TYPE}/${DATA_DIR}/db")
+     file(MAKE_DIRECTORY ${CMAKE_BINARY_DIR}/${CFG_TYPE}/${DATA_DIR}/db)
   endforeach(CFG_TYPE ${CMAKE_CONFIGURATION_TYPES})
 else(CMAKE_CONFIGURATION_TYPES)
-  file(MAKE_DIRECTORY "${CMAKE_BINARY_DIR}/${DATA_DIR}/db")
+  file(MAKE_DIRECTORY ${CMAKE_BINARY_DIR}/${DATA_DIR}/db)
 endif(CMAKE_CONFIGURATION_TYPES)
 
-add_subdirectory(comgeom)
-add_subdirectory(nist)
-add_subdirectory(faa)
-
-foreach(g_input ${G_BENCHMARK_MODELS})
-  ADD_G_TARGET(${g_input} "BRL-CAD Geometry Models/Benchmark")
-endforeach(g_input ${G_BENCHMARK_MODELS})
-CMAKEFILES(${G_BENCHMARK_MODELS})
-
-foreach(g_input ${G_SAMPLE_MODELS})
-  ADD_G_TARGET(${g_input} "BRL-CAD Geometry Models/Sample")
-endforeach(g_input ${G_SAMPLE_MODELS})
+foreach(g_model ${G_SAMPLE_MODELS})
+  string(REGEX REPLACE "([0-9a-z]*).asc" "\\1" g_model_root "${g_model}")
+  set(output_file ${bin_root}/${DATA_DIR}/db/${g_model_root}.g)
+  add_custom_command(
+    OUTPUT ${output_file}
+    COMMAND asc2g ${CMAKE_CURRENT_SOURCE_DIR}/${g_model} ${output_file}
+    DEPENDS asc2g ${CMAKE_CURRENT_SOURCE_DIR}/${g_model}
+  )
+  add_custom_target(${g_model_root}.g ALL DEPENDS ${output_file})
+  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
+    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
+      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
+    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
+    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
+  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
+  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
+endforeach(g_model ${G_SAMPLE_MODELS})
 CMAKEFILES(${G_SAMPLE_MODELS})
 
-set_directory_properties(PROPERTIES ADDITIONAL_MAKE_CLEAN_FILES "${BUILT_MODELS}")
+SET_DIRECTORY_PROPERTIES(PROPERTIES ADDITIONAL_MAKE_CLEAN_FILES "${BUILT_MODELS}")
 
 if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
    BRLCAD_ADDDATA(terra.dsp db)

db/comgeom/CMakeLists.txt

@@ -1,46 +0,0 @@
-set(COMGEOM_V5_MODELS
-  ADA073408.comgeom
-)
-
-macro(ADD_COMGEOM_V5_G_TARGET comgeom_model folder)
-  string(REGEX REPLACE "([0-9a-z]*).comgeom" "\\1" comgeom_model_root "${comgeom_model}")
-  set(output_file ${bin_root}/${DATA_DIR}/db/${comgeom_model_root}.g)
-  set(log_file ${CMAKE_CURRENT_BINARY_DIR}/${comgeom_model_root}.log)
-  add_custom_command(
-    OUTPUT ${output_file}
-    COMMAND ${CMAKE_COMMAND} -E remove ${output_file}
-    COMMAND comgeom-g -v 5 ${CMAKE_CURRENT_SOURCE_DIR}/${comgeom_model} ${output_file} > ${log_file} 2>&1
-    DEPENDS comgeom-g ${CMAKE_CURRENT_SOURCE_DIR}/${comgeom_model}
-  )
-  add_custom_target(${comgeom_model_root}.g ALL DEPENDS ${output_file})
-  set_target_properties(${comgeom_model_root}.g PROPERTIES FOLDER "${folder}")
-  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
-    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
-  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
-  set(LOG_FILES "${LOG_FILES};${log_file}")
-  DISTCLEAN(${log_file})
-endmacro(ADD_COMGEOM_V5_G_TARGET comgeom_model folder)
-
-foreach(comgeom_input ${COMGEOM_V5_MODELS})
-  ADD_COMGEOM_V5_G_TARGET(${comgeom_input} "BRL-CAD Geometry Models/Sample")
-endforeach(comgeom_input ${COMGEOM_V5_MODELS})
-CMAKEFILES(${COMGEOM_V5_MODELS})
-
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${BUILT_MODELS}")
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${LOG_FILES}")
-
-CMAKEFILES(
-  README_ADA073408
-  ADA073408_inputs.tar.gz
-)
-
-# Local Variables:
-# tab-width: 8
-# mode: cmake
-# indent-tabs-mode: t
-# End:
-# ex: shiftwidth=2 tabstop=8

db/comgeom/README_ADA073408

@@ -1,17 +0,0 @@
-Model ADA073408.comgeom is a transcription of the model documented in
-the 1979 public release report:
-
-A Combinatorial Geometry Computer Description of the MEP-021A Generator Set
-http://www.dtic.mil/docs/citations/ADA073408
-
-A series of Google GCI tasks worked to transcribe the ASCII COMGEOM
-description from the original report to text, and post-processed it
-into a form that the comgeom-g importer can handle:
-
-http://www.google-melange.com/gci/task/view/google/gci2013/5597236545191936
-http://www.google-melange.com/gci/task/view/google/gci2014/5293529710460928
-http://www.google-melange.com/gci/task/view/google/gci2014/5792678377684992
-
-The file ADA073408_inputs.tar.gz contains the original transcribed
-files and the script used to create the comgeom file.
-

db/cube.rt

@@ -2,7 +2,7 @@
 #                         C U B E . R T
 # BRL-CAD
 #
-# Copyright (c) 2004-2016 United States Government as represented by
+# Copyright (c) 2004-2013 United States Government as represented by
 # the U.S. Army Research Laboratory.
 #
 # Redistribution and use in source and binary forms, with or without

db/db.php

@@ -2,7 +2,7 @@
 /*                         D B . P H P
  * BRL-CAD
  *
- * Copyright (c) 2004-2016 United States Government as represented by
+ * Copyright (c) 2004-2013 United States Government as represented by
  * the U.S. Army Research Laboratory.
  *
  * This library is free software; you can redistribute it and/or
@@ -275,14 +275,12 @@ if ($physicalFile) {
 
 debug("END http request");
 
-?>
 
-<!--
-  Local Variables:
-  tab-width: 8
-  mode: php
-  c-basic-offset: 4
-  indent-tabs-mode: t
-  End:
-  ex: shiftwidth=4 tabstop=8
- -->
+# Local Variables: ***
+# mode: C ***
+# tab-width: 8 ***
+# c-basic-offset: 2 ***
+# indent-tabs-mode: t ***
+# End: ***
+# ex: shiftwidth=2 tabstop=8
+?>

db/faa/Business_Jet.fg4

@@ -1,856 +0,0 @@
-$COMMENT Generic Business Jet Rotor Burst Model
-$COMMENT Todd Horelica
-$COMMENT 28 Jan 2000
-$COMMENT
-$COMMENT The generic aircraft models were developed in support of the Federal
-$COMMENT Aviation Administration's Aircraft Catastrophic Failure Prevention
-$COMMENT Program. The models are used to demonstrate the Uncontained Engine
-$COMMENT Debris Damage Assessment Model (UEDDAM) tool which evaluates the risk
-$COMMENT to the aircraft from uncontained engine failures.  This analysis
-$COMMENT supports certification to Title 14 Code of Federal Regulations,
-$COMMENT Part 25.903.  The models are for demonstration purposes and do not
-$COMMENT depict actual aircraft and /or Aircraft systems in service.  The models
-$COMMENT are available for public release.
-$COMMENT
-$COMMENT Note:  Right and left are with respect to looking forward from the tail;
-$COMMENT        i.e. the pilot's perspective
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT
-$NAME          0       1                                Right Engine Nacelle
-SECTION        0       1       1       1
-GRID           1         -375.96  -64.08  145.47
-GRID           2         -491.31  -64.08  145.47
-CCONE1         1       8       1       2                    0.04    19.010000001
-10000001    19.0       1       1
-$NAME          0      11                                Left Engine Nacelle
-SECTION        0      11       1       1
-GRID           3         -375.96   64.08  145.47
-GRID           4         -491.31   64.08  145.47
-CCONE1         2       8       3       4                    0.04    19.010000002
-10000002    19.0       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Pylons
-$NAME          0       2                                Left Pylon
-SECTION        0       2       1       5
-GRID           5         -392.28   45.24  142.98
-GRID           6         -392.17   32.83  139.44
-GRID           7         -494.47   45.24  142.98
-GRID           8         -505.76   25.48  137.36
-GRID           9         -392.28   46.75  137.69
-GRID          10         -392.17   34.33  134.15
-GRID          11         -494.47   46.75  137.69
-GRID          12         -505.76   26.99  132.07
-CQUAD         51       8       5       9      11       7   0.032       1
-CQUAD         52       8       5       6      10       9   0.032       1
-CQUAD         53       8       6       8      12      10   0.032       1
-CQUAD         54       8       7       8      12      11   0.032       1
-CQUAD         55       8       5       6       8       7   0.032       1
-CQUAD         56       8       9      10      12      11   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          0       3                                Right Pylon
-SECTION        0       3       1       5
-GRID          13         -392.28  -45.24  142.98
-GRID          14         -392.17  -32.83  139.44
-GRID          15         -494.47  -45.24  142.98
-GRID          16         -505.76  -25.48  137.36
-GRID          17         -392.28  -46.75  137.69
-GRID          18         -392.17  -34.33  134.15
-GRID          19         -494.47  -46.75  137.69
-GRID          20         -505.76  -26.99  132.07
-CQUAD         61       8      13      17      19      15   0.032       1
-CQUAD         62       8      13      14      18      17   0.032       1
-CQUAD         63       8      14      16      20      18   0.032       1
-CQUAD         64       8      15      16      20      19   0.032       1
-CQUAD         65       8      13      14      16      15   0.032       1
-CQUAD         66       8      17      18      20      19   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          0       4                                Aft Fuselage
-SECTION        0       4       1       1
-GRID          21         -373.75   -0.00  127.25
-GRID          22         -512.50   -0.00  127.25
-CCONE1         3       8      21      22                   0.032   36.2510000003
-10000003   26.96       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          0     101                                Fairing
-SECTION        0     101       1       1
-GRID         223         -512.50   -0.00  100.27
-GRID         224         -373.75   33.49   75.73
-GRID         225         -373.75  -33.49   75.73
-GRID         226         -373.75   33.49  127.25
-GRID         227         -373.75  -33.49  127.25
-CQUAD         87       8     224     225     227     226   0.032       1
-CTRI          88       8     223     224     226           0.032       1
-CTRI          89       8     223     224     225           0.032       1
-CTRI          90       8     223     225     227           0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Rotors
-$NAME          1       1                                Right Engine Fan
-SECTION        1       1       2
-GRID         294         -408.33  -64.08  145.47
-GRID         295         -411.58  -64.08  145.47
-CCONE2         1       7     294     295                          13.609C90
-C90       13.609       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       2                                Right LPC1
-SECTION        1       2       2
-GRID         296         -416.62  -64.08  145.47
-GRID         297         -418.62  -64.08  145.47
-CCONE2         2       4     296     297                           8.543C905
-C905       8.543       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       3                                Right HPC1
-SECTION        1       3       2
-GRID         298         -427.25  -64.08  145.47
-GRID         299         -429.00  -64.08  145.47
-CCONE2         3       4     298     299                            5.09C91
-C91         5.09       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       4                                Right HPC2
-SECTION        1       4       2
-GRID         300         -431.36  -64.08  145.47
-GRID         301         -432.61  -64.08  145.47
-CCONE2         4       4     300     301                           4.898C92
-C92        4.898       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       5                                Right HPC3
-SECTION        1       5       2
-GRID         302         -436.69  -64.08  145.47
-GRID         303         -439.69  -64.08  145.47
-CCONE2         5       4     302     303                           6.644C93
-C93        6.644       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       6                                Right HPT1
-SECTION        1       6       2
-GRID         304         -443.53  -64.08  145.47
-GRID         305         -445.28  -64.08  145.47
-CCONE2         6       4     304     305                           5.784C94
-C94        5.784       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       7                                Right LPT1
-SECTION        1       7       2
-GRID         306         -447.46  -64.08  145.47
-GRID         307         -448.21  -64.08  145.47
-CCONE2         7       4     306     307                           7.286C95
-C95        7.286       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       8                                Right LPT2
-SECTION        1       8       2
-GRID         308         -450.10  -64.08  145.47
-GRID         309         -450.98  -64.08  145.47
-CCONE2         8       4     308     309                            8.63C96
-C96         8.63       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1       9                                Right LPT3
-SECTION        1       9       2
-GRID         310         -453.05  -64.08  145.47
-GRID         311         -454.05  -64.08  145.47
-CCONE2         9       4     310     311                           8.985C97
-C97        8.985       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      21                                Right Engine Case
-SECTION        1      21       1
-GRID         332         -407.83  -64.08  145.47
-GRID         333         -454.55  -64.08  145.47
-CCONE1        21       4     332     333                     0.1  14.109C332
-C332      14.109       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      11                                Left Engine Fan
-SECTION        1      11       2
-GRID         312         -408.33   64.08  145.47
-GRID         313         -411.58   64.08  145.47
-CCONE2        10       7     312     313                          13.609C98
-C98       13.609       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      12                                Left LPC2
-SECTION        1      12       2
-GRID         314         -416.62   64.08  145.47
-GRID         315         -418.62   64.08  145.47
-CCONE2        19       4     314     315                           8.543C985
-C985       8.543       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      13                                Left HPC1
-SECTION        1      13       2
-GRID         316         -427.25   64.08  145.47
-GRID         317         -429.00   64.08  145.47
-CCONE2        11       4     316     317                            5.09C99
-C99         5.09       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      14                                Left HPC2
-SECTION        1      14       2
-GRID         318         -431.36   64.08  145.47
-GRID         319         -432.61   64.08  145.47
-CCONE2        12       4     318     319                           4.898C100
-C100       4.898       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      15                                Left HPC3
-SECTION        1      15       2
-GRID         320         -436.69   64.08  145.47
-GRID         321         -439.69   64.08  145.47
-CCONE2        13       4     320     321                           6.644C101
-C101       6.644       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      16                                Left HPT1
-SECTION        1      16       2
-GRID         322         -443.53   64.08  145.47
-GRID         323         -445.28   64.08  145.47
-CCONE2        14       4     322     323                           5.784C102
-C102       5.784       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      17                                Left LPT1
-SECTION        1      17       2
-GRID         324         -447.46   64.08  145.47
-GRID         325         -448.21   64.08  145.47
-CCONE2        15       4     324     325                           7.286C103
-C103       7.286       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      18                                Left LPT2
-SECTION        1      18       2
-GRID         326         -450.10   64.08  145.47
-GRID         327         -450.98   64.08  145.47
-CCONE2        16       4     326     327                            8.63C104
-C104        8.63       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      19                                Left LPT3
-SECTION        1      19       2
-GRID         328         -453.05   64.08  145.47
-GRID         329         -454.05   64.08  145.47
-CCONE2        17       4     328     329                           8.985C105
-C105       8.985       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          1      22                                Left Engine Case
-SECTION        1      22       1
-GRID         334         -407.83   64.08  145.47
-GRID         335         -454.55   64.08  145.47
-CCONE1        22       4     334     335                     0.1  14.109C333
-C333      14.109       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Control Cables
-$NAME          3       1                                Elevator Control Cables
-SECTION        3       1       1
-GRID         256         -373.75   13.97   90.17
-GRID         257         -446.98   -2.25   95.25
-GRID         258         -512.50   -1.03  104.95
-GRID         259         -373.75    6.07   88.65
-GRID         260         -446.96   -2.70   95.40
-GRID         261         -512.50   -1.63  105.02
-CLINE          1       4     256     257                   0.063   0.063
-CLINE          2       4     257     258                   0.063   0.063
-CLINE          3       4     259     260                   0.063   0.063
-CLINE          4       4     260     261                   0.063   0.063
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          3       2                                Elevator Trim Cables
-SECTION        3       2       1
-GRID         262         -373.75  -26.11   99.49
-GRID         263         -388.77  -26.11   99.49
-GRID         264         -385.59   -5.80  160.33
-GRID         265         -512.50   -5.80  150.95
-GRID         266         -375.75  -25.70   99.35
-GRID         267         -388.78  -25.70   99.35
-GRID         268         -385.59   -5.80  159.88
-GRID         269         -512.50   -5.80  150.50
-CLINE          5       4     262     263                   0.063   0.063
-CLINE          6       4     263     264                   0.063   0.063
-CLINE          7       4     264     265                   0.063   0.063
-CLINE          8       4     266     267                   0.063   0.063
-CLINE          9       4     267     268                   0.063   0.063
-CLINE         10       4     268     269                   0.063   0.063
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          3     101                                Rudder-Upper
-SECTION        3     101       1
-GRID         270         -373.75   -3.72   90.59
-GRID         271         -384.74   -3.78   90.59
-GRID         272         -391.84   -5.80  158.00
-GRID         273         -512.50   -5.80  149.08
-GRID         274         -373.75   -9.62   91.68
-GRID         275         -383.88   -9.54   91.68
-GRID         276         -392.62   -7.04  157.94
-GRID         277         -512.50   -7.04  149.08
-CLINE         11       4     270     271                   0.063   0.063
-CLINE         12       4     271     272                   0.063   0.063
-CLINE         13       4     272     273                   0.063   0.063
-CLINE         14       4     274     275                   0.063   0.063
-CLINE         15       4     275     276                   0.063   0.063
-CLINE         16       4     276     277                   0.063   0.063
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          3     102                                Rudder-Lower
-SECTION        3     102       1
-GRID         278         -373.75   -3.85   89.54
-GRID         279         -448.81   -3.15   95.48
-GRID         280         -512.50   -5.55  106.78
-GRID         281         -373.75  -11.73   90.18
-GRID         282         -448.78   -3.68   95.40
-GRID         283         -512.50   -6.18  107.18
-CLINE         17       4     278     279                   0.063   0.063
-CLINE         18       4     279     280                   0.063   0.063
-CLINE         19       4     281     282                   0.063   0.063
-CLINE         20       4     282     283                   0.063   0.063
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          3     103                                Rudder Trim
-SECTION        3     103       1
-GRID         284         -375.75   25.28   99.20
-GRID         285         -388.78   25.28   99.20
-GRID         286         -385.54    5.55  159.17
-GRID         287         -406.34   -5.80  157.47
-GRID         288         -512.50   -5.80  149.62
-GRID         289         -373.75   26.53   99.63
-GRID         290         -388.76   26.53   99.63
-GRID         291         -385.75    5.95  159.27
-GRID         292         -406.37   -5.80  157.91
-GRID         293         -512.50   -5.80  150.06
-CLINE         21       4     284     285                   0.063   0.063
-CLINE         22       4     285     286                   0.063   0.063
-CLINE         23       4     286     287                   0.063   0.063
-CLINE         24       4     287     288                   0.063   0.063
-CLINE         25       4     289     290                   0.063   0.063
-CLINE         26       4     290     291                   0.063   0.063
-CLINE         27       4     291     292                   0.063   0.063
-CLINE         28       4     292     293                   0.063   0.063
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Fuel Lines
-$NAME          4       1                                Fuel Supply Line (Right Side)
-SECTION        4       1       1       1
-GRID          23         -378.88  -23.20   99.85
-GRID          24         -380.84  -28.57  144.05
-GRID          25         -428.13  -21.15  144.62
-GRID          26         -428.85  -24.92  136.29
-GRID          27         -427.79  -45.94  140.51
-CLINE          1      12      23      24                   0.035     0.5
-CLINE          2      12      24      25                   0.035     0.5
-CLINE          3      12      25      26                   0.035     0.5
-CLINE          4      12      26      27                   0.035     0.5
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          4       2                                Fuel Supply Line (Left Side)
-SECTION        4       2       1       1
-GRID          28         -378.88   23.20   99.85
-GRID          29         -380.84   28.57  144.05
-GRID          30         -428.13   21.15  144.62
-GRID          31         -428.85   24.92  136.29
-GRID          32         -427.79   45.94  140.51
-CLINE          5      12      28      29                   0.035     0.5
-CLINE          6      12      29      30                   0.035     0.5
-CLINE          7      12      30      31                   0.035     0.5
-CLINE          8      12      31      32                   0.035     0.5
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          4       3                                Fuel Motive Flow Line (Right Side)
-SECTION        4       3       1       1
-GRID          33         -378.82  -21.40   98.41
-GRID          34         -380.84  -26.92  143.90
-GRID          35         -428.20  -19.50  144.48
-GRID          36         -428.89  -24.34  133.86
-GRID          37         -427.77  -46.57  138.33
-CLINE          9      12      33      34                   0.035    0.25
-CLINE         10      12      34      35                   0.035    0.25
-CLINE         11      12      35      36                   0.035    0.25
-CLINE         12      12      36      37                   0.035    0.25
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          4       4                                Fuel Motive Flow Line (Left Side)
-SECTION        4       4       1       1
-GRID          38         -378.82   21.40   98.41
-GRID          39         -380.84   26.92  143.90
-GRID          40         -428.20   19.50  144.48
-GRID          41         -428.89   24.34  133.86
-GRID          42         -427.77   46.57  138.33
-CLINE         13      12      38      39                   0.035    0.25
-CLINE         14      12      39      40                   0.035    0.25
-CLINE         15      12      40      41                   0.035    0.25
-CLINE         16      12      41      42                   0.035    0.25
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Structure
-$NAME          7       1                                Left Forward Engine Beam (1st 2 outboard; 2nd 2 inboard)
-SECTION        7       1       1       1
-GRID          43         -421.50   45.35  142.87
-GRID          44         -421.50   46.64  137.80
-GRID          45         -421.50   31.04  138.79
-GRID          46         -421.50   32.33  133.72
-$COMMENT Forward Engine Beam, Back Side (1st 2 outboard; 2nd 2 inboard)
-GRID          47         -424.50   45.35  142.87
-GRID          48         -424.50   46.64  137.80
-GRID          49         -424.50   30.85  138.74
-GRID          50         -424.50   32.13  133.67
-CQUAD          1       8      49      45      43      47   0.190       1
-CQUAD          2       8      49      47      48      50   0.100       1
-CQUAD          3       8      44      46      50      48   0.190       1
-CQUAD          4       8      44      46      45      43   0.100       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7       2                                Forward Beam through fuselage
-SECTION        7       2       1       1
-GRID          45         -421.50   31.04  138.79
-GRID          46         -421.50   32.33  133.72
-GRID          61         -421.50  -31.04  138.79
-GRID          62         -421.50  -32.33  133.72
-GRID          49         -424.50   30.85  138.74
-GRID          50         -424.50   32.13  133.67
-GRID          65         -424.50  -30.85  138.74
-GRID          66         -424.50  -32.13  133.67
-CQUAD         17       8      45      46      62      61   0.100       1
-CQUAD         18       8      49      50      66      65   0.100       1
-CQUAD         19       8      45      49      65      61   0.190       1
-CQUAD         20       8      46      50      66      62   0.190       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7       3                                Right Forward Engine Beam (1st 2 outboard; 2nd 2 inboard)
-SECTION        7       3       1       1
-GRID          59         -421.50  -45.35  142.87
-GRID          60         -421.50  -46.64  137.80
-GRID          61         -421.50  -31.04  138.79
-GRID          62         -421.50  -32.33  133.72
-$COMMENT Forward Engine Beam, Back Side (1st 2 outboard; 2nd 2 inboard)
-GRID          63         -424.50  -45.35  142.87
-GRID          64         -424.50  -46.64  137.80
-GRID          65         -424.50  -30.85  138.74
-GRID          66         -424.50  -32.13  133.67
-CQUAD          9       8      65      61      59      63   0.190       1
-CQUAD         10       8      65      63      64      66   0.100       1
-CQUAD         11       8      60      62      66      64   0.190       1
-CQUAD         12       8      60      62      61      59   0.100       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      11                                Left Aft Engine Beam (1st 2 outboard; 2nd 2 inboard)
-SECTION        7      11       1       1
-GRID          51         -460.50   45.14  142.88
-GRID          52         -460.50   46.68  137.76
-GRID          53         -460.50   28.51  138.09
-GRID          54         -460.50   29.85  132.97
-$COMMENT Left Aft Engine Beam Back Side (1st 2 outboard; 2nd 2 inboard)
-GRID          55         -462.50   45.14  142.88
-GRID          56         -462.50   46.68  137.76
-GRID          57         -462.50   28.38  138.05
-GRID          58         -462.50   29.72  132.93
-CQUAD          5       8      57      53      51      55   0.160       1
-CQUAD          6       8      57      55      56      58   0.064       1
-CQUAD          7       8      52      54      58      56   0.100       1
-CQUAD          8       8      52      54      53      51   0.064       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      12                                Aft Engine Beam through fuselage
-SECTION        7      12       1       1
-GRID          53         -460.50   28.51  138.09
-GRID          54         -460.50   29.85  132.97
-GRID          57         -462.50   28.38  138.05
-GRID          58         -462.50   29.72  132.93
-GRID          69         -460.50  -28.51  138.09
-GRID          70         -460.50  -29.85  132.97
-GRID          73         -462.50  -28.38  138.05
-GRID          74         -462.50  -29.72  132.93
-CQUAD         21       8      53      54      70      69   0.064       1
-CQUAD         22       8      57      58      74      73   0.064       1
-CQUAD         23       8      53      57      73      69   0.160       1
-CQUAD         24       8      54      58      74      70   0.100       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      13                                Right Aft Engine Beam (1st 2 outboard; 2nd 2 inboard)
-SECTION        7      13       1       1
-GRID          67         -460.50  -45.14  142.88
-GRID          68         -460.50  -46.68  137.76
-GRID          69         -460.50  -28.51  138.09
-GRID          70         -460.50  -29.85  132.97
-$COMMENT Aft Engine Beam Back Side (1st 2 outboard; 2nd 2 inboard)
-GRID          71         -462.50  -45.14  142.88
-GRID          72         -462.50  -46.68  137.76
-GRID          73         -462.50  -28.38  138.05
-GRID          74         -462.50  -29.72  132.93
-CQUAD         13       8      73      69      67      71   0.160       1
-CQUAD         16       8      68      70      69      67   0.064       1
-CQUAD         14       8      73      71      72      74   0.064       1
-CQUAD         15       8      68      70      74      72   0.100       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$Frames
-$COMMENT  The number in parenthesis () is the actual location relative to the origin.
-$COMMENT  The other numbers are the numbers provided by the original source.
-$NAME          7      51                                Frame at FS 389.5
-SECTION        7      51       1       1
-GRID          75         -389.50   -0.00  127.25
-GRID          76         -390.25   -0.00  127.25
-CCONE1         5       8      75      76                   0.032  35.163C1
-C1        35.113       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      52                                Frame at FS 405.5
-SECTION        7      52       1       1
-GRID          77         -405.50   -0.00  127.25
-GRID          78         -406.25   -0.00  127.25
-CCONE1         6       8      77      78                   0.032  34.092C2
-C2        34.042       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      53                                Frame at FS 479.5
-SECTION        7      53       1       1
-GRID          79         -479.50   -0.00  127.25
-GRID          80         -480.25   -0.00  127.25
-CCONE1         7       8      79      80                   0.032  29.138C3
-C3        29.087       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      54                                Frame at FS 496.5
-SECTION        7      54       1       1
-GRID          81         -496.50   -0.00  127.25
-GRID          82         -497.25   -0.00  127.25
-CCONE1         8       8      81      82                   0.032   28.00C4
-C4         27.95       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      55                                Frame at FS 512.5
-SECTION        7      55       1       1
-GRID          83         -512.50   -0.00  127.25
-GRID          84         -513.25   -0.00  127.25
-CCONE1         9       8      83      84                   0.032  26.928C5
-C5        26.846       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Engine Beam Frames
-$NAME          7      61                                Frame at FS 420.75
-SECTION        7      61       1       1
-GRID          85         -420.75   -0.00  127.25
-GRID          86         -421.50   -0.00  127.25
-CCONE1        10       8      85      86                   0.032   33.07C6
-C6        33.021       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      62                                Frame at FS 424.5
-SECTION        7      62       1       1
-GRID          87         -424.50   -0.00  127.25
-GRID          88         -425.25   -0.00  127.25
-CCONE1        11       8      87      88                   0.032   32.82C7
-C7         32.77       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      63                                Frame at FS 459.75
-SECTION        7      63       1       1
-GRID          89         -459.75   -0.00  127.25
-GRID          90         -460.50   -0.00  127.25
-CCONE1        12       8      89      90                   0.032   30.46C8
-C8         30.41       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      64                                Frame at FS 462.5
-SECTION        7      64       1       1
-GRID          91         -462.50   -0.00  127.25
-GRID          92         -463.25   -0.00  127.25
-CCONE1        13       8      91      92                   0.032   30.28C9
-C9         30.23       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7      65                                Frame at FS 442.5
-$COMMENT (Missing frame--goes between the two engine beam frames)
-SECTION        7      65       1       1
-GRID          93         -442.50   -0.00  127.25
-GRID          94         -443.25   -0.00  127.25
-CCONE1        14       8      93      94                   0.032  31.615C10
-C10       31.565       1       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$COMMENT Stringers
-$NAME          7     101                                Stringer 1
-SECTION        7     101       1       1
-GRID          95         -373.75    0.75   91.13
-GRID          96         -373.75   -0.75   91.13
-GRID          97         -512.50    0.75  100.42
-GRID          98         -512.50   -0.75  100.42
-CQUAD         15      13      95      96      98      97   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     102                                Stringer 2
-SECTION        7     102       1       1
-GRID          99         -373.75    0.75  163.38
-GRID         100         -373.75   -0.75  163.38
-GRID         101         -512.50    0.75  154.09
-GRID         102         -512.50   -0.75  154.09
-CQUAD         16      13      99     100     102     101   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     103                                Stringer 3
-SECTION        7     103       1       1
-GRID         103         -373.75    6.00  162.51
-GRID         104         -373.75    7.49  162.24
-GRID         105         -512.50    4.25  153.47
-GRID         106         -512.50    5.72  153.17
-CQUAD         17      13     103     104     106     105   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     104                                Stringer 4
-SECTION        7     104       1       1
-GRID         107         -373.75   -6.00  162.51
-GRID         108         -373.75   -7.49  162.24
-GRID         109         -512.50   -4.25  153.47
-GRID         110         -512.50   -5.72  153.17
-CQUAD         18      13     107     108     110     109   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     105                                Stringer 5
-SECTION        7     105       1       1
-GRID         111         -373.75   12.78  160.63
-GRID         112         -373.75   14.11  160.05
-GRID         113         -512.50    9.22  152.04
-GRID         114         -512.50   10.61  151.47
-CQUAD         19      13     111     112     114     113   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     106                                Stringer 6
-SECTION        7     106       1       1
-GRID         115         -373.75  -12.78  160.63
-GRID         116         -373.75  -14.11  160.05
-GRID         117         -512.50   -9.22  152.04
-GRID         118         -512.50  -10.61  151.47
-CQUAD         20      13     115     116     118     117   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     107                                Stringer 7
-SECTION        7     107       1       1
-GRID         119         -373.75   19.11  157.41
-GRID         120         -373.75   20.36  156.57
-GRID         121         -512.50   13.95  149.68
-GRID         122         -512.50   15.20  148.85
-CQUAD         21      13     119     120     122     121   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     108                                Stringer 8
-SECTION        7     108       1       1
-GRID         123         -373.75  -19.12  157.41
-GRID         124         -373.75  -20.36  156.57
-GRID         125         -512.50  -13.95  149.68
-GRID         126         -512.50  -15.20  148.85
-CQUAD         22      13     123     124     126     125   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     109                                Stringer 9
-SECTION        7     109       1       1
-GRID         127         -373.75   24.70  153.01
-GRID         128         -373.75   25.76  151.95
-GRID         129         -512.50   18.13  146.44
-GRID         130         -512.50   19.19  145.38
-CQUAD         23      13     127     128     130     129   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     110                                Stringer 10
-SECTION        7     110       1       1
-GRID         131         -373.75  -24.70  153.01
-GRID         132         -373.75  -25.76  151.95
-GRID         133         -512.75  -18.13  146.44
-GRID         134         -512.75  -19.19  145.38
-CQUAD         24      13     131     132     134     133   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     111                                Stringer 11
-SECTION        7     111       1       1
-GRID         135         -373.75   29.32  147.61
-GRID         136         -373.75   30.16  146.37
-GRID         137         -512.50   21.60  142.45
-GRID         138         -512.50   22.43  141.20
-CQUAD         25      13     135     136     138     137   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     112                                Stringer 12
-SECTION        7     112       1       1
-GRID         139         -373.75  -29.32  147.61
-GRID         140         -373.75  -30.16  146.37
-GRID         141         -512.50  -21.60  142.45
-GRID         142         -512.50  -22.43  141.20
-CQUAD         26      13     139     140     142     141   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     113                                Stringer 13
-SECTION        7     113       1       1
-GRID         143         -373.75   32.80  141.41
-GRID         144         -373.75   33.38  140.03
-GRID         145         -512.50   24.22  137.86
-GRID         146         -512.50   24.79  136.47
-CQUAD         27      13     143     144     146     145   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     114                                Stringer 14
-SECTION        7     114       1       1
-GRID         147         -373.75  -32.80  141.41
-GRID         148         -373.75  -33.38  140.03
-GRID         149         -512.50  -24.22  137.86
-GRID         150         -512.50  -24.80  136.47
-CQUAD         28      13     147     148     150     149   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     115                                Stringer 15
-SECTION        7     115       1       1
-GRID         151         -373.75   35.01  134.66
-GRID         152         -373.75   35.30  133.19
-GRID         153         -512.50   25.90  132.85
-GRID         154         -512.50   26.19  131.37
-CQUAD         29      13     151     152     154     153   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     116                                Stringer 16
-SECTION        7     116       1       1
-GRID         155         -373.75  -35.01  134.66
-GRID         156         -373.75  -35.30  133.19
-GRID         157         -512.50  -25.90  132.85
-GRID         158         -512.50  -26.19  131.37
-CQUAD         30      13     155     156     158     157   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     117                                Stringer 17
-SECTION        7     117       1       1
-GRID         159         -373.75   35.85  127.60
-GRID         160         -373.75   35.85  126.10
-GRID         161         -512.50   26.56  127.60
-GRID         162         -512.50   26.56  126.10
-CQUAD         31      13     159     160     162     161   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     118                                Stringer 18
-SECTION        7     118       1       1
-GRID         163         -373.75  -35.85  127.60
-GRID         164         -373.75  -35.85  126.10
-GRID         165         -512.50  -26.56  127.60
-GRID         166         -512.50  -26.56  126.10
-CQUAD         32      13     163     164     166     165   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     119                                Stringer 19
-SECTION        7     119       1       1
-GRID         167         -373.75   35.30  121.31
-GRID         168         -373.75   35.01  119.84
-GRID         169         -512.50   26.19  123.13
-GRID         170         -512.50   25.90  121.65
-CQUAD         33      13     167     168     170     169   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     120                                Stringer 20
-SECTION        7     120       1       1
-GRID         171         -373.75  -35.30  121.31
-GRID         172         -373.75  -35.01  119.84
-GRID         173         -512.50  -26.19  123.13
-GRID         174         -512.50  -25.90  121.65
-CQUAD         34      13     171     172     174     173   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     121                                Stringer 21
-SECTION        7     121       1       1
-GRID         171         -373.75  -35.30  121.31
-GRID         172         -373.75  -35.01  119.84
-GRID         173         -512.50  -26.19  123.13
-GRID         174         -512.50  -25.90  121.65
-CQUAD         34      13     171     172     174     173   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     122                                Stringer 22
-SECTION        7     122       1       1
-GRID         175         -373.75   33.38  114.47
-GRID         176         -373.75   32.80  113.08
-GRID         177         -512.50   24.79  118.03
-GRID         178         -512.50   24.22  116.64
-CQUAD         35      13     175     176     178     177   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     123                                Stringer 23
-SECTION        7     123       1       1
-GRID         179         -373.75  -33.38  114.47
-GRID         180         -373.75  -32.80  113.08
-GRID         181         -512.50  -24.80  118.03
-GRID         182         -512.50  -24.22  116.64
-CQUAD         36      13     179     180     182     181   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     124                                Stringer 24
-SECTION        7     124       1       1
-GRID         183         -373.75   30.16  108.14
-GRID         184         -373.75   29.32  106.89
-GRID         185         -512.50   22.43  113.30
-GRID         186         -512.50   21.60  112.05
-CQUAD         37      13     183     184     186     185   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     125                                Stringer 25
-SECTION        7     125       1       1
-GRID         187         -373.75  -30.16  108.14
-GRID         188         -373.75  -29.32  106.89
-GRID         189         -512.50  -22.43  113.30
-GRID         190         -512.50  -21.60  112.05
-CQUAD         38      13     187     188     190     189   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     126                                Stringer 26
-SECTION        7     126       1       1
-GRID         191         -373.75   25.76  102.55
-GRID         192         -373.75   24.70  101.49
-GRID         193         -512.50   19.19  109.12
-GRID         194         -512.50   18.13  108.06
-CQUAD         39      13     191     192     194     193   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     127                                Stringer 27
-SECTION        7     127       1       1
-GRID         195         -373.75  -25.76  102.55
-GRID         196         -373.75  -24.70  101.49
-GRID         197         -512.50  -19.19  109.12
-GRID         198         -512.50  -18.13  108.06
-CQUAD         40      13     195     196     198     197   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     128                                Stringer 28
-SECTION        7     128       1       1
-GRID         199         -373.75   20.36   97.93
-GRID         200         -373.75   19.11   97.09
-GRID         201         -512.50   15.20  105.65
-GRID         202         -512.50   13.95  104.82
-CQUAD         41      13     199     200     202     201   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     129                                Stringer 29
-SECTION        7     129       1       1
-GRID         203         -373.75  -20.36   97.93
-GRID         204         -373.75  -19.12   97.09
-GRID         205         -512.50  -15.20  105.65
-GRID         206         -512.50  -13.95  104.82
-CQUAD         42      13     203     204     206     205   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     130                                Stringer 30
-SECTION        7     130       1       1
-GRID         207         -373.75   14.16   94.45
-GRID         208         -373.75   12.78   93.87
-GRID         209         -512.50   10.61  103.03
-GRID         210         -512.50    9.22  102.46
-CQUAD         43      13     207     208     210     209   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     131                                Stringer 31
-SECTION        7     131       1       1
-GRID         211         -373.75  -14.17   94.45
-GRID         212         -373.75  -12.78   93.87
-GRID         213         -512.50  -10.61  103.03
-GRID         214         -512.50   -9.22  102.46
-CQUAD         44      13     211     212     214     213   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     132                                Stringer 32
-SECTION        7     132       1       1
-GRID         215         -373.75    7.41   92.24
-GRID         216         -373.75    5.94   91.95
-GRID         217         -512.50    5.59  101.35
-GRID         218         -512.50    4.13  101.06
-CQUAD         45      13     215     216     218     217   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     133                                Stringer 33
-SECTION        7     133       1       1
-GRID         219         -373.75   -7.41   92.24
-GRID         220         -373.75   -5.94   91.95
-GRID         221         -512.50   -5.59  101.35
-GRID         222         -512.50   -4.13  101.06
-CQUAD         46      13     219     220     222     221   0.045       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     201                                Fairing Structure 1
-SECTION        7     201       1       1
-GRID         228         -389.50   29.69   78.52
-GRID         229         -389.50  -29.69   78.52
-GRID         230         -389.50   29.69  108.35
-GRID         231         -389.50  -29.69  108.35
-CQUAD         11       8     228     229     231     230   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     202                                Fairing Structure 2
-SECTION        7     202       1       1
-GRID         232         -405.50   25.83   81.35
-GRID         233         -405.50  -25.83   81.35
-GRID         234         -405.50   25.83  104.95
-GRID         235         -405.50  -25.83  104.95
-CQUAD         12       8     232     233     235     234   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     203                                Fairing Structure 3
-SECTION        7     203       1       1
-GRID         236         -423.00   21.61   84.44
-GRID         237         -423.00  -21.61   84.44
-GRID         238         -423.00   21.61  102.37
-GRID         239         -423.00  -21.61  102.37
-CQUAD         13       8     236     237     239     238   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     204                                Fairing Structure 4
-SECTION        7     204       1       1
-GRID         240         -442.50   16.90   87.89
-GRID         241         -442.50  -16.90   87.89
-GRID         242         -442.50   16.90  100.49
-GRID         243         -442.50  -16.90  100.49
-CQUAD         14       8     240     241     243     242   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     205                                Fairing Structure 5
-SECTION        7     205       1       1
-GRID         244         -461.50   12.31   91.25
-GRID         245         -461.50  -12.31   91.25
-GRID         246         -461.50   12.31   99.48
-GRID         247         -461.50  -12.31   99.48
-CQUAD         15       8     244     245     247     246   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     206                                Fairing Structure 6
-SECTION        7     206       1       1
-GRID         248         -479.50    7.97   94.43
-GRID         249         -479.50   -7.97   94.43
-GRID         250         -479.50    7.97   99.19
-GRID         251         -479.50   -7.97   99.19
-CQUAD         16       8     248     249     251     250   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     207                                Fairing Structure 7
-SECTION        7     207       1       1
-GRID         252         -496.50    3.86   97.44
-GRID         253         -496.50   -3.86   97.44
-GRID         254         -496.50    3.86   99.49
-GRID         255         -496.50   -3.86   99.49
-CQUAD         17       8     252     253     255     254   0.032       1
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-$NAME          7     501                                Pressure Bulkhead
-SECTION        7     501       2
-GRID         330         -373.25   -0.00  127.25
-GRID         331         -373.75   -0.00  127.25
-CCONE2        18       8     330     331                           36.25C106
-C106       36.25       0       0
-$COMMENT123456781234567812345678123456781234567812345678123456781234567812345678
-ENDDATA

db/faa/CMakeLists.txt

@@ -1,44 +0,0 @@
-set(FAA_SAMPLE_MODELS
-  Business_Jet.fg4
-  Generic_Twin.fg4
-  )
-
-macro(ADD_FAA_G_TARGET faa_model folder)
-  string(REGEX REPLACE "([0-9a-z]*).fg4" "\\1" faa_model_root "${faa_model}")
-  set(output_file ${bin_root}/${DATA_DIR}/db/${faa_model_root}.g)
-  set(log_file ${CMAKE_CURRENT_BINARY_DIR}/${faa_model_root}.log)
-  add_custom_command(
-    OUTPUT ${output_file}
-    COMMAND fast4-g ${CMAKE_CURRENT_SOURCE_DIR}/${faa_model} ${output_file} > ${log_file} 2>&1
-    DEPENDS fast4-g ${CMAKE_CURRENT_SOURCE_DIR}/${faa_model}
-  )
-  add_custom_target(${faa_model_root}.g ALL DEPENDS ${output_file})
-  set_target_properties(${faa_model_root}.g PROPERTIES FOLDER "${folder}")
-  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
-    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
-  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
-  set(LOG_FILES "${LOG_FILES};${log_file}")
-  DISTCLEAN(${log_file})
-endmacro(ADD_FAA_G_TARGET faa_model folder)
-
-foreach(faa_input ${FAA_SAMPLE_MODELS})
-  ADD_FAA_G_TARGET(${faa_input} "BRL-CAD Geometry Models/Sample")
-endforeach(faa_input ${FAA_SAMPLE_MODELS})
-CMAKEFILES(
-  ${FAA_SAMPLE_MODELS}
-  README
-  )
-
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${BUILT_MODELS}")
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${LOG_FILES}")
-
-# Local Variables:
-# tab-width: 8
-# mode: cmake
-# indent-tabs-mode: t
-# End:
-# ex: shiftwidth=2 tabstop=8

db/faa/README

@@ -1,8 +0,0 @@
-For example images of these models, see the report:
-
-Uncontained Engine Debris Analysis Using the Uncontained
-Engine Debris Damage Assessment Model
-DOT/FAA/AR-04/16
-Office of Aviation Research
-Washington, D.C. 20591
-http://www.tc.faa.gov/its/worldpac/techrpt/AR04-16.pdf

db/nist/CMakeLists.txt

@@ -1,111 +0,0 @@
-set(NIST_SAMPLE_STEP_MODELS
-  NIST_MBE_PMI_1.stp
-  NIST_MBE_PMI_2.stp
-  NIST_MBE_PMI_3.stp
-  NIST_MBE_PMI_4.stp
-  NIST_MBE_PMI_5.stp
-  NIST_MBE_PMI_6.stp
-  NIST_MBE_PMI_11.stp
-)
-set(NIST_SAMPLE_3DM_MODELS
-  NIST_MBE_PMI_7-10.3dm
-  )
-
-macro(ADD_NIST_STEP_TARGET step_model folder)
-  string(REGEX REPLACE "([0-9a-z]*).stp" "\\1" step_model_root "${step_model}")
-  set(output_file ${bin_root}/${DATA_DIR}/db/${step_model_root}.g)
-  set(log_file ${CMAKE_CURRENT_BINARY_DIR}/${step_model_root}.log)
-  add_custom_command(
-    OUTPUT ${output_file}
-    COMMAND step-g -O ${output_file} ${CMAKE_CURRENT_SOURCE_DIR}/${step_model} > ${log_file} 2>&1
-    DEPENDS step-g ${CMAKE_CURRENT_SOURCE_DIR}/${step_model}
-  )
-  add_custom_target(${step_model_root}.g ALL DEPENDS ${output_file})
-  set_target_properties(${step_model_root}.g PROPERTIES FOLDER "${folder}")
-  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
-    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
-  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
-  set(LOG_FILES "${LOG_FILES};${log_file}")
-  DISTCLEAN(${log_file})
-endmacro(ADD_NIST_STEP_TARGET step_model folder)
-
-# Get our root path
-if(CMAKE_CONFIGURATION_TYPES)
-  set(bin_root "${CMAKE_BINARY_DIR}/${CMAKE_CFG_INTDIR}")
-else(CMAKE_CONFIGURATION_TYPES)
-  set(bin_root "${CMAKE_BINARY_DIR}")
-endif(CMAKE_CONFIGURATION_TYPES)
-
-# The general pattern of the BRL-CAD build is to use CMAKE_CFG_INTDIR when
-# multi-configuration builds complicate the location of binaries.  In this
-# case, however, we are using a generated script with a different mechanism
-# for handling this situation, and we need to update the executable paths
-# accordingly if they are configuration dependent.
-if(CMAKE_CONFIGURATION_TYPES)
-  string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" rbin_root "${bin_root}")
-else(CMAKE_CONFIGURATION_TYPES)
-  set(rbin_root "${bin_root}")
-endif(CMAKE_CONFIGURATION_TYPES)
-
-# Use the CMake executable to figure out if we need an extension
-get_filename_component(EXE_EXT "${CMAKE_COMMAND}" EXT)
-
-
-macro(ADD_NIST_3DM_TARGET rhino_model folder)
-  set(CMD_EXEC ${rbin_root}/${BIN_DIR}/3dm-g${EXE_EXT})
-  string(REGEX REPLACE "([0-9a-z]*).3dm" "\\1" rhino_model_root "${rhino_model}")
-  set(output_file ${rbin_root}/${DATA_DIR}/db/${rhino_model_root}.g)
-  set(log_file ${CMAKE_CURRENT_BINARY_DIR}/${rhino_model_root}.log)
-  set(STDOUT_LOG "${log_file}")
-  set(STDERR_LOG "${log_file}")
-  set(CMD_ARGS "-o \"${output_file}\" \"${CMAKE_CURRENT_SOURCE_DIR}/${rhino_model}\"")
-  configure_file(${BRLCAD_CMAKE_DIR}/builddir_cmd.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/3dm-g.cmake @ONLY)
-  set(output_file ${bin_root}/${DATA_DIR}/db/${rhino_model_root}.g)
-  add_custom_command(
-    OUTPUT ${output_file}
-    COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/3dm-g.cmake
-    DEPENDS 3dm-g ${CMAKE_CURRENT_SOURCE_DIR}/${rhino_model}
-  )
-  add_custom_target(${rhino_model_root}.g ALL DEPENDS ${output_file})
-  set_target_properties(${rhino_model_root}.g PROPERTIES FOLDER "${folder}")
-  if(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-    if(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-      string(REPLACE "${CMAKE_CFG_INTDIR}" "\${BUILD_TYPE}" output_file "${output_file}")
-    endif(NOT "${CMAKE_CFG_INTDIR}" STREQUAL "." AND CMAKE_CONFIGURATION_FILES)
-    install(FILES ${output_file} DESTINATION ${DATA_DIR}/db)
-  endif(BRLCAD_INSTALL_EXAMPLE_GEOMETRY)
-  set(BUILT_MODELS "${BUILT_MODELS};${output_file}")
-  set(LOG_FILES "${LOG_FILES};${log_file}")
-  DISTCLEAN(${log_file})
-endmacro(ADD_NIST_3DM_TARGET rhino_model folder)
-
-
-foreach(step_input ${NIST_SAMPLE_STEP_MODELS})
-  ADD_NIST_STEP_TARGET(${step_input} "BRL-CAD Geometry Models/Sample")
-endforeach(step_input ${NIST_SAMPLE_STEP_MODELS})
-CMAKEFILES(${NIST_SAMPLE_STEP_MODELS})
-
-foreach(rhino_input ${NIST_SAMPLE_3DM_MODELS})
-  ADD_NIST_3DM_TARGET(${rhino_input} "BRL-CAD Geometry Models/Sample")
-endforeach(rhino_input ${NIST_SAMPLE_3DM_MODELS})
-CMAKEFILES(${NIST_SAMPLE_3DM_MODELS})
-
-
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${BUILT_MODELS}")
-set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${LOG_FILES}")
-
-CMAKEFILES(
-  README
-  pdf
-)
-
-# Local Variables:
-# tab-width: 8
-# mode: cmake
-# indent-tabs-mode: t
-# End:
-# ex: shiftwidth=2 tabstop=8

db/nist/README

@@ -1,37 +0,0 @@
-December 2014:
-
-The files in this directory are conversions of the NIST MBE PMI test models
-into the AP203 file format.  These conversions are also in the public domain.
-
-Originals are from http://www.nist.gov/el/msid/infotest/mbe-pmi-validation.cfm
-
-Models 7 through 10 have been assembled into a single file, guided by the example
-PDF provided with the original NIST data set.
-
-            MBE PMI Validation and Conformance Testing Models
-
-NIST has created a Test System to measure conformance of Computer-Aided Design
-(CAD) to American Society of Mechanical Engineers (ASME) standards for Product
-and Manufacturing Information (PMI), specifically geometric dimensioning and
-tolerancing (GD&T) information.
-
-As part of this Test System, CAD Models were prepared.
-
-For problems or questions about the MBE PMI CAD Models, contact: Robert Lipman
-
-Dataset 1 First Release:  December 2013
-Dataset 1 Update Release: December 2014  (Note: Dataset 1 files currently in
-                                          BRL-CAD repo are based off of the
-                                          2013 version.)
-Dataset 2 First Release:  June 2015
-
-These files were developed at the National Institute of Standards and
-Technology by employees of the Federal Government in the course of their
-official duties. Pursuant to Title 17 Section 105 of the United States Code
-these files are not subject to copyright protection and are in the public
-domain. These files are an experimental system. NIST assumes no responsibility
-whatsoever for their use by other parties, and makes no guarantees, expressed
-or implied, about their quality, reliability, or any other characteristic.
-
-Any mention of commercial products is for information only; it does not imply
-recommendation or endorsement by NIST.

doc/BRL-CAD.bib

@@ -2,6 +2,9 @@
 %
 % This file contains bibliographic information pertaining to BRL-CAD.
 %
+% To be added:
+% http://www.arl.army.mil/arlreports/2001/ARL-TR-2396.pdf
+%
 %%%
 
 
@@ -55,7 +58,6 @@
   number = {V5S10A04},
   pages = {pp. 1-12},
   address = {Aberdeen Proving Ground, Maryland 21005-5066},
-  note = {Reprinted by ARL in 2013 as ARL-RP-429.}
   owner = {cyapp},
   timestamp = {2008.02.05}
 }
@@ -63,7 +65,7 @@
 @TECHREPORT{Muuss87b,
   author = {Muuss, Michael John and Dykstra, P. and Applin, K. and Moss, G. and Davisson, E. and Stay, P. and Kennedy, C.},
   title = {Ballistic Research Laboratory CAD Package, Release 1.21},
-  publisher = {The U.S. Army Ballistic Research Laboratory},
+  publisher = "The U.S. Army Ballistic Research Laboratory},
   year = {1987},
   month = {June},
   address = {Aberdeen Proving Ground, Maryland 21005-5066},
@@ -348,9 +350,8 @@
   pages = {pp. 1-5},
   address = {Aberdeen Proving Ground, Maryland 21005-5066},
   month = {November},
-  note = {Reprinted by ARL in 2013 as ARL-RP-428.}
-  owner = {morrison},
-  timestamp = {2015.11.19}
+  owner = {cyapp},
+  timestamp = {2008.02.05}
 }
 
 @INCOLLECTION{Stiller88a,
@@ -639,20 +640,6 @@
   timestamp = {2008.02.05}
 }
 
-@PROCEEDING{doi:10.1117/12.960423,
-author = {Jones, J. and Gonda, T.},
-title = {A Thermal Model Preprocessor For Graphics And Material Database Generation},
-journal = {Proc. SPIE},
-volume = {1098},
-number = {},
-pages = {42-54},
-abstract = {The process of developing a physical description of a target for thermal models is a time consuming and tedious task. The problem is one of data collection, data manipulation, and data storage. Information on targets can come from many sources and therefore could be in any form (2-D drawings, 3-D wireframe or solid model representations, etc.). TACOM has developed a preprocessor that decreases the time involved in creating a faceted target representation. This program allows the user to create the graphics for the vehicle and to assign the material properties to the graphics. The vehicle description file is then automatically generated by the preprocessor. By containing all the information in one database, the modeling process is made more accurate and data tracing can be done easily. A bridge to convert other graphics packages (such as BRL-CAD) to a faceted representation is being developed. When the bridge is finished, this preprocessor will be used to manipulate the converted data.},
-year = {1989},
-doi = {10.1117/12.960423},
-URL = { http://dx.doi.org/10.1117/12.960423},
-eprint = {}
-}
-
 @INCOLLECTION{Deitz90b,
   author = {Deitz, Paul H.},
   title = {High-Resolution, Item-Level Weapons Modeling},
@@ -884,9 +871,8 @@ eprint = {}
   number = {V1S03A00},
   pages = {pp. 1-9},
   address = {Aberdeen Proving Ground, Maryland 21005-5066},
-  note = {Reprinted by ARL in 2013 as ARL-RP-432.}
-  owner = {morrison},
-  timestamp = {2015.11.19}
+  owner = {cyapp},
+  timestamp = {2008.02.05}
 }
 
 @INPROCEEDINGS{Eberius91a,
@@ -1639,19 +1625,6 @@ eprint = {}
   timestamp = {2010.02.23}
 }
 
-@TECHREPORT{Kunkel01,
-  author = {Kunkel, Robert W., Jr. and Anderson, John R.},
-  title = {Conversion Process of a Ballistic Research Laboratory Computer-Aided Design (BRL-CAD) Model to a Panelized Surface Model (PSM)},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2001},
-  month = {February},
-  number = {ARL-TR-2396},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release; Distribution is Unlimited.},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
 @INPROCEEDINGS{Keyser02a,
   author = {Keyser, John and Culver, Tim and Foskey, Mark and Krishnan, Shankar
 	and Manocha, Dinesh},
@@ -1811,7 +1784,8 @@ eprint = {}
   author = {Tabary, Joachim and Hugonnard, Patrick and Mathy, Francoise},
   title = {SINDBAD : a realistic multi-purpose and scalable X-ray simulation
 	tool for NDT applications},
-  booktitle = {Proceedings DIR 2007 - International Symposium on Digital industrial Radiology and Computed Tomography},
+  booktitle = {Proceedings DIR 2007 - International Symposium on Digital industrial
+	Radiology and Computed Tomography},
   year = {2007},
   month = {June},
   note = {http://www.ndt.net/article/dir2007/papers/s4.pdf},
@@ -1819,23 +1793,11 @@ eprint = {}
   timestamp = {2008.02.08}
 }
 
-@TECHREPORT{Mallory07,
-  author = {Mallory, Timothy},
-  title = {A 3-D Scanning Technique for Determining Fragment Shape Factor},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2007},
-  month = {July},
-  number = {ARL-TR-4183},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Distribution authorized to the Department of Defense and U.S. DOD contractors only; critical technology (July 2007).  Other requests for this document shall be referred to Director,	U.S. Army Research Laboratory, ATTN: AMSRD-ARL-SL-BM, Aberdeen Proving Ground, MD 21005-5068.},
-  owner = {morrison},
-  timestamp = {2015.12.16}
-}
-
 @TECHREPORT{Yapp09a,
   author = {Yapp, Clifford},
   title = {Interactive Raytracing: The nirt Command},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
+  institution = {United States Army, Army Research Laboratory, Survivability/Lethality
+	Analysis Directorate},
   year = {2009},
   month = {April},
   number = {ARL-CR-624},
@@ -1848,7 +1810,8 @@ eprint = {}
 @TECHREPORT{Yapp09b,
   author = {Yapp, Clifford},
   title = {Vehicle Tire and Wheel Creation in BRL-CAD},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
+  institution = {United States Army, Army Research Laboratory, Survivability/Lethality
+	Analysis Directorate},
   year = {2009},
   month = {April},
   number = {ARL-CR-625},
@@ -1887,152 +1850,6 @@ eprint = {}
   timestamp = {2010.02.23}
 }
 
-@TECHREPORT{Yapp12,
-  author = {Yapp, Clifford},
-  title = {Generating Coils in BRL-CAD},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2012},
-  month = {April},
-  number = {ARL-CR-691},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2012/ARL-CR-691.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Muuss13,
-  author = {Muuss, Michael John},
-  title = {RT \& REMRT Shared Memory Parallel and Network Distributed Ray-Tracing Programs},
-  institution = {United States Army, Army Research Laboratory},
-  year = {2013},
-  month = {April},
-  number = {ARL-RP-429},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2013/ARL-RP-429.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-  note = {This is a reprint from the Fourth USENIX Computer Graphics Workshop, Cambridge, MA, 9 Oct 1987.}
-}
-
-@TECHREPORT{Stay13,
-  author = {Stay, Paul R.},
-  title = {The Definition and Ray-Tracing of B-Spline Objects in a Combinatorial Solid Geometric Modeling System},
-  institution = {United States Army, Army Research Laboratory},
-  year = {2013},
-  month = {April},
-  number = {ARL-RP-428},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2013/ARL-RP-428.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-  note = {This is a reprint from the Fourth USENIX Computer Graphics Workshop, Cambridge, MA, 9 Oct 1987.}
-}
-
-@TECHREPORT{Dykstra13,
-  author = {Dykstra, Phillip C.},
-  title = {The BRL-CAD Package - An Overview},
-  institution = {United States Army, Army Research Laboratory},
-  year = {2013},
-  month = {April},
-  number = {ARL-RP-432},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2013/ARL-RP-432.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-  note = {This is a reprint from the Fourth USENIX Computer Graphics Workshop, Cambridge, MA, 9 Oct 1987.}
-}
-
-@TECHREPORT{Yapp13,
-  author = {Yapp, Clifford W.},
-  title = {The BRL-CAD CMake Build System - An Overview},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2013},
-  month = {June},
-  number = {ARL-TR-6475},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2013/ARL-TR-6475.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Ranawake15,
-  author = {Ranawake, Charith},
-  title = {The Verification and Validation of the Ray-tracing of Bag of Triangles (BoTs)},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {February},
-  number = {ARL-CR-0761},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-CR-0761.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Jain15,
-  author = {Jain, Rishub},
-  title = {Converting Between PLY and Ballistic Research Laboratory Computer-Aided Design (BRL-CAD) Formats},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {February},
-  number = {ARL-CR-0760},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited..  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-CR-0760.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Roberts15,
-  author = {Roberts, Mitchell},
-  title = {Comprehensive BRL-CAD Primitive Database},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {March},
-  number = {ARL-CR-0764},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-CR-0764.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Nichols15,
-  author = {Nichols, Steven J.},
-  title = {Uniform Tests of File Converters Using Unit Cubes},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {March},
-  number = {ARL-CR-0770},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-CR-0770.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Butler15,
-  author = {Butler, Lee A. and Yapp, Clifford},
-  title = {Adaptive Geometry Shader Tessellation for Massive Geometry Display},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {March},
-  number = {ARL-SR-0312},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-SR-0312.pdf},
-  owner = {morrison},
-  timestamp = {2015.11.19}
-}
-
-@TECHREPORT{Yapp15,
-  author = {Yapp, Clifford},
-  title = {An Investigation into Conversion from Non-Uniform Rational B-Spline Boundary Representation Geometry to Constructive Solid Geometry},
-  institution = {United States Army, Army Research Laboratory, Survivability/Lethality Analysis Directorate},
-  year = {2015},
-  month = {December},
-  number = {ARL-SR-0347},
-  address = {Army Research Laboratory, Aberdeen Proving Ground, MD 21005-5068},
-  note = {Approved for Public Release, distribution unlimited.  Available online:  http://www.arl.army.mil/arlreports/2015/ARL-SR-0347.pdf},
-  owner = {morrison},
-  timestamp = {2015.12.01}
-}
-
 @comment{jabref-meta: selector_journal:}
 
 @comment{jabref-meta: selector_author:}

doc/CMakeLists.txt

@@ -1,13 +1,11 @@
 if(BRLCAD_EXTRADOCS)
-  verbose_add_subdirectory(doc docbook)
+  add_subdirectory(docbook)
 else(BRLCAD_EXTRADOCS)
   CMAKEFILES(docbook)
 endif(BRLCAD_EXTRADOCS)
 
-verbose_add_subdirectory(doc html)
-verbose_add_subdirectory(doc legal)
-
-CMAKEFILES(parsers)
+add_subdirectory(html)
+add_subdirectory(legal)
 
 set(documentation_DATA
   IDEAS
@@ -25,12 +23,12 @@ set(documentation_DATA
   anim.txt
   archer_ack.txt
   benchmark.tr
+  bison_to_lemon.txt
   brep.txt
   BRL-CAD.bib
-  code_review.txt
   cvs.txt
   description.txt
-  editors.txt
+  flex_to_re2c.txt
   ged.tr
   history.txt
   hypot.txt
@@ -218,17 +216,14 @@ set(documentation_mged_old_DATA
   )
 ADD_DOC(documentation_mged_old_DATA mged_old)
 
-configure_file(pad_file.xml.in "${CMAKE_CURRENT_BINARY_DIR}/pad_file.xml" @ONLY)
-install(FILES "${CMAKE_CURRENT_BINARY_DIR}/pad_file.xml" DESTINATION ${DOC_DIR})
+configure_file(pad_file.xml.in ${CMAKE_CURRENT_BINARY_DIR}/pad_file.xml @ONLY)
+install(FILES ${CMAKE_CURRENT_BINARY_DIR}/pad_file.xml DESTINATION ${DOC_DIR})
 
 CMAKEFILES(
-  README.OSCON-2014
   STARTERS
-  STRATEGY
-  csv_to_comgeom.txt
+  burst
   implicit_constraints.txt
   pad_file.xml.in
-  trunk_hierarchy.org
   )
 
 # Local Variables:

doc/IDEAS

@@ -29,17 +29,6 @@ familiar with the project.
 
 * Implement one of the items listed on the request for enhancements tracker
 
---
-There are lots of possible non-coding tasks:
-
-* Write documentation
-* Improve the website
-* Offer to help with art and design
-* Engage in discussions
-* Write design docs
-* Update roadmap
-* Answer questions, be helpful
-* Give a presentation on some topic
 
 ---
 There may be more tasks and ideas available in the Tasks section of

doc/PROJECTS

@@ -79,7 +79,7 @@ available to receive files as well as for the evaluation of raw
 throughput performance of the network connection between the two
 systems.  TTCP includes support for sourcing to/from memory, variable
 packet sizes, and loading metrics.  TTCP is described as a standard
-testing tool for TCP implementers via Network Working Group RFC 2398.
+testing tool for TCP implementors via Network Working Group RFC 2398.
 
 = Geometry Modeling Kernel =
 

doc/README.Linux

@@ -56,7 +56,7 @@ Following the build instructions in the INSTALL file.  You will need:
 gcc (3+, e.g. 4.0.3)
 g++ (3+, e.g. 4.0.3)
 make (e.g. gnu make 3.8.0)
-cmake (2.8.8 or newer)
+cmake (2.8.3 or newer)
 
 All three of those have implicit dependencies on other packages.
 
@@ -98,7 +98,7 @@ libXext-devel
 libXi-devel
 freetype-devel
 fontconfig-devel
-mesa-libGL-devel
+
 
 To determine what particular version of Redhat or Fedora you are
 using, check these files:

doc/README.MacOSX

@@ -85,13 +85,6 @@ non-parallel build will still succeed.  Another workaround is to build
 just subdirectories (e.g. src/other, doc, etc.) individually and then
 do a toplevel make in non-parallel mode to finalize the build.
 
-OpenSceneGraph and OSX
-----------------------
-For 32bit OSX builds of an X11+OpenSceneGraph BRL-CAD:
-cmake .. -DBRLCAD_BUNDLED_LIBS=BUNDLED -DBRLCAD_ENABLE_OSG=ON
--DBRLCAD_REGEX=SYSTEM -DBRLCAD_WORD_SIZE=32BIT -DOSG_WINDOWING_SYSTEM=X11
-
-
 Tips
 ----
 
@@ -104,6 +97,6 @@ uname -a
 Bugs
 ----
 The only known bugs specific to Mac OS X are limitations of Tk or the
-X11 event handler that are generally outside of BRL-CAD's domain.
+X11 event handler that our generally outside of BRL-CAD's domain.
 Refer to BUGS for more general details on known bugs and reporting
 mechanisms.

doc/README.OSCON-2014

@@ -1,53 +0,0 @@
-BRL-CAD:  A Vibrant Open Source Model
-
-+ intro
-
-  - speaker
-
-  - old vs. new (Rurel's joke about old farmer and his young farmhand)
-
-+ overview
-
-  - history, players
-
-     Mike Muuss [author of ping]
-
-  - license
-
-  - languages (Ohloh stats)
-
-+ important technical features
-
-  - database format
-
-  - tools
-
-  - libraries
-
-  - use of other FOSS libraries
-
-  - road map
-
-+ other features
-
-+ community
-
-  - players (Ohloh stats)
-
-+ process
-
-  - Source Forge
-
-  - API changes
-
-  - deprecation policy
-
-  - release procedures
-
-  - version control
-
-  - bug tracking
-
-- policy
-
-- outreach

doc/README.Windows

@@ -3,17 +3,14 @@ BRL-CAD on Windows README
 
 The usual way to build BRL-CAD for Windows is to use the CMake build
 system generator and the Microsoft Visual Studio C++ (MSVC) compiler.
-Recent versions of both (as of this writing, MSVC 2013 and CMake
-2.8.12+) are recommended.  If generating an installer, the Nullsoft
+Recent versions of both (as of this writing, MSVC 2010 and CMake
+2.8.6+) are recommended.  If generating an installer, the Nullsoft
 Scriptable Install System (NSIS) tool is also required.
 
 In principle, BRL-CAD can be built using CMake and environments like
 Cygwin and/or Mingw/Msys, but the is largely untested and infrequently
 supported.  Enhancements or bug reports are welcome.
 
-Visual Studio
--------------
-
 To build with CMake and Visual Studio, the first step is to obtain the
 BRL-CAD sources and create a build directory.  In principle, it is not
 *required* to have a separate build directory, but with Windows and
@@ -46,22 +43,3 @@ ALL_BUILD.  Start compiling that target.
 Once compilation is successfully complete, you may want to produce an
 NSIS installer.  If so, locate a target named PACKAGE and run it.  The
 end result should be an .exe file capable of installing BRL-CAD.
-
-MINGW (WORK IN PROGRESS - THIS DOES NOT YET WORK!!!)
------
-
-After installing the MINGW system, set up as follows:
-
-set path=%path%;"C:\Program Files (x86)\CMake\bin"
-set path=%path%;C:\MinGW\bin
-
-now make a build directory, and run CMake:
-
-cmake ..\brlcad -G "MinGW Makefiles" -DBRLCAD_BUNDLED_LIBS=BUNDLED
-
-mingw32-make
-
-Note that you don't want to do this from an msys prompt that has
-sh in the path.  (ConEmu can make using the standard Windows command
-prompt a bit more tolerable:  http://conemu.github.io)
-

doc/STRATEGY

@@ -1,323 +0,0 @@
-					 # -*- mode: org; coding: utf-8; -*- #
-# This is an Emacs org-mode file.  Keybindings: http://orgmode.org/orgcard.txt
-
-# +TAGS: { UX : U u } { Complex : C c }
-# +TAGS: { Comms : P p } { Market : M m }
-
-BRL-CAD Development Strategy
-
-This is a living document that defines and aims to help maintain a
-consistent develpment strategy for addressing BRL-CAD requirements.
-It recognizes areas of strategic importance, outlines projects to
-bolster those areas, and identifies specific actionable objectives.
-
-
-* Strategic Areas
-
-  This section itemizes areas of strategic importance which coincide
-  closely with areas of categoric deficiency.  For each area, we
-  outline general activities that could strengthen them.  From these
-  areas, we conceive strategic projects and their associated tasks.
-
-** AREA 1: UX                                                            :UX:
-*** deploying Archer/MGED -cns                                          :p:C:
-*** UI simplification -s                                                  :C:
-*** undo / fault tolerance -n
-*** prototype Qt -c                                                       :p:
-*** UI design / clarification -j                                        :P:C:
-*** interaction / integration -j                                          :M:
-*** editing constraints, snapping, reuse existing coordinates
-*** bug reporting / feature requests                                      :P:
-*** portability                                                           :p:
-
-** AREA 2: Complexity                                               :Complex:
-*** command / tool reduction -cjns                                        :U:
-*** API code reduce / simplification / modularity -cjs                    :U:
-*** searchability / info -n                                             :U:p:
-*** discoverability / documentation (UP)                                :U:P:
-*** UI design / clarity (UP)
-*** restructure of file hierarchy
-*** continuous integration
-
-** AREA 3: Communications                                             :Comms:
-*** website -cjns                                                         :C:
-*** doc integration, website -cjns                                        :C:
-*** new content (audience / customer profiles), website                   :C:
-*** comms (meeting / promoting our successes / PRB / announcements)   :U:C:M:
-*** CRM / IRC                                                           :U:C:
-*** leverage existing capability
-
-** AREA 4: Marketability                                             :Market:
-   
-   FIXME: these need to be sorted and ranked
-
-*** conversion: import, processing, export -s                           :P:U:
-*** geometry analysis performance (interactive ray tracing / opencl)      :U:
-*** 3D printing / polygonal export / gcode -s                           :P:U:
-*** industrial design: blueprinting, dimensioning, annotations          :P:U:
-*** geometry preparation (killing overlaps, hierarchy, V&V)             :U:C:
-*** visuals: advanced rendering, animation, simulation                  :P:U:
-
-* Strategic Projects
-
-  This section itemizes projects conceived to address BRL-CAD's
-  principal strategic areas.  Each project focuses on one or more
-  strategic areas devising measurable tasks that support the
-  particular objective.
-
-
-** PROJECT: Deploy Archer/MGED Beta (14)
-
-*** interactivity / blocking indicators - ALPHA (3)
-**** TODO multithreaded command execution (2)
-**** TODO interface busy indicator (1)
-
-*** command cleanup - ALPHA (3)
-**** TODO inventory + mapping + time (1)
-**** TODO design UI / commands (2)
-**** TODO sit with users to discuss command migration (0)
-
-*** feature parity - ALPHA (2)
-**** TODO review/finish edit keypointing (oed parity) (1)
-**** TODO GUI matrix editing (1)
-    
-*** announcements + migration plan - BETA+ (4)
-**** TODO write + publish strategy map and migration plan (1)
-**** TODO preliminary discussion with users, discuss tcl scripts (0)
-**** TODO archer manual page (1)
-**** TODO install basic version of new website (1)
-**** TODO sit down review with users (1)
-
-*** searchable docs - ALPHA (2)
-**** TODO command line searching of doc content, apropos (2)
-
-
-** PROJECT: Deploy Merged Archer/MGED Final (16)
-
-*** usability parity - BETA (4)
-**** TODO classic console mode (1)
-**** TODO map from old to new, publish summary (1)
-**** TODO reverse .g tempfile backup, edit live (1)
-**** TODO graphical query ray (1)
-
-*** undo - BETA (2)
-**** TODO implement libbu filesystem info (1)
-**** TODO re-enable undo with fs awareness (1)
-
-*** bug reporting / feedback / metrics - BETA (3)
-**** TODO reliable backtrace (1)
-**** TODO hook/enable bombardier (1)
-**** TODO track metrics (archer commands, tips, docs) (1)
-
-*** QA acceptance - BETA (3)
-**** TODO define acceptance tasks (1)
-**** TODO run regression w/ archer (1)
-**** TODO make wiki procedural web scripts work (1)
-
-*** announcements + migration plan - BETA+ (3)
-**** TODO review + update tutorials and docs (2)
-**** TODO create + give presentation (1)
-
-*** searchable docs - FINAL (1)
-**** TODO web publishing + searching of docs (1)
-
-
-** PROJECT: Distilling BRL-CAD (11)
-
-*** revisit scope (vision, mission) (3)
-**** TODO communicate intent and updates (1)
-**** TODO develop high-level project roadmap (1)
-**** TODO connect features to markets (1)
-
-*** develop command roadmap (4)
-**** TODO inventory of command-line commands, decide keep/refactor/kill (1)
-**** TODO communicate command-line changes (0)
-**** TODO develop command categorization (1)
-**** TODO take inventory of ged commands, decide keep/refactor/kill (1)
-**** TODO communicate ged command changes (0)
-**** TODO assess and mitigate deployment risks (1)
-
-*** integrate docs (4)
-**** TODO plan what to do with html+troff docs (0)
-**** TODO stub new docs where missing (1)
-**** TODO consolidate docs, one guide per interface (2)
-**** TODO kill obsolete docs (0)
-**** TODO migrate e-mail and release notes to web (1)
-
-
-** PROJECT: Website Renovation (10)
-
-*** improve website usability (1)
-**** TODO set up platform-detected downloads on main page (0)
-**** TODO publish project vitality/stats (openhub integration) (0)
-**** TODO restore search interface (1)
-
-*** publish docbook docs (3)
-**** TODO instantiate / set up sofat's doc interface (1)
-**** TODO design pdf stylesheet (1)
-**** TODO integrate docs onto website (html+pdf) (1)
-
-*** publish use cases (3)
-**** TODO post 3+ customer profiles (1)
-**** TODO post top-10 feature highlights (1)
-**** TODO identify alternatives and their highlight mappings (1)
-**** TODO post comparison table with 2+ alternatives (0)
-
-*** set up developer corner (3)
-**** TODO ensure buildbot is setup and running handsfree (1)
-**** TODO update buildbot stylesheet to fit theme (0)
-**** TODO post nightly builds (0)
-**** TODO set up cron job to maintain CI and doc updates (1)
-**** TODO announce dev corner to brlcad-devel/brlcad-news (0)
-**** TODO buildbot <-> cdash/lcov/coverity/gccfarm/swamp integration (1)
-
-
-** PROJECT: Deploy GCV (9)
-
-*** 3dm "round-tripping" (2)
-**** TODO integrate existing importer (0)
-**** TODO NURBS export support (1)
-**** TODO document entity support (1)
-
-*** documentation (3)
-**** TODO convert jon's write-up to docbook (0)
-**** TODO integrate jon's plugin examples (1)
-**** TODO write and publish plugin API policy (1)
-**** TODO write and publish GCV feature profile on website (1)
-
-*** CLI usability (2)
-**** TODO design usage / synopsis (1)
-**** TODO provide logging/debugging interface (0)
-**** TODO integrate bot_dump into gcv (1)
-
-*** robust deployment (2)
-**** TODO convert tlib via automated testing (1)
-**** TODO automate extraction of sources from checkout (0)
-**** TODO integrate gcv into mged/archer (0)
-**** TODO troubleshoot JASP export memory issue (1)
-
-
-** PROJECT: Performant Pipeline (15)
-
-*** coherent Boolean evaluation (3)
-**** TODO preliminary OpenCL conversion (1)
-**** TODO eliminate branching (1)
-**** TODO V&V with specific test cases (1)
-
-*** audit ray dispatching (3)
-**** TODO define ray bundling API (1)
-**** TODO audit librt ray API, consolidate (1)
-
-*** implement bundled ray dispatch (2)
-**** TODO integrate Costa's GSoC work (1)
-**** TODO propagate bundle through spatial partition (1)
-**** TODO convert rt* to new bundled API (1)
-
-*** on-demand NURBS tree-build (4)
-**** TODO formulate a design / approach (1)
-**** TODO dynamic tree build with minimal malloc (2)
-**** TODO profile and validate results (1)
-
-*** coherent NURBS evaluation (1)
-**** TODO review 2006 paper (0)
-**** TODO convert openNURBS surface evaluation to OpenCL (1)
-
-*** performant raytrace image display (2)
-**** TODO optimize libdb/libfb to remove bottleneck (1)
-**** TODO update archer for interactive tracing display (1)
-
-
-** PROJECT: Raytrace Prep Caching (10)
-
-*** implement LIBBU data caching (3)
-**** TODO document libbu data caching API (1)
-**** TODO create data caching test cases (1)
-**** TODO implement libbu data caching (1)
-
-*** implment LIBRT object caching (4)
-**** TODO serialize BoT prep data to cache (1)
-**** TODO serialize NURBS prep data to cache (1)
-**** TODO serialize tess/plot data to cache (2)
-
-*** update tools to utilize the cache (3)
-**** TODO update rt* to use prep cache (1)
-**** TODO update mged/archer to use tess/plot cache (1)
-**** TODO document the prep cache interface (1)
-
-
-** PROJECT: Progressive Geometry Display (11)
-
-*** asynchronous geometry display (4)
-**** TODO modify display loop to run in separate thread (2)
-**** TODO update draw command to dispatch (2)
-
-*** ray trace display manager (4)
-**** TODO review rtgl code (1)
-**** TODO design incremental loading architecture (1)
-**** TODO implement incremental ray tracing (2)
-
-*** point cloud hashing (3)
-**** TODO design LoD point cloud storage approach (1)
-**** TODO calculate LoD point cloud utility metric (1)
-**** TODO implement LoD point cloud loading (3)
-
-
-** TEMPLATE: Project Title
-
-   Here is an example project that summarizes the taxonomy and
-   structure of a strategic project.  A project should be scoped to
-   less than 4 months of full-time uninterrupted effort.  A project
-   must have at least 1 objective.
-
-*** objective
-
-    Objectives should be simple with identifiable completion criteria.
-    An objective should be achievable in 4 weeks or less with larger
-    objectives divided into separate smaller chunks.  Each objective
-    must have at least 1 task.
-
-**** TODO task
-
-     A task is actionable work that should take someone 4 weeks or
-     less of full-time uninterrupted effort, estimated in weeks, with
-     0 for tasks less than 2 days.
-
-
-* Strategic Strengths
-** project
-*** open source
-*** cross-platform
-*** free software
-*** 30-years of development
-*** massive investment
-*** extensive API
-*** extensive documentation
-** code
-*** extensively modular
-*** scalability
-*** embeddable
-*** efficient workflow
-*** flexible workflow
-*** DoD-accreddited
-*** integrated into MUVES, AJEM, COVART
-** modeling
-*** hybrid representation system
-*** wide variety of supported entities
-*** csg, nurbs, triangles, volumes, point clouds
-*** scriptable geometry
-*** procedural geometry
-*** geometry conversion
-*** geometry editing
-** analysis
-*** geometry v&v
-*** geometry preparation
-*** joint articulation system
-*** physics simulation system
-*** ray tracing performance
-*** analytic ray tracing
-*** solid ray tracing
-*** geometry visualization
-
-# Local Variables:
-# mode: org
-# End:

doc/burst/Funcs

@@ -0,0 +1,30 @@
+tbl()	{
+	case $# in
+	0) rsh vmb.brl.mil 'PATH=/usr/5bin:$PATH export PATH; tbl';;
+	*) cat $1 | rsh vmb.brl.mil 'PATH=/usr/5bin:$PATH export PATH; tbl';;
+	esac;
+	}
+typeset()
+	{
+	case $# in
+	0)
+	rsh vmb.brl.mil 'PATH=/usr/5bin:$PATH export PATH; troff -mm -Ti300 | dimp -t | ipr -J -Pim124';;
+	*) cat $1 |
+	rsh vmb.brl.mil 'PATH=/usr/5bin:$PATH export PATH; troff -mm -Ti300 | dimp -t | ipr -J -Pim124';;
+	esac;
+	}
+laser()
+	{
+	OPTS=
+	case $# in
+	0)	;;
+	*)	case $1 in
+		-h)	OPTS=$1; shift;;
+		esac
+		case $# in
+		1)	FILE=$1;;
+		esac;;
+	esac
+	pix-bw -ntsc ${FILE} | bw-imp ${OPTS} | rsh vmb.brl.mil 'PATH=/usr/5bin:$PATH export PATH; ipr -J -Pim124'
+	unset OPTS FILE;
+	}

doc/burst/Make-docs.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+#OPTS='-V'
+OPTS='-b'
+
+groff $OPTS -mm -Tps burst.mm   > burst.ps
+ps2pdf burst.ps
+
+#groff $OPTS -mm
+
+#groff -mm -Thtml burst.mm > burst.html

doc/burst/Make-tables.sh

@@ -0,0 +1,22 @@
+#!/bin/sh
+
+tables="\
+bpl \
+cmap \
+commands \
+fb \
+hmkeys \
+ids \
+overlap \
+plot \
+screen \
+scrollmenu \
+shotlines \
+submenu \
+topmenu\
+"
+
+for table in $tables ; do
+  gtbl $table.tbl > $table.mm
+done
+

doc/burst/Makefile

@@ -0,0 +1,27 @@
+# these macros (mm files) are generated by tclsh script "Make-tables.sh"
+TABLE_MM := bpl.mm
+TABLE_MM += cmap.mm
+TABLE_MM += commands.mm
+TABLE_MM += fb.mm
+TABLE_MM += hmkeys.mm
+TABLE_MM += ids.mm
+TABLE_MM += overlap.mm
+TABLE_MM += plot.mm
+TABLE_MM += screen.mm
+TABLE_MM += scrollmenu.mm
+TABLE_MM += shotlines.mm
+TABLE_MM += submenu.mm
+TABLE_MM += topmenu.mm
+
+PRODS := burst.ps burst.pdf burst.html
+
+docs:
+	@echo "Making burst tables for groff..."
+	./Make-tables.sh
+	@echo "Making burst docs..."
+	./Make-docs.sh
+
+clean: distclean
+
+distclean:
+	-rm $(TABLE_MM) $(PRODS) *~ t tt

doc/burst/README

@@ -0,0 +1,64 @@
+Documentation for the BRL-CAD program 'burst'.
+
+Debian requires packages groff and groff-base.
+
+The original source file ('burst.mm') has been modified slightly to
+ensure correct handling by Eric Raymond's doclifter
+(http://www.catb.org/~esr/doclifter/).  From an e-mail from Eric:
+
+from:	   Eric S. Raymond <esr@thyrsus.com>
+reply-to:  esr@thyrsus.com
+to:	   Tom Browder <tom.browder@gmail.com>
+date:	   Tue, Aug 20, 2013 at 8:48 AM
+subject:   Re: doclifter (master) failing on troff mm source
+mailed-by: thyrsus.com
+
+<quote>
+Tom Browder <tom.browder@gmail.com>:
+> I have checked all macros and they are valid mm macros so I  can't
+> figure out why doclifter is failing.  I can send you the whole source
+> zipped if you're interested.
+
+What you sent is sufficient.  The problem is that your mm file
+contains none of the three trigger macros doclifter is looking for as
+a way to recognize that it's dealing with mm - .MT, .SA, or .COVER.
+The relevant table looks like this:
+
+# This is how we autodetect the right macro set:
+
+interpreter_dispatch = {
+    "pp": MeInterpreter,
+    "Dt": MdocInterpreter,
+    "Dd": MdocInterpreter,
+    "Nm": MdocInterpreter,
+    "AU": MsInterpreter,
+    "NH": MsInterpreter,
+    "TH": ManInterpreter,
+    "MT": MmInterpreter,
+    "SA": MmInterpreter,
+    "COVER": MmInterpreter,
+    # Extension macro sets
+    "supplemental macros used in Tcl/Tk": TkManInterpreter,
+    "BS": TkManInterpreter,
+    "the F register is turned on": Pod2ManInterpreter,
+    "ZN": XManInterpreter,
+    "Pn": XManInterpreter,
+    "ny0": XManInterpreter,
+    "reStructuredText": reStructuredTextInterpreter,
+    "reStructeredText": reStructuredTextInterpreter,
+    "DocBook XSL Stylesheets" : DocBookInterpreter,
+    "pdfdest" : FoojzsInterpreter,
+    "H0": ASTInterpreter,
+    # These are all of the supported Mwww tags
+    "URL": MwwwInterpreter,
+    "FTP": MwwwInterpreter,
+    "MTO": MwwwInterpreter,
+    "PIMG": MwwwInterpreter,
+    "IMG": MwwwInterpreter,
+    "TAG": MwwwInterpreter,
+    }
+
+Inserting a dummy .MT 0 call should fix your problem.
+</quote>
+
+

doc/burst/abstract.mm

@@ -0,0 +1,15 @@
+.TL
+``burst''; Air Force Vulnerability Analyses from BRL-CAD Models
+.AF "U. S. A. Ballistic Research Laboratory"
+.ds ZZ Aberdeen Proving Ground
+.AU "Gary S.\& Moss" GSM ZZ
+.AS
+.so introduction.mm
+'\"The presentation will not dwell on the details of usage as much as the paper
+'\"but will focus on the available features of the \*(b) program
+'\"as well as its flexibility in supporting analyses of varied threat
+'\"mechanisms on \*(m) targets.
+.AE
+.MT 4
+.rm ZZ
+.SA 1

doc/burst/bpl.tbl

@@ -0,0 +1,37 @@
+.TS
+allbox,center,tab(@);
+lb lb lb
+_ _ _
+l l l.
+record description@field format@field description
+run header@'1'@record number 1
+@1x,f9.4@attack azimuth (degrees)
+@1x,f8.4@attack elevation (degrees)
+@1x,f5.2@burst distance
+@1x,f10.2@projected area associated with burst point
+@1x,6a@units (mm,cm,inches,feet,meters)
+@1x,f9.6@ray solid angle (steradians)
+shotline header@'2'@record number 2
+@1x,f8.3@Y' coordinate of shotline
+@1x,f8.3@Z' coordinate of shotline
+shotline intersections@'3'@record number 3
+@1x,f8.2@X' coordinate of component intersection
+@1x,f8.2@line-of-sight thickness of component
+@1x,i4@component code number
+@1x,i2@space code
+@1x,f7.3@sine of fallback angle of exit normal
+@1x,f7.2@rotation angle of exit normal (degrees)
+@1x,f7.3@cosine of obliquity angle at entry
+@1x,a1@burst flag ('1' for yes, '0' for no)
+burst ray header@'4'@record number 4
+@1x,f8.3@azimuth angle WRT shotline (radians)
+@1x,f8.3@sine of elevation angle WRT shotline
+@1x,i6@sequential ray number for this burst point
+burst ray intersections@'5'@record number 5
+@1x,f10.3@distance to first contact with component
+@1x,f9.3@line-of-sight thickness of component
+@1x,f9.3@normal thickness of component
+@1x,i4@space code
+@1x,i4@component code number
+@1x,f6.3@cosine of obliquity angle at entry
+.TE

doc/burst/burst.mm

@@ -0,0 +1,995 @@
+.\" ASI Note: PP was changed to P in this file; CS was commented out
+.\" Note the following line was added per Eric Raymond's advice for
+.\"  use by doclifter:
+.MT 0
+.PH ""
+.PF "''\\\\nP''"
+.so defs.mm
+.so abstract.mm
+.so macros.mm
+.H 1 "User Interface"
+.H 2 "Program Invocation"
+In the examples below,
+the `$' symbol represents the \*(U)
+shell prompt.
+The general usage for the \*(b) program is as follows:
+.Ex "burst [-b]\fR"
+.P
+When \*(b) is used in the default mode,
+a full-screen, interactive, menu-driven interface is provided:
+.Ex burst
+In the interactive mode,
+commands are formatted by the menu system (see \fBHierarchical Menus\fR).
+The optional
+.I -b\^
+argument will suppress the full-screen terminal display in favor of a
+batch-oriented interface;
+when coupled with \*(U) file redirection and background processing,
+the user can submit the job and go on to other tasks.
+.Ex "burst \|\-b \|< \|input_file \|&"
+The user will typically want to redirect any diagnostics to a log file
+(see \fBError Log\fR).
+In either batch or interactive mode,
+the program will read commands (see \fBCommand Input\fR) from the standard
+input until an end of file is encountered.
+In batch mode,
+the program will exit after the last command is processed,
+but when run interactively the menu system will take over after the last
+command.
+The user must \fIquit\fR the program by exiting the top-level menu
+(see Table 2).
+It is recommended that the reader begin by running the \*(b)
+program interactively.
+The hierarchical menu system generates key word commands for the user by
+prompting him to make choices or enter values without prior knowledge of
+the commands and their syntax.
+As commands are generated,
+they are printed in the scrolling region so that the user can learn
+the syntax of the alternative mode of input without affecting his productivity.
+The more advanced user can circumvent the menu system by using a
+text editor to prepare input files.
+.sp
+.H 2 "Command Input"
+All commands to \*(b) are composed of one or more words connected by hyphens
+and each command may require one or more arguments that must be separated by
+either spaces or tabs.
+A line that begins with the `#' symbol is considered a comment and will be
+ignored.
+Each command must be on a separate line and may be supplied to the \*(b)
+program's standard input (i.e. using \*(U)
+.Ud sh 1
+file redirection) or can be generated from the hierarchical menus.
+In Table 1 below is a brief description of these commands; \fIflag\fR
+arguments have \fIyes\fR or \fIno\fR values, an \fIangle\fR is expressed in
+degrees as a floating-point quantity,
+\fIdistances\fR and coordinates such as \fIX, Y, Z, left, right\fR, etc.
+are also floating-point numbers,
+and \fIcount\fR represents an integer.
+Square brackets delimit optional arguments.
+For a detailed description of each command,
+refer to sections 2 through 7.
+.DF
+.sp
+.TB "Key Word Commands"
+.so commands.mm
+.sp
+.DE
+.H 2 "Screen Layout"
+In interactive mode,
+the screen is divided into sections of one or more rows (lines) of text.
+.DF
+.so screen.mm
+.FG "Screen Layout"
+.sp
+.DE
+The top line,
+referred to as line 1,
+is reserved for
+.SM CPU
+usage statistics.
+Starting on line 2,
+the hierarchical menu region spans 12 lines of the screen.
+Below the menu region is a line used for user input related errors and
+help messages that are generated by typing an `h' (see Table 2).
+Below that is a line used to prompt the user for input and to inform him
+of ongoing processing.
+The next line contains the program name and version number,
+and is intended as a divider between the scrolling window below it and the
+non-scrolling portion of the screen.
+Once ray tracing has begun,
+grid index ranges will appear inside square brackets to the right of the
+version number.
+The first number is the current horizontal index,
+and this is separated by a colon from the right-most index for the grid.
+After the comma,
+is the current vertical index,
+followed by the top-most index for the grid.
+As ray tracing commences,
+the current grid indices will reflect the current shotline being calculated
+as the grid is traversed in a left-to-right,
+bottom-to-top fashion.
+The scrolling window region takes up the remainder of the screen for the
+display of processed commands and processing-related errors (i.e. from the
+ray tracer).
+Figure 1 shows what the various sections of the screen are used for,
+however in practice,
+the status information,
+help message,
+and prompt would not be displayed concurrently.
+The screen-oriented interface is terminal independent;
+it doesn't use graphics per se
+but uses the terminal capabilities information database to control the
+manipulation of text characters.
+.sp
+.H 2 "Hierarchical Menus"
+Table 2 shows the key strokes used to manipulate the menus.
+.DF
+.sp
+.TB "Hierarchical Menu Commands"
+.so hmkeys.mm
+.sp
+.DE
+The top-level menu looks like Figure 2.
+.DF
+.so topmenu.mm
+.FG "Top-Level Hierarchical Menu"
+.sp
+.DE
+Note that the \fIcurrent\fR entry will be highlighted.
+The `v' symbols at the bottom corners of the menu show that
+there are more entries below.
+Attempting to move the cursor past the bottom entry will cause the
+menu to scroll upwards as illustrated in Figure 3.
+.DF
+.so scrollmenu.mm
+.FG "Scrolled Menu"
+.sp
+.DE
+Note the `^' symbols at the top corners of the menu.
+These signify that there are now hidden entries above that can be
+scrolled down by advancing the cursor upwards past the top visible
+entry.
+If no scrolling is possible,
+that is,
+if no further entries exist,
+a `+' symbol will mark the corner of the menu.
+If a menu item is selected that has a sub-menu,
+the sub-menu will be drawn to the right of its parent menu as shown
+in Figure 4.
+.DF
+.so submenu.mm
+.FG "Sub-Menu Display"
+.sp
+.DE
+The menu system \fIremembers\fR the last item selected in a given
+menu;
+entering a menu that has been used before will cause
+the \fIcurrent\fR item to be the same as it was when that menu was last exited.
+If a menu has never been used,
+the top item will initially be \fIcurrent\fR.
+.H 2 "Scrolling Region"
+When running the \*(b) program interactively,
+all diagnostic output is, by default, printed in a scrolling text window
+at the bottom of the display.
+If the batch option (\fI\-b\fR) is used,
+these diagnostics will be printed on the standard error output of the
+program.
+If there is enough output the user may find it difficult
+to read it all before it scrolls out of sight.
+Also, the user may wish to save these diagnostics for later reference;
+overlap diagnostics from the ray tracer are useful in fixing errors in
+the geometry of the target description.
+The \*(b) program has a command called
+.Co error-file
+that will divert this output to a file (see \fBError Log\fR).
+Figure 5 shows three such overlap diagnostics.
+.DS
+.sp
+.so overlap.mm
+.FG "Overlap Diagnostics"
+.sp
+.DE
+The full path name of both regions is printed, the zero enclosed in double
+curly brackets is intended to discriminate between \fIinstances\fR\*F.
+.FS
+An \fIinstance\fR is a type of group in the \*(m) data base that has
+a \fIprototype\fR object as a member.
+Several \fIinstances\fR may reference the same \fIprototype\fR
+yet have different transformation matrices.
+Although these objects represent distinct geometric entities,
+they share the same path name,
+therefore the additional discriminant is necessary.
+.FE
+Theoretically,
+\fIisol\fR and \fIosol\fR are the names of the starting and ending solids
+associated with the boolean operations on the overlapping partition.
+In practice,
+these solid names are typically not helpful in diagnosing the problem,
+but the region names should be sufficient.
+The \fIdepth\fR is the line-of-sight thickness of the overlapping partition
+in millimeters.
+In parentheses,
+are printed the target coordinates of the intersection of the ray
+with the overlap.
+The \fIx-2\fR and \fIy1\fR reveal that the grid indices of the shotline are
+\fI-2, 1\fR; this means that the shotline was 2 cells to the left,
+and one cell above the grid origin.
+If \fIlvl\fR (meaning ray tracing recursion level) is \fIzero\fR,
+then the overlap resulted from a shotline,
+but if it is \fIone\fR,
+it could represent either a burst ray intersection or a probe to
+calculate the normal thickness of a component intersected by the shotline.
+The real purpose of the ray is stated last.
+.H 1 "Executing a Run"
+.Cs "/execute"
+The \*(b) program is designed to allow many options to be configured before
+any outputs are calculated.
+Unless otherwise stated in the individual command descriptions in this report,
+a given command will nullify any previous occurrence of the same directive
+until an
+.Co execute
+command is given.
+For instance, the command
+.Co "target-file"
+\ \fItank1\fR followed by
+.Co "target-file"
+\ \fItank2\fR will nullify the reference to \fItank1\fR.
+Once the input parameters are specified,
+the
+.Co execute
+command will start a \fIrun\fR.
+Many \fIruns\fR may occur during an instance of the \*(b) program.
+One such instance is referred to as a \fIsession\fR.
+Below are descriptions of commands for configuring the behavior of the
+\*(b) program.
+.Ce
+.H 1 "User Preferences"
+.H 2 "Units of Measure"
+.Cs /units
+The
+.Co units
+command will set the linear units for input and output.
+This command should be used before any scalar quantities such as coordinates,
+distances,
+or sizes are input.
+The units may be changed to accommodate input files of differing units,
+but the output from a particular run will reflect whatever the units were
+set to when the
+.Co execute
+command was given.
+One argument is expected out of the following list and must be spelled
+correctly:
+\fImillimeters\fR,
+\fIcentimeters\fR,
+\fImeters\fR,
+\fIinches\fR and \fIfeet\fR.
+The default units are \fImillimeters\fR.
+Angles are always expressed in degrees, not radians.
+.Ce
+.H 2 "Region Overlap Reporting"
+.Cs "/preferences/report-overlaps"
+It is considered an error if two \fIregions\fR in an \*(m) file occupy
+the same space; we call this an \fIoverlap\fR.
+The ray tracing library (\*(l)) will report \fIoverlapping regions\fR that are
+intersected by shotlines or burst rays to the \*(b) application and
+the program will,
+by default,
+print out any that have a line of sight thickness of at least 0.25 millimeters
+(see \fBError Log\fR).
+Although a target may only have several \fIoverlaps\fR,
+an error will be reported for each ray that intersects one of them,
+so the messages will typically be repetitious.
+Although these diagnostics are important for fixing problems in the geometric
+description of the target,
+the user may wish to proceed with a production run and the printing of these
+errors can slow the execution time considerably.
+A \fIyes\fR or \fIno\fR argument to this command will turn the diagnostics
+on or off.
+Regardless of whether or not individual \fIoverlaps\fR are reported,
+the total number detected will be logged.
+.Ce
+.H 1 "Shotlining Options"
+.Cs /shotlines
+\fIShotlining\fR is a technique whereby lines are described in the target
+coordinate system and information is requested about the geometry that
+intersects those lines in 3-space.
+This technique is useful for analysis programs that must simulate
+threat/target interactions,
+and therefore must sample the geometry along the threat path.
+Typically the lines are specified discretely,
+by a point and a direction,
+or a \fIgrid\fR of lines is generated that is
+oriented perpendicular to the direction of attack.
+A \fIgrid\fR is rectangular,
+but is subdivided along its height and width uniformly resulting in square
+cells.
+\fIGridding\fR techniques include passing a line called a \fIshotline\fR through
+the center of each cell,
+or alternatively,
+\fIdithering\fR each shotline's position within its respective cell's
+boundaries (see \fBDithering Shotlines\fR).
+.Ce
+.H 2 "Attack Direction"
+.Cs "/shotlines/attack-direction"
+The orientation of shotlines with respect to the coordinate system of the
+target are described by \fIazimuth\fR and \fIelevation\fR angles.
+These angles must be specified in degrees as floating-point numbers
+(see \fBGridding\fR).
+.Ce
+.H 2 "Gridding"
+.Cs "/shotlines/shotline location"
+The user is faced with several choices for generating shotlines;
+full-target envelope, partial envelopes, or discrete shots.
+No matter what shotlining method is used,
+a grid always exists as a frame of reference for specifying 2-dimensional
+coordinates in the plane normal to the direction of attack.
+This 2-dimensional coordinate system is a projection of the shotline
+coordinate system (also referred to as the \fIprimed\fR coordinate system).
+For the simple case of a zero azimuth, zero elevation attack,
+the
+.Ax \*(x) \*(y) \*(z)
+in the shotline coordinate system coincide
+with the
+.Ax \*(X) \*(Y) \*(Z)
+of the target coordinate system and the shotline direction is parallel to
+the \*(x)\*(A) and headed toward decreasing coordinates.
+Other orientations are described by rotating the
+.Ax \*(x) \*(y) \*(z)
+to keep the shotline direction always down the \*(x)\*(A).
+This transformation involves two rotations;
+first a rotation of the \fIprimed\fR coordinate system about the coincident
+\*(Z) and \*(z)\*(a) by the specified azimuthal angle,
+followed by a rotation about the new \*(y)\*(A) by the specified elevation
+angle.
+Since the grid is a 2-d projection of the shotline coordinate system,
+it has no \*(X) coordinate;
+if the user's viewpoint is from the direction of attack,
+the \*(y)\*(A) can be thought of as horizontal with increasing coordinates
+to the right,
+and the \*(z)\*(A) as vertical and increasing in the upward direction.
+.Ce
+.Cs "/shotlines/shotline location/envelope"
+An \fIenvelope\fR refers to a grid that is dimensioned such that its
+rectangular area,
+projected normal to the grid,
+will cover optionally all or part of the target.
+.Ce
+.Cs "/shotlines/shotline location/envelope/enclose-target"
+This option will generate a grid that is guaranteed to cover the entire
+target.
+Since the \*(m) modeler uses combinatorial solid geometry,
+the dimensions of the target are not known,
+therefore a worst case bounding rectangular parallel piped (RPP)
+is the only information available to the program and
+the grid may be larger than necessary.
+In addition,
+depending on the attack aspect,
+the presented area of some targets may not fill up a rectangular grid well.
+This should not be a problem since ray tracing outside the target
+boundaries is cheap, but if desired,
+the grid can be trimmed down with the partial envelope option described
+below.
+The grid origin is always aligned with the target origin.
+.Ce
+.Cs "/shotlines/shotline location/envelope/enclose-portion"
+This option allows the user to generate a \fIsub-grid\fR by specifying the
+distances from the grid origin to the \fIsub-grid's\fR left, right, top,
+and bottom boundaries.
+.Ce
+.H 2 "Cell Size"
+.Cs "/shotlines/cell-size"
+The dimensions of a grid cell are input as floating-point values that
+represent the distances between the centers of adjacent cells.
+\fICell size\fR also expresses the projected area of influence
+associated with a shotline or burst ray.
+Therefore,
+\fIcell size\fR must be specified even when a grid will not be generated,
+such as with discrete shot or discrete burst point selection
+(see \fBInput Discrete Shots\fR and \fBInput Discrete Burst Points\fR).
+.Ce
+.H 2 "Dithering Shotlines"
+.Cs "/shotlines/dither-cells"
+When gridding,
+shotlines normally pass through the center of each cell,
+however,
+they may be also be \fIdithered\fR.
+If the user chooses the latter,
+2 random numbers are selected for each
+cell that are used to offset the shotline in both parametric
+directions of the grid plane,
+but within the respective cell's boundaries.
+.Ce
+.H 2 "Input Discrete Shots"
+.Cs "/shotlines/shotline location/discrete shots"
+The following options describe different ways to input explicit shot locations
+as an alternative to generating a grid.
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/target coordinate system"
+If the user wants to fire at a known point on the target,
+he may wish to describe the shotline location in target coordinates.
+When coupled with the attack direction,
+each 3-dimensional coordinate uniquely specifies a shotline.
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/target coordinate system/input-3d-shot"
+This option allows the user to type in a single shot location as an
+\*(X), \*(Y), and \*(Z) coordinate.
+When the
+.Co execute
+command is given,
+that one shot will be run.
+No queueing of shots occurs in this mode;
+the last set of coordinates entered will be used.
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/target coordinate system/read-3d-shot-file"
+A number of shots can be input from a file;
+this option will,
+after submission of an
+.Co execute
+directive,
+loop through every set of target coordinates in the named file.
+The file should contain three floating-point numbers on each line separated by
+white space (blanks or tabs).
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/shotline coordinate system"
+Another way to describe a shot location is in the shotline coordinate
+system.
+Since the \*(x) location of the shot is irrelevant (the shotline is
+parallel to the \*(x)\*(A)) a shot may be specified as a
+\*(y) and \*(z) coordinate.
+These coordinates can also be referred to as horizontal and vertical grid
+offsets.
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/shotline coordinate system/input-2d-shot"
+This option allows the user to type in a single shot location as a
+\*(y), and \*(z) coordinate.
+When the
+.Co execute
+command is given,
+that one shot will be run.
+No queueing of shots occurs in this mode,
+the last set of grid offsets entered will be used.
+.Ce
+.Cs "/shotlines/shotline location/discrete shots/shotline coordinate system/read-2d-shot-file"
+A number of shots can be input from a file;
+this option will,
+after submission of an
+.Co execute
+directive,
+loop through every set of grid offsets in the named file.
+The file should contain three floating-point numbers on each line separated by
+white space (blanks or tabs).
+.Ce
+.H 1 "Bursting Options"
+.Cs "/burst points"
+\fIBursting\fR is a technique for sampling a target's geometry with the use
+of ray tracing.
+As opposed to \fIshotlining\fR involving parallel rays,
+\fIbursting\fR employs a distribution of rays that emanate from a single
+point.
+The \*(b) program generates rays that approximate a uniform distribution
+over a user-specified solid angle (see \fBSampling Cone Half Angle\fR)
+and having a density (see \fBNumber of Sampling Rays\fR) that is also under
+control of the user.
+The user also has a choice between several mechanisms for setting up
+burst point locations depending on the particular threat he is attempting
+to emulate.
+.Ce
+.H 2 "Method of Locating Burst Point"
+.Cs "/burst points/bursting method"
+Depending on threat type,
+burst points may be located using two basic techniques.
+The first technique is simply to input the burst point coordinates.
+This method can be used to compare vulnerability analysis results with
+empirical results from the firing range or combat field.
+The second technique available to the user is to burst along a shotline.
+This option is used more for predicting the burst point location based
+on target geometry,
+given certain parameters that describe the target/threat interactions.
+.Ce
+.H 3 "Input Discrete Burst Points"
+.Cs "/burst points/bursting method/burst point coordinates"
+The input of explicit burst point coordinates can be accomplished
+either by typing them in one at a time or by reading a file
+of target \*(X), \*(Y), and \*(Z) coordinates.
+.Ce
+.Cs "/burst points/bursting method/burst point coordinates/burst-coordinates"
+This option allows the user to type in a single burst point location as an
+\*(X), \*(Y), and \*(Z) coordinate.
+When the
+.Co execute
+command is given,
+that one burst point will be run.
+No queueing of burst points occurs in this mode,
+the last set of coordinates entered will be used.
+.Ce
+.Cs "/burst points/bursting method/burst point coordinates/read-burst-file"
+A number of burst points can be input from a file;
+this option will,
+after submission of an
+.Co execute
+directive,
+loop through every set of target coordinates in the named file.
+The file should contain three numbers on each line separated by
+white space (blanks or tabs).
+.Ce
+.H 3 "Burst on Contact"
+.Cs "/burst points/bursting method/burst point coordinates/shotline-burst"
+The
+.Co shotline-burst
+directive can be given a \fIyes\fR or \fIno\fR argument to either enable
+or disable this method of generating burst points.
+When a \fIyes\fR argument is given,
+a second \fIyes\fR or \fIno\fR argument is also required
+(see \fBBurst on Armor\fR).
+Bursting along a shotline can be done different ways depending on the
+combination of several options.
+The location of the burst point is based on the triggering
+mechanism that is selected with the \fIburst distance\fR parameter.
+.Ce
+.H 4 "Burst on Armor"
+.sp
+If the \fIburst distance\fR parameter is set to a negative or zero value,
+then interior burst points will be generated (see \fBBurst Distance\fR).
+This method of bursting requires the input of \fIburst armor\fR idents and,
+by default, \fIburst air\fR idents are also required.
+If the user does not want to require that certain air be present to trigger
+a burst point,
+the
+.Co shotline-burst
+command has a second argument.
+When this second argument is set to \fIno\fR,
+bursting will occur as long as
+\fIburst armor\fR is followed by any air or void (empty space),
+and the \fIburst air\fR file is not required.
+For more information see \fBBurst Armor File\fR and \fBBurst Air File\fR.
+.Ce
+.H 4 "Ground Plane Bursting"
+.Cs "/burst points/bursting method/burst point coordinates/ground-plane"
+Ground plane bursting is a vehicle for evaluating the effect of
+fragmenting warheads on light-armored vehicles when they strike the ground
+in close proximity to the target.
+The
+.Co ground-plane
+command is only relevant when bursting along a shotline is selected.
+The ground is modeled as a rectangle lying in a plane parallel
+to the target \fIX-Y\fR plane with edges parallel to the \*(X) and \*(Y)
+axes.
+The grid will be enlarged to include the ground plane;
+it is important for efficiency to limit the size of the ground plane to
+match the range of the fragments that may be generated by the particular
+threat being modeled.
+When enabling this option,
+the
+.Co ground-plane
+command is given a \fIyes\fR argument
+followed by the height of the target above the ground,
+and the distances that the ground rectangle extends out positive \*(X),
+negative \*(X),
+positive \*(Y),
+and negative \*(Y) axes.
+.Ce
+.H 2 "Bursting Parameters"
+.Cs "/burst points/bursting parameters"
+The following parameters influence both the triggering mechanism for burst
+points,
+as well as the characteristics of the cone of rays generated from each
+point.
+.Ce
+.H 3 "Burst Distance"
+.Cs "/burst points/bursting parameters/burst-distance"
+The \fIburst distance\fR parameter is modeled after the \fBBDIST\fR parameter
+used by the Air Force's \*(G)\*F code.
+.FS
+The Air Force currently uses \*(G) to produce burst point libraries
+for \*(P) from \*(F) descriptions.
+.FE
+The role of this parameter is overloaded,
+however it was retained to aid \*(G) users in transitioning to the \*(b)
+program.
+If it is zero or negative,
+then \fIinterior bursting\fR is enabled,
+otherwise,
+if it is greater than zero, \fIexterior bursting\fR will occur,
+subject to certain conditions (see below).
+The magnitude of this parameter is used to offset the burst point location
+along the shotline relative to the geometry that triggered the burst.
+.Ce
+.H 4 "Interior Bursting"
+.sp
+\fIBurst armor\fR refers to a component whose ident code is found in
+the list input by the
+.Co burst-armor-file
+command.
+Similarly,
+\fIburst air\fR refers to a component whose ident code is found in the
+list input by the
+.Co burst-air-file
+directive.
+If \fIinterior bursting\fR is enabled
+and a \fIburst armor\fR component is encountered along a shotline
+that is immediately followed by \fIburst air\fR,
+then a burst point will be located the absolute value of \fIburst distance\fR
+beyond the exit of the shotline from the component.
+This means that if \fIburst distance\fR is zero,
+the burst point will lie at the \fIburst armor/air\fR interface,
+and if its -5.5,
+the burst point will lie 5.5 units inside the air compartment from the
+back surface of the armor.
+.Ce
+.H 4 "Exterior Bursting"
+.sp
+If \fIburst distance\fR is greater than zero,
+the first component encountered along the shotline will trigger a
+burst point,
+regardless of its ident code,
+that will be located \fIburst distance\fR
+in front of the shotline \fIentry\fR point.
+This technique simulates the behavior of a fragmenting munition with
+a \fIstandoff\fR fuzing such that detonation is triggered before
+the collision of the warhead with the target.
+The \fIburst distance\fR is set to imitate the built in \fIstandoff\fR
+of the warhead.
+When employing \fIexterior bursting\fR methods,
+\fIburst armor\fR and \fIburst air\fR are not used.
+.sp
+.H 3 "Sampling Cone Half Angle"
+.Cs "/burst points/bursting parameters/cone-half-angle"
+To limit the solid angle within which burst rays will be generated,
+the user may specify a \fIcone half angle\fR.
+This angle represents the degrees (in floating point) from the \fIaxis\fR of
+the cone to its limiting surface.
+The default value for the \fIcone half angle\fR is 45 degrees.
+.Ce
+.H 3 "Deflected Sampling Cone"
+.Cs "/burst points/bursting parameters/deflect-spall-cone"
+The spall cone axis is,
+by default,
+aligned with the shotline.
+In reality,
+the center of mass of the spall cloud would be between the shotline direction
+and the exit normal of the shotline from the spalling component.
+By aligning the spall cone axis with a vector halfway between the shotline
+and the exit normal,
+a narrower cone half angle can be used and still sample within the solid
+angle of interest.
+This technique can therefore be used to cut down on the number of rays
+calculated without lowering the sampling density.
+The
+.Co deflect-spall-cone
+command takes a \fIyes\fR or \fIno\fR argument about whether or not
+to divert the cone axis.
+.Ce
+.H 3 "Number of Sampling Rays"
+.Cs "/burst points/bursting parameters/max-spall-rays"
+The sampling ray density within the spall cone is controlled by specifying
+the maximum number of rays desired.
+Due to the uniform distribution algorithm employed,
+the number of rays calculated will be slightly less.
+.Ce
+.H 3 "Maximum Barriers"
+.Cs "/burst points/bursting parameters/max-barriers"
+For munitions known to have limited penetration capability,
+the user may set a limit on the number of burst ray intersections reported.
+The effect of setting this parameter is to reduce the size of the
+burst point library (see \fBBurst Point Library\fR) by limiting the
+number of components that will be reported per burst ray.
+By default,
+up to 100 components are reported,
+as it is not expected that this number will be reached under normal
+circumstances.
+.Ce
+.H 1 "Input File Options"
+.H 2 "Target-Related Input Files"
+.Cs "/target files"
+This group of commands is for specification of target-specific input files.
+.Ce
+.H 3 "Target Data Base File"
+.Cs "/target files/target-file"
+The input of the target's \*(m) file is accomplished with this command.
+Note that only one data base may be read in during a given \fIsession\fR.
+If the user wishes to change the target once the
+.Co execute
+command has been given,
+he must exit the \*(b) program and start a new \fIsession\fR.
+.Ce
+.Cs "/target files/target-objects"
+After specifying the \*(m) file,
+the user must list all of the objects in the \*(m) hierarchy that he
+wishes to be included in his analysis.
+The objects must be listed as arguments to one
+.Co target-objects
+command with spaces or tabs as separators.
+Note that only one list of objects may be loaded per \fIsession\fR,
+however,
+they do not get loaded until the
+.Co execute
+command is given.
+.Ce
+.H 3 "Ident List Input Files"
+.sp
+\fIIdents\fR refer to the \fIregion ident\fR code from the \*(m) file.
+Lists of \fIidents\fR may be specified singly or as ranges.
+Individual \fIidents\fR must appear as one per line,
+but ranges are specified by two numbers on a line that are
+separated by one or more of the following characters: comma, hyphen, colon,
+semicolon, space, or tab.
+Figure 6 shows an example of such a file.
+.DS
+.sp
+.so ids.mm
+.FG "Ident List File Format"
+.sp
+.DE
+.Ce
+.H 4 "Burst-Armor and Burst-Air Ident Files"
+.sp
+.Cs "/target files/burst-armor-file"
+.Cs "/target files/burst-air-file"
+When interior burst points are to be generated along a shotline
+(see \fBInterior Bursting\fR) a file of \fIburst armor\fR idents and
+\fIburst air\fR idents must be input.
+If a shotline intersects a component whose \fIident\fR has been input
+as a \fIburst armor\fR and it is immediately followed by \fIburst air\fR
+a burst point will be triggered.
+.Ce
+.H 4 "Critical Component Idents"
+.Cs "/target files/critical-comp-file"
+Whether interior or exterior bursting is being employed,
+information about components hit by burst rays will only be output
+for rays that hit \fIcritical components\fR.
+The file name containing a list of \fIcritical component\fR idents must
+therefore be input by this command if burst points are to be generated.
+.Ce
+.H 3 "Color Mapping Input File"
+.Cs "/target files/color-file"
+This command allows users to assign colors to component idents for graphics
+options,
+in particular,
+the
+.Co image-file
+and
+.Co plot-file
+commands.
+The format of this file is 5 numbers per line separated by blanks or tabs.
+The first number is the low end of an ident range and the second number is
+the high end of the range (both numbers are inclusive).
+This range is mapped to the color specified by the last 3 numbers on the
+line that are red, green, and blue components of the color (values for
+these components must be between 0 and 255 inclusive).
+Figure 7 shows an example of such a file.
+.DS
+.sp
+.so cmap.mm
+.FG "Color Mapping File Format"
+.sp
+.DE
+.Ce
+.H 2 "Project-Related Input Files"
+.H 3 "Reading Session Files"
+.Cs "/project files/read-input-file"
+This command reads an \fIinput\fR file of commands.
+These files can be generated manually by using a text editor or
+saved from a \fIsession\fR file with the
+.Co write-input-file
+command.
+See the section called \fBCommand Input\fR for the format of this
+file.
+.Ce
+.H 3 "Shotline and Burst Point Input Files"
+.sp
+For an explanation of commands for reading in files of shotline or burst
+point coordinates,
+see the sections called \fBInput Discrete Shots\fR and
+\fBInput Discrete Burst Points\fR.
+.Ce
+.H 1 "Output File Options"
+.Cs "/project files"
+The following commands will turn on optional output.
+By default,
+no output is produced except error logging (see \fBError Log\fR),
+unless an output file is specified with the appropriate command.
+Any combination of output options may be specified for a particular run.
+Note that specifying an output file will cause an existing file with that
+name to be truncated to zero length.
+Therefore,
+only one such command should be entered per \fIsession\fR for a particular file
+name.
+Multiple runs during a \fIsession\fR will append to the same files if
+intervening commands to change the output file name are not given,
+except for the graphics files as explained below.
+Note that there is no way to append to a file created by a previous
+\fIsession\fR of the \*(b) program,
+but these files may be concatenated after the fact by using the
+\*(U)
+.Ud cat 1
+utility.
+.Ce
+.H 2 "Burst Point Library File"
+.Cs "/project files/burst-file"
+This command will open the named file for creating a burst point library.
+If the file exists,
+it will be truncated by this command.
+\fBAppendix A\fR describes the format for these files.
+.Ce
+.H 2 "Shotline File"
+.Cs "/project files/shotline-file"
+This command will open the named file for creating a shotline file.
+If the file exists,
+it will be truncated by this command.
+\fBAppendix B\fR describes the format for these files.
+.Ce
+.H 2 "\*(U) Plot File"
+.Cs "/project files/plot-file"
+This command generates a \*(U) plot file,
+using \*(B) extensions to the standard format.
+This option is useful for examining the shotline and burst ray information
+graphically as a three-dimensional vector plot.
+Due to constraints inherent in the \*(U) plot format,
+these plots must be displayed as a post-process step by using
+a \*(B) plotting utility such as \fBpl-sgi\fR or \fBpl-fb\fR.
+Because some of these display programs do not support multiple plots
+per file,
+the file name should be changed between runs.
+Table 3 describes the color mapping associated with these plots.
+.DF
+.sp
+.TB "Color Key for \s-1UNIX\s0 \*(Tm Plots"
+.so plot.mm
+.sp
+.DE
+.P
+If the user has specified a color mapping file with the
+.Co color-file
+command,
+then those colors will be used rather than the above colors for
+all shotline/ray intersections.
+.Ce
+.H 2 "Frame Buffer Image"
+.Cs "/project files/image-file"
+This option will generate a color image that provides the user with
+immediate feedback about a run.
+The grid is displayed graphically and each cell location is dynamically
+color coded to show its current status.
+Table 4 describes the color mapping associated with the grid.
+.DF
+.sp
+.TB "Color Key for Frame Buffer Image"
+.so fb.mm
+.sp
+.DE
+.P
+In addition to the above cell colors, hits on critical components by burst
+rays are depicted as a colored pixel projected into grid
+space from the intersection point where the ray enters the component.
+Colors for the components are mapped from ident numbers according to the
+table specified by the user with the
+.Co "/target files/color-file"
+directive and shaded using a lighting model illuminated from the viewing
+direction.
+.H 2 "Grid File"
+.Cs "/project files/grid-file"
+This command will store each shotline coordinate generated during the run
+as grid offsets.
+These files can later be read in to replicate a previous run's grid or discrete
+shots by using the
+.Co read-2d-shot-file
+command.
+This capability is especially useful when \fIdithered\fR shotlines have been
+used and it is desired that the same shotlines be used in another run.
+Note that the shotline intersection information is not saved,
+just the grid offsets for each shotline.
+.Ce
+.H 2 "Script File"
+.Cs "/project files/write-input-file"
+During a \fIsession\fR,
+all commands are saved in a temporary file.
+The
+.Co write-input-file
+command will create a \fIsnapshot\fR of this \fIsession\fR file,
+that can later be used to recreate the current \fIsession\fR
+up to the point when the file was written.
+The \fIsession\fR or \fIinput\fR files
+can later be used in one of two ways: either read in with the
+.Co read-input-file
+command,
+or supplied on the standard input of the \*(b) program.
+Note that the
+.Co write-input-file
+and
+.Co read-input-file
+commands will not be included in the \fIinput\fR files,
+but the commands read in by the latter \fIwill\fR.
+.Ce
+.H 2 "Error Log"
+.Cs "/project files/error-file"
+This command is useful to save errors in a log file and prevent copious
+ray tracer diagnostics from scrolling by on the screen.
+This option is especially useful if using the batch mode of execution
+so that the terminal is not tied up by program output.
+If no error log is specified,
+diagnostic messages will appear in the scrolling window or,
+if in batch mode,
+on the \*(b) program's standard error output.
+.Ce
+.H 2 "Histogram File"
+.Cs "/project files/histogram-file"
+This command generates a frequency histogram to the named file.
+The file format is simply one number per line; each number is a count
+of critical components hit by an individual burst ray.
+This file can easily be post-processed to display a histogram,
+for instance,
+how many rays hit zero, one, two, three, etc. components.
+.Ce
+.H 1 Conclusion
+There is a large, and rapidly growing, collection of highly detailed \*(m)
+models due to the widespread use of the highly portable \*(B) package.
+The \*(b) program gives the \*(F) community the option of analyzing \*(m)
+models.
+This, along with the \*(F) to \*(m) translator will permit an easy transition
+of the Air Force to the \*(B) system.
+Then,
+productivity in the target description arena,
+that has long been a bottleneck to the vulnerability and lethality analyst,
+will increase dramatically.
+Another benefit will be increased accuracy of results due to the superior
+detail and accuracy afforded by a true combinatorial solid geometry modeler.
+.H 1 Acknowledgements
+The author would like to thank Leonard E. Bruenning, Jr. of Sverdrup
+Technology, Inc. for his thorough, concise and well-illustrated
+documentation\*F of the requirements to be met by the \*(b) program
+and for his courteous and professional manner in fielding related questions.
+.FS
+Leonard E. Bruenning,
+"Interface Control Document for BURST Ray Generator Computer Program",
+\fBTechnical Report\fR,
+prepared for: Department of the Air Force,
+Armament Division,
+Eglin AFB,
+FL 32542-5000,
+14 December 1988.
+.FE
+.H 1 Appendices
+Both burst point library files and shotline files are composed
+of single-line records.
+Each line begins with a digit that identifies the type of record it represents.
+Both file formats are composed of one or more \fIruns\fR that begin with a
+\fIrun header\fR.
+Each shotline that intersects the target will result in a
+\fIshotline header\fR that is followed by one or
+more \fIshotline intersection\fR records.
+These record types exist for both file formats,
+but they do not contain the same information.
+Burst point library files have two additional record types,
+\fIburst ray headers\fR and \fIburst ray intersections\fR.
+If a burst point occurs along a shotline,
+the \fIburst ray header\fR will immediately follow that shotline's last
+intersection record.
+Each \fIburst ray header\fR records will be immediately followed by
+\fIburst ray intersection\fR records,
+one for each ray that strikes a \fIcritical component\fR.
+.bp
+.H 2 "Appendix A:  Burst Point Library File Format"
+Below is a description of the format of the burst point library files that
+are generated if the
+.Co burst-file
+command is used.
+.DS
+.so bpl.mm
+.DE
+.bp
+.H 2 "Appendix B:  Shotline File Format"
+Below is a description of the format of the shotline files that are
+generated if the
+.Co shotline-file
+command is used.
+.DS
+.so shotlines.mm
+.DE
+.de TX
+.ce
+TABLE OF CONTENTS       \" define header for TOC page
+..
+.de TY          \" suppress default TOC header
+..
+.TC
+.\" .CS

doc/burst/cmap.tbl

@@ -0,0 +1,12 @@
+.TS
+center,box;
+l.
+4001 4003       255 255 0       # Fuel
+4050 4050       255 255 0       # Fuel
+8000 8001       255 100 255     # Ammo
+100 165         150 255 100     # Hull armor
+610 619         220 150 100     # Commander
+720 729         220 150 100     # Gunner
+830 839         220 150 100     # Loader
+940 949         220 150 100     # Driver
+.TE

doc/burst/commands.tbl

@@ -0,0 +1,55 @@
+.so defs.mm
+.ps -2
+.vs -2
+.TS
+center,allbox,tab(@);
+cb cb cb
+_ _ _
+cb ci c.
+COMMAND@ARGUMENTS@DESCRIPTION
+attack-direction@azim_angle elev_angle@specify azimuth and elevation of attack relative to target
+burst-air-file@file@input burst air idents from \fIfile\fR
+burst-armor-file@file@input burst armor idents from \fIfile\fR
+burst-coordinates@X  Y  Z@input single burst point location in target coordinates
+burst-distance@distance@offset burst point along shotline (see \fBBurst Distance\fR)
+burst-file@file@output burst point library to \fIfile\fR
+cell-size@distance@specify shotline separation (equidistant horizontal and vertical)
+color-file@file@input ident to color mapping from \fIfile\fR (for graphics)
+cone-half-angle@angle@specify limiting angle for spall ray generation
+critical-comp-file@file@input critical component idents from \fIfile\fR
+deflect-spall-cone@flag@deflect axis of spall cone half way towards exit normal
+dither-cells@flag@if \fIyes\fR, randomly offset shotline within grid cell
+enclose-target@@generate rectangular grid of shotlines for full target envelope
+enclose-portion@left right bottom top@T{
+generate partial envelope by specifying grid boundaries
+T}
+error-file@file@divert all diagnostics to \fIfile\fR
+execute@@initiate a run (no output produced without this command)
+grid-file@file@save shotline locations (Y' Z') in \fIfile\fR
+ground-plane@flag [Z  +X  -X  +Y  -Y]@T{
+if \fIyes\fR, burst on ground (see \fBGround Plane Bursting\fR).
+T}
+histogram-file@file@write hit frequency histogram to \fIfile\fR
+image-file@file@generate frame buffer image on specified \fIfile\fR or device
+input-2d-shot@Y'  Z'@input single shotline location as grid offsets
+input-3d-shot@X  Y  Z@input single shotline location in target coordinates
+max-barriers@count@specify the maximum number of components to report along spall ray
+max-spall-rays@count@specify the desired number of spall rays generated per burst point
+plot-file@file@generate \*(U) plot in \fIfile\fR
+read-2d-shot-file@file@read shot locations from \fIfile\fR as grid offsets (see \fBinput-2d-shot\fR)
+read-3d-shot-file@file@read shot locations from \fIfile\fR in target coords. (see \fBinput-3d-shot\fR)
+read-burst-file@file@read burst point locations from \fIfile\fR (see \fBburst-coordinates\fR)
+read-input-file@file@read key word commands from \fIfile\fR
+report-overlaps@flag@if \fIyes\fR, log overlap diagnostics
+shotline-burst@flag [flag]@T{
+if \fIyes\fR, generate burst points along shotlines (see \fBBurst on Contact\fR).
+T}
+shotline-file@file@output shot line data to \fIfile\fR
+target-file@file@read \*(m) data base from \fIfile\fR
+target-objects@object0 [object1 object2 ...]@list objects from \*(m) data base to interrogate
+units@name@linear units (\fIinches,feet,millimeters,centimeters,meters\fR)
+write-input-file@file@save script of commands in \fIfile\fR
+#@@any line beginning with the `\fB#\fR' character is a comment
+.TE
+.ps +2
+.vs +2

doc/burst/defs.mm

@@ -0,0 +1,21 @@
+.ds A) \fI axis\fR
+.ds a) \fI axes\fR
+.ds B) \fB\s-1BRL-CAD\s0\fR
+.ds b) \fBburst\fR
+.ds f) \fBlibfb\fR
+.ds F) \fB\s-1FASTGEN\s0\fR
+.ds G) \fB\s-1PGEN\s0\fR
+.ds l) \fBlibrt\fR
+.ds m) \fBmged\fR
+.ds p) \fBlibplot3\fR
+.ds P) \fB\s-1PDAM\s0\fR
+.ds S) \fB\s-1SHOTGEN\s0\fR
+.ds U) \s-1UNIX\s0 \*(Tm
+.ds X) \fIX\fR
+.ds Y) \fIY\fR
+.ds Z) \fIZ\fR
+.ds x) \fIX'\fR
+.ds y) \fIY'\fR
+.ds z) \fIZ'\fR
+.ds HF 3 3 3 3 3 3 3
+.ds HP +2 +2 +2 +2 +2 +2 +2

doc/burst/fb.tbl

@@ -0,0 +1,15 @@
+.TS
+center,allbox,tab(@);
+cb cb cb cb cb
+_ _ _ _ _
+lb ci ci ci l.
+COLOR@R@G@B@REPRESENTATION
+red@255@0@0@axis of grid
+black@0@0@0@grid cell boundaries
+blue@150@100@255@outside of grid
+lt grey@200@200@200@shot missed target
+white@255@255@255@shot hit target
+lt green@200@255@200@burst occurred but hit no critical components
+pink@255@200@200@burst occurred and hit some critical components
+purple@255@0@255@a ground burst occurred
+.TE

doc/burst/hmkeys.tbl

@@ -0,0 +1,12 @@
+.TS
+center,allbox;
+cb cb
+_ _
+ci c.
+KEY	FUNCTION
+u or ^P	move cursor to item above the current item
+d or ^N	move cursor to item below the current item
+h or ?	print help message about the current item
+q	exit the current menu without making a selection
+space	select the current item
+.TE

doc/burst/ids.tbl

@@ -0,0 +1,11 @@
+.TS
+center,box;
+l.
+600-999
+1011
+4002-4050
+8000
+9001
+9004
+9005
+.TE

doc/burst/introduction.mm

@@ -0,0 +1,53 @@
+A joint-services sponsored program is currently establishing a Ballistic
+Research Laboratory-Computer Aided Design (\*(B))
+modeling capability at Eglin Air Force Base, Florida.
+Currently, the Air Force uses \*(F) to model target geometries using
+polygonal facets, two-dimensional plates, and some solid primitives.
+They also maintain compatibility with \*(S), a precursor to \*(F).
+These modelers are cumbersome to use by today's standards and the resultant
+descriptions,
+while taking an extremely long time to build,
+fall far short of the accuracy and information content of true
+combinatorial solid geometry models such as produced by
+the \fBM\fRultiple-device \fBG\fRraphics \fBED\fRitor (\*(m)),
+the \*(B) modeler.
+Along with this capability comes several key requirements,
+one of which will be addressed in this paper;
+an interface to Eglin AFB's Point Burst Damage Assessment Model (\*(P))
+from \*(B) solid models.
+.P
+The \*(b) program enables the user to direct ray tracing
+of the \*(m) models to prepare inputs to the
+\*(P) code in the form of shotline files and burst point library files.
+The program is capable of supporting analyses of varied threat
+mechanisms on \*(m) targets.
+The shotline and burst point library files are written in
+.SM ASCII
+and are supplemented with both shaded, color images
+and 3-d vector plots using the \*(B) frame buffer (\*(f)) and extended
+\*(U)
+.FS \*(Tm
+UNIX is a registered trademark of AT&T.
+.FE
+plot (\*(p)) libraries for portability to virtually all hardware
+platforms running the \*(U) operating system.
+The terminal-independent user interface employs hierarchical menus
+coupled with optional graphics displays facilitating ease of use and
+maximizing information feed back to the operator while permitting full
+featured use from any video terminal or window system.
+The menu-driven interface is coupled with an interpreter that
+accepts key word commands for batch input if the user wishes to
+detach the job to run unattended.
+These key word command files can either be prepared automatically from
+the user-selected parameters orchestrated by the menu system,
+typed in by hand with an editor,
+or perhaps generated from another process in a pipeline configuration.
+.P
+This paper is intended to serve a dual function,
+both as a technical memorandum,
+and as a user manual.
+Hopefully,
+not only will it help one appreciate why \*(b) was developed in the first place
+but will help readers decide whether they need to acquire it,
+and if so,
+how to use it.

doc/burst/macros.mm

@@ -0,0 +1,28 @@
+'\" define macro for program usage examples
+.de Ex
+.sp
+.in +0.5i
+\fI$\ \\$1\fR
+.in -0.5i
+.sp
+..
+'\" define macro for naming coordinate axes
+.de Ax
+\\$1, \\$2, and \\$3\fI axes\fR
+..
+'\" define macro for naming commands
+.de Co
+\fB\\$1\fR
+..
+'\" define macros for command descriptions.
+.de Cs                  \" Start command description.
+.br
+\s-1\fB[menu reference:\\$1]\fR\s0
+.P
+..
+.de Ce                  \" End command description.
+.sp
+..
+.de Ud
+.BI \\$1 (\\$2)\^
+..

doc/burst/outline.mm

@@ -0,0 +1,48 @@
+.so defs.mm
+.H 1 Introduction
+.H 1 "User Interface"
+.H 2 "Program Invocation"
+.H 2 "Command Input"
+.H 2 "Screen Layout"
+.H 2 "Hierarchical Menus"
+.H 2 "Scrolling Region"
+.H 1 "Shotlining Options"
+.H 2 "Attack Direction"
+.H 2 "Cell Size"
+.H 2 "Dithering"
+.H 2 "Gridding"
+.H 3 "Envelope"
+.H 4 "Enclose target"
+.H 4 "Enclose portion of target"
+.H 3 "Input shot coordinates"
+.H 4 "Target coordinate system"
+.H 5 "Type in 3-D coordinates"
+.H 5 "Read file of 3-D coordinates"
+.H 4 "Shotline coordinate system"
+.H 5 "Type in 2-D coordinates"
+.H 5 "Read file of 2-D coordinates"
+.H 1 "Bursting Options"
+.H 2 "Method of Locating Burst Point"
+.H 3 "Input burst point coordinates"
+.H 4 "Type in 3-D coordinates"
+.H 4 "Read file of 3-D coordinates"
+.H 3 "Burst on contact"
+.H 4 "Ground plane bursting"
+.H 4 "Burst on armor"
+.H 2 "Bursting Parameters"
+.H 3 "Burst distance"
+.H 3 "Sampling cone half angle"
+.H 3 "Deflected sampling cone"
+.H 3 "Number of sampling rays"
+.H 3 "Maximum barriers"
+.H 1 "Output Options"
+.H 2 "UNIX Plot File"
+.H 2 "Frame Buffer Image"
+.H 2 "Burst Point Library"
+.H 2 "Shotline File"
+.H 2 "Grid File"
+.H 2 "Script File"
+.H 2 "Error Log"
+.H 1 Conclusion
+
+

doc/burst/overlap.tbl

@@ -0,0 +1,18 @@
+.TS
+center,box,tab(@);
+l.
+OVERLAP:
+reg=/component/turret/tur.ext/tur.armor/tur.bot{{0}} isol=s2,
+reg=/component/hull/hull.ext/hull.armor/r1.top{{0}} osol=ss4,
+depth 544.21mm at (-471.784,812.8,0) x-2 y1 lvl0 purpose=shotline
+_
+OVERLAP:
+reg=/component/turret/tur.ext/tur.ring{{0}} isol=ss2,
+reg=/component/turret/tur.ext/tur.armor/tur.bot{{0}} osol=s2,
+depth 25.39mm at (-418.907,812.8,0) x-2 y1 lvl1 purpose=normal thickness
+_
+OVERLAP:
+reg=/component/turret/tur.ext/tur.ring{{0}} isol=ss2,
+reg=/component/turret/tur.ext/tur.armor/tur.bot{{0}} osol=s2,
+depth 52.88mm at (-418.907,-812.8,0) x-2 y1 lvl1 purpose=spall ray
+.TE

doc/burst/plot.tbl

@@ -0,0 +1,13 @@
+.TS
+center,allbox,tab(@);
+cb cb cb cb cb
+_ _ _ _ _
+lb ci ci ci l.
+COLOR@R@G@B@REPRESENTATION
+yellow@255@255@0@grid cell centers
+red@255@0@0@burst cone
+blue@0@0@255@default component intersection
+lt blue@100@100@255@default outside air intersection
+lt green@100@255@100@default inside air intersection
+purple@255@0@255@default critical component intersection
+.TE

doc/burst/run_doclifter.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+#MASTER=burst
+MASTER=debug
+
+doclifter -h hints.txt -x -vvvv $MASTER.mm #2>t
+
+STATUS=$?
+
+echo "doclifter return value for '$MASTER' was '$STATUS'"

doc/burst/screen.tbl

@@ -0,0 +1,54 @@
+.TS
+center,box,tab(@);
+c0 l s s s.
+@0.97 user + 1.21 sys in 6 elapsed secs (16.1667%)
+.T&
+c0   c   c   c   c
+c0 | c | c | c | c
+c0 | c | c | c | c
+c0 | c | _ | c | c
+c0 | c | c | c | c
+c0 | c | c | c | c
+c0 | c | c   _   c
+c0 | c | c   c   c .
+@_@_@_@
+@units@bursting method@burst-distance
+@project files@\fBbursting parameters\fR@\fBcone-half-angle\fR
+@target files@@deflect-spall-cone
+@shotlines@@max-spall-rays
+@\fBburst points\fR@@max-barriers
+@comment
+@execute
+@preferences
+@_@
+.sp 2
+.T&
+c0 lb s s c
+c0 lb s s c
+c0 l  s s s .
+@degrees from spall cone axis to limit burst rays
+@Cone angle ? (degrees)[45.000000]
+@___BURST (2.2)_______________________________________________
+.T&
+c0 l l.
+@error-file@tfiles/ktank.log
+@plot-file@tfiles/ktank.plot
+@image-file@/dev/sgi
+@units@inches
+@shotline-file@tfiles/ktank.shotlines
+@burst-file@tfiles/ktank.burst
+@burst-air-file@tfiles/ktank,air.ids
+@burst-armor-file@tfiles/ktank,armor.ids
+@critical-comp-file@tfiles/ktank,crit.ids
+@color-file@tfiles/ktank,colors
+@burst-distance@0
+@cell-size@16
+@attack-direction@0 0
+@max-spall-rays@50
+@cone-half-angle@45
+@target-file@/vld/moss/g/ktank.g
+@target-objects@component
+@report-overlaps@no
+@shotline-burst@yes yes
+@#ground-plane@yes 66 200 200 200 200
+.TE

doc/burst/scrollmenu.tbl

@@ -0,0 +1,12 @@
+.TS
+center;
+c c c.
+\d\s+6\s+4^\s-4\s-6\u	_	\d\s+6\s+4^\s-4\s-6\u
+|	target files	|
+|	shotlines	|
+|	burst points	|
+|	comment	|
+|	\fBexecute\fR	|
+|	preferences	|
+\s+2+\s0	_	\s+2+\s0
+.TE

doc/burst/shotlines.tbl

@@ -0,0 +1,29 @@
+.TS
+center,allbox,tab(@);
+lb lb lb
+_ _ _
+l l l.
+record description@field format@field description
+run header@'1'@record number 1
+@1x,f9.4@attack azimuth in degrees
+@1x,f8.4@attack elevation in degrees
+@1x,f7.2@shotline separation
+@1x,f7.2@maximum Y' coordinate of target
+@1x,f7.2@minimum Y' coordinate of target
+@1x,f7.2@maximum Z' coordinate of target
+@1x,f7.2@minimum Z' coordinate of target
+@1x,6a@units (\fImm,cm,inches,feet,meters\fR)
+shotline header@'2'@record number 2
+@1x,f8.3@Y' coordinate of shotline
+@1x,f8.3@Z' coordinate of shotline
+shotline intersections@'3'@record number 3
+@1x,f8.2@X' coordinate of intersection
+@1x,f7.3@sine of fallback angle of exit normal
+@1x,f7.2@rotation angle of exit normal in degrees
+@1x,i4@component code number
+@1x,f8.2@normal thickness of component
+@1x,f8.2@line-of-sight thickness of component
+@1x,i2@space code following component
+@1x,f7.2@obliquity angle at entry to component in degrees
+@1x,f7.2@obliquity angle at exit from component in degrees
+.TE

doc/burst/submenu.tbl

@@ -0,0 +1,12 @@
+.TS
+center,tab(@);
+c c c c c.
+\s+2+\s0@_@\s+2+\s0@_@\s+2+\s0
+|@units@|@\fBtarget-file\fR@|
+|@project files@|@target-objects@|
+|@\fBtarget files\fR@|@burst-air-file@|
+|@shotlines@|@burst-armor-file@|
+|@burst points@|@critical-comp-file@|
+|@comment@|@color-file@|
+\s+2v\s0@_@\s+2+\s0@_@\s+2+\s0
+.TE

doc/burst/title.mm

@@ -0,0 +1,14 @@
+.ce
+\fB``burst''; Air Force Vulnerability Analyses from BRL-CAD Models\fR
+.ce
+"\fIGary S. Moss"
+.sp
+.ce 4
+"\fRVulnerability Methodology Branch"
+"Vulnerability/Lethality Division"
+"USA Ballistic Research Laboratory"
+"SLCBR-VL-V"
+"Aberdeen Proving Ground, MD  21005-5066"
+.sp
+.ce
+"moss@vmb.brl.mil"

doc/burst/topmenu.tbl

@@ -0,0 +1,12 @@
+.TS
+center;
+c c c.
+\s+2+\s0	_	\s+2+\s0
+|	\fBunits\fR	|
+|	project files	|
+|	target files	|
+|	shotlines	|
+|	burst points	|
+|	comment	|
+\s+2v\s0	_	\s+2v\s0
+.TE

doc/code_review.txt

@@ -1,48 +0,0 @@
-BRL-CAD Code Review
-===================
-
-...what to look for during a review...
-
-Legal:
- * proper copyright statement and compatible license?
- * any indication contribution disagrees with copyright assignment?
- * if incorporating 3rd party code, prefer bsd/mit-style options
-
-Architecture:
- * proper location in hierarchy?
- * proper file name(s)?
- * is a dependency being introduced?
- * is a cyclic dependency being introduced?
- * are any global variables being introduced?
-
-Design:
- * is public API minimized?
- * is a platform symbol being used?
- * does the change reduce or violate modularity?
- * is the approach being taken reasonable?
- * is the code easy to understand?
-
-Testing:
- * compiles cleanly?
- * are warnings handled cleanly?
- * any blatant logic errors?
- * are all data inputs checked properly, sanitized?
- * if fixing a bug more than once, is there a test?
- * is a unit test warranted?
- * are there major robustness issues?
-
-Documentation:
- * if publicly visible, is NEWS updated?
- * if public API changed, is CHANGES updated?
- * if public API introduced, does every symbol have a comment?
- * if interface changed, are man page or other docs updated?
- * are numeric constants documented?
- * is suspicious, complex, risky code commented?
-
-Code:
- * conforms with style and coding standards?
- * proper indentation, formatting, whitespace?
- * are symbol names consistent?
- * is duplication being introduced, refactoring warranted?
- * is there undocumented dead / commented-out code?
- * can any code be replaced with library calls?

doc/csv_to_comgeom.txt

@@ -1,17 +0,0 @@
-These are some notes about using text manipulation tools to try taking the csv
-text files from GCI's transcription work and formatting them as comgeom files.
-I don't think they're fully working as yet, but certainly they are a starting
-point.
-
-tr "\r" "\n" < in_raw.csv > in.csv
-
-Solid table:
-
-awk -F, 'BEGIN {widthlist = "3 3 10 10 10 10 10 10 10"; split (widthlist, widths, " ")}{for(i=1;i<=NF;i++){printf "%-*s", widths[i],$i};printf "\n"}' in.csv
-
-Region table:
-awk -F, 'BEGIN {widthlist = "5 2 5 7 7 7 7 7 7 7 2 5 10"; split (widthlist, widths, " ")}{for(i=1;i<=NF;i++){printf "%-*s", widths[i],$i};printf "\n"}' in.csv
-
-Ident table:
-awk -F, 'BEGIN {widthlist = "10 10 10 43 3 3"; split (widthlist, widths, " ")}{for(i=1;i<=NF;i++){printf "%-*s", widths[i],$i};printf "\n"}' in.csv
-

doc/docbook/CMakeLists.txt

@@ -11,16 +11,13 @@ string(REPLACE " " "%20" DOCBOOK_BINARY_DIR "${CMAKE_BINARY_DIR}")
 string(REPLACE " " "%20" DOCBOOK_SOURCE_DIR "${CMAKE_SOURCE_DIR}")
 
 # Common stylesheets for all DocBook sources
-if(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_PDF OR BRLCAD_EXTRADOCS_MAN OR BRLCAD_EXTRADOCS_PHP OR BRLCAD_EXTRADOCS_PPT)
+if(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_PDF OR BRLCAD_EXTRADOCS_MAN)
   configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/brlcad/brlcad-common.xsl.in
     ${CMAKE_CURRENT_BINARY_DIR}/resources/brlcad/brlcad-common.xsl)
   # Fonts definition
   configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/brlcad/brlcad-fonts.xsl.in
     ${CMAKE_CURRENT_BINARY_DIR}/resources/brlcad/brlcad-fonts.xsl)
-  # Wordpress
-  configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/brlcad/wordpress.xsl.in
-    ${CMAKE_CURRENT_BINARY_DIR}/resources/brlcad/wordpress.xsl)
-endif(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_PDF OR BRLCAD_EXTRADOCS_MAN OR BRLCAD_EXTRADOCS_PHP OR BRLCAD_EXTRADOCS_PPT)
+endif(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_PDF OR BRLCAD_EXTRADOCS_MAN)
 
 # Files for PDF products
 if(BRLCAD_EXTRADOCS_PDF)
@@ -50,6 +47,27 @@ add_subdirectory(presentations)
 add_subdirectory(specifications)
 add_subdirectory(system)
 
+# Now that we have all the individual targets listed by the DocBook.cmake
+# macros, define convenience targets
+if(BRLCAD_EXTRADOCS_HTML)
+  get_property(BRLCAD_EXTRADOCS_HTML_TARGETS GLOBAL PROPERTY BRLCAD_EXTRADOCS_HTML_TARGETS)
+  add_custom_target(html DEPENDS ${BRLCAD_EXTRADOCS_HTML_TARGETS})
+endif(BRLCAD_EXTRADOCS_HTML)
+if(BRLCAD_EXTRADOCS_MAN)
+  get_property(BRLCAD_EXTRADOCS_MAN_TARGETS GLOBAL PROPERTY BRLCAD_EXTRADOCS_MAN_TARGETS)
+  add_custom_target(man DEPENDS ${BRLCAD_EXTRADOCS_MAN_TARGETS})
+endif(BRLCAD_EXTRADOCS_MAN)
+if(BRLCAD_EXTRADOCS_PDF)
+  get_property(BRLCAD_EXTRADOCS_PDF_TARGETS GLOBAL PROPERTY BRLCAD_EXTRADOCS_PDF_TARGETS)
+  add_custom_target(pdf DEPENDS ${BRLCAD_EXTRADOCS_PDF_TARGETS})
+endif(BRLCAD_EXTRADOCS_PDF)
+if(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_MAN OR BRLCAD_EXTRADOCS_PDF)
+  add_custom_target(doc DEPENDS
+	${BRLCAD_EXTRADOCS_HTML_TARGETS}
+	${BRLCAD_EXTRADOCS_MAN_TARGETS}
+	${BRLCAD_EXTRADOCS_PDF_TARGETS})
+endif(BRLCAD_EXTRADOCS_HTML OR BRLCAD_EXTRADOCS_MAN OR BRLCAD_EXTRADOCS_PDF)
+
 CMAKEFILES(README fop.xconf.in log4j.properties resources)
 CMAKEFILES(README.DB_authors_notes)
 CMAKEFILES(css/brlcad.css)

doc/docbook/README

@@ -24,7 +24,7 @@ lessons/
 resources/
 	The DocBook xsl files are contained within the "other"
 	subdirectory.  Also included there are various directories and
-	files associated with DB validation, fonts, and hyphenation.
+	files associated with DB validation, fonts, snd hyphenation.
 	The "brlcad" subdirectory contains files customized for
 	BRL-CAD products including common files and images.
 
@@ -68,7 +68,7 @@ the file 'README.DB_authors_notes'.
 The text character code requirements may eventually be enforced by a
 pre-commit hook script.
 
-CONVERTING MAN FORMAT TO DOCBOOK
+CONVERTING MAN FORMAT TO DOCBBOOK
 ---------------------------------
 
 The doclifter program (available in a Debian or Ubuntu distribution)
@@ -103,9 +103,9 @@ documents:
   For pdf documents:
 
     * fop
-	a java program provided by the Apache Software Foundation; note
+	a java program provide by the Apache Software Foundation; note
 	that a minimum of version 1.0 is required to use the
-	hyphenation binaries provided in the resources sub-directory
+	hyphenation binaries provided in thre resources sub-directory
 	(see http://xmlgraphics.apache.org/fop/).  Also, version 1.0
 	has some new font support features and we recommend using that
 	version (or later) for DB processing.

doc/docbook/articles/CMakeLists.txt

@@ -4,11 +4,6 @@ if(BRLCAD_EXTRADOCS_HTML)
     ${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/brlcad-article-xhtml-stylesheet.xsl)
 endif(BRLCAD_EXTRADOCS_HTML)
 
-if(BRLCAD_EXTRADOCS_PHP)
-  configure_file(${CMAKE_CURRENT_SOURCE_DIR}/../resources/brlcad/brlcad-article-xhtml-stylesheet.xsl.in
-    ${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/brlcad-article-xhtml-stylesheet.xsl)
-endif(BRLCAD_EXTRADOCS_PHP)
-
 # Files for PDF products
 if(BRLCAD_EXTRADOCS_PDF)
   # Style sheet for XSLT transformation to PDF
@@ -19,8 +14,7 @@ endif(BRLCAD_EXTRADOCS_PDF)
 # For HTML and FO (FO is an intermediate file used in the
 # XML->PDF transformation) we use variables to hold the full
 # stylesheet path.
-set(XSL_PHP_STYLESHEET "${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/wordpress.xsl")
-set(XSL_HTML_STYLESHEET "${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/brlcad-article-xhtml-stylesheet.xsl")
+set(XSL_XHTML_STYLESHEET "${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/brlcad-article-xhtml-stylesheet.xsl")
 set(XSL_FO_STYLESHEET "${CMAKE_CURRENT_BINARY_DIR}/../resources/brlcad/brlcad-article-fo-stylesheet.xsl")
 
 add_subdirectory(en)

doc/docbook/articles/en/CMakeLists.txt

@@ -1,26 +1,18 @@
-set(articles_EN
+set(docbook_articles_EN
   TEMPLATE.xml
   about.xml
-  animation_tutorial.xml
   build_pattern.xml
   build_region.xml
-  camo_shader.xml
   ebm_primitive.xml
-  gcv.xml
-  ged.xml
   mgedrc.xml
   nirt.xml
   oed.xml
   pipes.xml
   projection_shader.xml
   tire.xml
-  mged.xml
-  main_menu.xml
   )
 
-set(articles_EN_IMAGES
-  images/Lee_tux.gif
-  images/animtbl.gif
+set(docbook_articles_EN_IMAGES
   images/build_pattern_fig01.png
   images/build_pattern_fig02.png
   images/build_pattern_fig03.png
@@ -32,26 +24,12 @@ set(articles_EN_IMAGES
   images/build_region_fig02.png
   images/build_region_fig03.png
   images/build_region_fig04.png
-  images/dagtbl.gif
   images/ebm_primitive_fig01.png
   images/ebm_primitive_fig02.png
   images/ebm_primitive_fig03.png
-  images/ell.mpg
-  images/ell_sm.gif
-  images/ell_ssm.gif
-  images/equation.gif
-  images/film.gif
-  images/fn.gif
-  images/gcv_architecture.png
-  images/gcv_unsupported_tessellation.png
-  images/gcv_using_gdiff.png
-  images/matrix.gif
   images/mgedrc_fig01.png
   images/mgedrc_fig02.png
   images/mgedrc_fig03.png
-  images/moss.mpg
-  images/moss_sm.gif
-  images/moss_ssm.gif
   images/nirt_fig01.png
   images/nirt_fig02.png
   images/nirt_fig03.png
@@ -123,43 +101,14 @@ set(articles_EN_IMAGES
   images/tire_fig12.png
   images/tire_fig13.png
   images/tire_fig14.png
-  images/trans.gif
-  images/transboth.gif
-  images/transboth_sm.gif
-  images/v_eqn1.gif
-  images/v_eqn2.gif
-  images/azel.jpg
-  images/az_el.gif
-  images/az_el.jpg
-  images/az_el_sm.gif
-  images/base.gif
-  images/base.jpg
-  images/bool.gif
-  images/coord-axes.gif
-  images/cup_and_mug.gif
-  images/cup_and_mug_small.gif
-  images/cup_out+in.gif
-  images/cup_outside.gif
-  images/cup_w_handle.gif
-  images/faceplate.gif
-  images/faceplate_menu.gif
-  images/faceplate_menu_sm.gif
-  images/faceplate_sm.gif
-  images/fillet.gif
-  images/fillet.jpg
-  images/handle.gif
-  images/handle.jpg
-  images/mug_camo.gif
-  images/mug_camo.jpg
-  images/mug_green.gif
-  images/mug_green.jpg
-  images/prims.gif
-  images/rim.gif
-  images/rim.jpg
   )
-ADD_DOC(articles_EN_IMAGES html/articles/en/images)
+ADD_DOC(docbook_articles_EN_IMAGES html/articles/en/images)
 
-ADD_DOCBOOK("HTML;PHP;PDF" articles_EN articles/en articles_EN_IMAGES_cp)
+DOCBOOK_TO_HTML(article docbook_articles_EN html/articles/en docbook_articles_EN_IMAGES_cp)
+
+if(BRLCAD_EXTRADOCS_PDF)
+  DOCBOOK_TO_PDF(article docbook_articles_EN pdf/articles/en docbook_articles_EN_IMAGES_cp)
+endif(BRLCAD_EXTRADOCS_PDF)
 
 CMAKEFILES(images/tire_fig12.svg images/tire_fig13.svg)
 

doc/docbook/articles/en/TEMPLATE.xml

@@ -1,4 +1,6 @@
-<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+<?xml version="1.0"?>
+<article xmlns="http://docbook.org/ns/docbook" version="5.0"
+         xmlns:xlink="http://www.w3.org/1999/xlink">
 
   <info>
     <title>Article Title</title>
@@ -79,19 +81,12 @@
         <title>Example embedded image text.</title>
       </info>
       <mediaobject>
-        <imageobject role="html">
+        <imageobject>
           <!--
                NOTE: fileref will normally be something like
                "../../articles/en/images/nirt_fig02.png" NOT http: URL
                -->
-          <imagedata align="center" fileref="http://brlcad.org/images/logo/BRL-CAD_gear_logo_w_name_256.png" format="PNG" width="256"/>
-        </imageobject>
-        <imageobject role="fo">
-          <!--
-               NOTE: fileref will normally be something like
-               "../../articles/en/images/nirt_fig02.png" NOT http: URL
-               -->
-          <imagedata align="center" fileref="http://brlcad.org/images/logo/BRL-CAD_gear_logo_w_name_256.png" format="PNG" width="256"/>
+          <imagedata align="center" fileref="http://brlcad.org/images/logo/BRL-CAD_256x256.png" format="PNG" width="64"/>
         </imageobject>
         <caption>
           <para>
@@ -103,7 +98,7 @@
 
     <para>
       Another image, but rendered inline
-      <inlinemediaobject><imageobject role="html"><imagedata fileref="http://brlcad.org/images/logo/BRL-CAD_gear_logo_64x64.png" format="PNG" width="64"/></imageobject><imageobject role="fo"><imagedata fileref="http://brlcad.org/images/logo/BRL-CAD_gear_logo_64x64.png" format="PNG" width="64"/></imageobject></inlinemediaobject>
+      <inlinemediaobject><imageobject><imagedata fileref="http://brlcad.org/images/logo/BRL-CAD_64x64.png" format="PNG" width="64"/></imageobject></inlinemediaobject>
       with the paragraph text.
     </para>
 

doc/docbook/articles/en/about.xml

@@ -78,7 +78,7 @@
       applications comprising more than a million lines of source
       code.  The package is intentionally designed to be extensively
       cross-platform and is actively developed on and maintained for
-      many common operating system environments including BSD,
+      many common operating system environments including for BSD,
       Linux, Solaris, Mac OS X, and Windows among others.  BRL-CAD is
       distributed in binary and source code form as free open source
       software (FOSS), provided under Open Source Initiative (OSI)

doc/docbook/articles/en/build_pattern.xml

@@ -1,4 +1,8 @@
-<article xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
+<!-- Converted by db4-upgrade version 1.0 -->
+
+<article xmlns="http://docbook.org/ns/docbook" version="5.0"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+>
   <info><title>Using the Build Pattern Tool</title>
 
 
@@ -27,7 +31,7 @@
     <para>
       There are many input fields. Some stand alone, and others belong to series
       that work together to provide the needed information for a specific
-      option. Each series is denoted by a diamond-shaped check box. If the
+      option. Each series is demarked by a diamond-shaped check box. If the
       diamond is highlighted red, then all fields in that series are required.
       All required fields must be filled in for the pattern tool to work
       properly. It is also important to note that all dimensions must be in
@@ -76,10 +80,7 @@
     <figure><info><title>Example of pattern-generated assembly names.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig01.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig01.png" format="PNG"/>
 	</imageobject>
       </mediaobject>
@@ -91,7 +92,7 @@
       increment, examine the primitives of the object(s) you wish to pattern and find
       the largest span. For example, to create a pattern to the primitive level with
       the following primitives (which may or may not be in regions or
-      assemblies):
+      assemblies),
 
       <literallayout class="normal">
 part.s22 part.s22-1 part.s23 part.s24 part.s24+1 part.s24-1 part.s25,
@@ -131,7 +132,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
      thorough and name each primitive, region, and assembly properly. Consider
      the following example:
 
-     <inlinemediaobject><imageobject role="html"><imagedata fileref="../../articles/en/images/build_pattern_fig07.png"/></imageobject><imageobject role="fo"><imagedata fileref="../../articles/en/images/build_pattern_fig07.png"/></imageobject></inlinemediaobject>
+     <inlinemediaobject><imageobject><imagedata fileref="../../articles/en/images/build_pattern_fig07.png"/></imageobject></inlinemediaobject>
     </para>
     <para>
       Top-level duplications copy the patterned object and reference its entire
@@ -185,10 +186,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
     <figure><info><title>The user interface for building rectangular patterns.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig02.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig02.png" format="PNG"/>
 	</imageobject>
       </mediaobject>
@@ -242,10 +240,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
     <figure><info><title>The user interface for building spherical patterns.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig03.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig03.png" format="PNG"/>
 	</imageobject>
       </mediaobject>
@@ -268,10 +263,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
     <figure><info><title>Examples of different spherical pattern orientations.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig04.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig04.png" format="PNG"/>
 	</imageobject>
       </mediaobject>
@@ -281,10 +273,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
     <figure><info><title>Implementation of spherical patterns.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig05.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig05.png" format="PNG"/>
 	</imageobject>
       </mediaobject>
@@ -309,10 +298,7 @@ part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29
     <figure><info><title>The user interface for building cylindrical patterns.</title></info>
 
       <mediaobject>
-	<imageobject role="html">
-	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig06.png" format="PNG"/>
-	</imageobject>
-      <imageobject role="fo">
+	<imageobject>
 	  <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig06.png" format="PNG"/>
 	</imageobject>
       </mediaobject>

doc/docbook/articles/en/build_region.xml

@@ -1,4 +1,8 @@
-<article xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
+<!-- Converted by db4-upgrade version 1.0 -->
+
+<article xmlns="http://docbook.org/ns/docbook" version="5.0"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+>
   <info><title>Using the build_region Command</title>
 
 
@@ -47,10 +51,7 @@
   <figure xml:id="build_region5"><info><title>The rounded corners of a toy wagon.</title></info>
 
     <mediaobject>
-      <imageobject role="html">
-	<imagedata align="center" fileref="../../articles/en/images/build_region_fig01.png" format="PNG"/>
-      </imageobject>
-    <imageobject role="fo">
+      <imageobject>
 	<imagedata align="center" fileref="../../articles/en/images/build_region_fig01.png" format="PNG"/>
       </imageobject>
     </mediaobject>
@@ -69,10 +70,7 @@
   <figure xml:id="build_region7"><info><title>Arb8, cylinder, and two Boolean primitives.</title></info>
 
     <mediaobject>
-      <imageobject role="html">
-	<imagedata align="center" fileref="../../articles/en/images/build_region_fig02.png" format="PNG"/>
-      </imageobject>
-    <imageobject role="fo">
+      <imageobject>
 	<imagedata align="center" fileref="../../articles/en/images/build_region_fig02.png" format="PNG"/>
       </imageobject>
     </mediaobject>
@@ -106,10 +104,7 @@ u wgn.s2 + wgn.s2+1 - wgn.s2-1
   <figure xml:id="build_region9"><info><title>The region and the subtraction primitives.</title></info>
 
     <mediaobject>
-      <imageobject role="html">
-	<imagedata align="center" fileref="../../articles/en/images/build_region_fig03.png" format="PNG"/>
-      </imageobject>
-    <imageobject role="fo">
+      <imageobject>
 	<imagedata align="center" fileref="../../articles/en/images/build_region_fig03.png" format="PNG"/>
       </imageobject>
     </mediaobject>
@@ -124,10 +119,7 @@ u wgn.s2 + wgn.s2+1 - wgn.s2-1
   <figure xml:id="build_region11"><info><title>Raytraced image with hole.</title></info>
 
     <mediaobject>
-      <imageobject role="html">
-	<imagedata align="center" fileref="../../articles/en/images/build_region_fig04.png" format="PNG"/>
-      </imageobject>
-    <imageobject role="fo">
+      <imageobject>
 	<imagedata align="center" fileref="../../articles/en/images/build_region_fig04.png" format="PNG"/>
       </imageobject>
     </mediaobject>