Bug#979493: Error: Rule failed to generate the following targets: _doc/_html/highlight.pack.js

[Johannes 'josch' Schauer <josch@debian.org>]

Package: ocaml-odoc
Version: 1.5.1+dfsg-2+b1
Severity: grave
Justification: renders package unusable

Hi Ralf,

as you probably remember, I brought up the odoc problem before here:

https://gitlab.com/irill/dose3/-/merge_requests/1#note_475481814

I now investigated further and it seems that the package has an
autopkgtest (yay!) so I triggered that and it failed with the same error
message that I got:

https://ci.debian.net/data/autopkgtest/unstable/amd64/o/ocaml-odoc/9469763/log.gz

Since the logs are removed after some time, here the last lines from the
log:

autopkgtest [02:11:21]: test odoc-on-odoc: [-----------------------
File series fully applied, ends at patch debian/patches/no-vendored-js-highlight
File "_doc/_html/_unknown_", line 1, characters 0-0:
Error: Rule failed to generate the following targets:
- _doc/_html/highlight.pack.js
autopkgtest [02:11:26]: test odoc-on-odoc: -----------------------]
autopkgtest [02:11:26]: test odoc-on-odoc:  - - - - - - - - - - results - - - - - - - - - -
odoc-on-odoc         FAIL non-zero exit status 1
autopkgtest [02:11:27]: @@@@@@@@@@@@@@@@@@@@ summary
odoc-on-odoc         FAIL non-zero exit status 1

[ I also took the liberty to add salsaci to the ocaml-odoc repository on
salsa and it seems there is also a FTBFS which I was unable to trigger
locally using sbuild:
https://salsa.debian.org/ocaml-team/ocaml-odoc/-/pipelines/216353 ]

This makes me believe that this is probably not a problem with my system
but with the ocaml-odoc package itself.

A minimal test that triggers this error message is this shell script:

--%<------------------
#!/bin/sh
mkdir "$1/test"
cat << END > "$1/test/dune-project"
(lang dune 2.0)
(name test)
(generate_opam_files true)
(package (name test))
END
chroot "$1" sh -c 'cd /test && dune build @doc'
-->%------------------

Which I passed to mmdebstrap with the first timestamp from
snapshot.debian.org in which the ocaml-odoc package existed to see
whether maybe this is a regression and this used to work in the
beginning:

    $ mmdebstrap --aptopt='Acquire::Check-Valid-Until "false"' \
        --variant=apt unstable --include=ocaml-odoc,ocaml-dune,ocaml-nox \
        --customize-hook=/tmp/test.sh \
        /dev/null http://snapshot.debian.org/archive/debian/20200624T145103Z/

But even back in June 2020 I got the same error message as from the
autopkgtest on debci run above.

I didn't try with the opam version yet. Maybe it works there. Nobody
else (build-)depends on ocaml-odoc yet, so this problem is probably not
super important unless we want to generate documentation for the next
dose3 release.

Thanks!

cheers, josch