Re: Fixing catman pages

[Jonathan Perkin <jperkin%joyent.com@localhost>]

* On 2013-09-08 at 03:23 BST, OBATA Akio wrote:

> On Sat, 07 Sep 2013 23:29:34 +0900, Jonathan Perkin 
> <jperkin%joyent.com@localhost> wrote:
> 
> >* On 2013-09-07 at 12:43 BST, OBATA Akio wrote:
> >
> >>On Fri, 06 Sep 2013 21:35:28 +0900, Jonathan Perkin 
> >><jperkin%joyent.com@localhost> wrote:
> >>
> >>> #1: Use mdocml as the tool replacement for nroff.
> >>> =================================================
> >>>
> >>>  Some packages which generate catman pages ('pkgin', for example) add
> >>>  a USE_TOOLS dependency on nroff, which currently will pull in groff.
> >>>
> >>>  Whilst this works, it is not ideal as groff has many dependencies,
> >>>  and when adding catman support to e.g. devel/tradcpp we run into
> >>>  circular dependency issues.
> >>>
> >>>  To fix this, two changesets are required.  First, allow mdocml and
> >>>  groff to co-exist, so that 'USE_TOOLS= groff nroff' will work
> >>>  correctly.  This involves renaming some of mdocml's files:
> >>>
> >>>    
> >>> https://github.com/joyent/pkgsrc/commit/1e43db1ed16b8d232001ec68f237a791afdff473
> >>>
> >>>  Secondly, use mdocml for USE_TOOLS=nroff:
> >>>
> >>>    
> >>> https://github.com/joyent/pkgsrc/commit/de6ecbe53c452369475e9058542666bee864c3f2
> >>>
> >>>  This should have benefits regardless of catman issues, as mdocml is
> >>>  much smaller than groff and is BSD licensed.
> >>
> >>How about change to install nroff from groff as `gnroff' instead,
> >>same as other GNU packages?
> >
> >What would be the benefit of that?  That would be out of scope for the
> >changes I've proposed, so I'd rather see that discussed separately if
> >there is a reason for doing so.
> 
> Because your change means that nroff from mdocml is the default nroff in 
> pkgsrc,
> so I feel that nroff from mdocml should be kept as `nroff' and nroff from 
> groff
> should be renamed instead.

There is no 'nroff' from mdocml.  The utility is called 'mandoc', and
the tools infrastructure creates an nroff symlink to that.

> `gnroff' is found in pkgsrc/mk/tools/tools.SunOS.mk, so isn't it so
> specal naming?

That's just the GNU version present in some SunOS 5.11 distributions,
the 'nroff' on those systems is still the old SYSV one.

-- 
Jonathan Perkin  -  Joyent, Inc.  -  www.joyent.com