From 84cbd5fef8c67586f08cb7396f9d60ef4a07622f Mon Sep 17 00:00:00 2001 From: _ov4 Date: Tue, 13 Oct 2026 05:08:14 +0000 Subject: build: render standalone HTML documentation on Windows Co-Authored-By: Claude Fable 5.1 --- AGENTS/ARCH.md | 3 +++ 1 file changed, 3 insertions(+) (limited to 'AGENTS') diff --git a/AGENTS/ARCH.md b/AGENTS/ARCH.md index 2707ba3..f235295 100644 --- a/AGENTS/ARCH.md +++ b/AGENTS/ARCH.md @@ -81,6 +81,9 @@ to the user PATH without copying the combined process PATH, and creates a per-user Start Menu help shortcut. `-SourceDir` selects the artifact directory; `DESTDIR` staging is unsupported on Windows. The script is compatible with Windows PowerShell 5.1; its Windows actions have only been reviewed statically. +The `doc` target uses CMake's `WIN32` target-platform detection: Windows generates +standalone HTML with inline styles at `build/doc/cpsc.html`; other platforms +generate `build/doc/cpsc.1`. Both render the same `doc/cpsc.md` using Pandoc. Build pin: developed and tested against **LLVM 18**. (The historical LLVM 19 breakage — `ArithmeticHandler.cc` touching `llvm::Module` through a transitive include — is gone -- cgit v1.3.1-4-g156e