diff options
| author | _ov4 <ov4@ov4.org> | 2026-10-13 05:08:14 +0000 |
|---|---|---|
| committer | _ov4 <ov4@ov4.org> | 2026-10-13 05:08:14 +0000 |
| commit | 84cbd5fef8c67586f08cb7396f9d60ef4a07622f (patch) | |
| tree | 229029f00ebb977bcc93889fb5f7189f6ba8de1f /README.md | |
| parent | 26b378e7e90f950e8d64a294e56fbe9e06d19214 (diff) | |
build: render standalone HTML documentation on Windows
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 13 |
1 files changed, 11 insertions, 2 deletions
@@ -134,7 +134,7 @@ and kept even if execution fails. ## Manual -The command-line quick reference is in `doc/cpsc.md`. Generating the man page requires Pandoc; ordinary builds do not. +The command-line quick reference is in `doc/cpsc.md`. Generating the manual requires Pandoc; ordinary builds do not. From the project root on Linux: @@ -146,7 +146,16 @@ man ./build/doc/cpsc.1 ``` You can also run `make doc` inside the configured `build/` directory. -The output is `build/doc/cpsc.1` and is regenerated when the Markdown source changes. +The output is `build/doc/cpsc.1` on Unix and `build/doc/cpsc.html` on Windows, +and is regenerated when the Markdown source changes. On Windows, install Pandoc, +then generate and open the standalone HTML manual from PowerShell: + +```powershell +cmake --build build --target doc +Start-Process .\build\doc\cpsc.html +``` + +The HTML contains its own styles and can be read offline in a browser. ## Install and release |