Skip to content

Fix $(O) typo in docs Makefile livehtml target - #1694

Open
v1teka wants to merge 1 commit into
simonw:mainfrom
v1teka:fix-docs-makefile
Open

v1teka wants to merge 1 commit into
simonw:mainfrom
v1teka:fix-docs-makefile

Conversation

@v1teka

@v1teka v1teka commented Sep 20, 2026

Copy link
Copy Markdown

The livehtml target in docs/Makefile passes $(0) where every other target passes $(O). Make expands $(0) to an empty string, so options given the documented Sphinx way are silently dropped:

$ make -n livehtml O="--port 9000"
sphinx-autobuild -b html "." "_build"

With the fix:

$ make -n livehtml O="--port 9000"
sphinx-autobuild -b html "." "_build" --port 9000

just docs passes the port through SPHINXOPTS, so it behaves the same before and after.

This also updates SPHINXPROJ, which still held the sqlite-utils value this Makefile was originally copied from. It is unused by the current Sphinx Makefile, but the stale name is confusing next to project = "LLM" in conf.py.

The livehtml target passed $(0), which Make expands to an empty string,
so options given as `make livehtml O="--port 9000"` were silently
dropped. The catch-all target above it uses $(O).

Also updates SPHINXPROJ, which still held the sqlite-utils value this
Makefile was originally copied from.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants