Skip to content

Latest commit

 

History

History
269 lines (171 loc) · 7.83 KB

README.md

File metadata and controls

269 lines (171 loc) · 7.83 KB

ReMake

Synopsis

A set of CMake macros for restructuring GNU Automake/Autoconf projects.

Author(s): Ralf Kaestner, Dizan Vasquez

Maintainer: Ralf Kaestner [email protected]

License: GNU Lesser General Public License (LGPL)

Operating system(s): Debian-based Linux, Mac OS X

Package PPA: ppa:ethz-asl/build-essential

Description

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.

Installation

Installing from packages (recommended for Ubuntu LTS users)

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-essential
    

    on 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

Building from source

This project is inherently based on the CMake build system and bootstraps itself using the ReMake macro extension.

Installing build dependencies

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

Building with CMake

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_DIR
    

    to configure the build

  • Build and install the project using

    make packages_install
    

    (from packages on Debian-based Linux only) or

    make install
    

API documentation

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

Feature requests and bug reports

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.

Further reading

For additional information of the CMake build system, please refer to the official CMake documentation.