[Bug fortran/112873] F2023 degree trig functions

["sgk at troutmask dot apl.washington.edu" <gcc-bugzilla@gcc.gnu.org>]

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

--- Comment #25 from Steve Kargl <sgk at troutmask dot apl.washington.edu> ---
On Thu, Dec 14, 2023 at 07:48:08PM +0000, anlauf at gcc dot gnu.org wrote:
> https://gcc.gnu.org/bugzilla/show_bug.cgi?id=112873
> 
> --- Comment #24 from anlauf at gcc dot gnu.org ---
> (In reply to Jerry DeLisle from comment #23)
> > I am going to suggest the following. The wording was confusing around the
> > functionality of the option vs the intrinsics. Hope this is OK?
> > 
> > @opindex @code{fdec-math}
> > @item -fdec-math
> > Obsolete flag.  The purpose of this option was to
> > enable legacy math intrinsics such as COTAN and degree-valued trigonometric
> > functions (e.g. TAND, ATAND, etc...) for compatibility with older code. This
> > option is no longer operable. The trigonometric functions are now either 
> > part of Fortran 2023 or GNU extensions.
> 
> I am not a native speaker, so this is certainly better than what I wrote.
> 

Your English is much better than my non-existent German. ;-)

The above is fine for the -fdec-math option.  However, we'll need
to audit the description of each function to cleanup the non-support
for complex.  For example, ASIND has

_Arguments_:
    X     The type shall be either ‘REAL’ and a magnitude
          that is less than or equal to one - or be ‘COMPLEX’.

_Return value_:
     The return value is of the same type and kind as X.  The real part
     of the result is in degrees and lies in the range -90 \leq \Re
     \asin(x) \leq 90.

These should likely read

_Arguments_:
    X     The type shall be ‘REAL’.  The  magnitude of X should be
          less than or equal to one.

_Return value_:
     The return value is of the same type and kind as X.  The 
     result is in degrees and lies in the range -90 \leq \Re
     \asin(x) \leq 90.