Skip to contentSkip to conversation

sphinx: dev-manual: Clarify that virtual providers do not apply to runtime dependencies

PATCH In review Joshua Watt 2 participants 3 messages Aug 31, 2020 – Sep 16, 2020

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 sphinx: dev-manual: Clarify that virtual providers do not apply to runtime dependencies

From: Joshua Watt <[email protected]>

Clarifies that virtual providers are only used for build time dependencies specified with PROVIDES and DEPENDS, and do not apply to runtime dependencies specified with RPROVIDES and RDEPENDS.

---
 documentation/dev-manual/dev-manual-common-tasks.rst | 6 ++++++
 1 file changed, 6 insertions(+)
documentation/dev-manual/dev-manual-common-tasks.rst +6 -0
index c9b8a834c..a54379fef 100644
@@ -2000,6 +2000,12 @@ The following lists specific examples of virtual providers:
 
 -  ``virtual/libgles2``: Provides ``glesv2.pc`` (i.e. libGLESv2).
 
+.. note::
+
+   Virtual providers only apply to build time dependencies specified with
+   :term:`PROVIDES` and :term:`DEPENDS`. They do not apply to runtime
+   dependencies specified with :term:`RPROVIDES` and :term:`RDEPENDS`.
+
 Properly Versioning Pre-Release Recipes
 ---------------------------------------
 
Signature · 1 line
2.28.0
#1 lore raw
Quoted 17 lines · Joshua Watt

From: Joshua Watt <[email protected]>

Clarifies that virtual providers are only used for build time dependencies specified with PROVIDES and DEPENDS, and do not apply to runtime dependencies specified with RPROVIDES and RDEPENDS.

---
 documentation/dev-manual/dev-manual-common-tasks.rst | 6 ++++++
 1 file changed, 6 insertions(+)
documentation/dev-manual/dev-manual-common-tasks.rst +0 -0
index c9b8a834c..a54379fef 100644

documentation/dev-manual/dev-manual-common-tasks.rst The following lists specific examples of virtual providers: · line 2007

Quoted 8 lines
documentation/dev-manual/dev-manual-common-tasks.rst +5 -0
@@ -2000,6 +2000,12 @@ The following lists specific examples of virtual providers:
 
 -  ``virtual/libgles2``: Provides ``glesv2.pc`` (i.e. libGLESv2).
 
+.. note::
+
+   Virtual providers only apply to build time dependencies specified with
+   :term:`PROVIDES` and :term:`DEPENDS`. They do not apply to runtime
+   dependencies specified with :term:`RPROVIDES` and :term:`RDEPENDS`.

Thank you so much for sending it both versions of the doc patches (docbook and sphinx). It's very much appreciated!

Quoted 8 lines
documentation/dev-manual/dev-manual-common-tasks.rst +1 -1
+
 Properly Versioning Pre-Release Recipes
 ---------------------------------------
 
--

2.28.0

#2 lore raw
In reply to Joshua Watt
Quoted 8 lines · Joshua Watt

From: Joshua Watt <[email protected]>

Clarifies that virtual providers are only used for build time dependencies specified with PROVIDES and DEPENDS, and do not apply to runtime dependencies specified with RPROVIDES and RDEPENDS.

thanks. Pulled into the sphinx branch. It will be included in the next release, once we merge in master.

Quoted 25 lines
---
 documentation/dev-manual/dev-manual-common-tasks.rst | 6 ++++++
 1 file changed, 6 insertions(+)
documentation/dev-manual/dev-manual-common-tasks.rst +6 -1
index c9b8a834c..a54379fef 100644
@@ -2000,6 +2000,12 @@ The following lists specific examples of virtual providers:
 
 -  ``virtual/libgles2``: Provides ``glesv2.pc`` (i.e. libGLESv2).
 
+.. note::
+
+   Virtual providers only apply to build time dependencies specified with
+   :term:`PROVIDES` and :term:`DEPENDS`. They do not apply to runtime
+   dependencies specified with :term:`RPROVIDES` and :term:`RDEPENDS`.
+
 Properly Versioning Pre-Release Recipes
 ---------------------------------------
 
--

2.28.0