| 1 | =============================================================================== |
|---|
| 2 | = Pugs Modules Directory |
|---|
| 3 | =============================================================================== |
|---|
| 4 | |
|---|
| 5 | - What is this directory? |
|---|
| 6 | |
|---|
| 7 | This directory is meant to be a temporary holding place for both perl6 module |
|---|
| 8 | ports of perl5 modules, and any new perl6 modules people might want to write. |
|---|
| 9 | |
|---|
| 10 | Eventually all that you see here will end up on 6PAN. |
|---|
| 11 | |
|---|
| 12 | - Do these modules work in Pugs? |
|---|
| 13 | |
|---|
| 14 | Yes. Each module must come with unit tests and compiles with Pugs. |
|---|
| 15 | |
|---|
| 16 | - What are those modules good for? |
|---|
| 17 | |
|---|
| 18 | It is our hope that having a number of modules, each with their own test suites, |
|---|
| 19 | will later serve as a kind of integration test for the more advanced features |
|---|
| 20 | of Pugs and Perl 6. |
|---|
| 21 | |
|---|
| 22 | Also the act of porting perl5 modules helps to raise questions about how certain |
|---|
| 23 | things will be accomplished in Perl 6 and helps to expose some of the darker |
|---|
| 24 | corners of the Perl 6 spec; this has proven to be a good way to help the |
|---|
| 25 | perl6-language group in the development of the specification. |
|---|
| 26 | |
|---|
| 27 | - How can I contribute? |
|---|
| 28 | |
|---|
| 29 | Pick a module, port it, ask for a commit bit on perl6-compiler or |
|---|
| 30 | irc.freenode.net #perl6, and upload it. |
|---|
| 31 | |
|---|
| 32 | - What modules should I port? |
|---|
| 33 | |
|---|
| 34 | Whatever you like. There are no restrictions nor expectations. |
|---|
| 35 | |
|---|
| 36 | - Is there a How-To document for porting to perl6? |
|---|
| 37 | |
|---|
| 38 | Yes, see docs/other/porting_howto for some ideas. |
|---|
