Skip to content

Latest commit

 

History

History
49 lines (41 loc) · 1.88 KB

INSTALL-cmakebuild.md

File metadata and controls

49 lines (41 loc) · 1.88 KB
Raw

Building IceWM with CMake

The CMake build system for IceWM is an alternative to the traditional configure build system. The minimum supported CMake version is 3.2 (March 2015).

Installation instructions:

  • for system requirements, see the INSTALL file.
  • run: mkdir build ; cd build ; cmake ..
  • check the output. To change variables, rerun the command above and add: -DVARIABLE=value. To change the installation prefix to /opt/icewm run: cmake -DCMAKE_INSTALL_PREFIX:PATH=/opt/icewm ... If some values are sticky or some checks are not rerun (although you might have installed the reported missing packages), delete the file CMakeCache.txt and try again.
  • run: make -j4
  • run: make install

Developer/Integrator notes:

  • you can see more internals and documented variables with "cmake -LAH"
  • CMAKE_CXX_FLAGS are appended to default compiler options. To override completely, see CXXFLAGS_COMMON in src/CMakeLists.txt
  • use cmake -DCMAKE_INSTALL_PREFIX=... (or related variables, see CMakeLists.txt) to specify the target file space (default is /usr/local)
  • make install DESTDIR=/elsewhere copies to another target location
  • Potential tuning options for smaller binaries, build analysis, ...
   -DEXTRA_LIBS="-lsupc++"
   -DENABLE_LTO=ON
   -DEXTRA_MSGMERGE=--verbose -DEXTRA_MSGFMT=--verbose --log-level=VERBOSE

  • There is a special target called update_pot which refreshes the translation master template

  • Another special option is -DPO_UPDATE=ON which extends the install target to replace the PO files in the input source code. NOTE: this might trigger another recompilation of MO files later.

  • There is a configuration example for cmake builds in rebuild.sh. run: ./rebuild.sh -r --prefix=/usr