[Python-modules-team] Bug#833791: dh_sphinxdoc: Fails to recognise Sphinx-generated documentation

[Ben Finney]

On 08-Aug-2016, Dmitry Shachnev wrote:
> Hi Ben,

Thank you for the quick response.

> On Tue, Aug 09, 2016 at 02:47:23AM +1000, Ben Finney wrote:
> > $ dh_sphinxdoc doc/_build/html
> > dh_sphinxdoc: Sphinx documentation not found at doc/_build/html/
> 
> This command does not make any sense. dh_sphinxdoc operates on
> *installed* documentation

As can be seen from the session in the original message, the
documentation is installed. (It is built by the upstream build system,
and that's the default location.)

> and looks for files in debian/{packagename}/ directories.

Yes, that's why I'm specifying the location where the documentation
was actually installed by the upstream build system.

> Passing the path is usually not necessary (just calling it with no
> arguments after the files are installed is enough), but when you
> pass the path, it should be relative to the installation root
> directory.

Thanks for the advice.

That does not address this bug: The ‘dh_sphinxdoc’ tool is failing to
detect documentation that's clearly in the place where the command
specifies to look.

Its error message even reports the very directory where it looked, and
claims it can't find documentation that evidently exists there.

-- 
 \     “I thought I'd begin by reading a poem by Shakespeare, but then |
  `\     I thought ‘Why should I? He never reads any of mine.’” —Spike |
_o__)                                                         Milligan |
Ben Finney <ben at benfinney.id.au>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20160809/42e76ef2/attachment.sig>