[Bug 300368] textproc/py-rst2html5: Deprecate (conflicts with py-docutils on bin/rst2html5)

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=300368

            Bug ID: 300368
           Summary: textproc/py-rst2html5: Deprecate (conflicts with
                    py-docutils on bin/rst2html5)
           Product: Ports & Packages
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Individual Port(s)
          Assignee: python@FreeBSD.org
          Reporter: patrick@crandol.com
          Assignee: python@FreeBSD.org
             Flags: maintainer-feedback?(python@FreeBSD.org)

textproc/py-rst2html5 2.0 can't be installed together with its own
dependency, textproc/py-docutils:

    py312-rst2html5-2.0_1 conflicts with py312-docutils-0.22.4,1 on
/usr/local/bin/rst2html5

Since py-docutils was updated to 0.21.2 (c0615e6a, 2024-07-11),
docutils itself installs bin/rst2html5, and this port installs the same
file, so pkg refuses. The packaged command is broken anyway: setup.py's
entry point is rst2html5_:main, but rst2html5_.py is not installed.

Upstream (https://foss.heptapod.net/doc-utils/rst2html5) has been
dormant since 2.0.1 (2024-01-06), and 2.0.1 still installs an rst2html5
script that overwrites the one from docutils by design, so updating
would not remove the conflict. An update would have to rename the
script, probably for little value, since docutils now ships an rst2html5
command of its own.

This proposes deprecating it; I've left EXPIRATION_DATE for you to set.
The patch sets

    DEPRECATED= Conflicts with its own dependency textproc/py-docutils
    BROKEN=             its bin/rst2html5 conflicts with its own dependency
textproc/py-docutils

If you would rather keep the port, it would need an update to 2.0.1 with
its rst2html5 script renamed so it no longer overwrites the one from
textproc/py-docutils, which already ships that command.

Impact: no ports depend on it. The ports that use an rst2html5 command
(json-glib, pango, taisei) already use the one from docutils.

Users can use the rst2html5 command from textproc/py-docutils.

-- 
You are receiving this mail because:
You are the assignee for the bug.