# New Ticket Created by  Andy Dougherty 
# Please include the string:  [perl #38480]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/rt3/Ticket/Display.html?id=38480 >


I thought I'd try the ackermann "shootout" function, but alas ran into

        ./parrot -Oc -C ack.pir 11
        Couldn't find init_func for core 6

The following patch would have made it slightly easier for me to figure it 
out (mostly by assuring that the same abbreviations are used consistently 
so that grep helps you finds the relevant documents more quickly.)

diff -ru parrot-current/docs/porting_intro.pod 
parrot-andy/docs/porting_intro.pod
--- parrot-current/docs/porting_intro.pod       Wed Oct  5 03:15:03 2005
+++ parrot-andy/docs/porting_intro.pod  Fri Feb 10 09:36:31 2006
@@ -13,7 +13,7 @@
 internals.  For each feature, a brief description of its purpose, hints on
 helping to port it, and pointers to more information are included.
 
-=head1 CGoto
+=head1 CGoto or CGP (CGoto Predereferenced)
 
 =head2 What it is
 
diff -ru parrot-current/docs/running.pod parrot-andy/docs/running.pod
--- parrot-current/docs/running.pod     Sun Dec  4 03:15:02 2005
+++ parrot-andy/docs/running.pod        Fri Feb 10 10:04:46 2006
@@ -133,6 +133,8 @@
 
 =head2 Run Core Options
 
+TODO:  The default run core should be indicated.
+
 =over 4
 
 =item -b, --bounds-checks, --slow-core
@@ -141,7 +143,7 @@
 
 =item -C, --CGP-core
 
-Select the CGP (CGoto Predereferenced) core.
+Select the CGP (CGoto Predereferenced) core (if available).
 
 =item -f, --fast-core
 
@@ -149,19 +151,19 @@
 
 =item -g, --computed-goto-core
 
-Select the CGoto core.
+Select the CGoto core (if available).
 
 =item -j, --jit-core
 
-Run with the JIT subsystem.
+Run with the JIT subsystem (if available).
 
 =item -p, --profile
 
-Run with the slow core and do print an execution profile.
+Run with the slow core and print an execution profile.
 
-=item -P, --predereferenced-core
+=item -S, --switched-core
 
-Predereference opcode function arguments on the fly.
+TODO:  This needs to be documented briefly here and also in glossary.pod.
 
 =item -t, --trace
 
--- parrot-current/src/parrot.c Sun Apr 10 11:15:05 2005
+++ parrot-andy/src/parrot.c    Fri Feb 10 10:17:02 2006
@@ -8,7 +8,8 @@
 
 =head1 DESCRIPTION
 
-THIS FILE IS NOT USED.
+THIS FILE IS NOT USED.  
+The main function for parrot is found in ../compilers/imcc/main.c.
 
 =cut
 

-- 
    Andy Dougherty              [EMAIL PROTECTED]

Reply via email to