Deprecate accessor::max_size()

This function was added only to align accessor with the container interface.
However, an accessor is not a container, and this has led to confusion
regarding what this value should return.

Author: Pennycook

adoc/chapters/programming_interface.adoc

@@ -9453,8 +9453,10 @@ a@
 ----
 size_type max_size() const noexcept
 ----
-   a@ Returns the maximum number of elements any accessor of this type would be
-      able to access.
+   a@ Deprecated.
+
+Returns the maximum number of elements any accessor of this type would be able
+to access.
 
 a@
 [source]

adoc/headers/accessorBuffer.h

@@ -137,6 +137,7 @@ class accessor {
 
   size_type size() const noexcept;
 
+  // Deprecated
   size_type max_size() const noexcept;
 
   // Deprecated

adoc/headers/accessorHost.h

@@ -69,6 +69,7 @@ class host_accessor {
 
   size_type size() const noexcept;
 
+  // Deprecated
   size_type max_size() const noexcept;
 
   bool empty() const noexcept;

adoc/headers/accessorLocal.h

@@ -37,6 +37,7 @@ template <typename DataT, int Dimensions = 1> class local_accessor {
 
   size_type size() const noexcept;
 
+  // Deprecated
   size_type max_size() const noexcept;
 
   bool empty() const noexcept;