Glynn Foster wrote:
> 
> Brian Cameron wrote:
>> Rather than focusing on OpenSolaris spec file maintainers doing
>> special ARC documentation, I'd prefer if they were just involved
>> to ensure that the manpages were complete and accurate and we can
>> internally build ARC documents from the manpage information as
>> needed.  This way OpenSolaris spec file maintainers can focus more
>> on community involvement and less on the Sun specific aspects of
>> things.
> 
> I'm happy to pick up more man page edits from time to time. The real issue is
> that it's an absolute pain to have to write them in docbook - oh, if only we 
> had
> an easy solution here.

The easy solution is to use the man page sources from upstream - that's
what we do in X, shipping the troff man pages.   Conversion to DocBook
(technically SolBook) is only useful if you have a doc writer assigned
to put the results on docs.sun.com, which most of these community packages
probably won't.

-- 
        -Alan Coopersmith-           alan.coopersmith at sun.com
         Sun Microsystems, Inc. - X Window System Engineering


Reply via email to