[parted-devel] [PATCH] doc: Improve section 2.1 and remove reference to missing GNU Storage Guide.
Gareth Randall
gareth.randall at virgin.net
Wed Apr 13 07:46:34 UTC 2016
Hi,
I just wondered whether you'd had a chance to consider committing this
documentation update, while the list is busy :-)
While
Yours,
Gareth
On 11/11/2015 11:15, Gareth Randall wrote:
> On 11/11/2015 00:38, Brian C. Lane wrote:
>
>> If you are going to mention resources you should include links.
>
> Good point. I think it's best not to since links will go out of date and
> users will be competent enough to look them up.
>
>> Thanks for helping improve the docs,
>>
>> Brian
>
> Thanks for some very nice feedback points.
>
> I've updated the patch below to incorporate your suggestions:
>
>
> diff --git a/doc/parted.texi b/doc/parted.texi
> index cb12e8d..060f3d4 100644
> --- a/doc/parted.texi
> +++ b/doc/parted.texi
> @@ -291,12 +291,38 @@ or you want to modify a root or boot partition,
> use GParted Live:
> @section Introduction to Partitioning
> @cindex partitioning overview
>
> -Unfortunately, partitioning your disk is rather complicated. This is
> -because there are interactions between many different systems that need
> -to be taken into consideration.
> +Partitioning is the process of dividing a storage device into local
> +sections, called partitions, which help organize multiple filesystems
> +and their associated operating systems.
> +
> +A storage device presents itself as a sequence of bytes, numbered
> +starting from zero and increasing until the maximum capacity of the
> +device is reached. Bytes are normally read and written a sector at a
> +time, rather than individually. Each sector contains a fixed number
> +of bytes, with the number determined by the device.
> +
> + at example
> ++------------------------------------------------------------+
> +| storage device with no partitions |
> ++------------------------------------------------------------+
> +0 start end
> + at end example
> +
> +In order to store multiple filesystems, a storage device can be divided
> +up in to multiple partitions. Each partition can be thought of as an
> +area which contains a real filesystem inside of it. To show where these
> +partitions are on the device a small table is written at the start,
> +shown as PT in the diagram below. This table is called a partition
> +table, or disklabel, and also stores the type of each partition and
> +some flags.
> +
> + at example
> ++--+---------------+----------------+------------------------+
> +|PT| Partition 1 | Partition 2 | Partition 3 |
> ++--+---------------+----------------+------------------------+
> +0 start end
> + at end example
>
> -This manual used to introduce the reader to these systems and their
> -working. This content has moved to the GNU Storage Guide.
>
> @node Running Parted
> @section Using GNU Parted
>
>
>
More information about the parted-devel
mailing list