Bugzilla – Bug 1217886
pipewire generates corrupted documentation with doxygen < 1.9.7
Last modified: 2024-02-21 07:40:05 UTC
To quote the pipewire dev who wrote the patches: > This will need Doxygen 1.9.7, earlier versions put .md files in wrong place in HTML treeview because of https://github.com/doxygen/doxygen/issues/9254 The pipewire package is presently using doxygen 1.9.6, so is generating corrupt docs. Doxygen can't be updated because wxPython is broken on new versions, so wxPython needs to be fixed, so that doxygen can be updated, so that pipewire generates docs correctly. See https://build.opensuse.org/request/show/1128250 Sorry to be the bearer of bad news.
Is there an upstream issue open for wxPython? Doxygen 1.10 was released!
Fixed in wxPython, see https://github.com/wxWidgets/Phoenix/pull/2497 This commit has to be added to our wxPython package as a patch.
(In reply to Christoph G from comment #1) > Is there an upstream issue open for wxPython? Doxygen 1.10 was released! As far as I'm aware, nobody from opensuse has chased this up with them yet. I brought it up on OBS and got no replies, so that's why I created this issue, and I've had no replies here, either.
(In reply to Christoph G from comment #2) > Fixed in wxPython, see https://github.com/wxWidgets/Phoenix/pull/2497 > This commit has to be added to our wxPython package as a patch. But perhaps this was an opensuse contributor helping out? I guess we will just have to wait and see if opensuse pick it up, or maybe we'll have to wait for the next wxWidgets release for the next doxygen release so we can have fully working pipewire. Until then I'm building doxygen and pipewire in my home repo so that my doco works, which isn't great.... I wish someone from opensuse would say something to us. I feel like a mushroom :D
Thanks Pallas and Christoph for taking care of this. I submitted the wxPython fix (and a couple other fixes) in https://build.opensuse.org/request/show/1135151 and there's already https://build.opensuse.org/request/show/1135120 that submits a doxygen update. So let's see if those get approved soon.
(In reply to Antonio Larrosa from comment #5) > Thanks Pallas and Christoph for taking care of this. I submitted the > wxPython fix (and a couple other fixes) in > https://build.opensuse.org/request/show/1135151 and there's already > https://build.opensuse.org/request/show/1135120 that submits a doxygen > update. So let's see if those get approved soon. Ahh legendary, thanks Antonio! All credit for taking care of it goes to you and Christoph, here, I didn't know about the patch! Much appreciated thanks to you both :)
doxygen is 1.10 now, so this can me closed, the next pipewire release's doc should be fine. Great work Antonio and Christoph, thanks so much!