CMake: icetray’s build system

• Release Notes

Quick User Guide

• Dependencies
  • Required Dependencies
  • Optional Build Dependencies
  • Other Dependencies
• Supported Platforms
  • Officially Supported Platforms
  • Detailed Instructions
• User’s Guide
  • Building with CMake
  • Command line configuration
  • Testing
• Installing IceTray
  • Setting the Installation Prefix
  • Other Installation Options
  • Installing
• Using Installed IceTray
  • Bare Install
  • Installation to a Python Virtual Environment
• Parasitic metaprojects
• Building tarballs for use on clusters or the grid
  • What is done
  • Example
  • For metaproject maintainers: tarball_hook.sh
  • Changing the name of the tarball
  • Lightweight tarballs for CVMFS-enabled grids

Advanced

• Advanced CMake
  • Editing the CMake cache
  • Command line configuration
  • Common CMake Settings
  • Uncommon CMake settings
  • Verbose build
  • The cmake cache CMakeCache.txt
• Organization/Structure of Projects and Metaprojects
  • Project Directory Structure
  • Branches, Releases and The Trunk
• Documentation
  • Requirements
  • reStructuredText (rst)
  • Doxygen
  • Building the documentation
  • Links
• Targets
  • Workspace level
  • Project level
• Tool detection/configuration
  • tooldef
  • SYSTEM_PACKAGES
  • I3_SITE_CMAKE_DIR
  • Troubleshooting
• I3Test Reference
  • Overview
  • Testing Interface
  • Building and running I3Tests
  • The test driver command line interface
  • References
• Icetray-specific cmake macro reference
  • i3_project
  • i3_add_library
  • i3_executable
  • i3_test_executable
  • i3_add_pybindings
  • i3_test_scripts
  • qt4_i3_automoc
• How to write pybindings for your project
  • Registering your class with boost::python
  • Wrapping containers
  • Wrapping enumerated types
  • Declaring the module
  • Helpful preprocessor macros
  • Gotchas
  • Naming conventions
  • Resources
  • Todo: finer points of return-by-value vs. reference
• env-shell.sh
  • What env-shell.sh does
  • A good way to set up your shell
• Using the Intel C++ compiler
  • Configuration
  • Gotchas
• Homebrew
  • Some history
  • Homebrew usage for IceCube

Information on particular tools

• Boost
• NLopt
• PAL
• Photospline
• Python
• ROOT