docs: do not use definition-list for sub-topics
The dl-tag isn't a neat tool for defining sub-headings, it's a semantic tool for defining definitions and their meaning. Let's insetad use normal sub-headings instead. To make the last few paragraphs stand out from the above, let's add a sub-heading for those as well. Reviewed-by: Eric Engestrom <eric@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/merge_requests/3443>
This commit is contained in:
@@ -203,10 +203,7 @@ or greater. Older versions always use the microsoft compiler.
|
|||||||
|
|
||||||
<h2 id="advanced">3. Advanced Usage</h2>
|
<h2 id="advanced">3. Advanced Usage</h2>
|
||||||
|
|
||||||
<dl>
|
<h3>Installation Location</h3>
|
||||||
|
|
||||||
<dt>Installation Location</dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
<p>
|
||||||
Meson default to installing libGL.so in your system's main lib/ directory
|
Meson default to installing libGL.so in your system's main lib/ directory
|
||||||
and DRI drivers to a dri/ subdirectory.
|
and DRI drivers to a dri/ subdirectory.
|
||||||
@@ -228,10 +225,8 @@ to run/test the driver.
|
|||||||
<p>
|
<p>
|
||||||
Meson also honors <code>DESTDIR</code> for installs.
|
Meson also honors <code>DESTDIR</code> for installs.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dt>Compiler Options</dt>
|
<h3>Compiler Options</h3>
|
||||||
<dd>
|
|
||||||
<p>Meson supports the common CFLAGS, CXXFLAGS, etc. environment
|
<p>Meson supports the common CFLAGS, CXXFLAGS, etc. environment
|
||||||
variables but their use is discouraged because of the many caveats
|
variables but their use is discouraged because of the many caveats
|
||||||
in using them.
|
in using them.
|
||||||
@@ -247,11 +242,9 @@ for C++ sources:
|
|||||||
<pre>
|
<pre>
|
||||||
meson builddir/ -Dc_args=-fmax-errors=10 -Dcpp_args=-DMAGIC=123
|
meson builddir/ -Dc_args=-fmax-errors=10 -Dcpp_args=-DMAGIC=123
|
||||||
</pre>
|
</pre>
|
||||||
</dd>
|
|
||||||
|
|
||||||
|
|
||||||
<dt>Compiler Specification</dt>
|
<h3>Compiler Specification</h3>
|
||||||
<dd>
|
|
||||||
<p>
|
<p>
|
||||||
Meson supports the standard CC and CXX environment variables for
|
Meson supports the standard CC and CXX environment variables for
|
||||||
changing the default compiler. Note that Meson does not allow
|
changing the default compiler. Note that Meson does not allow
|
||||||
@@ -274,14 +267,12 @@ The default compilers depends on your operating system. Meson supports most of
|
|||||||
the popular compilers, a complete list is available
|
the popular compilers, a complete list is available
|
||||||
<a href="https://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>.
|
<a href="https://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dt>LLVM</dt>
|
<h3>LLVM</h3>
|
||||||
<dd><p>Meson includes upstream logic to wrap llvm-config using its standard
|
<p>Meson includes upstream logic to wrap llvm-config using its standard
|
||||||
dependency interface.
|
dependency interface.
|
||||||
</p></dd>
|
</p>
|
||||||
|
<p>
|
||||||
<dd><p>
|
|
||||||
As of meson 0.51.0 meson can use cmake to find llvm (the cmake finder
|
As of meson 0.51.0 meson can use cmake to find llvm (the cmake finder
|
||||||
was added in meson 0.49.0, but LLVM cannot be found until 0.51) Due to the
|
was added in meson 0.49.0, but LLVM cannot be found until 0.51) Due to the
|
||||||
way LLVM implements its cmake finder it will only find static libraries, it
|
way LLVM implements its cmake finder it will only find static libraries, it
|
||||||
@@ -294,9 +285,8 @@ example:
|
|||||||
<pre>
|
<pre>
|
||||||
meson builddir -Dcmake_module_path=/home/user/mycmake/prefix
|
meson builddir -Dcmake_module_path=/home/user/mycmake/prefix
|
||||||
</pre>
|
</pre>
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dd><p>
|
<p>
|
||||||
As of meson 0.49.0 meson also has the concept of a
|
As of meson 0.49.0 meson also has the concept of a
|
||||||
<a href="https://mesonbuild.com/Native-environments.html">"native file"</a>,
|
<a href="https://mesonbuild.com/Native-environments.html">"native file"</a>,
|
||||||
these files provide information about the native build environment (as opposed
|
these files provide information about the native build environment (as opposed
|
||||||
@@ -315,9 +305,8 @@ Then configure meson:
|
|||||||
<pre>
|
<pre>
|
||||||
meson builddir/ --native-file custom-llvm.ini
|
meson builddir/ --native-file custom-llvm.ini
|
||||||
</pre>
|
</pre>
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dd><p>
|
<p>
|
||||||
Meson < 0.49 doesn't support native files, so to specify a custom
|
Meson < 0.49 doesn't support native files, so to specify a custom
|
||||||
<code>llvm-config</code> you need to modify your <code>$PATH</code> (or
|
<code>llvm-config</code> you need to modify your <code>$PATH</code> (or
|
||||||
<code>%PATH%</code> on windows), which will be searched for
|
<code>%PATH%</code> on windows), which will be searched for
|
||||||
@@ -327,9 +316,8 @@ and <code>llvm-config-<i>$version</i></code>:
|
|||||||
<pre>
|
<pre>
|
||||||
PATH=/path/to/folder/with/llvm-config:$PATH meson build
|
PATH=/path/to/folder/with/llvm-config:$PATH meson build
|
||||||
</pre>
|
</pre>
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dd><p>
|
<p>
|
||||||
For selecting llvm-config for cross compiling a
|
For selecting llvm-config for cross compiling a
|
||||||
<a href="https://mesonbuild.com/Cross-compilation.html#defining-the-environment">"cross file"</a>
|
<a href="https://mesonbuild.com/Cross-compilation.html#defining-the-environment">"cross file"</a>
|
||||||
should be used. It uses the same format as the native file above:
|
should be used. It uses the same format as the native file above:
|
||||||
@@ -351,9 +339,8 @@ should be used. It uses the same format as the native file above:
|
|||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
See the <a href="#cross-compilation">Cross Compilation</a> section for more information.
|
See the <a href="#cross-compilation">Cross Compilation</a> section for more information.
|
||||||
</dd>
|
|
||||||
|
|
||||||
<dd><p>On windows (and in other cases), using llvm-config or cmake may be
|
<p>On windows (and in other cases), using llvm-config or cmake may be
|
||||||
either undesirable or impossible. Meson's solution for this is a
|
either undesirable or impossible. Meson's solution for this is a
|
||||||
<a href="https://mesonbuild.com/Wrap-dependency-system-manual.html">wrap</a>, in
|
<a href="https://mesonbuild.com/Wrap-dependency-system-manual.html">wrap</a>, in
|
||||||
this case a "binary wrap". Follow the steps below:</p>
|
this case a "binary wrap". Follow the steps below:</p>
|
||||||
@@ -418,18 +405,16 @@ irbuilder_h = files('include/llvm/IR/IRBuilder.h')
|
|||||||
workarounds for the wrong version of LLVM might be used resulting in build
|
workarounds for the wrong version of LLVM might be used resulting in build
|
||||||
failures.</p>
|
failures.</p>
|
||||||
|
|
||||||
</dd>
|
<h3><code>PKG_CONFIG_PATH</code></h3>
|
||||||
<dt><code>PKG_CONFIG_PATH</code></dt>
|
<p>The
|
||||||
<dd><p>The
|
|
||||||
<code>pkg-config</code> utility is a hard requirement for configuring and
|
<code>pkg-config</code> utility is a hard requirement for configuring and
|
||||||
building Mesa on Unix-like systems. It is used to search for external libraries
|
building Mesa on Unix-like systems. It is used to search for external libraries
|
||||||
on the system. This environment variable is used to control the search path for
|
on the system. This environment variable is used to control the search path for
|
||||||
<code>pkg-config</code>. For instance, setting
|
<code>pkg-config</code>. For instance, setting
|
||||||
<code>PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig</code> will search for package
|
<code>PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig</code> will search for package
|
||||||
metadata in <code>/usr/X11R6</code> before the standard directories.</p>
|
metadata in <code>/usr/X11R6</code> before the standard directories.</p>
|
||||||
</dd>
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
<h3>Options</h3>
|
||||||
<p>
|
<p>
|
||||||
One of the oddities of meson is that some options are different when passed to
|
One of the oddities of meson is that some options are different when passed to
|
||||||
the <code>meson</code> than to <code>meson configure</code>. These options are
|
the <code>meson</code> than to <code>meson configure</code>. These options are
|
||||||
|
Reference in New Issue
Block a user