diff options
Diffstat (limited to 'man3/newlocale.3')
-rw-r--r-- | man3/newlocale.3 | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/man3/newlocale.3 b/man3/newlocale.3 index 2c602a4..4bbaf14 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH newlocale 3 2023-05-03 "Linux man-pages 6.05.01" +.TH newlocale 3 2023-10-31 "Linux man-pages 6.7" .SH NAME newlocale, freelocale \- create, modify, and free a locale object .SH LIBRARY @@ -11,17 +11,17 @@ Standard C library .SH SYNOPSIS .nf .B #include <locale.h> -.PP +.P .BI "locale_t newlocale(int " category_mask ", const char *" locale , .BI " locale_t " base ); .BI "void freelocale(locale_t " locobj ); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR newlocale (), .BR freelocale (): .nf @@ -67,7 +67,7 @@ reference returned as the function result. If the call fails, the contents of .I base remain valid and unchanged. -.PP +.P If .I base is the special locale object @@ -78,7 +78,7 @@ or is not .I (locale_t)\ 0 and is not a valid locale object handle, the behavior is undefined. -.PP +.P The .I category_mask argument is a bit mask that specifies the locale categories @@ -101,7 +101,7 @@ and Alternatively, the mask can be specified as .BR LC_ALL_MASK , which is equivalent to ORing all of the preceding constants. -.PP +.P For each category specified in .IR category_mask , the locale data from @@ -112,7 +112,7 @@ If a new locale object is being created, data for all categories not specified in .I category_mask is taken from the default ("POSIX") locale. -.PP +.P The following preset values of .I locale are defined for all categories that can be specified in @@ -146,7 +146,7 @@ If is .B LC_GLOBAL_LOCALE or is not valid locale object handle, the results are undefined. -.PP +.P Once a locale object has been freed, the program should make no further use of it. .SH RETURN VALUE @@ -202,7 +202,7 @@ The second command-line argument is optional; if it is present, it is used to set the .B LC_TIME category of the locale object. -.PP +.P Having created and initialized the locale object, the program then applies it using .BR uselocale (3), @@ -220,15 +220,15 @@ Displaying the date. The format and language of the output will be affected by the .B LC_TIME setting. -.PP +.P The following shell sessions show some example runs of this program. -.PP +.P Set the .B LC_NUMERIC category to .I fr_FR (French): -.PP +.P .in +4n .EX $ \fB./a.out fr_FR\fP @@ -236,7 +236,7 @@ $ \fB./a.out fr_FR\fP Fri Mar 7 00:25:08 2014 .EE .in -.PP +.P Set the .B LC_NUMERIC category to @@ -247,7 +247,7 @@ and the category to .I it_IT (Italian): -.PP +.P .in +4n .EX $ \fB./a.out fr_FR it_IT\fP @@ -255,7 +255,7 @@ $ \fB./a.out fr_FR it_IT\fP ven 07 mar 2014 00:26:01 CET .EE .in -.PP +.P Specify the .B LC_TIME setting as an empty string, @@ -263,7 +263,7 @@ which causes the value to be taken from environment variable settings (which, here, specify .IR mi_NZ , New Zealand Māori): -.PP +.P .in +4n .EX $ LC_ALL=mi_NZ ./a.out fr_FR "" |