From owner-freebsd-current@FreeBSD.ORG Fri Oct 19 16:11:32 2012 Return-Path: Delivered-To: current@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 91D5DD0E for ; Fri, 19 Oct 2012 16:11:32 +0000 (UTC) (envelope-from kostikbel@gmail.com) Received: from mail.zoral.com.ua (mx0.zoral.com.ua [91.193.166.200]) by mx1.freebsd.org (Postfix) with ESMTP id 09F8E8FC16 for ; Fri, 19 Oct 2012 16:11:31 +0000 (UTC) Received: from skuns.kiev.zoral.com.ua (localhost [127.0.0.1]) by mail.zoral.com.ua (8.14.2/8.14.2) with ESMTP id q9JGBagB054308 for ; Fri, 19 Oct 2012 19:11:36 +0300 (EEST) (envelope-from kostikbel@gmail.com) Received: from deviant.kiev.zoral.com.ua (kostik@localhost [127.0.0.1]) by deviant.kiev.zoral.com.ua (8.14.5/8.14.5) with ESMTP id q9JGBOQv020260 for ; Fri, 19 Oct 2012 19:11:24 +0300 (EEST) (envelope-from kostikbel@gmail.com) Received: (from kostik@localhost) by deviant.kiev.zoral.com.ua (8.14.5/8.14.5/Submit) id q9JGBOoU020259 for current@FreeBSD.org; Fri, 19 Oct 2012 19:11:24 +0300 (EEST) (envelope-from kostikbel@gmail.com) X-Authentication-Warning: deviant.kiev.zoral.com.ua: kostik set sender to kostikbel@gmail.com using -f Date: Fri, 19 Oct 2012 19:11:24 +0300 From: Konstantin Belousov To: current@FreeBSD.org Subject: Re: RFC: removal of share/doc/{papers,psd,smm,usd} in 2 months Message-ID: <20121019161124.GZ35915@deviant.kiev.zoral.com.ua> References: <20121019143617.GF69724@acme.spoerlein.net> <20121019155542.GQ1967@funkthat.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="8BV2nTfVFGsA18NK" Content-Disposition: inline In-Reply-To: <20121019155542.GQ1967@funkthat.com> User-Agent: Mutt/1.5.21 (2010-09-15) X-Virus-Scanned: clamav-milter 0.95.2 at skuns.kiev.zoral.com.ua X-Virus-Status: Clean X-Spam-Status: No, score=-4.0 required=5.0 tests=ALL_TRUSTED,AWL,BAYES_00 autolearn=ham version=3.2.5 X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on skuns.kiev.zoral.com.ua X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Oct 2012 16:11:32 -0000 --8BV2nTfVFGsA18NK Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Oct 19, 2012 at 08:55:42AM -0700, John-Mark Gurney wrote: > Ulrich Sprlein wrote this message on Fri, Oct 19, 2012 at 16:36 +0200: > > those roff sources have been very naughty and will be removed from the > > tree by the end of the year. Most of those papers are severely out of > > date and provide no more use to the system. They can probably also be > > found online using a search engine of your choice. > >=20 > > Should people feel strongly about them, we might be able to move them > > over to the doc repository. >=20 > One paper that should definately be saved is the vi docs. The man page > is just a reference, but the paper on vi contains useful information > that the man page doesn't cover... >=20 > One good example is that the man page only has very short descriptions > of all the options... The paper has a complete description of what > the options do... >=20 > I guess the real bug is that we've been installing these, but never > referencing them, or telling users where they could find them... I.e. > in man vi: > ``An Introduction to Display Editing with Vi'', found in the `= `UNIX > User's Manual Supplementary Documents'' section of both the 4.3BSD= and > 4.4BSD manual sets. This document is the closest thing available = to an > introduction to the vi screen editor. >=20 > refers to usd/12.vi/paper.ascii.gz, but no reader of the man page would > know that... Same w/ the other docs in the same section.. I'm not sure > many users would think to go man hier to see where they are located, or > even know that they might be distributed w/ FreeBSD... >=20 > I think the same thing applies foo memacros and others too... That the > man page provides a short reference, and that these provide a more > detailed description of what is happening... >=20 > Are we installing doc by default? If we reference these papers in the > man pages, and a user chooses not to install doc when they first install > the system, how hard would it be for the user to install the docs? Can > they run a simple command to get the docs installed? Maybe having a > README in /usr/share/doc explaining that they are now part of the doc > repo, and needs to be installed if they aren't part of the baes install.. >=20 > Some papers I can see go, like psd/06.Clang... Heck, it doesn't even > cover C89!?! :) >=20 > I'm fine w/ cleaning it up, just not wholesale removal... And e.g. sendmail documentation is fresh and updated together with sendmail imports, AFAIR. fsck/ffs/quotas is more or less relevant even today. --8BV2nTfVFGsA18NK Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (FreeBSD) iEYEARECAAYFAlCBe6wACgkQC3+MBN1Mb4haEwCfReUH2H06+kny+WcRl3rWTMTe r+YAoIFB3O7kWAoYPy8oQEWtmGtM5Rih =zq2b -----END PGP SIGNATURE----- --8BV2nTfVFGsA18NK--