Date: Mon, 24 Jun 2013 18:44:53 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Eitan Adler <eadler@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r41811 - head/en_US.ISO8859-1/books/handbook/basics Message-ID: <alpine.BSF.2.00.1306241802370.50796@wonkity.com> In-Reply-To: <CAF6rxgn5%2BeCMmBvS5RnEZ-r702o0nSurpXxo6iCaD0Nn5uZRQA@mail.gmail.com> References: <201306011536.r51FaLfP079593@svn.freebsd.org> <alpine.GSO.1.10.1306011552570.9389@multics.mit.edu> <CAF6rxgn5%2BeCMmBvS5RnEZ-r702o0nSurpXxo6iCaD0Nn5uZRQA@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 25 Jun 2013, Eitan Adler wrote: > On Sat, Jun 1, 2013 at 9:55 PM, Benjamin Kaduk <kaduk@mit.edu> 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 >>> </tgroup> >>> </informaltable> >>> >>> - <para>Each partition-that-contains-a-file-system is stored in what >>> - &os; calls a <firstterm>slice</firstterm>. 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.</para> >>> + <para>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.</para> >> >> >> 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1306241802370.50796>