Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 17 Dec 2020 01:55:32 +0000
From:      subwayirks@gmail.com
To:        svn-src-head@freebsd.org
Subject:   RE:
Message-ID:  <00000000000038c29905b69f4903@google.com>

Next in thread | Raw E-Mail | Index | Archive | Help
5oiR5bey6YKA6K+35oKo5aGr5YaZ5Lul5LiL6KGo5Y2V77yaDQpSRToNCg0K6KaB5aGr5YaZ5q2k
6KGo5Y2V77yM6K+36K6/6Zeu77yaDQpodHRwczovL2RvY3MuZ29vZ2xlLmNvbS9mb3Jtcy9kL2Uv
MUZBSXBRTFNjOEZXNXBKQWFnVGtIeGlUNWZvMG1scUhoemxiOFdrbWNPZGRlV0FKempVWGpYMkEv
dmlld2Zvcm0/dmM9MCZhbXA7Yz0wJmFtcDt3PTEmYW1wO2Zscj0wJmFtcDt1c3A9bWFpbF9mb3Jt
X2xpbmsNCg0K5oiR5bey6YKA6K+35oKo5aGr5YaZ6KGo5Y2V77yaDQoNCkdvb2dsZeihqOWNle+8
muWIm+W7uuiwg+afpemXruWNt+W5tuWIhuaekOiwg+afpee7k+aenOOAgg0K
From owner-svn-src-head@freebsd.org  Thu Dec 17 02:33:53 2020
Return-Path: <owner-svn-src-head@freebsd.org>
Delivered-To: svn-src-head@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id 14B504CECF3;
 Thu, 17 Dec 2020 02:33:53 +0000 (UTC)
 (envelope-from yuripv@FreeBSD.org)
Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org
 [IPv6:2610:1c1:1:606c::19:3])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256
 client-signature RSA-PSS (4096 bits) client-digest SHA256)
 (Client CN "mxrelay.nyi.freebsd.org",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 4CxGJx052Jz4k94;
 Thu, 17 Dec 2020 02:33:53 +0000 (UTC)
 (envelope-from yuripv@FreeBSD.org)
Received: from repo.freebsd.org (repo.freebsd.org
 [IPv6:2610:1c1:1:6068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id E9FFB1147B;
 Thu, 17 Dec 2020 02:33:52 +0000 (UTC)
 (envelope-from yuripv@FreeBSD.org)
Received: from repo.freebsd.org ([127.0.1.37])
 by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 0BH2Xqgw026551;
 Thu, 17 Dec 2020 02:33:52 GMT (envelope-from yuripv@FreeBSD.org)
Received: (from yuripv@localhost)
 by repo.freebsd.org (8.15.2/8.15.2/Submit) id 0BH2Xqkn026550;
 Thu, 17 Dec 2020 02:33:52 GMT (envelope-from yuripv@FreeBSD.org)
Message-Id: <202012170233.0BH2Xqkn026550@repo.freebsd.org>
X-Authentication-Warning: repo.freebsd.org: yuripv set sender to
 yuripv@FreeBSD.org using -f
From: Yuri Pankov <yuripv@FreeBSD.org>
Date: Thu, 17 Dec 2020 02:33:52 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: svn commit: r368711 - head/lib/libc/locale
X-SVN-Group: head
X-SVN-Commit-Author: yuripv
X-SVN-Commit-Paths: head/lib/libc/locale
X-SVN-Commit-Revision: 368711
X-SVN-Commit-Repository: base
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
 <svn-src-head.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head/>;
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 17 Dec 2020 02:33:53 -0000

Author: yuripv
Date: Thu Dec 17 02:33:52 2020
New Revision: 368711
URL: https://svnweb.freebsd.org/changeset/base/368711

Log:
  nl_langinfo(3): document recognized item names
  
  While here, remove .Tn macro usage (prompted by mandoc lint).
  
  PR:		251468
  Reviewed by:	bapt
  Differential Revision:	https://reviews.freebsd.org/D27606

Modified:
  head/lib/libc/locale/nl_langinfo.3

Modified: head/lib/libc/locale/nl_langinfo.3
==============================================================================
--- head/lib/libc/locale/nl_langinfo.3	Thu Dec 17 00:20:57 2020	(r368710)
+++ head/lib/libc/locale/nl_langinfo.3	Thu Dec 17 02:33:52 2020	(r368711)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 30, 2012
+.Dd December 14, 2020
 .Dt NL_LANGINFO 3
 .Os
 .Sh NAME
@@ -46,10 +46,6 @@ the particular language or cultural area defined in th
 locale, or in the case of
 .Fn nl_langinfo_l ,
 the locale passed as the second argument.
-The manifest constant names and values of
-.Fa item
-are defined in
-.In langinfo.h .
 .Pp
 Calls to
 .Fn setlocale
@@ -59,12 +55,102 @@ or to the
 category
 .Dv LC_ALL ,
 may overwrite the buffer pointed to by the return value.
+.Pp
+The manifest constant names and values of
+.Fa item
+are defined in
+.In langinfo.h .
+.Pp
+The following standard constants are recognized:
+.Bl -column "Constant" "Category"
+.It Sy Constant Ta Sy Category Ta Sy Description
+.It Dv CODESET Ta Dv LC_CTYPE Ta codeset name
+.It Dv D_T_FMT Ta Dv LC_TIME Ta string for formatting date and time
+.It Dv D_FMT Ta Dv LC_TIME Ta date format string
+.It Dv T_FMT Ta Dv LC_TIME Ta time format string
+.It Dv T_FMT_AMPM Ta Dv LC_TIME Ta a.m. or p.m. time format string
+.It Dv AM_STR Ta Dv LC_TIME Ta ante-meridiem affix
+.It Dv PM_STR Ta Dv LC_TIME Ta post-meridiem affix
+.It Dv DAY_1 Ta Dv LC_TIME Ta name of the first day of the week
+.It Dv DAY_2 Ta Dv LC_TIME Ta name of the second day of the week
+.It Dv DAY_3 Ta Dv LC_TIME Ta name of the third day of the week
+.It Dv DAY_4 Ta Dv LC_TIME Ta name of the fourth day of the week
+.It Dv DAY_5 Ta Dv LC_TIME Ta name of the fifth day of the week
+.It Dv DAY_6 Ta Dv LC_TIME Ta name of the sixth day of the week
+.It Dv DAY_7 Ta Dv LC_TIME Ta name of the seventh day of the week
+.It Dv ABDAY_1 Ta Dv LC_TIME Ta abbreviated name of the first day of the week
+.It Dv ABDAY_2 Ta Dv LC_TIME Ta abbreviated name of the second day of the week
+.It Dv ABDAY_3 Ta Dv LC_TIME Ta abbreviated name of the third day of the week
+.It Dv ABDAY_4 Ta Dv LC_TIME Ta abbreviated name of the fourth day of the week
+.It Dv ABDAY_5 Ta Dv LC_TIME Ta abbreviated name of the fifth day of the week
+.It Dv ABDAY_6 Ta Dv LC_TIME Ta abbreviated name of the sixth day of the week
+.It Dv ABDAY_7 Ta Dv LC_TIME Ta abbreviated name of the seventh day of the week
+.It Dv MON_1 Ta Dv LC_TIME Ta name of the first month of the year
+.It Dv MON_2 Ta Dv LC_TIME Ta name of the second month
+.It Dv MON_3 Ta Dv LC_TIME Ta name of the third month
+.It Dv MON_4 Ta Dv LC_TIME Ta name of the fourth month
+.It Dv MON_5 Ta Dv LC_TIME Ta name of the fifth month
+.It Dv MON_6 Ta Dv LC_TIME Ta name of the sixth month
+.It Dv MON_7 Ta Dv LC_TIME Ta name of the seventh month
+.It Dv MON_8 Ta Dv LC_TIME Ta name of the eighth month
+.It Dv MON_9 Ta Dv LC_TIME Ta name of the ninth month
+.It Dv MON_10 Ta Dv LC_TIME Ta name of the tenth month
+.It Dv MON_11 Ta Dv LC_TIME Ta name of the eleventh month
+.It Dv MON_12 Ta Dv LC_TIME Ta name of the twelfth month
+.It Dv ABMON_1 Ta Dv LC_TIME Ta abbreviated name of the first month
+.It Dv ABMON_2 Ta Dv LC_TIME Ta abbreviated name of the second month
+.It Dv ABMON_3 Ta Dv LC_TIME Ta abbreviated name of the third month
+.It Dv ABMON_4 Ta Dv LC_TIME Ta abbreviated name of the fourth month
+.It Dv ABMON_5 Ta Dv LC_TIME Ta abbreviated name of the fifth month
+.It Dv ABMON_6 Ta Dv LC_TIME Ta abbreviated name of the sixth month
+.It Dv ABMON_7 Ta Dv LC_TIME Ta abbreviated name of the seventh month
+.It Dv ABMON_8 Ta Dv LC_TIME Ta abbreviated name of the eighth month
+.It Dv ABMON_9 Ta Dv LC_TIME Ta abbreviated name of the ninth month
+.It Dv ABMON_10 Ta Dv LC_TIME Ta abbreviated name of the tenth month
+.It Dv ABMON_11 Ta Dv LC_TIME Ta abbreviated name of the eleventh month
+.It Dv ABMON_12 Ta Dv LC_TIME Ta abbreviated name of the twelfth month
+.It Dv ERA Ta Dv LC_TIME Ta era description segments
+.It Dv ERA_D_FMT Ta Dv LC_TIME Ta era date format string
+.It Dv ERA_D_T_FMT Ta Dv LC_TIME Ta era date and time format string
+.It Dv ERA_T_FMT Ta Dv LC_TIME Ta era time format string
+.It Dv ALT_DIGITS Ta Dv LC_TIME Ta alternative symbols for digits
+.It Dv RADIXCHAR Ta Dv LC_NUMERIC Ta radix character
+.It Dv THOUSEP Ta Dv LC_NUMERIC Ta separator for thousands
+.It Dv YESEXPR Ta Dv LC_MESSAGES Ta affirmative response extended regular
+expression
+.It Dv NOEXPR Ta Dv LC_MESSAGES Ta negative response extended regular expression
+.It Dv CRNCYSTR Ta Dv LC_MONETARY Ta local currency symbol, preceded by '-' if the
+symbol should appear before the value, '+' if the symbol should appear after the
+value, or '.' if the symbol should replace the radix character; if the local
+currency symbol is the empty string, implementations may return the empty string
+.Pq Qq
+.El
+.Pp
+The following non-standard
+.Fx
+extensions are recognized:
+.Bl -column "Constant" "Category"
+.It Sy Constant Ta Sy Category Ta Sy Description
+.It Dv D_MD_ORDER Ta Dv LC_TIME Ta month/day order
+.It Dv ALTMON_1 Ta Dv LC_TIME Ta standalone name of the first month
+.It Dv ALTMON_2 Ta Dv LC_TIME Ta standalone name of the second month
+.It Dv ALTMON_3 Ta Dv LC_TIME Ta standalone name of the third month
+.It Dv ALTMON_4 Ta Dv LC_TIME Ta standalone name of the fourth month
+.It Dv ALTMON_5 Ta Dv LC_TIME Ta standalone name of the fifth month
+.It Dv ALTMON_6 Ta Dv LC_TIME Ta standalone name of the sixth month
+.It Dv ALTMON_7 Ta Dv LC_TIME Ta standalone name of the seventh month
+.It Dv ALTMON_8 Ta Dv LC_TIME Ta standalone name of the eighth month
+.It Dv ALTMON_9 Ta Dv LC_TIME Ta standalone name of the ninth month
+.It Dv ALTMON_10 Ta Dv LC_TIME Ta standalone name of the tenth month
+.It Dv ALTMON_11 Ta Dv LC_TIME Ta standalone name of the eleventh month
+.It Dv ALTMON_12 Ta Dv LC_TIME Ta standalone name of the twelfth month
+.It Dv YESSTR Ta Dv LC_MESSAGES Ta affirmative response string
+.It Dv NOSTR Ta Dv LC_MESSAGES Ta negative response string
+.El
 .Sh RETURN VALUES
 In a locale where langinfo data is not defined,
 .Fn nl_langinfo
-returns a pointer to the corresponding string in the
-.Tn POSIX
-locale.
+returns a pointer to the corresponding string in the POSIX locale.
 .Fn nl_langinfo_l
 returns the same values as
 .Fn nl_langinfo .



Want to link to this message? Use this URL: <http://docs.FreeBSD.org/cgi/mid.cgi?00000000000038c29905b69f4903>