? languages/m4
? languages/befunge/befunge.pbc
Index: imcc/docs/imcc.pod
===================================================================
RCS file: /cvs/public/parrot/imcc/docs/imcc.pod,v
retrieving revision 1.5
diff -u -u -r1.5 imcc.pod
--- imcc/docs/imcc.pod	23 Oct 2003 17:02:54 -0000	1.5
+++ imcc/docs/imcc.pod	25 Nov 2003 21:42:21 -0000
@@ -12,30 +12,51 @@
 
 =head1 OVERVIEW
 
-IMCC is the Intermediate Code Compiler for Parrot.  The language it
-compiles is termed Parrot Intermediate Language (PIR).
+IMCC is the Intermediate Code Compiler for Parrot. 
+IMCC is invoced as the executable 'parrot'. 
 
-This document describes available IMCC documentation.
+The language IMCC compiles is termed Parrot Intermediate Representation (PIR).
+PIR is the primary target of language implementations. PIR code is usually stored
+in files with the extension B<.imc>.
+
+This document describes available IMCC documentation. 
+Unless otherwise indicated the described documentation is located
+in parrot/imcc/docs. 
+
+See also the documentation in parrot/docs.
 
 =head1 DESCRIPTION
 
-=head2 running.pod
+=head2 calling_conventions.pod
+
+Describes the standard way of passing arguments and receiving results from
+subroutines.
+
+=head2 imcfaq.pod
 
-IMCC's command line options.
+A must read for potential language implementors.
+
+=head2 macros.pod
+
+The macro layer of parrot.
+
+=head2 operation.pod
+
+Describes how parrot operates internally. 
 
 =head2 parsing.pod
 
 Basic parsing functionality.
 
-=head2 syntax.pod
+=head2 running.pod
 
-The syntax of B<.imc> files.
+parrot's command line options.
 
-=head2 operation.pod
+=head2 syntax.pod
 
-IMCC operation basics.
+The syntax of B<.imc> files.
 
-=head2 README
+=head2 parrot/imcc/README
 
 Summary of IMCC features and syntax.