From 14c0a35d68b98e56d75c6b0ee1f7fd45db32c3c9 Mon Sep 17 00:00:00 2001
From: Aaron Meurer <asmeurer@gmail.com>
Date: Mon, 11 Apr 2022 16:03:15 -0600
Subject: Small updates to the array_api docs

These items were not clear in the original PR #21260 but have since been
clarified.
---
 doc/source/reference/array_api.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

(limited to 'doc/source/reference/array_api.rst')

diff --git a/doc/source/reference/array_api.rst b/doc/source/reference/array_api.rst
index 494cbad65..a6a8619da 100644
--- a/doc/source/reference/array_api.rst
+++ b/doc/source/reference/array_api.rst
@@ -624,11 +624,8 @@ Linear Algebra Differences
    * - ``cholesky`` includes an ``upper`` keyword argument.
      - **Compatible**
      -
-   * - ``cross`` does not broadcast its arguments.
-     - ???
-     -
    * - ``cross`` does not allow size 2 vectors (only size 3).
-     - ???
+     - **Breaking**
      -
    * - ``diagonal`` operates on the last two axes.
      - **Breaking**
@@ -663,7 +660,9 @@ Linear Algebra Differences
        <https://data-apis.org/array-api/latest/API_specification/generated/signatures.linear_algebra_functions.matrix_transpose.html#signatures.linear_algebra_functions.matrix_transpose>`__
    * - ``outer`` only supports 1-dimensional arrays.
      - **Breaking**
-     -
+     - The spec currently only specifies behavior on 1-D arrays but future
+       behavior will likely be to broadcast, rather than flatten, which is
+       what ``np.outer`` does.
    * - ``pinv`` has an ``rtol`` keyword argument instead of ``rcond``
      - **Breaking**
      - The meaning of ``rtol`` and ``rcond`` is the same, but the default
-- 
cgit v1.2.1