File	Date	Author	Commit
docs	2011-07-16	Peter A. Bigot	[41d1bf] Update for SF 3354053 and 3354800
htdocs	2011-03-01	Peter A. Bigot	[6b55a4] Put all generated HTML files in htdocs/html
README	2012-04-07	Peter A. Bigot	[c98f87] README: Update to note directory will contain d...
README.rst	2012-06-06	Peter A. Bigot	[58c886] README displayed in SourceForge files area
RELEASES.TXT	2012-09-11	Peter A. Bigot	[6596ff] Update for release
msp430-binutils-2.22-20120911.patch	2012-09-11	Peter A. Bigot	[6596ff] Update for release
msp430-gcc-4.7.0-20120911.patch	2012-09-11	Peter A. Bigot	[6596ff] Update for release
msp430-gdb-7.2a-20111205.patch	2011-12-05	Peter A. Bigot	[d6a2fc] Update for next development series
msp430-libc.version	2012-07-16	Peter A. Bigot	[d10ade] Update for release
msp430mcu.version	2012-07-16	Peter A. Bigot	[d10ade] Update for release

Read Me

This directory contains files that add/enhance support for the Texas
Instruments MSP430 family of microcontrollers in open-source toolchains.
The material incorporated is maintained in a git repository hosted at:

 git://mspgcc.git.sourceforge.net/mspgcc/mspgcc

NOTE ON RELEASES
================

This is a *development* release of mspgcc.  Your needs may be better
supported by an LTS release such as LTS-20120406.

Quoting from
http://www.mail-archive.com/mspgcc-users@lists.sourceforge.net/msg10028.html:

  Certain releases of mspgcc will be marked as "Long Term Support".  These
  releases include well-tested sets of patches against specific versions of
  upstream packages like gcc and binutils.  The maintenance promise for LTS
  releases is that reproducible "significant" bugs for which a
  non-disruptive fixes can be identified will be fixed and patches supplied
  which can be applied on top of the patches provided in the corresponding
  mspgcc release.

  Other releases should be considered development snapshots.  They may be
  based on development (unversioned) snapshots of upstream tools.  No
  official patches will be released for these, and support for them ends on
  the release of the next version of mspgcc.

  Downstream packagers should publish only LTS releases, and should
  periodically check for new patches to be integrated into their packages
  (though I'll try to announce them periodically).  Patches are archived on
  the patches branch of the mspgcc repository, and are published for
  individual download at in Files/Patches on SourceForge.  Such patches will
  also be committed to the release branches on the gcc/binutils/gdb git
  repositories.


BUILD OVERVIEW
==============

Build and install a complete toolchain by building each of the following
tools in order:

  binutils
  gcc
  gdb
  msp430mcu
  msp430-libc

The source for the first three is obtained by applying patches in this
directory to the upstream distributions of the generic tools.  The patches
include information on how to build the distribution.

msp430mcu provides C headers and binutils linker scripts for each of the
over 300 microcontrollers in the MSP430 family.  It is released as an
independent package and can be obtained at:

  http://sourceforge.net/projects/mspgcc/files/msp430mcu/msp430mcu-YYYYMMDD.tar.bz2

where YYYYMMDD is provided in the file msp430mcu.version in this release.  A
.zip file is available as well.

msp430-libc provides C library routines.  It is released as an independent
package and can be obtained at:

  https://sourceforge.net/projects/mspgcc/files/msp430-libc/msp430-libc-YYYYMMDD.tar.bz2

where YYYYMMDD is provided in the file msp430-libc.version in this release.  A
.zip file is available as well.

** Please report all problems with this toolchain on the mspgcc bug tracker
   at:

  http://sourceforge.net/tracker/?group_id=42303&atid=432701

**WARNING** The documentation portions of this package are in progress, and
  may be out of date in significant ways.