Re: NAME_MAX usage not consistent across man pages

[David Holland <dholland-docs%netbsd.org@localhost>]

On Sun, May 23, 2010 at 11:01:16PM +0200, Nicolas Joly wrote:
 > 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 ?

Why do we want the braces? And if we do, why is this particular symbol
different from all other uses of Dv?

I'd go with just .Dv NAME_MAX.

-- 
David A. Holland
dholland%netbsd.org@localhost