Installation of S.Ha.R.K. and DJGPP
--------------------------------------------------
by Giacomo Guidi <giacomo "at" gandalf.sssup.it>
May 4, 2003
--------------------------------------------------


>> Linux:
-----------------------------------------------------------------------------

	1) Download shark-XXX.tar.bz2 from the S.Ha.R.K. web site

	2) tar xvjf shark-XXX.tar.bz2

	3) cd shark

	4) cp config/mk/linux.mk config/config.mk

	5) cp oslib/mk/linux.mk oslib/config.mk

        5a) Edit shark.cfg: New in S.Ha.R.K 1.21 !

            This step is needed to setup the compiler
            options and to optimize the kernel for faster
            and more precise time computation.

            You can:

              ENABLE/DISABLE TSC (DEFAULT: ENABLE)
              ENABLE/DISABLE APIC (DEFAULT: DISABLE)
	      ENABLE TIMER OPTIMIZATION (FOR SPECIFIC CPU SPEED) 

	6) make

S.Ha.R.K. is compiled

	7) cd demos

	8) make

The demos are compiled. You can run the demos using
the FreeDOS bootdisk with x.exe or directly load a demo
thought Grub.





>> DOS:
-----------------------------------------------------------------------------

In DOS real mode it's important to load smartdrive (smartdrv 16000 /x) 
to speedup all these steps.

	1) Download unzip32.exe, mindj322.zip and sharkxxx.zip from
           the S.Ha.R.K. web site.

	2) unzip32 -o mindj322.zip -d c: 

	   (if you already have PkZip, pkunzip -d -o mindj322.zip c:\)

	3) cd c:\djgpp

	   (if you change this directory name or position, you have also to
	    modify the .bat files)

	4) install.bat

	5) setvar.bat

	   (this script automtically set the environement variables
	    for DJGPP, you must run this files every time you reboot
	    and start a compile session)

Now DJGPP is installed and ready to compile shark	

	6) unzip32 -o sharkxxx.zip -d c: 

	   (or pkunzip -d -o sharkxxx.zip c:\)

	7) cd c:\shark

        7a) Edit shark.cfg: New in S.Ha.R.K 1.21 !
                                                                                                                             
            This step is needed to setup the compiler
            options and to optimize the kernel for faster
            and more precise time computation.
                                                                                                                             
            You can:
                                                                                                                             
              ENABLE/DISABLE TSC (DEFAULT: ENABLE)
              ENABLE/DISABLE APIC (DEFAULT: DISABLE)
              ENABLE TIMER OPTIMIZATION (FOR SPECIFIC CPU SPEED)

	8) cp config\mk\gnu.mk config\config.mk

	9) cp oslib\mk\gnu.mk oslib\config.mk

	   (cp is like copy command, it's included in the DJGPP distribution)

	10) make

S.Ha.R.K. is compiled

	11) cd demos

	12) make

The demos are compiled. If you want to test a demo

	13) cd <demo dir>
	
	14) x <demo name>

In real DOS environement, you can compile and run a demos without reboot.








>> Windows version with DOS real mode support (Windows 95/98):
-----------------------------------------------------------------------------

	1) Download unzip32.exe,mindj322.zip and sharkxxx.zip from the
           S.Ha.R.K. web site.

	2) Go to DOS real mode

	3) Follow the previous procedure for normal DOS environement

PAY ATTENTION: DON'T UNZIP mindj322.zip AND sharkxxx.zip INSIDE WINDOWS,
LIKE USING WINZIP OR PKUNZIP FROM DOS EMULATION WINDOWS. THIS WILL CAUSE
ERRORS DUE TO THE FAT32 LONG NAMES.







>> Windows Millennium/NT/2000/XP:
-----------------------------------------------------------------------------

	1) Download unzip32.exe,mindj322.zip and sharkxxx.zip from the
           S.Ha.R.K. web site.

	2) Go in a DOS emulation window (DOS prompt)
	
	3) Follow the previous procedure for normal DOS environement

The big difference between this install and the others is that YOU
CANNOT EXECUTE X.EXE EXTENDER INSIDE A DOS EMULATION WINDOW. So to
test a compiled demo you have to reboot with FreeDOS bootdisk or
something similar.