Update class comments.

2 files changed, 6 insertions, 5 deletions

diff --git a/document/src/vespa/document/update/tensor_add_update.h b/document/src/vespa/document/update/tensor_add_update.h
index a92ff0101f0..49519ee1ddd 100644
--- a/document/src/vespa/document/update/tensor_add_update.h
+++ b/document/src/vespa/document/update/tensor_add_update.h
@@ -8,10 +8,10 @@ namespace document {
 
 class TensorFieldValue;
 
-/*
- *  An update used to add cells to a sparse tensor (has only mapped dimensions).
+/**
+ * An update used to add cells to a sparse or mixed tensor.
  *
- *  The cells to add are contained in a sparse tensor as well.
+ * The cells to add are contained in a tensor of the same type.
  */
 class TensorAddUpdate : public ValueUpdate {
     std::unique_ptr<TensorFieldValue> _tensor;
diff --git a/document/src/vespa/document/update/tensor_remove_update.h b/document/src/vespa/document/update/tensor_remove_update.h
index 7f2a32a8a3a..809e9d42305 100644
--- a/document/src/vespa/document/update/tensor_remove_update.h
+++ b/document/src/vespa/document/update/tensor_remove_update.h
@@ -9,9 +9,10 @@ namespace document {
 class TensorFieldValue;
 
 /**
- * An update used to remove cells from a sparse tensor (has only mapped dimensions).
+ * An update used to remove cells from a sparse or mixed tensor.
  *
- * The cells to remove are contained in a sparse tensor as well.
+ * The cells to remove are contained in a sparse tensor (with all mapped dimensions) where cell values are set to 1.0.
+ * When used on a mixed tensor the entire dense sub-space (pointed to by a cell in the sparse tensor) is removed.
  */
 class TensorRemoveUpdate : public ValueUpdate {
 private: