#Modula Keyb.
13-May-87 06:03:17
Sb: #67466-#Modula Keyb.
Fm: Peter da Silva 70216,1076
To: John Draper 76703,4322
This message turned up in search, but its forum couldn’t be identified from the original transcript, so it may not be linked into its thread.
But what it's really doing is running BCPL. I'll go along with Vic on this
one… if you're making calls in BCPL describe them as BCPL calls, then
document the BCPL calling sequence. If you're making everything look like
it's in 'C', then document them (completely) as 'C' calls and describe the
calling sequence in an aside. Write the manuals for the majority of the
users who are not assembly hacks or compiler writers.
In summation, I say document the *operating system* in terms of what it's
really doing, and leave the assembly for the hardware manual.