On Wed, 9 Oct 2024, Alejandro Colomar wrote: > Every little bit adds up. Documentation is simpler if there is naming > consistency. We have SYNOPSISes in the man pages, and they're up front, > because they constitute an important part of the documentation.
We also have a convention for future standard C interfaces to put the length before the pointer so that a VLA parameter declaration can be used that makes very clear the intent for how many elements the array has, which seems much better for that purpose than relying on the name of a parameter. -- Joseph S. Myers josmy...@redhat.com