psrc@poseidon.ATT.COM (Paul S. R. Chisholm) (10/14/88)
<"He seemed like such a nice man . . . and then he turned out to be a writer!"> In article <790@euraiv1.UUCP>, evas@euraiv1.UUCP (Eelco van Asperen) writes (in response to Bob Burch) > You left out the essential part of my remark; 'start each entry on > a separate page !' I was not talking about the quality of the docs, > just a gripe about their layout. >Eelco van Asperen, evas@eurtrx, mcvax!eurtrx!evas, asperen@hroeur5 Together, the two TC 2.0 manuals (not counting the TD/TASM books) are nearly a thousand pages long. Making each manual page a separate physical page would make the Reference Manual unliftable! But Borland's made a change I suspect you'll like: nearly *every* function has its own entry. No more "setfoo: Description: see getfoo" stuff. Every entry has Remarks, Return Value (as appropriate), and Portability sections. Indeed, that's part of the reason the 2.0 Reference Manual's so big! ("Nearly"? The exec, spawn, and va_ families are grouped together, instead of giving each function its own entry.)