Added note on re-targeting.
[fw/sdcc] / README
1 Small Device C Compiler (sdcc)
2 ------------------------------
3 A C compiler for the Intel mcs51 series and soon the Z80.
4
5 http://sdcc.sourceforge.net/
6
7 This file is just a stub.  It will get better.
8
9 Almost all of this is by Sandeep Dutta <sandeep.dutta@usa.net>
10 The Z80 port was started by Michael Hope <michaelh@earthling.net>
11
12 Some of the Z80 related files are borrowed from the Gameboy
13 Development Kit (GBDK) originally by Pascal Felber.
14
15 Notes:
16 ------
17 000123 mlh: You can set the processor type at run time.  Try:
18 sdcc -mz80 blah.c
19 sdcc -mmcs51 blah.c
20
21 The default is the mcs51.
22
23 Roadmap:
24 --------
25 README          - This file
26 COPYING         - GPL v2
27 as/             - Assembler, derrived from asxxxx
28 debugger/
29 device/         - Device libraries and examples
30 doc/            - sdcc and port specific documentation
31 link/           - Linker, also derrived from asxxxx
32 sim/            - Simulator (mcs51 only)
33 src/            - Source to the C compiler and ports
34 support/        - Libraries and apps that may not be provided by your system.
35
36 Most of the port related files are in a subdirectory below the
37 appropriate module.  For example, all compiler z80 related files
38 are in src/z80, all 8051 (mcs51) specific library files are in
39 device/lib/mcs51.
40
41 Links:
42 ------
43
44 * SDCC homepage
45   http://sdcc.sourceforge.net/
46
47 * GBDK homepage
48   http://gbdk.sourceforge.net/
49
50 * SDCC at Geocities (old)
51   http://www.geocities.com/ResearchTriangle/Forum/1353/
52
53 * SDCC mailing list
54   http://sdcc.listbot.com/
55
56 * Yahoo! Random link
57   http://random.yahoo.com/bin/ryl