[comp.lang.c] Documenting for reusability

mark@stratix.UUCP (mark) (10/28/87)

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