Skip to content

Commit 6f4331d

Browse files
authored
Prepare for 2.4
Removed ref to RMA and RLINK in documentation. Changed version to 2.4.
1 parent 95f6e6a commit 6f4331d

File tree

2 files changed

+8
-20
lines changed

2 files changed

+8
-20
lines changed

build/unix/rules.mak

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Project-Wide Rules
22

3-
VERSION = 2.2
3+
VERSION = 2.4
44

55
MERGE = cat
66
SOFTLINK = ln -s

doc/ToolShed.md

Lines changed: 7 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
ToolShed v2.2
1+
ToolShed v2.4
22
-------------
33

44
## A Color Computer Cross-Development Toolset
@@ -15,7 +15,6 @@ ToolShed v2.2
1515
* [Disk Extraction Under Linux](#de_linux)
1616
* [Pathname Elements](#path_elements)
1717
* [Support for HDB-DOS](#de_hdb_dos)
18-
* [rma, rlink and rdump](#rma)
1918
* [os9](#os9) - Manipulate OS-9 formatted disk images
2019
* [ATTR](#attr_os9) - Display or modify file attributes
2120
* [CMP](#cmp) - Compare the contents of two files
@@ -88,14 +87,20 @@ Managing a sizable assembly language source file for a complex program can be da
8887

8988
The relocatable macro assembler and linker give you the ability to write complex assembly language programs in different source files, then link them together to form a single OS-9 or Disk BASIC object file that can be loaded and executed.
9089

90+
These two command are no longer included in the ToolShed project.
91+
9192
### rdump
9293

9394
The output of the rma macro assembler is a ROF (relocatable object file). rdump allows the inspection of this intermediate file, and can also act as a disassembler.
9495

96+
This command is no longer included in the ToolShed project. It's functionality has been included into the os9 command.
97+
9598
### mamou
9699

97100
If you are comfortable with using the asm assembler that was part of OS-9/6809, then you will feel at home with mamou. This tool is more suited for assembly language programs that contain their entire source code in one file.
98101

102+
This assembler is included for historical purposes and should not be used for new development. For example, the NitrOS-9 project has switch to the LWASM assembler.
103+
99104
### ar2
100105

101106
Carl Kreider is a long time OS-9/6809 user and programmer, and has graciously given us permission to include his archiver utility, ar2, in ToolShed.
@@ -203,23 +208,6 @@ The number after the plus is the offset. It can be expressed in decimal or hexad
203208

204209
---
205210

206-
<h2 id="rma">rma, rlink and rdump</h2>
207-
208-
If you have used the software tools from the OS-9 Development System sold by Radio Shack for the Color Computer, then you will be right at home with rma, rlink and rdump. These tools behave exactly the same and have identical function to their Color Computer counterparts.
209-
210-
### Roles and Responsibilities
211-
212-
The function of each of these tools can be summed as follows: rma assembles source code into intermediate object code files called ROFs, and rlink assembles one or more ROFs into a binary executable file.
213-
214-
Let's look at a hypothetical program called doesitall. This program is a whiz-bang text processor written in 6809 assembly language and is composed of three files: main.a, sub.a and io.a. On top of that, the program uses routines from the alib assembly routine library (available from the NitrOS-9 Project). Here's how you would assemble a working executable from these files:
215-
216-
rma main.a -o=main.r
217-
rma sub.a -o=sub.r
218-
rma io.a -o=io.r
219-
rlink main.r sub.r io.r -l=alib.l
220-
221-
---
222-
223211
<h2 id="os9">os9</h2>
224212
The following pages document the commands built into the os9 tool. As the examples above illustrated, the built in commands such as dir, copy, etc. must be executed from the os9 executive, and any parameters for that command follow the command name.
225213

0 commit comments

Comments
 (0)