Re: [PATCH] Various pages: SYNOPSIS: Use VLA syntax in function parameters

Ingo Schwarze
2022-08-27T11:10:16Z

Hi Alejandro,

> -.BI "char *getcwd(char *" buf ", size_t " size );
> +.BI "char *getcwd(char " buf [ size "], size_t " size );

I dislike this.

Manual pages should show function prototypes as they really are in
the header file, or if the header file contains useless fluff like
"restrict", a shortened form showing the essence that actually matters
for using the API. They should certainly not show something imaginary
that does not match reality, and even less so using invalid syntax.

Yours,
Ingo