Zulip Chat Archive

Stream: general

Topic: doc-gen4 stalling on empty zero-dependency project


runofff (Dec 31 2025 at 22:00):

Hello, I am trying to locally build documentation for my standalone lean project.
I am running into an issue where DOCGEN_SRC="vscode" lake build DocTest2:docs completely seems to stall at the very last step. I waited more than ten minutes.

The steps that I took were:
1) use the VS Code command palette to "Create Standalone Lean project"
2) create a docbuild/ folder in the new project
3) add the lakefile.toml as specified in the doc-gen4 readme https://github.com/leanprover/doc-gen4 and run lake update doc-gen4 in docbuild/
4) ran DOCGEN_SRC="vscode" lake build DocTest2:docs

This ran for 10 minutes before I killed it. The project has no dependencies and no theorems yet it seems to stall.
Can anyone help? Thanks

anand@jain ~/s/l/D/docbuild (main)> DOCGEN_SRC="vscode" lake build DocTest2:docs
 [132/143] Replayed «doc-gen4»/bibPrepass
info: stdout:
INFO: reference page disabled
 [143/144] Running DocTest2/DocTest2:docs

Henrik Böving (Dec 31 2025 at 22:02):

The most likely thing it is doing is building the documentation for Lean, Std and Init which it always does in the background. On a weak machine this can definitely take a little while the first time you do it.

runofff (Dec 31 2025 at 22:03):

but does that happen in step 143/144? I thought I saw that stuff building in earlier steps

runofff (Dec 31 2025 at 22:03):

I can keep it running though, but is there a way to then skip building these since it's taking so long?

Henrik Böving (Dec 31 2025 at 22:06):

You can also check htop or whatever other process manager is your favorite to see what it is up to of course.

runofff (Dec 31 2025 at 22:08):

That's helpful, it is still building Std and Lean. I will go make some food and see if it finishes over lunch


Last updated: Feb 28 2026 at 14:05 UTC