@@ -12,7 +12,7 @@ Every Pod document has to begin with C<=begin pod> and end with C<=end pod>.
12
12
Everything between these two delimiters will be processed and used to generate
13
13
documentation.
14
14
15
- = begin code
15
+ = begin code :lang<pod6>
16
16
= begin pod
17
17
18
18
A very simple Perl 6 Pod document
@@ -35,7 +35,7 @@ C<typename> of the block. Typenames that are entirely lowercase (for
35
35
example: C < =begin head1 > ) or entirely uppercase (for example: C < =begin
36
36
SYNOPSIS > ) are reserved.
37
37
38
- = begin code
38
+ = begin code :lang<pod6>
39
39
= begin head1
40
40
Top Level Heading
41
41
= end head1
@@ -92,7 +92,7 @@ The C<=for> marker is followed by the C<typename> of the block
92
92
plus, optionally, any configuration data as in the delimited
93
93
blocks described above.
94
94
95
- = begin code
95
+ = begin code :lang<pod6>
96
96
= for head1
97
97
Top Level Heading
98
98
= end code
@@ -104,7 +104,7 @@ C<typename> of the block. All following data are part of the contents of the
104
104
block, thus configuration data B < cannot > be specified for an I < abbreviated >
105
105
block. The block ends at the next Pod directive or the first blank line.
106
106
107
- = begin code
107
+ = begin code :lang<pod6>
108
108
= head1 Top level heading
109
109
= end code
110
110
@@ -178,7 +178,7 @@ Pod offers a wide range of standard block types.
178
178
Headings can be defined using C < =headN > ,
179
179
where N is greater than zero (e.g., C < =head1 > , C < =head2 > , …).
180
180
181
- = begin code
181
+ = begin code :lang<pod6>
182
182
= head1 A top level heading
183
183
184
184
= head2 A second level heading
@@ -222,7 +222,7 @@ Ordinary paragraphs do not require an explicit marker or delimiters.
222
222
223
223
Alternatively, there is also an explicit C < =para > marker that can be used to explicitly mark a paragraph.
224
224
225
- = begin code
225
+ = begin code :lang<pod6>
226
226
=para
227
227
This is an ordinary paragraph.
228
228
Its text will be squeezed and
@@ -233,7 +233,7 @@ In addition, the longer C<=begin para> and C<=end para> form can be used.
233
233
234
234
For example:
235
235
236
- = begin code
236
+ = begin code :lang<pod6>
237
237
238
238
= begin para
239
239
This is an ordinary paragraph.
@@ -269,7 +269,7 @@ This ordinary paragraph introduces a code block:
269
269
270
270
Code blocks can also be explicitly defined by enclosing them in C < =begin code > and C < =end code >
271
271
272
- = begin code
272
+ = begin code :lang<pod6>
273
273
= begin code
274
274
my $name = 'John Doe';
275
275
say $name;
@@ -313,7 +313,7 @@ The three suspects are:
313
313
314
314
Lists that define terms or commands use C < =defn > , equivalent to the C < DL > lists in HTML
315
315
316
- = begin code
316
+ = begin code :lang<pod6>
317
317
= defn Happy
318
318
When you're not blue.
319
319
@@ -337,7 +337,7 @@ Note that C<=item> is just an abbreviation for C<=item1>.
337
337
338
338
For example:
339
339
340
- = begin code
340
+ = begin code :lang<pod6>
341
341
= item1 Animal
342
342
= item2 Vertebrate
343
343
= item2 Invertebrate
@@ -415,13 +415,13 @@ Pod comments are comments that Pod renderers ignore.
415
415
416
416
Comments are useful for meta-documentation (documenting the documentation). Single-line comments use the C < comment > keyword:
417
417
418
- = begin code
418
+ = begin code :lang<pod6>
419
419
= comment Add more here about the algorithm
420
420
= end code
421
421
422
422
For multi-line comments use a delimited C < comment > block:
423
423
424
- = begin code
424
+ = begin code :lang<pod6>
425
425
= begin comment
426
426
This comment is
427
427
multi-line.
@@ -433,7 +433,7 @@ multi-line.
433
433
All uppercase block typenames are reserved for specifying standard documentation,
434
434
publishing, source components, or meta-information.
435
435
436
- = begin code
436
+ = begin code :lang<pod6>
437
437
=NAME
438
438
=AUTHOR
439
439
=VERSION
@@ -536,7 +536,7 @@ code itself.
536
536
C < P <> > codes are handy for breaking out standard elements of
537
537
your documentation set into reusable components that can then be
538
538
incorporated directly into multiple documents. For example:
539
- = begin code
539
+ = begin code :lang<pod6>
540
540
=COPYRIGHT
541
541
P < file:/shared/docs/std_copyright.pod >
542
542
0 commit comments