Common Conventions
==================

XDG Desktop Portal uses D-Bus in a slightly uncommon way, due to the potentially
long-running nature of some of its requests. These different usage patterns are
documented in the pages below:

.. toctree::
   :hidden:

   terminology
   requests
   sessions
   window-identifiers
   icons

.. cssclass:: tiled-toc

*  .. image:: _static/img/tiles/Terminology-l.png
      :target: terminology.html
      :class: only-light
   .. image:: _static/img/tiles/Terminology-d.png
      :target: terminology.html
      :class: only-dark

   :doc:`Terminology </terminology>`
*  .. image:: _static/img/tiles/Request-l.png
      :target: requests.html
      :class: only-light
   .. image:: _static/img/tiles/Request-d.png
      :target: requests.html
      :class: only-dark

   :doc:`Requests </requests>`
*  .. image:: _static/img/tiles/Sessions-l.png
      :target: sessions.html
      :class: only-light
   .. image:: _static/img/tiles/Sessions-d.png
      :target: sessions.html
      :class: only-dark

   :doc:`Sessions </sessions>`
*  .. image:: _static/img/tiles/Window-ids-l.png
      :target: window-identifiers.html
      :class: only-light
   .. image:: _static/img/tiles/Window-ids-d.png
      :target: window-identifiers.html
      :class: only-dark

   :doc:`Window Identifiers </window-identifiers>`
*  .. image:: _static/img/tiles/Icons-l.png
      :target: icons.html
      :class: only-light
   .. image:: _static/img/tiles/Icons-d.png
      :target: icons.html
      :class: only-dark

   :doc:`Icons </icons>`