From 90d9cfc234b85bcbaa68903cb17793c6567aeff6 Mon Sep 17 00:00:00 2001 From: michaelh Date: Wed, 19 Sep 2001 18:32:39 +0000 Subject: [PATCH] Updated READMEs for 2.3.0 git-svn-id: https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc@1288 4a8a32a2-be11-0410-ad9d-d568d2c75423 --- README | 97 +---------------------------------------------- doc/KNOWNBUGS.txt | 7 +--- doc/README.txt | 20 ++++++++-- 3 files changed, 18 insertions(+), 106 deletions(-) diff --git a/README b/README index 22377abb..4e35d99b 100644 --- a/README +++ b/README @@ -1,96 +1 @@ -Small Device C Compiler (sdcc) ------------------------------- -A C compiler for the Intel mcs51 series and soon the Z80. - -http://sdcc.sourceforge.net/ - -This file is just a stub. It will get better. - -Almost all of this is by Sandeep Dutta -The Z80 port was started by Michael Hope - -Some of the Z80 related files are borrowed from the Gameboy -Development Kit (GBDK) originally by Pascal Felber. - -Notes on the z80 port ---------------------- -The 2.2.1 release finally includes the required libraries and -tools to target the z80. 2.2.0a included z80 compiler support -but not the assembler, linker, etc. - -Things are still not perfect. The z80 port is partly wedged in -due to the different ports using different base libraries, but most -of this is hidden by lcc. It is reccomended that to compile for -the z80 you use: - -lcc -mz80/consolez80 -c -o file.o file.c -lcc -mz80/consolez80 -o file.ihx file.o - -etc. -lcc is a wrapper for sdcc, the assembler, linker etc. It has the -added advantage that it accepts more of the standard command line -options than raw sdcc. - -The -mz80/consolez80 is very important as it selects the libraries -to use and which crt0 module to use. Unfortunatly each target system -requires its own startup code (crt0) and definitions for the base -of RAM, ROM etc. Those adventurous enough should get a copy of gbdk-lib, -build the appropriate crt0.s, and then manually link the object files -together with the appropriate base definitions and the appropriate -crt0.o. Try - -lcc -mz80/consolez80 -v -o file.ihx file.c - -to see the current liker command line. - -If you succeed, please consider sending Michael Hope a copy of crt0.s -and the appropriate base definitions, and he will roll them into the -next release of sdcc. - -If you find a bug and really cant wait, download the latest copy of -gbdk and use the copy of sdcc from that. - -Notes: ------- -000123 mlh: You can set the processor type at run time. Try: -sdcc -mz80 blah.c -sdcc -mmcs51 blah.c - -The default is the mcs51. - -Roadmap: --------- -README - This file -COPYING - GPL v2 -as/ - Assembler, derrived from asxxxx -debugger/ -device/ - Device libraries and examples -doc/ - sdcc and port specific documentation -link/ - Linker, also derrived from asxxxx -sim/ - Simulator (mcs51 only) -src/ - Source to the C compiler and ports -support/ - Libraries and apps that may not be provided by your system. - -Most of the port related files are in a subdirectory below the -appropriate module. For example, all compiler z80 related files -are in src/z80, all 8051 (mcs51) specific library files are in -device/lib/mcs51. - -Links: ------- - -* SDCC homepage - http://sdcc.sourceforge.net/ - -* GBDK homepage - http://gbdk.sourceforge.net/ - -* SDCC at Geocities (old) - http://www.geocities.com/ResearchTriangle/Forum/1353/ - -* SDCC mailing list - http://lists.sourceforge.net/mailman/listinfo/sdcc-user - - -* Yahoo! Random link - http://random.yahoo.com/bin/ryl +This file is depreciated. Please see doc/README.txt. diff --git a/doc/KNOWNBUGS.txt b/doc/KNOWNBUGS.txt index f8fc9144..cd2d3057 100644 --- a/doc/KNOWNBUGS.txt +++ b/doc/KNOWNBUGS.txt @@ -2,10 +2,5 @@ SDCC known bugs --------------- $Id$ -* Postincrement doesn't work correcly for structure members. - -z80 port: -* Longs and floats are minimally supported. - ds390 port: -* The linker does not yet supports segments >64k. \ No newline at end of file +* The linker does not yet supports segments >64k. diff --git a/doc/README.txt b/doc/README.txt index 0b854f30..0a7b8416 100644 --- a/doc/README.txt +++ b/doc/README.txt @@ -35,9 +35,19 @@ questions on the user mailing list. See: Notes: -* The gbz80, avr, and pic ports are currently experimental. The gbz80 - port is known to have some large bugs due to falling out of sync - with the z80 port. +* The avr, and pic ports are currently experimental. + + +Roadmap: +COPYING - GPL v2 +as/ - Assembler, derrived from asxxxx +debugger/ +device/ - Device libraries and examples +doc/ - sdcc and port specific documentation +link/ - Linker, also derrived from asxxxx +sim/ - Simulator (mcs51 only) +src/ - Source to the C compiler and ports +support/ - Libraries and apps that may not be provided by your system. Authors and interested persons: @@ -59,5 +69,7 @@ SDCC includes code from: Porting ASXXX and ASLINK for 8051. * Dmitry S. Obukhov malloc and serial I/O routines. - +* Pascal Felber + Some of the Z80 related files are borrowed from the Gameboy + Development Kit (GBDK). -- 2.47.2