summaryrefslogtreecommitdiffstats
path: root/man3/duplocale.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/duplocale.3')
-rw-r--r--man3/duplocale.328
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