Import Dev86src-0.0.8.tar.gzv0.0.8

1 files changed, 26 insertions, 11 deletions

diff --git a/README b/README
index 3e31632..47cfa57 100644
--- a/README
+++ b/README
@@ -1,6 +1,6 @@
 This is a development environment for ELKS-86
 
-You have to do make install as root
+To install the basic environment you have to do make install as root
 Or:
 
 $ make bcc
@@ -9,26 +9,41 @@ $ make library
 $ su -c "make install-lib"
 $ make elksemu
 $ su -c "make install-emu"
-$ make tests
 
 All from the top directory.
 Once this is done new files will be /lib/elksemu, /usr/bcc/* and /usr/bin/bcc
 
-The bcc command defaults to using /usr/bcc/include and /usr/bcc/lib. Beware
-that /usr/bcc/include is a symlink into this directory.
+The manual pages in the man subdirectory are a start as some pages matched
+to these programs, there are also some hints for using as86 well.
+The tests and bootblocks directories give some example code.
 
-It is now also possible to make libc.a versions for MSDOS and a more compact
-version with 'CALLER_SAVES' and 'FIRST_ARG_IN_AX'. "Make install-lib2" does
-this and 'bcc -Md x.c -o x.com" or "bcc x.c -Mf x.c -o x" uses the libs.
-To compile bcc using bcc this has to be done.
+The bcc command defaults to using /usr/bcc/include and /usr/bcc/lib the
+libraries _and_ include files are compied to these locations by install.
+
+After this you may want to install the other libraries, 'fast', 'MSDOS',
+'standalone' and Linux-i386.
+$ su -c "make install-lib"
+
+Use these libraries like this:
+   'FAST'    	$ bcc -Mf prog.c -o prog
+   MSDOS	$ bcc -Md prog.c -o prog.com
+   Standalone	$ bcc -Ms prog.c -o prog.sys
+   Minix 386	$ bcc -3  prog.c -o prog
+   Linux-i386	$ bcc -3 -N prog.c -o prog
+
+The Linux-i386 version generates static Linux a.out programs, they need
+neither elksemu nor a.out shared libries to run. If you want you can
+convert them to an odd ELF executable with:
+    $ bcc -N -3 prog.c -o prog
+    $ objcopy -O elf32-i386 prog
 
 The as86 and ld86 with this are _different_ from the ones needed for the
 linux-i386 kernel but can replace them, the kernel-i386 ones _will_ _not_
 work correctly here!
 
-Unfortunatly, I've just discovered the dosemu folks have been using the
-'-r' option of ld86, Grrrrr. Well **** them, they can use as86_encap, it's
-better suited to the job anyway.
+Unfortunatly, the DOSEMU folks have been using the '-r' option of ld86
+This version does accept '-r' but it generates _LINUX_ a.out object files.
+I think they should really be using 'as86_encap'.
 
 To compile the various tools as Linux-8086 binaries cd into the relevent
 directory and do a "make clean ; make" from there.