[Numpy-svn] r3890 - trunk/numpy/f2py/lib/parser

[numpy-svn at scipy.org]

Author: pearu
Date: 2007-07-19 06:12:38 -0500 (Thu, 19 Jul 2007)
New Revision: 3890

Modified:
   trunk/numpy/f2py/lib/parser/doc.txt
Log:
update fortran parser docs, 2

Modified: trunk/numpy/f2py/lib/parser/doc.txt
===================================================================
--- trunk/numpy/f2py/lib/parser/doc.txt	2007-07-19 11:04:25 UTC (rev 3889)
+++ trunk/numpy/f2py/lib/parser/doc.txt	2007-07-19 11:12:38 UTC (rev 3890)
@@ -16,23 +16,25 @@
 
 The Fortran parser package is a Python implementation
 of Fortran 66/77/90/95/2003 language parser. The code
-is under NumPy SVN tree: `numpy/f2py/lib/parser/`.
-The Fortran language syntax rules are defined in `Fortran2003.py`,
+is under NumPy SVN tree: `numpy/f2py/lib/parser/`__.
+The Fortran language syntax rules are defined in `Fortran2003.py`__,
 the rules are taken from the following ISO/IEC 1539 working draft:
 http://j3-fortran.org/doc/2003_Committee_Draft/04-007.pdf.
 
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/Fortran2003.py
 
 Fortran parser package structure
 ================================
 
 `numpy.f2py.lib.parser` package contains the following files:
 
-api.py
-------
+api.py - public API for Fortran parser
+--------------------------------------
 
-Public API for Fortran parser.
+`This file`__ exposes `Statement` subclasses, `CHAR_BIT` constant, and a function `parse`.
 
-It exposes `Statement` subclasses, `CHAR_BIT` constant, and a function `parse`.
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/api.py
 
 Function `parse(<input>, ..)` parses, analyzes and returns a `Statement`
 tree of Fortran input. For example,
@@ -82,8 +84,10 @@
 readfortran.py
 --------------
 
-This file contains tools for reading Fortran codes from file and string objects.
+`This file`__ contains tools for reading Fortran codes from file and string objects.
 
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/readfortran.py
+
 To read Fortran code from a file, use `FortranFileReader` class.
 `FortranFileReader` class is iterator over Fortran code lines
 and is derived from `FortranReaderBase` class.
@@ -227,8 +231,10 @@
 parsefortran.py
 ---------------
 
-This file contains code for parsing Fortran code from `FortranReaderBase` iterator.
+`This file`__ contains code for parsing Fortran code from `FortranReaderBase` iterator.
 
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/parsefortran.py
+
 `FortranParser` class holds the parser information while
 iterating over items returned by `FortranReaderBase` iterator.
 The parsing information, collected when calling `.parse()` method,
@@ -248,9 +254,14 @@
             PRINT *, "a=", a
           END SUBROUTINE foo
 
-block_statements.py, base_classes.py, typedecl_statements.py, statements.py
----------------------------------------------------------------------------
+Files `block_statements.py`__, `base_classes.py`__, `typedecl_statements.py`__, `statements.py`__
+-------------------------------------------------------------------------------------------------
 
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/block_statements.py
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/base_classes.py
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/typedecl_statements.py
+__ http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/f2py/lib/parser/statements.py
+
 The model for representing Fortran code statements consists of a tree of `Statement`
 classes defined in `base_classes.py`. There are two types of statements: one-line
 statements and block statements. Block statements consists of start and end