[MacPorts] #53902: manpage formatters

classic Classic list List threaded Threaded
13 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

[MacPorts] #53902: manpage formatters

MacPorts
#53902: manpage formatters
---------------------------------+--------------------------------
 Reporter:  janstary             |      Owner:
     Type:  enhancement          |     Status:  new
 Priority:  Normal               |  Milestone:
Component:  ports                |    Version:  2.4.99
 Keywords:  haspatch maintainer  |       Port:  mandoc, man, groff
---------------------------------+--------------------------------
 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.

--
Ticket URL: <https://trac.macports.org/ticket/53902>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
#53902: manpage formatters
---------------------------------+---------------------------------
  Reporter:  janstary            |      Owner:
      Type:  enhancement         |     Status:  new
  Priority:  Normal              |  Milestone:
 Component:  ports               |    Version:  2.4.99
Resolution:                      |   Keywords:  haspatch maintainer
      Port:  mandoc, man, groff  |
---------------------------------+---------------------------------
Changes (by janstary):

 * Attachment "man.diff" added.

 sort out the relations between the manpage formaters

--
Ticket URL: <https://trac.macports.org/ticket/53902>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by MacPorts
#53902: manpage formatters
---------------------------------+----------------------
  Reporter:  janstary            |      Owner:
      Type:  enhancement         |     Status:  new
  Priority:  Normal              |  Milestone:
 Component:  ports               |    Version:  2.4.99
Resolution:                      |   Keywords:  haspatch
      Port:  mandoc, man, groff  |
---------------------------------+----------------------
Changes (by l2dy):

 * keywords:  haspatch maintainer => haspatch


--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:1>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------
Changes (by mf2k):

 * owner:   => grimreaper
 * cc: grimreaper (removed)
 * version:  2.4.99 =>
 * status:  new => assigned
 * port:  mandoc, man, groff => mandoc man groff


--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:2>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by janstary):

 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.

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:4>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by janstary):

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

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:5>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by janstary):

 Eitan agrees. Can we remove mdocml please?

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:6>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by mf2k):

 In [changeset:"3869e56cc8dea97211841d845aade4c0a02299fb/macports-ports"
 3869e56cc8dea97211841d845aade4c0a02299fb/macports-ports]:
 {{{
 #!ConfigurableCommitTicketReference repository="macports-ports"
 revision="3869e56cc8dea97211841d845aade4c0a02299fb"
 mdocml:
  - Replaced by duplicate port mandoc

 See: https://trac.macports.org/ticket/53902
 }}}

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:7>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by mf2k):

 So is this patch good to be committed as is?

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:8>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by 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  |
-------------------------------+------------------------

Comment (by mf2k):

 In [changeset:"945ccc0cc955a8843bacc3185d36f963f9941036/macports-ports"
 945ccc0cc955a8843bacc3185d36f963f9941036/macports-ports]:
 {{{
 #!ConfigurableCommitTicketReference repository="macports-ports"
 revision="945ccc0cc955a8843bacc3185d36f963f9941036"
 mdocml:
  - Use obsolete 1.0 portgroup

 See: https://trac.macports.org/ticket/53902
 }}}

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:9>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by MacPorts
#53902: manpage formatters
-------------------------------+------------------------
  Reporter:  janstary          |      Owner:  grimreaper
      Type:  enhancement       |     Status:  closed
  Priority:  Normal            |  Milestone:
 Component:  ports             |    Version:
Resolution:  fixed             |   Keywords:  haspatch
      Port:  mandoc man groff  |
-------------------------------+------------------------
Changes (by mf2k):

 * status:  assigned => closed
 * resolution:   => fixed


Comment:

 In [changeset:"f4b3ca56da01f0670e37c4b339f81348b62e952b/macports-ports"
 f4b3ca56da01f0670e37c4b339f81348b62e952b/macports-ports]:
 {{{
 #!ConfigurableCommitTicketReference repository="macports-ports"
 revision="f4b3ca56da01f0670e37c4b339f81348b62e952b"
 mandoc man groff: Update conflicts between them.
  - mandoc: remove a pointless -nonewline
  - mandoc: put CC before CFLAGS and LDFLAGS

 Fixes: https://trac.macports.org/ticket/53902
 }}}

--
Ticket URL: <https://trac.macports.org/ticket/53902#comment:10>
MacPorts <https://www.macports.org/>
Ports system for macOS
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [MacPorts] #53902: manpage formatters

MacPorts
In reply to this post by MacPorts
#53902: manpage formatters
-------------------------------+------------------------
  Reporter:  janstary          |      Owner:  grimreaper
      Type:  enhancement       |     Status:  closed
  Priority:  Normal            |  Milestone:
 Component:  ports             |    Version:
Resolution:  fixed             |   Keywords:  haspatch
      Port:  mandoc man groff  |
-------------------------------+------------------------

Comment (by janstary):

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

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