0043-docs-Improve-partition-description-in-parted.texi.patch

   1 From 22a2fd360f5f0f8e7e522712a6187b1c6ac74ba7 Mon Sep 17 00:00:00 2001
   2 From: Gareth Randall <gareth.randall@virgin.net>
   3 Date: Fri, 30 Sep 2016 10:07:42 -0700
   4 Subject: [PATCH 43/53] docs: Improve partition description in parted.texi
   5
   6 (cherry picked from commit e27ac8ff6706f67817f68246311899bd920b9c88)
   7 ---
   8  doc/parted.texi | 36 +++++++++++++++++++++++++++++++-----
   9  1 file changed, 31 insertions(+), 5 deletions(-)
  10
  11 diff --git a/doc/parted.texi b/doc/parted.texi
  12 index 1b9c084..414179d 100644
  13 --- a/doc/parted.texi
  14 +++ b/doc/parted.texi
  15 @@ -291,12 +291,38 @@ or you want to modify a root or boot partition, use GParted Live:
  16  @section Introduction to Partitioning
  17  @cindex partitioning overview
  18
  19 -Unfortunately, partitioning your disk is rather complicated.  This is
  20 -because there are interactions between many different systems that need
  21 -to be taken into consideration.
  22 +Partitioning is the process of dividing a storage device into local
  23 +sections, called partitions, which help organize multiple filesystems
  24 +and their associated operating systems.
  25 +
  26 +A storage device presents itself as a sequence of bytes, numbered
  27 +starting from zero and increasing until the maximum capacity of the
  28 +device is reached. Bytes are normally read and written a sector at a
  29 +time, rather than individually. Each sector contains a fixed number
  30 +of bytes, with the number determined by the device.
  31 +
  32 +@example
  33 ++------------------------------------------------------------+
  34 +|            storage device with no partitions               |
  35 ++------------------------------------------------------------+
  36 +0 start                                                    end
  37 +@end example
  38 +
  39 +In order to store multiple filesystems, a storage device can be divided
  40 +up in to multiple partitions. Each partition can be thought of as an
  41 +area which contains a real filesystem inside of it. To show where these
  42 +partitions are on the device a small table is written at the start,
  43 +shown as PT in the diagram below. This table is called a partition
  44 +table, or disklabel, and also stores the type of each partition and
  45 +some flags.
  46 +
  47 +@example
  48 ++--+---------------+----------------+------------------------+
  49 +|PT|  Partition 1  |  Partition 2   |  Partition 3           |
  50 ++--+---------------+----------------+------------------------+
  51 +0 start                                                    end
  52 +@end example
  53
  54 -This manual used to introduce the reader to these systems and their
  55 -working.  This content has moved to the GNU Storage Guide.
  56
  57  @node Running Parted
  58  @section Using GNU Parted
  59 --
  60 2.7.4
  61