Path: utzoo!mnetor!uunet!husc6!necntc!dandelion!ulowell!page
From: page@swan.ulowell.edu (Bob Page)
Newsgroups: comp.sys.amiga
Subject: Re: include files
Message-ID: <6067@swan.ulowell.edu>
Date: 10 Apr 88 02:28:22 GMT
References: <23565@hi.unm.edu> <6009@swan.ulowell.edu> <26@fishpond.UUCP>
Reply-To: page@swan.ulowell.edu (Bob Page)
Organization: University of Lowell, Computer Science Dept.
Lines: 21

It still can (should) be done.  The RKMs are being revised, which
means the autodocs can get touched too.  How about:

FooBar -- Attempt to Bar a section of Foo

Usage:
	#include <exec/types.h>
	#include <exec/memory.h>
	#include <libraries/foo.h>

	struct Foo *FooBar(buf, siz, flags)
	            a1     a0   d0   d1
	UBYTE *buf;		/* pointer to data area */
	USHORT siz;		/* size of data area */
	ULONG flags;		/* bar-related operation flags */

...etc.  Most *NIX man pages are like this.  Easy to understand, no?

..Bob
-- 
Bob Page, U of Lowell CS Dept.  page@swan.ulowell.edu  ulowell!page