github-markup 0.1.1 → 0.1.2
Sign up to get free protection for your applications and to get access to all the features.
- data/HISTORY.md +5 -0
- data/lib/github/markup/version.rb +1 -1
- data/lib/github/markups.rb +1 -1
- data/test/markups/README.pod +86 -4
- data/test/markups/README.pod.html +109 -1
- metadata +1 -1
data/HISTORY.md
CHANGED
data/lib/github/markups.rb
CHANGED
|
@@ -20,7 +20,7 @@ command(:asciidoc2html, /asciidoc/)
|
|
|
20
20
|
# Any block passed to `command` will be handed the command's STDOUT for
|
|
21
21
|
# post processing.
|
|
22
22
|
command("/usr/bin/env pod2html", /pod/) do |rendered|
|
|
23
|
-
if rendered =~
|
|
23
|
+
if rendered =~ /<body.+?>\s*(.+)\s*<\/body>/mi
|
|
24
24
|
`rm pod2htmd.tmp` if File.exists?('pod2htmd.tmp') rescue nil
|
|
25
25
|
`rm pod2htmi.tmp` if File.exists?('pod2htmi.tmp') rescue nil
|
|
26
26
|
$1
|
data/test/markups/README.pod
CHANGED
|
@@ -1,7 +1,89 @@
|
|
|
1
|
-
=head1
|
|
1
|
+
=head1 Matrixy
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
=head2 INTRODUCTION
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
This is a port of the MATLAB/Octave programming language to Parrot. See the
|
|
6
|
+
ROADMAP file for more information on the status of this project, and what else
|
|
7
|
+
needs to be done.
|
|
8
|
+
|
|
9
|
+
=head2 ABOUT
|
|
10
|
+
|
|
11
|
+
Primary goals are:
|
|
12
|
+
|
|
13
|
+
=over 4
|
|
14
|
+
|
|
15
|
+
=item* Create a working compiler that understands the majority of the
|
|
16
|
+
MATLAB/Octave programming language.
|
|
17
|
+
|
|
18
|
+
=back
|
|
19
|
+
|
|
20
|
+
=head2 IMPLEMENTATION
|
|
21
|
+
|
|
22
|
+
This project is broken into three primary components:
|
|
23
|
+
|
|
24
|
+
=over 4
|
|
25
|
+
|
|
26
|
+
=item* The first is the parser, located in the C<src/parser/> directory. The
|
|
27
|
+
parser proper is composed of three source files, F<grammar.pg> which is a
|
|
28
|
+
Perl6Grammar file, and F<actions.pm> which is the associated actions file
|
|
29
|
+
written in NQP, and F<grammar-oper.pm> which is the operator precidence parser.
|
|
30
|
+
In addition, several helper functions used by the parser are located in
|
|
31
|
+
C<src/internals>.
|
|
32
|
+
|
|
33
|
+
=item* The second component is the library of builtin functions in the
|
|
34
|
+
C<src/builtins/> directory. These functions are, currently, written primarily in
|
|
35
|
+
PIR. Function names prefixed with an underscore are "private" functions for use
|
|
36
|
+
with the parser. Other functions should have names which are the same as names
|
|
37
|
+
for regular MATLAB or Octave functions, since they will be available to the
|
|
38
|
+
HLL. These are also separated into different namespaces depending on visibility
|
|
39
|
+
and utility.
|
|
40
|
+
|
|
41
|
+
=item* A number of library functions are written in M, or mostly M with some
|
|
42
|
+
inline PIR code in C<toolbox/>.
|
|
43
|
+
|
|
44
|
+
=back
|
|
45
|
+
|
|
46
|
+
=head2 DEPENDENCIES
|
|
47
|
+
|
|
48
|
+
Matrixy depends on these dependencies:
|
|
49
|
+
|
|
50
|
+
=head3 Parrot
|
|
51
|
+
|
|
52
|
+
To get a proper version of Parrot to build Matrixy, you will need to check out
|
|
53
|
+
and build Parrot from source:
|
|
54
|
+
|
|
55
|
+
svn co http://svn.parrot.org/parrot/trunk parrot
|
|
56
|
+
cd parrot
|
|
57
|
+
perl Configure.pl
|
|
58
|
+
make && make test && make install-dev
|
|
59
|
+
|
|
60
|
+
=head3 Parrot-Linear-Algebra
|
|
61
|
+
|
|
62
|
+
The linear algebra package for Parrot is available separately and provides
|
|
63
|
+
functionality required by Matrixy. This includes matrix data types and matrix
|
|
64
|
+
manipulation libraries
|
|
65
|
+
|
|
66
|
+
=head2 BUILDING
|
|
67
|
+
|
|
68
|
+
Once all dependencies are in place, you can build Matrixy using this sequence of
|
|
69
|
+
commands:
|
|
70
|
+
|
|
71
|
+
perl Configure.pl
|
|
72
|
+
nmake test
|
|
73
|
+
|
|
74
|
+
=head2 TODO
|
|
75
|
+
|
|
76
|
+
* Parser
|
|
77
|
+
* Standard Builtins
|
|
78
|
+
* Test against Octave Test Suite.
|
|
79
|
+
|
|
80
|
+
=head2 BUGS
|
|
81
|
+
|
|
82
|
+
Lots!
|
|
83
|
+
|
|
84
|
+
=head2 CONTACT
|
|
85
|
+
|
|
86
|
+
If you need to contact the Matrixy team, go to the project home page at:
|
|
87
|
+
|
|
88
|
+
www.github.com\Whiteknight\matrixy
|
|
6
89
|
|
|
7
|
-
=item * Here's another item.
|
|
@@ -1,10 +1,118 @@
|
|
|
1
|
+
<!-- INDEX BEGIN -->
|
|
1
2
|
<div name="index">
|
|
2
3
|
<p><a name="__index__"></a></p>
|
|
3
4
|
|
|
4
5
|
<ul>
|
|
5
6
|
|
|
6
|
-
<li><a href="#
|
|
7
|
+
<li><a href="#matrixy">Matrixy</a></li>
|
|
8
|
+
<ul>
|
|
9
|
+
|
|
10
|
+
<li><a href="#introduction">INTRODUCTION</a></li>
|
|
11
|
+
<li><a href="#about">ABOUT</a></li>
|
|
12
|
+
<li><a href="#implementation">IMPLEMENTATION</a></li>
|
|
13
|
+
<li><a href="#dependencies">DEPENDENCIES</a></li>
|
|
14
|
+
<ul>
|
|
15
|
+
|
|
16
|
+
<li><a href="#parrot">Parrot</a></li>
|
|
17
|
+
<li><a href="#parrot_linear_algebra">Parrot-Linear-Algebra</a></li>
|
|
18
|
+
</ul>
|
|
19
|
+
|
|
20
|
+
<li><a href="#building">BUILDING</a></li>
|
|
21
|
+
<li><a href="#todo">TODO</a></li>
|
|
22
|
+
<li><a href="#bugs">BUGS</a></li>
|
|
23
|
+
<li><a href="#contact">CONTACT</a></li>
|
|
24
|
+
</ul>
|
|
25
|
+
|
|
7
26
|
</ul>
|
|
8
27
|
|
|
9
28
|
<hr name="index" />
|
|
10
29
|
</div>
|
|
30
|
+
<!-- INDEX END -->
|
|
31
|
+
|
|
32
|
+
<p>
|
|
33
|
+
</p>
|
|
34
|
+
<h1><a name="matrixy">Matrixy</a></h1>
|
|
35
|
+
<p>
|
|
36
|
+
</p>
|
|
37
|
+
<h2><a name="introduction">INTRODUCTION</a></h2>
|
|
38
|
+
<p>This is a port of the MATLAB/Octave programming language to Parrot. See the
|
|
39
|
+
ROADMAP file for more information on the status of this project, and what else
|
|
40
|
+
needs to be done.</p>
|
|
41
|
+
<p>
|
|
42
|
+
</p>
|
|
43
|
+
<h2><a name="about">ABOUT</a></h2>
|
|
44
|
+
<p>Primary goals are:</p>
|
|
45
|
+
<ul>
|
|
46
|
+
<li><strong><a name="create_a_working_compiler_that_understands_the_majority_of_the_matlab_octave_programming_language" class="item">Create a working compiler that understands the majority of the
|
|
47
|
+
MATLAB/Octave programming language.</a></strong>
|
|
48
|
+
|
|
49
|
+
</ul>
|
|
50
|
+
<p>
|
|
51
|
+
</p>
|
|
52
|
+
<h2><a name="implementation">IMPLEMENTATION</a></h2>
|
|
53
|
+
<p>This project is broken into three primary components:</p>
|
|
54
|
+
<ul>
|
|
55
|
+
<li><strong><a name="the_first_is_the_parser_located_in_the_src_parser_directory_the_parser_proper_is_composed_of_three_source_files_grammar_pg_which_is_a_perl6grammar_file_and_actions_pm_which_is_the_associated_actions_file_written_in_nqp_and_grammar_oper_pm_which_is_the_operator_precidence_parser_in_addition_several_helper_functions_used_by_the_parser_are_located_in_src_internals" class="item">The first is the parser, located in the <code>src/parser/</code> directory. The
|
|
56
|
+
parser proper is composed of three source files, <em class="file">grammar.pg</em> which is a
|
|
57
|
+
Perl6Grammar file, and <em class="file">actions.pm</em> which is the associated actions file
|
|
58
|
+
written in NQP, and <em class="file">grammar-oper.pm</em> which is the operator precidence parser.
|
|
59
|
+
In addition, several helper functions used by the parser are located in
|
|
60
|
+
<code>src/internals</code>.</a></strong>
|
|
61
|
+
|
|
62
|
+
<li><strong><a name="the_second_component_is_the_library_of_builtin_functions_in_the_src_builtins_directory_these_functions_are_currently_written_primarily_in_pir_function_names_prefixed_with_an_underscore_are_private_functions_for_use_with_the_parser_other_functions_should_have_names_which_are_the_same_as_names_for_regular_matlab_or_octave_functions_since_they_will_be_available_to_the_hll_these_are_also_separated_into_different_namespaces_depending_on_visibility_and_utility" class="item">The second component is the library of builtin functions in the
|
|
63
|
+
<code>src/builtins/</code> directory. These functions are, currently, written primarily in
|
|
64
|
+
PIR. Function names prefixed with an underscore are "private" functions for use
|
|
65
|
+
with the parser. Other functions should have names which are the same as names
|
|
66
|
+
for regular MATLAB or Octave functions, since they will be available to the
|
|
67
|
+
HLL. These are also separated into different namespaces depending on visibility
|
|
68
|
+
and utility.</a></strong>
|
|
69
|
+
|
|
70
|
+
<li><strong><a name="a_number_of_library_functions_are_written_in_m_or_mostly_m_with_some_inline_pir_code_in_toolbox" class="item">A number of library functions are written in M, or mostly M with some
|
|
71
|
+
inline PIR code in <code>toolbox/</code>.</a></strong>
|
|
72
|
+
|
|
73
|
+
</ul>
|
|
74
|
+
<p>
|
|
75
|
+
</p>
|
|
76
|
+
<h2><a name="dependencies">DEPENDENCIES</a></h2>
|
|
77
|
+
<p>Matrixy depends on these dependencies:</p>
|
|
78
|
+
<p>
|
|
79
|
+
</p>
|
|
80
|
+
<h3><a name="parrot">Parrot</a></h3>
|
|
81
|
+
<p>To get a proper version of Parrot to build Matrixy, you will need to check out
|
|
82
|
+
and build Parrot from source:</p>
|
|
83
|
+
<pre>
|
|
84
|
+
svn co <a href="http://svn.parrot.org/parrot/trunk">http://svn.parrot.org/parrot/trunk</a> parrot
|
|
85
|
+
cd parrot
|
|
86
|
+
perl Configure.pl
|
|
87
|
+
make && make test && make install-dev</pre>
|
|
88
|
+
<p>
|
|
89
|
+
</p>
|
|
90
|
+
<h3><a name="parrot_linear_algebra">Parrot-Linear-Algebra</a></h3>
|
|
91
|
+
<p>The linear algebra package for Parrot is available separately and provides
|
|
92
|
+
functionality required by Matrixy. This includes matrix data types and matrix
|
|
93
|
+
manipulation libraries</p>
|
|
94
|
+
<p>
|
|
95
|
+
</p>
|
|
96
|
+
<h2><a name="building">BUILDING</a></h2>
|
|
97
|
+
<p>Once all dependencies are in place, you can build Matrixy using this sequence of
|
|
98
|
+
commands:</p>
|
|
99
|
+
<pre>
|
|
100
|
+
perl Configure.pl
|
|
101
|
+
nmake test</pre>
|
|
102
|
+
<p>
|
|
103
|
+
</p>
|
|
104
|
+
<h2><a name="todo">TODO</a></h2>
|
|
105
|
+
<pre>
|
|
106
|
+
* Parser
|
|
107
|
+
* Standard Builtins
|
|
108
|
+
* Test against Octave Test Suite.</pre>
|
|
109
|
+
<p>
|
|
110
|
+
</p>
|
|
111
|
+
<h2><a name="bugs">BUGS</a></h2>
|
|
112
|
+
<p>Lots!</p>
|
|
113
|
+
<p>
|
|
114
|
+
</p>
|
|
115
|
+
<h2><a name="contact">CONTACT</a></h2>
|
|
116
|
+
<p>If you need to contact the Matrixy team, go to the project home page at:</p>
|
|
117
|
+
<p>www.github.com\Whiteknight\matrixy</p>
|
|
118
|
+
|