> My response to "UNIX admin" below. ...And thank You for it!
> I'm in the SunOS man page group. Our group creates > and updates most > of the man pages published by Sun. There are other > groups within Sun > that produce man pages. In some cases, they use > different tools from > what we use. > > We use the Epic editor to edit SGML source files that > conform to the > Solbook 3.5 DTD. One could use any text editor to > edit the SGML, but > Epic provides features, among which is a link editor, > that facilitate > creation of properly formatted SGML files. >From what I could tell, Epic is now in the ownership of PTC, and is a >non-free, non-open source product which, judging by the screenshots, appears >to run only on the Windows platform. Unfortunately, this conundrum of factors makes it prohibitive for me to use Epic as a solution, nevertheless, Your insight and clarification of documentation team tools is invaluable to me, because it is a pointer in the right direction: I now know, that I need to be looking for an SGML, respectively an XML editor. > I'd guess you could find some decent tutorial > documentation, but I have > no specific knowledge of such a document. There appears to be no comprehensive documentation on the subject of typesetting with the troff(1) family of tools; the closest I've found is sgi's http://techpubs.sgi.com documentation on roff(1), respectively groff(1), and also UNIX(TM) 7th edition "UNIX PROGRAMMER'S MANUAL", from 1979. > There is the possibility we could change our tools. > This is really a topic > for another email, but briefly: Some believe that > opening Solaris entails > opening up the man page for direct editing by users. > Our current tools don't > upport such activity. There are people in our tools > group who are > investigating which tools would provide support for > direct editing by > people outside of Sun. I'm not necessarily looking to start changing SUNWman documentation, I was merely interested in the tools used internally to produce such typeset material. My goal is to provide quality documentation with my software, and in that respect, Sun's own documentation is the standard to measure against, and reach. -- This message posted from opensolaris.org
