You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/ToolShed.md
+7-19Lines changed: 7 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
ToolShed v2.2
1
+
ToolShed v2.4
2
2
-------------
3
3
4
4
## A Color Computer Cross-Development Toolset
@@ -15,7 +15,6 @@ ToolShed v2.2
15
15
*[Disk Extraction Under Linux](#de_linux)
16
16
*[Pathname Elements](#path_elements)
17
17
*[Support for HDB-DOS](#de_hdb_dos)
18
-
*[rma, rlink and rdump](#rma)
19
18
*[os9](#os9) - Manipulate OS-9 formatted disk images
20
19
*[ATTR](#attr_os9) - Display or modify file attributes
21
20
*[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
88
87
89
88
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.
90
89
90
+
These two command are no longer included in the ToolShed project.
91
+
91
92
### rdump
92
93
93
94
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.
94
95
96
+
This command is no longer included in the ToolShed project. It's functionality has been included into the os9 command.
97
+
95
98
### mamou
96
99
97
100
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.
98
101
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
+
99
104
### ar2
100
105
101
106
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
203
208
204
209
---
205
210
206
-
<h2id="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
-
223
211
<h2id="os9">os9</h2>
224
212
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.
0 commit comments