[Mspgcc-users] Documentation

[Steve U. <st...@co...>]

Hi all,

I have started putting together something approximating to real 
documentation for mspgcc :-).

The stuff on the web site has a number of limitations. The information 
on building the software was updated recently, so that part is not too 
bad. The information about about mspgcc specific programming was put 
together a long time ago, and shows it. It lacks important information 
(like completely omitting how to handle low power modes - a significant 
omission for the MSP430, I would say :-) ). Some has become irrelevant, 
as better ways to achieve the same thing now exist (e.g. the RESERVE_RAM 
attribute to main(), is mentioned, but the old messy ways of achieving 
much the same thing aremore prominent). Some has a strong Russian accent 
:-).

I took all I could find - the stuff from the web site, the stuff about 
the MSP430 that was posted here a few days ago, various notes that 
people have posted - and tried to mould them into the beginnings of a 
real user oriented manual. You can find the current state of this at 
http://mspgcc.sourceforge.net/manual/mspgcc-manual.html. Anyone who 
would like to
proof read, comment on, add to, or otherwise improve this is *most* 
welcome to do so. Its still in a raw state, but I have got far enough 
that I hope others might like to make some useful input.

If you would like to do any editting, the HTML is generated from a 
simple XML file - http://mspgcc.sourceforge.net/manual/mspgcc-manual.xml 
- which is turned into the working manual pages by a simple Python 
program - http://mspgcc.sourceforge.net/manual/doclite.py - which is a 
slightly modified version of the one you can find here - 
http://doclite.sourceforge.net.

Regards,
Steve