From c8ba0bfb01cfd7e75461de13ed6e04343c061847 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9=20Iv=C3=A1n=20L=C3=B3pez=20Gonz=C3=A1lez?= Date: Fri, 20 Nov 2020 09:24:01 +0000 Subject: [PATCH] Improve doc --- doc/btrfs-subvolumes.md | 6 +++--- src/lib/y2storage/shadower.rb | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/btrfs-subvolumes.md b/doc/btrfs-subvolumes.md index 2ebdaac98c..2f89fc4e2c 100644 --- a/doc/btrfs-subvolumes.md +++ b/doc/btrfs-subvolumes.md @@ -37,10 +37,10 @@ The list of subvolumes for a BtrFS file system can be configured by means of the This configuration of subvolumes is taken into accout by the Storage Proposal when calculating the partitioning proposal. But it also affects to the Expert Partitioner, see *Expert Partitioner* section. -Note that there is a `btrfs_default_subvolume` option. This option allows to configure a kind of "prefix" subvolume, and it has some implications over the rest of subvolumes: +Note that there is a *btrfs_default_subvolume* option. This option allows to configure a kind of "prefix" subvolume, and it may end up being the real default subvolume or not. For example, when using snapshots, the default subvolume is a snapshot subvolume instead of this one. The *btrfs_default_subvolume* has some implications over the rest of subvolumes: -* All the subvolumes are created as children of the default one. -* The path of the default subvolume is prepended to the path of all the other subvolumes. +* All the subvolumes are created as children of the *btrfs_default_subvolume*. +* The path of the *btrfs_default_subvolume* is prepended to the path of all the other subvolumes. When the storage proposal is calculated during the installation, all the BtrFS file systems are configured to contain the list of subvolumes indicated in the control file. Note that the list of subvolumes can be defined for all the volumes formatted as BtrFS and not only for root. In the very specific case of root, the Storage Proposal will use a fallback list of subvolumes when nothing is indicated in the control file. The list of subvolumes can always be manually adapted by means of the Expert Partitioner. diff --git a/src/lib/y2storage/shadower.rb b/src/lib/y2storage/shadower.rb index 57abff8f08..99d1238baa 100644 --- a/src/lib/y2storage/shadower.rb +++ b/src/lib/y2storage/shadower.rb @@ -25,8 +25,8 @@ module Y2Storage # # This class is used to automatically shadow Btrfs Subvolumes. In some cases, Btrfs subvolumes are # automatically added when creating a Btrfs. Those subvolumes should also be automatically hidden when - # other device shadows them. Moreover, subvolumes added by the user should be automatically mounted or - # unmounted depending on whether they are shadowed or not. + # other device shadows them. Moreover, subvolumes that already exist on disk or manually added by the + # user should be automatically mounted or unmounted depending on whether they are shadowed or not. class Shadower # Constructor #