Grant Report : RPerl User Documentation #2 - March 2016
Sun, 03-Apr-2016 by
Mark A Jensen
edit post
<
follows. (The POD tables look nice.)
"As planned, I've continued work where we left on in part 1 off the
Learning RPerl grant.
I've implemented a new mechanism for creating tables in POD, currently
supporting 14 output formats, which I believe is significantly more
than anyone else has achieved to date. (Unfortunately, PseudoPod's
often-mentioned table feature is both lacking in basic features and
seemingly broken at this time. Fortunately, I was able to maintain
full PseudoPod compatibility by working around their table feature and
directly implementing mine in it's place.)
[`learning_rperl_generate.sh`](https://github.com/wbraswell/rperl/blob/master/script/development/learning_rperl_generate.sh)
[[[ Pod ]]]
1. pod2text
2. pod2text color
3. pod2man
4. pod2man postscript
5. pod2html
6. pod2cpanhtml
7. pod2rperlhtml
[[[ PseudoPod ]]]
8. ppod2txt
9. ppod2html
10. ppod2docbook
[[[ Docbook ]]]
11. sgmltools onehtml
12. sgml2x docbook-2-html
13. docbook2html chunks
14. docbook2html no chunks
You can see the use of tables in many of the new chapter 2 sections,
starting with the Arithmetic Operators in
[2.1.9](http://rperl.org/learning_rperl.html#Section_2.1.9%3A_Arithmetic_Operators).
You can see the source code of the new tables implementation in any of
the sections where it is utilized in the Learning RPerl POD. You will
notice there are 4 different output format groups: text
(Text::ASCIITable), man (raw), html (raw), and docbook (raw). Here's
a link to the shortest table (header row plus 3 body rows) in the
Trigonometry Operators in
[2.1.10](https://github.com/wbraswell/rperl/blob/master/lib/RPerl/Learning.pm#L2495-L2818).
As part of my work on chapter 2, I've completed the content for
sections 2.1.9 through 2.1.14, and made various updates throughout
other parts of chapter 2.
I've added a new section, [Appendix B3](http://rperl.org/learning_rperl.html#B.3%3A_Syntax_Arity%2C_Fixity%2C_Precedence%2C_Associativity), with more in-depth information about operator arity, fixity, precedence, and associativity.
I've added 2 new exercises not present in Learning Perl, ex2.6 and ex2.7, in order to provide a proper introduction to the while() loop and algorithmic equivalence:
* [Exercise 6](http://rperl.org/learning_rperl.html#Chapter_2%2C_Exercise_6)
* [Exercise 7](http://rperl.org/learning_rperl.html#Chapter_2%2C_Exercise_7)
And last but certainly not least, I've released RPerl v1.7 (Codename
Tycho) including the long-awaited ability to generate stand-alone
executable files, and I have updated Learning RPerl section 1.24
accordingly:
* [https://metacpan.org/release/WBRASWELL/RPerl-1.700000](https://metacpan.org/release/WBRASWELL/RPerl-1.700000)
* [http://rperl.org/learning_rperl.html#Section_1.24%3A_How_Do_I_Compile_RPerl%3F](http://rperl.org/learning_rperl.html#Section_1.24%3A_How_Do_I_Compile_RPerl%3F)"
MAJ
#rperl-grants
]]>
Comments (0)
