nixpkgs/doc/hooks/meson.section.md

# Meson {#meson}

Overrides the configure phase to run meson to generate Ninja files. To run these files, you should accompany Meson with ninja. By default, `enableParallelBuilding` is enabled as Meson supports parallel building almost everywhere.

## Variables controlling Meson {#variables-controlling-meson}

### `mesonFlags` {#mesonflags}

Controls the flags passed to meson.

### `mesonBuildType` {#mesonbuildtype}

Which [`--buildtype`](https://mesonbuild.com/Builtin-options.html#core-options) to pass to Meson. We default to `plain`.

### `mesonAutoFeatures` {#mesonautofeatures}

What value to set [`-Dauto_features=`](https://mesonbuild.com/Builtin-options.html#core-options) to. We default to `enabled`.

### `mesonWrapMode` {#mesonwrapmode}

What value to set [`-Dwrap_mode=`](https://mesonbuild.com/Builtin-options.html#core-options) to. We default to `nodownload` as we disallow network access.

### `dontUseMesonConfigure` {#dontusemesonconfigure}

Disables using Meson’s `configurePhase`.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								# Meson {#meson}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								Overrides the configure phase to run meson to generate Ninja files. To run these files, you should accompany Meson with ninja. By default, `enableParallelBuilding` is enabled as Meson supports parallel building almost everywhere.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								## Variables controlling Meson {#variables-controlling-meson}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								### `mesonFlags` {#mesonflags}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								Controls the flags passed to meson.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								### `mesonBuildType` {#mesonbuildtype}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								Which [`--buildtype`](https://mesonbuild.com/Builtin-options.html#core-options) to pass to Meson. We default to `plain`.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								### `mesonAutoFeatures` {#mesonautofeatures}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								What value to set [`-Dauto_features=`](https://mesonbuild.com/Builtin-options.html#core-options) to. We default to `enabled`.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								### `mesonWrapMode` {#mesonwrapmode}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								What value to set [`-Dwrap_mode=`](https://mesonbuild.com/Builtin-options.html#core-options) to. We default to `nodownload` as we disallow network access.
-												doc: make sure section depths are consecutive

skipping heading levels (eg from # to ###, or starting at ###) is legal
in pandoc, but not in nixos-render-docs. pandoc acts as though section
levels *were* consecutive, nixos-render-docs prefers to tell people not
to do that kind of thing because it can make documents more fragile.

											
										
										
											2023-06-10 15:54:02 +00:00
+								### `dontUseMesonConfigure` {#dontusemesonconfigure}
-												doc: Move non-stdenv hooks out of stdenv chapter

											
										
										
											2022-10-13 13:36:04 +00:00
 								Disables using Meson’s `configurePhase`.