230 lines
6.9 KiB
Groff
230 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.
|
|||
|
|
.
|