G95-XML Homepage

• Modification of the g95 parser and output to XML format
• Fortran source code browser
• Re-writing of parsed Fortran source code and comparison with the original source code
• Validation of the parser and source browser over a very large number of Fortran packages

The XML output of the g95-xml parser, though describing very acurately Fortran code is pretty hard to deal with. I have written Perl scripts to handle its output and make something usable out of it.

The approach I used was to write scripts so that I could reproduce a compiling environment; therefore, g95-xml provides scripts named f95, ar, ld. All these Perl scripts behave like a Fortran compiler and associated binary management utilities.

For instance, parsing a Fortran source file named main.f90 is just the matter of typing ( assuming g95-xml's f95, ar, ld are in your PATH ):

$ f95 -c -html -keep-xml main.f90
$ ls -l main.* 
-rw-rw-r-- 1 phi001 phi001    50 avr 26 19:42 main.f90
-rw-r--r-- 1 phi001 phi001 24576 avr 26 19:49 main.o
-rw-r--r-- 1 phi001 phi001  5075 avr 26 19:49 main.xml

The command we issued produced an XML file containing the full description of our source code, and a .o file which contains the table of global symbols of main.f90 and a frozen Perl structure which has been re-built from the XML.

The -html option was added to generate HTML code for this Fortran unit; it is embedded in the .o file.

Hence you see that you can parse your Fortran code using the Makefile ( or a more elaborate build system ) you have already written.

Please note that the Apache+mod_perl browser is much more easier to use; its possible to browse executables and libraries as well. In fact, it is possible to configure Apache so that a particular handler takes care of some requests ( and let others to the standard Apache webserver ). I use this feature so that regular files and directories be served directly by Apache, and .exe, .o, .a files be processed by a dedicated handler.

I would like to express my gratitude to Andy Vaught, who wrote a very nice piece of software and allowed everybody to use it and access its source code.