Skip to content

Commit 45793f0

Browse files
committed
Normalize use of X<>, L<>, and C<> somewhat
In particular, change some X<foo> to L<foo>. Not all L<foo> are generating working links yet; this is something for future commits to handle. When a term is used frequently in a region of text, the first occurrance is usually linked (with L<foo>), and later ones are marked as code (C<foo>) or emphasized (I<foo>) as appropriate.
1 parent 9ee37cf commit 45793f0

File tree

9 files changed

+21
-22
lines changed

9 files changed

+21
-22
lines changed

lib/Instant.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
An C<Instant> is a particular moment in time measured in atomic seconds, with
88
fractions. It is not tied to or aware of any epoch.
99
10-
An C<Instant> can be used to create a C<DateTime> object set to that
10+
An C<Instant> can be used to create a L<DateTime> object set to that
1111
C<Instant>. The pseudo-constant C<now> returns the current time as an
1212
C<Instant>.
1313

lib/List.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -198,7 +198,7 @@ stop at the point where the infinity is detected.
198198
Returns a list with the same elements in reverse order.
199199
200200
Note that C<reverse> always refers to reversing elements of a list;
201-
to reverse the characters in a string, use X<flip>.
201+
to reverse the characters in a string, use L<flip>.
202202
203203
=head2 rotate
204204

lib/Pair.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ parts of the C<Pair> formatted. Here's an example:
4242
say $pair.fmt("%s is %.3f AU away from the sun")
4343
# Prints "Earth is 1.000 AU away from the sun"
4444
45-
For more about format strings, see X<sprintf>.
45+
For more about format strings, see L<sprintf>.
4646
4747
=head2 kv
4848

lib/Routine.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
55
class Routine is Block { }
66
7-
A I<Routine> is a code object meant for larger unities of code than L<Block>.
7+
A C<Routine> is a code object meant for larger unities of code than L<Block>.
88
Routine is the common superclass for L<Sub> and L<Method>, the two primary
99
code objects for code reuse.
1010

lib/Str.pod

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ case
8686
Performs a Unicode titlecase operation on the first character of
8787
each word of the string (as defined by a regex C<«> boundary),
8888
and forces the rest of the letters through a filter that defaults
89-
to C<lc>. After this operation, if any exceptions are supplied and
89+
to L<lc>. After this operation, if any exceptions are supplied and
9090
if the word is found in the set of exceptions, the first character is also
9191
forced through the filter. Note that the exceptions must be spelled with
9292
an initial titlecase, such as "By" or "And", to produce "by" or "and".
@@ -99,11 +99,11 @@ Perl 6 does not have a C<lcfirst> function.
9999
100100
=head2 ucfirst
101101
102-
Perl 6 does not have a C<ucfirst> function. See X<tc>.
102+
Perl 6 does not have a C<ucfirst> function. See L<tc>.
103103
104104
=head2 length
105105
106-
Perl 6 does not have a C<length> function. See X<chars> or X<elems>.
106+
Perl 6 does not have a C<length> function. See L<chars> or L<elems>.
107107
108108
=head2 chars
109109
@@ -117,7 +117,7 @@ Returns the number of characters in the string in the current
117117
118118
multi method encode(Str:D: $encoding = $?ENC, $nf = $?NF) returns Buf
119119
120-
Returns a C<Buf> which represents the original string in the given encoding
120+
Returns a L<Buf> which represents the original string in the given encoding
121121
and normal form. The actual return type is as specific as possible, so
122122
C<$str.encode('UTF-8')> returns a C<utf8> object,
123123
C<$str.encode('ISO-8859-1')> a C<buf8>.
@@ -156,7 +156,7 @@ If the named parameter C<:all> is passed, the matches from C<$delimiter>
156156
are included in the result list.
157157
158158
Note that unlike in Perl 5, empty chunks are not removed from the result list.
159-
If you want that behavior, consider using C<Str.comb> instead.
159+
If you want that behavior, consider using L<comb> instead.
160160
161161
=head2 comb
162162
@@ -167,7 +167,7 @@ If you want that behavior, consider using C<Str.comb> instead.
167167
multi method comb(Str:D $input: Regex:D $matcher, $limit = Inf, Bool :$match)
168168
169169
Searches for C<$matcher> in C<$input> and returns a list of all matches
170-
(as C<Str> by default, or as C<Match> if C<$match> is True), limited to at most
170+
(as C<Str> by default, or as L<Match> if C<$match> is True), limited to at most
171171
C<$limit> matches.
172172
173173
If no matcher is supplied, a list of characters in the string
@@ -303,7 +303,7 @@ character can be uniquely classified as belonging to one range of characters.
303303
Returns the string decremented by one.
304304
305305
String decrementing is "magical" just like string increment (see
306-
C<Str.succ>). It fails on underflow
306+
L<succ>). It fails on underflow
307307
308308
'b0'.pred # a9
309309
'a0'.pred # Failure

lib/Version.pod

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ Version objects identify version of software components (and potentially other
66
entities). Perl 6 uses them internally for versioning modules.
77
88
A version consists of several parts, which are visually represented by joining
9-
them with a dot. A version part is usually an integer, a string like I<alpha>,
9+
them with a dot. A version part is usually an integer, a string like C<alpha>,
1010
or a L<Whatever>-star C<*>. The latter is used to indicate that any version
1111
part is acceptable in another version that is compared to the current one.
1212
1313
say v1.0.1 ~~ v.1.*; # True
1414
1515
Version literals can only contain numeric and L<Whatever> parts. They start
16-
with a lowe-case C<v>, and are followed by at least one part. Multiple parts
16+
with a lower-case C<v>, and are followed by at least one part. Multiple parts
1717
are separate with a dot C<.>. A trailing C<+> indicates that higher versions
1818
are OK in comparisons:
1919

lib/objects.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ Private methods are not inherited to subclasses.
209209
=head2 Submethods
210210
211211
A submethod is public method that is not inherited to subclasses. The name
212-
stems from the fact that they are sematically similar to subroutines.
212+
stems from the fact that they are semantically similar to subroutines.
213213
214214
Submethods are useful for object construction and destruction tasks, as well
215215
as for tasks that are so specific to a certain type that subtypes must

lib/operators.pod

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -59,8 +59,7 @@ for binary operators are interpreted as follows:
5959
6060
=end table
6161
62-
For unaries this is interpreted as:
63-
62+
For unary operators this is interpreted as:
6463
6564
=begin table
6665
@@ -294,7 +293,7 @@ same as C<< prefix:<!> >>.
294293
295294
I<upto> operator.
296295
297-
Coerces the argument to C<Numeric>, and generates a range from 0 up to (but
296+
Coerces the argument to L<Numeric>, and generates a range from 0 up to (but
298297
excluding) the argument.
299298
300299
say ^5; # 0..^5
@@ -337,7 +336,7 @@ Generally the following identity holds:
337336
338337
multi sub infix:<%%>($a, $b) returns Bool:D
339338
340-
Divisibility operator. Returns C<True> if L<$a % $b == 0>.
339+
Divisibility operator. Returns C<True> if C<$a % $b == 0>.
341340
342341
=head2 infix mod
343342
@@ -350,7 +349,7 @@ Integer modulo operator. Returns the remainder of an integer modulo operation.
350349
multi sub infix:<+&>($a, $b) returns Int:D
351350
352351
Numeric bitwise I<AND>. Coerces both arguments to L<Int> and does a bitwise
353-
L<AND> operation assuming two's complement.
352+
I<AND> operation assuming two's complement.
354353
355354
=head2 infix +<
356355
@@ -775,7 +774,7 @@ For value types, C<===> behaves like C<eqv>:
775774
say 1 === 1.0; # False
776775
777776
C<===> uses the L<WHICH> method to obtain the object identity, so all value
778-
types must override method L<WHICH>.
777+
types must override method C<WHICH>.
779778
780779
=head2 infix =:=
781780

lib/variables.pod

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
=TITLE Perl 6 variables
44
55
Variable names start with a special character called a I<sigil>, followed
6-
optionally by a second special character named C<twigil>, and then an
7-
identifer.
6+
optionally by a second special character named I<twigil>, and then an
7+
I<identifer>.
88
99
=head1 Sigils
1010

0 commit comments

Comments
 (0)