Subject: lib/28144: ngettext() documentation is misleading
To: None <lib-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: Christian Biere <christianbiere@gmx.de>
List: netbsd-bugs
Date: 11/10/2004 00:35:01
>Number:         28144
>Category:       lib
>Synopsis:       ngettext() documentation is misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Nov 10 00:35:00 +0000 2004
>Originator:     Christian Biere
>Release:        NetBSD 2.0G
>Environment:
System: NetBSD cyclonus 2.0G NetBSD 2.0G (STARSCREAM) #0: Tue Jul 20 02:41:48 CEST 2004 bin@cyclonus:/usr/obj/sys/arch/i386/compile/STARSCREAM i386
Architecture: i386
Machine: i386
>Description:

The manpage of ngettext() names the first parameter of ngettext() "domainname"
which implies a quite different usage.

>How-To-Repeat:

Read the manpage and be confused that everybody seems to use it wrong.

>Fix:

RCS file: /cvsroot/src/lib/libintl/gettext.3,v
retrieving revision 1.10
diff -u -r1.10 gettext.3
--- gettext.3	24 Jan 2004 16:59:51 -0000	1.10
+++ gettext.3	10 Nov 2004 00:27:15 -0000
@@ -47,7 +47,7 @@
 .Ft char *
 .Fn dgettext "const char *domainname" "const char *msgid"
 .Ft char *
-.Fn ngettext "const char *domainname" "const char *msgid" "unsigned long int n"
+.Fn ngettext "const char *msgid1" "const char *msgid2" "unsigned long int n"
 .Ft char *
 .Fn dngettext "const char *domainname" "const char *msgid1" "const char *msgid2" "unsigned long int n"
 .Ft char *