Skip to content

Commit eb992c6

Browse files
committed
Change some link pod for better rendering
C<L</foo>> renders better in places than L</C<foo>>
1 parent 2de859c commit eb992c6

File tree

9 files changed

+24
-24
lines changed

9 files changed

+24
-24
lines changed

README.os2

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -300,7 +300,7 @@ with
300300
perl ../../blah/foo.cmd arg1 arg2 arg3
301301

302302
(note that the argument C<-my_opts> is taken care of by the C<extproc> line
303-
in your script, see L</C<extproc> on the first line>).
303+
in your script, see C<L</extproc> on the first line>).
304304

305305
To understand what the above I<magic> does, read perl docs about C<-S>
306306
switch - see L<perlrun>, and cmdref about C<extproc>:
@@ -558,7 +558,7 @@ of this file.
558558

559559
B<NOTE>. Because of a typo the binary installer of 5.00305
560560
would install a variable C<PERL_SHPATH> into F<Config.sys>. Please
561-
remove this variable and put L</C<PERL_SH_DIR>> instead.
561+
remove this variable and put C<L</PERL_SH_DIR>> instead.
562562

563563
=head2 Manual binary installation
564564

hv.c

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3737,10 +3737,10 @@ Returns the label attached to a cop, and stores its length in bytes into
37373737
C<*len>.
37383738
Upon return, C<*flags> will be set to either C<SVf_UTF8> or 0.
37393739
3740-
Alternatively, use the macro L</C<CopLABEL_len_flags>>;
3740+
Alternatively, use the macro C<L</CopLABEL_len_flags>>;
37413741
or if you don't need to know if the label is UTF-8 or not, the macro
3742-
L</C<CopLABEL_len>>;
3743-
or if you additionally dont need to know the length, L</C<CopLABEL>>.
3742+
C<L</CopLABEL_len>>;
3743+
or if you additionally dont need to know the length, C<L</CopLABEL>>.
37443744
37453745
=cut
37463746
*/

lib/overload.pm

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
package overload;
22

3-
our $VERSION = '1.31';
3+
our $VERSION = '1.32';
44

55
%ops = (
66
with_assign => "+ - * / % ** << >> x .",
@@ -1239,7 +1239,7 @@ Put this in F<symbolic.pm> in your Perl library directory:
12391239
12401240
This module is very unusual as overloaded modules go: it does not
12411241
provide any usual overloaded operators, instead it provides an
1242-
implementation for L</C<nomethod>>. In this example the C<nomethod>
1242+
implementation for C<L</nomethod>>. In this example the C<nomethod>
12431243
subroutine returns an object which encapsulates operations done over
12441244
the objects: C<< symbolic->new(3) >> contains C<['n', 3]>, C<< 2 +
12451245
symbolic->new(3) >> contains C<['+', 2, ['n', 3]]>.

pod/perl5120delta.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -573,7 +573,7 @@ could create names that are, for example, made up entirely of punctuation
573573
symbols. It is now deprecated to make names that don't begin with an
574574
alphabetic character, and aren't alphanumeric or contain other than
575575
a very few other characters, namely spaces, dashes, parentheses
576-
and colons. Because of the added meaning of C<\N> (See L</C<\N>
576+
and colons. Because of the added meaning of C<\N> (See C<L</\N>
577577
experimental regex escape>), names that look like curly brace -enclosed
578578
quantifiers won't work. For example, C<\N{3,4}> now means to match 3 to
579579
4 non-newlines; before a custom name C<3,4> could have been created.

pod/perlre.pod

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -296,7 +296,7 @@ string as a multi-line buffer, such that the C<"^"> will match after any
296296
newline within the string (except if the newline is the last character in
297297
the string), and C<"$"> will match before any newline. At the
298298
cost of a little more overhead, you can do this by using the
299-
L</C<E<sol>m>> modifier on the pattern match operator. (Older programs
299+
C<L</E<sol>m>> modifier on the pattern match operator. (Older programs
300300
did this by setting C<$*>, but this option was removed in perl 5.10.)
301301
X<^> X<$> X</m>
302302

@@ -710,7 +710,7 @@ the pattern uses a Unicode break (C<\b{...}> or C<\B{...}>); or
710710

711711
=item 7
712712

713-
the pattern uses L</C<(?[ ])>>
713+
the pattern uses C<L</(?[ ])>>
714714

715715
=item 8
716716

@@ -926,7 +926,7 @@ string" problem can be most efficiently performed when written as:
926926

927927
as we know that if the final quote does not match, backtracking will not
928928
help. See the independent subexpression
929-
L</C<< (?>I<pattern>) >>> for more details;
929+
C<L</(?E<gt>I<pattern>)>> for more details;
930930
possessive quantifiers are just syntactic sugar for that construct. For
931931
instance the above example could also be written as follows:
932932

@@ -2575,7 +2575,7 @@ you can write either of these:
25752575
(*atomic_script_run:pattern)
25762576
(*asr:pattern)
25772577

2578-
(See L</C<(?E<gt>I<pattern>)>>.)
2578+
(See C<L</(?E<gt>I<pattern>)>>.)
25792579

25802580
In Taiwan, Japan, and Korea, it is common for text to have a mixture of
25812581
characters from their native scripts and base Chinese. Perl follows

pod/perlrebackslash.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -576,7 +576,7 @@ The boundary types are:
576576

577577
This matches a Unicode "Grapheme Cluster Boundary". (Actually Perl
578578
always uses the improved "extended" grapheme cluster"). These are
579-
explained below under L</C<\X>>. In fact, C<\X> is another way to get
579+
explained below under C<L</\X>>. In fact, C<\X> is another way to get
580580
the same functionality. It is equivalent to C</.+?\b{gcb}/>. Use
581581
whichever is most convenient for your situation.
582582

pod/perlrun.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -957,7 +957,7 @@ X<-X>
957957
Disables all warnings regardless of C<use warnings> or C<$^W>.
958958
See L<warnings>.
959959

960-
Forbidden in L</C<PERL5OPT>>.
960+
Forbidden in C<L</PERL5OPT>>.
961961

962962
=item B<-x>
963963
X<-x>

utf8.c

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -493,7 +493,7 @@ different extension. For these reasons, there is a separate set of flags that
493493
can warn and/or disallow these extremely high code points, even if other
494494
above-Unicode ones are accepted. They are the C<UNICODE_WARN_PERL_EXTENDED>
495495
and C<UNICODE_DISALLOW_PERL_EXTENDED> flags. For more information see
496-
L</C<UTF8_GOT_PERL_EXTENDED>>. Of course C<UNICODE_DISALLOW_SUPER> will
496+
C<L</UTF8_GOT_PERL_EXTENDED>>. Of course C<UNICODE_DISALLOW_SUPER> will
497497
treat all above-Unicode code points, including these, as malformations. (Note
498498
that the Unicode standard considers anything above 0x10FFFF to be illegal, but
499499
there are standards predating it that allow up to 0x7FFF_FFFF (2**31 -1))
@@ -1260,7 +1260,7 @@ different extension. For these reasons, there is a separate set of flags that
12601260
can warn and/or disallow these extremely high code points, even if other
12611261
above-Unicode ones are accepted. They are the C<UTF8_WARN_PERL_EXTENDED> and
12621262
C<UTF8_DISALLOW_PERL_EXTENDED> flags. For more information see
1263-
L</C<UTF8_GOT_PERL_EXTENDED>>. Of course C<UTF8_DISALLOW_SUPER> will treat all
1263+
C<L</UTF8_GOT_PERL_EXTENDED>>. Of course C<UTF8_DISALLOW_SUPER> will treat all
12641264
above-Unicode code points, including these, as malformations.
12651265
(Note that the Unicode standard considers anything above 0x10FFFF to be
12661266
illegal, but there are standards predating it that allow up to 0x7FFF_FFFF
@@ -1393,7 +1393,7 @@ C<UTF8_DISALLOW_NONCHAR> or the C<UTF8_WARN_NONCHAR> flags.
13931393
13941394
The input sequence was malformed in that a non-continuation type byte was found
13951395
in a position where only a continuation type one should be. See also
1396-
L</C<UTF8_GOT_SHORT>>.
1396+
C<L</UTF8_GOT_SHORT>>.
13971397
13981398
=item C<UTF8_GOT_OVERFLOW>
13991399

utf8.h

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -539,16 +539,16 @@ If there is a possibility of malformed input, use instead:
539539
540540
=over
541541
542-
=item L</C<UTF8_SAFE_SKIP>> if you know the maximum ending pointer in the
542+
=item C<L</UTF8_SAFE_SKIP>> if you know the maximum ending pointer in the
543543
buffer pointed to by C<s>; or
544544
545-
=item L</C<UTF8_CHK_SKIP>> if you don't know it.
545+
=item C<L</UTF8_CHK_SKIP>> if you don't know it.
546546
547547
=back
548548
549549
It is better to restructure your code so the end pointer is passed down so that
550550
you know what it actually is at the point of this call, but if that isn't
551-
possible, L</C<UTF8_CHK_SKIP>> can minimize the chance of accessing beyond the end
551+
possible, C<L</UTF8_CHK_SKIP>> can minimize the chance of accessing beyond the end
552552
of the input buffer.
553553
554554
=cut
@@ -557,7 +557,7 @@ of the input buffer.
557557

558558
/*
559559
=for apidoc Am|STRLEN|UTF8_SKIP|char* s
560-
This is a synonym for L</C<UTF8SKIP>>
560+
This is a synonym for C<L</UTF8SKIP>>
561561
562562
=cut
563563
*/
@@ -567,8 +567,8 @@ This is a synonym for L</C<UTF8SKIP>>
567567
/*
568568
=for apidoc Am|STRLEN|UTF8_CHK_SKIP|char* s
569569
570-
This is a safer version of L</C<UTF8SKIP>>, but still not as safe as
571-
L</C<UTF8_SAFE_SKIP>>. This version doesn't blindly assume that the input
570+
This is a safer version of C<L</UTF8SKIP>>, but still not as safe as
571+
C<L</UTF8_SAFE_SKIP>>. This version doesn't blindly assume that the input
572572
string pointed to by C<s> is well-formed, but verifies that there isn't a NUL
573573
terminating character before the expected end of the next character in C<s>.
574574
The length C<UTF8_CHK_SKIP> returns stops just before any such NUL.
@@ -579,7 +579,7 @@ beyond the end of the input buffer, even if it is malformed UTF-8.
579579
580580
This macro is intended to be used by XS modules where the inputs could be
581581
malformed, and it isn't feasible to restructure to use the safer
582-
L</C<UTF8_SAFE_SKIP>>, for example when interfacing with a C library.
582+
C<L</UTF8_SAFE_SKIP>>, for example when interfacing with a C library.
583583
584584
=cut
585585
*/

0 commit comments

Comments
 (0)