Hi Mikko,

On 10/4/22 17:27, Mikko Rapeli wrote:
It sets various environment variables correctly for openssl-native.

Signed-off-by: Mikko Rapeli <mikko.rap...@linaro.org>
---
  documentation/ref-manual/classes.rst | 11 +++++++++++
  1 file changed, 11 insertions(+)

diff --git a/documentation/ref-manual/classes.rst 
b/documentation/ref-manual/classes.rst
index 11e0d472e8..5fc30f9233 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1672,6 +1672,17 @@ one such example. However, being aware of this class can 
reduce the
  proliferation of different versions of similar classes across multiple
  layers.
+.. _ref-classes-openssl-native:
+
+``openssl-native.bbclass``
+==================
+
+The ``openssl-native`` class supports using the native version of openssl

The :ref:`openssl-native <ref-classes-openssl-native>` class supports using the native version of ``openssl``
+built by the build system rather than support of the version provided
+by the build host. It helps setting environment variables for engines,
+modules, certificates etc correctly. For full certificate checking
+users should also add ``ca-certificates-native`` to :term:`DEPENDS`.
+

I could suggest:
"""
built by the Yocto Project instead of the one provided by the build host distribution.
"""

I find "rather than support of the version..." confusing.

I think we could also replace the "It helps" sentence by stating that any recipe requiring openssl to be run on the host should inherit this class instead of just adding openssl-native to DEPENDS. Maybe that could even be a new QA check?

I would still keep the last sentence though.

What do you think?

(Thank you for sending a documentation patch in the same series as the code implementation, this is rare enough to be highlighted, much appreciated!)

Cheers,
Quentin
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#171450): 
https://lists.openembedded.org/g/openembedded-core/message/171450
Mute This Topic: https://lists.openembedded.org/mt/94131410/21656
Group Owner: openembedded-core+ow...@lists.openembedded.org
Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub 
[arch...@mail-archive.com]
-=-=-=-=-=-=-=-=-=-=-=-

Reply via email to