Changeset 20262 for ext

Show
Ignore:
Timestamp:
04/12/08 03:11:34 (9 months ago)
Author:
Darren_Duncan
Message:

ext/Muldis-DB/ : part 1 of 20080411 resync with Perl 5 version

Location:
ext/Muldis-DB
Files:
4 modified

Legend:

Unmodified
Added
Removed

  • ext/Muldis-DB/Changes

    r20096 r20262  
    22--------------------------------------------------------------------------- 
    33 
    4 2008-03-xx   Darren Duncan <perl@DarrenDuncan.net> 
     42008-04-xx   Darren Duncan <perl@DarrenDuncan.net> 
    55 
    66    * Muldis DB version 0.7.0 for Perl 5 is released on CPAN as 
    … …  
    1111 
    1212    * New file versions are: DB.pm and Interface.pm and Validator.pm and 
    13     Example.pm 0.7.0 and SeeAlso.pod 0.4.3.  Added new file 
     13    Example.pm 0.7.0 and SeeAlso.pod 0.4.5.  Added new file 
    1414    lib/Muldis/DB/Engine/Example/Value.pm, which starts at version 0.0.0. 
    1515 
     16    * (DB.pm)  The TRADEMARK POLICY section was severely edited to excise 
     17    most legalese, and is now just half its previous size; the old longer 
     18    version was shunted off to the Muldis Data Systems' website. 
     19 
     20    * (Interface.pm, Validator.pm)  Update to retain compatibility with the 
     21    official Muldis D version 0.25.0, where the second (authority) part of 
     22    a fully-qualified Muldis D language name has changed from 
     23    'cpan:DUNCAND' to 'http://muldis.com'. 
     24 
    1625    TODO: Describe the new Value.pm and other new friends. 
     26 
     27    * (SeeAlso.pod)  A few minor updates. 
     28 
     29    * Minor update to the file archives/OSCON2008SessionProposal.txt which 
     30    reflects that the proposal was accepted; the talk will be given Jul 23. 
     31 
     322008-03-23   Darren Duncan <perl@DarrenDuncan.net> 
     33 
     34    * Muldis DB version 0.6.2 for Perl 5 is released on CPAN as 
     35    Muldis-DB-0.6.2.tar.gz.  Muldis DB version 0.6.2 for Perl 6 is not 
     36    released at all.  The rest of this Changes entry refers only to the 
     37    Perl 5 version, and it should not be assumed that the Perl 6 version 
     38    incorporates all of said updates, though it may have some of them. 
     39 
     40    * Renamed the 2 t/MDB_\w+ test files to t/Muldis_DB_\w+. 
     41 
     42    * New file versions are: DB.pm and Interface.pm and Validator.pm and 
     43    Example.pm 0.6.2 and SeeAlso.pod 0.4.4. 
     44 
     45    * Updated DB.pm and the README file to clarify that commercial support 
     46    is available from the author specifically by way of Muldis Data 
     47    Systems. 
     48 
     49    * Updated all .pm and .pod files to add a new TRADEMARK POLICY section 
     50    near the end of each; it serves for trademarks what the LICENSE AND 
     51    COPYRIGHT did for copyrights.  The DB.pm file had the actual text, and 
     52    the other files simply say to look at DB.pm.  To summarize, the word 
     53    MULDIS is a trademark and how you may use it has limitations. 
     54 
     55    * (DB.pm, Interface.pm, Validator.pm, SeeAlso.pod)  A few minor updates 
     56    to reflect the fact that, for one thing, the Muldis D official spec is 
     57    now released under the Perl main package namespace Muldis::D rather 
     58    than Language::MuldisD, and for another thing, some small aspects of 
     59    Muldis DB's reflection of the Muldis D language were out of date, but 
     60    now they were updated to resync. 
     61 
     622008-03-10   Darren Duncan <perl@DarrenDuncan.net> 
     63 
     64    * Muldis DB version 0.6.1 for Perl 5 is released on CPAN as 
     65    Muldis-DB-0.6.1.tar.gz.  Muldis DB version 0.6.1 for Perl 6 is not 
     66    released at all.  The rest of this Changes entry refers only to the 
     67    Perl 5 version, and it should not be assumed that the Perl 6 version 
     68    incorporates all of said updates, though it may have some of them. 
     69 
     70    * New file versions are: DB.pm and Interface.pm and Validator.pm and 
     71    Example.pm 0.6.1 and SeeAlso.pod 0.4.3. 
     72 
     73    * Updated the README file to emphasize the Perl 5 version for now. 
    1774 
    1875    * (SeeAlso.pod)  A few minor updates. 
    … …  
    2481    also be given elsewhere); this is likely the most succinct description 
    2582    yet of what the projects are and why one would want to use them. 
    26  
    27     * Updated the README file to emphasize the Perl 5 version for now. 
    2883 
    29842008-03-10   Darren Duncan <perl@DarrenDuncan.net> 
    … …  
    327382        LICENSE/GPL 
    328383        Makefile.PL 
    329         MANIFEST                        This list of files 
     384        MANIFEST 
    330385        MANIFEST.SKIP 
    331386        META.yml 
    … …  
    458513        lib/Muldis/DB/Validator.pm 
    459514        Makefile.PL 
    460         MANIFEST                        This list of files 
     515        MANIFEST 
    461516        MANIFEST.SKIP 
    462517        META.yml 

  • ext/Muldis-DB/README

    r20096 r20262  
    77 
    88This distribution features the Perl 5 or 6 (depending on which copy of this 
    9 README file you are reading) module named "Muldis::DB" (Full-featured truly 
     9README file you are reading) module named Muldis::DB (Full-featured truly 
    1010relational DBMS in Perl) and its support structure. 
    1111 
    … …  
    7575"http://search.cpan.org/search?author=DUNCAND". 
    7676 
    77 The main CPAN search site url for Muldis-DB for Perl 5 is 
     77The main CPAN search site url for Muldis DB for Perl 5 is 
    7878"http://search.cpan.org/dist/Muldis-DB/"; that is the url you should link 
    7979to presently if you want something to consider the "home page" of 
    80 Muldis-DB; it is best to refer people there by default. 
     80Muldis DB; it is best to refer people there by default. 
    8181 
    8282You can download my oldest tarred and gzipped distributions from BACKPAN, 
    … …  
    8787SUPPORT 
    8888 
    89 Currently, the best place to get basic support is the appropriate user 
    90 forums (see "http://mm.DarrenDuncan.net/mailman/listinfo"), which exist so 
    91 that Muldis DB users can help each other, or that help coming from 
    92 Muldis DB developers can be said once to many people, rather than to each 
    93 individually. 
     89Several public email-based forums exist whose main topic is all 
     90implementations of the Muldis D language, especially the Muldis DB project, 
     91which they are named for.  They exist so that Muldis D / Muldis DB users 
     92can help each other, or that help coming from Muldis D / Muldis DB 
     93developers can be said once to many people, rather than to each 
     94individually.  All of these you can reach via 
     95"http://mm.DarrenDuncan.net/mailman/listinfo". 
    9496 
    95 Alternately, you can purchase more advanced commercial support for 
    96 Muldis DB from the author; contact "perl@DarrenDuncan.net" for details. 
     97Alternately, you can purchase more advanced commercial support for various 
     98Muldis D implementations, particularly Muldis DB, from its author by way of 
     99Muldis Data Systems; see "http://www.muldis.com/" for details. 
    97100 
    98101FIN 

  • ext/Muldis-DB/archives/OSCON2008SessionProposal.txt

    r19859 r20262  
    22by Darren Duncan, Founder, Muldis Data Systems 
    33submitted for consideration on 2008 February 3 
     4accepted for presenting on 2008 July 23 (Wed), 17:20-18:05, room D137/138 
    45 
    56----------------- 
    … …  
    8990    If actually seeing the topical projects makes a difference to your 
    9091    proposal selection process, they are at 
    91     http://search.cpan.org/dist/Language-MuldisD/ (language spec) and 
     92    http://search.cpan.org/dist/Muldis-D/ (language spec) and 
    9293    http://search.cpan.org/dist/Muldis-DB/ (Perl 5 impl) respectively.  I 
    9394    didn't know whether to put those urls in the Abstract or not, so they 

  • ext/Muldis-DB/lib/Muldis/DB/SeeAlso.pod

    r19859 r20262  
    1010=head1 VERSION 
    1111 
    12 This document is Muldis::DB::SeeAlso version 0.4.2. 
     12This document is Muldis::DB::SeeAlso version 0.4.4. 
    1313 
    1414=head1 DESCRIPTION 
    … …  
    2121=head1 FORMAL SPECIFICATION 
    2222 
    23 Please see the separately distributed L<Language::MuldisD> distribution, 
     23Please see the separately distributed L<Muldis::D> distribution, 
    2424which defines the B<Muldis D> language that Muldis DB implements and uses 
    25 as its primary API.  Likewise see also the L<Language::MuldisD::SeeAlso> 
     25as its primary API.  Likewise see also the L<Muldis::D::SeeAlso> 
    2626appendix document of the Muldis D spec for links to various things 
    2727comprising and related to I<The Third Manifesto>, which Muldis DB is a 
    … …  
    5656distro. 
    5757 
    58 =item C<Genezzo> or C<Genezzo::Muldis::DB> or 
     58=item C<Genezzo> or C<Genezzo::Muldis_DB> or 
    5959C<Muldis::DB::Engine::Genezzo> etc 
    6060 
    … …  
    6969probably best for branding. 
    7070 
    71 =item C<Muldis::DB::PHMD::Refactor(|::\w+)> 
    72  
    73 Utility modules that take Perl Hosted Muldis D code as input and derive 
    74 other PHMD code as output, such as with the purpose of refactoring them 
    75 into canonical representations (such that manual code debugging or 
    76 comparisons may be made easier), or forms that are more efficient for 
    77 particular uses but are still logically equivalent. 
     71=item C<Muldis::DB::PHDMD::Refactor(|::\w+)> 
     72 
     73Utility modules that take Perl Hosted Data Muldis D (PHDMD) code as input 
     74and derive other PHDMD code as output, such as with the purpose of 
     75refactoring them into canonical representations (such that manual code 
     76debugging or comparisons may be made easier), or forms that are more 
     77efficient for particular uses but are still logically equivalent. 
    7878 
    7979Presumably all of these would work using static analysis methods and not 
    8080actually "execute" anything, so they are independent of any particular 
    8181Engine environment.  This isn't to say that we can't separately have 
    82 modules that help implement a specific Engine and do PHMD optimization that 
    83 knows the specific needs of that Engine's implementation environment. 
     82modules that help implement a specific Engine and do PHDMD optimization 
     83that knows the specific needs of that Engine's implementation environment. 
    8484 
    8585Other words that could go in such module names are like C<Optimize> or 
    8686C<Canon>, or whatever authors prefer. 
    8787 
    88 =item C<Muldis::DB::PHMD::YAML> and C<Muldis::DB::PHMD::XML> etc 
    89  
    90 Utility modules that serialize Perl Hosted Muldis D to, or unserialize it 
    91 from, logically equivalent YAML, XML, or other generic data interchange 
    92 formats.  This implementation should be native to the Muldis D language 
    93 itself and not output any Perl-specific details that aren't in non-Perl 
    94 languages, so that it is suitable for interchange, at the very least 
    95 between Perl 5 and Perl 6. 
    96  
    97 =item C<Muldis::DB::PHMD::Translate::ConcreteMuldisD> 
    98  
    99 Utility module that parses Concrete Muldis D (character strings) into Perl 
    100 Hosted Muldis D (tree of Perl Arrays etc), and also that generates the 
    101 former from the latter.  The 2 formats should basically have a 1:1 
    102 correspondence. 
     88=item C<Muldis::DB::PHDMD::YAML> and C<Muldis::DB::PHDMD::XML> etc 
     89 
     90Utility modules that serialize Perl Hosted Data Muldis D code to, or 
     91unserialize it from, logically equivalent YAML, XML, or other generic data 
     92interchange formats.  This implementation should be native to the Muldis D 
     93language itself and not output any Perl-specific details that aren't in 
     94non-Perl languages, so that it is suitable for interchange, at the very 
     95least between Perl 5 and Perl 6. 
     96 
     97=item C<Muldis::DB::PHDMD::Translate::PTMD> 
     98 
     99Utility module that parses Plain Text Muldis D (PTMD) code into Perl Hosted 
     100Data Muldis D, and also that generates the former from the latter.  The 2 
     101formats should basically have a 1:1 correspondence. 
    103102 
    104103=item C<Muldis::DB::Shell> 
    105104 
    106105Implementation of a command-line user application over the Muldis DB API 
    107 that takes Concrete Muldis D as input, compiles it and runs it, and nicely 
    108 formats output for user display.  This is analogous to L<DBI::Shell>. 
    109  
    110 =item C<DBD::MuldisDB> 
     106that takes Plain Text Muldis D as input, compiles it and runs it, and 
     107nicely formats output for user display.  This is analogous to 
     108L<DBI::Shell>. 
     109 
     110=item C<DBD::Muldis_DB> 
    111111 
    112112A wrapper over the Muldis DB API that makes it work as a L<DBI> driver 
    113113module, should that be useful.  Depending on what DBI itself permits or 
    114114requires, this could take a variety of query definition formats, including 
    115 either or both of Concrete Muldis D or (most likely) Perl Hosted Muldis D. 
    116  
    117 =item C<Muldis::DB::PHMD::Translate::TutorialD> etc 
     115either or both of Plain Text Muldis D or (most likely) Perl Hosted Data 
     116Muldis D. 
     117 
     118=item C<Muldis::DB::PHMD::Translate::Tutorial_D> etc 
    118119 
    119120Utility module that parses the B<Tutorial D> language into Perl Hosted 
    … …  
    125126D>. 
    126127 
    127 =item C<Muldis::DB::PHMD::Translate::SQL::Native> 
    128  
    129 Utility module that parses a Muldis DB-native variant of SQL into 
    130 Perl Hosted Muldis D, and also that generates the former from the latter. 
     128=item C<Muldis::DB::PHDMD::Translate::SQL::Native> 
     129 
     130Utility module that parses a Muldis DB-native variant of SQL into Perl 
     131Hosted Data Muldis D, and also that generates the former from the latter. 
    131132This SQL variant is essentially a cleaned up subset of the SQL:2003 
    132133standard, with some misfeatures removed, some missing features added, and 
    … …  
    143144and what actually happens to implement it. 
    144145 
    145 =item C<Muldis::DB::PHMD::Translate::SQL::\w+> 
     146=item C<Muldis::DB::PHDMD::Translate::SQL::\w+> 
    146147 
    147148Utility modules that parse other variants of SQL (or subsets thereof) into 
    148 Perl Hosted Muldis D, and also that generate the former from the latter. 
    149 Examples of these variants are the actual SQL:2003 standard, and the native 
    150 dialects of each actual SQL DBMS. 
    151  
    152 =item C<Muldis::DB::PHMD::Translate::\w+> 
     149Perl Hosted Data Muldis D, and also that generate the former from the 
     150latter.  Examples of these variants are the actual SQL:2003 standard, and 
     151the native dialects of each actual SQL DBMS. 
     152 
     153=item C<Muldis::DB::PHDMD::Translate::\w+> 
    153154 
    154155Utility modules that translate data (including code and declaratives) 
    155 between representations that are Perl Hosted Muldis D and representations 
    156 that aren't, or between 2 of the latter kind while using the former kind as 
    157 an intermediate representation.  Besides the aforementioned possibilities 
    158 that deal with B<D> languages or SQL, we can have utilities that translate 
    159 to/from native Perl data structures, including native Perl routine 
    160 definitions (L<PPI> would probably be employed in the Perl 5 version), and 
    161 including commonly used third party class' objects. 
     156between representations that are Perl Hosted Data Muldis D and 
     157representations that aren't, or between 2 of the latter kind while using 
     158the former kind as an intermediate representation.  Besides the 
     159aforementioned possibilities that deal with B<D> languages or SQL, we can 
     160have utilities that translate to/from native Perl data structures, 
     161including native Perl routine definitions (L<PPI> would probably be 
     162employed in the Perl 5 version), and including commonly used third party 
     163class' objects. 
    162164 
    163165=item C<Muldis::DB::Proxy::(Server|Client|\w+)> 
    … …  
    185187specific to one SQL DBMS, could be named this. 
    186188 
    187 =item C<DBIx::Class::Storage::MuldisDB> etc 
     189=item C<DBIx::Class::Storage::Muldis_DB> etc 
    188190 
    189191An alternative plug-in storage engine for L<DBIx::Class> that uses Muldis 
    … …  
    245247L<SQL::Generator>, L<SQL::Schema>, L<SQL::Abstract>, L<SQL::Snippet>, 
    246248L<SQL::Catalog>, L<DBIx::Perlish>, L<DBIx::StORM>, L<Tao::DBI>, L<NTuples>, 
    247 L<DBIx::CopyRecord>, L<Data::Domain>, L<Fey>. 
     249L<DBIx::CopyRecord>, L<Data::Domain>, L<Fey>, L<SQL::Tokenizer>. 
    248250 
    249251=head1 AUTHOR 
    … …  
    259261See the LICENSE AND COPYRIGHT of L<Muldis::DB> for details. 
    260262 
     263=head1 TRADEMARK POLICY 
     264 
     265The TRADEMARK POLICY in L<Muldis::DB> applies to this file too. 
     266 
    261267=head1 ACKNOWLEDGEMENTS 
    262268