Date: Thu, 14 May 2020 21:35:28 -0700 From: Benjamin Kaduk <kaduk@mit.edu> To: FreeBSD Docs <freebsd-doc@freebsd.org> Subject: Re: manpages query (net/openntpd) Message-ID: <20200515043528.GY27494@kduck.mit.edu> In-Reply-To: <20200510203203.GA82843@lime.woodcruft.co.uk> References: <20200510203203.GA82843@lime.woodcruft.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, May 10, 2020 at 09:32:03PM +0100, Frank Shute wrote: > > Hi, > > > I installed net/openntpd some time ago. I think I read about it's usage > possibly on OpenBSD's site. Installed it & did the necessary in rc.conf > > The other day I wanted to have a look at the local docs for it as I felt the > need to twiddle with its start up args. As always, I have a look to see what > docs it comes with: > > $ pkg info -l openntpd > > openntpd-6.2p3_2,2: > /usr/local/etc/ntpd.conf.sample > /usr/local/etc/periodic/daily/480.status-openntpd > /usr/local/etc/rc.d/openntpd > /usr/local/man/man5/ntpd.conf.5.gz > /usr/local/man/man8/ntpctl.8.gz > /usr/local/man/man8/ntpd.8.gz > /usr/local/sbin/ntpctl > /usr/local/sbin/ntpd > /usr/local/share/licenses/openntpd-6.2p3_2,2/ISCL > /usr/local/share/licenses/openntpd-6.2p3_2,2/LICENSE > /usr/local/share/licenses/openntpd-6.2p3_2,2/catalog.mk > > Ok. > > $ man ntpd > > Problems. As in front of it in $MANPATH is: > > /usr/share/man/man8/ntpd.8.gz > > and all the other manpages for ntpd from base. > > I happened to realise what was happening, so I could have a look at man(1) > and: > > $ man -M /usr/local/man: ntpd > > so as to display the port manpage rather than the one installed by base. > > This seems to be a POLA violation and I was wondering how, if at all, it > should be handled. A pkg message or rename the binaries or something else? I think a proper solution would be pkgbase, where installing the ntpd from ports could cause the one from base to be removed. Until then, I suppose that MANPATH and PATH should stay in sync, but it may be worth adding a note to the pkg-message. I believe it would be okay to create a bugzilla entry (https://bugs.freebsd.org/bugzilla/enter_bug.cgi) against the port requesting this enhancement. Thanks for raising the question, Ben
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20200515043528.GY27494>