From owner-svn-doc-head@FreeBSD.ORG Tue Jun 25 00:45:01 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 34465413; Tue, 25 Jun 2013 00:45:01 +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 AE77B18FB; Tue, 25 Jun 2013 00:45:00 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r5P0irlE051084; Mon, 24 Jun 2013 18:44:53 -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 r5P0irqJ051081; Mon, 24 Jun 2013 18:44:53 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 24 Jun 2013 18:44:53 -0600 (MDT) From: Warren Block To: Eitan Adler Subject: Re: svn commit: r41811 - head/en_US.ISO8859-1/books/handbook/basics In-Reply-To: Message-ID: References: <201306011536.r51FaLfP079593@svn.freebsd.org> 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]); Mon, 24 Jun 2013 18:44:53 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Benjamin Kaduk X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Jun 2013 00:45:01 -0000 On Tue, 25 Jun 2013, Eitan Adler wrote: > On Sat, Jun 1, 2013 at 9:55 PM, Benjamin Kaduk wrote: >> On Sat, 1 Jun 2013, Eitan Adler wrote: >> >>> Log: >>> Clarify some language relating to how disks are laid out in &os; >>> >>> Submitted by: crees >>> >>> Modified: head/en_US.ISO8859-1/books/handbook/basics/chapter.xml >>> >>> ============================================================================== >>> --- head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Sat Jun 1 >>> 15:23:47 2013 (r41810) >>> +++ head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Sat Jun 1 >>> 15:36:21 2013 (r41811) >>> @@ -1380,11 +1380,10 @@ root 5211 0.0 0.2 3620 1724 2 >>> >>> >>> >>> - Each partition-that-contains-a-file-system is stored in what >>> - &os; calls a slice. Slice is >>> - &os;'s term for what the common call partitions, and again, >>> - this is because of &os;'s &unix; background. Slices are >>> - numbered, starting at 1, through to 4. >>> + Disks in &os; are divided into slices, referred to in >>> + &windows; as partitions, which are numbered from 1 to 4. These >>> + are then then divided into partitions, which contain file >>> + systems, and are labeled using lettesrs. >> >> >> This seems silently MBR-centric, though we are using GPT by default in our >> installer IIRC... >> This is the "basics" chapter, though, so I'm not sure how best to change >> things (and that would probably end up a larger project). > > I would be happy to see some additional work in this area. I believe > wblock@ is working on the storage area in general. The Storage chapter, yes, but my major changes there are done. For now, anyway. We have several different sections on partitions in different chapters, none really complete. The right way to fix that is to write a complete chapter on disk partitions and just refer to it from other sections rather than repeating information (Don't Repeat Yourself). > That said, I don't have the time for rewriting this section. I have other projects currently. But the Handbook disk information is scattered, redundant, and still manages to be incomplete. This may come to bother me enough that I'll... do something about it.