In general nobody tends to deliver the catXX version - that's usually generated
by using the command "catman".

Most consolidations tend to deliver either the nroff formatted man-page or the
SGML equivalent - in fact the SGML version is the default for delivery by most
consolidations since they are then able to be easily used in the docs.sun.com
generated pages.

For people delivering via the docs group, they tend to use SGML as the source,
and generate the nroff version for delivery to the WOS.

Thanks,

Darren.

On 06/ 4/10 10:31 AM, Rainer Orth wrote:
> Jack Schwartz <[email protected]> writes:
> 
>> So my plan is to put dot-command-free, pre-formatted manpages into
>> /usr/share/man/catXX.
>>
>> BTW, this follows the precident of the pkg team, which already does this...
> 
> Which is a bad precedent, and I've filed
> 
> 15358   Issues with IPS man pages
> 
> about this (among several other issues).
> 
>> Maybe this is much ado about nothing, but please let me know if you have
>> any issues with this.
> 
> I do: man pages should be consistent across consolidations, and having
> them all in the same format (at the moment nroff with -man macros)
> allows them to be printed (e.g. converted to postscript if desired)
> easily, and with all the proper markup.  This is nothing a single
> consolidation should be allowed to decide on its own.  If OpenSolaris as
> a whole would decide to switch to a different input format for manpages,
> fine (provided this format provides the same facilities as nroff -man),
> using something at individual engineer's or team's whim is not.
> 
> Thanks.
>       Rainer
> 
_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss

Reply via email to