Menu

Tree [r6] /
 History

HTTPS access


File Date Author Commit
 doc 2020-08-04 trevorbl [r6] add README
 Licence.txt 2020-06-23 trevorbl [r1] initial commit of document code
 README 2020-08-04 trevorbl [r6] add README

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.