Document new interface

Signed-off-by: Cristian Le <git@lecris.dev>

Author: LecrisUT

docs/releases/pending/4427.fmf

@@ -0,0 +1,6 @@
+description: |
+  Beakerlib libraries can now be referenced without a ``url`` or ``path`` key.
+  In that case the ``name`` is relative to the discovered test's tmt tree.
+  The ``nick`` key **must** be set in this situation, matching what the
+  consuming scripts are using in ``rlImport``, or the name of the repo or
+  equivalent.

spec/tests/require.fmf

@@ -34,8 +34,15 @@ description: |
 
     By default, fetched repositories are stored in the discover
     step workdir under the ``libs`` directory. Use optional key
-    ``destination`` to choose a different location. The ``nick``
-    key can be used to override the default git repository name.
+    ``destination`` to choose a different location.
+
+    .. note::
+       :name: nick-usage
+
+       The name of the beakerlib library (the value used with
+       ``rlImport``) is taken as the last directory pointed by
+       ``url`` or ``path``. Use the ``nick`` key if you need
+       to override this.
 
     For debugging beakerlib libraries it is useful to reference
     the development version directly from the local filesystem.
@@ -49,6 +56,13 @@ description: |
     __ https://github.com/beakerlib/
     __ https://fmf.readthedocs.io/en/latest/concept.html#identifiers
 
+    .. versionadded:: 1.65
+       As a special handling when using ``type: library``, if both
+       ``url`` and ``path`` is omitted, the current test's tree is
+       used as the repo of the library. The ``nick`` key **must**
+       be set in this case (see :ref:`previous note<nick-usage>`
+       for what values to set for this)
+
 example:
   - |
     # Require a single package
@@ -75,6 +89,13 @@ example:
         url: https://github.com/beakerlib/openssl
         name: /certgen
 
+  - |
+    # Library from the current tmt tree
+    require:
+      - type: library
+        name: /certgen
+        nick: openssl
+
   - |
     # Library from the local filesystem
     require: