github-markup 3.0.2 → 3.0.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.travis.yml +1 -7
- data/HISTORY.md +4 -0
- data/github-markup.gemspec +1 -1
- data/lib/github-markup.rb +1 -1
- data/lib/github/commands/pod62html +1 -6
- metadata +2 -32
- data/.gitmodules +0 -3
- data/test/markups/README.pod6 +0 -151
- data/test/markups/README.pod6.html +0 -128
- data/vendor/Pod-To-HTML/LICENSE +0 -201
- data/vendor/Pod-To-HTML/META6.json +0 -20
- data/vendor/Pod-To-HTML/README.md +0 -96
- data/vendor/Pod-To-HTML/README.pod6 +0 -42
- data/vendor/Pod-To-HTML/TODO +0 -5
- data/vendor/Pod-To-HTML/lib/Pod/To/HTML.pm +0 -691
- data/vendor/Pod-To-HTML/resources/examples/01-parse-files.p6 +0 -7
- data/vendor/Pod-To-HTML/resources/examples/README.md +0 -13
- data/vendor/Pod-To-HTML/resources/examples/main.mustache +0 -26
- data/vendor/Pod-To-HTML/resources/examples/render.p6 +0 -17
- data/vendor/Pod-To-HTML/resources/templates/main.mustache +0 -32
- data/vendor/Pod-To-HTML/t/010-basic.t +0 -29
- data/vendor/Pod-To-HTML/t/020-code.t +0 -49
- data/vendor/Pod-To-HTML/t/030-comment.t +0 -15
- data/vendor/Pod-To-HTML/t/040-lists.t +0 -82
- data/vendor/Pod-To-HTML/t/050-format-x-index.t +0 -47
- data/vendor/Pod-To-HTML/t/060-table.t +0 -108
- data/vendor/Pod-To-HTML/t/070-headings.t +0 -45
- data/vendor/Pod-To-HTML/t/075-defn.t +0 -45
- data/vendor/Pod-To-HTML/t/080-lang.t +0 -14
- data/vendor/Pod-To-HTML/t/090-css.t +0 -16
- data/vendor/Pod-To-HTML/t/100-issue-37.t +0 -16
- data/vendor/Pod-To-HTML/t/110-issue-41.t +0 -18
- data/vendor/Pod-To-HTML/t/120-templates.t +0 -42
- data/vendor/Pod-To-HTML/t/templates/main.mustache +0 -33
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c3af7e9cf8ed0fbc63c2705e680b36470373ee6c8d65f4140364c850413b9e3c
|
4
|
+
data.tar.gz: 64d493460cd36838258eba6c51b8fb6d8273780aa9a4de4ccd70567016d44ec3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b02b26218266f9fdbf1211ee4cea875936936ddebed1a4b784b327a2911c1ae8ba6173f98b3d78b06b8e558afb87f707c136eac00a1e7696d6b0d610c4864bed
|
7
|
+
data.tar.gz: 29820c650182ee9fb73cfbbe809a89ae7aa681359b8cd3d5116bc7cfe59e72cf96f971cdb96bc67d26e42546bc4b56d1694f31f735eeb465897db6d242491889
|
data/.travis.yml
CHANGED
@@ -6,9 +6,6 @@ rvm:
|
|
6
6
|
- 2.2.7
|
7
7
|
- 2.3.4
|
8
8
|
- 2.4.1
|
9
|
-
- jruby-9.1.9.0
|
10
|
-
jdk:
|
11
|
-
- oraclejdk8
|
12
9
|
notifications:
|
13
10
|
email: false
|
14
11
|
git:
|
@@ -18,7 +15,7 @@ before_install:
|
|
18
15
|
- echo "deb https://dl.bintray.com/nxadm/rakudo-pkg-debs `lsb_release -cs` main" | sudo tee -a /etc/apt/sources.list.d/rakudo-pkg.list
|
19
16
|
- sudo apt-get update -qq
|
20
17
|
- sudo apt-get install perl rakudo-pkg
|
21
|
-
- export PATH=$PATH:/.perl6/bin:/opt/rakudo-pkg/bin
|
18
|
+
- export PATH=$PATH:/.perl6/bin:/opt/rakudo-pkg/bin
|
22
19
|
- curl -L http://cpanmin.us | perl - --sudo App::cpanminus
|
23
20
|
- sudo cpanm --installdeps --notest Pod::Simple
|
24
21
|
- sudo pip install docutils
|
@@ -28,6 +25,3 @@ cache:
|
|
28
25
|
env:
|
29
26
|
global:
|
30
27
|
- "JRUBY_OPTS=-Xcext.enabled=true"
|
31
|
-
matrix:
|
32
|
-
allow_failures:
|
33
|
-
- rvm: jruby-9.1.9.0
|
data/HISTORY.md
CHANGED
data/github-markup.gemspec
CHANGED
@@ -12,7 +12,7 @@ Gem::Specification.new do |s|
|
|
12
12
|
s.license = "MIT"
|
13
13
|
|
14
14
|
s.files = `git ls-files`.split($\)
|
15
|
-
s.files += Dir['vendor
|
15
|
+
s.files += Dir['vendor/**/*']
|
16
16
|
s.executables = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
|
17
17
|
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
18
18
|
s.require_paths = %w[lib]
|
data/lib/github-markup.rb
CHANGED
@@ -1,10 +1,5 @@
|
|
1
1
|
#!/usr/bin/env perl6
|
2
2
|
|
3
3
|
use v6;
|
4
|
-
use lib $*PROGRAM.IO.parent.add: '../../../vendor/Pod-To-HTML';
|
5
|
-
use Pod::To::HTML;
|
6
4
|
|
7
|
-
|
8
|
-
s:s{\<\!doctype html\>.*\<div id\=\"___top\"\>\<\/div\>\s*} = "";
|
9
|
-
s:s{\s*\<\/div\>\s*\<\/body\>\s*\<\/html\>\s*} = "";
|
10
|
-
.put;
|
5
|
+
slurp.put;
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: github-markup
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.0.
|
4
|
+
version: 3.0.3
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Chris Wanstrath
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2018-12-
|
11
|
+
date: 2018-12-17 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rake
|
@@ -144,7 +144,6 @@ extra_rdoc_files: []
|
|
144
144
|
files:
|
145
145
|
- ".dockerignore"
|
146
146
|
- ".gitignore"
|
147
|
-
- ".gitmodules"
|
148
147
|
- ".kick"
|
149
148
|
- ".travis.yml"
|
150
149
|
- CODE_OF_CONDUCT.md
|
@@ -191,8 +190,6 @@ files:
|
|
191
190
|
- test/markups/README.org.html
|
192
191
|
- test/markups/README.pod
|
193
192
|
- test/markups/README.pod.html
|
194
|
-
- test/markups/README.pod6
|
195
|
-
- test/markups/README.pod6.html
|
196
193
|
- test/markups/README.rdoc
|
197
194
|
- test/markups/README.rdoc.html
|
198
195
|
- test/markups/README.rst
|
@@ -205,31 +202,6 @@ files:
|
|
205
202
|
- test/markups/README.toc.rst.html
|
206
203
|
- test/markups/README.txt
|
207
204
|
- test/markups/README.txt.html
|
208
|
-
- vendor/Pod-To-HTML/LICENSE
|
209
|
-
- vendor/Pod-To-HTML/META6.json
|
210
|
-
- vendor/Pod-To-HTML/README.md
|
211
|
-
- vendor/Pod-To-HTML/README.pod6
|
212
|
-
- vendor/Pod-To-HTML/TODO
|
213
|
-
- vendor/Pod-To-HTML/lib/Pod/To/HTML.pm
|
214
|
-
- vendor/Pod-To-HTML/resources/examples/01-parse-files.p6
|
215
|
-
- vendor/Pod-To-HTML/resources/examples/README.md
|
216
|
-
- vendor/Pod-To-HTML/resources/examples/main.mustache
|
217
|
-
- vendor/Pod-To-HTML/resources/examples/render.p6
|
218
|
-
- vendor/Pod-To-HTML/resources/templates/main.mustache
|
219
|
-
- vendor/Pod-To-HTML/t/010-basic.t
|
220
|
-
- vendor/Pod-To-HTML/t/020-code.t
|
221
|
-
- vendor/Pod-To-HTML/t/030-comment.t
|
222
|
-
- vendor/Pod-To-HTML/t/040-lists.t
|
223
|
-
- vendor/Pod-To-HTML/t/050-format-x-index.t
|
224
|
-
- vendor/Pod-To-HTML/t/060-table.t
|
225
|
-
- vendor/Pod-To-HTML/t/070-headings.t
|
226
|
-
- vendor/Pod-To-HTML/t/075-defn.t
|
227
|
-
- vendor/Pod-To-HTML/t/080-lang.t
|
228
|
-
- vendor/Pod-To-HTML/t/090-css.t
|
229
|
-
- vendor/Pod-To-HTML/t/100-issue-37.t
|
230
|
-
- vendor/Pod-To-HTML/t/110-issue-41.t
|
231
|
-
- vendor/Pod-To-HTML/t/120-templates.t
|
232
|
-
- vendor/Pod-To-HTML/t/templates/main.mustache
|
233
205
|
homepage: https://github.com/github/markup
|
234
206
|
licenses:
|
235
207
|
- MIT
|
@@ -275,8 +247,6 @@ test_files:
|
|
275
247
|
- test/markups/README.org.html
|
276
248
|
- test/markups/README.pod
|
277
249
|
- test/markups/README.pod.html
|
278
|
-
- test/markups/README.pod6
|
279
|
-
- test/markups/README.pod6.html
|
280
250
|
- test/markups/README.rdoc
|
281
251
|
- test/markups/README.rdoc.html
|
282
252
|
- test/markups/README.rst
|
data/.gitmodules
DELETED
data/test/markups/README.pod6
DELETED
@@ -1,151 +0,0 @@
|
|
1
|
-
=begin pod
|
2
|
-
|
3
|
-
=TITLE About the Docs
|
4
|
-
|
5
|
-
=SUBTITLE Meta-documentation
|
6
|
-
|
7
|
-
This document collection represents the on-going effort to document the Perl 6 programming
|
8
|
-
language with the goals of being: comprehensive; easy to use; easy to
|
9
|
-
navigate; and useful to both newcomers and experienced Perl 6
|
10
|
-
programmers.
|
11
|
-
|
12
|
-
An HTML version of the documentation is located online at
|
13
|
-
L<https://docs.perl6.org>.
|
14
|
-
|
15
|
-
The official source for this documentation is located at L<perl6/doc on
|
16
|
-
GitHub|https://github.com/perl6/doc>.
|
17
|
-
|
18
|
-
This particular document is a quick overview of the process
|
19
|
-
described in more detail in L<CONTRIBUTING on GitHub|https://github.com/perl6/doc/blob/master/CONTRIBUTING.md>.
|
20
|
-
This document also provides a short introduction to writing Perl 6
|
21
|
-
Pod files, which can be rendered into HTML and other formats.
|
22
|
-
|
23
|
-
=head1 Structure
|
24
|
-
|
25
|
-
All of the documentation is written in Perl 6 Pod and kept in the C<doc/>
|
26
|
-
directory, and the C<doc/Language/> and C<doc/Type/> sub-directories.
|
27
|
-
These files are processed as collections of definitions or
|
28
|
-
"documentables", which are then post-processed and linked together.
|
29
|
-
|
30
|
-
=head1 Generating HTML from Pod
|
31
|
-
|
32
|
-
To generate HTML from the Pod files, you'll need:
|
33
|
-
|
34
|
-
=item A recent version of the Rakudo Perl 6 compiler
|
35
|
-
|
36
|
-
=item The Perl 6 modules Pod::To::HTML, Pod::To::BigPage, and URI::Escape
|
37
|
-
(can be installed via L<zef|https://github.com/ugexe/zef>).
|
38
|
-
|
39
|
-
=item B<Optional>: L<GraphViz|http://graphviz.org>, for creating graphs
|
40
|
-
of the relationships between Perl 6 types
|
41
|
-
|
42
|
-
=item B<Optional>: L<Atom Highlights|https://github.com/atom/highlights> and L<language-perl6|https://atom.io/packages/language-perl6>, for syntax
|
43
|
-
highlighting
|
44
|
-
|
45
|
-
To generate the documentation into the C<html/> folder, run:
|
46
|
-
|
47
|
-
=begin code :lang<shell>
|
48
|
-
perl6 htmlify.p6
|
49
|
-
=end code
|
50
|
-
|
51
|
-
To host the documentation from a web server, have Perl 5
|
52
|
-
and Mojolicious::Lite installed, then run:
|
53
|
-
|
54
|
-
=begin code :lang<shell>
|
55
|
-
perl app.pl daemon
|
56
|
-
=end code
|
57
|
-
|
58
|
-
=head1 Contributing
|
59
|
-
|
60
|
-
The documentation is written in Perl 6 Pod.
|
61
|
-
|
62
|
-
For a quick introduction to Perl 6 Pod, see L<Perl 6 Pod|https://docs.perl6.org/language/pod>.
|
63
|
-
|
64
|
-
For full details about the Perl 6 Pod specification, see L<Synopsis 26, Documentation|https://design.perl6.org/S26.html>.
|
65
|
-
|
66
|
-
=head2 Adding definitions
|
67
|
-
|
68
|
-
Documentables can be defined using an C<=headN> Pod directive, where
|
69
|
-
C<N> is greater than zero (e.g., C<=head1>, C<=head2>, …).
|
70
|
-
|
71
|
-
All of the paragraphs and blocks following that directive, up until the
|
72
|
-
next directive of the same level, will be considered part of the
|
73
|
-
documentable. So, in:
|
74
|
-
|
75
|
-
=begin code :allow<R> :skip-test
|
76
|
-
=head2 R<My Definition>
|
77
|
-
|
78
|
-
Some paragraphs, followed by some code:
|
79
|
-
|
80
|
-
my Code $examples = "amazing";
|
81
|
-
|
82
|
-
Mind === blown.
|
83
|
-
|
84
|
-
=head3 Minor details about R<My Definition>
|
85
|
-
|
86
|
-
It's fantastic.
|
87
|
-
|
88
|
-
=head2 And now, for something completely different
|
89
|
-
|
90
|
-
…
|
91
|
-
|
92
|
-
=end code
|
93
|
-
|
94
|
-
The documentable R<My Definition> extends down to the C<=head2 And now…>.
|
95
|
-
|
96
|
-
Documentables may contain other documentables. Class documentables, for
|
97
|
-
example, often contain the methods the class implements.
|
98
|
-
|
99
|
-
Definitions must be in one of the following forms to be recognized as
|
100
|
-
the start of a documentable named, say, þ. First the code in the document source:
|
101
|
-
|
102
|
-
=begin code :skip-test
|
103
|
-
|
104
|
-
=item X<C<How to use the þ infix> | infix,þ> (This a special case, which
|
105
|
-
is always considered a definition)
|
106
|
-
|
107
|
-
=item C<The þ Infix>
|
108
|
-
|
109
|
-
=item B<The C<þ> Infix>
|
110
|
-
|
111
|
-
=item C<Infix þ>
|
112
|
-
|
113
|
-
=item B<Infix C<þ>>
|
114
|
-
|
115
|
-
=item C<trait is cached> (A special case for the L<trait|/language/functions#Traits> documentables)
|
116
|
-
|
117
|
-
=end code
|
118
|
-
|
119
|
-
Then the results on the rendered page:
|
120
|
-
|
121
|
-
=item X<C<How to use the þ infix> | infix,þ> (This is a special case, which
|
122
|
-
is always considered a definition)
|
123
|
-
|
124
|
-
=item C<The þ Infix>
|
125
|
-
|
126
|
-
=item B<The C<þ> Infix>
|
127
|
-
|
128
|
-
=item C<Infix þ>
|
129
|
-
|
130
|
-
=item B<Infix C<þ>>
|
131
|
-
|
132
|
-
=item C<trait is cached> (A special case for the L<trait|/language/functions#Traits> documentables)
|
133
|
-
|
134
|
-
These items should now be searchable by using the search field in the HTML docs.
|
135
|
-
|
136
|
-
You can add emphasis with bold (B<V< B<> >>) or italicized (B<V< I<> >>),
|
137
|
-
with or without code formatting (B<V< C<> >>). Due to current parser limitations,
|
138
|
-
special steps have to be taken to use B<V< X<> >> with other formatting codes; for example:
|
139
|
-
|
140
|
-
=begin code :skip-test
|
141
|
-
=item X<B<foo>|foo> a fancy subroutine
|
142
|
-
=end code
|
143
|
-
|
144
|
-
renders like this
|
145
|
-
|
146
|
-
=item X<B<foo>|foo> a fancy subroutine
|
147
|
-
|
148
|
-
Notice that text after a pipe ('|') has no formatting. Also note that B<V< C<> >>
|
149
|
-
preserves spaces and treats text as verbatim.
|
150
|
-
=end pod
|
151
|
-
|
@@ -1,128 +0,0 @@
|
|
1
|
-
<h1>About the Docs</h1>
|
2
|
-
<p>Meta-documentation</p>
|
3
|
-
|
4
|
-
<table>
|
5
|
-
<h2>Table of Contents</h2>
|
6
|
-
<tr>
|
7
|
-
<td>1</td>
|
8
|
-
<td><a href="#Structure">Structure</a></td>
|
9
|
-
</tr>
|
10
|
-
<tr>
|
11
|
-
<td>2</td>
|
12
|
-
<td><a href="#Generating_HTML_from_Pod">Generating HTML from Pod</a></td>
|
13
|
-
</tr>
|
14
|
-
<tr>
|
15
|
-
<td>3</td>
|
16
|
-
<td><a href="#Contributing">Contributing</a></td>
|
17
|
-
</tr>
|
18
|
-
<tr>
|
19
|
-
<td>3.1</td>
|
20
|
-
<td><a href="#Adding_definitions">Adding definitions</a></td>
|
21
|
-
</tr>
|
22
|
-
|
23
|
-
</table>
|
24
|
-
|
25
|
-
|
26
|
-
<div>
|
27
|
-
<p>This document collection represents the on-going effort to document the Perl 6 programming language with the goals of being: comprehensive; easy to use; easy to navigate; and useful to both newcomers and experienced Perl 6 programmers.</p>
|
28
|
-
<p>An HTML version of the documentation is located online at <a href="https://docs.perl6.org">https://docs.perl6.org</a>.</p>
|
29
|
-
<p>The official source for this documentation is located at <a href="https://github.com/perl6/doc">perl6/doc on GitHub</a>.</p>
|
30
|
-
<p>This particular document is a quick overview of the process described in more detail in <a href="https://github.com/perl6/doc/blob/master/CONTRIBUTING.md">CONTRIBUTING on GitHub</a>. This document also provides a short introduction to writing Perl 6 Pod files, which can be rendered into HTML and other formats.</p>
|
31
|
-
<h1><a href="#___top" title="go to top of document">Structure</a></h1>
|
32
|
-
<p>All of the documentation is written in Perl 6 Pod and kept in the <code>doc/</code> directory, and the <code>doc/Language/</code> and <code>doc/Type/</code> sub-directories. These files are processed as collections of definitions or "documentables", which are then post-processed and linked together.</p>
|
33
|
-
<h1><a href="#___top" title="go to top of document">Generating HTML from Pod</a></h1>
|
34
|
-
<p>To generate HTML from the Pod files, you'll need:</p>
|
35
|
-
<ul>
|
36
|
-
<li>
|
37
|
-
<p>A recent version of the Rakudo Perl 6 compiler</p>
|
38
|
-
</li>
|
39
|
-
<li>
|
40
|
-
<p>The Perl 6 modules Pod::To::HTML, Pod::To::BigPage, and URI::Escape (can be installed via <a href="https://github.com/ugexe/zef">zef</a>).</p>
|
41
|
-
</li>
|
42
|
-
<li>
|
43
|
-
<p><strong>Optional</strong>: <a href="http://graphviz.org">GraphViz</a>, for creating graphs of the relationships between Perl 6 types</p>
|
44
|
-
</li>
|
45
|
-
<li>
|
46
|
-
<p><strong>Optional</strong>: <a href="https://github.com/atom/highlights">Atom Highlights</a> and <a href="https://atom.io/packages/language-perl6">language-perl6</a>, for syntax highlighting</p>
|
47
|
-
</li>
|
48
|
-
</ul>
|
49
|
-
<p>To generate the documentation into the <code>html/</code> folder, run:</p>
|
50
|
-
<pre>perl6 htmlify.p6
|
51
|
-
</pre>
|
52
|
-
<p>To host the documentation from a web server, have Perl 5 and Mojolicious::Lite installed, then run:</p>
|
53
|
-
<pre>perl app.pl daemon
|
54
|
-
</pre>
|
55
|
-
<h1><a href="#___top" title="go to top of document">Contributing</a></h1>
|
56
|
-
<p>The documentation is written in Perl 6 Pod.</p>
|
57
|
-
<p>For a quick introduction to Perl 6 Pod, see <a href="https://docs.perl6.org/language/pod">Perl 6 Pod</a>.</p>
|
58
|
-
<p>For full details about the Perl 6 Pod specification, see <a href="https://design.perl6.org/S26.html">Synopsis 26, Documentation</a>.</p>
|
59
|
-
<h2><a href="#___top" title="go to top of document">Adding definitions</a></h2>
|
60
|
-
<p>Documentables can be defined using an <code>=headN</code> Pod directive, where <code>N</code> is greater than zero (e.g., <code>=head1</code>, <code>=head2</code>, …).</p>
|
61
|
-
<p>All of the paragraphs and blocks following that directive, up until the next directive of the same level, will be considered part of the documentable. So, in:</p>
|
62
|
-
<pre>=head2 <var>My Definition</var>
|
63
|
-
|
64
|
-
Some paragraphs, followed by some code:
|
65
|
-
|
66
|
-
my Code $examples = "amazing";
|
67
|
-
|
68
|
-
Mind === blown.
|
69
|
-
|
70
|
-
=head3 Minor details about <var>My Definition</var>
|
71
|
-
|
72
|
-
It's fantastic.
|
73
|
-
|
74
|
-
=head2 And now, for something completely different
|
75
|
-
|
76
|
-
…
|
77
|
-
|
78
|
-
</pre>
|
79
|
-
<p>The documentable <var>My Definition</var> extends down to the <code>=head2 And now…</code>.</p>
|
80
|
-
<p>Documentables may contain other documentables. Class documentables, for example, often contain the methods the class implements.</p>
|
81
|
-
<p>Definitions must be in one of the following forms to be recognized as the start of a documentable named, say, þ. First the code in the document source:</p>
|
82
|
-
<pre>=item X<C<How to use the þ infix> | infix,þ> (This a special case, which
|
83
|
-
is always considered a definition)
|
84
|
-
|
85
|
-
=item C<The þ Infix>
|
86
|
-
|
87
|
-
=item B<The C<þ> Infix>
|
88
|
-
|
89
|
-
=item C<Infix þ>
|
90
|
-
|
91
|
-
=item B<Infix C<þ>>
|
92
|
-
|
93
|
-
=item C<trait is cached> (A special case for the L<trait|/language/functions#Traits> documentables)
|
94
|
-
|
95
|
-
</pre>
|
96
|
-
<p>Then the results on the rendered page:</p>
|
97
|
-
<ul>
|
98
|
-
<li>
|
99
|
-
<p><a name="index-entry-infix_%C3%BE-How_to_use_the_%C3%BE_infix"><code>How to use the þ infix</code></a> (This is a special case, which is always considered a definition)</p>
|
100
|
-
</li>
|
101
|
-
<li>
|
102
|
-
<p><code>The þ Infix</code></p>
|
103
|
-
</li>
|
104
|
-
<li>
|
105
|
-
<p><strong>The <code>þ</code> Infix</strong></p>
|
106
|
-
</li>
|
107
|
-
<li>
|
108
|
-
<p><code>Infix þ</code></p>
|
109
|
-
</li>
|
110
|
-
<li>
|
111
|
-
<p><strong>Infix <code>þ</code></strong></p>
|
112
|
-
</li>
|
113
|
-
<li>
|
114
|
-
<p><code>trait is cached</code> (A special case for the <a href="/language/functions#Traits">trait</a> documentables)</p>
|
115
|
-
</li>
|
116
|
-
</ul>
|
117
|
-
<p>These items should now be searchable by using the search field in the HTML docs.</p>
|
118
|
-
<p>You can add emphasis with bold (<strong> B<> </strong>) or italicized (<strong> I<> </strong>), with or without code formatting (<strong> C<> </strong>). Due to current parser limitations, special steps have to be taken to use <strong> X<> </strong> with other formatting codes; for example:</p>
|
119
|
-
<pre>=item X<B<foo>|foo> a fancy subroutine
|
120
|
-
</pre>
|
121
|
-
<p>renders like this</p>
|
122
|
-
<ul>
|
123
|
-
<li>
|
124
|
-
<p><a name="index-entry-foo-foo"><strong>foo</strong></a> a fancy subroutine</p>
|
125
|
-
</li>
|
126
|
-
</ul>
|
127
|
-
<p>Notice that text after a pipe ('|') has no formatting. Also note that <strong> C<> </strong> preserves spaces and treats text as verbatim.</p>
|
128
|
-
</div>
|
data/vendor/Pod-To-HTML/LICENSE
DELETED
@@ -1,201 +0,0 @@
|
|
1
|
-
The Artistic License 2.0
|
2
|
-
|
3
|
-
Copyright (c) 2000-2006, The Perl Foundation.
|
4
|
-
|
5
|
-
Everyone is permitted to copy and distribute verbatim copies
|
6
|
-
of this license document, but changing it is not allowed.
|
7
|
-
|
8
|
-
Preamble
|
9
|
-
|
10
|
-
This license establishes the terms under which a given free software
|
11
|
-
Package may be copied, modified, distributed, and/or redistributed.
|
12
|
-
The intent is that the Copyright Holder maintains some artistic
|
13
|
-
control over the development of that Package while still keeping the
|
14
|
-
Package available as open source and free software.
|
15
|
-
|
16
|
-
You are always permitted to make arrangements wholly outside of this
|
17
|
-
license directly with the Copyright Holder of a given Package. If the
|
18
|
-
terms of this license do not permit the full use that you propose to
|
19
|
-
make of the Package, you should contact the Copyright Holder and seek
|
20
|
-
a different licensing arrangement.
|
21
|
-
|
22
|
-
Definitions
|
23
|
-
|
24
|
-
"Copyright Holder" means the individual(s) or organization(s)
|
25
|
-
named in the copyright notice for the entire Package.
|
26
|
-
|
27
|
-
"Contributor" means any party that has contributed code or other
|
28
|
-
material to the Package, in accordance with the Copyright Holder's
|
29
|
-
procedures.
|
30
|
-
|
31
|
-
"You" and "your" means any person who would like to copy,
|
32
|
-
distribute, or modify the Package.
|
33
|
-
|
34
|
-
"Package" means the collection of files distributed by the
|
35
|
-
Copyright Holder, and derivatives of that collection and/or of
|
36
|
-
those files. A given Package may consist of either the Standard
|
37
|
-
Version, or a Modified Version.
|
38
|
-
|
39
|
-
"Distribute" means providing a copy of the Package or making it
|
40
|
-
accessible to anyone else, or in the case of a company or
|
41
|
-
organization, to others outside of your company or organization.
|
42
|
-
|
43
|
-
"Distributor Fee" means any fee that you charge for Distributing
|
44
|
-
this Package or providing support for this Package to another
|
45
|
-
party. It does not mean licensing fees.
|
46
|
-
|
47
|
-
"Standard Version" refers to the Package if it has not been
|
48
|
-
modified, or has been modified only in ways explicitly requested
|
49
|
-
by the Copyright Holder.
|
50
|
-
|
51
|
-
"Modified Version" means the Package, if it has been changed, and
|
52
|
-
such changes were not explicitly requested by the Copyright
|
53
|
-
Holder.
|
54
|
-
|
55
|
-
"Original License" means this Artistic License as Distributed with
|
56
|
-
the Standard Version of the Package, in its current version or as
|
57
|
-
it may be modified by The Perl Foundation in the future.
|
58
|
-
|
59
|
-
"Source" form means the source code, documentation source, and
|
60
|
-
configuration files for the Package.
|
61
|
-
|
62
|
-
"Compiled" form means the compiled bytecode, object code, binary,
|
63
|
-
or any other form resulting from mechanical transformation or
|
64
|
-
translation of the Source form.
|
65
|
-
|
66
|
-
|
67
|
-
Permission for Use and Modification Without Distribution
|
68
|
-
|
69
|
-
(1) You are permitted to use the Standard Version and create and use
|
70
|
-
Modified Versions for any purpose without restriction, provided that
|
71
|
-
you do not Distribute the Modified Version.
|
72
|
-
|
73
|
-
|
74
|
-
Permissions for Redistribution of the Standard Version
|
75
|
-
|
76
|
-
(2) You may Distribute verbatim copies of the Source form of the
|
77
|
-
Standard Version of this Package in any medium without restriction,
|
78
|
-
either gratis or for a Distributor Fee, provided that you duplicate
|
79
|
-
all of the original copyright notices and associated disclaimers. At
|
80
|
-
your discretion, such verbatim copies may or may not include a
|
81
|
-
Compiled form of the Package.
|
82
|
-
|
83
|
-
(3) You may apply any bug fixes, portability changes, and other
|
84
|
-
modifications made available from the Copyright Holder. The resulting
|
85
|
-
Package will still be considered the Standard Version, and as such
|
86
|
-
will be subject to the Original License.
|
87
|
-
|
88
|
-
|
89
|
-
Distribution of Modified Versions of the Package as Source
|
90
|
-
|
91
|
-
(4) You may Distribute your Modified Version as Source (either gratis
|
92
|
-
or for a Distributor Fee, and with or without a Compiled form of the
|
93
|
-
Modified Version) provided that you clearly document how it differs
|
94
|
-
from the Standard Version, including, but not limited to, documenting
|
95
|
-
any non-standard features, executables, or modules, and provided that
|
96
|
-
you do at least ONE of the following:
|
97
|
-
|
98
|
-
(a) make the Modified Version available to the Copyright Holder
|
99
|
-
of the Standard Version, under the Original License, so that the
|
100
|
-
Copyright Holder may include your modifications in the Standard
|
101
|
-
Version.
|
102
|
-
|
103
|
-
(b) ensure that installation of your Modified Version does not
|
104
|
-
prevent the user installing or running the Standard Version. In
|
105
|
-
addition, the Modified Version must bear a name that is different
|
106
|
-
from the name of the Standard Version.
|
107
|
-
|
108
|
-
(c) allow anyone who receives a copy of the Modified Version to
|
109
|
-
make the Source form of the Modified Version available to others
|
110
|
-
under
|
111
|
-
|
112
|
-
(i) the Original License or
|
113
|
-
|
114
|
-
(ii) a license that permits the licensee to freely copy,
|
115
|
-
modify and redistribute the Modified Version using the same
|
116
|
-
licensing terms that apply to the copy that the licensee
|
117
|
-
received, and requires that the Source form of the Modified
|
118
|
-
Version, and of any works derived from it, be made freely
|
119
|
-
available in that license fees are prohibited but Distributor
|
120
|
-
Fees are allowed.
|
121
|
-
|
122
|
-
|
123
|
-
Distribution of Compiled Forms of the Standard Version
|
124
|
-
or Modified Versions without the Source
|
125
|
-
|
126
|
-
(5) You may Distribute Compiled forms of the Standard Version without
|
127
|
-
the Source, provided that you include complete instructions on how to
|
128
|
-
get the Source of the Standard Version. Such instructions must be
|
129
|
-
valid at the time of your distribution. If these instructions, at any
|
130
|
-
time while you are carrying out such distribution, become invalid, you
|
131
|
-
must provide new instructions on demand or cease further distribution.
|
132
|
-
If you provide valid instructions or cease distribution within thirty
|
133
|
-
days after you become aware that the instructions are invalid, then
|
134
|
-
you do not forfeit any of your rights under this license.
|
135
|
-
|
136
|
-
(6) You may Distribute a Modified Version in Compiled form without
|
137
|
-
the Source, provided that you comply with Section 4 with respect to
|
138
|
-
the Source of the Modified Version.
|
139
|
-
|
140
|
-
|
141
|
-
Aggregating or Linking the Package
|
142
|
-
|
143
|
-
(7) You may aggregate the Package (either the Standard Version or
|
144
|
-
Modified Version) with other packages and Distribute the resulting
|
145
|
-
aggregation provided that you do not charge a licensing fee for the
|
146
|
-
Package. Distributor Fees are permitted, and licensing fees for other
|
147
|
-
components in the aggregation are permitted. The terms of this license
|
148
|
-
apply to the use and Distribution of the Standard or Modified Versions
|
149
|
-
as included in the aggregation.
|
150
|
-
|
151
|
-
(8) You are permitted to link Modified and Standard Versions with
|
152
|
-
other works, to embed the Package in a larger work of your own, or to
|
153
|
-
build stand-alone binary or bytecode versions of applications that
|
154
|
-
include the Package, and Distribute the result without restriction,
|
155
|
-
provided the result does not expose a direct interface to the Package.
|
156
|
-
|
157
|
-
|
158
|
-
Items That are Not Considered Part of a Modified Version
|
159
|
-
|
160
|
-
(9) Works (including, but not limited to, modules and scripts) that
|
161
|
-
merely extend or make use of the Package, do not, by themselves, cause
|
162
|
-
the Package to be a Modified Version. In addition, such works are not
|
163
|
-
considered parts of the Package itself, and are not subject to the
|
164
|
-
terms of this license.
|
165
|
-
|
166
|
-
|
167
|
-
General Provisions
|
168
|
-
|
169
|
-
(10) Any use, modification, and distribution of the Standard or
|
170
|
-
Modified Versions is governed by this Artistic License. By using,
|
171
|
-
modifying or distributing the Package, you accept this license. Do not
|
172
|
-
use, modify, or distribute the Package, if you do not accept this
|
173
|
-
license.
|
174
|
-
|
175
|
-
(11) If your Modified Version has been derived from a Modified
|
176
|
-
Version made by someone other than you, you are nevertheless required
|
177
|
-
to ensure that your Modified Version complies with the requirements of
|
178
|
-
this license.
|
179
|
-
|
180
|
-
(12) This license does not grant you the right to use any trademark,
|
181
|
-
service mark, tradename, or logo of the Copyright Holder.
|
182
|
-
|
183
|
-
(13) This license includes the non-exclusive, worldwide,
|
184
|
-
free-of-charge patent license to make, have made, use, offer to sell,
|
185
|
-
sell, import and otherwise transfer the Package with respect to any
|
186
|
-
patent claims licensable by the Copyright Holder that are necessarily
|
187
|
-
infringed by the Package. If you institute patent litigation
|
188
|
-
(including a cross-claim or counterclaim) against any party alleging
|
189
|
-
that the Package constitutes direct or contributory patent
|
190
|
-
infringement, then this Artistic License to you shall terminate on the
|
191
|
-
date that such litigation is filed.
|
192
|
-
|
193
|
-
(14) Disclaimer of Warranty:
|
194
|
-
THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS
|
195
|
-
IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED
|
196
|
-
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
|
197
|
-
NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL
|
198
|
-
LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL
|
199
|
-
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
|
200
|
-
DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF
|
201
|
-
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|