develooper Front page | perl.cvs.parrot | Postings from January 2009

[svn:parrot] r35409 - in trunk: . languages/pipp languages/pipp/docs

From:
bernhard
Date:
January 11, 2009 04:34
Subject:
[svn:parrot] r35409 - in trunk: . languages/pipp languages/pipp/docs
Message ID:
20090111123438.97853CB9F9@x12.develooper.com
Author: bernhard
Date: Sun Jan 11 04:34:37 2009
New Revision: 35409

Added:
   trunk/languages/pipp/docs/internals.pod   (contents, props changed)
      - copied, changed from r34912, /trunk/languages/pipp/docs/namespaces.pod
Removed:
   trunk/languages/pipp/docs/antlr3.pod
   trunk/languages/pipp/docs/namespaces.pod
Modified:
   trunk/MANIFEST
   trunk/MANIFEST.SKIP
   trunk/languages/pipp/README
   trunk/languages/pipp/docs/pipp.pod
   trunk/languages/pipp/docs/testing.pod

Log:
[Pipp] Work on the docs.


Modified: trunk/MANIFEST
==============================================================================
--- trunk/MANIFEST	(original)
+++ trunk/MANIFEST	Sun Jan 11 04:34:37 2009
@@ -1,7 +1,7 @@
 # ex: set ro:
 # $Id$
 #
-# generated by tools/dev/mk_manifest_and_skip.pl Sun Jan 11 09:13:24 2009 UT
+# generated by tools/dev/mk_manifest_and_skip.pl Sun Jan 11 12:31:49 2009 UT
 #
 # See tools/dev/install_files.pl for documentation on the
 # format of this file.
@@ -2256,9 +2256,8 @@
 languages/pipp/ROADMAP                                      [pipp]
 languages/pipp/Test.php                                     [pipp]
 languages/pipp/config/makefiles/root.in                     [pipp]
-languages/pipp/docs/antlr3.pod                              [pipp]
 languages/pipp/docs/extensions.pod                          [pipp]
-languages/pipp/docs/namespaces.pod                          [pipp]
+languages/pipp/docs/internals.pod                           [pipp]
 languages/pipp/docs/pipp.pod                                [pipp]
 languages/pipp/docs/testing.pod                             [pipp]
 languages/pipp/lib/Parrot/Test/Pipp.pm                      [pipp]

Modified: trunk/MANIFEST.SKIP
==============================================================================
--- trunk/MANIFEST.SKIP	(original)
+++ trunk/MANIFEST.SKIP	Sun Jan 11 04:34:37 2009
@@ -1,6 +1,6 @@
 # ex: set ro:
 # $Id$
-# generated by tools/dev/mk_manifest_and_skip.pl Fri Dec 26 11:40:35 2008 UT
+# generated by tools/dev/mk_manifest_and_skip.pl Sun Jan 11 12:18:19 2009 UT
 #
 # This file should contain a transcript of the svn:ignore properties
 # of the directories in the Parrot subversion repository. (Needed for
@@ -1112,14 +1112,8 @@
 ^languages/pheme/Makefile$
 ^languages/pheme/Makefile/
 # generated from svn:ignore of 'languages/pheme/lib/'
-^languages/pheme/lib/.*\.pbc$
-^languages/pheme/lib/.*\.pbc/
 ^languages/pheme/lib/ASTGrammar\.pir$
 ^languages/pheme/lib/ASTGrammar\.pir/
-^languages/pheme/lib/OSTGrammar\.pir$
-^languages/pheme/lib/OSTGrammar\.pir/
-^languages/pheme/lib/PIRGrammar\.pir$
-^languages/pheme/lib/PIRGrammar\.pir/
 ^languages/pheme/lib/pheme_grammar_gen\.pir$
 ^languages/pheme/lib/pheme_grammar_gen\.pir/
 # generated from svn:ignore of 'languages/pipp/'

Modified: trunk/languages/pipp/README
==============================================================================
--- trunk/languages/pipp/README	(original)
+++ trunk/languages/pipp/README	Sun Jan 11 04:34:37 2009
@@ -1,11 +1,11 @@
 # $Id$
 
 Pipp is Parrot's PHP.
-Pipp is an implementation of the language PHP that runs on Parrot
-and uses the Parrot Compiler Toolkit.
+Pipp is an implementation of the language PHP that runs on Parrot.
+Pipp is implemtented with the Parrot Compiler Toolkit.
 
-Run 'make test' for building and running the tests in F<t>.
-Run 'make smolder_test' for testing and submitting the test result to
+Run 'make test' for building and running the tests in the directory F<t>.
+Run 'make smoke' for testing and submitting the test result to
 http://smolder.plusthree.com/app/public_projects/smoke_reports/10
 
 For more information see F<docs/pipp.pod> or visit L<http://pipp.org>.

Copied: trunk/languages/pipp/docs/internals.pod (from r34912, /trunk/languages/pipp/docs/namespaces.pod)
==============================================================================
--- /trunk/languages/pipp/docs/namespaces.pod	(original)
+++ trunk/languages/pipp/docs/internals.pod	Sun Jan 11 04:34:37 2009
@@ -2,9 +2,51 @@
 
 =head1 TITLE
 
-namespaces - Notes on namespaces in PHP
+internals - Design and Implementation of Pipp
 
-=head1 Namespaces in Pipp
+=head1 Source code
+
+See L<pipp.pod>.
+
+=head1 Issue tracking
+
+See F<../ROADMAP> and L<pipp.pod>.
+
+=head1 Testing
+
+See L<testing.pod>.
+
+=head1 Parsing
+
+Parsing is done with PCT.
+
+=head1 Variables
+
+=over 4
+
+=item globals in top file
+
+=item globals in included files
+
+=item class scope
+
+=item function and method scope
+
+=item constants
+
+=back
+
+=head1 Functions and closures
+
+=head2 Builtin functions
+
+=head2 Closures
+
+=head2 Internal functions
+
+=head1 Object orientation
+
+=head1 Namespaces
 
 A namespace is introduced with the keyword B<namespace>.
 There can be multiple namespaces per file. They are not nested.
@@ -18,7 +60,7 @@
 No global code can precede the first B<namespace> directive.
 Free code is disallowed within namespaces.
 
-=head1 Implementation in Pipp
+=head2 Implementation in Pipp
 
 Currently the namespace directive is only parsed.
 
@@ -29,13 +71,7 @@
 There will be namespaced variables as well.
 'namespace \;' indicates the return to the root namespace.
 
-
-
-=head1 AUTHOR
-
-Bernhard Schmalhofer - <Bernhard.Schmalhofer@gmx.de>
-
-=head1 SEE ALSO
+=head2 SEE ALSO
 
   L<http://docs.php.net/manual/en/language.namespaces.php>
   L<http://wiki.php.net/rfc/namespaces>
@@ -48,4 +84,35 @@
   L<http://bugs.php.net/bug.php?id=46304>
   L<http://loveandtheft.org/2008/10/26/set-sail-for-fail-php-namespaces/>
 
+=head1 Including and requiring
+
+C<require_once()> is supported, but might have issues with variables. 
+
+=head1 Extensions
+
+=head2 Implementation in Pipp
+
+Currently, Pipp has no support at all for extensions.
+
+=head2 SEE ALSO
+
+  TODO: Embedding and Extending PHP, by Sahrah ...
+  L<http://www.php.net/manual/en/internals2.php>
+
+=head1 Interaction with the Parrot world
+
+Using Modules from other HLLs. Inlining PIR and other languages.
+
+=head1 Compatability
+
+See L<pipp.pod> for a list of divergences.
+
+=head1 Related projects.
+
+See the Wiki. Roadsend, Zend, PHC.
+
+=head1 AUTHOR
+
+Bernhard Schmalhofer - <Bernhard.Schmalhofer@gmx.de>
+
 =cut

Modified: trunk/languages/pipp/docs/pipp.pod
==============================================================================
--- trunk/languages/pipp/docs/pipp.pod	(original)
+++ trunk/languages/pipp/docs/pipp.pod	Sun Jan 11 04:34:37 2009
@@ -33,7 +33,7 @@
 
 =head1 Implementation
 
-Pipp is based on the Parrot Compiler Toolkit.
+Pipp is based on the Parrot Compiler Toolkit. See L<internals.pod> for details.
 
 =head1 Status
 

Modified: trunk/languages/pipp/docs/testing.pod
==============================================================================
--- trunk/languages/pipp/docs/testing.pod	(original)
+++ trunk/languages/pipp/docs/testing.pod	Sun Jan 11 04:34:37 2009
@@ -8,10 +8,10 @@
 
 For testing the test-suite from PHP 5.3 is used.
 For sanity checking there are also few tests in
-the subdirs of F<languages/pipp/t>.
-These tests are used by 'make test'.
+below the directory subdirs of F<pipp/t>.
+These tests are executed by 'make test'.
 
-Run individual tests like:
+Run individual tests e.g.:
   
   perl t/harness --verbose t/in_php/01_sea_only.t
 



nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About