On Sat, 18 Apr 2015 16:47:20 +0200 Ingo Schwarze <[email protected]> wrote: > Hi, > > dan mclaughlin wrote on Mon, Apr 13, 2015 at 01:13:16AM -0400: > > > i think i found the perfect places for this in both ports(7) > > and the FAQ. i'm sure the wording can be improved, but diffs below. > > I'd prefer the following way. > > The FAQ is a separate matter. > > OK? > Ingo > > > Index: etc/examples/man.conf > =================================================================== > RCS file: /cvs/src/etc/examples/man.conf,v > retrieving revision 1.2 > diff -u -r1.2 man.conf > --- etc/examples/man.conf 27 Mar 2015 21:17:16 -0000 1.2 > +++ etc/examples/man.conf 18 Apr 2015 14:44:00 -0000 > @@ -1,12 +1,15 @@ > # $OpenBSD: man.conf,v 1.2 2015/03/27 21:17:16 schwarze Exp $ > # man(1)/apropos(1)/makewhatis(8) configuration, see man.conf(5). > # This sample file shows the default settings. > +# Commented lines are suggestions that are not enabled by default. > > # Default search path for manual pages. > # Copy these three lines, then add, delete, or reorder as desired. > +# For example, to work on ports(7), uncomment and add the fourth line. > manpath /usr/share/man > manpath /usr/X11R6/man > manpath /usr/local/man > +#manpath /usr/ports/infrastructure/man > > # Options for terminal output. > output width 78
overall makes sense, but the original 'these three lines' reference seems a little out of place now. > Index: share/man/man7/ports.7 > =================================================================== > RCS file: /cvs/src/share/man/man7/ports.7,v > retrieving revision 1.101 > diff -u -r1.101 ports.7 > --- share/man/man7/ports.7 17 Feb 2015 16:29:16 -0000 1.101 > +++ share/man/man7/ports.7 18 Apr 2015 14:44:00 -0000 > @@ -740,6 +740,15 @@ > .Xr mirroring-ports 7 , > .Xr packages 7 > .Pp > +To get access to additional maintenance tools for the ports tree, add > +.Pa /usr/ports/infrastructure/bin > +to the > +.Ev PATH > +environment variable and add the line > +.Dq Ic manpath Pa /usr/ports/infrastructure/man > +to > +.Xr man.conf 5 . > +.Pp > The > .Ox > Ports System: that's a good spot, an obvious place to look (i often hit 'G' to get to the end looking for such references.)
