Build and use
=============

After setting up the environment following the previous :doc:`setup`
section, it is time to start building the Rat C++ libraries using
vcpkg_.

The Project-Rat_ libraries are here defined as `vcpkg ports`_.
This section describes how ports can serve both vcpkg_ modes and
the workflows to consume (build/use) packages.

.. seealso::

    - :doc:`about_vcpkg_ports`
    - `vcpkg in CMake projects`_

.. Rat-vcpkg: build and use table of contents
.. toctree::
   :maxdepth: 2
   :caption: RAT-VCPKG: BUILD AND USE CONTENTS

   caching
   manifest_mode
   classic_mode
   examples

.. mermaid:: ../graphs/repo-rat-vcpkg/build_and_use_index.mmd

.. Links
.. _Project-Rat: https://gitlab.com/project-rat
.. _vcpkg: https://vcpkg.io/en/
.. _vcpkg in CMake projects: https://learn.microsoft.com/en-us/vcpkg/users/buildsystems/cmake-integration
.. _vcpkg ports: https://learn.microsoft.com/en-us/vcpkg/concepts/ports