block: Document blockdev-add's immaturity

Signed-off-by: Markus Armbruster <[email protected]>
Reviewed-by: Eric Blake <[email protected]>
Message-id: 1426858337[email protected]
Signed-off-by: Stefan Hajnoczi <[email protected]>

diff --git a/qapi/block-core.json b/qapi/block-core.json
index f525b04355edae482944c8a492aeb02d5ff39c0f..78730846c24b4e88c3b9306d44e4bcd2e2193ef7 100644 (file)
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -1721,6 +1721,10 @@
 #
 # Creates a new block device.
 #
+# This command is still a work in progress.  It doesn't support all
+# block drivers, it lacks a matching blockdev-del, and more.  Stay
+# away from it unless you want to help with its development.
+#
 # @options: block device options for the new device
 #
 # Since: 1.7

diff --git a/qmp-commands.hx b/qmp-commands.hx
index 7f6876077b6d4b72deabe1910d7379beb2baf793..3a42ad0bffeb23778f877410f6e2038943da46c0 100644 (file)
--- a/qmp-commands.hx
+++ b/qmp-commands.hx
@@ -3636,6 +3636,10 @@ blockdev-add
 
 Add a block device.
 
+This command is still a work in progress.  It doesn't support all
+block drivers, it lacks a matching blockdev-del, and more.  Stay away
+from it unless you want to help with its development.
+
 Arguments:
 
 - "options": block driver options