#53902 closed enhancement (fixed)
manpage formatters
| Reported by: | janstary (Jan Starý) | Owned by: | grimreaper (Eitan Adler) |
|---|---|---|---|
| Priority: | Normal | Milestone: | |
| Component: | ports | Version: | |
| Keywords: | haspatch | Cc: | |
| Port: | mandoc man groff |
Description (last modified by mf2k (Frank Schima))
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.
Attachments (1)
Change History (12)
Changed 7 years ago by janstary (Jan Starý)
comment:1 Changed 7 years ago by l2dy (Zero King)
| Keywords: | maintainer removed |
|---|
comment:2 Changed 7 years ago by mf2k (Frank Schima)
| Cc: | grimreaper removed |
|---|---|
| Owner: | set to grimreaper |
| Port: | mandoc, man, groff → mandoc man groff |
| Status: | new → assigned |
| Version: | 2.4.99 |
comment:3 Changed 7 years ago by mf2k (Frank Schima)
| Description: | modified (diff) |
|---|
comment:4 Changed 7 years ago by 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.
comment:5 Changed 7 years ago by 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'.
comment:7 Changed 7 years ago by mf2k (Frank Schima)
comment:9 Changed 7 years ago by mf2k (Frank Schima)
comment:10 Changed 7 years ago by mf2k (Frank Schima)
| Resolution: | → fixed |
|---|---|
| Status: | assigned → closed |
comment:11 Changed 7 years ago by janstary (Jan Starý)
This got closed by cherrypicking just the conflict lines. I will continue with this in a Pull Request instead.
sort out the relations between the manpage formaters