doc: Document the NBFT API

Added an explicit note about unstable API, that is in fact
semi-unstable whereas existing structures are stable and
new API will possibly be added at the end of the structs.

Signed-off-by: Tomas Bzatek <tbzatek@redhat.com>

diff --git a/doc/api.rst.in b/doc/api.rst.in
index 34787661ecbc68a6e303b0e15134063ee59e914b..57188f63c072a27574e1d3ba7ef78b2d70aa8ef4 100644 (file)
--- a/doc/api.rst.in
+++ b/doc/api.rst.in
@@ -16,3 +16,4 @@ functions.
 .. include::   rst/filters.rst
 .. include::   rst/util.rst
 .. include::   rst/log.rst
+.. include::   rst/nbft.rst

diff --git a/src/nvme/nbft.h b/src/nvme/nbft.h
index 6012e160819c72730f10a49d439a0bd8a20f8cfd..48aaecf420fa4f219fbcf7548a057fac03075591 100644 (file)
--- a/src/nvme/nbft.h
+++ b/src/nvme/nbft.h
@@ -12,6 +12,14 @@
 #include <sys/types.h>
 #include "util.h"
 
+/**
+ * DOC: nbft.h
+ *
+ * NVM Express Boot Specification, Revision 1.0
+ *
+ * Note: this API is currently unstable, subject to further additions.
+ */
+
 /*
  *  ACPI NBFT table structures (TP8012 Boot Specification rev. 1.0)
  */