Revision: 77902
http://sourceforge.net/p/brlcad/code/77902
Author: starseeker
Date: 2020-12-03 17:18:03 +0000 (Thu, 03 Dec 2020)
Log Message:
-----------
fix line wrapping
Modified Paths:
--------------
brlcad/trunk/misc/CMake/BRLCAD_User_Options.cmake
Modified: brlcad/trunk/misc/CMake/BRLCAD_User_Options.cmake
===================================================================
--- brlcad/trunk/misc/CMake/BRLCAD_User_Options.cmake 2020-12-03 17:17:33 UTC
(rev 77901)
+++ brlcad/trunk/misc/CMake/BRLCAD_User_Options.cmake 2020-12-03 17:18:03 UTC
(rev 77902)
@@ -33,26 +33,26 @@
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
###
-#
-# Now we define the various options for BRL-CAD - ways to enable and
-# disable features, select which parts of the system to build, etc.
-# As much as possible, sane default options are either selected or
-# detected. Because documentation is autogenerated for BRL-CAD
-# options, be sure to initialize the file.
+# Now we define the various options for BRL-CAD - ways to enable and disable
+# features, select which parts of the system to build, etc. As much as
+# possible, sane default options are either selected or detected. Because
+# documentation is autogenerated for BRL-CAD options, be sure to initialize the
+# file.
set(CONFIG_OPT_STRING "CONFIGURATION OPTIONS\n---------------------\n")
file(WRITE "${CMAKE_BINARY_DIR}/BRLCAD_OPTIONS" "${CONFIG_OPT_STRING}")
-# Build shared libs by default. Mark this as advanced - turning off
-# ALL shared library building is unlikely to result in a working build
-# and is not a typical configuration. Note that turning this option off
-# will not disable libraries specifically added as SHARED.
+
+# Build shared libs by default. Mark this as advanced - turning off ALL shared
+# library building is unlikely to result in a working build and is not a
+# typical configuration. Note that turning this option off will not disable
+# libraries specifically added as SHARED.
option(BUILD_SHARED_LIBS "Build shared libraries" ON)
mark_as_advanced(BUILD_SHARED_LIBS)
-# Build static libs by default unless we're debugging. Note: this
-# option will not disable libraries specifically added as STATIC even
-# when OFF. For multi-configuration options the build type determination
-# is made at build time, so just default to "ON".
+# Build static libs by default unless we're debugging. Note: this option will
+# not disable libraries specifically added as STATIC even when OFF. For
+# multi-configuration options the build type determination is made at build
+# time, so just default to "ON".
if(NOT CMAKE_BUILD_TYPE)
set(CBT "MULTICONFIG")
else(NOT CMAKE_BUILD_TYPE)
@@ -65,12 +65,11 @@
option(BRLCAD_ENABLE_BRLCAD_LIBRARY "Build the brlcad.dll" OFF)
mark_as_advanced(BRLCAD_ENABLE_BRLCAD_LIBRARY)
-# Global third party controls - these options enable and disable ALL
-# local copies of libraries in src/other. Forcing all local
-# libraries off is not usually recommended unless attempting to
-# build packages for a distribution. If both of these options are
-# on the enabling of local packages is the "senior" option and will
-# force the system libs option to off.
+# Global third party controls - these options enable and disable ALL local
+# copies of libraries in src/other. Forcing all local libraries off is not
+# usually recommended unless attempting to build packages for a distribution.
+# If both of these options are on the enabling of local packages is the
+# "senior" option and will force the system libs option to off.
set(BRLCAD_BUNDLED_LIBS_DESCRIPTION "
Enables compilation of all 3rd party sources that are provided within a BRL-CAD
source distribution. If used this option sets all other 3rd party library
@@ -109,9 +108,9 @@
endif(BRLCAD_ENABLE_MINIMAL)
# Enable Aqua widgets on Mac OSX. This impacts Tcl/Tk building and OpenGL
-# building. Not currently working - needs work in at least Tk
-# CMake logic (probably more), and the display manager/framebuffer codes are
known to depend
-# on either GLX or WGL specifically in their current forms.
+# building. Not currently working - needs work in at least Tk CMake logic
+# (probably more), and the display manager/framebuffer codes are known to
+# depend on either GLX or WGL specifically in their current forms.
option(BRLCAD_ENABLE_AQUA "Use Aqua instead of X11 whenever possible on OSX."
OFF)
mark_as_advanced(BRLCAD_ENABLE_AQUA)
@@ -118,8 +117,8 @@
# Install example BRL-CAD Geometry Files
option(BRLCAD_INSTALL_EXAMPLE_GEOMETRY "Install the example BRL-CAD geometry
files." ON)
-# test for X11 on all platforms since we don't know when/where we'll find it,
unless
-# we've indicated we *don't* want an X11 build
+# test for X11 on all platforms since we don't know when/where we'll find it,
+# unless we've indicated we *don't* want an X11 build
if(NOT BRLCAD_ENABLE_AQUA AND NOT BRLCAD_ENABLE_MINIMAL)
include(FindX11)
if (X11_Xrender_FOUND)
@@ -158,9 +157,8 @@
endif(BRLCAD_ENABLE_X11)
mark_as_advanced(OPENGL_USE_AQUA)
-# Enable/disable features requiring the Tcl/Tk toolkit - usually this should
-# be on, as a lot of functionality in BRL-CAD depends on Tcl/Tk
-
+# Enable/disable features requiring the Tcl/Tk toolkit - usually this should be
+# on, as a lot of functionality in BRL-CAD depends on Tcl/Tk
option(BRLCAD_ENABLE_TCL "Enable features requiring the Tcl toolkit" ON)
cmake_dependent_option(BRLCAD_ENABLE_TK "Enable features requiring the Tk
toolkit" ON "BRLCAD_ENABLE_TCL" OFF)
mark_as_advanced(BRLCAD_ENABLE_TCL BRLCAD_ENABLE_TK)
@@ -172,13 +170,12 @@
endif(BRLCAD_ENABLE_X11)
# Enable features requiring OPENGL
-# Be smart about this - if we don't have X11 or Aqua and we're
-# not on Windows, we're non-graphical and that means OpenGL is
-# a no-go. The Windows version would have to be some sort of
-# option for the WIN32 graphics layer? Should probably think
-# about that... for now, on Win32 don't try OpenGL if Tk is
-# off. That'll hold until we get a non-Tk based GUI - then
-# setting non-graphical on Windows will take more thought.
+# Be smart about this - if we don't have X11 or Aqua and we're not on Windows,
+# we're non-graphical and that means OpenGL is a no-go. The Windows version
+# would have to be some sort of option for the WIN32 graphics layer? Should
+# probably think about that... for now, on Win32 don't try OpenGL if Tk is off.
+# That'll hold until we get a non-Tk based GUI - then setting non-graphical on
+# Windows will take more thought.
if(NOT BRLCAD_ENABLE_X11 AND NOT BRLCAD_ENABLE_AQUA AND NOT WIN32)
set(OPENGL_FOUND OFF)
set(BRLCAD_ENABLE_OPENGL OFF CACHE BOOL "Disabled - NOT BRLCAD_ENABLE_X11
and NOT BRLCAD_ENABLE_AQUA" FORCE)
@@ -276,15 +273,16 @@
CONFIG_H_APPEND(BRLCAD "#define USE_BINARY_ATTRIBUTES 1\n")
endif(BRLCAD_ENABLE_BINARY_ATTRIBUTES)
-#----------------------------------------------------------------------
-# The following are fine-grained options for enabling/disabling compiler
-# and source code definition settings. Typically these are set to
-# various configurations by the toplevel CMAKE_BUILD_TYPE setting, but
-# can also be individually set.
-# Enable/disable runtime debugging - these are protections for
-# minimizing the possibility of corrupted data files. Generally
-# speaking these should be left on.
+#------------------------------------------------------------------------------
+# The following are fine-grained options for enabling/disabling compiler and
+# source code definition settings. Typically these are set to various
+# configurations by the toplevel CMAKE_BUILD_TYPE setting, but can also be
+# individually set.
+
+# Enable/disable runtime debugging - these are protections for minimizing the
+# possibility of corrupted data files. Generally speaking these should be left
+# on.
set(BRLCAD_ENABLE_RUNTIME_DEBUG_ALIASES
ENABLE_RUNTIME_DEBUG
ENABLE_RUN_TIME_DEBUG
@@ -320,8 +318,8 @@
CONFIG_H_APPEND(BRLCAD "#define NO_DEBUG_CHECKING 1\n")
endif(NOT BRLCAD_ENABLE_RUNTIME_DEBUG)
-# Enable debug flags during compilation - we always want to use these
-# unless explicitly told not to.
+# Enable debug flags during compilation - we always want to use these unless
+# explicitly told not to.
set(BRLCAD_FLAGS_DEBUG_DESCRIPTION "
Add compiler flags to aid in program debugging. Defaults to ON.
")
@@ -330,8 +328,8 @@
ALIASES ENABLE_DEBUG ENABLE_FLAGS_DEBUG ENABLE_DEBUG_FLAGS
DESCRIPTION BRLCAD_FLAGS_DEBUG_DESCRIPTION)
-# A variety of debugging messages in the code key off of the DEBUG
-# definition - set it according to whether we're using debug flags.
+# A variety of debugging messages in the code key off of the DEBUG definition -
+# set it according to whether we're using debug flags.
if(BRLCAD_FLAGS_DEBUG)
CONFIG_H_APPEND(BRLCAD "#define DEBUG 1\n")
endif(BRLCAD_FLAGS_DEBUG)
@@ -346,11 +344,11 @@
DESCRIPTION BRLCAD_ENABLE_COMPILER_WARNINGS_DESCRIPTION)
mark_as_advanced(BRLCAD_ENABLE_COMPILER_WARNINGS)
-# Enable/disable strict compiler settings - these are used for building
-# BRL-CAD by default, but not src/other code. Always used for BRL-CAD
-# code unless the NO_STRICT option is specified when defining a target
-# with BRLCAD_ADDEXEC or BRLCAD_ADDLIB. If only C++ files in a target
-# are not compatible with strict, the NO_STRICT_CXX option can be used.
+# Enable/disable strict compiler settings - these are used for building BRL-CAD
+# by default, but not src/other code. Always used for BRL-CAD code unless the
+# NO_STRICT option is specified when defining a target with BRLCAD_ADDEXEC or
+# BRLCAD_ADDLIB. If only C++ files in a target are not compatible with strict,
+# the NO_STRICT_CXX option can be used.
set(BRLCAD_ENABLE_STRICT_DESCRIPTION "
Causes all compilation warnings for C code to be treated as errors. This is
now
the default for BRL-CAD source code, and developers should address issues
@@ -376,8 +374,8 @@
endif(CMAKE_BUILD_TYPE)
mark_as_advanced(BRLCAD_OPTIMIZED_BUILD)
-# Build with full compiler lines visible by default (won't need make
-# VERBOSE=1) on command line
+# Build with full compiler lines visible by default (won't need make VERBOSE=1)
+# on command line
option(BRLCAD_ENABLE_VERBOSE_PROGRESS "verbose output" OFF)
mark_as_advanced(BRLCAD_ENABLE_VERBOSE_PROGRESS)
if(BRLCAD_ENABLE_VERBOSE_PROGRESS)
@@ -384,11 +382,11 @@
set(CMAKE_VERBOSE_MAKEFILE ON)
endif(BRLCAD_ENABLE_VERBOSE_PROGRESS)
-# Build with profile-guided optimization support. this requires a
-# two-pass compile, once with BRLCAD_PGO=ON on a location that did not
-# exist beforehand (specified via the PGO_PATH environment variable),
-# and again to use profiling metrics captured on "typical" operations
-# and data. By default, path is BUILDDIR/profiling
+# Build with profile-guided optimization support. this requires a two-pass
+# compile, once with BRLCAD_PGO=ON on a location that did not exist beforehand
+# (specified via the PGO_PATH environment variable), and again to use profiling
+# metrics captured on "typical" operations and data. By default, path is
+# BUILDDIR/profiling
option(BRLCAD_PGO "Enable profile-guided optimization (set PGO_PATH
environment variable)")
mark_as_advanced(BRLCAD_PGO)
@@ -432,20 +430,19 @@
add_definitions(-DEXPOSE_DM_HEADER)
endif(BRLCAD_HEADERS_OLD_COMPAT)
-#----------------------------------------------------------------------
-# Some generators in CMake support generating folders in IDEs for
-# organizing build targets. We want to use them if they are there.
+#-----------------------------------------------------------------------------
+# Some generators in CMake support generating folders in IDEs for organizing
+# build targets. We want to use them if they are there.
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
-#----------------------------------------------------------------------
-# There are extra documentation files available requiring DocBook
-# They are quite useful in graphical interfaces, but also add considerably
-# to the overall build time. If necessary BRL-CAD provides its own
-# xsltproc (see src/other/xmltools), so the html and man page
-# outputs are always potentially available. PDF output, on the other hand,
-# needs Apache FOP. FOP is not a candidate for bundling with BRL-CAD for
-# a number of reasons, so we simply check to see if it is present and set
-# the options accordingly.
+#-----------------------------------------------------------------------------
+# There are extra documentation files available requiring DocBook They are
+# quite useful in graphical interfaces, but also add considerably to the
+# overall build time. If necessary BRL-CAD provides its own xsltproc (see
+# src/other/xmltools), so the html and man page outputs are always potentially
+# available. PDF output, on the other hand, needs Apache FOP. FOP is not a
+# candidate for bundling with BRL-CAD for a number of reasons, so we simply
+# check to see if it is present and set the options accordingly.
# Do we have the environment variable set locally?
if(NOT "$ENV{APACHE_FOP}" STREQUAL "")
@@ -492,10 +489,10 @@
DESCRIPTION BRLCAD_EXTRADOCS_DESCRIPTION)
-# The HTML output is used in the graphical help browsers in MGED and Archer,
-# as well as being the most likely candidate for external viewers. Turn this
-# on unless explicitly instructed otherwise by the user or all extra
-# documentation is disabled.
+# The HTML output is used in the graphical help browsers in MGED and Archer, as
+# well as being the most likely candidate for external viewers. Turn this on
+# unless explicitly instructed otherwise by the user or all extra documentation
+# is disabled.
CMAKE_DEPENDENT_OPTION(BRLCAD_EXTRADOCS_HTML "Build MAN page output from
DocBook documentation" ON "BRLCAD_EXTRADOCS" OFF)
mark_as_advanced(BRLCAD_EXTRADOCS_HTML)
@@ -505,16 +502,15 @@
CMAKE_DEPENDENT_OPTION(BRLCAD_EXTRADOCS_PPT "Build MAN page output from
DocBook documentation" ON "BRLCAD_EXTRADOCS" OFF)
mark_as_advanced(BRLCAD_EXTRADOCS_PPT)
-# Normally, we'll turn on man page output by default, but there is
-# no point in doing man page output for a Visual Studio build - the
-# files aren't useful and it *seriously* increases the target build
-# count/build time. Conditionalize on the CMake MSVC variable NOT
-# being set.
+# Normally, we'll turn on man page output by default, but there is no point in
+# doing man page output for a Visual Studio build - the files aren't useful and
+# it *seriously* increases the target build count/build time. Conditionalize
+# on the CMake MSVC variable NOT being set.
CMAKE_DEPENDENT_OPTION(BRLCAD_EXTRADOCS_MAN "Build MAN page output from
DocBook documentation" ON "BRLCAD_EXTRADOCS;NOT MSVC" OFF)
mark_as_advanced(BRLCAD_EXTRADOCS_MAN)
-# Don't do PDF by default because it's pretty expensive, and hide the
-# option unless the tools to do it are present.
+# Don't do PDF by default because it's pretty expensive, and hide the option
+# unless the tools to do it are present.
set(BRLCAD_EXTRADOCS_PDF_DESCRIPTION "
Option that enables building of BRL-CAD's DocBook PDF-based documentation
(includes manuals and man pages for commands, among
@@ -525,19 +521,19 @@
")
CMAKE_DEPENDENT_OPTION(BRLCAD_EXTRADOCS_PDF "Build PDF output from DocBook
documentation" OFF "BRLCAD_EXTRADOCS;APACHE_FOP" OFF)
-# Provide an option to enable/disable XML validation as part
-# of the DocBook build - sort of a "strict flags" mode for DocBook.
-# By default, this will be enabled when extra docs are built and
-# the toplevel BRLCAD_ENABLE_STRICT setting is enabled.
-# Unfortunately, Visual Studio 2010 seems to have issues when we
-# enable validation on top of everything else... not clear why,
-# unless build target counts >1800 are beyond MSVC's practical
-# limit. Until we either find a resolution or a way to reduce
-# the target count on MSVC, disable validation there.
+# Provide an option to enable/disable XML validation as part of the DocBook
+# build - sort of a "strict flags" mode for DocBook. By default, this will be
+# enabled when extra docs are built and the toplevel BRLCAD_ENABLE_STRICT
+# setting is enabled. Unfortunately, Visual Studio 2010 seems to have issues
+# when we enable validation on top of everything else... not clear why, unless
+# build target counts >1800 are beyond MSVC's practical limit. Until we either
+# find a resolution or a way to reduce the target count on MSVC, disable
+# validation there.
CMAKE_DEPENDENT_OPTION(BRLCAD_EXTRADOCS_VALIDATE "Perform validation for
DocBook documentation" ON "BRLCAD_EXTRADOCS;BRLCAD_ENABLE_STRICT" OFF)
mark_as_advanced(BRLCAD_EXTRADOCS_VALIDATE)
+
# Local Variables:
# tab-width: 8
# mode: cmake
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits