btrfs-progs: docs: clarify potential problems with convert

Add a note summarizing the problems. [ci skip] Issue: #257 Signed-off-by: David Sterba <[email protected]>
kdave · Feb 20, 2024 · f5db48e · f5db48e
1 parent 93cdc1c
commit f5db48e
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/Documentation/ch-convert-intro.rst b/Documentation/ch-convert-intro.rst
@@ -33,6 +33,13 @@ have a supported data block size (i.e. the same that would be valid for
 :command:`mkfs.btrfs`). This is typically the system page size (4KiB on x86_64
 machines).
 
+.. note::
+
+   Always consider if a mkfs and file copy would not be a better option than
+   the in-place conversion given what was said above. The conversion depends on
+   3rd party libraries and the other filesystems could still evolve and add new
+   features. Not all combinations are covered or tested.
+
 **BEFORE YOU START**
 
 The source filesystem must be clean, e.g. no journal to replay or no repairs