----------------------------------------------------------------------
FERNANDO 3-C Release 0.29 of 18/01/99.
Copyright (C) 1998-1999 by Patrick Pelissier.
All rights reserved.
----------------------------------------------------------------------



----------------------------------------------------------------------
			 COPYRIGHT CONDITIONS 
----------------------------------------------------------------------

This game is copyrighted but freely redistributable.  This means that you
can distribute it as much as you want to, free of charge. If you are
distributing it between computers, you should include the documentation,
source codes and 'Editors' with it. You are allowed to include this game
with other software. You should not charge anything for copying this game 
other than a reasonable fee to cover the costs of media and duplication.

TI-92, TI-92 II, TI-92 E, TI-92 +, TI-89 and TI logo
are trademarks of Texas Instruments. All rights reserved.

----------------------------------------------------------------------
				Requirements
----------------------------------------------------------------------

 You need a TI-92 with Fargo II (0.2.7.1 or ...).
 Or a TI-92 + with Plus-Shell 1.0 or Doors-Os 0.90.
 Or a TI-89 with Plus-Shell 1.0 or Doors-Os 0.90.

 If you don't have these OS, see http://www.ticalc.org/pub
 Or http://www.ti-files.org (or ...)

----------------------------------------------------------------------
				LIBRARY:
----------------------------------------------------------------------
Just need libraries :
	_ flib  OR Util.
	_ pk92lib.


----------------------------------------------------------------------
				MEMORY:	
----------------------------------------------------------------------
	_ You need 17910 Bytes Free (Average) to run the program. 
	  But, in fact, you will need : One buffer screen ($F00 Bytes always
	  for any fargo program) and the size of the unpackered files :
		_ 8194 Bytes for a level-File.
		_ ???? Bytes for a graph-File  ( <= 32640 Bytes).
		_ ???? Bytes for a boss-File   ( <= 32640 Bytes).
		_ ???? Bytes for a bonus-File.
	_ And the libraries.
	_ And Fer3C.92P.
	_ And Level.92p (or World.92p or anyother Fer3-World).

	Change 92P to 9XZ or 89Z in function of your calc.

----------------------------------------------------------------------
				RUN:
----------------------------------------------------------------------
	
	First, install the OS (Fargo, PlusShell, DoorsOS, ...).
	Then send 'Fer3c', the libraries and a level 'level'
	to your calc.
	Finally, press World() to run fer3c or level() in home.
	+Or run it in a shell.


----------------------------------------------------------------------
				MENU:
----------------------------------------------------------------------

	* Press F1, F2, F3 to select your difficulty.
	ESC	to escape (Return to TI-OS or a shell).
	You can change the speed of the game by using Left/Right
	(Frame 1 >>>>>> Frame 255).
        	F4 : Link is not available !
		F5  : you can load an old game .
	 Just quit by pressing 2nd (Or Esc for 89) and validate by ENTER.

	* Then press F1, F2, F3, F4 to select the number of players.
	If there are more than one player,
	  Press Up then Down then Left then Right then Jump
	  for each player.


----------------------------------------------------------------------
			GAME : 	An Action-PlatForm game.
----------------------------------------------------------------------
	You must find the exit door (which can be another thing,
	 like a flower!) or kill the boss.
	Take item-Power to increase your power.
	To pass, find keys, switch or ...
	That's all !! Easy, very easy! But...you are not alone.

	In multi-player cooperation mode, all fernandos have the same
	lifes and the same keys... so it's very hard, but fun.
	You have different power, so don't take all items...

	I think that this game is quite hard (I always play in EasyMode).

----------------------------------------------------------------------
				KEYS TI-92:
----------------------------------------------------------------------
 In One-player Mode:
	_ 2nd  : Exit and save the game (just life and Level).
		To save the game, just press ENTER at 'SAVE ?' screen.
	_ Shift: Pause & turn Off.
	_ Hand : Jump.
	_ F5   : Slow.
	_ F6   : normal speed.
	_ F7   : hight speed.
	_ DOWN : Use the teleportation (when you can - like mario).
	_ UP   : Use it very often to catch the ceilling.
	_ Left : ?
	_ Right: ??
	_ PAD-ENTER : Only in full-screen mode, Statut-Bar
 In Multi-Player Mode :
	_ 2nd  : Exit and save the game (just life and Level).
	_ Shift: Pause & turn Off.
	_ Hand : recenter all fernandos (very usefull ! ! ).
	_ F5   : Slow.
	_ F6   : normal speed.
	_ F7   : hight speed.
	_ PAD-ENTER : Only in full-screen mode, Statut-Bar

	And the keys you have quoted...


----------------------------------------------------------------------
				KEYS TI-89:
----------------------------------------------------------------------
 In One-player Mode:
	_ Esc  : Exit and save the game (just life and Level).
		To save the game, just press ENTER at 'SAVE ?' screen.
	_ F5   : Pause & turn Off.
	_ 2nd : Jump.
	_ F1   : Slow.
	_ F2   : normal speed.
	_ F3   : hight speed.
	_ DOWN : Use the teleportation (when you can - like mario).
	_ UP   : Use it very often to catch the ceilling.
	_ Left : ?
	_ Right: ??
	_ Home : Stat-Bar
 In Multi-Player Mode :
	_ Esc  : Exit and save the game (just life and Level).
	_ F5   : Pause & turn Off.
	_ F4   : recenter all fernandos (very usefull ! ! ).
	_ F1   : Slow.
	_ F2   : normal speed.
	_ F3   : hight speed.
	_ Home : Stat-Bar
	And the keys you have quoted...

----------------------------------------------------------------------
				KNOW BUGS :
----------------------------------------------------------------------
 _ In multi-player, some keys should be available but not...
   There is a bug (like I think all Asm-programs) in Keyboard scanning.
 _ It may exist a crash bug (why one ?). I hope i have corrected it but ...
   This text is an extract from MegaCar.txt by Thomas FERNIQUE aka TLP:
 " There is ONE bug (maybe other but the only i know), and it drive me CRAZY !!!
I did not resolve it, and i'll ask help for D.ELLSWORTH if i have time.
The bug : When you try to run a track which need more ram that you have, the
calc crash (you get 'illegal instruction'). I try with a simply program,
which try to allow more mem than available mem, and it crash to, so the crash
is not due to an error in the real program.
BUT IF YOU HIT 2ND-MEM BEFORE LAUNCH THE PROGRAM (only the first time),
THE CALC DOES'NT CRASH !!! (the game just quit because not enough
mem detected).
I think there is a bug in the tios function 'HeapAlloc' or in the rom 1.3.
Try it on tour calc and say me what happend !"

		$ SO DON'T FORGET TO HIT 2ND + MEM $

 It really works on a TI-92 (but sometimes it crashes when you open it..)

 _ In multi-player mode, you can't see exactly your power.

-------------------------------------------------------------------
			Disclaimer
-------------------------------------------------------------------
There is always the possibility that a program will crash your 
calculator.  I cannot be held responsible for loss of data, damage 
to your calculator, etc.  Use this program at your own risk.


----------------------------------------------------------------------
			GLOBAL REM
----------------------------------------------------------------------

	* The game uses the I/O screen for the sprite buffer.
 It pushes the 2nd screen (3096 Bytes) and the Virtual Screen
 (4480 Bytes) on the stack, so you don't have to run a shell
 which runs a shell which ... which runs Fer3c even if I test it (It
 might crash your TI even if it doesn't crash my TI-92 {Rom 1.12}.).
 But don't cry the stack is quite big : about 16 KO, so it
 should be all right.
 If I don't use these buffers, Fer3c will need 26536 bytes Free to 
 run...
	* World is quit big (~22 Ko) but it is ~ 75 Ko of uncompressed data.
	* Fer3c contains 45 sprites, 75 Options and many special effects.
 But in fact, Fer3c can contain an infinity of sprites, an infinity of gfx,..
 How ? Using AddOn and your Graphics.
	* Fer3c is a library !!! You must run the world !
	* If you need to enter a pass-word when you turn off your calc,
 when you pause the game, you will need to enter it even if you don't
 have the dialog box (It changes the adress of the screen).
	* In multi-player you can't choose some keys :
	'2ND' 'SHIFT' 'DIAMOND' 'HAND' (Normal)
  And
	'.' '0' 'F4' 'Q' 'A' 'ENTER1' (Dad, I see a bug. No, my soon...)
	* There is a cheat code to enter TURBO-MODE !
	* On my TI-92 (Rom 1.12), Fer3c runs at ,about, 60Hz !!!!
 When you use grayscale graphics, it runs at 40 Hz ( 60 Hz if you
 have a calc like TI-92 II, TI-92 Boosted, TI-92+ or 89).
	* Max Speed = 5480 pixels / seconde without any bug-collisions!!!!!
 Calc = TI-89, Cheat = On, SuperSpeed = ON, PROPULSOR = RIGHT, KEY = RIGHT
 But the speed is 120 pixels/seconde in average( Speed2 and 60 Hz)
        * Like all programs which use Pk92lib, you can't use pk92sfx.
 	* When you use Multi-Plan and Multi-Player, sometimes you can't move
 because the other players have changed of plan, so you can be in a block.
 Use hand to try to escape the block (the last chance but it can fail).
 	* 'Load / Save File' doesn't work if the size of the level
 is < 2600 Bytes.
	* Spritexx.exe, boss.exe will crash if you don't have a mouse-Driver.

----------------------------------------------------------------------
			Missing:
----------------------------------------------------------------------

		+ Competition Mode (by link)

----------------------------------------------------------------------
			History:
----------------------------------------------------------------------
 ...
 Release 0.09 : * First Public Release
 ...
 Release 0.11 : * Added Fish, Fer-Hunter, Ghost and Fungus.
                * Added new graphics.
                * Correct Bugs and some optimization.
                * Added new options.
                * Added new actions.
                * Added new levels (Fernando 3 v2.55 levels).

 Release 0.12 : * Added Waterfall, Special-Bat & Garbesh-Collector.
		* Added Bomb, Exploded-Wall and a 2nd explosion.
                * Correct many bugs.
		* Optimization of the code.
		* Improve Exhumed dance, fly, .....

 Release 0.13 : * Fixed 3 bugs (Switch & doors don't work properly).
		* Update Level.exe : new options and new keys (ESC !).
		* Added a new level : Valley.
		* Update : Priwi, Merald, GreenIll.
		* Added Star.
		* Increase Fer-Hunter Power.

 Release 0.14 : * Added MULTI-PLAN (Look at Land.92P).
		* Optimization of the code.
		* Optimization of Sprite routine.
		* Added GrayScale (Now you can have 3 colours !).
		* Added Scroll-Right.
		* Update Level.exe.
		* Added a new level : Land.

 Release 0.15 : * Added Shifting.
		* Added Boat-effect.
		* UpDate Level.exe : New Options & New Keys (Up/F1 -> F5)
		* Added Sun.
		* UpDate GreenIll.
		* Added diagonal as Test(Extra-Option) & Graph.
		* Added Mode X-Or & find a new bug (Not a crash bug).
		* Added Cinema-mode.

 Release 0.16 : * Added Crabe.
		* Added Monkey.
		* Added Deca-Rol.
		* Added a 2nd Shifting.
		* Added Shooter.
		* Added Moon.
		* Optimization of the code ( - 1000 Bytes)
		* Added a new level : Level2.
		* Optimization of title.bin (- 256 Bytes)
		* Improve Shifting 1 : Look & cry !
		* Added Miror.

 Release 0.17 : * Delete Clipping (Sprite Routine)
		* Improve Memory needed : now you need 17Ko to run it !
		* Added World !
		* Improve Water-Fall : now it's Deca-Vert and it
			works very nice (Added one graph).
		* Improve Teleportation.
		* Del a Crash Bug.
		* Optimization of the code.
		* Added linker Graph-Test.
		* Improve Gray-Scale and added Anim2 : PERFECT !
		* Correct ScollUpDate.
		* Change fer3c : now it's a library and to run fer3c, you must run
		the worlds. (- 500 BYTES).

 Release 0.18 : * Optimization of intro and level completed screen.
		* Make intro.92p (Separate file).
		* Added Glooner.
		* Added Boolder.
		* Changed Star.
		* Added HoloD...
		* Added FlyBoot.
		* Added Scarat.
		* Added Point Dexter.
		* Added Bloominator.
		* Added Flams.

 Release 0.19 : * Boss Engine and Boss Editor.

 Release 0.20 : * Improve Flams.
		* Optimization of scrolling and Time-Gestion (-500 Bytes).
		* Correct a bug (Keys).
		* Improve MkWorld: now it works perfectly (Only if fargo-dos
		 doesn't crash...).
		* Added a cheat code...
		* Increase difficulty : harder ...
		* Del a crash bug (Memory free between 12000 & 18000).
		* Finished Boss.
		* Added a new level.
		* Added a new level.

 Release 0.21 : * Added Multi-Player Cooperation Mode.
		* Change APPS to Shift (because of MultiPlayer).

 Release 0.22 : * Ported to TI-92 +.

 Release 0.23 : * Correct a very bad crash bug (Many thanks to Tleilax).
		Instead of SkipStar, I have written SkipEntry...
		* Improve 92 Plus version by using IO Screen. It may be
		more stable...
		* Added Speed-Control.
		* Correct a bug ( d0 instead of d6 in 'Limites').
		* Improve Intro.asm.
		* Added Bonus-File as external-programs !!!!
		For example after a very hard level, you can play at tetris.
		(See MkWorld).
		* Improve (a few) Scroll-engine (faster and smaller):
		 Exchange only a7 and a0.

 Release 0.24 : * Start of working on link...AAAAARRRRRR-_- GAME OVER MAN
		* Added new graphs in World2
		* Added a new level (World2)

 Release 0.25 : * Optimization of the code :
			Change all clr.l ds to moveq #0,ds
			Change all lsl.w #1,ds to add.w ds,ds
			Change all clr.w Dat1 clr.w Dat2 to clr.l Dat1
			....
		* Delete 1 crash Bug and two other bugs.
		* Ported to TI-89.
		* Added Save / load System.
		* Added Level editor on the calc ! ! ! !  (Only TI-92)

 Release 0.26 : * Improve Bonus-File.
		* Improve sources : now you can choose your Scrolling engine.
		* Added Full-Screen for TI-92 !!!!!
		* Improve Fernando 3-C for TI-89 (Faster than 92 or 92 Plus).
		* Delete the wild teleportation bug (maybe).
		* Ported 'fer3edit' to TI-89.
		* Added 'Box' in Fer3Edit.
		* Added 'Map' in Fer3Edit.
		* Added one level in world2.
		* Update Level 1 and 3 of world2.
		* Del a bug in Fer3Edit (processor's clock).
		* Del a bug in Fer3c (FullScreen and TinyScreen).
		* Del a bug if Fer3c : Sprites now appear correctly.
		* Added 'ShortKeys' in Fer3Edit.
		* Added '[2nd] keys' if Fer3Edit.

 Release 0.27 : * Improve Sun and Moon.
		* Improve FlyBoot.
		* Optimize the code.
		* Del a crash bug in Fer3Edit (Processor's clock 2).
		* Added 6 type of Nests.
		* Optimize the code.
		* Added new gfx based on Mario but they take very much
		memory (You need 22Ko free to run !).
		* UpDate Level.exe : new keys (list function)
		* Added 'Jump' and 'Jump if Key=0' in MkWorld
		* Improve Gfx of Fernando
		* Added a new level in world3.
		* Added a new level in world3.
		* Del a crash bug in new-sprite.
		* Added a new boss in world2.

 Release 0.28 : * Added 'AddOn'.
		* Improve MkWorld for AddOn.
		* Improve Boss : FullScreen and TinyScreen work.
		* Improve Conc_Scroll   : it works in multiplayer.
		* Improve Multi-Player (different power).
		* Correct a crash bug in multi-player on TI-89.
		   Well, I think now that keystat is a few bugged...
		* Del Hard-Mode bug (You can not used it).
		* Del a minor bug in Scroll-Righ (Tiny & Full screen)
		* Added many entries in fer3c.h
		* Added new characters (Starting working on BOB).
		* Improve Add-On and Bob.
		* Added a 'MEMORY' screen.
		* You can now exit if you have selected 2 or more players.
		* Del a crash bug (a new !) : MultiPlayer and Fer3Edit.
		* Added 'Save ?' when you quit.

 Release 0.29 : * Added a new level in world2.
		* Del a minor bug with doors and gates.
		* Added coins statut.

-------------------------------------------------------------------
			Thanks to...
-------------------------------------------------------------------

Texas Instruments,
	      For their fact calc.
	      But not for their bad OS which crashes every week in average.

David Ellsworth
              For creating Fargo, the only ASM shell for the TI-92,

Rusty Wagner
	      For PlusShell, Send92p, and Virtual TI,

The Doors Team
	      For Doors OS,

Jimmy Mardell
              For the sprite routines (Sprmaker), 68000 Guide & SQRXZ,

David Khling 
	      For Packer 92,

Benoit  SCHERRER
	      For Hexview,

Tleilax	
	      For D B 92,

Jonas Minnberg 
	      For the Tiger emulator,

PACO Z
	      For many things : without him Fer3 wouldn't exist on the TI-92.

All the beta testers :
		Olivier		Certner,
		Francis		Colas,
		Thomas  	Fabritius,
		Christophe	Laplanche,
		Olivier		Marsden,
		Cedric		Pelissier,
		
And many others ....

-------------------------------------------------------------------
				Author
-------------------------------------------------------------------

If you think you have found a new bug, mail me.
 ppelissier@hotmail.com
