manpage formatters

[janstary (Jan Starý)]

Currently, there are three ports dealing with displaying the manpages:

• sysutils/groff
• sysutils/man
• textproc/mandoc

sysutils/groff declares a conflict with mdocml, but there is no mdocml, and there is no conflict with mandoc (which was probably meant) - the two can happily coexist. In fact, mandoc goes out of its way to be as compatible with groff as possible.

sysutils/man uses groff to do the actual parsing and formatting, and provides man, man2dvi, man2html, makewhatis, whatis and apropos. These binaries are installed under those names.

textproc/mandoc formats man(7) and mdoc(7) like groff does, and provides man, mandoc, soelim, makewhatis, whatis and apropos. Currently, the port renames those to mman, mwhatis etc so as to not clash with the system defaults. Similarly, mandoc's man.conf is renamed to mandoc.conf. IMHO mandoc should just install man, whatis etc under those names, just like sysutils/man does (and the two should declare a mutual conflict).

One exception is the 'soelim' binary, which conflicts with groff's. Let mandoc make the compromise of installing 'msoelim', so that the two coexist, while the ubiquituous groff remains untouched.

The attached diff to the three Portfiles

• removes sysutils/groff's nonexistent conflict with mandoc
• declares sysutils/man's conflict with textproc/mandoc and vice versa
• lets textproc/mandoc install its binaries under the expected names
• similarly, lets mandoc use man.conf just like sysutils/man does
• comments on the above

While there,

• fix the MANDIR (/opt/local/share/man, not /opt/local/man)
• remove a pointless -nonewline
• put CC before CFLAGS and LDFLAGS

Tickets #53887 and #53898 probably need to go in before this. At least the diff is based on top of those.

[janstary (Jan Starý)]

sort out the relations between the manpage formaters