[MacPorts] #53902: manpage formatters

[MacPorts]

#53902: manpage formatters
-------------------------------+------------------------
  Reporter:  janstary          |      Owner:  grimreaper
      Type:  enhancement       |     Status:  assigned
  Priority:  Normal            |  Milestone:
 Component:  ports             |    Version:
Resolution:                    |   Keywords:  haspatch
      Port:  mandoc man groff  |
-------------------------------+------------------------
Description changed by mf2k:

Old description:

> 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 https://trac.macports.org/ticket/53887
> and https://trac.macports.org/ticket/53898
> probably need to go in before this.
> At least the diff is based on top of those.

New description:

 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.

--

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:3>
MacPorts <https://www.macports.org/>
Ports system for macOS