xxx:squash: doc update

Signed-off-by: John Mulligan <[email protected]>

Author: phlogistonjohn

docs/api-status.json

@@ -1956,7 +1956,7 @@
       },
       {
         "name": "Image.EncryptionLoad2",
-        "comment": "EncryptionLoad2 enables IO on an open encrypted image. The difference\nbetween EncryptionLoad and EncryptionLoad2 is that EncryptionLoad2 can open\nancestor images with a different encryption options than the current image.\nThe first EncryptionOptions in the slice is applied to the current image,\nthe second to the first ancestor, the third to the second ancestor and so\non.  If the length of the slice is smaller than the number of ancestors the\nfinal item in the slice will be applied to all remaining ancestors, or if\nthe ancestor does not match the encryption format the ancestor will be\ninterpreted as plain-text.\n\nImplements:\n\n\tint rbd_encryption_load2(rbd_image_t image,\n\t                         const rbd_encryption_spec_t *specs,\n\t                         size_t spec_count);\n",
+        "comment": "EncryptionLoad2 enables IO on an open encrypted image. Multiple encryption\noption values can be passed to this call in a slice. For more information\nabout how items in the slice are applied to images, and possibly ancestor\nimages refer to the documentation in the C api for rbd_encryption_load2.\n\nImplements:\n\n\tint rbd_encryption_load2(rbd_image_t image,\n\t                         const rbd_encryption_spec_t *specs,\n\t                         size_t spec_count);\n",
         "added_in_version": "$NEXT_RELEASE",
         "expected_stable_version": "$NEXT_RELEASE_STABLE"
       }

rbd/encryption_load2.go

@@ -55,15 +55,10 @@ func (opts EncryptionOptionsLUKS2) writeEncryptionSpec(spec *C.rbd_encryption_sp
 	}
 }
 
-// EncryptionLoad2 enables IO on an open encrypted image. The difference
-// between EncryptionLoad and EncryptionLoad2 is that EncryptionLoad2 can open
-// ancestor images with a different encryption options than the current image.
-// The first EncryptionOptions in the slice is applied to the current image,
-// the second to the first ancestor, the third to the second ancestor and so
-// on.  If the length of the slice is smaller than the number of ancestors the
-// final item in the slice will be applied to all remaining ancestors, or if
-// the ancestor does not match the encryption format the ancestor will be
-// interpreted as plain-text.
+// EncryptionLoad2 enables IO on an open encrypted image. Multiple encryption
+// option values can be passed to this call in a slice. For more information
+// about how items in the slice are applied to images, and possibly ancestor
+// images refer to the documentation in the C api for rbd_encryption_load2.
 //
 // Implements:
 //