$Id: README,v 1.3 1993/11/24 01:13:12 root Exp $

Introduction:
=============

Many people (including myself) had asked for a linux to MS-DOS
cross-compiler on the net. It turned out that it was quite easy to
build a cross compiler using DJGPP (the GCC porting to MS-DOS) since 
both compilers (djgpp and linux gcc) use the same object format.
The differences appear on the executable format, so all that was
needed was a cross-linker; fortunately the new GNU binutils where
designed with this on mind.

	All I had to do at that moment was to compile the binutils,
generate to (really small) scripts and test the thing.

Installation:
============

The distribution suposses you are using version 2.4.5 of GCC
(the one I had at home when built the thing), the script mklns tries
to determine your GCC version and use that information to create the
right links/scripts for you, if you don't trust my script (good idea)
you can use it as guidelines on what to do it yourself (hack, hack,
:-) Remember to add /usr/local/bin to your path.

	You will need some portions of the djgpp distribution also,
specially go32.exe, stub.exe and aout2exe.exe, this utilities are
needed to run DJGPP programs under MS-DOS. They are usually
distributed on a file called djdev110.zip (version may change of
course). You will also need the device drivers if you are planning to
do any graphics.

	Another source of annoyance is that djgpp and dosemu don't
understand each other very well, one of those horrible memory problems
of PC's that I don't want to know about (and thanks to Linux I don't
have to learn).


    go32crs has been tested under the following configuration:

	Software:
		Linux 0.99pl10
		GCC 2.4.5
		GNU binutils 2.2.1
		DJGPP 1.10 (go32 1.08)
		C-TORTURE 1.15 (for testing purposes)
	Hardware:
		i486dx33 (no 387 emulation tests had been done)


Bugs:
=====


Up to now the following bugs had been detected:

- GCC long long int's don't work, there are some things missing on 
  DJGPP libgcc.a.
- g++ does not work at all, the problem is that DJGPP still uses a very 
  old version of libg++.
- DJGPP printf uses 7 decimal digits when printing floating point
  numbers the torture test expects 6, it is a problem undoubtely, but
  I'm not sure to call it a bug.

Copyright:
==========

    go32crs a Linux to MS-DOS cross compiler
    Copyright (C) 1993 Carlos O'Ryan

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

I ask (do not require) is that you cite me if you use this thing, I think
that I can do little else since most of the work is GNU based.

	I apologize in advance if I am violating anybody's copyright,
please let me know if I do so, I'll do my best to correct the
situation. Just to make sure:

- DJGPP is partly copyrighted by 

DJ Delorie
USmail: 24 Kirsten Ave, Rochester, NH 03867-2954, USA
email:  dj@ctron.com

DJ does not support go32crs, please ask me first, if it is a real DJGCPP 
problem we go after him.

- Linux GNU binutils, and Linux GCC are copyrighted or partly
copyrighted by 

Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Acknowledgements:
=================

	I don't want to miss the opportunity to thank all the people
from GNU and Linux, specially Richard Stallman and Linus Torvalds.

	Also I'd like to thank Paul Brewer my first (and only) alpha
tester who tried this thing when there wasn't even and installation
script.

Contacting the Author:
======================

	The perpetrator :) can be found trough E-mail on the address
below, as usual I can not promise solutions, but since I'm interested
on using the cross compiler too I'd be happy to hear of any problems,
bugs, solutions or (if there is any) success with this package.

			Carlos O'Ryan Lira
			(coryan@mat.puc.cl)