|
|
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@xxxxxx>
-
-=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@xxxxxx>
+
=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
|
|