1 # This is a worksheet to help with organizing our CMake options with 2 # an eye towards consistency, clarity, and simplification. 3 # 4 # TODO: 5 # * consistent naming convention 6 # * eliminate aliases 7 # * drop unnecessary/unhelpful/obsolete flags 8 # * audit what ccmake presents by default 9 # 10 11 ### HOW TO COMPILE ### 12 13 CMAKE_BUILD_TYPE := Release | Debug 14 15 BRLCAD_ENABLE_VERBOSE_PROGRESS "verbose output" OFF 16 BRLCAD_ENABLE_COVERAGE "Build with coverage enabled" OFF 17 18 ENABLE_ALL_CXX_COMPILE "Build all C and C++ files with a C++ compiler." OFF 19 ENABLE_ALL_CXX 20 21 BRLCAD_ENABLE_PROFILING 22 BRLCAD_ENABLE_DTRACE "Build with dtrace support" OFF 23 24 BRLCAD_ENABLE_SMP "Enable SMP architecture parallel computation support" ON 25 BRLCAD_ENABLE_RUNTIME_DEBUG 26 ENABLE_RUNTIME_DEBUG 27 ENABLE_RUN_TIME_DEBUG 28 ENABLE_RUNTIME_DEBUGGING 29 ENABLE_RUN_TIME_DEBUGGING 30 BRLCAD_FLAGS_DEBUG 31 ENABLE_DEBUG 32 ENABLE_FLAGS_DEBUG 33 ENABLE_DEBUG_FLAGS 34 BRLCAD_ENABLE_COMPILER_WARNINGS 35 ENABLE_WARNINGS 36 ENABLE_COMPILER_WARNINGS 37 BRLCAD_ENABLE_STRICT 38 ENABLE_STRICT 39 ENABLE_STRICT_COMPILE 40 ENABLE_STRICT_COMPILE_FLAGS 41 42 43 ### WHAT TO COMPILE ### 44 45 BRLCAD_ENABLE_MINIMAL "Skip GUI support and docs. Faster builds." OFF 46 BUILD_SHARED_LIBS "Build shared libraries" ON 47 BUILD_STATIC_LIBS "Build static libraries" ON 48 BRLCAD_ENABLE_BRLCAD_LIBRARY "Build the brlcad.dll" OFF 49 50 BRLCAD_BUNDLED_LIBS := AUTO | BUNDLED | SYSTEM 51 ENABLE_ALL 52 53 BRLCAD_ENABLE_AQUA "Use Aqua instead of X11 whenever possible on OSX." OFF 54 BRLCAD_ENABLE_X11 "Use X11." OFF 55 BRLCAD_ENABLE_TK "Enable features requiring the Tk toolkit" ON 56 BRLCAD_ENABLE_OPENGL "Enable support for OpenGL based Display Managers in BRL-CAD." ON 57 OFF "Disabled - NOT BRLCAD_ENABLE_X11 and NOT BRLCAD_ENABLE_AQUA" 58 ENABLE_OPENGL 59 BRLCAD_ENABLE_QT "Enable features requiring Qt" OFF 60 BRLCAD_ENABLE_OSG "Enable features requiring OpenSceneGraph" OFF 61 62 BRLCAD_ENABLE_BULLET "Enable features requiring the Bullet Physics Library" ON 63 BRLCAD_ENABLE_GCT "Enable features requiring GCT" ON 64 BRLCAD_ENABLE_GDAL "Enable features requiring the Geospatial Data Abstraction Library" ON 65 BRLCAD_ENABLE_SPR "Enable features requiring Screened Poisson Surface Reconstruction" OFF 66 67 BRLCAD_ENABLE_BINARY_ATTRIBUTES "Enable support for binary attributes" OFF 68 69 BRLCAD_ENABLE_OPENCL "Enable features requiring OpenCL" OFF 70 71 BRLCAD_EXTRADOCS 72 ENABLE_DOCS 73 ENABLE_EXTRA_DOCS 74 ENABLE_DOCBOOK 75 BRLCAD_EXTRADOCS_VALIDATE "Perform validation for DocBook documentation" ON 76 BRLCAD_EXTRADOCS_HTML "Build MAN page output from DocBook documentation" ON 77 BRLCAD_EXTRADOCS_PHP "Build MAN page output from DocBook documentation" OFF 78 BRLCAD_EXTRADOCS_PPT "Build MAN page output from DocBook documentation" ON 79 BRLCAD_EXTRADOCS_MAN "Build MAN page output from DocBook documentation" ON 80 BRLCAD_EXTRADOCS_PDF "Build PDF output from DocBook documentation" OFF 81 BRLCAD_ENABLE_TARGETS "controls all DocBook based documentation. Keys off what target level is enabled." 82 EXTRADOCS_DEFAULT is ON when <= 2 ; OFF when > 2 83 84 85 ### HOW TO INSTALL ### 86 87 BRLCAD_ENABLE_WIX 88 BRLCAD_INSTALL_EXAMPLE_GEOMETRY "Install the example BRL-CAD geometry files." ON 89 90 # Local Variables: 91 # tab-width: 8 92 # mode: cmake 93 # indent-tabs-mode: t 94 # End: 95 # ex: shiftwidth=2 tabstop=8