mirror of
https://github.com/gnif/LookingGlass.git
synced 2024-11-21 21:17:19 +00:00
[doc] add documentation about libdecor
This commit is contained in:
parent
1e2caf4c9f
commit
0b70aa49d0
@ -127,6 +127,13 @@ into the *LookingGlass* directory.
|
||||
This will build the **looking-glass-client** binary, which is used to display
|
||||
frames from the guest.
|
||||
|
||||
.. note::
|
||||
|
||||
If you are using GNOME on Wayland, you likely want to pass
|
||||
``-DENABLE_LIBDECOR=ON`` to ``cmake``, i.e. run ``cmake -DENABLE_LIBDECOR=ON ../``.
|
||||
|
||||
For details, see :ref:`the FAQ <gnome_wayland_decorations>`.
|
||||
|
||||
.. seealso::
|
||||
|
||||
- :ref:`Installing the Client <client_install>`
|
||||
|
25
doc/faq.rst
25
doc/faq.rst
@ -77,6 +77,31 @@ host OS is the ``looking-glass-client`` application.
|
||||
You can :ref:`build <host_linux_on_linux>` a version of the host for Linux as
|
||||
well.
|
||||
|
||||
.. _gnome_wayland_decorations:
|
||||
|
||||
Why is there no title bar? / Why can't I resize the window?
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This happens on GNOME Wayland because GNOME doesn't support the `standard
|
||||
protocol`_ for server-side decorations. As a result, the window decorations
|
||||
do not appear.
|
||||
|
||||
The easy solution is to use `libdecor`_. This is currently not packaged in
|
||||
most distros, so you will need to build it from the linked git repository.
|
||||
|
||||
Once you have built it, you can then build the the client with libdecor
|
||||
support by passing ``-DENABLE_LIBDECOR=ON`` to ``cmake``.
|
||||
|
||||
Please be aware that libdecor comes with overheads, which is why it is not
|
||||
used by default. You should avoid it if possible.
|
||||
|
||||
An alternative solution is to hold down the Super key (Windows key on most
|
||||
keyboards), and then right click on the window. This should bring up a menu,
|
||||
which will allow you to move the window and resize it.
|
||||
|
||||
.. _standard protocol: https://wayland.app/protocols/xdg-decoration-unstable-v1
|
||||
.. _libdecor: https://gitlab.gnome.org/jadahl/libdecor
|
||||
|
||||
Mouse
|
||||
-----
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user