Grouping same methods under one subsection
Change-Id: I8915435632d5a92cabe6cf5335146729507ab6e5
diff --git a/blob.rst b/blob.rst
index 52c730a..8867d3d 100644
--- a/blob.rst
+++ b/blob.rst
@@ -12,8 +12,11 @@
A Blob holds a pointer to an immutable byte array implemented as const std::vector<uint8_t>. This is like a JavaScript string which is a pointer to an immutable string. It is OK to pass a pointer to the string because the new owner can't change the bytes of the string. However, like a JavaScript string, it is possible to change the pointer, and so this does allow the copy constructor and assignment to change the pointer. Also remember that the pointer can be null.
-Blob Constructor
-----------------
+Blob Constructors
+-----------------
+
+Blob Constructor (from existing byte array)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new Blob to point to an existing byte array.
@@ -50,8 +53,8 @@
- `value`
(optional) A pointer to a vector with the byte array. This takes another reference and does not copy the bytes. If omitted, this set this blob to a null pointer.
-Blob Constructor (``uint8_t *``)
---------------------------------
+Blob Constructor (from immutable ``uint8_t *`` array) (C++ only)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
(C++ only) Create a new Blob with an immutable copy of the given array.
@@ -75,7 +78,7 @@
The length of value.
Blob Constructor (copy byte array)
-----------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new Blob with an immutable copy of the array in the given vector. If you want to transfer the array without copying, the the vector has to start as a type for the main Blob constructor.