Control: tags -1 wontfix
On Sat, Mar 14, 2020 at 05:35:14PM -0400, Sandro Tosi wrote:
> from what i can see, xapian-bindings builds its documentation twice, one for
> the
> python2 bindings (and install that in bin:python-xapian) and one for the
> python3
> bindings (and install that in bin:python3-xapian).
>
> this is usually un-necessary, and the convention is to create a separate
> package
> to contain the documentation, in this case python-xapian-doc. So please split
> out such a package to contain the documentation for the python bindings in a
> single place, and that the same time, please only use python3-sphinx to build
> the documentation.
The Python2 and Python3 bindings don't have exactly the same API (mostly
due to Unicode handling differences, but also the Python3 bindings don't
include various backward-compatibility features with older versions of
the Python2 bindings)
A single set of docs doesn't really work as the Python3 bindings docs
aren't a good replacement for the Python2 bindings docs. It this seems
to fall outside your "usually un-necessary" hence tagging as wontfix.
Cheers,
Olly
