On Wed, Feb 05, 2020 at 02:19:34PM -0800, John Hubbard wrote: > So if we do this, I think we'd also want something like this (probably with > better wording, this is just a first draft): > > diff --git a/Documentation/core-api/xarray.rst b/Documentation/core-api/xarray.rst > index 640934b6f7b4..8adeaa8c012e 100644 > --- a/Documentation/core-api/xarray.rst > +++ b/Documentation/core-api/xarray.rst > @@ -66,10 +66,11 @@ pointer at every index. > You can then set entries using xa_store() and get entries > using xa_load(). xa_store will overwrite any entry with the > new entry and return the previous entry stored at that index. You can > -use xa_erase() instead of calling xa_store() with a > +use xa_erase() plus xas_init_marks(), instead of calling xa_store() with a Woah, woah, woah. xa_erase() re-initialises the marks. Nobody's going to change that. Don't confuse the porcelain and plumbing APIs.
