BabyFix Manual
~~~~~~~~~~~~~~

1) What is BabyFix?

BabyFix is a bug fix for Nostalgia's BabyTro as released on 13 February 1995.
This original release suffered from a bug resulting in an all-black screen on
most parts when running on a machine with a Cirrus Logic VLB card. Also, the
GUS detection routine did not always correctly detect that there was indeed one
installed (well, at least Trixter's GUS refused to be detected, I hope that's
fixed now).

The Cirrus Logic bug was caused by a small bug in the screen set routine, where
I wrote a word to port 3c2h instead of a byte. This means there's a byte
written to port 3c3h as well, but on most VGA cards there's no register at that
address, so the bug didn't cause any problems. Not so on the Cirrus Logic, that
has an undocumented register (I couldn't find it in Ferraro III) at that
position, causing all the trouble.

The faulty GUS detection itself is not solved, but there's an override flag now
(/g) that forces the GUS environment settings (ULTRASND) to be used, regardless
whether a GUS is present or not. Thus, the problem should be solved.

Since I was making a bug fix anyway, I also solved another less significant
bug: you cannot specify bogus options on the command line anymore. I discovered
the bug when accidently typing  /7 instead of #7. This didn't generate an error
message, but it should. That's fixed now as well.


2) How to use BabyFix

The usage is very simple: make sure that BABYTRO.EXE is in the current
directory and run BABYFIX. The program will replace the existing EXE file with
the bugfixed one, and copy the resource file.

Make sure you have at least 1Mb of free diskspace, the program doesn't check
this. If you run out of diskspace you will probably be left with an incomplete
BABYNEW.EXE. Delete that file, free some diskspace and try again.

After the program has finished the BabyTro should be bugfixed. You can check
this by requesting help with /?: the copyright message should say "version 1.1"
now, and the help should have the /g option listed.

Note that you can 'bugfix' the already bugfixed BABYTRO.EXE again without the
program giving a warning. This causes no problem whatsoever since BabyFix
replaces just whatever executable is inside the large EXE file.


3) Finally...

Thankyous go to the following persons:

Lone Ranger, for adapting the PolyPlayer (again)
Trixter, for reporting the detection bug

Greetings go to the following persons (in random order):

The REW, for initiating the Nostalgia WWW page set-up (and brilliant music)
SuaVe, who desperately needs a break (and money)
Lone Ranger, who thinks he needs a 10 for chemistry (but didn't get one)
Piotr, who must be either dead or worse (nice to know you're alive after all!)
Bas van Schooten, who has still no decent handle (and no girl)
TcM, long time no see! (and no hear for that matter)
Ren‚, for doing a great job on Tweety's Cage
The Specialist, who has proven there's no life after Nostalgia
SimStim, who left AcmE without his knwoledge
Aap, who actually believed that SimStim left AcmE
LaSerDance, who never thought for one moment that SimStim left AcmE
Lone Ranger, who never knew SimStim left AcmE
The REW, who was the first to know SimStim left AcmE
Sjaap, who's biting dust in the army now
Kristian and Nellie, who have been married for over 7 months now (almost 8)
Bas van Schooten, who still has no girl
SuaVe, who desperately needs money (and a break)
Mark and Henry, Hersenletsel rulez! (now go play that Kelder down!)
Patrycja, just to tease Bas if nothing else
Giddy Aunt, yes, I'll return those Threshold as soon as possible (already did)
Dimitri Ars, for maintaining pitel_lnx
Trixter, for hiding relaxedness behind well, eeehh, take a look at
  his picture :-)
all relaxed and cool guys here at X-95
all distrosite sysops, thanx for the support guys
all those thousands of persons I forgot to mention here, sorry guys, my memory
  is a giant zeef!

JAL / 5 April 1995 / 23 April 1995

