aboutsummaryrefslogtreecommitdiff
path: root/AGENTS
diff options
context:
space:
mode:
author_ov4 <ov4@ov4.org>2026-10-13 14:13:00 +0000
committer_ov4 <ov4@ov4.org>2026-10-13 14:13:00 +0000
commit3b4e89d96afe203bb0e8b5b331bb30d1193d0831 (patch)
tree273802efdf5962d82ad0d7691d286ff6b8b9edd2 /AGENTS
parent05cdcb6a1cc3d4de3a0b3d12d4babcd6438b4754 (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.md12
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.