fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2026-05-09 08:58:02 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

docs: Mention 'meson devenv' in the pre-install test instructions

Browse source 
Also immunize ourselves against section renumbering.

Reviewed-by: Eric Engestrom <eric@igalia.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25686>
This commit is contained in:
Adam Jackson 2023-03-24 11:10:54 -04:00 • committed by Marge Bot
parent abf5eb5753
commit 6e20f820c6
1 changed files with 23 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

33
docs/install.rst
View file

@ -74,7 +74,7 @@ on the packaging tool used by your distro.
apt-get build-dep mesa # Debian and derivatives
... # others
2. Building with meson
1. Building with meson
----------------------
Meson is the latest build system in mesa, it is currently able to build
@ -99,15 +99,28 @@ On Windows you can also use the Visual Studio backend
Please read the :doc:`detailed meson instructions <meson>` for more
information
3. Running against a local build
--------------------------------
1. Running against a local build (easy way)
-------------------------------------------
It's often necessary or useful when debugging driver issues or testing new
branches to run against a local build of Mesa without doing a system-wide
install. To do this, choose a temporary location for the install. A directory
called ``installdir`` inside your mesa tree is as good as anything. All of the
commands below will assume ``$MESA_INSTALLDIR`` is an absolute path to this
location.
install. Meson has built-in support for this with its ``devenv`` subcommand:
.. code-block:: console
meson devenv -C builddir glxinfo
This will run the given command against the build in ``builddir``. Note that meson
will ``chdir`` into the directory first, so any relative paths in the command line
will be relative to ``builddir`` which may not be what you expect.
1. Running against a local build (hard way)
-------------------------------------------
If you prefer you can configure your test environment manually. To do this,
choose a temporary location for the install. A directory called ``installdir``
inside your mesa tree is as good as anything. All of the commands below will
assume ``$MESA_INSTALLDIR`` is an absolute path to this location.
First, configure Mesa and install in the temporary location:
@ -185,12 +198,12 @@ here are a few things to check:
recently built 64-bit and are now building 32-bit, throw away the install
directory first to prevent conflicts.
4. Building with AOSP (Android)
1. Building with AOSP (Android)
-------------------------------
<TODO>
5. Library Information
1. Library Information
----------------------
When compilation has finished, look in the top-level ``lib/`` (or
@ -221,7 +234,7 @@ If you built the DRI hardware drivers, you'll also see the DRI drivers:
If you built with Gallium support, look in lib/gallium/ for
Gallium-based versions of libGL and device drivers.
6. Building OpenGL programs with pkg-config
1. Building OpenGL programs with pkg-config
-------------------------------------------
Running ``meson install`` will install package configuration files for