Re: [PATCH v3] btrfs-progs: Doc: Add warning and note on btrfs-convert.

[Duncan <1i5t5.duncan@cox.net>]

Qu Wenruo posted on Fri, 03 Apr 2015 09:21:15 +0800 as excerpted:

> +WARNING: If one hopes to rollback to ext2/3/4, he or she should not execute
> +*btrfs balance* command on converted btrfs.
> +Since it will change the extent layout and make *btrfs-convert* unable to
> +rollback.

Because "since" is subordinating and the sentence doesn't contain what
it is subordinated to as that's explained in the previous sentence,
"Since it will..." introduces a sentence fragment.

Possible correction 1, combine the sentences:  Either simply eliminate
the period following the previous sentence, or convert it to a comma,
either way combining the sentences into one.

Possible correction 2, eliminate the subordinator:  Eliminate "Since"
and begin the second sentence with "A balance..." (replacing "it").

Possible correction 3, reorder and edit, something like this:

+WARNING: Do not execute a *btrfs balance" on a converted btrfs until you
+are sure you will not rollback, as a balance changes the extent layout
+and prevents btrfs-convert from successfully rolling back to ext2/3/4.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman