[Bug web/103214] New: Incorrect function signatures for __builtin_ia32_pblendd* instructions

[Bug web/103214] New: Incorrect function signatures for __builtin_ia32_pblendd* instructions

[gnugcc at bdwjn dot 33mail.com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=103214

            Bug ID: 103214
           Summary: Incorrect function signatures for
                    __builtin_ia32_pblendd* instructions
           Product: gcc
           Version: 12.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: web
          Assignee: unassigned at gcc dot gnu.org
          Reporter: gnugcc at bdwjn dot 33mail.com
  Target Milestone: ---

The documentation on
https://gcc.gnu.org/onlinedocs/gcc/x86-Built-in-Functions.html lists the
following two AVX2 functions:

> v4si __builtin_ia32_pblendd128 (v4si,v4si)
> v8si __builtin_ia32_pblendd256 (v8si,v8si)

These instructions take two vectors and an integer mask, so this should be:

> v4si __builtin_ia32_pblendd128 (v4si,v4si,int)
> v8si __builtin_ia32_pblendd256 (v8si,v8si,int)

[Bug web/103214] Incorrect function signatures for __builtin_ia32_pblendd* instructions

[jakub at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=103214

Jakub Jelinek <jakub at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |jakub at gcc dot gnu.org

--- Comment #1 from Jakub Jelinek <jakub at gcc dot gnu.org> ---
These builtins should never be used directly, they aren't a supported
interface, which are the intrinsics like _mm_blend_epi32 etc.  The builtins are
just underlying implementation of those intrinsics, and can be added, removed
or changed any time.
So, IMNSHO instead of changing the prototypes in the documentation we should
remove all that documentation from there and clarify what we've been telling
for years, that the __builtin_ia32_* builtins must never be used directly.