-
Notifications
You must be signed in to change notification settings - Fork 0
/
pod.pod6
64 lines (49 loc) · 2.33 KB
/
pod.pod6
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
=begin pod
=CHAPTER Формат Pod
Широко известный формат ведения документации в perl5 - POD
(Plain Old Documentation) совсем недавно отпраздновал 15 лет.
Вместе с новой версией perl6 готовится новый формат : Pod.
Чем отличается perl 5 POD от Perl 6 Pod ?
Немного исторических дат, связанных с обоими форматами:
=defn 18 октября 1994
В списке анонса perl 5.000 присутвует поддержка POD
=code
18 October 1994:
It was a complete rewrite of Perl.
A few of the features and pitfalls are:
...
* The documentation is much more extensive
and perldoc along with pod is introduced.
..
=defn 9 апреля 2005
S26: cпецификация формата Pod для perl6. Автор - L<Damian Conway|http://en.wikipedia.org/wiki/Damian_Conway>.
=defn 25 Apr 2007
Первая редакция формата.
=defn August 16, 2009
S26 - The Next Generation ( L<preview|http://www.nntp.perl.org/group/perl.perl6.language/2009/08/msg32352.html>).
=defn 31 Jul 2010
Последняя редакция. Появились декларативные блоки.
В то время как существующий ныне B<POD> означает Perl Old Documentation,
cпецификация s26 представляет новый формат следующим образом:
=for nested :formatted<I>
B<Pod> - является эволюцией POD. В сравнении с POD, Perl 6 Pod более однороден, компактен и выразительнее. Pod также характеризуется описательной нотацией разметки, чем презентационной.
Таким образом B<Pod> избавился от слова "старый".
=Include p01_struct.pod6
=Include p02_bloks.pod6
=Include p03_conf.pod6
=comment
# =Include p04_ext.pod6
=Include p11_nested.pod6
=Include p12_lists.pod6
=Include p10_pseud.pod6
=Include p13_levels.pod6
=Include p06_iobloks.pod6
=Include p07_fcodeX.pod6
=Include p08_fcodeE.pod6
=Include p09_fcodeN.pod6
=Include p14_fcodeD.pod6
=Include p15_fcodeZ.pod6
=Include p16_fcodeS.pod6
=Include p05_semantic.pod6
=Include p17_fcode_codspec.pod6
=end pod