On Thu, Sep 28, 2023 at 9:12 PM Florian Weimer <fwei...@redhat.com> wrote:
>
> * Stephen Gallagher:
>
> > On Wed, Sep 27, 2023 at 12:59 PM Ron Olson <tachokni...@gmail.com> wrote:
> >>
> >> I mean this sincerely: Where is the excellent documentation? I admit that 
> >> I’ve been frustrated that web searches leads me all over the place, 
> >> sometimes the documentation is obsolete, or it’s someone’s blog post, etc. 
> >> I’ve been surprised again and again there’s a macro for this or that which 
> >> could have made the job much easier, but I had no idea until I asked here 
> >> or in IRC.
> >>
> >
> > The documentation he's referring to is the
> > https://src.fedoraproject.org/rpms/redhat-rpm-config/blob/rawhide/f/buildflags.md
> >
> > Indeed, we probably should figure out a way to make that link more
> > prominent on the Packaging Guidelines pages, though.
>
> I couldn't figure out the contribution process for the documentation (it
> probably has changed since), but I did file
> <https://pagure.io/packaging-committee/issue/743> a while back.
>
> Making a copy is disappointing because it will bit-rot fairly quickly.
> Every Fedora release will change some build flags.  And ideally, you'd
> consult the documentation for the Fedora release you are working on.
> The on-the-side documentation wouldn't be versioned per Fedora release.

The buildflags.md doc is indeed linked from the Packaging Guidelines:
https://docs.fedoraproject.org/en-US/packaging-guidelines/RPMMacros/#_macros_providing_compiler_and_linker_flags

It might be put into a more prominent location, but it *is* referenced.
I should know, I put the link there :)

https://pagure.io/packaging-committee/c/16efbb0b4d2337b3d59e7a61c38b78cd2a3e8c1f

Not sure why the ticket you filed wasn't updated or closed.

Fabio
_______________________________________________
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam, report it: 
https://pagure.io/fedora-infrastructure/new_issue

Reply via email to