113 lines
3.6 KiB
Groff
113 lines
3.6 KiB
Groff
|
.\" Hey, EMACS: -*- nroff -*-
|
||
|
|
.\" First parameter, NAME, should be all caps
|
||
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||
|
|
.\" other parameters are allowed: see man(7), man(1)
|
||
|
|
.TH CMAKE 1 "August 8, 2002"
|
||
|
|
.\" Please adjust this date whenever revising the manpage.
|
||
|
|
.\"
|
||
|
|
.\" Some roff macros, for reference:
|
||
|
|
.\" .nh disable hyphenation
|
||
|
|
.\" .hy enable hyphenation
|
||
|
|
.\" .ad l left justify
|
||
|
|
.\" .ad b justify to both left and right margins
|
||
|
|
.\" .nf disable filling
|
||
|
|
.\" .fi enable filling
|
||
|
|
.\" .br insert line break
|
||
|
|
.\" .sp <n> insert n+1 empty lines
|
||
|
|
.\" for manpage-specific macros, see man(7)
|
||
|
|
.SH NAME
|
||
|
|
cmake \- Cross-platform Makefile generator.
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B cmake
|
||
|
|
.RI < path-to-source > " " [ options ]
|
||
|
|
.br
|
||
|
|
.B ccmake
|
||
|
|
.RI < path-to-source >
|
||
|
|
.br
|
||
|
|
.B ctest
|
||
|
|
.RI [ -R " " < regex > ]
|
||
|
|
.br
|
||
|
|
.B cmaketest
|
||
|
|
.RI < test-src-dir > " " < test-bin-dir > " " < test-executable >
|
||
|
|
.SH DESCRIPTION
|
||
|
|
|
||
|
|
This manual page documents briefly the \fBcmake\fP, \fBccmake\fP,
|
||
|
|
\fBctest\fP and \fBcmaketest\fP commands. It is not intended to aid
|
||
|
|
authors of CMakeLists.txt files or to describe all advanced options
|
||
|
|
available. For full documentation, please visit
|
||
|
|
\fBhttp://www.cmake.org\fP.
|
||
|
|
|
||
|
|
.PP
|
||
|
|
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
||
|
|
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
|
||
|
|
.\" respectively.
|
||
|
|
|
||
|
|
CMake provides developers with a means of building their project on
|
||
|
|
multiple platforms while writing only one build system configuration.
|
||
|
|
The developer writes a set of CMakeLists.txt files that are read by
|
||
|
|
CMake and used to generate a native build system for the current
|
||
|
|
environment. On unix platforms, Makefiles are generated.
|
||
|
|
|
||
|
|
.PP
|
||
|
|
|
||
|
|
\fBcmake\fP is used to generate the makefiles for a project from its
|
||
|
|
source. The first argument should specify a path to the source tree.
|
||
|
|
The current directory will be used as the build tree for the project.
|
||
|
|
Both in-source and out-of-source builds are supported, but
|
||
|
|
out-of-source builds are preferred. CMake provides functionality for
|
||
|
|
tailoring the build to user preferences through settings in the cmake
|
||
|
|
cache. Options may be set interactively using the -i option (or
|
||
|
|
\fBccmake\fP). Once CMake has generated the makefiles in the build
|
||
|
|
tree, one may use the standard \fBmake\fP tool to build the project.
|
||
|
|
|
||
|
|
.PP
|
||
|
|
|
||
|
|
\fBccmake\fP provides a curses interface front-end for \fBcmake\fP.
|
||
|
|
The interface allows users to interactively configure the build
|
||
|
|
options stored in the cmake cache. This is the preferred interface
|
||
|
|
for interactive builds. Build scripts should use \fBcmake\fP
|
||
|
|
directly.
|
||
|
|
|
||
|
|
.PP
|
||
|
|
|
||
|
|
\fBctest\fP runs tests found in the project's build tree after it has
|
||
|
|
been compiled and displays a summary of test results. Use the -R
|
||
|
|
option to specify a regular expression of test names to match.
|
||
|
|
|
||
|
|
\fBcmaketest\fP is provided to simplify project testing scripts. It
|
||
|
|
allows a CMake project to be compiled and tested from a single command
|
||
|
|
line.
|
||
|
|
|
||
|
|
.SH OPTIONS
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.B \-\-help
|
||
|
|
Available for \fBcmake\fP , \fBccmake\fP and \fBcmaketest\fP.
|
||
|
|
.br
|
||
|
|
Show version number and summary of options.
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.B -R regex
|
||
|
|
Available for \fBctest\fP.
|
||
|
|
.br
|
||
|
|
Run only tests matching the given regular expression.
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.B -i
|
||
|
|
Available for \fBcmake\fP.
|
||
|
|
.br
|
||
|
|
Run cmake in an interactive wizard mode to configure the build.
|
||
|
|
|
||
|
|
.SH SEE ALSO
|
||
|
|
.BR Dart (1),
|
||
|
|
.BR VTK (1).
|
||
|
|
|
||
|
|
.SH MAILING LIST
|
||
|
|
For help using cmake, a mailing list is provided at
|
||
|
|
\fBcmake@www.cmake.org\fP. Please first read the full documentation
|
||
|
|
at \fBhttp://www.cmake.org\fP before posting questions to the list.
|
||
|
|
|
||
|
|
.SH AUTHOR
|
||
|
|
This manual page was written by CMake authors at Kitware
|
||
|
|
<kitware@kitware.com>.
|