229 lines
6.9 KiB
Groff
229 lines
6.9 KiB
Groff
.\" Man page generated from reStructuredText.
|
||
.
|
||
.TH "CMAKE-GUI" "1" "Aug 20, 2020" "3.18.2" "CMake"
|
||
.SH NAME
|
||
cmake-gui \- CMake GUI Command-Line Reference
|
||
.
|
||
.nr rst2man-indent-level 0
|
||
.
|
||
.de1 rstReportMargin
|
||
\\$1 \\n[an-margin]
|
||
level \\n[rst2man-indent-level]
|
||
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
-
|
||
\\n[rst2man-indent0]
|
||
\\n[rst2man-indent1]
|
||
\\n[rst2man-indent2]
|
||
..
|
||
.de1 INDENT
|
||
.\" .rstReportMargin pre:
|
||
. RS \\$1
|
||
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||
. nr rst2man-indent-level +1
|
||
.\" .rstReportMargin post:
|
||
..
|
||
.de UNINDENT
|
||
. RE
|
||
.\" indent \\n[an-margin]
|
||
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.nr rst2man-indent-level -1
|
||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||
..
|
||
.SH SYNOPSIS
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
.sp
|
||
.nf
|
||
.ft C
|
||
cmake\-gui [<options>]
|
||
cmake\-gui [<options>] {<path\-to\-source> | <path\-to\-existing\-build>}
|
||
cmake\-gui [<options>] \-S <path\-to\-source> \-B <path\-to\-build>
|
||
.ft P
|
||
.fi
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.SH DESCRIPTION
|
||
.sp
|
||
The \fBcmake\-gui\fP executable is the CMake GUI. Project configuration
|
||
settings may be specified interactively. Brief instructions are
|
||
provided at the bottom of the window when the program is running.
|
||
.sp
|
||
CMake is a cross\-platform build system generator. Projects specify
|
||
their build process with platform\-independent CMake listfiles included
|
||
in each directory of a source tree with the name \fBCMakeLists.txt\fP\&.
|
||
Users build a project by using CMake to generate a build system for a
|
||
native tool on their platform.
|
||
.SH OPTIONS
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \fB\-S <path\-to\-source>\fP
|
||
Path to root directory of the CMake project to build.
|
||
.TP
|
||
.B \fB\-B <path\-to\-build>\fP
|
||
Path to directory which CMake will use as the root of build directory.
|
||
.sp
|
||
If the directory doesn’t already exist CMake will make it.
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \fB\-\-help,\-help,\-usage,\-h,\-H,/?\fP
|
||
Print usage information and exit.
|
||
.sp
|
||
Usage describes the basic command line interface and its options.
|
||
.TP
|
||
.B \fB\-\-version,\-version,/V [<f>]\fP
|
||
Show program name/version banner and exit.
|
||
.sp
|
||
If a file is specified, the version is written into it.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-full [<f>]\fP
|
||
Print all help manuals and exit.
|
||
.sp
|
||
All manuals are printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-manual <man> [<f>]\fP
|
||
Print one help manual and exit.
|
||
.sp
|
||
The specified manual is printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-manual\-list [<f>]\fP
|
||
List help manuals available and exit.
|
||
.sp
|
||
The list contains all manuals for which help may be obtained by
|
||
using the \fB\-\-help\-manual\fP option followed by a manual name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-command <cmd> [<f>]\fP
|
||
Print help for one command and exit.
|
||
.sp
|
||
The \fBcmake\-commands(7)\fP manual entry for \fB<cmd>\fP is
|
||
printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-command\-list [<f>]\fP
|
||
List commands with help available and exit.
|
||
.sp
|
||
The list contains all commands for which help may be obtained by
|
||
using the \fB\-\-help\-command\fP option followed by a command name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-commands [<f>]\fP
|
||
Print cmake\-commands manual and exit.
|
||
.sp
|
||
The \fBcmake\-commands(7)\fP manual is printed in a
|
||
human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-module <mod> [<f>]\fP
|
||
Print help for one module and exit.
|
||
.sp
|
||
The \fBcmake\-modules(7)\fP manual entry for \fB<mod>\fP is printed
|
||
in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-module\-list [<f>]\fP
|
||
List modules with help available and exit.
|
||
.sp
|
||
The list contains all modules for which help may be obtained by
|
||
using the \fB\-\-help\-module\fP option followed by a module name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-modules [<f>]\fP
|
||
Print cmake\-modules manual and exit.
|
||
.sp
|
||
The \fBcmake\-modules(7)\fP manual is printed in a human\-readable
|
||
text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-policy <cmp> [<f>]\fP
|
||
Print help for one policy and exit.
|
||
.sp
|
||
The \fBcmake\-policies(7)\fP manual entry for \fB<cmp>\fP is
|
||
printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-policy\-list [<f>]\fP
|
||
List policies with help available and exit.
|
||
.sp
|
||
The list contains all policies for which help may be obtained by
|
||
using the \fB\-\-help\-policy\fP option followed by a policy name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-policies [<f>]\fP
|
||
Print cmake\-policies manual and exit.
|
||
.sp
|
||
The \fBcmake\-policies(7)\fP manual is printed in a
|
||
human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-property <prop> [<f>]\fP
|
||
Print help for one property and exit.
|
||
.sp
|
||
The \fBcmake\-properties(7)\fP manual entries for \fB<prop>\fP are
|
||
printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-property\-list [<f>]\fP
|
||
List properties with help available and exit.
|
||
.sp
|
||
The list contains all properties for which help may be obtained by
|
||
using the \fB\-\-help\-property\fP option followed by a property name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-properties [<f>]\fP
|
||
Print cmake\-properties manual and exit.
|
||
.sp
|
||
The \fBcmake\-properties(7)\fP manual is printed in a
|
||
human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-variable <var> [<f>]\fP
|
||
Print help for one variable and exit.
|
||
.sp
|
||
The \fBcmake\-variables(7)\fP manual entry for \fB<var>\fP is
|
||
printed in a human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-variable\-list [<f>]\fP
|
||
List variables with help available and exit.
|
||
.sp
|
||
The list contains all variables for which help may be obtained by
|
||
using the \fB\-\-help\-variable\fP option followed by a variable name.
|
||
The help is printed to a named <f>ile if given.
|
||
.TP
|
||
.B \fB\-\-help\-variables [<f>]\fP
|
||
Print cmake\-variables manual and exit.
|
||
.sp
|
||
The \fBcmake\-variables(7)\fP manual is printed in a
|
||
human\-readable text format.
|
||
The help is printed to a named <f>ile if given.
|
||
.UNINDENT
|
||
.SH SEE ALSO
|
||
.sp
|
||
The following resources are available to get help using CMake:
|
||
.INDENT 0.0
|
||
.TP
|
||
.B Home Page
|
||
\fI\%https://cmake.org\fP
|
||
.sp
|
||
The primary starting point for learning about CMake.
|
||
.TP
|
||
.B Online Documentation and Community Resources
|
||
\fI\%https://cmake.org/documentation\fP
|
||
.sp
|
||
Links to available documentation and community resources may be
|
||
found on this web page.
|
||
.TP
|
||
.B Discourse Forum
|
||
\fI\%https://discourse.cmake.org\fP
|
||
.sp
|
||
The Discourse Forum hosts discussion and questions about CMake.
|
||
.UNINDENT
|
||
.SH COPYRIGHT
|
||
2000-2020 Kitware, Inc. and Contributors
|
||
.\" Generated by docutils manpage writer.
|
||
.
|