commit
e7b91c1226
112
cmake.1
112
cmake.1
|
@ -1,112 +0,0 @@
|
|||
.\" 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>.
|
Loading…
Reference in New Issue