[Bug middle-end/101852] New: [meta-bug] some optabs are not documented

[Bug middle-end/101852] New: [meta-bug] some optabs are not documented

[pinskia at gcc dot gnu.org]

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

            Bug ID: 101852
           Summary: [meta-bug] some optabs are not documented
           Product: gcc
           Version: 12.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: middle-end
          Assignee: unassigned at gcc dot gnu.org
          Reporter: pinskia at gcc dot gnu.org
        Depends on: 21231
  Target Milestone: ---

There are a few optabs that seems to be missing documentation.
Linked are those bugs.
Someone should do an audit of optabs.def and doc/md.texi to see what optabs are
also missing.


Referenced Bugs:

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=21231
[Bug 21231] cmov and cstore standard names not documented.

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|[meta-bug] some optabs are  |[meta-bug] some standard
                   |not documented              |RTL names are not
                   |                            |documented

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Here is a simple way to find some which seems to be missing:
grep ^OPTAB optabs.def|awk -F',' ' { print $2 } '|awk -F '"' ' { print $2 }
'|sed 's/_*\$[a-zA-Z0-9\$]*$//' |sort|uniq > ~/optabs.txt
for x in `cat ~/optabs.txt`; do  if grep -q -r $x doc ; then true; else echo
$x; fi ; done  > ~/missing.txt



Not the best but found some:
avg$a3_ceil
avg$a3_floor
divv
smul$a3_highpart
storent
uavg$a3_ceil
uavg$a3_floor
umul$a3_highpart
vec_realign_load

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

--- Comment #2 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Oh target-insns.def needs to be added to the list of auditing too.

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

--- Comment #3 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
My simple grep found
storent
vec_realign_load ;;; this is PR 36396

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

--- Comment #4 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Here is the list from target-insns.def:
grep ^DEF_TARGET_INSN target-insns.def|awk ' { print $2 } ' | tr -d '('  | tr
-d ',' > ~/insns.txt
for x in `cat ~/insns.txt`; do  if grep -q -r $x doc ; then true; else echo $x;
fi ; done  > ~/missinginsns.txt


oacc_dim_pos
oacc_dim_size
oacc_fork
oacc_join
omp_simt_enter
omp_simt_exit
omp_simt_lane
omp_simt_last_lane
omp_simt_ordered
omp_simt_vote_any
omp_simt_xchg_bfly
omp_simt_xchg_idx

reload_load_address
sibcall_value ;; PR 26831
split_stack_prologue
split_stack_space_check

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

--- Comment #5 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
A new one for GCC 14 even:

cond_copysign
cond_len_copysign

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

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

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Last reconfirmed|                            |2023-12-11
             Status|UNCONFIRMED                 |NEW
     Ever confirmed|0                           |1
           Keywords|                            |documentation

[Bug middle-end/101852] [meta-bug] some standard RTL names are not documented

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=101852
Bug 101852 depends on bug 112951, which changed state.

Bug 112951 Summary: [14 Regression] cond_copysign, cond_len_copysign optab not documented (added by r14-5285-gf30ecd8050444f)
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=112951

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |RESOLVED
         Resolution|---                         |FIXED