diff options
Diffstat (limited to 'man3/duplocale.3')
-rw-r--r-- | man3/duplocale.3 | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 246af79e9..bce4b7154 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -17,7 +17,7 @@ Standard C library .P .RS -4 Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): +.MR feature_test_macros 7 ): .RE .P .BR duplocale (): @@ -40,7 +40,7 @@ is .BR duplocale () creates a locale object containing a copy of the global locale determined by -.BR setlocale (3). +.MR setlocale 3 . .SH RETURN VALUE On success, .BR duplocale () @@ -63,11 +63,11 @@ Duplicating a locale can serve the following purposes: .IP \[bu] 3 To create a copy of a locale object in which one of more categories are to be modified (using -.BR newlocale (3)). +.MR newlocale 3 ). .IP \[bu] To obtain a handle for the current locale which can used in other functions that employ a locale handle, such as -.BR toupper_l (3). +.MR toupper_l 3 . This is done by applying .BR duplocale () to the value returned by the following call: @@ -79,11 +79,11 @@ loc = uselocale((locale_t) 0); .in .IP This technique is necessary, because the above -.BR uselocale (3) +.MR uselocale 3 call may return the value .BR LC_GLOBAL_LOCALE , which results in undefined behavior if passed to functions such as -.BR toupper_l (3). +.MR toupper_l 3 . Calling .BR duplocale () can be used to ensure that the @@ -97,11 +97,11 @@ should be deallocated using .BR freelocale (3). .SH EXAMPLES The program below uses -.BR uselocale (3) +.MR uselocale 3 and .BR duplocale () to obtain a handle for the current locale which is then passed to -.BR toupper_l (3). +.MR toupper_l 3 . The program takes one command-line argument, a string of characters that is converted to uppercase and displayed on standard output. @@ -160,9 +160,9 @@ main(int argc, char *argv[]) .EE .\" SRC END .SH SEE ALSO -.BR freelocale (3), -.BR newlocale (3), -.BR setlocale (3), -.BR uselocale (3), -.BR locale (5), -.BR locale (7) +.MR freelocale 3 , +.MR newlocale 3 , +.MR setlocale 3 , +.MR uselocale 3 , +.MR locale 5 , +.MR locale 7 |