NetBSD-Docs archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
NAME_MAX usage not consistent across man pages
Hi,
While looking to some man pages, i noticed that NAME_MAX define usage
is not consistent ... Some of them use it enclosed with braces, and
some others do not; and there is 3 variants for setting braces :
njoly@petaure [share/man]> find man* -type f -name '*.[1-9]' | xargs grep -h
'[^_A-Z]NAME_MAX' | sort | uniq -c
5 .Brq Dv NAME_MAX
2 .Brq Dv NAME_MAX .
14 .Dv NAME_MAX
4 .Dv NAME_MAX .
3 .Dv { NAME_MAX }
30 .Dv {NAME_MAX}
To be consistent across all pages, we should use a single expression
in all pages. I'm for using the `.Brq Dv NAME_MAX' one, which add the
braces (without spaces, following the opengroup man pages) using a
mdoc macro.
Comments ?
NB: At least, PATH_MAX suffers from the very same ...
njoly@petaure [share/man]> find man* -type f -name '*.[1-9]' | xargs grep -h
'[^[_A-Z]PATH_MAX' | sort | uniq -c
7 .Brq Dv PATH_MAX
7 .Cm PATH_MAX
16 .Dv PATH_MAX
3 .Dv { PATH_MAX }
28 .Dv {PATH_MAX}
2 .Va PATH_MAX .
--
Nicolas Joly
Biological Software and Databanks.
Institut Pasteur, Paris.
Home |
Main Index |
Thread Index |
Old Index