(lint-doc)

2025-07-17 18:23.56: New job: test robur-coop/ocaml-h1 https://github.com/robur-coop/ocaml-h1.git#refs/heads/master (8af72495de51ed84801fc93a25f3b47ee90ed709) (linux-x86_64:(lint-doc))
Base: ocaml/opam:debian-12-ocaml-4.08@sha256:4b3e5b2d1be26cada6c08f752ca0b48d3b0ba20fec23648d53395a83f1ae2517
Opam project lint documentation


To reproduce locally:


git clone --recursive "https://github.com/robur-coop/ocaml-h1.git" -b "master" && cd "ocaml-h1" && git reset --hard 8af72495
cat > Dockerfile <<'END-OF-DOCKERFILE'
FROM ocaml/opam:debian-12-ocaml-4.08@sha256:4b3e5b2d1be26cada6c08f752ca0b48d3b0ba20fec23648d53395a83f1ae2517
# debian-12-4.08_opam-2.3
USER 1000:1000
ENV CLICOLOR_FORCE="1"
ENV OPAMCOLOR="always"
WORKDIR /src
RUN sudo ln -f /usr/bin/opam-2.2 /usr/bin/opam
RUN opam init --reinit -ni
RUN uname -rs && opam exec -- ocaml -version && opam --version
WORKDIR /src
RUN sudo chown opam /src
RUN cd ~/opam-repository && (git cat-file -e 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 || git fetch origin master) && git reset -q --hard 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 && git log --no-decorate -n1 --oneline && opam update -u
COPY --chown=1000:1000 h1.opam h1-lwt-unix.opam ./
RUN opam pin add -yn h1.dev './' && \
opam pin add -yn h1-lwt-unix.dev './'
RUN echo '(lang dune 3.0)' > './dune-project'
ENV DEPS="alcotest.1.9.0 angstrom.0.16.1 astring.0.8.5 base.v0.14.3 base-bigarray.base base-bytes.base base-threads.base base-unix.base bigstringaf.0.10.0 cmdliner.1.3.0 cppo.1.8.0 csexp.1.5.2 dune.3.19.1 dune-configurator.3.19.1 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.10.0 httpun-types.0.2.0 lwt.5.9.1 ocaml.4.08.1 ocaml-base-compiler.4.08.1 ocaml-config.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.11.0 seq.base sexplib0.v0.14.0 stdio.v0.14.0 stdlib-shims.0.3.0 topkg.1.0.8 uutf.1.0.4"
ENV CI="true"
ENV OCAMLCI="true"
RUN opam update --depexts && opam install --cli=2.2 --depext-only -y h1.dev h1-lwt-unix.dev $DEPS
RUN opam install $DEPS
RUN opam install --yes dune 'odoc>=1.5.0'
COPY --chown=1000:1000 . /src/
RUN ODOC_WARN_ERROR=false opam exec -- dune build @doc || (echo "dune build @doc failed"; exit 2)


END-OF-DOCKERFILE
docker build .
END-REPRO-BLOCK


2025-07-17 18:23.56: Using cache hint "robur-coop/ocaml-h1-ocaml/opam:debian-12-ocaml-4.08@sha256:4b3e5b2d1be26cada6c08f752ca0b48d3b0ba20fec23648d53395a83f1ae2517-debian-12-4.08_opam-2.3-7648e3813dc4b30e173d990bc43396e5"
2025-07-17 18:23.56: Using OBuilder spec:
((from ocaml/opam:debian-12-ocaml-4.08@sha256:4b3e5b2d1be26cada6c08f752ca0b48d3b0ba20fec23648d53395a83f1ae2517)
(comment debian-12-4.08_opam-2.3)
(user (uid 1000) (gid 1000))
(env CLICOLOR_FORCE 1)
(env OPAMCOLOR always)
(workdir /src)
(run (shell "sudo ln -f /usr/bin/opam-2.2 /usr/bin/opam"))
(run (shell "opam init --reinit -ni"))
(run (shell "uname -rs && opam exec -- ocaml -version && opam --version"))
(workdir /src)
(run (shell "sudo chown opam /src"))
(run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "cd ~/opam-repository && (git cat-file -e 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 || git fetch origin master) && git reset -q --hard 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 && git log --no-decorate -n1 --oneline && opam update -u"))
(copy (src h1.opam h1-lwt-unix.opam) (dst ./))
(run (network host)
(shell  "opam pin add -yn h1.dev './' && \
\nopam pin add -yn h1-lwt-unix.dev './'"))
(run (network host)
(shell "echo '(lang dune 3.0)' > './dune-project'"))
(env DEPS "alcotest.1.9.0 angstrom.0.16.1 astring.0.8.5 base.v0.14.3 base-bigarray.base base-bytes.base base-threads.base base-unix.base bigstringaf.0.10.0 cmdliner.1.3.0 cppo.1.8.0 csexp.1.5.2 dune.3.19.1 dune-configurator.3.19.1 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.10.0 httpun-types.0.2.0 lwt.5.9.1 ocaml.4.08.1 ocaml-base-compiler.4.08.1 ocaml-config.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.11.0 seq.base sexplib0.v0.14.0 stdio.v0.14.0 stdlib-shims.0.3.0 topkg.1.0.8 uutf.1.0.4")
(env CI true)
(env OCAMLCI true)
(run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam update --depexts && opam install --cli=2.2 --depext-only -y h1.dev h1-lwt-unix.dev $DEPS"))
(run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam install $DEPS"))
(run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam install --yes dune 'odoc>=1.5.0'"))
(copy (src .) (dst /src/))
(run (shell "ODOC_WARN_ERROR=false opam exec -- dune build @doc || (echo \"dune build @doc failed\"; exit 2)"))
)


2025-07-17 18:23.56: Waiting for resource in pool OCluster
2025-07-17 18:36.54: Waiting for worker…
2025-07-17 18:39.35: Got resource from pool OCluster
Building on bremusa.ocamllabs.io
All commits already cached
HEAD is now at 8af7249 Merge pull request #6 from robur-coop/prepare-v1.0.0


(from ocaml/opam:debian-12-ocaml-4.08@sha256:4b3e5b2d1be26cada6c08f752ca0b48d3b0ba20fec23648d53395a83f1ae2517)
2025-07-17 18:39.35 ---> using "6cffc1a1a52caf2843bd473effea9756e568737c821ae9874d1cb7264a14fd20" from cache


/: (comment debian-12-4.08_opam-2.3)


/: (user (uid 1000) (gid 1000))


/: (env CLICOLOR_FORCE 1)


/: (env OPAMCOLOR always)


/: (workdir /src)


/src: (run (shell "sudo ln -f /usr/bin/opam-2.2 /usr/bin/opam"))
2025-07-17 18:39.35 ---> using "9c97cea08e7dae03fe3c5eaaa5448a16f132183665f2365e2d5c1013581d731b" from cache


/src: (run (shell "opam init --reinit -ni"))
Configuring from /home/opam/.opamrc and then from built-in defaults.
Checking for available remotes: rsync and local, git.
- you won't be able to use mercurial repositories unless you install the hg command on your system.
- you won't be able to use darcs repositories unless you install the darcs command on your system.


This development version of opam requires an update to the layout of /home/opam/.opam from version 2.0 to version 2.2, which can't be reverted.
You may want to back it up before going further.


Continue? [y/n] y
Format upgrade done.


<><> Updating repositories ><><><><><><><><><><><><><><><><><><><><><><><><><><>
[default] Initialised
2025-07-17 18:39.35 ---> using "ecd882b9a14d0350261ad043d549f05d0fe896aed368dd95773d6c4987550c9c" from cache


/src: (run (shell "uname -rs && opam exec -- ocaml -version && opam --version"))
Linux 6.8.0-63-generic
The OCaml toplevel, version 4.08.1
2.2.1
2025-07-17 18:39.35 ---> using "1397e380ac5e73ca7fd0243274730299a0dc5d31bbdca5d36e20f69b5a5b12d6" from cache


/src: (workdir /src)


/src: (run (shell "sudo chown opam /src"))
2025-07-17 18:39.35 ---> using "5bfa47a7533de07c89111d2182425445f5999bfb3999ad9d0c943a0941e496bf" from cache


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "cd ~/opam-repository && (git cat-file -e 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 || git fetch origin master) && git reset -q --hard 23a00cc88920eca4ff3ff0ddeda3a7f80324e3b7 && git log --no-decorate -n1 --oneline && opam update -u"))
23a00cc889 Merge pull request #28142 from liyishuai/patch-2


<><> Updating package repositories ><><><><><><><><><><><><><><><><><><><><><><>
[default] synchronised from git+file:///home/opam/opam-repository


Everything as up-to-date as possible (run with --verbose to show unavailable upgrades).
However, you may "opam upgrade" these packages explicitly, which will ask permission to downgrade or uninstall the conflicting packages.
Nothing to do.
# Run eval $(opam env) to update the current shell environment
2025-07-17 18:39.35 ---> using "58ed07a52b655dc497d95e87778705f8ed2ac7b6b5c81b254971e523d8749ec6" from cache


/src: (copy (src h1.opam h1-lwt-unix.opam) (dst ./))
2025-07-17 18:39.35 ---> saved as "a74e1687a9b9db22912fcc85e5f37bb28aad8be330b1afda78798c17f2fcc2cb"


/src: (run (network host)
(shell  "opam pin add -yn h1.dev './' && \
\nopam pin add -yn h1-lwt-unix.dev './'"))
[h1.dev] synchronised (file:///src)
h1 is now pinned to file:///src (version dev)
[h1-lwt-unix.dev] synchronised (file:///src)
h1-lwt-unix is now pinned to file:///src (version dev)
2025-07-17 18:39.41 ---> saved as "37e5044bd6581ddabb628ab6c4a3cac56269dd11acd587801a98ff0e33cb99f0"


/src: (run (network host)
(shell "echo '(lang dune 3.0)' > './dune-project'"))
2025-07-17 18:39.41 ---> saved as "01e0c911af46bd86ee1ba60c340b32a0f601457326d851964dba9bd0548d9eba"


/src: (env DEPS "alcotest.1.9.0 angstrom.0.16.1 astring.0.8.5 base.v0.14.3 base-bigarray.base base-bytes.base base-threads.base base-unix.base bigstringaf.0.10.0 cmdliner.1.3.0 cppo.1.8.0 csexp.1.5.2 dune.3.19.1 dune-configurator.3.19.1 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.10.0 httpun-types.0.2.0 lwt.5.9.1 ocaml.4.08.1 ocaml-base-compiler.4.08.1 ocaml-config.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.11.0 seq.base sexplib0.v0.14.0 stdio.v0.14.0 stdlib-shims.0.3.0 topkg.1.0.8 uutf.1.0.4")


/src: (env CI true)


/src: (env OCAMLCI true)


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam update --depexts && opam install --cli=2.2 --depext-only -y h1.dev h1-lwt-unix.dev $DEPS"))
+ /usr/bin/sudo "apt-get" "update"
- Hit:1 http://deb.debian.org/debian bookworm InRelease
- Get:2 http://deb.debian.org/debian bookworm-updates InRelease [55.4 kB]
- Get:3 http://deb.debian.org/debian-security bookworm-security InRelease [48.0 kB]
- Get:4 http://deb.debian.org/debian-security bookworm-security/main amd64 Packages [272 kB]
- Fetched 375 kB in 1s (530 kB/s)
- Reading package lists...
- 


<><> Synchronising pinned packages ><><><><><><><><><><><><><><><><><><><><><><>
[h1.dev] synchronised (file:///src)
[h1-lwt-unix.dev] synchronised (file:///src)


[NOTE] Package ocaml-config is already installed (current version is 1).
[NOTE] Package ocaml-base-compiler is already installed (current version is 4.08.1).
[NOTE] Package ocaml is already installed (current version is 4.08.1).
[NOTE] Package base-unix is already installed (current version is base).
[NOTE] Package base-threads is already installed (current version is base).
[NOTE] Package base-bigarray is already installed (current version is base).
2025-07-17 18:39.59 ---> saved as "daa031f1d21fcbcecc96455520e2674a12d897aeb6f96456b0b8a469bebfa839"


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam install $DEPS"))
[NOTE] Package ocaml-config is already installed (current version is 1).
[NOTE] Package ocaml-base-compiler is already installed (current version is 4.08.1).
[NOTE] Package ocaml is already installed (current version is 4.08.1).
[NOTE] Package base-unix is already installed (current version is base).
[NOTE] Package base-threads is already installed (current version is base).
[NOTE] Package base-bigarray is already installed (current version is base).
The following actions will be performed:
=== install 28 packages
- install alcotest           1.9.0
- install angstrom           0.16.1
- install astring            0.8.5
- install base               v0.14.3
- install base-bytes         base
- install bigstringaf        0.10.0
- install cmdliner           1.3.0
- install cppo               1.8.0
- install csexp              1.5.2
- install dune               3.19.1
- install dune-configurator  3.19.1
- install faraday            0.8.2
- install faraday-lwt        0.8.2
- install faraday-lwt-unix   0.8.2
- install fmt                0.10.0
- install httpun-types       0.2.0
- install lwt                5.9.1
- install ocaml-syntax-shims 1.0.0
- install ocamlbuild         0.16.1
- install ocamlfind          1.9.8
- install ocplib-endian      1.2
- install re                 1.11.0
- install seq                base
- install sexplib0           v0.14.0
- install stdio              v0.14.0
- install stdlib-shims       0.3.0
- install topkg              1.0.8
- install uutf               1.0.4


<><> Processing actions <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
-> retrieved astring.0.8.5  (cached)
-> retrieved angstrom.0.16.1  (cached)
-> retrieved bigstringaf.0.10.0  (cached)
-> retrieved alcotest.1.9.0  (cached)
-> retrieved base.v0.14.3  (cached)
-> retrieved cmdliner.1.3.0  (cached)
-> retrieved cppo.1.8.0  (cached)
-> retrieved csexp.1.5.2  (cached)
-> retrieved faraday.0.8.2, faraday-lwt.0.8.2, faraday-lwt-unix.0.8.2  (cached)
-> retrieved fmt.0.10.0  (cached)
-> retrieved lwt.5.9.1  (cached)
-> retrieved httpun-types.0.2.0  (cached)
-> retrieved ocaml-syntax-shims.1.0.0  (cached)
-> retrieved ocamlfind.1.9.8  (cached)
-> retrieved ocamlbuild.0.16.1  (cached)
-> retrieved ocplib-endian.1.2  (cached)
-> retrieved seq.base  (cached)
-> installed seq.base
-> retrieved re.1.11.0  (cached)
-> retrieved sexplib0.v0.14.0  (cached)
-> retrieved stdio.v0.14.0  (cached)
-> retrieved stdlib-shims.0.3.0  (cached)
-> retrieved uutf.1.0.4  (cached)
-> retrieved topkg.1.0.8  (cached)
-> retrieved dune.3.19.1, dune-configurator.3.19.1  (cached)
-> installed cmdliner.1.3.0
-> installed ocamlbuild.0.16.1
-> installed ocamlfind.1.9.8
-> installed base-bytes.base
-> installed topkg.1.0.8
-> installed uutf.1.0.4
-> installed fmt.0.10.0
-> installed astring.0.8.5
-> installed dune.3.19.1
-> installed csexp.1.5.2
-> installed cppo.1.8.0
-> installed ocaml-syntax-shims.1.0.0
-> installed re.1.11.0
-> installed sexplib0.v0.14.0
-> installed stdlib-shims.0.3.0
-> installed ocplib-endian.1.2
-> installed alcotest.1.9.0
-> installed dune-configurator.3.19.1
-> installed bigstringaf.0.10.0
-> installed faraday.0.8.2
-> installed httpun-types.0.2.0
-> installed angstrom.0.16.1
-> installed lwt.5.9.1
-> installed faraday-lwt.0.8.2
-> installed faraday-lwt-unix.0.8.2
-> installed base.v0.14.3
-> installed stdio.v0.14.0
Done.
# Run eval $(opam env) to update the current shell environment
2025-07-17 18:41.20 ---> saved as "bd6812d8def7c3c44cb52254108ba37cdb49b438e6dee8fcc7ed782e0efa2595"


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam install --yes dune 'odoc>=1.5.0'"))
[NOTE] Package dune is already installed (current version is 3.19.1).
The following actions will be performed:
=== install 9 packages
- install camlp-streams 5.0.1 [required by odoc-parser]
- install crunch        4.0.0 [required by odoc]
- install fpath         0.7.3 [required by odoc]
- install odoc          3.0.0
- install odoc-parser   3.0.0 [required by odoc]
- install ptime         1.2.0 [required by crunch]
- install result        1.5   [required by odoc]
- install tyxml         4.6.0 [required by odoc]
- install yojson        3.0.0 [required by odoc]


<><> Processing actions <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
-> retrieved camlp-streams.5.0.1  (cached)
-> retrieved crunch.4.0.0  (cached)
-> retrieved fpath.0.7.3  (cached)
-> retrieved ptime.1.2.0  (cached)
-> retrieved result.1.5  (cached)
-> retrieved tyxml.4.6.0  (cached)
-> retrieved yojson.3.0.0  (cached)
-> installed result.1.5
-> installed camlp-streams.5.0.1
-> retrieved odoc.3.0.0, odoc-parser.3.0.0  (cached)
-> installed fpath.0.7.3
-> installed ptime.1.2.0
-> installed yojson.3.0.0
-> installed odoc-parser.3.0.0
-> installed crunch.4.0.0
-> installed tyxml.4.6.0
-> installed odoc.3.0.0
Done.
# Run eval $(opam env) to update the current shell environment
2025-07-17 18:42.04 ---> saved as "49410b5a01e654f64c8ca80a69cd3104e76f3a2d17505f39d72feffd2ec92db2"


/src: (copy (src .) (dst /src/))
2025-07-17 18:42.04 ---> saved as "971c81c5ba9b866e26f30dc394d8932ad6b9ad03ae21e58e10231f90891aab6b"


/src: (run (shell "ODOC_WARN_ERROR=false opam exec -- dune build @doc || (echo \"dune build @doc failed\"; exit 2)"))
(cd _build/default/lib/.h1.objs/byte && /home/opam/.opam/4.08/bin/odoc compile -I . -I ../../../_doc/_odoc/pkg/h1 --pkg h1 -o h1.odoc h1.cmti)
File "lib/h1.mli", line 174, characters 19-20:
Warning: End of text is not allowed in '{{:...} ...}' (external link).
File "lib/h1.mli", line 186, characters 36-38:
Warning: '{R' should be followed by space, a tab, or a new line.
File "lib/h1.mli", line 186, characters 36-45:
Warning: '{R ...}' (right alignment) should not be used because it has no effect.
File "lib/h1.mli", line 230, characters 19-20:
Warning: End of text is not allowed in '{{:...} ...}' (external link).
File "lib/h1.mli", line 336, characters 12-33:
Warning: '{next_read_operation}': bad markup.
Suggestion: did you mean '{!next_read_operation}' or '[next_read_operation]'?
File "lib/h1.mli", line 348, characters 33-54:
Warning: '{report_write_result}': bad markup.
Suggestion: did you mean '{!report_write_result}' or '[report_write_result]'?
File "lib/h1.mli", line 349, characters 14-36:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
File "lib/h1.mli", line 354, characters 8-30:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
File "lib/h1.mli", line 361, characters 12-34:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
File "lib/h1.mli", line 432, characters 33-54:
Warning: '{report_write_result}': bad markup.
Suggestion: did you mean '{!report_write_result}' or '[report_write_result]'?
File "lib/h1.mli", line 433, characters 14-36:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
File "lib/h1.mli", line 438, characters 8-30:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
File "lib/h1.mli", line 445, characters 12-34:
Warning: '{next_write_operation}': bad markup.
Suggestion: did you mean '{!next_write_operation}' or '[next_write_operation]'?
2025-07-17 18:42.06 ---> saved as "b7beff2d6abafb360a945f662029a694259eedd97ed133f72c6fae58196c207a"
Job succeeded
2025-07-17 18:42.06: Job succeeded