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

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

On Tue Jun 24, 2025 at 10:31 AM CEST, Robert P. J. Day wrote:
> On Tue, 24 Jun 2025, Antonin Godard via lists.yoctoproject.org wrote:
>
>> 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?
>
>   i'm not sure that's the right way to do it. that old article is
> quite a decent explanation of library versioning; if we now link
> directly to the FHS spec from the yocto docs and bypass that article,
> we lose a lot of good intro-level explanation.
>
>   thoughts?

I see. Then as Quentin suggested I think it's reasonable to link to
https://refspecs.linuxfoundation.org/fhs.shtml instead of the 3.0 version, and
say:

"""
the latest release can be found `here
<https://refspecs.linuxfoundation.org/fhs.shtml>`__.
"""

Thanks,
Antonin

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