Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.bugs.dist > #1200850 > unrolled thread

Bug#1073183: python-dask-doc: invalid doc-base file

Back to article view | Back to linux.debian.bugs.dist

Contents

  Bug#1073183: python-dask-doc: invalid doc-base file Julian Gilbey <jdg@debian.org> - 2024-06-14 10:10 +0200
    Bug#1073183: python-dask-doc: invalid doc-base file Julian Gilbey <jdg@debian.org> - 2024-06-14 11:00 +0200
      Bug#1073183: python-dask-doc: package is almost empty with no documentation Étienne Mollier <emollier@debian.org> - 2024-06-14 22:50 +0200
      Bug#1073183: python-dask-doc: invalid doc-base file Diane Trout <diane@ghic.org> - 2024-06-16 02:20 +0200
        Bug#1073183: python-dask-doc: invalid doc-base file Julian Gilbey <julian@d-and-j.net> - 2024-06-16 15:30 +0200

#1200850 — Bug#1073183: python-dask-doc: invalid doc-base file

Package: python-dask-doc
Version: 2024.1.1+dfsg-1
Severity: normal

On installing python-dask-doc, I get the following error message:

Error in `/usr/share/doc-base/python-dask-doc.python-dask-doc', line 11: all `Format' sections are invalid.

Running the verbose check as recommended:

euler:~ # install-docs --verbose --check /usr/share/doc-base/python-dask-doc.python-dask-doc 
Warning in `/usr/share/doc-base/python-dask-doc.python-dask-doc', line 11: file `/usr/share/doc/python-dask-doc/html/index.html' does not exist.
Error in `/usr/share/doc-base/python-dask-doc.python-dask-doc', line 11: all `Format' sections are invalid.
/usr/share/doc-base/python-dask-doc.python-dask-doc: Fatal error found, the file won't be registered.

[toc] | [next] | [standalone]

#1200861

retitle 1073183 python-dask-doc: package is almost empty with no documentation
severity 1073183 important
thanks

On Fri, Jun 14, 2024 at 09:03:35AM +0100, Julian Gilbey wrote:
> Package: python-dask-doc
> Version: 2024.1.1+dfsg-1
> Severity: normal
> 
> On installing python-dask-doc, I get the following error message:
> 
> Error in `/usr/share/doc-base/python-dask-doc.python-dask-doc', line 11: all `Format' sections are invalid.
> [...]

Ah, I think I see the cause of the problem: the python-dask-doc
package is almost empty!  Something's clearly gone wrong here.

I'm retitling the bug report in recognition and raising its severity.

Best wishes,

   Julian

[toc] | [prev] | [next] | [standalone]

#1200922 — Bug#1073183: python-dask-doc: package is almost empty with no documentation

[Multipart message — attachments visible in raw view] — view raw

Control: tags -1 + confirmed

Hi Julian,

Julian Gilbey, on 2024-06-14:
> Ah, I think I see the cause of the problem: the python-dask-doc
> package is almost empty!  Something's clearly gone wrong here.

I happen to be staring at dask at the moment, and indeed,
lintian tripped on the broken doc-base entries caused by the
empty package.  In essence, the building procedure looks to rely
heavily on resources on the web, and required extra steps in
past uploads to stay in working conditions.  There are patching
stubs already present replacing some of the remote resources by
some locally packaged ones, but I didn't really grasp how the
whole thing worked to extend on that.

Have a nice day,  :)
-- 
  .''`.  Étienne Mollier <emollier@debian.org>
 : :' :  pgp: 8f91 b227 c7d6 f2b1 948c  8236 793c f67e 8f0d 11da
 `. `'   sent from /dev/pts/1, please excuse my verbosity
   `-

[toc] | [prev] | [next] | [standalone]

#1201059

On Fri, 2024-06-14 at 09:50 +0100, Julian Gilbey wrote:
> retitle 1073183 python-dask-doc: package is almost empty with no
> documentation
> severity 1073183 important
> thanks
> 
> On Fri, Jun 14, 2024 at 09:03:35AM +0100, Julian Gilbey wrote:
> > Package: python-dask-doc
> > Version: 2024.1.1+dfsg-1
> > Severity: normal
> > 
> > On installing python-dask-doc, I get the following error message:
> > 
> > Error in `/usr/share/doc-base/python-dask-doc.python-dask-doc',
> > line 11: all `Format' sections are invalid.
> > [...]
> 
> Ah, I think I see the cause of the problem: the python-dask-doc
> package is almost empty!  Something's clearly gone wrong here.

I probably found the reason docs aren't building correctly.

In debian/rules the call to build the docs is:

  PYTHONPATH=$(CURDIR) $(MAKE) -C docs html || true

running the documentation build without the || true.

Extension error (sphinx.ext.autosummary):
Handler <function process_generate_options at 0x7ff3fbd04360> for event
'builder-inited' threw an exception (exception: no module named
dask_expr.DataFrame)


It looks like dask_expr is officially an optional dependence as of
2024.5.2, I going to see if I can make it optional to sphinx too.

Diane

[toc] | [prev] | [next] | [standalone]

#1201134

On Sat, Jun 15, 2024 at 04:31:37PM -0700, Diane Trout wrote:
> I probably found the reason docs aren't building correctly.
> 
> In debian/rules the call to build the docs is:
> 
>   PYTHONPATH=$(CURDIR) $(MAKE) -C docs html || true

Good detective work, Diane!  What a silly thing to do in a build
script!  :-)

> running the documentation build without the || true.
> 
> Extension error (sphinx.ext.autosummary):
> Handler <function process_generate_options at 0x7ff3fbd04360> for event
> 'builder-inited' threw an exception (exception: no module named
> dask_expr.DataFrame)
> 
> It looks like dask_expr is officially an optional dependence as of
> 2024.5.2, I going to see if I can make it optional to sphinx too.

Thanks for fixing this!

Best wishes,

   Julian

[toc] | [prev] | [standalone]

Back to top | Article view | linux.debian.bugs.dist

csiph-web