fdo-mirrors/libinput
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/libinput/libinput.git synced 2026-01-10 23:20:17 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: add build instructions for meson

Browse source 
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
Peter Hutterer 2017-05-04 13:30:02 +10:00
parent 4f4bfae2a1
commit 96fa4266d0
1 changed files with 51 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

55
doc/building.dox
View file

@ -12,9 +12,38 @@ see @ref reverting_install to revert to the previous state.
@section building Building libinput
libinput uses automake, a build is usually the three-step process below.
A successful build requires the @ref building_dependencies to be installed
at configure time.
libinput uses [meson](https://www.mesonbuild.com) and
[ninja](https://www.ninja-build.org). A build is usually the three-step
process below. A successful build requires the @ref
building_dependencies to be installed before running meson.
@code
$> git clone git://anongit.freedesktop.org/git/wayland/libinput
$> cd libinput
$> meson --prefix=/usr builddir/
$> ninja -C builddir/
$> sudo ninja -C builddir/ install
$> sudo udevadm hwdb --update
@endcode
The ```prefix``` option or other options can be changed later with the
```mesonconf``` command.
@code
$> mesonconf builddir/ -Dprefix=/some/other/prefix
$> ninja -C builddir
$> sudo ninja -C builddir/ install
@endcode
@note On Fedora, use ```ninja-build``` instead of ```ninja```. We recommend
setting up a shell alias.
@subsection building_autotools Building with automake
libinput currently also provides the autotools build system, but this will
be removed in future libinput versions. A build with automake is usually the
three-step process below. A successful build requires the @ref
building_dependencies to be installed at configure time.
@code
$> git clone git://anongit.freedesktop.org/git/wayland/libinput
@ -52,6 +81,12 @@ files in the system (e.g. ```/usr/lib/libinput.la```) but these files are
usually harmless. To definitely remove all files, run the following command
from the libinput source directory:
@code
$> sudo ninja -C builddir/ uninstall
@endcode
or when using autotools:
@code
$> sudo make uninstall
# WARNING: Do not restart the computer/X/the Wayland compositor after make
@ -110,7 +145,13 @@ for instructions on how to fix it.
libwacom is required by libinput's tablet code to gather additional
information about tablets that is not available from the kernel device
itself. libwacom is required by default but can be skipped when @ref
building with the ``--disable-libwacom`` argument.
building.
@code
$> meson --prefix=/usr -Dlibwacom=false builddir
@endcode
or when building with autotools:
@code
$> ./autogen.sh --disable-libwacom --prefix=/usr --libdir=/usr/lib64
@ -132,6 +173,12 @@ to build. If these libraries are not available, the build will fail.
If the tool is not required, use the ``--disable-event-gui`` argument
when @ref building.
@code
$> meson --prefix=/usr -Devent-gui=false builddir
@endcode
or when building with autotools:
@code
$> ./autogen.sh --disable-event-gui --prefix=/usr --libdir=/usr/lib64
@endcode