From owner-freebsd-doc@FreeBSD.ORG Wed Jun 26 02:23:14 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id EAA89F2A for ; Wed, 26 Jun 2013 02:23:14 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id ADCB3122C for ; Wed, 26 Jun 2013 02:23:14 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r5Q2NDL1069194; Tue, 25 Jun 2013 20:23:13 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r5Q2NDlS069191; Tue, 25 Jun 2013 20:23:13 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 25 Jun 2013 20:23:13 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: Handbook obsolescence scan: "The vinum Volume Manager" In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 25 Jun 2013 20:23:13 -0600 (MDT) Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 26 Jun 2013 02:23:15 -0000 On Tue, 25 Jun 2013, Benjamin Kaduk wrote: > On Tue, 25 Jun 2013, Warren Block wrote: > >> Next on the list of potentially outdated things in the Handbook: "The vinum >> Volume Manager", a whole chapter on vinum. Actually, it is really now >> about gvinum. >> >> Are there any situations where new users should be advised to use gvinum >> rather than ZFS or gconcat/gstripe/gmirror? >> >> What reasons are there for this chapter to remain in the Handbook given the >> newer, simpler alternatives? >> >> If the information should remain, why should it be separate from the GEOM >> chapter? > > Hmm, I seem to recall there being desire to keep the documentation around the > last time this question came up, but don't remember why. Let's go rooting > around in the archives... > > It seems that as of 2009, gvinum was still useful enough that I was happy to > have documentation fixes for it > (http://lists.freebsd.org/pipermail/freebsd-doc/2009-May/015913.html), though > just two weeks later this thread > (http://lists.freebsd.org/pipermail/freebsd-hackers/2009-May/028730.html) > sees to indicate that it was dying already. The documentation is always > behind on the times... > > I thought there was an attempt to remove gvinum or the documentation thereof > since then, but cannot find any record of it. That means we don't get to > re-analyze the arguments presented then, and can just do it. Moving it to an article should cover all the bases. It won't be first-line information in the Handbook, but can still be found. And eventually, if not already, we can have an archive section for obsolete information that may still be useful to someone, somewhere, but not most users.