ext/README

   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.
  39