Subject: lib/30791: printf(3) man page should say "ll" is for "long long"
To: None <lib-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: None <soda@NetBSD.org>
List: netbsd-bugs
Date: 07/20/2005 13:21:02
>Number:         30791
>Category:       lib
>Synopsis:       printf(3) man page should say "ll" is for "long long"
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jul 20 13:21:02 +0000 2005
>Originator:     Noriyuki Soda
>Release:        NetBSD 3.99.7
>Organization:
	the NetBSD project
>Environment:
NetBSD on any platforms

>Description:

printf(3) man page says that "ll" prefix in a format string is for quad_t.
but it should say for "long long", because
- theoretically "long long" may be different from 64bit integer, although
  currently it's always 64bit on any NetBSD platforms.
- "q" prefix is a BSD extention, and not portable.
  on the other hand, "ll" is defined in C99 standard.

>How-To-Repeat:
man 3 printf

>Fix:

- add independent entry for "ll", and describe it as for "long long"
- it may better to discourage using "q" prefix, since it isn't portable.
  or, at least the man page should mention that "q" is a BSD extension.