From 7bab3799412c26d4ee12363de4b9b19430fb0d2d Mon Sep 17 00:00:00 2001 From: Francois Perrad Date: Sat, 7 Nov 2009 17:14:29 +0100 Subject: [PATCH] update doc --- doc/running.pod | 2 +- doc/status.pod | 98 ++++++++++++++++++++++++------------------------- 2 files changed, 50 insertions(+), 50 deletions(-) diff --git a/doc/running.pod b/doc/running.pod index 4bd4a4d..212f055 100644 --- a/doc/running.pod +++ b/doc/running.pod @@ -30,7 +30,7 @@ Retrieve Lua Configure & build Lua - perl Configure.pl + parrot Configure.pir make =head2 Running the Test Suite diff --git a/doc/status.pod b/doc/status.pod index e73064e..4576c78 100644 --- a/doc/status.pod +++ b/doc/status.pod @@ -19,8 +19,8 @@ This implementation is aligned with Lua 5.1 specifications. =head2 PIR Compiler/Interpreter -C is the interpreter/compiler, see F -& F. +C is the interpreter/compiler, see F +& F. C is written in PIR and generates PIR from Lua sources. C uses the following Parrot compiler toolchain components : @@ -29,17 +29,17 @@ C uses the following Parrot compiler toolchain components : =item PGE -The Lua grammar is described in F. +The Lua grammar is described in F. The PIR code is emitted by C. C is also used by the Lua pattern compiler in -F. +F. =item TGE Two stages of tree transformation are used -F & F. +F & F. =item PAST @@ -56,13 +56,13 @@ F. =back -The lexicography part could be checked with F. +The lexicography part could be checked with F. -The code generation could be examined with F. +The code generation could be examined with F. =head3 KNOWN PROBLEMS -in F : +in F : a = {} local x = 20 @@ -93,33 +93,33 @@ This compiler is written in Perl5 : Implemented with Perl5 regex -F +F =item * parser Implemented with Parse::Yapp. -It supports the full grammar described in F. +It supports the full grammar described in F. Only one C rule, so the syntax error diagnostic is minimalist. -F +F =item * code generation -F +F =item * symbole table -F +F =item * opcode representation -F +F =item * opcode emission -F +F =back @@ -129,17 +129,17 @@ There are eight basic types in Lua, each of them is implemented by a PMC. =over 4 -=item * nil F +=item * nil F -=item * boolean F +=item * boolean F -=item * number F +=item * number F -=item * string F +=item * string F -=item * function F +=item * function F -=item * userdata F +=item * userdata F This type allows OO extension. @@ -151,16 +151,16 @@ This type is used to implement coroutines. The current implementation use the library F. -=item * table F +=item * table F This type is I data structure of the language. =back -F provides an abstract base class for all +F provides an abstract base class for all Lua types. -F is a singleton PMC what holds some static methods. +F is a singleton PMC what holds some static methods. =head3 TODO @@ -176,29 +176,29 @@ Lua 5.1 defines the following standard libraries: =over 4 -=item * basic library F +=item * basic library F -=item * coroutine manipulation F +=item * coroutine manipulation F -=item * package library F +=item * package library F -=item * string manipulation F +=item * string manipulation F -=item * table manipulation F +=item * table manipulation F -=item * mathematical functions F +=item * mathematical functions F -=item * input and output F, F +=item * input and output F, F -=item * operating system facilities F +=item * operating system facilities F -=item * debug facilities F +=item * debug facilities F =back -F is the equivalent of Auxiliary Library. +F is the equivalent of Auxiliary Library. -F implements a regex compiler using PGE. +F implements a regex compiler using PGE. =head3 TODO @@ -210,33 +210,33 @@ These libraries are loaded dynamically with the Lua function C. =over 4 -=item * alarm library F +=item * alarm library F -=item * base64 library F +=item * base64 library F -=item * big number library F +=item * big number library F -=item * bitwise operation library F +=item * bitwise operation library F -=item * bitwise operation library F +=item * bitwise operation library F -=item * complex library F +=item * complex library F -=item * Lua File System library F +=item * Lua File System library F -=item * LPeg library F +=item * LPeg library F -=item * markdown library F +=item * markdown library F -=item * mathx library F +=item * mathx library F -=item * md5 & sha1 library F +=item * md5 & sha1 library F -=item * random library F +=item * random library F -=item * struct library F +=item * struct library F -=item * uuid library F +=item * uuid library F =back