ocaml / ocaml/dune

@doc "Couldn't find the following modules: Stdlib"

Open
#5,229 8 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

odoc
Dominant language
OCaml
Stars
1.9k
Forks
500
Avg merge
15h 21m
Merged PRs (30d)
277

Description

Expected Behavior

Building without errors. 😉

Actual Behavior

Using dune build @all @doc with or without --watch, I almost consistently get errors like this:

File "../../lib_lwt/.gxd_lwt.objs/byte/gxd_lwt.odoc":
Couldn't find the following modules:
  Lwt Lwt_result Stdlib
File "../../lib/.gxd.objs/byte/gxd.odoc":
Couldn't find the following modules:
  Stdlib

These libraries are installed, as the build itself works fine. Even the generated documentation seems okay.

Reproduction

Clearly there's something about my setup that is unique enough to cause this rare issue, but I'm at a loss as to how to narrow things down. I'm hoping you might suggest things to verify or attempt so I can get a bit closer to what you'd need to reproduce this.

Specifications

  • Version of dune (output of dune --version): 2.9.1
  • Version of ocaml (output of ocamlc --version): 4.13.1 (built with Musl GCC 10.2.1)
  • Operating system (distribution and version): Debian GNU/Linux 10 (buster), kernel 4.16.6 on x86_64

Additional information

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No source file or test is named. Start by reproducing with dune build @all @doc and compare the --verbose output with the linked gist, using the reported Dune 2.9.1 and OCaml 4.13.1 environment. Done means identifying why documentation generation cannot resolve installed modules and confirming that the command completes without these errors.

Written by the indexing model from the issue text.

Assessment

Tech stack
ocaml
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.