feat(weston): describe how to take screenshots

Describe how to take screenshots and the required configuration steps
beforehand.

Signed-off-by: Randolph Sapp <[email protected]>

Author: StaticRocket

source/linux/Foundational_Components/Graphics/Common/Weston.rst

@@ -253,3 +253,19 @@ See the following for more information about the Weston IVI-shell:
 
    - `<https://wayland.pages.freedesktop.org/weston/toc/ivi-shell.html>`_
 
+***********
+Screenshots
+***********
+
+The :command:`weston-screenshooter` utility allows for fast, full-screen
+screenshots. It behaves similarly to any other weston client utility and
+requires the ``WAYLAND_DISPLAY`` environment variable to point to a valid
+Wayland socket. See :ref:`running-weston-clients` for more information.
+
+For most Wayland compositors this would be enough, but Weston requires
+additional configuration. Weston does not support the `screen capture
+protocol`_, and instead uses an internal helper to fetch and dump active display
+contents. Weston only exposes this helper when launched in debug mode. To do
+this, add the ``--debug`` argument when starting Weston.
+
+.. _screen capture protocol: https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/staging/ext-image-copy-capture/ext-image-copy-capture-v1.xml