OpenHarmony/third_party_mesa3d
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: use more file-roles

Browse Source 
This makes the documentation a bit easier to read, and aids
spell-checkers, so let's specify these using file-roles.

Reviewed-by: Eric Engestrom <eric@engestrom.ch>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/11464>
This commit is contained in:
Erik Faye-Lund
2021-06-18 13:38:31 +02:00
committed by Marge Bot
parent 63c9d51981
commit e41efc173b
1 changed files with 9 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/meson.rst
View File

@@ -165,8 +165,8 @@ Visual Studio integration or you just like msbuild, passing
Installation Location Installation Location
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
Meson default to installing libGL.so in your system's main lib/ Meson default to installing :file:`libGL.so` in your system's main
directory and DRI drivers to a dri/ subdirectory. :file:`lib/` directory and DRI drivers to a :file:`dri/` subdirectory.
Developers will often want to install Mesa to a testing directory rather Developers will often want to install Mesa to a testing directory rather
than the system library directory. This can be done with the --prefix than the system library directory. This can be done with the --prefix
@@ -230,8 +230,9 @@ dependency interface.
Meson can use CMake to find LLVM. But due to the way LLVM implements its Meson can use CMake to find LLVM. But due to the way LLVM implements its
CMake finder it will only find static libraries, it will never find CMake finder it will only find static libraries, it will never find
libllvm.so. There is also a ``-Dcmake_module_path`` option, which points :file:`libllvm.so`. There is also a ``-Dcmake_module_path`` option,
to the root of an alternative installation (the prefix). For example: which points to the root of an alternative installation (the prefix).
For example:
.. code-block:: console .. code-block:: console
@@ -287,7 +288,7 @@ this case a "binary wrap". Follow the steps below:
- Install the binaries and headers into the - Install the binaries and headers into the
``$mesa_src/subprojects/llvm`` ``$mesa_src/subprojects/llvm``
- Add a meson.build file to that directory (more on that later) - Add a :file:`meson.build` file to that directory (more on that later)
The wrap file must define the following: The wrap file must define the following:
@@ -301,7 +302,7 @@ It may also define:
- ``has_rtti``: a ``bool`` that declares whether LLVM was built with - ``has_rtti``: a ``bool`` that declares whether LLVM was built with
RTTI. Defaults to true RTTI. Defaults to true
such a meson.build file might look like: such a :file:`meson.build` file might look like:
:: ::
@@ -400,8 +401,8 @@ this file to ``meson`` or ``meson configure`` with the ``--cross-file``
parameter. parameter.
This file can live at any location, but you can use the bare filename This file can live at any location, but you can use the bare filename
(without the folder path) if you put it in $XDG_DATA_HOME/meson/cross or (without the folder path) if you put it in
~/.local/share/meson/cross :file:`$XDG_DATA_HOME/meson/cross` or :file:`~/.local/share/meson/cross`
Below are a few example of cross files, but keep in mind that you will Below are a few example of cross files, but keep in mind that you will
likely have to alter them for your system. likely have to alter them for your system.