I've been watching pugs for a while and would like to get more involved. To that end I've been exploring the source tree. As a newbie, I've got a lot of questions, So I'm attempting to learn by updating and adding documenation. My patches may seem obvious to the seasoned pugs hacker, however, I'm attempting to help newbies be able to understand more of the directory structure and architecture without a personal tutorial.
I'm sure I've got some things wrong, I've figured out what I know by just poking around. Anyway, this is my first attempt at a pugs doc patch :) Comments welcome! Kevin Speaking about directory structure how about backends/Perl5/codegen /Perl6-MetaModel-Impl /runtime or prelude (What exactly is a prelude? how does it differ from a runtime library?) /Perl6 /... /JS/... /PIR/Parrot/.. or Perl6-MetaModel-BACKEND ie Perl6-MetaModel-Perl5 Perl6-MetaModel-JS etc I found pugs/perl5/ a little confusing at first
Index: perl5/README =================================================================== --- perl5/README (revision 6349) +++ perl5/README (working copy) @@ -4,3 +4,16 @@ See docs/notes/plan for the general idea. Currently this directory is not indexed nor installed as part of Pugs. + +Current Directory stucture +org.perl6.metamodel - old Meta Model implementation in java, historical reference +Perl6-Container - implementation of Perl6 containers Array, Hash, Scalar in Perl5 +Perl6-MetaModel - Perl6-MetaModel-Perl5 - Perl6 meta model for Pugs Perl5 back end +Perl6.MetaModel - Perl6-MetaModel-JS - Perl6 meta model for Pugs JS back end +Perl6-MetaModel2.0 - Perl6-MetaModel-Perl5-2.0 - Perl6 meta model for Pugs Perl5 back end version 2.0 +Perl6-Value - implementation of Perl6 value types Int, Num, Str, Bit, List in Perl5 +PIL2JS - PIL 2 javascript backend code generator for pugs. +PIL-Run - PIL runtime support for the Perl5 backend +T2-Perl6 - converts T2 schema objects to Perl6::Class objects. + - T2 is a re-modelling of the Tangram::Schema structure, as used by the + - Tangram Object/Relational mapping system,