Date: Mon, 24 Mar 2003 22:30:04 +0100 From: Christian Brueffer <chris@unixpages.org> To: Ruslan Ermilov <ru@FreeBSD.ORG> Cc: Jarkko Santala <jake@iki.fi>, Kevin Oberman <oberman@es.net>, Poul-Henning Kamp <phk@phk.freebsd.dk>, current@FreeBSD.ORG Subject: Re: MAKEDEV(8) manpage Message-ID: <20030324213003.GC36490@unixpages.org> In-Reply-To: <20030324210352.GB99926@sunbay.com> References: <20030324133457.GR36490@unixpages.org> <20030324171215.7DBD85D07@ptavv.es.net> <20030324181450.GU36490@unixpages.org> <20030324202245.D401@trillian.santala.org> <20030324210352.GB99926@sunbay.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--2VcK7Ezgm4IMdfSa Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Mar 24, 2003 at 11:03:52PM +0200, Ruslan Ermilov wrote: > On Mon, Mar 24, 2003 at 08:29:59PM +0200, Jarkko Santala wrote: > > On Mon, 24 Mar 2003, Christian Brueffer wrote: > >=20 > > > On Mon, Mar 24, 2003 at 09:12:15AM -0800, Kevin Oberman wrote: > > > > > Date: Mon, 24 Mar 2003 14:34:57 +0100 > > > > > From: Christian Brueffer <chris@unixpages.org> > > > > > Sender: owner-freebsd-current@FreeBSD.ORG > > > > > > > > > > On Mon, Mar 24, 2003 at 09:40:32AM +0200, Jarkko Santala wrote: > > > > > > On Sun, 23 Mar 2003, Poul-Henning Kamp wrote: > > > > > > > > > > > > > In message <20030323143507.GG36490@unixpages.org>, Christian = Brueffer w=3D > > > > > rites: > > > > > > > >now that MAKEDEV has been gone for a while, the manpages (al= pha and i3=3D > > > > > 86) > > > > > > > >can be nuked as well, right? > > > > > > > > > > > > > > Right. > > > > > > > > > > > > Although it might be considered dragging old baggage around, wo= uld it > > > > > > make sense to instead of zapping the man page completely write = a new one > > > > > > that would at least give a clue on how things are done these da= ys? > > > > > > > > > > > > Otherwise unclued people might just think there's something wro= ng with > > > > > > their system because the man page is missing and get even more = confused. > > > > > > > > > > Well, people are supposed to read UPDATING before updating the sy= stem. > > > > > UPDATING already has an entry about this, so has the handbook, the > > > > > release notes etc. > > > > > > > > > > I think we can't really help people that don't read the recommend= ed > > > > > documentation. > > > > > > > > I think POLA should apply to things like this (even across major > > > > releases). MAKEDEV has been around for a long time and most folks a= re > > > > used to it being there. It's simply something that most people assu= me > > > > will be there on a Unix-like system. > > > > > > > > Yes, people should read UPDATING and, better still, the release > > > > notes. But taking the added step of having a simple man page with a > > > > pointer to the devfs paper and saying that MAKEDEV is no more there= will > > > > avoid a lot of confusion. > > > > > > > > The goal of documentation should not be to make it possible for > > > > sophisticated users to use the system. It should make it as > > > > easy as possible for all levels of users, including those new to Un= ix > > > > and BSD to use the system. > > > > > > I'll write a small manpage this evening which says that MAKEDEV is go= ne now > > > with a short summary of what devfs does. > > > Does that resolve your worries? > >=20 > > Exactly what I had in mind, so sounds good to me. ;) You probably want = to > > make it as generic as possible, so that keeping it up-to-date doesn't > > become a burden in the future. I'd hate to create any extra maintenance > > work to anyone, no matter how small. > >=20 > I'd rather just MLINK mount_devfs(8) to MAKEDEV(8) for the > time being, say until 5.2 is out, like is the case for > vnconfig(8). >=20 Also good. devfs(5) would be a better choice then, mount_devfs(8) is just an MLINK to mount_std. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --2VcK7Ezgm4IMdfSa Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+f3jbbHYXjKDtmC0RAmRiAKClcURxLMbMAXNq92FKjZ37k8RRuACdFZhV nP/W3LNtHBMffnTggVLGcoQ= =XZnU -----END PGP SIGNATURE----- --2VcK7Ezgm4IMdfSa-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030324213003.GC36490>