[comp.sys.amiga] C reference needed

MCARTSHA@UREGINA1.BITNET (Shan Mcarthur) (10/06/89)

I have Lattice Cv4.1 and the manual.  It is a great compiler but I do not like
their documentation.   The functions that they did document were done very well
but they did not document every function that comes with the compiler.  I have
about 8 other C manuals and I really hate cruising through all of them just
trying to figure out what I do and do not have and how to use it.

Does anyone know of a way I can find out all of the functions, their parameters
and how to use them ALL IN ONE SOURCE for Lattice C?  I really wish that they
did a good job of documentation in the first place.  Is there another book out
on the market that I don't know about yet?

Thanks

cmcmanis%pepper@Sun.COM (Chuck McManis) (10/07/89)

In article <8910052039.AA14159@jade.berkeley.edu> (Shan Mcarthur) writes:
>I have Lattice Cv4.1 and the manual.  It is a great compiler but I do not like
>their documentation.   The functions that they did document were done very well
>but they did not document every function that comes with the compiler.  

Can you give an example of a function that Lattice provided that they didn't
document? I'm only guessing, but are you talking about the Amiga specific
routines such as OpenWindow() and stuff like that? If so they are Lattice
routines, they are Amiga routines. 

--Chuck McManis
uucp: {anywhere}!sun!cmcmanis   BIX: cmcmanis  ARPAnet: cmcmanis@sun.com
These opinions are my own and no one elses, but you knew that didn't you.
"If I were driving a Macintosh, I'd have to stop before I could turn the wheel."

fgd3@jc3b21.UUCP (Fabbian G. Dufoe) (10/07/89)

In article <8910052039.AA14159@jade.berkeley.edu>, MCARTSHA@UREGINA1.BITNET 
(Shan Mcarthur) asks for a single source of documentation for the functions
supplied with the Lattice C compiler (version 4.1).

     The documentation for version 5.02 (the current version of the Lattice
AmigaDOS C Compiler) is better.  All the Lattice supplied functions are
documented therein.  However, many of the functions you use when you write
C programs for the Amiga are supplied by Commodore.  The best source for
documentation of those functions is the Autodocs.

     The Autodocs are available from Commodore for $20.  They are a collection 
of disk files which contain the same kind of information about each function 
that Lattice includes for their functions.  Unfortunately, the Autodocs don't
tell you which include files are needed with the function.  That would be a
big improvement.

     I don't think you'll find a single source for information on both the
Lattice libraries and the Amiga libraries.

--Fabbian Dufoe
  350 Ling-A-Mor Terrace South
  St. Petersburg, Florida  33705
  813-823-2350

UUCP: ...uunet!pdn!jc3b21!fgd3

tron1@tronsbox.UUCP (HIM) (10/09/89)

>>I have Lattice Cv4.1 and the manual.  It is a great compiler but I do not
>>like
>>their documentation.   The functions that they did document were done very
>>well
>>but they did not document every function that comes with the compiler.  


I have always been very happy with the Lattice C. The newest version (5.2)
is a fantrastic producet and a great environment. They have always been very
good with the documentation.

But , they are NOT stand alone. The only REASONABLE way to program and Amiga
is with an industrial strength bookshelf and the RKM set above the desk.

****************************************************************************
  So Lord, I'd think you more than wise, (and me much less a jerk) 
  if only once you might supply.....
                        SOME PENGUIN WINGS THAT WORK!"  Opus '83 - 89 R.I.P.

 UUCP: tron1@tronsbox.UUCP  BEST PATH ---> uunet!tronsbox!tron1 
      Sysop, The Penthouse ]I[ BBS - (201)759-8450 / (201)759-8568 
****************************************************************************

donw@zehntel.zehntel.com (Don White) (10/14/89)

In article <125952@sun.Eng.Sun.COM> cmcmanis@sun.UUCP (Chuck McManis) writes:
>In article <8910052039.AA14159@jade.berkeley.edu> (Shan Mcarthur) writes:
>>I have Lattice Cv4.1 and the manual.  It is a great compiler but I do not like
>>their documentation.   The functions that they did document were done very
>
>Can you give an example of a function that Lattice provided that they didn't
>document? I'm only guessing, but are you talking about the Amiga specific

     Chuck, I think I see Shans complaint. Two or three years ago when I was
  first learning C, I was learning on my Amiga with Lattice. Lattice provides
  EVERYTHING including the Amy libraries. BUT (and this is a big but!) they 
  sort of assumed you knew the difference between standard library functions
  and Amiga library functions. They thoroughly documented the standard stuff
  and just barely told you the Amiga stuff was there (amiga.lib was used in
  an example). This was frustrating because I kept tripping over whether the
  functions I was trying to use were Lattice or Amiga, and what did the Amiga
  stuff do?  Fortunately, I hooked up with the ROM Kernal books before I killed
  myself ;-)

     I guess my point here is that if they provide the libraries maybe they 
  should be expected to provide at least cursory documentation? 

     At this point with the function prototyping of Lattice version 5 something
  and Rob Pecks' book on programming (and of course the RKMs) I feel I can 
  pretty much do what I need to.

     Don White - Box 271177 Concord, CA. 94527-1177
     zehtnel!donw

  Never end a sentence with a preposition, even when it would be good to.

usenet@cps3xx.UUCP (Usenet file owner) (10/15/89)

In article <1834@zehntel.UUCP> donw@zehntel.UUCP (Don White) writes:
>In article <125952@sun.Eng.Sun.COM> cmcmanis@sun.UUCP (Chuck McManis) writes:
>>In article <8910052039.AA14159@jade.berkeley.edu> (Shan Mcarthur) writes:
>>>I have Lattice Cv4.1 and the manual.  It is a great compiler but I do not like
>     Chuck, I think I see Shans complaint. Two or three years ago when I was
>  first learning C, I was learning on my Amiga with Lattice. Lattice provides
>  EVERYTHING including the Amy libraries. BUT (and this is a big but!) they 
>  sort of assumed you knew the difference between standard library functions
>  and Amiga library functions. They thoroughly documented the standard stuff

Its very easy to tell the difference. All Amiga functions
are capitalized, and none of the Lattice (Circa V3.10) functions are.

I would not put the burden of documenting the OS on the compiler
companies, it would only increase the price of the compiler. Since
CBM comtrolls the OS, has the source, they should provide
the docs on all the OS's functions.


 Joe Porkka   porkka@frith.egr.msu.edu
Press 'n' now if you are not Larry Kollar.

Hi Larry.
	I lost that address you sent me, so I have been unable
	to email you lately.
	Please send it to me again. Thanks.

	By the way, I have been playing around with the
	HyperText thing. A couple more days and I will post
	it.
 Joe Porkka   porkka@frith.egr.msu.edu