On Thu, Sep 28, 2023 at 9:12 PM Florian Weimer <fweimer@xxxxxxxxxx> wrote: > > * Stephen Gallagher: > > > On Wed, Sep 27, 2023 at 12:59 PM Ron Olson <tachoknight@xxxxxxxxx> 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@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx 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@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
