Return to BSD News archive
Path: sserve!newshost.anu.edu.au!harbinger.cc.monash.edu.au!msuinfo!agate!howland.reston.ans.net!europa.eng.gtefsd.com!MathWorks.Com!yeshua.marcam.com!charnel.ecst.csuchico.edu!olivea!decwrl!nntp.crl.com!crl.crl.com!not-for-mail From: gfurbush@crl.com (Gordon Furbush) Newsgroups: comp.unix.bsd Subject: Re: Man Pages Date: 31 Jul 1994 18:45:03 -0700 Organization: CRL Dialup Internet Access (415) 705-6060 [login: guest] Lines: 23 Message-ID: <31hk2v$fs8@crl.crl.com> References: <31cnj3$6cl@crl2.crl.com> <31fg3i$of7@sun.cais.com> NNTP-Posting-Host: crl.com X-Newsreader: TIN [version 1.2 PL2] Tom Strickland Jr (toms@cais.cais.com) wrote: : While on the surface a slick GUI interface seems nice, especially to : marketing, I perfer to have something that works well, doesnt require a : cray for reasonable response, and I have create my only little (ever so : humble) man pages and they work! : Sorry, I just am plain tired of having things fixed that are not "broke" I understand your point of view. But man pages, in hardcopy form, are often bundled with documentation written using other tools (most commonly FrameMaker). By authoring man pages using -man macros, you lose the ability to automatically cross reference the rest of the document with the man pages, and you can't create a cohesive table of contents or index. I know there's an nroff-to-mif filter that converts man pages into FrameMaker format, but it has more than a few bugs and doesn't handle tables. I was hoping that, after all of these years, someone would have figured out a better way to author man pages. -- Gordon Furbush gfurbush@crl.com