https://bugzilla.redhat.com/show_bug.cgi?id=2369464 --- Comment #3 from Ben Beasley <code@xxxxxxxxxxxxxxxxxx> --- (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? 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. 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. 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. -- You are receiving this mail because: You are on the CC list for the bug. You are always notified about changes to this product and component 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%23c3 -- _______________________________________________ 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
