svn commit: r41811 - head/en_US.ISO8859-1/books/handbook/basics

[Warren Block]

On Tue, 25 Jun 2013, Eitan Adler wrote:

> On Sat, Jun 1, 2013 at 9:55 PM, Benjamin Kaduk <kaduk at 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.