Merge branch 'main' into never_copy

Author: rgommers

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,6 +1,6 @@
 name: Bug report
 description: Report a bug. For security vulnerabilities see Report a security vulnerability in the templates.
-title: "BUG: "
+title: "BUG: <Please write a comprehensive title after the 'BUG: ' prefix>"
 labels: [00 - Bug]
 
 body:
@@ -35,10 +35,12 @@ body:
   attributes:
     label: "Error message:"
     description: >
-      Please include full error message, if any (starting from `Traceback: ...`).
+      Please include full error message, if any.
       If you are reporting a segfault please include a GDB traceback,
       which you can generate by following
       [these instructions](https://github.com/numpy/numpy/blob/main/doc/source/dev/development_environment.rst#debugging).
+    placeholder: |
+      << Full traceback starting from `Traceback: ...` >>
     render: shell
 
 - type: textarea

.github/ISSUE_TEMPLATE/documentation.yml

@@ -1,6 +1,6 @@
 name: Documentation
 description: Report an issue related to the NumPy documentation.
-title: "DOC: "
+title: "DOC: <Please write a comprehensive title after the 'DOC: ' prefix>"
 labels: [04 - Documentation]
 
 body:

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,6 +1,6 @@
 name: Feature request
 description: Check instructions for submitting your idea on the mailing list first.
-title: "ENH: "
+title: "ENH: <Please write a comprehensive title after the 'ENH: ' prefix>"
 
 body:
 - type: markdown

.github/ISSUE_TEMPLATE/post-install.yml

@@ -1,5 +1,6 @@
 name: Post-install/importing issue
 description: Report an issue if you have trouble importing or using NumPy after installation.
+title: "<Please write a comprehensive title here>"
 labels: [32 - Installation]
 
 body:
@@ -16,10 +17,12 @@ body:
   attributes:
     label: "Error message:"
     description: >
-      Please include full error message, if any (starting from `Traceback: ...`).
+      Please include full error message, if any.
       If you are reporting a segfault please include a GDB traceback,
       which you can generate by following
       [these instructions](https://github.com/numpy/numpy/blob/main/doc/source/dev/development_environment.rst#debugging).
+    placeholder: |
+      << Full traceback starting from `Traceback: ...` >>
     render: shell
 
 - type: textarea

.github/workflows/build_test.yml

@@ -277,3 +277,35 @@ jobs:
         docker run --rm --interactive -v $(pwd):/numpy the_build /bin/bash -c "
           cd /numpy && python3 runtests.py -n -v -- -k test_simd
         "
+
+  sde_simd_avx512_test:
+    # Intel Software Development Emulator (SDE) is used to run a given program
+    # on a specific instruction set architecture and capture various performance details.
+    # see https://www.intel.com/content/www/us/en/developer/articles/tool/software-development-emulator.html
+    needs: [smoke_test]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: recursive
+        fetch-depth: 0
+    - uses: actions/setup-python@v2
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+    - name: Install Intel SDE
+      run: |
+        curl -o /tmp/sde.tar.bz2 https://www.intel.com/content/dam/develop/external/us/en/documents/downloads/sde-external-8.69.1-2021-07-18-lin.tar.bz2
+        mkdir /tmp/sde && tar -xvf /tmp/sde.tar.bz2 -C /tmp/sde/
+        sudo mv /tmp/sde/* /opt/sde && sudo ln -s /opt/sde/sde64 /usr/bin/sde
+    - name: Install dependencies
+      run: python -m pip install -r test_requirements.txt
+    - name: Build
+      run: python setup.py build
+           --simd-test="\$werror AVX512F AVX512_KNL AVX512_KNM AVX512_SKX AVX512_CLX AVX512_CNL AVX512_ICL"
+           install
+    # KNM implies KNL
+    - name: Run SIMD tests (Xeon PHI)
+      run: sde -knm -- python runtests.py -n -v -- -k test_simd
+    # ICL implies SKX, CLX and CNL
+    - name: Run SIMD tests (Ice Lake)
+      run: sde -icl -- python runtests.py -n -v -- -k test_simd

.github/workflows/wheels.yml

@@ -40,9 +40,9 @@ jobs:
     name: Build wheel for cp${{ matrix.python }}-${{ matrix.platform }}
     needs: get_commit_message
     if: >-
-      contains(needs.get_commit_message.outputs.message, '[cd build]') ||
-      github.event.name == 'schedule' ||
-      github.event.name == 'workflow_dispatch'
+      contains(needs.get_commit_message.outputs.message, '[wheel build]') ||
+      github.event_name == 'schedule' ||
+      github.event_name == 'workflow_dispatch'
     runs-on: ${{ matrix.os }}
     strategy:
       # Ensure that a wheel builder finishes even if another fails

azure-pipelines.yml

@@ -109,7 +109,7 @@ stages:
       # the docs even though i.e., numba uses another in their
       # azure config for mac os -- Microsoft has indicated
       # they will patch this issue
-      vmImage: 'macOS-10.14'
+      vmImage: 'macOS-1015'
     strategy:
       maxParallel: 3
       matrix:

doc/changelog/1.21.4-changelog.rst

@@ -0,0 +1,29 @@
+
+Contributors
+============
+
+A total of 7 people contributed to this release.  People with a "+" by their
+names contributed a patch for the first time.
+
+* Bas van Beek
+* Charles Harris
+* Isuru Fernando
+* Matthew Brett
+* Sayed Adel
+* Sebastian Berg
+* 傅立业（Chris Fu） +
+
+Pull requests merged
+====================
+
+A total of 9 pull requests were merged for this release.
+
+* `#20278 <https://github.com/numpy/numpy/pull/20278>`__: BUG: Fix shadowed reference of ``dtype`` in type stub
+* `#20293 <https://github.com/numpy/numpy/pull/20293>`__: BUG: Fix headers for universal2 builds
+* `#20294 <https://github.com/numpy/numpy/pull/20294>`__: BUG: ``VOID_nonzero`` could sometimes mutate alignment flag
+* `#20295 <https://github.com/numpy/numpy/pull/20295>`__: BUG: Do not use nonzero fastpath on unaligned arrays
+* `#20296 <https://github.com/numpy/numpy/pull/20296>`__: BUG: Distutils patch to allow for 2 as a minor version (!)
+* `#20297 <https://github.com/numpy/numpy/pull/20297>`__: BUG, SIMD: Fix 64-bit/8-bit integer division by a scalar
+* `#20298 <https://github.com/numpy/numpy/pull/20298>`__: BUG, SIMD: Workaround broadcasting SIMD 64-bit integers on MSVC...
+* `#20300 <https://github.com/numpy/numpy/pull/20300>`__: REL: Prepare for the NumPy 1.21.4 release.
+* `#20302 <https://github.com/numpy/numpy/pull/20302>`__: TST: Fix a ``Arrayterator`` typing test failure

doc/neps/nep-0013-ufunc-overrides.rst

@@ -556,7 +556,7 @@ in turn immediately raises :exc:`TypeError`, because one of its operands
 ``arr.__array_ufunc__``, which will return :obj:`NotImplemented`, which
 we catch.
 
-.. note :: the reason for not allowing in-place operations to return
+.. note:: the reason for not allowing in-place operations to return
    :obj:`NotImplemented` is that these cannot generically be replaced by
    a simple reverse operation: most array operations assume the contents
    of the instance are changed in-place, and do not expect a new

doc/neps/nep-0027-zero-rank-arrarys.rst

@@ -10,7 +10,7 @@ NEP 27 — Zero rank arrays
 :Created: 2006-06-10
 :Resolution: https://mail.python.org/pipermail/numpy-discussion/2018-October/078824.html
 
-.. note ::
+.. note::
 
     NumPy has both zero rank arrays and scalars. This design document, adapted
     from a `2006 wiki entry`_, describes what zero rank arrays are and why they