🚀 go-pugleaf

	The gemdos Fdatime() (function $57) is incorrectly documented
in the Hitch Hikers Guide, in the original Dri Gem Dos spec manual AND
in the Abacus St Internals book. I just could not believe my eyes when
i realized that ALL 3 of them DOCUMENTED this function INCORRECTLY.
The only document that documented Fdatime() correctly was the Gemdos
Manual (the April 4 release by Landon Dyer, who is on the net -
kudos!!).
The correct usage is:

	#define Fdatime(a, b, c) gemdos(0x57, a, b, c)

	Fdatime(Buffer, Handle, Set)
	char *Buffer;
	WORD Handle;
	WORD Set;

	Buffer ---> WORD Time;	/* Points to buffer containing */
		    WORD Date;

	Handle if a Fopen'ed file handle (open for read is fine).

	Set == 0  get the file mod. time and date
	Set == 1  set the file mod. time and date

	The Hitch Hikers guide has the first two parameters backwards.
	The Dri GemDos spec has the definition of Set backwards.
	The St internals book also has the definition of Set backwards.
	The St explored book does not document this function at all !!

	More Megamax C madness:
	  I guess the people over at Megamax C discoved the same mistake
in the hitch hikers guide (first two parameters backwards). So what
they did was in <osbind.h> they

	#define Fdatime(a, b, c) gemdos(0x57, b, a, c)

reversed the first two parameters for us. You can imagine my surprise
when my code started giving me bombs when compiled with Megamax. I
looked everywhere but in Osbind.h, because the last thing you suspect
to be wrong are the standard include files. If you look at the
osbind.h supplied by megamax, it is written by Atari. So someone at
Atari may be the culprit. 

	BTW Atari (Landon, Neil, Alan) when are you going to release
the rest of the missing .h files [signal.h (yes the library does contain
signal.o ), setjmp.h, dir.h etc) and the rest of the utilities
(ranlib, tsort, lorder - they are documented in the Alcyon document
that you give out without bothering to even mention why the documented
functions are not provided - a simple we have'nt done it as yet will
put the mind to rest). The developers kit has been out for over a year
now and i feel that now its about time that at least standard
header files are distributed by Atari, if nothing else, to avoid a
zillion different versions of the same files, and the resulting
disaster. So don't just claim V7 library compatibility with the new
release of the kit (seen several message from atari that state this)
DO SOMETHING ABOUT IT. I'll step off now.
-- 
					Jwahar R. Bammi
 		        Usenet:  .....!decvax!cwruecmp!bammi
		        CSnet:  bammi@case         Arpa:  bammi%case@csnet-relay
			CompuServe:  71515,155