[comp.object] Documenting OO systems : makedoc

root@NEXTSERVER.CS.STTHOMAS.EDU (Max Tardiveau) (03/09/91)

Several people have requested te makedoc program I mentioned a few  
days ago. Makedoc was not written by me, but by the Real-Time and  
Distributed Systems Group, Department of Systems and Computer  
Engineering, Carleton University, Ottawa, Ontario, Canada.

I could not contact these guys, so I made it available on our  
anonymous FTP server : cs.stthomas.edu (140.209.16.21), as
pub/makedoc/makedoc.tar.Z (34663 bytes).

From the README file :
------------------------------------------------------------------
| Makedoc is a program that generates documentation for Objective C
| programs.  The output format is similar to that used by StepStone.
| Makedoc will even generate a class hierarchy diagram.
|
| The documentation is generated by searching for comment strings in  
| the source file.  Objective C method and standard C function 

| declarations are formatted appropriately.  

|
| Output is in Latex.  Other formatters can be accomodated by 

| replacing all of the printf statements.
------------------------------------------------------------------

If you don't have FTP access, I could mail it. If someone knows if  
there is a newer version from Carleton, I would be glad to hear about  
it.

Hope this helps.

---------------------------------------------------------------
Max Tardiveau
Department of Computer Science
University of St.Thomas
St.Paul, MN  55105
Internet : m9tardiv@cs.stthomas.edu
---------------------------------------------------------------
"Incompetence is like a two edged banana."

mherman@alias.UUCP (Michael Herman) (03/15/91)

C++/Views has a similar tool for C++ class libraries - it creates MS
Word documents from comments embedded in the C++ source.  C++/Views is
a C++ class library product for MS Windows GUI application development.