Path: utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!cornell!uw-beaver!tektronix!percival!baer
From: baer@percival.UUCP (Ken Baer)
Newsgroups: comp.sys.amiga.tech
Subject: New RKM:AutoDocs & Includes  MAJOR problem!
Keywords: RKM, parameter type, Manx, WARNING Will Robinson!
Message-ID: <1467@percival.UUCP>
Date: 8 Mar 89 18:05:23 GMT
Organization: Percy's UNIX, Portland, OR.
Lines: 24


I bought the new RKM:Autodocs & Includes the other day with great delight.
The manual is a vast improvement over its predescesors.  I was particularly
pleased with the fact that the parameter types were actually listed with
the function descriptions.  HOWEVER, to my dismay, I discovered that the
type sizes are WRONG!  Those of us who use Manx C, know that when you 
pass an integer to an Amiga system function (like Draw()), you have to
cast it to LONG (or it must me LONG in the first place).  But, in the new
RKM, these variables are listed as SHORT!!  Not as LONG!  I guarentee
that if you call Draw(rp, (SHORT)x, (SHORT)y)  you'll either go somewhere
wierd, or crash horribly.  At least this seems to be consistent through
the manual, so you can do a mental global search and replace on the SHORTS
and turn them to LONGS.  My heart goes out to all new Amiga developers who
try to use these functions.  Most of us know what a pain it is when you
find out the manual you trusted is wrong.

Hey CATS folx.  Other than this problem, I think the manual is EXCELLENT.
I can't wait for the new Libraries and Devices to come out!

-- 
	-Ken Baer.  					 
   //   Hash Enterprises: When the Going gets Wierd, the Wierd go Professional
 \X/    USENET - baer@percival.UUCP,  PLINK - KEN BAER,
        BIX - kbaer,  "while (AINTGOTNOSATISFACTION) { do stuff }" - RJ Mical