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

[janstary (Jan Starý)]

I almost forgot: please let me know if there are some other manpage formaters besides man, groff, mandoc that I haven't taken into account.

[janstary (Jan Starý)]

Also, I just realized that both 'mdocml' (Kurt Hindenburg) and 'mandoc' (Mihai Moldovan) do exist. The 'mandoc' port is currently @1.13.3 and has a maintainer, while 'mdocml' is at @1.13.1 and has no maintainer. I propose we remove the mdocml port and keep 'mandoc'.

[janstary (Jan Starý)]

Eitan agrees. Can we remove mdocml please?

[mf2k (Frank Schima)]

In 3869e56cc8dea97211841d845aade4c0a02299fb/macports-ports:

mdocml:

• Replaced by duplicate port mandoc

See: #53902

[mf2k (Frank Schima)]

So is this patch good to be committed as is?

[mf2k (Frank Schima)]

In 945ccc0cc955a8843bacc3185d36f963f9941036/macports-ports:

mdocml:

• Use obsolete 1.0 portgroup

See: #53902

[mf2k (Frank Schima)]

In f4b3ca56da01f0670e37c4b339f81348b62e952b/macports-ports:

mandoc man groff: Update conflicts between them.

• mandoc: remove a pointless -nonewline
• mandoc: put CC before CFLAGS and LDFLAGS

Fixes: #53902

[janstary (Jan Starý)]

This got closed by cherrypicking just the conflict lines. I will continue with this in a Pull Request instead.