mkcephfs: note that btrfs (and --mkbtrfs) are optional and experimental

And that --mkbtrfs will be deprecated soon.

Signed-off-by: Sage Weil <sage.weil@dreamhost.com>

diff --git a/doc/man/8/mkcephfs.rst b/doc/man/8/mkcephfs.rst
index 2868307d2ed1ba6c4407f2aef11c620ce0fef8a2..23f980abff7d1739471ff653c4157087e39bce08 100644 (file)
--- a/doc/man/8/mkcephfs.rst
+++ b/doc/man/8/mkcephfs.rst
@@ -77,6 +77,14 @@ Options
    and (if it differs from "osd data") "btrfs path" options must be
    defined.
 
+   **NOTE** Btrfs is still considered experimental.  This option
+   can ease some configuration pain, but is the use of btrfs is not
+   required when ``osd data`` directories are mounted manually by the
+   adminstrator.
+
+   **NOTE** This option is deprecated and will be removed in a future
+   release.
+
 .. option:: --no-copy-conf
 
    By default, mkcephfs with -a will copy the new configuration to