A set of CMake macros for restructuring GNU Automake/Autoconf projects.
Author(s): Ralf Kaestner, Dizan Vasquez
Maintainer: Ralf Kaestner ralf.kaestner@gmail.com
License: GNU Lesser General Public License (LGPL)
Operating system(s): Debian-based Linux, Mac OS X
Package PPA: ppa:ethz-asl/build-essential
ReMake provides a set of CMake macros that have originally been written to facilitate the restructuring of GNU Automake/Autoconf projects. In the course of continuous development, however, ReMake grew into a vast collection of highly useful CMake macros for a variety of different build system applications.
ReMake is structured into several modules. This is a brief overview of their core purposes:
-
ReMake - ReMake convenience macros
The most widely used ReMake macros have been summarized into a reduced set of short-named macros for flexible and convenient use.
-
ReMakeBranch - ReMake branch macros
Branching is a central concept in ReMake. A branch is defined along with a list of dependencies that is automatically resolved by ReMake.
-
ReMakeComponent - ReMake component macros
The ReMake component module provides basic functionalities for managing component-based project structures.
-
ReMakeDebian - ReMake Debian macros
The ReMake Debian macros provide abstracted access to Debian-specific build system facilities.
-
ReMakeDistribute - ReMake distribution macros
The ReMake distribution macros facilitate automated distribution of a ReMake project.
-
ReMakeDoc - ReMake documentation macros
The ReMake documentation module has been designed for simple and transparent intergration of project documentation tasks with CMake.
-
ReMakeFile - ReMake file macros
The ReMake file macros are a set of helper macros to simplify file operations in ReMake.
-
ReMakeFind - ReMake package and file discovery macros
The ReMake package and file discovery macros provide a useful abstraction to CMake's native find functionalities.
-
ReMakeGenerate - ReMake code generation macros
The ReMake code generation macros define additional targets for the automated generation of source code.
-
ReMakeGit - ReMake Git macros
The ReMake Git module provides useful tools for Git-based projects.
-
ReMakeList - ReMake list macros
The ReMake list macros are a set of helper macros to simplify operations over lists in ReMake.
-
ReMakeOSX - ReMake OS X macros
The ReMake OS X macros provide abstracted access to OS X-specific build system facilities.
-
ReMakePack - ReMake packaging macros
The ReMake packaging macros have been designed to provide simple and transparent package generation using CMake's CPack module.
-
ReMakePkgConfig - ReMake pkg-config support
The ReMake pkg-config macros provide support for generating pkg-config files from ReMake projects.
-
ReMakePrivate - ReMake private macros
ReMake's private module provides basic helper macros that are used throughout the ReMake module infrastructure. As the name suggest, these macros are considered to be private to ReMake.
-
RemakeProject - ReMake project macros
The ReMake project macros are required by most processing macros in ReMake. They maintain the environment necessary for initializing default values throughout the modules, thus introducing convenience and conventions into ReMake's naming schemes.
-
ReMakePython - ReMake Python macros
The ReMake Python macros provide convenient targets for the distribution of Python modules and extensions using generators such as the Simplified Wrapper and Interface Generator (SWIG).
-
ReMakeQt3 - ReMake Qt3 macros
The ReMake Qt3 macros provide seamless integration of Qt3 meta-object processing with ReMake build targets.
-
ReMakeQt4 - ReMake Qt4 macros
The ReMake Qt4 macros provide seamless integration of Qt4 meta-object and user interface file processing with ReMake build targets.
-
ReMakeRecurse - ReMake multi-project recursion macros
The ReMake recursion macros extend the CMake build system facilities into multi-project environments. Recursion support exists for selected build system types.
-
ReMakeROS - ReMake ROS build macros
The ReMake ROS build macros provide access to the ROS build system configuration without requirement for the ROS CMake API. Note that all ROS environment variables should be initialized by sourcing the corresponding ROS setup script prior to calling CMake.
-
ReMakeSVN - ReMake Subversion macros
The ReMake Subversion module provides useful tools for Subversion-based projects.
-
ReMakeTarget - ReMake target macros
The ReMake target module provides useful workarounds addressing some grave CMake limitations. In CMake, top-level target definition only behaves correctly in the top-level source directory. The ReMake target macros are specifically designed to also work in directories below the top-level.
-
ReMakeTest - ReMake testing macros
The ReMake testing module provides unit testing support.
-
ReMakeVersion - ReMake version information
The ReMake version module only holds the current version of ReMake.
It is important to note that, although modern CMake provides some of the ReMake features in a very similar fashion, many of these features have already been developed when CMake still suffered from serious limitations.
In its current version, ReMake requires CMake version 2.6.2 or higher. It specifically targets projects which are intended to build on Debian-based Linux platforms.
The maintainers of this project provide binary packages for the latest Ubuntu LTS releases and commonly used system architectures. To install these packages, you may follow these instructions:
-
Add the project PPA to your APT sources by issuing
sudo add-apt-repository ppa:ethz-asl/build-essentialon the command line
-
To re-synchronize your package index files, run
sudo apt-get update -
Install all project packages and their dependencies through
sudo apt-get install remake*or selected packages using your favorite package management tool
This project is inherently based on the CMake build system and bootstraps itself using the ReMake macro extension.
The build dependencies of this project are available from the standard package repositories of recent Ubuntu LTS releases. To install them, simply use the command
sudo apt-get install debhelper cmake groff
This project can be built the traditional CMake way. Assuming that you have
cloned the project sources into PROJECT_DIR, a typical out-of-source build
might look like this:
-
Create a build directory using
mkdir -p PROJECT_DIR/build -
Switch into the build directoy by
cd PROJECT_DIR/build -
In the build directory, run
cmake PROJECT_DIRto configure the build
-
Build and install the project using
make packages_install(from packages on Debian-based Linux only) or
make install
This project generates its API documentation from source. To access it, you
may either inspect the build directory tree after the project has been built
using make or install the documentation package through
sudo apt-get install remake-doc
If you would like to propose a feature for this project, please consider contributing or send a feature request to the project authors. Bugs may be reported through the project's issue page.
For additional information of the CMake build system, please refer to the official CMake documentation.