Introduction and Overview
Part 4 is the direct command and tool reference for the build environment. The earlier parts of the manual focus on workflow, installation, and guided use. This part is organised by tool family so that you can either read one area in order or jump straight to the group that matches the task in hand.
Each following chapter groups commands that are usually learned together or used in the same stage of work. The chapter introductions explain the role of that tool family, and the individual command entries give the supported command-line interface, normal behaviour, examples, and related commands.
The Part 4 chapters are arranged as follows:
- Build orchestration and makefiles covers top-level build entry points, AMU selection, makefile-generation helpers, and the shared build framework used by most projects.
- Compilers, linkers, and 64-bit binary tools covers the main compiler, linker, library, and binary-processing wrappers for direct toolchain use.
- Assembler tools covers ObjAsm and GNU assembler workflows, conversion tools, and AOF-oriented helpers.
- Module and interface generation tools covers CMHG or CMunge processing, generated veneers and headers, parser generators, RPC generators, and related derived-resource tools.
- Project and CI covers project skeleton creation, version-file management, port scaffolding, build-run packaging, and CI-facing helpers.
- Archive and packaging tools covers ZIP, Spark, Squash, TBAFS, ALF, and StrongHelp packaging or extraction commands.
- Inspection and conversion tools covers binary inspection, resource decoding, tokenised-BASIC conversion, drawing and sprite conversion, and text-transformation helpers.
- Filetype and filesystem tools covers filetype-setting, copy and deletion wrappers, text output helpers, and resource-version inspection.
- Environment and help tools covers environment launchers, help lookup, path transformation, pagers, syntax colouring, and PRM lookup tools.
- Host bridge tools covers the commands that pass file opening, editing, copying, or repository browsing back to the host system.
- AI agent tools covers the `ai` management command and the wrapper commands for the supported agents.
- Quality and maintenance covers analysis, formatting, template repair, PRM conversion, and source-maintenance helpers.
- Pascal translation tools covers the Pascal-to-C translator and the wrapper that continues from translation into compilation and linking.
- Pyromaniac and runtime tools covers one-shot and persistent runtime commands, BASIC or Supervisor startup, and low-level Pyromaniac control.
Tools
Build orchestration and makefiles
Use this chapter when you need the main build entry points, shared makefile behaviour, or helper commands that control how a project is built.
| Command | Reference |
|---|---|
| riscos-amu | riscos-amu |
| riscos64-amu | riscos64-amu |
| riscos-makegen | riscos-makegen |
| riscos64-make | riscos64-make |
| make | make |
| riscos-ifthere | riscos-ifthere |
Compilers, linkers, and 64-bit binary tools
Use this chapter when you need to drive the compilers or linkers directly, or when you need the binary-inspection and post-link helpers used by the 64-bit toolchain.
| Command | Reference |
|---|---|
| riscos-cc | riscos-cc |
| riscos-c++ | riscos-c++ |
| riscos-link | riscos-link |
| riscos-libfile | riscos-libfile |
| riscos64-cc | riscos64-cc |
| riscos64-c++ | riscos64-c++ |
| riscos64-gcc | riscos64-gcc |
| riscos64-link | riscos64-link |
| riscos64-fortran | riscos64-fortran |
| riscos64-gfortran | riscos64-gfortran |
| riscos64-mkreloc | riscos64-mkreloc |
| riscos64-addsignatures | riscos64-addsignatures |
| riscos64-libfile | riscos64-libfile |
| riscos64-objdump | riscos64-objdump |
| riscos64-objcopy | riscos64-objcopy |
Assembler tools
Use this chapter for ObjAsm, GNU assembler, ObjAsm-to-GAS conversion, and AOF helper commands that sit close to assembler-driven build work.
| Command | Reference |
|---|---|
| riscos-objasm | riscos-objasm |
| objasm2gas | objasm2gas |
| riscos-objasm2gas | riscos-objasm2gas |
| riscos64-objasm2gas | riscos64-objasm2gas |
| riscos64-as | riscos64-as |
| riscos64-objasm | riscos64-objasm |
| riscos-binaof | riscos-binaof |
| riscos-aoftoc | riscos-aoftoc |
Module and interface generation tools
Use this chapter for generated veneers, generated headers, CMHG or CMunge processing, parser generators, RPC source generation, and related derived resource helpers.
| Command | Reference |
|---|---|
| riscos-cmunge | riscos-cmunge |
| riscos-defmod | riscos-defmod |
| riscos-tboxmethods | riscos-tboxmethods |
| riscos-mergemoduleswis | riscos-mergemoduleswis |
| riscos-resgen | riscos-resgen |
| riscos-modgen | riscos-modgen |
| riscos-modsqz | riscos-modsqz |
| riscos-buildrom | riscos-buildrom |
| riscos-bison | riscos-bison |
| riscos-flex | riscos-flex |
| riscos-rpcgen | riscos-rpcgen |
Project and CI
Use this chapter for project creation, version-file maintenance, port scaffolding, build-run packaging, and CI-oriented wrappers.
| Command | Reference |
|---|---|
| riscos-project | riscos-project |
| riscos-allocate | riscos-allocate |
| riscos-vmanage | riscos-vmanage |
| riscos-vtranslate | riscos-vtranslate |
| riscos-cport | riscos-cport |
| riscos-build-run | riscos-build-run |
| riscos-build-online | riscos-build-online |
Archive and packaging tools
Use this chapter when you need to create, unpack, inspect, or convert archive and packaged-manual formats used by the build environment.
| Command | Reference |
|---|---|
| riscos-zip | riscos-zip |
| riscos-unzip | riscos-unzip |
| riscos-nspark | riscos-nspark |
| riscos-sqsh | riscos-sqsh |
| riscos-tbafs | riscos-tbafs |
| riscos-makealf | riscos-makealf |
| riscos-shextract | riscos-shextract |
| riscos-strongcopy | riscos-strongcopy |
Inspection and conversion tools
Use this chapter for binary inspection, format decoding, tokenised-BASIC conversion, drawing or sprite conversion, and stream-oriented transformation tools.
| Command | Reference |
|---|---|
| riscos-dumpi | riscos-dumpi |
| riscos-dump | riscos-dump |
| riscos-basictokenise | riscos-basictokenise |
| riscos-basicdetokenise | riscos-basicdetokenise |
| riscos-dumpsprites | riscos-dumpsprites |
| riscos-intergif | riscos-intergif |
| riscos-ccres | riscos-ccres |
| riscos-templateheader | riscos-templateheader |
| riscos-mkdrawf | riscos-mkdrawf |
| riscos-decdrawf | riscos-decdrawf |
| riscos-decaof | riscos-decaof |
| riscos-dem | riscos-dem |
| riscos-toansi | riscos-toansi |
| riscos-sed | riscos-sed |
Filetype and filesystem tools
Use this chapter for filetype-setting, host-side copy or deletion wrappers, plain-text output helpers, and resource-version inspection.
| Command | Reference |
|---|---|
| riscos-settype | riscos-settype |
| riscos-copy | riscos-copy |
| riscos-cdir | riscos-cdir |
| riscos-wipe | riscos-wipe |
| riscos-destroy | riscos-destroy |
| riscos-kitten | riscos-kitten |
| riscos-resversions | riscos-resversions |
Environment and help tools
Use this chapter for environment launchers, help lookup, path-transform helpers, PRM lookup, pagers, syntax colouring, and editor-facing SWI support.
| Command | Reference |
|---|---|
| robuild | robuild |
| man | man |
| riscos-transformcli | riscos-transformcli |
| riscos64-transformcli | riscos64-transformcli |
| riscos-help | riscos-help |
| riscos-prm | riscos-prm |
| riscos-less | riscos-less |
| nano-colour | nano-colour |
| riscos-swi-lsp | riscos-swi-lsp |
Host bridge tools
Use this chapter for the commands that open files, edit files, launch host-side commands, copy to the host clipboard, or browse repository URLs through the host system.
| Command | Reference |
|---|---|
| host-open | host-open |
| host-edit | host-edit |
| host-run | host-run |
| host-copy | host-copy |
| git-open | git-open |
AI agent tools
Use this chapter for the `ai` management command and the agent-specific wrapper commands supplied by the environment.
| Command | Reference |
|---|---|
| ai | ai |
| agy | agy |
| codex | codex |
| claude | claude |
| copilot | copilot |
| gemini | gemini |
| qwen | qwen |
| opencode | opencode |
Quality and maintenance
Use this chapter for static analysis, formatting, template repair, PRM conversion, and general source-maintenance helpers.
| Command | Reference |
|---|---|
| riscos-cppcheck | riscos-cppcheck |
| riscos64-cppcheck | riscos64-cppcheck |
| riscos-indent | riscos-indent |
| riscos-libsearch | riscos-libsearch |
| riscos-tooltester | riscos-tooltester |
| riscos-fixuptemplate | riscos-fixuptemplate |
| riscos-hdrtoh | riscos-hdrtoh |
| riscos-prminxml | riscos-prminxml |
| git absorb | git absorb |
Pascal translation tools
Use this chapter for the Pascal-to-C translator and the wrapper that continues from translation into compilation and linking.
| Command | Reference |
|---|---|
| riscos-p2c | riscos-p2c |
| riscos-p2cc | riscos-p2cc |
| riscos64-p2cc | riscos64-p2cc |
Pyromaniac and runtime tools
Use this chapter for one-shot runtime commands, persistent Pyromaniac sessions, interactive BASIC or Supervisor startup, and runtime inspection helpers.
| Command | Reference |
|---|---|
| riscos-run | riscos-run |
| riscos-basic | riscos-basic |
| riscos-gos | riscos-gos |
| pyro | pyro |
| pyro-server | pyro-server |
| pyro-client | pyro-client |
| riscos-modservices | riscos-modservices |