This is the mail archive of the newlib@sourceware.org mailing list for the newlib project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: patch to add C99 complex - 1/3


On Oct  7 15:59, Marco Atzeri wrote:
> Hi Corinna,
> [...]
> About the documentation, if I understood correctly
> 
> math/math.tex and common/math.tex are the start point of the documentation for math functions.
> So I need to replicate in a new complex/math.tex
> 
> math.tex include *.def and they are created from 
> the comments in the c files.
> 
> -------------------------------------------------------
> $ grep \.def Makefile.am
> chobj = w_acos.def w_acosh.def w_asin.def s_asinh.def \
>         s_atan.def w_atan2.def w_atanh.def w_j0.def \
>         w_cosh.def s_erf.def w_exp.def w_exp2.def \
>         s_fabs.def s_floor.def w_fmod.def s_frexp.def \
>         w_gamma.def w_hypot.def s_ldexp.def w_log.def \
>         w_log10.def \
>         w_pow.def w_remainder.def s_sin.def w_sinh.def \
>         w_sqrt.def s_tan.def s_tanh.def
> SUFFIXES = .def
> .c.def:
>         $(CHEW) < $< > $*.def 2> $*.ref
>         touch stmp-def
> --------------------------------------------------------
> 
> 
> 
> Only the leading functions need these comments
> like w_acos.c covers also w_acosf.c 
> 
>  $ ls *.c |wc -l
> 135
> 
> $ grep SYNOPSIS *.c  |wc -l
> 55
> 
> so I should add around 22 comments for all the couples
> double / single of funtions, copying from the NETBSD
> documentation.
> 
> I presume no documentation is needed for the internal 
> functions in cephes_subr.c
> 
> Correct ?

Exactly!  As you can see in the existing docs, you don't even have to
add a lot of text.


Thanks,
Corinna

-- 
Corinna Vinschen
Cygwin Project Co-Leader
Red Hat


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]