[prev in list] [next in list] [prev in thread] [next in thread] 

List:       freebsd-doc
Subject:    Re: .Xr references to ports in man pages
From:       Ruslan Ermilov <ru () freebsd ! org>
Date:       2003-04-29 17:35:34
[Download RAW message or body]


On Tue, Apr 29, 2003 at 05:57:04PM +0200, Simon L. Nielsen wrote:
> On 2003.04.28 23:29:15 -0400, Tom Rhodes wrote:
> > On Sat, 26 Apr 2003 14:32:27 +0300
> > Ruslan Ermilov <ru@freebsd.org> wrote:
> > 
> > > Not, it's not OK with others.  Writing a simple script that finds
> > > all port references and checks this with the fresh ports/ tree is
> > > not that hard.  I've been planning on setting the manpages tinder
> > > box; adding this feature to it would be trivial.
> > > 
> > 
> > So, are we going to work on this?  I've got a PR which I'll gladly work
> > on which shows .Xr refs to ports manual pages.  I don't want to just
> > remove the ref, yet I don't want it to stay there either.
> 
> Since nobody has objected to the idea of having ports references I don't
> see why not.
> 
> The isue with categories or not can, as Ruslan noted, be handled by a
> man page tinderbox so I don't think that is a real problem.
> 
> I understood on Ruslan that to add support for this it needs to be added
> to the upstream GNU groff so I don't know how long time it would be
> before port references could be used if it is decided that this is the
> way to go.
> 
This usually takes 2-3 days; I have a well established contact
with the Groff maintainer, and especially on mdoc(7) issues.
FWIW, I'm co-maintaining the mdoc(7) in Groff.


Cheers,
-- 
Ruslan Ermilov		Sysadmin and DBA,
ru@sunbay.com		Sunbay Software AG,
ru@FreeBSD.org		FreeBSD committer,
+380.652.512.251	Simferopol, Ukraine

http://www.FreeBSD.org	The Power To Serve
http://www.oracle.com	Enabling The Information Age

[Attachment #3 (application/pgp-signature)]

[prev in list] [next in list] [prev in thread] [next in thread]