Can’t we just get rid of the python2 sphinx and keep only the python3 version?
— Antoine > On 26 Jan 2020, at 22:06, Stuart Henderson <s...@spacehopper.org> wrote: > > There are two sphinxs: > > textproc/py-sphinx: "python documentation generator" > https://www.sphinx-doc.org/ > > textproc/sphinx: "free open-source SQL full-text search engine" > https://sphinxsearch.com/ > > The first is the one people usually want, the presence of textproc/sphinx > in itself causes some confusion (there's a comment in the port Makefile > but mistakes are still sometimes made with this). > > There's also a problem with the py2/3 versions of py-sphinx because the > executables are named sphinx-<whatever> and sphinx-<whatever>-3 to avoid a > conflict; this causes problems for porters wanting to use the doc generator > that result in either pulling in an unwanted py2 dependency, or having to > patch or add symlinks to cope with the unexpected filename. > > A proposal in three parts: > > - Either drop textproc/sphinx (it's unmaintained in ports, hasn't been > updated in ports since 2015 despite regular upstream updates, and has no > other ports using it), or reimport it as databases/sphinxsearch to avoid > confusion. > > - Remove executables from py-sphinx and py3-sphinx > > - Either multipackage py3-sphinx or add a separate port, the relevant > package depending on py3-sphinx, and containing the executables, named > without MODPY_BIN_SUFFIX, i.e. sphinx-apidoc, sphinx-build etc. > Maybe name this something like sphinxdoc or sphinx-doc? (Just plain > "sphinx" would be easier to use, but probably a bit confusing when > coupled with the old sphinxsearch sphinx-XX packages..) > > I can take a look at actually doing this but wanted a sanity check from > other porters first.. any feedback? > > (This isn't just about sphinx, we also need a way to properly handle the > MODPY_BIN_SUFFIXed executables in a bunch of other python ports, but > this seems a good a place as any to start with because it's already > causing problems for porters, and when we get it to work it would act > as a template to use for others..) >
