Date: Mon, 3 Mar 2003 11:21:51 -0500 From: Mike Barcroft <mike@FreeBSD.org> To: "Andrey A. Chernov" <ache@nagual.pp.ru> Cc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/lib/libutil login.conf.5 Message-ID: <20030303112151.E49156@espresso.bsdmike.org> In-Reply-To: <20030303130643.GA25214@nagual.pp.ru>; from ache@nagual.pp.ru on Mon, Mar 03, 2003 at 04:06:43PM %2B0300 References: <200303030509.h2359Ofb036507@repoman.freebsd.org> <20030303095422.GA20923@nagual.pp.ru> <20030303101518.GA8214@HAL9000.homeunix.com> <20030303103819.GA22044@nagual.pp.ru> <20030303115011.GA8705@HAL9000.homeunix.com> <20030303120707.GA24280@nagual.pp.ru> <20030303122609.GA9305@HAL9000.homeunix.com> <20030303130643.GA25214@nagual.pp.ru>
next in thread | previous in thread | raw e-mail | index | archive | help
Andrey A. Chernov <ache@nagual.pp.ru> writes: > On Mon, Mar 03, 2003 at 04:26:09 -0800, David Schultz wrote: > > > Look at usr.bin/passwd/Makefile,v 1.45 and the subsequent commit > > that removed usr.bin/passwd/local_passwd.c. > > It is removing from the utility, not from the library. All it means that > this utility not relay on this library feature anymore. It not means that > this future should be removed from the library too, because _other_ > (f.e. non-base) utilities may relay on that feature. > > > Aah, this is a separate issue. The other items I removed are not > > implemented, and they never have been implemented since the > > creation of the login.conf manpage six years ago. A little while > > ago, I was thinking about writing a daemon to enforce some > > accounting limits. If I ever get around to writing one and manage > > to get it integrated into the base system, I will be sure to > > document it in the appropriate place. > > > > FWIW, ports/sysutils/blimitd adds support for one of these > > options, but I think the general consensus is that system manpages > > should not document third-party utilities. > > We need to clarify what "implemented" term means relating to that items > (including minpassword*). For them LOGIN_CAP library are merely > placeholder, like termcap database, i.e. they not means to be implemeted > somehow in the library code, but utilities get them to obtain their values > and set limits by itself. Like in termcap, their commonly used names are > documented in single centralized place. Other way you try to implement > will cause each utility will invent its own name, and all of them, > duplicating and probably conflicting with each other, will pollute > /etc/login.conf If we do this, we need to say "(Not supported by any base system utilities.)" next to each unsupported option. Otherwise you get users that are confused about login.conf not working as expected on their systems. There's also the problem that third-party software can add extentions that will always be undocumented by the base-system manual. I'm not sure how you'd propose we handle that one. What David was trying to do was shift the burden of documentation on to third-party software. I was a bit concerned that this change would be contentious and asked David to take the extra step of getting this reviewed by -doc. Best regards, Mike Barcroft To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-src" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030303112151.E49156>