1 files changed, 18 insertions, 5 deletions
diff --git a/upstream/mageia-cauldron/man8/mkfs.btrfs.8 b/upstream/mageia-cauldron/man8/mkfs.btrfs.8
index 7bc9f86d..1aff6876 100644
--- a/upstream/mageia-cauldron/man8/mkfs.btrfs.8
+++ b/upstream/mageia-cauldron/man8/mkfs.btrfs.8
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "MKFS.BTRFS" "8" "Jan 09, 2024" "6.6.3" "BTRFS"
+.TH "MKFS.BTRFS" "8" "Mar 10, 2024" "6.7.1" "BTRFS"
 .SH NAME
 mkfs.btrfs \- create a btrfs filesystem
 .SH SYNOPSIS
@@ -163,10 +163,23 @@ Versions up to 3.11 set the nodesize to 4KiB.
 .B \-s|\-\-sectorsize <size>
 Specify the sectorsize, the minimum data block allocation unit.
 .sp
-The default value is the page size and is autodetected. If the sectorsize
-differs from the page size, the created filesystem may not be mountable by the
-running kernel. Therefore it is not recommended to use this option unless you
-are going to mount it on a system with the appropriate page size.
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+Versions prior to 6.7 set the sectorsize matching the host CPU
+page size, starting in 6.7 this is 4KiB for cross\-architecture
+compatibility. Please read more about the \fI\%subpage block size support\fP
+and \fI\%its status\fP\&.
+.UNINDENT
+.UNINDENT
+.sp
+By default, the value is 4KiB, but it can be manually set to match the
+system page size (e.g. using command \fBgetconf PAGE_SIZE\fP).
+However, if the sector size is different from the page
+size, the resulting filesystem may not be mountable by the current
+kernel, apart from the default 4KiB. Hence, using this option is not
+advised unless you intend to mount it on a system with the suitable
+page size.
 .TP
 .B \-L|\-\-label <string>
 Specify a label for the filesystem. The \fIstring\fP should be less than 256