Chiebot-Mirror
/
meson
mirror of https://github.com/mesonbuild/meson.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update man pages.

Browse Source
pull/2067/head
Jussi Pakkanen 7 years ago
parent 2817fcf2f3
commit d82c7e3c23
5 changed files with 176 additions and 123 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 161
      man/meson.1
  2. 23
      man/mesonconf.1
  3. 30
      man/mesonintrospect.1
  4. 52
      man/mesontest.1
  5. 33
      man/wraptool.1

161
man/meson.1
Unescape View File

@ -8,11 +8,16 @@ productivity. It aims to do this by providing simple, out-of-the-box
support for modern software development tools and practices, such as support for modern software development tools and practices, such as
unit tests, coverage reports, Valgrind, CCache and the like. unit tests, coverage reports, Valgrind, CCache and the like.
The main Meson executable provides many subcommands to access all
the functionality.
.SH The setup command
Using Meson is simple and follows the common two-phase Using Meson is simple and follows the common two-phase
process of most build systems. First you run Meson to process of most build systems. First you run Meson to
configure your build: configure your build:
.B meson [ .B meson setup [
.I options .I options
.B ] [ .B ] [
.I source directory .I source directory
@ -35,6 +40,19 @@ your build dir. After that you just run the build command. Meson will
autodetect changes in your source tree and regenerates all files autodetect changes in your source tree and regenerates all files
needed to build the project. needed to build the project.
The setup command is the default operation. If no actual command is
specified, Meson will assume you meant to do a setup. That means
that you can set up a build directory without the setup command
like this:
.B meson [
.I options
.B ] [
.I source directory
.B ] [
.I build directory
.B ]
.SS "options:" .SS "options:"
.TP .TP
\fB\-\-version\fR \fB\-\-version\fR
@ -42,5 +60,146 @@ print version number
.TP .TP
\fB\-\-help\fR \fB\-\-help\fR
print command line help print command line help
.SH The configure command
Mesonconf provides a way to configure a Meson
project from the command line. Its usage is simple.
.B meson configure [
.I build directory
.B ] [
.I options to set
.B ]
If build directory is omitted, the current directory is used instead.
If no parameters are set, mesonconf will print the value of all build
options to the console.
To set values, use the \-D command line argument like this.
.B meson configure \-Dopt1=value1 \-Dopt2=value2
.SH The introspect command
Meson introspect is a command designed to make it simple to integrate with
other tools, such as IDEs. The output of this command is in JSON.
.B meson introspect [
.I build directory
.B ] [
.I option
.B ]
If build directory is omitted, the current directory is used instead.
.SS "options:"
.TP
\fB\-\-targets\fR
print all top level targets (executables, libraries, etc)
.TP
\fB\-\-target\-files\fR
print the source files of the given target
.TP
\fB\-\-buildsystem\-files\fR
print all files that make up the build system (meson.build, meson_options.txt etc)
.TP
\fB\-\-tests\fR
print all unit tests
.TP
\fB\-\-help\fR
print command line help
.SH The test command
Mesontest is a helper tool for running test suites of projects using Meson.
The default way of running tests is to invoke the default build command:
\fBninja [\fR \fItest\fR \fB]\fR
Mesontest provides a richer set of tools for invoking tests.
.SS "options:"
.TP
\fB\-\-repeat\fR
run tests as many times as specified
.TP
\fB\-\-gdb\fR
run tests under gdb
.TP
\fB\-\-list\fR
list all available tests
.TP
\fB\-\-wrapper\fR
invoke all tests via the given wrapper (e.g. valgrind)
.TP
\fB\-C\fR
Change into the given directory before running tests (must be root of build directory).
.TP
\fB\-\-suite\fR
run tests in this suite
.TP
\fB\-\-no\-suite\fR
do not run tests in this suite
.TP
\fB\-\-no\-stdsplit\fR
do not split stderr and stdout in test logs
.TP
\fB\-\-benchmark\fR
run benchmarks instead of tests
.TP
\fB\-\-logbase\fR
base of file name to use for writing test logs
.TP
\fB\-\-num-processes\fR
how many parallel processes to use to run tests
.TP
\fB\-\-verbose\fR
do not redirect stdout and stderr
.TP
\fB\-t\fR
a multiplier to use for test timeout values (usually something like 100 for Valgrind)
.TP
\fB\-\-setup\fR
use the specified test setup
.SH The wrap command
Wraptool is a helper utility to manage source dependencies
using the online wrapdb service.
.B meson wrap <
.I command
.B > [
.I options
.B ]
You should run this command in the top level source directory
of your project.
.SS "Commands:"
.TP
\fBlist\fR
list all available projects
.TP
\fBsearch\fR
search projects by name
.TP
\fBinstall\fR
install a project with the given name
.TP
\fBupdate\fR
update the specified project to latest available version
.TP
\fBinfo\fR
show available versions of the specified project
.TP
\fBstatus\fR
show installed and available versions of currently used subprojects
.SH SEE ALSO .SH SEE ALSO
http://mesonbuild.com/ http://mesonbuild.com/
https://wrapdb.mesonbuild.com/

23
man/mesonconf.1
Unescape View File

@ -3,23 +3,8 @@
mesonconf - a tool to configure Meson builds mesonconf - a tool to configure Meson builds
.SH DESCRIPTION .SH DESCRIPTION
Mesonconf provides a way to configure a Meson This executable is deprecated and will be removed in the future. The
project from the command line. Its usage is simple. functionality that was in this executable can be invoked via the main Meson
command like this:
.B mesonconf [ .B meson configure <options>
.I build directory
.B ] [
.I options to set
.B ]
If build directory is omitted, the current directory is used instead.
If no parameters are set, mesonconf will print the value of all build
options to the console.
To set values, just use the \-D command line argument like this.
.B mesonconf \-Dopt1=value1 \-Dopt2=value2
.SH SEE ALSO
http://mesonbuild.com/

30
man/mesonintrospect.1
Unescape View File

@ -3,33 +3,11 @@
mesonintrospect - a tool to extract information about a Meson build mesonintrospect - a tool to extract information about a Meson build
.SH DESCRIPTION .SH DESCRIPTION
Mesonintrospect is a tool designed to make it simple to integrate with This executable is deprecated and will be removed in the future. The
other tools, such as IDEs. The output of this command is in JSON. functionality that was in this executable can be invoked via the main Meson
command like this:
.B mesonintrospect [ .B meson introspect <options>
.I build directory
.B ] [
.I option
.B ]
If build directory is omitted, the current directory is used instead.
.SS "options:"
.TP
\fB\-\-targets\fR
print all top level targets (executables, libraries, etc)
.TP
\fB\-\-target\-files\fR
print the source files of the given target
.TP
\fB\-\-buildsystem\-files\fR
print all files that make up the build system (meson.build, meson_options.txt etc)
.TP
\fB\-\-tests\fR
print all unit tests
.TP
\fB\-\-help\fR
print command line help
.SH SEE ALSO .SH SEE ALSO
http://mesonbuild.com/ http://mesonbuild.com/

52
man/mesontest.1
Unescape View File

@ -3,55 +3,11 @@
mesontest - test tool for the Meson build system mesontest - test tool for the Meson build system
.SH DESCRIPTION .SH DESCRIPTION
Mesontest is a helper tool for running test suites of projects using Meson. This executable is deprecated and will be removed in the future. The
The default way of running tests is to invoke the default build command: functionality that was in this executable can be invoked via the main Meson
command like this:
\fBninja [\fR \fItest\fR \fB]\fR .B meson test <options>
Mesontest provides a much richer set of tools for invoking tests.
.SS "options:"
.TP
\fB\-\-repeat\fR
run tests as many times as specified
.TP
\fB\-\-gdb\fR
run tests under gdb
.TP
\fB\-\-list\fR
list all available tests
.TP
\fB\-\-wrapper\fR
invoke all tests via the given wrapper (e.g. valgrind)
.TP
\fB\-C\fR
Change into the given directory before running tests (must be root of build directory).
.TP
\fB\-\-suite\fR
run tests in this suite
.TP
\fB\-\-no\-suite\fR
do not run tests in this suite
.TP
\fB\-\-no\-stdsplit\fR
do not split stderr and stdout in test logs
.TP
\fB\-\-benchmark\fR
run benchmarks instead of tests
.TP
\fB\-\-logbase\fR
base of file name to use for writing test logs
.TP
\fB\-\-num-processes\fR
how many parallel processes to use to run tests
.TP
\fB\-\-verbose\fR
do not redirect stdout and stderr
.TP
\fB\-t\fR
a multiplier to use for test timeout values (usually something like 100 for Valgrind)
.TP
\fB\-\-setup\fR
use the specified test setup
.SH SEE ALSO .SH SEE ALSO
http://mesonbuild.com/ http://mesonbuild.com/

33
man/wraptool.1
Unescape View File

@ -3,36 +3,11 @@
wraptool - source dependency downloader wraptool - source dependency downloader
.SH DESCRIPTION .SH DESCRIPTION
Wraptool is a helper utility to manage source dependencies This executable is deprecated and will be removed in the future. The
using the wrapdb database. functionality that was in this executable can be invoked via the main Meson
command like this:
.B wraptool < .B meson wrap <options>
.I command
.B > [
.I options
.B ]
You should run this command in the top level source directory
of your project.
.SS "Commands:"
.TP
\fBlist\fR
list all available projects
.TP
\fBsearch\fR
search projects by name
.TP
\fBinstall\fR
install a project with the given name
.TP
\fBupdate\fR
update the specified project to latest available version
.TP
\fBinfo\fR
show available versions of the specified project
.TP
\fBstatus\fR
show installed and available versions of currently used subprojects
.SH SEE ALSO .SH SEE ALSO
http://wrapdb.mesonbuild.com/ http://wrapdb.mesonbuild.com/

Write Preview
Loading…
Cancel
Save