Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Path: utzoo!mnetor!uunet!stratix!mark
From: mark@stratix.UUCP (mark)
Newsgroups: comp.lang.c
Subject: Documenting for reusability
Message-ID: <173@stratix.UUCP>
Date: Wed, 28-Oct-87 08:24:33 EST
Article-I.D.: stratix.173
Posted: Wed Oct 28 08:24:33 1987
Date-Received: Sat, 31-Oct-87 13:44:30 EST
Organization: Stratix Inc,McLean VA
Lines: 22
Keywords: document library standards

Help desperately needed!
	After receiving a set a documentation specs from clients, we
informed them that the specs were effectively worthless in achieving
the objective, which is to document a program in such a way that
general purpose modules can be easily extracted from it and used in
other products.  Fine, they said, how should we do it.  My response:
???????. Uh, gee, I don't know.

	So, to all those out there, have any of you managed to come up
with a set of standard forms for documenting C programs so that they
can be
	o Easily modified by others than the original developers
	o Allow easy reuse of generic routines

	As a quick disclaimer, I am familiar with fipspub 38, etc. etc.
I need something that is oriented more towards enhancing code 
reusability when I am denied access to Object Oriented evironments.

Thanks
Mark Mullin / Stratix Inc
Voice: +1 703 847 2046
net:  uunet!stratix!mark