Re: [docs] [PATCH] dev-manual: some minor cleanups to "Pre-Built Libraries"

["Antonin Godard" <antonin.godard@bootlin.com>]

On Sun Jun 22, 2025 at 12:59 PM CEST, Robert P. J. Day wrote:
>
>   * Add note about new URL for FHS 3.0.
>   * Add wildcard for "INHIBIT_" variable.
>   * Fix font for ${PN}.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
> diff --git a/documentation/dev-manual/prebuilt-libraries.rst b/documentation/dev-manual/prebuilt-libraries.rst
> index a05f39ca1..077184657 100644
> --- a/documentation/dev-manual/prebuilt-libraries.rst
> +++ b/documentation/dev-manual/prebuilt-libraries.rst
> @@ -22,6 +22,13 @@ To summarize, a versioned library must meet two conditions:
>  This section shows how to deal with both versioned and unversioned
>  pre-built libraries.
>
> +.. note::
> +
> +   In the shared library article referenced above, the link to the current
> +   version of the Filesystem Hierarchy Standard (FHS) is out of date;
> +   the current FHS 3.0 release can be found
> +   `here <https://refspecs.linuxfoundation.org/FHS_3.0/index.html>`__.

Not sure adding a note to say a link is outdated is the good approach.
Instead update the link above?

>  Versioned Libraries
>  ===================
>
> @@ -79,7 +86,7 @@ To write a recipe to use such a library in your system:
>  -  The vendor will typically ship release builds without debugging symbols.
>     Avoid errors by preventing the packaging task from stripping out the symbols
>     and adding them to a separate debug package. This is done by setting the
> -   ``INHIBIT_`` flags shown below.
> +   ``INHIBIT_*`` flags shown below.
>
>  The complete recipe would look like this::
>
> @@ -170,7 +177,7 @@ as follows::
>  The modifications cause the ``.so`` file to be the real library
>  and unset :term:`FILES_SOLIBSDEV` so that no libraries get packaged into
>  ``${PN}-dev``. The changes are required because unless :term:`PACKAGES` is changed,
> -``${PN}-dev`` collects files before `${PN}`. ``${PN}-dev`` must not collect any of
> +``${PN}-dev`` collects files before ``${PN}``. ``${PN}-dev`` must not collect any of

Can you send this in a separate patch?

>  the files you want in ``${PN}``.
>
>  Finally, loadable modules, essentially unversioned libraries that are linked


Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com