Introduction and Overview
This chapter cites the public source material used while building this manual: official Docker and RISC OS documentation, and the upstream project repositories that publish the tools and libraries this guide describes. It is intended as a working bibliography for the guide itself, rather than as a general list of all RISC OS references that might ever be useful.
Some chapters were also written or checked directly against material that exists only inside the build environment or this repository, such as installed help topics, help command files, extracted documentation trees, and upstream source code with no separately published form. That material is not suitable as a reader-facing citation, so it is not listed here; where it informed a chapter and no public equivalent could be found, it is recorded in an XML comment near the relevant entry below, for maintainers who need to re-check or update it.
Installation and host setup
The prerequisites and installation chapters drew on the following Docker documentation:
- Docker Engine installation overview
- Linux post-installation steps for Docker Engine
- Install Docker Engine on Ubuntu
- Install Docker Engine on Debian
- Install Docker Engine on Fedora
- Install Docker Engine on RHEL
- Install Docker Desktop on Mac
- Mac permission requirements for Docker Desktop
- Install Docker Desktop on Windows
- Windows permission requirements for Docker Desktop
The guide's statements about the build environment being tied to linux/amd64 images were checked against this repository's own Dockerfiles, which are internal build inputs rather than separately published material.
PRM-in-XML, StrongHelp, and document authoring
The PRM-in-XML and StrongHelp chapters and appendices drew on the installed documentation sets and help resources:
- riscos-prminxml-tool repository, the public source for the installed HowTo, PRMinXML reference, BNF, and DTD material;
Build system, versioning, and project-management material
The makefile-system, version-management, and project-structure chapters cite the following public references:
The CMunge and CMHG material also used the extracted local PRM-in-XML source, now maintained publicly as riscos-cmunge repository:
Archive, resource, and file-format chapters
The archive and resource-format appendices cite a mixture of upstream web references and the public repositories that now publish material originally consulted locally:
- riscos-dumpsprites repository
- mkdrawf repository
- mkdrawf manual
- RISC OS PRM file-format reference
- TBAFS NotesFromDisassembly
- python-zipinfo-riscos repository, the public source for the zipper pymodule's RISC OS ZIP handling;
- mattgodbolt-tbafs-extractor repository, the public source for the local TBAFS extractor.
Execution format appendices
The AIF, module, and utility execution-format appendix cites the canonical public specifications for each base format, alongside the 64-bit C library repository already cited below for the 64-bit extensions to those formats:
- ARM Image Format (1993)
- RISC OS PRM: Modules
- RISC OS PRM: Modules (changes)
- RISC OS 6 PRM: Code formats
- Pyromaniac PRM: Modules supplement
- RISC OS 6 PRM: OS_Module changes, for the RISC OS 4 and later revised service-call-handler table format.
ObjAsm and assembler material
The ObjAsm workflow and appendix cite the published assembler manuals together with the public repository behind the local wrapper tooling:
- ObjAsm assembler overview
- ObjAsm source language
- ObjAsm directives
- ObjAsm symbolic values
- ObjAsm expressions and operators
- ObjAsm conditional assembly
- ObjAsm macros
- objasm2gas repository, the public source behind the local objasm2gas and riscos64-objasm wrapper material.
Language-server and editor-integration material
The riscos-swi-lsp documentation cites a general LSP introduction and the tool's own upstream repository:
Git workflow, environment tooling, and 64-bit library references
The remaining chapters cite a mixture of public repositories cited directly and public repositories that now publish material originally consulted from installed command help, wrapper scripts, and other tooling local to the build environment:
- lessfilter repository, the public source for the local less filter chain;
- riscos-agent-skills repository, the public extract of the AI agent skills used in this environment;
- RISC OS 64-bit C library repository
- RISC OS 64-bit OSLib repository
- git absorb project page
- git-absorb command documentation
Examples
When extending or revising a chapter, consult the bibliography section that matches the topic first. It helps distinguish between:
- stable public documentation that should usually be cited directly;
- upstream project repositories that now publish material that was originally only available locally, where the visible entry should explain that connection;
- local installed help, extracted source trees, or tool implementation files with no public equivalent, which belong in an XML comment near the relevant entry rather than as a visible citation.