diff options
| author | _ov4 <ov4@ov4.org> | 2026-10-13 14:13:00 +0000 |
|---|---|---|
| committer | _ov4 <ov4@ov4.org> | 2026-10-13 14:13:00 +0000 |
| commit | 3b4e89d96afe203bb0e8b5b331bb30d1193d0831 (patch) | |
| tree | 273802efdf5962d82ad0d7691d286ff6b8b9edd2 /AGENTS | |
| parent | 05cdcb6a1cc3d4de3a0b3d12d4babcd6438b4754 (diff) | |
Document supported pseudocode with section 7 language manuals
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Diffstat (limited to 'AGENTS')
| -rw-r--r-- | AGENTS/ARCH.md | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/AGENTS/ARCH.md b/AGENTS/ARCH.md index c837ea1..25faaa5 100644 --- a/AGENTS/ARCH.md +++ b/AGENTS/ARCH.md @@ -116,7 +116,7 @@ per-user Start Menu help shortcut. `-SourceDir` selects the artifact directory; 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. +generate `build/doc/cpsc.1`. Both render the same `doc/cpsc.1.md` using Pandoc. Windows `mingw32-make -C build install` builds the HTML manual and invokes `install.ps1` through Windows PowerShell with the build directory and `CMAKE_INSTALL_PREFIX`. The default Windows prefix is the per-user Programs @@ -167,3 +167,13 @@ they are pure data with virtual destructors only — no codegen/visitor methods. | `AGENTS/EXTENDING.md` | Adding a statement, builtin, operator, type, runtime check, or libc dependency — exact recipes | | `AGENTS/SUBSYSTEMS.md` | Working on arrays, functions/procedures, or runtime checks | | `AGENTS/PITFALLS.md` | Verified sharp edges (they *will* bite) and the list of unimplemented 9618 features | + +## Language manuals + +`doc/cpsc.1.md` documents the command-line interface. Short language manuals live +in `doc/language/` as `cpsc-keyword-NAME.7.md`, `cpsc-function-NAME.7.md`, and +`cpsc-language-overview.7.md`; filenames are lowercase and preserve underscores. +Document auxiliary/closing keywords with the main construct, not in separate +pages. Keep examples small and describe actual compiler support, noting relevant +differences from the 2026 Cambridge guide in `reference/`. All project text is +English. |
