ftp.nice.ch/peanuts/GeneralData/Usenet/news/1993/csna/csna.1993.19.tar.gz#/csna.1993.19/csna.19.29

This is csna.19.29 in view mode; [Up]

Newsgroups: comp.sys.next.announce
From: guy@infotec.ch (Guy Roberts)
Subject: SUBMISSION: Man pages from Header files (Free)
Reply-To: guy@infotec.ch
Organization: comp.sys.next.announcements
Approved: sanguish@digifix.com

The utility is called ManPagesFromHeaders and has an AppKit interface 
that can convert (NeXT) Objective-C header files into rich text format 
in the same style as the on-line object class documentation provided 
by NeXT.

ManPagesFromHeaders.tar.Z (60Kb) can be found on sonata.cc.purdue.edu  
(128.210.15.30) in pub/next/submissions.  You will need to compile it.

Of course you will still have to fill in the gaps to describe what
each class and method is for, but the program lays out a skeleton page 
using appropriate fonts and tabulation.

A better solution might be to have comments within the code of a format
that can be recognised by a manual page generator. That way a well
commented object class could be used to produce a nearly complete
manual page. The existing code should be made to work as a service.

Happy documenting,
Guy Roberts, guy@infotec.ch. (But not here for long).


-- 
Guy Roberts (guy@infotec.ch)Infotec S.A.

phone: +41 22 738 44 36     5, Place Cornavin,
fax:   +41 22 738 29 12     Geneve, Switzerland.

Note:  There was a version up on sonata.cc.purdue.edu that was corrupted
earlier today.  That has been replaced, and the version currently there 
appears fine. - Scott Anguish

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Marcel Waldvogel and Netfuture.ch.