https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107796
Bug ID: 107796
Summary: The vector extension documentation should be improved
Product: gcc
Version: 13.0
Status: UNCONFIRMED
Keywords: documentation
Severity: normal
Priority: P3
Component: c
Assignee: unassigned at gcc dot gnu.org
Reporter: pinskia at gcc dot gnu.org
Target Milestone: ---
The documentation for the vector extension should be improved.
https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/Vector-Extensions.html#Vector-Extensions
Right now the title is "Using Vector Instructions through Built-in Functions"
but this is not just about vector instructions any more. Plus we define
operations on the vector instructions.
PR 89817 references we talked about internal type modes which are not used to
describe vectors any more.
We have generic vectors any now too.
I think we should reorg the documentation here too.
This is how we should org the vector docs:
* Introduction
* type definition (vector_size attribute)
* Operations
** General (+/-,etc)
** Shifts
** comparisons (and ?:, !, && and || C++ only) (see also PR 70438)
** Casts (see also PR 61744)
*** __builtin_convertvector
** subscripting (v[N])
** Shuffles (__builtin_shuffle and __builtin_shufflevector)
