unikernel/duniverse/dune_/doc/reference/dune-project/source.rst

@@ -0,0 +1,42 @@
+source
+------
+
+.. describe:: (source ...)
+
+   .. versionadded:: 1.7
+
+   Specify where the source for the package can be found.
+
+   It can be specified as ``(uri <uri>)`` or using shortcuts for some
+   hosting services:
+
+   Valid for all packages defined in the current Dune project. May be overriden
+   by the per-package field (see :doc:`package`).
+
+   .. list-table::
+
+     * - Service
+       - Syntax
+     * - `Github <https://github.com>`_
+       - ``(github user/repo)``
+     * - `Bitbucket <https://bitbucket.org>`_
+       - ``(bitbucket user/repo)``
+     * - `Gitlab <https://gitlab.com>`_
+       - | ``(gitlab user/repo)``
+         | ``(gitlab organization/project/repo)`` *(New in 3.17)*
+     * - `Sourcehut <https://sr.ht>`_
+       - ``(sourcehut user/repo)``
+     * - `Codeberg <https://codeberg.org>`_
+       - ``(codeberg user/repo)`` *(New in 3.17)*
+
+   Examples:
+
+   .. code:: dune
+
+      (source
+       (github ocaml/dune))
+
+   .. code:: dune
+
+      (source
+       (uri https://dev.example.com/project.git))