"Fossies" - the Fresh Open Source Software Archive

Member "brlcad-7.32.4/INSTALL" (29 Jul 2021, 24955 Bytes) of package /linux/misc/brlcad-7.32.4.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "INSTALL": 7.32.0_vs_7.32.2.

    1 The Installation Guide to BRL-CAD
    2 =================================
    3 
    4 This document covers the basics of installing BRL-CAD from either a
    5 source or binary distribution.  Please see the 'Reporting Problems'
    6 section if you run into any trouble installing BRL-CAD.
    7 
    8 Some platforms have additional platform-specific documentation
    9 provided in the doc/ directory of the source distribution that should
   10 be consulted if that is the platform you are installing on.  This
   11 presently includes the following:
   12 
   13   doc/README.AIX        -- IBM's Advanced Interactive eXecutive OS
   14   doc/README.BSD        -- FreeBSD, NetBSD, OpenBSD, etc.
   15   doc/README.IRIX	-- SGI IRIX and IRIX64
   16   doc/README.Linux	-- Various Linux distributions
   17   doc/README.MacOSX	-- Apple Mac OS X
   18   doc/README.Solaris    -- Oracle Solaris, OpenIndiana (Illumos), etc.
   19   doc/README.Windows    -- Microsoft Windows
   20   doc/README.VAX        -- Virtual Address eXtension architecture from DEC.
   21                            One of the original BRL-CAD platforms. These
   22                            days, re-created using the simh simulator.
   23 
   24 
   25 TABLE OF CONTENTS
   26 -----------------
   27   Introduction
   28   Table of Contents
   29   Quick Installation
   30   Installing from Binary
   31   Installing from Source
   32   Testing Functionality
   33   Post-Installation
   34   Reporting Problems
   35   Configuration Options
   36 
   37 
   38 QUICK INSTALLATION
   39 ------------------
   40 
   41 Note that the downloaded files have two check sums calculated
   42 automatically by the Source Forge file release system.  The values are
   43 used to verify the integrity of the files as distributed.  Get those
   44 data by clicking on the 'i' button at the end of each file's name.
   45 You should ensure those data are retained and kept with the files if
   46 you re-distribute them.
   47 
   48 
   49 If you downloaded a binary distribution of BRL-CAD for your system,
   50 please read the INSTALLING FROM BINARY section of this document down
   51 below.  The rest of this quick installation section is only relevant
   52 to source code distributions of BRL-CAD.
   53 
   54 For the impatient or simplistic, the following steps should compile,
   55 test, and install an optimized BRL-CAD quickly into the
   56 /usr/brlcad/rel-VERSION directory if CMake is already installed:
   57 
   58   tar -zxvf brlcad-VERSION.tar
   59   mkdir brlcad-VERSION/build
   60   cd brlcad-VERSION/build
   61   cmake .. -DBRLCAD_BUNDLED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
   62   make -j4
   63   make check
   64   make install
   65 
   66 See the REPORTING PROBLEMS section of this document to report any
   67 problems or the INSTALLING FROM SOURCE section for more comprehensive
   68 instructions.
   69 
   70 Once installed, add /usr/brlcad/rel-VERSION/bin to your path, and you should be
   71 able to run any of the 400+ applications that constitute BRL-CAD.  For
   72 example, to run the MGED solid modeler:
   73 
   74 PATH=/usr/brlcad/rel-VERSION/bin:$PATH ; export PATH
   75 mged
   76 
   77 If you use tcsh or another C-shell based command shell, use this
   78 instead:
   79 
   80 set path=( /usr/brlcad/rel-VERSION/bin $path ) ; rehash
   81 mged
   82 
   83 
   84 INSTALLING FROM BINARY
   85 ----------------------
   86 
   87 There are a variety of different kinds of binary distributions of
   88 BRL-CAD.  Some of the binary distributions are sufficiently generic and
   89 are simply a binary compressed tarball distribution.  Others are
   90 specific to a particular platform such as Debian, Mac OS X, FreeBSD,
   91 and Windows etc.
   92 
   93 
   94 Generic Binary Distributions:
   95 
   96 For the unspecialized binary distributions that are basically
   97 compressed tarballs of the installation root, they should contain the
   98 entire hierarchy of the distribution.  To put that hierarchy in its
   99 "installed" location, you just create the directory and move the
  100 expanded tarball contents:
  101 
  102 gunzip BRL-CAD_7.2.4_Linux_ia64.tar.gz
  103 tar -xvf BRL-CAD_7.2.4_Linux_ia64.tar
  104 sudo mkdir /usr/brlcad/rel-7.2.4
  105 sudo mv BRL-CAD_7.2.4_Linux_ia64/* /usr/brlcad/rel-7.2.4/
  106 
  107 Of course, there are other compression options possible including zip
  108 and bzip2.  By default, BRL-CAD expects to be installed into
  109 /usr/brlcad/rel-7.2.4. On some platforms the binary may be relocatable,
  110 but this is not guaranteed. It's recommended that you start from a source
  111 distribution if you would like to install into an alternate installation
  112 location.  That said, if you do desire to install and/or run BRL-CAD from
  113 a different location, give it a try...on some platforms it will work.
  114 
  115 Something to be aware of, even if a binary distribution IS relocatable:
  116 it will use its local copies of things like libraries only so long as the
  117 "final" installed target directory that the build was compiled for
  118 does not contain a BRL-CAD installation.  Due to the way path logic
  119 is set, an installed copy of a library in the correct location will
  120 always be loaded first, regardless of the presence of a "local" copy.
  121 
  122 
  123 Mac OS X Disk Mounting Image:
  124 
  125 Mount the .dmg and run the Installer .pkg contained therein.  This
  126 will install into /usr/brlcad/rel-X.Y.Z and will only require
  127 confirming that your environment is set up properly (i.e. add
  128 /usr/brlcad/rel-X.Y.Z/bin to your path) as described in the Quick
  129 Installation section.
  130 
  131 
  132 INSTALLING FROM SOURCE
  133 ----------------------
  134 
  135 There are a couple of ways to obtain the BRL-CAD sources, usually via
  136 one of the following starting points:
  137 
  138   1) from a Git checkout, or
  139   2) from a source distribution tarball
  140 
  141 Using the latest Git sources is recommended where possible since it
  142 will have the latest changes.
  143 
  144 There are many different ways to build BRL-CAD and depending on what
  145 you need/want will determine which configuration options you should
  146 use.  See the CONFIGURATION OPTIONS section below for details on how
  147 to go about selecting which options are appropriate for you.
  148 
  149 By default, the default configuration will prepare the build system
  150 to perform a Debug build and install into the /usr/brlcad/dev-X.Y.Z
  151 directory.   The CMAKE_INSTALL_PREFIX option may be used to change
  152 that directory, or a Release build type may be specified to install to
  153 /usr/brlcad/rel-X.Y.Z - more on this below.  The
  154 tradition of non-system installation paths goes back a couple of decades
  155 and is a convenient means to isolate the BRL-CAD solid modeling
  156 system from your system, resolves conflicts, facilitates uninstalls,
  157 and simplifies upgrades.  The default configuration is performed by
  158 running `cmake'.  It is not required to do the build in a directory
  159 different from your source directory, but it is much cleaner and
  160 *highly* recommended - this guide will illustrate the build process
  161 with the assumption that the BRL-CAD source code is in the directory
  162 brlcad-7.2.4 and the directory intended to hold the build output is
  163 brlcad-build, located in the same parent directory as brlcad-7.2.4:
  164 
  165   .
  166   ./brlcad-7.2.4
  167   ./brlcad-build
  168 
  169 To start the build process, cd into brlcad-build and run CMake,
  170 pointing it to the source directory:
  171 
  172   cd brlcad-build
  173   cmake ../brlcad-7.2.4
  174 
  175 As mentioned earlier, CMake uses two "build types", controlled by
  176 the CMAKE_BUILD_TYPE variable, that are useful for specific purposes:
  177 
  178 * Debug (-DCMAKE_BUILD_TYPE=Debug) - Debug is the configuration that most
  179   developers will want to use when working on BRL-CAD.  It will add
  180   debug flags to the compile, and sets the default install directory to
  181   be /usr/brlcad/dev-X.Y.Z - in order to run the resulting installed
  182   binaries, the developer should ensure that the dev-X.Y.Z  path is
  183   first in his or her PATH environment variable.
  184 
  185 * Release (-DCMAKE_BUILD_TYPE=Release) - A release build is intended for
  186   final consumption by end users and as such has optimizations enabled.
  187   It also sets the install path to /usr/brlcad/rel-X.Y.Z - best practice
  188   for release installation is to set up symbolic links in /usr/brlcad to
  189   point to the most current BRL-CAD release, while allowing older versions
  190   to remain installed on the system in case they are needed.
  191 
  192 In both of these cases any individual variable may be overridden - for
  193 example, setting -DCMAKE_INSTALL_PREFIX=/usr/brlcad in a Debug build will
  194 override the ../brlcad-install default.  Build types are a convenient way
  195 to bundle sets of settings, but they do not prevent overrides if a more
  196 custom setup is needed.
  197 
  198 By default, all components and functionality will be built.
  199 Note that BRL-CAD does require and include several 3rd party
  200 components.  If your system does not include a sufficient version of
  201 those required 3rd party components, they will be automatically
  202 configured for compilation.
  203 
  204 If the autodetection mechanisms fail to produce a working configuration,
  205 the next simplest approach is typically to enable ALL the third party
  206 components - this is typically a well tested configuration, but will
  207 increase both the build time and final install size of BRL-CAD on
  208 the system.  To set this variable on the command line, use -D to
  209 define BRLCAD_BUNDLED_LIBS for CMake:
  210 
  211   -DBRLCAD_BUNDLED_LIBS=Bundled
  212 
  213 If the graphical interface (cmake-gui) is in use, it will list this
  214 and other common options by default, allowing the user change them
  215 graphically.  This is often quicker and more convenient than
  216 defining options on the command line, but both will work.
  217 
  218 You can also force on or off any individual 3rd party library by
  219 setting the BRL-CAD variable for that feature to either on or off:
  220 
  221   -DBRLCAD_<LIBRARY>=ON
  222 
  223 Other variables control BRL-CAD features.  For example, to NOT
  224 enable functionality using OpenGL, set
  225 
  226   -DBRLCAD_ENABLE_OPENGL=OFF
  227 
  228 To obtain an optimized build (for example, for BRL-CAD Benchmark
  229 performance evaluation), enable BRLCAD_FLAGS_OPTIMIZATION:
  230 
  231   -DBRLCAD_FLAGS_OPTIMIZATION=ON
  232 
  233 Profile-guided optimization builds are possible via two-pass
  234 compilation.  Compile with this flag set, run the benchmark suite,
  235 clean the build, and then compile again with this flag set.  Supported
  236 compilers will utilize data from the first pass to guide optimization,
  237 typically resulting in a significant performance increase:
  238 
  239   -DBRLCAD_PGO=ON
  240 
  241 See the CONFIGURATION OPTIONS below for more details on all of the
  242 possible settings.
  243 
  244 You can specify options or preferences you want to always use by
  245 default.  For example, to always enable all local libs the following
  246 line can be added to your own configuration file:
  247 
  248   set(BRLCAD_BUNDLED_LIBS "Bundled" CACHE STRING "Enable all local libs")
  249 
  250 You can define your own configuration file in one of three ways.  The
  251 build system will search for the file in this order:
  252 
  253   ${BRLCAD_SOURCE_DIR}/../BRL-CAD_CONFIG.GLOBAL
  254 
  255   ${BRLCAD_SOURCE_DIR}/BRL-CAD_CONFIG.GLOBAL
  256 
  257   the file defined in the environment variable "BRLCAD_USER_GLOBAL_CONFIG_FILE"
  258 
  259 The build system will use the first file defined that exists.
  260 
  261 Once configured, you should be able to successfully build BRL-CAD via
  262 make:
  263 
  264   make
  265 
  266 (On multicore systems, adding the -j flag (e.g. -j6) is recommended)
  267 
  268 Installing the Compilation:
  269 
  270 After the build successfully completes and assuming the benchmark also
  271 produces correct results, installation may begin.  Like any package,
  272 you must have sufficient filesystem permissions to install.  To
  273 install into a system location, you can generally either become a
  274 super user via the su command and run
  275 
  276   make install
  277 
  278 or on operating systems set up to use sudo:
  279 
  280   sudo make install
  281 
  282 
  283 TESTING FUNCTIONALITY
  284 ---------------------
  285 
  286 The primary build target to validate a compilation of BRL-CAD is:
  287 
  288   make check
  289 
  290 That runs a trio of test sets including "benchmark", "regress", and
  291 "unit".  The first set is a performance test that also validates
  292 whether ray tracing behavior is correct:
  293 
  294   make benchmark
  295 
  296 The second test set is our regression tests that run a host of
  297 rigorous integration tests and validate essential behavior:
  298 
  299   make regress
  300 
  301 The third set runs unit tests that validate low-level behavior in
  302 BRL-CAD's core libraries:
  303 
  304   make unit
  305 
  306 Last but not least, one may simply run all available tests, though
  307 note that some tests will intentionally fail:
  308 
  309   make test
  310 
  311 
  312 POST-INSTALLATION
  313 -----------------
  314 
  315 Permissions:
  316 
  317 Something to be aware of with CMake installations is that umask settings
  318 are ignored by current versions of CMake.  It is a common situation in
  319 Unix environments to want "group" members to have read/write access -
  320 to achieve this, after installation the following find command can be
  321 run (of course, substituting the actual BRL-CAD version for X.Y.Z):
  322 
  323 find /usr/brlcad/rel-X.Y.Z -type d -exec chmod ug+rwx {} \; -exec chmod o+rx {} \; -o -type f -exec chmod ug+rw {} \; -exec chmod o+r {} \;
  324 
  325 The above 'find' line will set up permissions across a /usr/brlcad
  326 rooted installation such that 'user' and 'group' will have read-write
  327 access and 'other' will have read access consistently across all
  328 files.
  329 
  330 
  331 System PATH:
  332 
  333 Normally, BRL-CAD's install directories are not in system PATH lists and
  334 consequently BRL-CAD's executables will not be invokable without specifying
  335 their full path.  This is normally handled in Unix environments by adding
  336 the desired BRL-CAD installation's binary directory to the user's local path:
  337 
  338 In the bash shell: export PATH=/usr/brlcad/rel-X.Y.Z:$PATH
  339 In the csh shell:  setenv PATH /usr/brlcad/rel-X.Y.Z:$PATH
  340 
  341 REPORTING PROBLEMS
  342 ------------------
  343 
  344 Please report any bugs encountered to the project bug tracker at
  345 http://sourceforge.net/tracker/?group_id=105292&atid=640802
  346 
  347 Similarly, please post any request for feature enhancements or support
  348 to http://sourceforge.net/tracker/?group_id=105292&atid=640805 and
  349 http://sourceforge.net/tracker/?group_id=105292&atid=640803
  350 respectively.
  351 
  352 
  353 CONFIGURATION OPTIONS
  354 ---------------------
  355 
  356 --- BRLCAD_BUNDLED_LIBS ---
  357 
  358 Enables compilation of all 3rd party sources that are provided within a BRL-CAD
  359 source distribution.  If used this option sets all other 3rd party library
  360 build flags to ON by default.  However, that setting can be overridden by
  361 manually setting individual variables. Default is "AUTO" - 3rd party sources
  362 are compiled only if they are not detected as being available and functioning
  363 as expected.
  364 
  365 Aliases:  ENABLE_ALL
  366 
  367 
  368 --- BRLCAD_ENABLE_OPENGL ---
  369 
  370 Enable support for OpenGL based Display Managers in BRL-CAD.
  371 Default depends on whether OpenGL is successfully detected -
  372 if it is, default is to enable.
  373 
  374 Aliases:  ENABLE_OPENGL
  375 
  376 
  377 --- BRLCAD_ENABLE_RUNTIME_DEBUG ---
  378 
  379 Enables support for application and library debugging facilities.
  380 Disabling the run-time debugging facilities can provide a significant
  381 (10%-30%) performance boost at the expense of extensive error
  382 checking (that in turn help prevent corruption of your data).
  383 Default is "ON", and should only be disabled for read-only render
  384 work where performance is critical.
  385 
  386 Aliases:  ENABLE_RUNTIME_DEBUG, ENABLE_RUN_TIME_DEBUG, ENABLE_RUNTIME_DEBUGGING
  387           ENABLE_RUN_TIME_DEBUGGING
  388 
  389 
  390 --- BRLCAD_FLAGS_DEBUG ---
  391 
  392 Add compiler flags to aid in program debugging.  Defaults to ON.
  393 
  394 Aliases:  ENABLE_DEBUG, ENABLE_FLAGS_DEBUG, ENABLE_DEBUG_FLAGS
  395 
  396 
  397 --- BRLCAD_ENABLE_COMPILER_WARNINGS ---
  398 
  399 Use extra compiler warning flags when compiling C/C++ code.  Defaults to ON.
  400 
  401 Aliases:  ENABLE_WARNINGS, ENABLE_COMPILER_WARNINGS
  402 
  403 
  404 --- BRLCAD_ENABLE_STRICT ---
  405 
  406 Causes all compilation warnings for C code to be treated as errors.  This is now
  407 the default for BRL-CAD source code, and developers should address issues
  408 discovered by these flags whenever possible rather than disabling strict
  409 mode.
  410 
  411 Aliases:  ENABLE_STRICT, ENABLE_STRICT_COMPILE, ENABLE_STRICT_COMPILE_FLAGS
  412 
  413 
  414 --- ENABLE_ALL_CXX_COMPILE ---
  415 
  416 Build all C and C++ files with a C++ compiler.  Defaults to OFF.
  417 
  418 EXPERIMENTAL!
  419 
  420 Aliases:  ENABLE_ALL_CXX
  421 
  422 
  423 --- BRLCAD_EXTRADOCS ---
  424 
  425 The core option that enables and disables building of BRL-CAD's
  426 DocBook based documentation (includes manuals and man pages for
  427 commands, among other things).  Defaults to ON, but only HTML and MAN
  428 formats are enabled by default - PDF must be enabled separately by use
  429 of this option or one of its aliases.  Note that you may set
  430 environment variable APACHE_FOP to point to your locally installed fop
  431 executable file (which on Linux is usually a shell script with 0755
  432 permissions).
  433 
  434 Aliases:  ENABLE_DOCS, ENABLE_EXTRA_DOCS, ENABLE_DOCBOOK
  435 
  436 
  437 --- BRLCAD_LEMON ---
  438 
  439 Option for enabling and disabling compilation of the lemon parser
  440 provided with BRL-CAD's source distribution.  Default is AUTO,
  441 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  442 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  443 
  444 Aliases:  ENABLE_LEMON
  445 
  446 
  447 --- BRLCAD_RE2C ---
  448 
  449 Option for enabling and disabling compilation of the re2c scanner
  450 utility provided with BRL-CAD's source distribution.  Default is AUTO,
  451 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  452 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  453 
  454 Aliases:  ENABLE_RE2C
  455 
  456 
  457 --- BRLCAD_PERPLEX ---
  458 
  459 Option for enabling and disabling compilation of the perplex scanner
  460 generator provided with BRL-CAD's source distribution.  Default is
  461 AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and
  462 testing first for a system version if BRLCAD_BUNDLED_LIBS is also
  463 AUTO.  perplex requires a working re2c.
  464 
  465 Aliases:  ENABLE_PERPLEX
  466 
  467 
  468 --- BRLCAD_ASTYLE ---
  469 
  470 Option for enabling and disabling compilation of the Artistic Style
  471 (astyle) utility provided with BRL-CAD's source distribution.  Default is
  472 AUTO,
  473 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  474 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  475 
  476 Aliases:  ENABLE_ASTYLE
  477 
  478 
  479 --- BRLCAD_XSLTPROC ---
  480 
  481 Option for enabling and disabling compilation of the xsltproc XML
  482 transformation utility provided with BRL-CAD's source distribution.
  483 Used for DocBook documentation processing.  Default is AUTO,
  484 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  485 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  486 Depends on BRLCAD_EXTRADOCS.
  487 
  488 Aliases:  ENABLE_XSLTPROC
  489 
  490 
  491 --- BRLCAD_XMLLINT ---
  492 
  493 Option for enabling and disabling compilation of the xmllint XML
  494 validation utility provided with BRL-CAD's source distribution.  Used
  495 for DocBook documentation validation.  Default is AUTO, responsive to
  496 the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
  497 version if BRLCAD_BUNDLED_LIBS is also AUTO.
  498 
  499 Aliases:  ENABLE_XMLLINT
  500 
  501 
  502 --- BRLCAD_REGEX ---
  503 
  504 Option for enabling and disabling compilation of the Regular
  505 Expression Library provided with BRL-CAD's source distribution.
  506 Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option
  507 and testing first for a system version if BRLCAD_BUNDLED_LIBS is also
  508 AUTO.
  509 
  510 Aliases:  ENABLE_REGEX
  511 
  512 
  513 --- BRLCAD_ZLIB ---
  514 
  515 Option for enabling and disabling compilation of the zlib library
  516 provided with BRL-CAD's source distribution.  Default is AUTO,
  517 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  518 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  519 
  520 Aliases:  ENABLE_ZLIB, ENABLE_LIBZ
  521 
  522 
  523 --- BRLCAD_PNG ---
  524 
  525 Option for enabling and disabling compilation of the Portable Network
  526 Graphics library provided with BRL-CAD's source distribution.  Default
  527 is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and
  528 testing first for a system version if BRLCAD_BUNDLED_LIBS is also
  529 AUTO.
  530 
  531 Aliases:  ENABLE_PNG
  532 
  533 
  534 --- BRLCAD_NETPBM ---
  535 
  536 Option for enabling and disabling compilation of the netpbm library
  537 provided with BRL-CAD's source code.  Default is AUTO, responsive to
  538 the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
  539 version if BRLCAD_BUNDLED_LIBS is also AUTO.
  540 
  541 Aliases:  ENABLE_NETPBM
  542 
  543 
  544 --- BRLCAD_UTAHRLE ---
  545 
  546 Option for enabling and disabling compilation of the Utah Raster
  547 Toolkit library provided with BRL-CAD's source code.  Default is AUTO,
  548 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  549 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  550 
  551 Aliases:  ENABLE_UTAHRLE
  552 
  553 
  554 --- BRLCAD_TCL ---
  555 
  556 Option for enabling and disabling compilation of the Tcl library
  557 provided with BRL-CAD's source code.  Default is AUTO, responsive to
  558 the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
  559 version if BRLCAD_BUNDLED_LIBS is also AUTO.
  560 
  561 Aliases:  ENABLE_TCL
  562 
  563 
  564 --- BRLCAD_TK ---
  565 
  566 Option for enabling and disabling compilation of the Tk library
  567 provided with BRL-CAD's source code.  Default is AUTO, responsive to
  568 the BRLCAD_TCL option and testing first for a system version if
  569 BRLCAD_BUNDLED_LIBS is also AUTO. Option for enabling and disabling
  570 compilation of the Tk graphics package for Tcl provided with BRL-CAD's
  571 source distribution.  Default is AUTO, auto-enabling if the BRLCAD_TCL
  572 option is set to BUNDLED and testing first for a system version if
  573 BRLCAD_TCL is set to AUTO or SYSTEM.  If BRLCAD_TK is set to BUNDLED,
  574 local copy is built even if a system version is present.  This option
  575 also depends on BRLCAD_ENABLE_TK being ON.
  576 
  577 Aliases:  ENABLE_TK
  578 
  579 
  580 --- BRLCAD_ITCL ---
  581 
  582 Option for enabling and disabling compilation of the IncrTcl package
  583 for Tcl objects provided with BRL-CAD's source distribution.  Default
  584 is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and
  585 testing first for a system version if BRLCAD_TCL is set to AUTO or
  586 SYSTEM.  If BRLCAD_ITCL is set to BUNDLED, local copy is built even if
  587 a system version is present.
  588 
  589 Aliases:  ENABLE_ITCL
  590 
  591 
  592 --- BRLCAD_ITK ---
  593 
  594 Option for enabling and disabling compilation of the IncrTcl itk
  595 package for Tk objects provided with BRL-CAD's source distribution.
  596 Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to
  597 BUNDLED and testing first for a system version if BRLCAD_TCL is set to
  598 AUTO or SYSTEM.  If BRLCAD_ITK is set to BUNDLED, local copy is built
  599 even if a system version is present.  This package will be disabled if
  600 BRLCAD_ENABLE_TK is OFF.
  601 
  602 Aliases:  ENABLE_ITK
  603 
  604 
  605 --- BRLCAD_IWIDGETS ---
  606 
  607 Option for enabling and disabling compilation of the IWidgets Tk
  608 widget package provided with BRL-CAD's source distribution.  Default
  609 is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and
  610 testing first for a system version if BRLCAD_TCL is set to AUTO or
  611 SYSTEM.  If BRLCAD_IWIDGETS is set to BUNDLED, local copy is built even if
  612 a system version is present.  This package will be disabled if
  613 BRLCAD_ENABLE_TK is OFF.
  614 
  615 Aliases:  ENABLE_IWIDGETS
  616 
  617 
  618 --- BRLCAD_TKHTML ---
  619 
  620 Option for enabling and disabling compilation of the Tkhtml HTML
  621 viewing package provided with BRL-CAD's source distribution.  Default
  622 is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and
  623 testing first for a system version if BRLCAD_TCL is set to AUTO or
  624 SYSTEM.  If BRLCAD_TKHTML is set to BUNDLED, local copy is built even if
  625 a system version is present.  This package will be disabled if
  626 BRLCAD_ENABLE_TK is OFF.
  627 
  628 Aliases:  ENABLE_TKHTML
  629 
  630 
  631 --- BRLCAD_TKTABLE ---
  632 
  633 Option for enabling and disabling compilation of the Tktable graphical
  634 table widget package provided with BRL-CAD's source distribution.
  635 Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to
  636 BUNDLED and testing first for a system version if BRLCAD_TCL is set to
  637 AUTO or SYSTEM.  If BRLCAD_TKTABLE is set to BUNDLED, local copy is built
  638 even if a system version is present.  This package will be disabled if
  639 BRLCAD_ENABLE_TK is OFF.
  640 
  641 Aliases:  ENABLE_TKTABLE
  642 
  643 
  644 --- BRLCAD_OPENNURBS ---
  645 
  646 Option for enabling and disabling compilation of the openNURBS library
  647 provided with BRL-CAD's source code.  Default is AUTO, responsive to
  648 the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
  649 version if BRLCAD_BUNDLED_LIBS is also AUTO.
  650 
  651 Aliases:  ENABLE_OPENNURBS
  652 
  653 
  654 --- BRLCAD_SC ---
  655 
  656 Option for enabling and disabling compilation of the NIST Step Class
  657 Libraries provided with BRL-CAD's source code.  Default is AUTO,
  658 responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing
  659 first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO.
  660 
  661 Aliases:  ENABLE_SCL, ENABLE_STEP, ENABLE_STEP_CLASS_LIBRARIES
  662 
  663 
  664 --- BRLCAD_OSG ---
  665 
  666 Option for enabling and disabling compilation of the OpenSceneGraph
  667 libraries provided with BRL-CAD's source code.  Default is AUTO, responsive to
  668 the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system
  669 version if BRLCAD_BUNDLED_LIBS is also AUTO.
  670 
  671 Aliases:  ENABLE_OPENSCENEGRAPH
  672 
  673 
  674 --- BRLCAD_PROJ4 ---
  675 
  676 Option for enabling and disabling compilation of the PROJ.4 geographic
  677 projection library provided with BRL-CAD's source code.  Default
  678 is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and
  679 testing first for a system version if BRLCAD_BUNDLED_LIBS is also
  680 AUTO.
  681 
  682 Aliases:  ENABLE_PROJ4
  683 
  684 
  685 --- BRLCAD_GDAL ---
  686 
  687 Option for enabling and disabling compilation of the GDAL geographic
  688 library provided with BRL-CAD's source code.  Default
  689 is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and
  690 testing first for a system version if BRLCAD_BUNDLED_LIBS is also
  691 AUTO.
  692 
  693 Aliases:  ENABLE_GDAL
  694 
  695 
  696 
  697 *** Note - Do not add or edit configuration option descriptions and alias
  698    lists in this file - those entries are auto-generated from information in
  699    the toplevel CMakeLists.txt file and src/other/CMakeLists.txt - any changes
  700    should be made in those files.  The CMake configuration process will
  701    automatically re-generate INSTALL with the new descriptions and alias
  702    information.