locale documentation: Grammaar and appearance nits

diff --git a/ext/POSIX/lib/POSIX.pod b/ext/POSIX/lib/POSIX.pod
index ff201b8..325d92a 100644 (file)
--- a/ext/POSIX/lib/POSIX.pod
+++ b/ext/POSIX/lib/POSIX.pod
@@ -728,8 +728,7 @@ for creating hard links into files, see L<perlfunc/link>.
 Get numeric formatting information.  Returns a reference to a hash
 containing the current locale formatting values.
 Users of this function should also read L<perllocale>, where there is a
-discussion devoted to this function
-(L<perllocale/The localeconv function>).
+L<discussion devoted to this function|perllocale/The localeconv function>.
 
 Here is how to query the database for the B<de> (Deutsch or German) locale.
 
@@ -1086,11 +1085,11 @@ see L<perlfunc/eval>.
 =item setlocale
 
 Modifies and queries the program's underlying locale.  Users of this
-function should also read L<perllocale>, where there is a discussion
-devoted to this function (L<perllocale/The setlocale function>).
+function should also read L<perllocale>, where there is a
+L<discussion devoted to this function|perllocale/The setlocale function>.
 Note that Perl itself is almost entirely unaffected by the locale
 except within the scope of S<C<"use locale">>.  (Exceptions are listed
-in L<perllocale/Not within the scope of any use locale variant>.)
+in L<perllocale/Not within the scope of any "use locale" variant>.)
 
 The following examples assume
 
@@ -1110,7 +1109,7 @@ argument means 'query'.)
 
 The following will set the LC_CTYPE behaviour according to the locale
 environment variables (the second argument C<"">).
-Please see your systems C<setlocale(3)> documentation for the locale
+Please see your system's C<setlocale(3)> documentation for the locale
 environment variables' meaning or consult L<perllocale>.
 
        $loc = setlocale( LC_CTYPE, "" );

diff --git a/pod/perlembed.pod b/pod/perlembed.pod
index 8b4d2da..b06a242 100644 (file)
--- a/pod/perlembed.pod
+++ b/pod/perlembed.pod
@@ -1076,7 +1076,7 @@ When a Perl interpreter normally starts up, it tells the system it wants
 to use the system's default locale.  This is often, but not necessarily,
 the "C" or "POSIX" locale.  Absent a S<C<"use locale">> within the perl
 code, this mostly has no effect (but see L<perllocale/Not within the
-scope of any use locale variant>).  Also, there is not a problem if the
+scope of any "use locale" variant>).  Also, there is not a problem if the
 locale you want to use in your embedded Perl is the same as the system
 default.  However, this doesn't work if you have set up and want to use
 a locale that isn't the system default one.  Starting in Perl v5.20, you

diff --git a/pod/perllocale.pod b/pod/perllocale.pod
index d0d197f..c29c9af 100644 (file)
--- a/pod/perllocale.pod
+++ b/pod/perllocale.pod
@@ -89,7 +89,7 @@ This indicates, for example if a character is an uppercase letter.
 Some platforms have other categories, dealing with such things as
 measurement units and paper sizes.  None of these are used directly by
 Perl, but outside operations that Perl interacts with may use
-these.  See L</Not within the scope of any use locale variant> below.
+these.  See L</Not within the scope of any "use locale" variant> below.
 
 =back
 
@@ -190,7 +190,7 @@ The operations that are affected by locale are:
 
 =over 4
 
-=item B<Not within the scope of any C<use locale> variant>
+=item B<Not within the scope of any C<"use locale"> variant>
 
 Only operations originating outside Perl should be affected.
 
@@ -236,7 +236,7 @@ behavior, not if the matches are done within such a scope or not.
 
 =back
 
-=item B<Under C<use locale ':not_characters';>>
+=item B<Under C<"use locale ':not_characters';">>
 
 =over 4
 
@@ -266,7 +266,7 @@ The nbsp below makes this look better
 
 E<160>
 
-=item B<Under just plain C<use locale;>>
+=item B<Under just plain C<"use locale";>>
 
 =over 4