Read Me
MARK WILLIAMS C
As a one time Atari ST programmer, I was interested to find the mwc open
sourced and released at http://www.nesssoftware.com/home/mwc/source.php.
Apart from briefly at work, I didn't use it, but it was a highly regarded
compiler and deserves to be remembered.
This project is a build for the Atarti ST version of the manual. It contains
the raw sources for other versions (dos, coherent, etc - see READ.ME), and
could be used as a template to resurrect these.
This manual is a mighty 800+ pages of info, containing details with examples
on how to use the compiler, supplemented with a lexicon on just about all
aspects of the c programming language and the Atari TOS environment. This is
useful for all c programmers and all Atari TOS programmers, not just those
using mwc.
It is built with troff, which is a unix typesetting system. As mentioned in
the READ.ME, all the content is present, but the formatting and style macros
are missing.
Recalling some of my now rusty troff skills, I have managed to create a plain
vanilla version of the macros, so while this version doesn't have the look and
feel of the original, the content is all there. Well, mostly. It's a pdf,
you can search for any term you want, there's no need for an index or a table
of contents, is there?
Am I going to include a rebuild of the c compiler? Unfortunately, the
released code didn't include the Atari specific libraries or code generator,
so, no, not likely.
One final note:
I simply do not have the time to proof-read all the manual. If you find a
mistake somewhere, please report it to ensutre that it gets fixed. You'll be
doing yourself and others a favour.
I hope there are some out there in internet land who find this useful.