https://bugzilla.redhat.com/show_bug.cgi?id=2369464 --- Comment #5 from Benson Muite <benson_muite@xxxxxxxxxxxxx> --- (In reply to Ben Beasley from comment #3) > (In reply to Benson Muite from comment #2) > > Initial comments: > > a) It seems possible to build the documentation in docbook format which can > > be > > viewed using Yelp or KHelpCenter > > Sure, but why bring in the extra dependencies just to package documentation > in a format that almost no other Python packages in Fedora use? Who will > expect it, find it, or use it? > For Sphinx, it is possible to add macros to make this easier, as new macros are being added, it is a good time to consider this and make people aware it is available. > Building HTML documentation is probably possible, but problematic due to > bundled fonts, JS, CSS and so on; see bug 2006555. FESCo decisions > https://pagure.io/fesco/issue/3177 and https://pagure.io/fesco/issue/3269 > have made this more feasible, but still messy to try to do correctly. > Docbook does not introduce extra fonts, js or CSS and there is a viewer already packaged. There is some expertise in Fedora for docbook format: https://packages.fedoraproject.org/pkgs/publican/ > I briefly considered building PDF documentation, but this is something I’ve > been trying to get away from: the TexLive dependency is very heavy, and I’ve > had several packages where the PDF documentation breaks in what is otherwise > a minor, compatible update, which puts me in a bind where I cannot update > without dropping the documentation. In this *particular* package, building > the documentation as PDF fails without giving a clear error. > pdf bundles fonts, does not really adapt to screen size and is much larger than docbook. > Overall, I’ve long been in favor of the *idea* of packaged offline > documentation, but I’ve gradually been won over to the perspective that > documentation generated by Sphinx or Doxygen tends to be more trouble than > it is worth to package, and I have been actively working to reduce the > number of packages I maintain with this kind of documentation, not increase > it. > > > https://copr.fedorainfracloud.org/coprs/fed500/python-pyscipopt/builds/ > > > > b) libscip-devel is not available on i686 > > That’s a great observation. Thanks. I’ll add ExcludeArch to this package. Thanks. -- You are receiving this mail because: You are always notified about changes to this product and component You are on the CC list for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2369464 Report this comment as SPAM: https://bugzilla.redhat.com/enter_bug.cgi?product=Bugzilla&format=report-spam&short_desc=Report%20of%20Bug%202369464%23c5 -- _______________________________________________ package-review mailing list -- package-review@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to package-review-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/package-review@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
