Re: [PATCH] man/: Replaced reserved exp identifier

[Vincent Lefevre <vincent@vinc17.net>]

On 2025-07-02 16:41:28 +0200, Alejandro Colomar wrote:
> On Wed, Jul 02, 2025 at 11:25:16AM +0200, Vincent Lefevre wrote:
[...]
> > --- a/man/man2/timerfd_create.2
> > +++ b/man/man2/timerfd_create.2
> > @@ -639,12 +639,12 @@ main(int argc, char *argv[])
> >  {
> >      int                fd;
> >      ssize_t            s;
> > -    uint64_t           exp, tot_exp, max_exp;
> > +    uint64_t           ex, tot_ex, max_ex;
> 
> How about using 'to' for timeout?  Do you think it makes sense?

As described by the man page, this is more a timer expiration
(many occurrences of words starting with "expir") than a timeout
(a single occurrence - shouldn't this be "expiration time"?).
So, for these 3 variables, instead of "exp", perhaps "te" for
"timer expiration"?

> >      struct timespec    now;
> >      struct itimerspec  new_value;
> >  \&
> >      if (argc != 2 && argc != 4) {
> > -        fprintf(stderr, "%s init\-secs [interval\-secs max\-exp]\[rs]n",
> > +        fprintf(stderr, "%s init\-secs [interval\-secs max\-ex]\[rs]n",
> 
> And here saying max\-timeout.

One could actually let max\-exp. Or say max\-timer\-exp (the line
would not be too large).

[...]
> > --- a/man/man3/frexp.3
> > +++ b/man/man3/frexp.3
> > @@ -14,9 +14,9 @@ Math library
> >  .nf
> >  .B #include <math.h>
> >  .P
> > -.BI "double frexp(double " x ", int *" exp );
> > -.BI "float frexpf(float " x ", int *" exp );
> > -.BI "long double frexpl(long double " x ", int *" exp );
> > +.BI "double frexp(double " x ", int *" p );
> > +.BI "float frexpf(float " x ", int *" p );
> > +.BI "long double frexpl(long double " x ", int *" p );
> 
> Here I think I'd use 'e' for exponent.  What do you think?

One could do that (this was more or less my initial idea,
and I'm wondering why the committee chose p).

BTW, for frexp, this is a pointer, while for ldexp, this is
an integer. So, should there be a difference (e.g. pe for
the pointer to the exponent, and e for the exponent)?

-- 
Vincent Lefèvre <vincent@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / Pascaline project (LIP, ENS-Lyon)