[PATCH] XArray: document that tags persist after storing new elements

[PATCH] XArray: document that tags persist after storing new elements

[Christoph Hellwig]

This is a very useful feature, document it.

Signed-off-by: Christoph Hellwig <hch@lst.de>
---
 Documentation/core-api/xarray.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/core-api/xarray.rst b/Documentation/core-api/xarray.rst
index c6c91cbd0c3c..9a0d930a8c79 100644
--- a/Documentation/core-api/xarray.rst
+++ b/Documentation/core-api/xarray.rst
@@ -127,6 +127,8 @@ by using xa_set_mark() and remove the mark from an entry by calling
 xa_clear_mark().  You can ask whether any entry in the XArray has a
 particular mark set by calling xa_marked().  Erasing an entry from the
 XArray causes all marks associated with that entry to be cleared.
+Storing a new entry that replaces an existing entry keeps the marks
+associated with the index intact.
 
 Setting or clearing a mark on any index of a multi-index entry will
 affect all indices covered by that entry.  Querying the mark on any
-- 
2.53.0

Re: [PATCH] XArray: document that tags persist after storing new elements

[Jonathan Corbet]

Christoph Hellwig <hch@lst.de> writes:

> This is a very useful feature, document it.
>
> Signed-off-by: Christoph Hellwig <hch@lst.de>
> ---
>  Documentation/core-api/xarray.rst | 2 ++
>  1 file changed, 2 insertions(+)
>
> diff --git a/Documentation/core-api/xarray.rst b/Documentation/core-api/xarray.rst
> index c6c91cbd0c3c..9a0d930a8c79 100644
> --- a/Documentation/core-api/xarray.rst
> +++ b/Documentation/core-api/xarray.rst
> @@ -127,6 +127,8 @@ by using xa_set_mark() and remove the mark from an entry by calling
>  xa_clear_mark().  You can ask whether any entry in the XArray has a
>  particular mark set by calling xa_marked().  Erasing an entry from the
>  XArray causes all marks associated with that entry to be cleared.
> +Storing a new entry that replaces an existing entry keeps the marks
> +associated with the index intact.
>  
Applied, thanks.

jon