Updated docstrings

Author: rogerbinns

apsw/__init__.pyi

@@ -232,21 +232,14 @@ def carray(object: Buffer | tuple[str, ...] | tuple[Buffer, ...], *, start: int
     :param flags: Default auto detect.
 
         For numbers, detection is done from the buffer
-        `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__.
-        Use :code:`memoryview(object).format` to see it..
-
-        .. list-table::
-          :widths: auto
-          :header-rows: 1
-
-          * - Format
-            - Flag
-          * - ``i``
-            - ``SQLITE_CARRAY_INT32``
-          * - ``l``
-            - ``SQLITE_CARRAY_INT64``
-          * - ``d``
-            - ``SQLITE_CARRAY_DOUBLE``
+        `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__
+        and itemsize.  You can use ``format`` and ``itemsize`` attributes of :code:`memoryview(object)`
+        to see what they are.
+
+        Format ``i``, ``l``, ``q``
+            ``SQLITE_CARRAY_INT32`` or ``SQLITE_CARRAY_INT64`` based on itemsize
+        Format  ``d``
+            ``SQLITE_CARRAY_DOUBLE``
 
         You can explicitly provide the type such as :code:`apsw.SQLITE_CARRAY_INT32`.  If
         it is incorrect then the values will be nonsense.

src/apsw.c

@@ -312,21 +312,14 @@ static int allow_missing_dict_bindings = 0;
   :param flags: Default auto detect.
 
       For numbers, detection is done from the buffer
-      `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__.
-      Use :code:`memoryview(object).format` to see it..
-
-      .. list-table::
-        :widths: auto
-        :header-rows: 1
-
-        * - Format
-          - Flag
-        * - ``i``
-          - ``SQLITE_CARRAY_INT32``
-        * - ``l``
-          - ``SQLITE_CARRAY_INT64``
-        * - ``d``
-          - ``SQLITE_CARRAY_DOUBLE``
+      `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__
+      and itemsize.  You can use ``format`` and ``itemsize`` attributes of :code:`memoryview(object)`
+      to see what they are.
+
+      Format ``i``, ``l``, ``q``
+          ``SQLITE_CARRAY_INT32`` or ``SQLITE_CARRAY_INT64`` based on itemsize
+      Format  ``d``
+          ``SQLITE_CARRAY_DOUBLE``
 
       You can explicitly provide the type such as :code:`apsw.SQLITE_CARRAY_INT32`.  If
       it is incorrect then the values will be nonsense.

src/apsw.docstrings

@@ -57,21 +57,14 @@
 ":param flags: Default auto detect.\n" \
 "\n" \
 "    For numbers, detection is done from the buffer\n" \
-"    `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__.\n" \
-"    Use :code:`memoryview(object).format` to see it..\n" \
-"\n" \
-"    .. list-table::\n" \
-"      :widths: auto\n" \
-"      :header-rows: 1\n" \
-"\n" \
-"      * - Format\n" \
-"        - Flag\n" \
-"      * - ``i``\n" \
-"        - ``SQLITE_CARRAY_INT32``\n" \
-"      * - ``l``\n" \
-"        - ``SQLITE_CARRAY_INT64``\n" \
-"      * - ``d``\n" \
-"        - ``SQLITE_CARRAY_DOUBLE``\n" \
+"    `format code <https://docs.python.org/3/library/struct.html#byte-order-size-and-alignment>`__\n" \
+"    and itemsize.  You can use ``format`` and ``itemsize`` attributes of :code:`memoryview(object)`\n" \
+"    to see what they are.\n" \
+"\n" \
+"    Format ``i``, ``l``, ``q``\n" \
+"        ``SQLITE_CARRAY_INT32`` or ``SQLITE_CARRAY_INT64`` based on itemsize\n" \
+"    Format  ``d``\n" \
+"        ``SQLITE_CARRAY_DOUBLE``\n" \
 "\n" \
 "    You can explicitly provide the type such as :code:`apsw.SQLITE_CARRAY_INT32`.  If\n" \
 "    it is incorrect then the values will be nonsense.\n" \