The-OpenROAD-Project / The-OpenROAD-Project/OpenROAD

Man-page generation is highly non-hermetic

Open
#10,692 1 comment 0 reactions 1 assignee View on GitHub

@vvbandeira is already working on this.

Since Jul 30, 2026.

Dominant language
Verilog
Stars
3.1k
Forks
1k
Avg merge
2d 23h
Merged PRs (30d)
136

Description

The bazel-target //docs:man_pages is highly non-hermetic

  • it invokes make, which is not a standard binary
  • it assumes pandoc, nroff`` and sphinx-build` to be available, also non-standard binaries.
  • Why is it using make in the first place, if there is bazel ?

So this will not work in any hermetic environment that disallows bazel to use the $PATH or any remote execution environment at all.

This should be fixed to

Initially I recommend to mark it tags = ["local", "manual"] to not disrupt the buildability.

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.