(lint-doc)

2025-10-01 14:58.15: New job: test robur-coop/ocaml-h1 https://github.com/robur-coop/ocaml-h1.git#refs/heads/master (389e5b99380fe090c6ff2622dc0d6819582334f0) (linux-x86_64:(lint-doc))
Base: ocaml/opam:alpine-3.22-ocaml-4.14@sha256:e1cb67ff0571dfb179fc3cd9b7f5639658f87d2d7fc9f8a0ba7da3644a9fec12
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 389e5b99
cat > Dockerfile <<'END-OF-DOCKERFILE'
FROM ocaml/opam:alpine-3.22-ocaml-4.14@sha256:e1cb67ff0571dfb179fc3cd9b7f5639658f87d2d7fc9f8a0ba7da3644a9fec12
# alpine-3.22-4.14_opam-2.4
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 241aae26db44294142794da0ce695e8beac418df || git fetch origin master) && git reset -q --hard 241aae26db44294142794da0ce695e8beac418df && 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.1 angstrom.0.16.1 astring.0.8.5 base.v0.16.4 base-bigarray.base base-bytes.base base-threads.base base-unix.base base64.3.5.2 bigstringaf.0.10.0 bstr.0.0.2 cmdliner.2.0.0 cppo.1.8.0 csexp.1.5.2 dune.3.20.2 dune-configurator.3.20.2 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.11.0 httpun-types.0.2.0 lwt.5.9.2 ocaml.4.14.2 ocaml-base-compiler.4.14.2 ocaml-config.2 ocaml-options-vanilla.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.14.0 sexplib0.v0.16.0 stdio.v0.16.0 stdlib-shims.0.3.0 topkg.1.1.0 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-10-01 14:58.15: Using cache hint "robur-coop/ocaml-h1-ocaml/opam:alpine-3.22-ocaml-4.14@sha256:e1cb67ff0571dfb179fc3cd9b7f5639658f87d2d7fc9f8a0ba7da3644a9fec12-alpine-3.22-4.14_opam-2.4-9894e88a9e600288ee450cf18fda67b8"
2025-10-01 14:58.15: Using OBuilder spec:
((from ocaml/opam:alpine-3.22-ocaml-4.14@sha256:e1cb67ff0571dfb179fc3cd9b7f5639658f87d2d7fc9f8a0ba7da3644a9fec12)
(comment alpine-3.22-4.14_opam-2.4)
(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 241aae26db44294142794da0ce695e8beac418df || git fetch origin master) && git reset -q --hard 241aae26db44294142794da0ce695e8beac418df && 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.1 angstrom.0.16.1 astring.0.8.5 base.v0.16.4 base-bigarray.base base-bytes.base base-threads.base base-unix.base base64.3.5.2 bigstringaf.0.10.0 bstr.0.0.2 cmdliner.2.0.0 cppo.1.8.0 csexp.1.5.2 dune.3.20.2 dune-configurator.3.20.2 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.11.0 httpun-types.0.2.0 lwt.5.9.2 ocaml.4.14.2 ocaml-base-compiler.4.14.2 ocaml-config.2 ocaml-options-vanilla.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.14.0 sexplib0.v0.16.0 stdio.v0.16.0 stdlib-shims.0.3.0 topkg.1.1.0 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-10-01 14:58.15: Waiting for resource in pool OCluster
2025-10-01 15:26.12: Waiting for worker…
2025-10-01 15:28.46: Got resource from pool OCluster
Building on toxis.caelum.ci.dev
All commits already cached
HEAD is now at 389e5b9 Merge pull request #17 from robur-coop/prepare-v1.1.0


(from ocaml/opam:alpine-3.22-ocaml-4.14@sha256:e1cb67ff0571dfb179fc3cd9b7f5639658f87d2d7fc9f8a0ba7da3644a9fec12)
2025-10-01 15:28.46 ---> using "b004d39c9addeb865f11c6029618ea8df221f8b3190584e8b865e82aabd3dd51" from cache


/: (comment alpine-3.22-4.14_opam-2.4)


/: (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-10-01 15:28.47 ---> saved as "b39e8780386fe7e5f68282ee9cddf8898c4c8ac299646b9431eed91362bf4229"


/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.
[NOTE] The 'jobs' option was reset, its value was 255 and its new value will vary according to the current number of cores on your machine. You can restore the fixed value using:
opam option jobs=255 --global


<><> Updating repositories ><><><><><><><><><><><><><><><><><><><><><><><><><><>
[default] Initialised
2025-10-01 15:29.35 ---> saved as "35a5e6d9e320f8159f4b89e0710121627ac7cf7826bba07d97790fb2a47f3369"


/src: (run (shell "uname -rs && opam exec -- ocaml -version && opam --version"))
Linux 5.15.0-134-generic
The OCaml toplevel, version 4.14.2
2.2.1
2025-10-01 15:29.35 ---> saved as "8e37b1e231e4ef72a36d3915bcd11fdf1415d7637b2f1c8bf1a95445b3019eac"


/src: (workdir /src)


/src: (run (shell "sudo chown opam /src"))
2025-10-01 15:29.35 ---> saved as "6300ff1335fd0ccb017f380626dc15270d22afa5d4896a868f7904dc46f3ab74"


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "cd ~/opam-repository && (git cat-file -e 241aae26db44294142794da0ce695e8beac418df || git fetch origin master) && git reset -q --hard 241aae26db44294142794da0ce695e8beac418df && git log --no-decorate -n1 --oneline && opam update -u"))
From https://github.com/ocaml/opam-repository
* branch                  master     -> FETCH_HEAD
bcac5d1731..241aae26db  master     -> origin/master
241aae26db Merge pull request #28629 from dinosaure/release-alcotest-1.9.1


<><> 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-10-01 15:30.19 ---> saved as "9dea60a43f2324114cf8b42d8e02585c5652c36e575045b1db4c2f404c0330c9"


/src: (copy (src h1.opam h1-lwt-unix.opam) (dst ./))
2025-10-01 15:30.20 ---> saved as "9aee0579389d4b2d7a759e610b6917557fb0b34dd78f8d7094df4c882d9b6c13"


/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-10-01 15:30.29 ---> saved as "731d5eb79d571d71e7296deb3369316a0ff601b360ee6f9bad444370733c8e40"


/src: (run (network host)
(shell "echo '(lang dune 3.0)' > './dune-project'"))
2025-10-01 15:30.29 ---> saved as "8b9d0db0061705a8faa0735dbe58b960945d26107bd70ff357b6e435acc9ff04"


/src: (env DEPS "alcotest.1.9.1 angstrom.0.16.1 astring.0.8.5 base.v0.16.4 base-bigarray.base base-bytes.base base-threads.base base-unix.base base64.3.5.2 bigstringaf.0.10.0 bstr.0.0.2 cmdliner.2.0.0 cppo.1.8.0 csexp.1.5.2 dune.3.20.2 dune-configurator.3.20.2 faraday.0.8.2 faraday-lwt.0.8.2 faraday-lwt-unix.0.8.2 fmt.0.11.0 httpun-types.0.2.0 lwt.5.9.2 ocaml.4.14.2 ocaml-base-compiler.4.14.2 ocaml-config.2 ocaml-options-vanilla.1 ocaml-syntax-shims.1.0.0 ocamlbuild.0.16.1 ocamlfind.1.9.8 ocplib-endian.1.2 re.1.14.0 sexplib0.v0.16.0 stdio.v0.16.0 stdlib-shims.0.3.0 topkg.1.1.0 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 "apk" "update"
- fetch https://dl-cdn.alpinelinux.org/alpine/v3.22/main/x86_64/APKINDEX.tar.gz
- fetch https://dl-cdn.alpinelinux.org/alpine/v3.22/community/x86_64/APKINDEX.tar.gz
- fetch https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz
- fetch https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
- fetch https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz
- v3.22.1-508-g8f330e62bd4 [https://dl-cdn.alpinelinux.org/alpine/v3.22/main]
- v3.22.1-509-gdd439baf159 [https://dl-cdn.alpinelinux.org/alpine/v3.22/community]
- v3.23.0_alpha20250612-7338-g76fd86ee64a [https://dl-cdn.alpinelinux.org/alpine/edge/main]
- v3.23.0_alpha20250612-7342-g0866d332363 [https://dl-cdn.alpinelinux.org/alpine/edge/community]
- v3.23.0_alpha20250612-7337-gd50d094c4c8 [https://dl-cdn.alpinelinux.org/alpine/edge/testing]
- OK: 59298 distinct packages available


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


[NOTE] Package ocaml-options-vanilla is already installed (current version is 1).
[NOTE] Package ocaml-config is already installed (current version is 2).
[NOTE] Package ocaml-base-compiler is already installed (current version is 4.14.2).
[NOTE] Package ocaml is already installed (current version is 4.14.2).
[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-10-01 15:30.53 ---> saved as "e205c36d62a1762738371b76e5c405ce3aa07630d238fb67b614083cb8598f2f"


/src: (run (cache (opam-archives (target /home/opam/.opam/download-cache)))
(network host)
(shell "opam install $DEPS"))
[NOTE] Package ocaml-options-vanilla is already installed (current version is 1).
[NOTE] Package ocaml-config is already installed (current version is 2).
[NOTE] Package ocaml-base-compiler is already installed (current version is 4.14.2).
[NOTE] Package ocaml is already installed (current version is 4.14.2).
[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 29 packages
- install alcotest           1.9.1
- install angstrom           0.16.1
- install astring            0.8.5
- install base               v0.16.4
- install base-bytes         base
- install base64             3.5.2
- install bigstringaf        0.10.0
- install bstr               0.0.2
- install cmdliner           2.0.0
- install cppo               1.8.0
- install csexp              1.5.2
- install dune               3.20.2
- install dune-configurator  3.20.2
- install faraday            0.8.2
- install faraday-lwt        0.8.2
- install faraday-lwt-unix   0.8.2
- install fmt                0.11.0
- install httpun-types       0.2.0
- install lwt                5.9.2
- 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.14.0
- install sexplib0           v0.16.0
- install stdio              v0.16.0
- install stdlib-shims       0.3.0
- install topkg              1.1.0
- install uutf               1.0.4


<><> Processing actions <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
-> retrieved astring.0.8.5  (cached)
-> retrieved angstrom.0.16.1  (cached)
-> retrieved base64.3.5.2  (cached)
-> retrieved base.v0.16.4  (cached)
-> retrieved alcotest.1.9.1  (cached)
-> retrieved bigstringaf.0.10.0  (cached)
-> retrieved cppo.1.8.0  (cached)
-> retrieved cmdliner.2.0.0  (cached)
-> retrieved bstr.0.0.2  (https://opam.ocaml.org/cache)
-> 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.11.0  (cached)
-> retrieved lwt.5.9.2  (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 re.1.14.0  (cached)
-> retrieved sexplib0.v0.16.0  (cached)
-> retrieved stdio.v0.16.0  (cached)
-> retrieved stdlib-shims.0.3.0  (cached)
-> retrieved uutf.1.0.4  (cached)
-> retrieved topkg.1.1.0  (cached)
-> retrieved dune.3.20.2, dune-configurator.3.20.2  (cached)
-> installed cmdliner.2.0.0
-> installed ocamlbuild.0.16.1
-> installed ocamlfind.1.9.8
-> installed base-bytes.base
-> installed topkg.1.1.0
-> installed uutf.1.0.4
-> installed fmt.0.11.0
-> installed astring.0.8.5
-> installed dune.3.20.2
-> installed csexp.1.5.2
-> installed base64.3.5.2
-> installed bstr.0.0.2
-> installed ocaml-syntax-shims.1.0.0
-> installed sexplib0.v0.16.0
-> installed cppo.1.8.0
-> installed stdlib-shims.0.3.0
-> installed ocplib-endian.1.2
-> installed re.1.14.0
-> installed dune-configurator.3.20.2
-> installed alcotest.1.9.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.2
-> installed faraday-lwt.0.8.2
-> installed faraday-lwt-unix.0.8.2
-> installed base.v0.16.4
-> installed stdio.v0.16.0
Done.
# Run eval $(opam env) to update the current shell environment
2025-10-01 15:33.21 ---> saved as "684bfa5d67133a52b98af1e60a7ebf0eb6be981dd218229b3a62286461e3122b"


/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.20.2).
The following actions will be performed:
=== install 8 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.1.0
- install odoc-parser   3.1.0 [required by odoc]
- install ptime         1.2.0 [required by crunch]
- install seq           base  [required by tyxml]
- install tyxml         4.6.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 seq.base  (cached)
-> installed seq.base
-> retrieved ptime.1.2.0  (cached)
-> retrieved tyxml.4.6.0  (cached)
-> installed camlp-streams.5.0.1
-> retrieved odoc.3.1.0, odoc-parser.3.1.0  (cached)
-> installed fpath.0.7.3
-> installed ptime.1.2.0
-> installed crunch.4.0.0
-> installed odoc-parser.3.1.0
-> installed tyxml.4.6.0
-> installed odoc.3.1.0
Done.
# Run eval $(opam env) to update the current shell environment
2025-10-01 15:34.15 ---> saved as "5640a99da6dff5472109e4cc9e597804037b2e7a2e9cf57d9e35f368ab4aed20"


/src: (copy (src .) (dst /src/))
2025-10-01 15:34.15 ---> saved as "34ccd13def73b485e79cd7f186d70e434c0cafa59e2c8c7f47bd0be6b381432b"


/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.14/bin/odoc compile -I . -I ../../../_doc/_odoc/pkg/h1 --pkg h1 -o h1.odoc h1.cmti)
File "lib/h1.mli", line 175, characters 19-20:
Warning: End of text is not allowed in '{{:...} ...}' (external link).
File "lib/h1.mli", line 187, characters 36-38:
Warning: '{R' should be followed by space, a tab, or a new line.
File "lib/h1.mli", line 187, characters 36-45:
Warning: '{R ...}' (right alignment) should not be used because it has no effect.
File "lib/h1.mli", line 231, 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-10-01 15:34.16 ---> saved as "aca8118d2e3435e95591730d06afba68fd223f60061ca5ba3ebed110200cc1eb"
Job succeeded
2025-10-01 15:34.17: Job succeeded