Blame SOURCES/0043-docs-Improve-partition-description-in-parted.texi.patch

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