Hi everyone.

While working a bug regarding beadm manpages (14550) I learned that manpages deposited into /usr/share/man/catXX are displayed without additional formatting. Those in /usr/share/man/manXX are formatted by the man(1) command, and when they are, a copy of the formatted output is put in /usr/share/man/catXX as part of the process. The catXX files are used if man is run on the same inquiry again.

Currently our slim_source manpages are all put into /usr/share/man/manXX. I think that if we put them into /usr/share/man/catXX directly, we could do all of the formatting ourselves and eliminate all of the dot (formatting) commands.

The benefit of this would leave the files as readable whether in the gate or installed on the system. Lack of dot commands would make maintenance of manpage sources easier.

A potential drawback to this approach is that font changes (i.e. Bold) would be lost on some systems, but I'm not sure how much it matters (hence this email). In Gnome there is no problem as these font changes are not emitted to begin with. It may be that font changes are lost only on old vt100-style terminals.

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...

Maybe this is much ado about nothing, but please let me know if you have any issues with this.

    Thanks,
    Jack


_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss

Reply via email to