bammi@cwruecmp.UUCP (08/06/86)
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