Skip to content

Commit 7676f9f

Browse files
authored
escaped __DATA__ in code blocks
from __DATA__ to \_\_DATA\_\_
1 parent 59502a5 commit 7676f9f

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

tutorial/tutorial-english.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -495,9 +495,9 @@ A whole day is passed, well.. two days, and we did not wrote a single line of pe
495495
<a id="daytwostep1"></a>
496496
<h4>step 1) POD documentation</h4>
497497

498-
Well first of all some cleaning: open you local copy of the module <code>/path/to/Range-Validator/lib/Range/Validator.pm</code> in your text editor or IDE. Personally I like the POD documentation to be all together after the <code>__DATA__</code> token rather interleaved with the code. Inside the code I only like to have comments. POD documentation is for the user, comments are for you! After a week or month you'll never remember what your code is doing: comment it explaining what is passing.
498+
Well first of all some cleaning: open you local copy of the module <code>/path/to/Range-Validator/lib/Range/Validator.pm</code> in your text editor or IDE. Personally I like the POD documentation to be all together after the <code>\_\_DATA\_\_</code> token rather interleaved with the code. Inside the code I only like to have comments. POD documentation is for the user, comments are for you! After a week or month you'll never remember what your code is doing: comment it explaining what is passing.
499499

500-
So go to the end of the module where the line is the final <code>1;</code> ( remember all modules must have a true return value as last statement) and place, in a new line the <code>__DATA__</code> token. Move all POD after the token. Also cancel the POD and the code relative to <code>function2</code>
500+
So go to the end of the module where the line is the final <code>1;</code> ( remember all modules must have a true return value as last statement) and place, in a new line the <code>\_\_DATA\_\_</code> token. Move all POD after the token. Also cancel the POD and the code relative to <code>function2</code>
501501

502502
Then rename <code>function1</code> into <code>validate</code> and change accordingly the name of the POD section too.
503503

@@ -1074,7 +1074,7 @@ This function accepts a string or a list (range) and returns an array.
10741074
In the string form the accepted characters are: positive integers, dots, commas and spaces. Every space will be removed.
10751075

10761076
</pre>
1077-
We do not need <code>=cut</code> anymore because we do not have POD in blocks interleaved with the code, but an unique POD block in the <code>__DATA__</code> section.
1077+
We do not need <code>=cut</code> anymore because we do not have POD in blocks interleaved with the code, but an unique POD block in the <code>\_\_DATA\_\_</code> section.
10781078

10791079

10801080

0 commit comments

Comments
 (0)