Skip to content

Add a local documentation server - #4936

Merged
bdbaddog merged 1 commit into
SCons:masterfrom
mwichmann:doc/server
Oct 20, 2026
Merged

bdbaddog merged 1 commit into
SCons:masterfrom
mwichmann:doc/server

Conversation

@mwichmann

Copy link
Copy Markdown
Collaborator

For a long time, it's been a pain to view the generated API docs, as the links don't work right. This change lets you start a tiny http server during development, a similar concept to what has long been available for the scons-website project. Use scons serve-docs and scons stop-docs to start/stop the server. It will tell you the links to go to, assuming they already exist, so the usage model is Build docs -> start server -> view.

This change was AI-assisted.

No changes to SCons or its tests.

Contributor Checklist:

  • I have created a new test or updated the unit tests to cover the new/changed functionality.
  • I have updated CHANGES.txt and RELEASE.txt (and read the README.rst).
  • I have updated the appropriate documentation

Comment thread CHANGES.txt Resolved
For a long time, it's been a pain to view the generated API docs,
as the links don't work right.  This change lets you start a tiny
http server during development, a similar concept to what has long
been available for the scons-website project. Use "scons serve-docs"
and "scons stop-docs" to start/stop the server. It will tell you
the links to go to, assuming they already exist, so the usage model
is Build docs -> start server -> view.

This change was AI-assisted.

Signed-off-by: Mats Wichmann <mats@linux.com>
@bdbaddog
bdbaddog merged commit 9f78242 into SCons:master Oct 20, 2026
10 of 11 checks passed
@mwichmann
mwichmann deleted the doc/server branch October 20, 2026 13:04
@mwichmann mwichmann added this to the NextRelease milestone Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants