RDocF95: Enhanced version of RDoc Fortran 90/95 parser
RDocF95 is an improved RDoc for generation of documents of Fortran 90/95 programs.
Differences to the original one are given below.
- Enhancement of “parser/f95.rb”
The Fortran 90/95 parse script “parser/f95.rb” (In rdoc-f95, old name “parsers/parse_f95.rb” is used yet) is modified in order to parse almost all entities of the Fortran 90/95 Standard.
- Addition of
In the Fortran 90/95 Standard,
upper case letters are not distinguished from lower case letters, although original RDoc produces case-dependently cross-references of Class and Methods. When this options is specified, upper cases are not distinguished from lower cases.
- Cross-reference of file names
Cross-reference of file names is available as well as modules, subroutines, and so on.
- Modification of
Original RDoc can not treat relative path stylesheet. Application of this patch modifies this function.
- Conversion of TeX formula into MathML
TeX formula can be converted into MathML format with –mathml option, if MathML library for Ruby version 0.6b – 0.8 is installed. This library is available from Bottega of Hiraku (only JAPANESE). See RDocF95::Markup::ToXHtmlTexParser about format.
*** Caution *** Documents generated with “–mathml” option are not displayed correctly according to browser and/or its setting. We have been confirmed that documents generated with “–mathml” option are displayed correctly with Mozilla Firefox and Internet Explorer (+ MathPlayer). See MathML Software - Browsers for other browsers.
Some formats of comments in HTML document are changed to improve the analysis features. See parse_f95.rb
Set the environment variable PATH to include the directory where the execution program is installed, and RUBYLIB to include the directory where the libraries are installed.
Move to a directory where your Fortran 90/95 files exist, and execute the following command. HTML documents will be generated in doc directory.
% rdoc-f95 -U --ignore-case --inline-source
.F95 are parsed as Fortran 90/95 programs. All Fortran 90/95 programs in subdirectories are parsed recursively.
Just as in the original RDoc, files ending with
.rbw are parsed as Ruby programs and files ending with
.cxx are parsed as C programs.
With the option
the directory where HTML documents are generated can be changed.
--title option sets title of HTML documents. When
--all option is used, private subroutines, functions etc. in Fortran 90/95 programs are shown in HTML documents (for developers). If files or directories are specified as arguments (for example, “
src/*.f90” or “
test/”), the particular files are parsed. In the following example, files with suffix “
.f90” in a directory “
src/” and files in a directory “
test/” are parsed.
% rdoc-f95 -U --ignore-case --inline-source \ --op rdoc --title "RDoc documentations" src/*.f90 test/
Alternatively, you can parse only a part of files by creating a “
.document” file and writing names of the files and the directories to the file.
For more information, see www.ruby-doc.org/stdlib/libdoc/rdoc/rdoc/index.html
Refer to parse_f95.rb which explains parsed information, way of looking at documents, the format of comment blocks in Fortran 90/95 source code. If you use “–mathml” option (see below), refer to RDocF95::Markup::ToXHtmlTexParser, too. For general information, see www.ruby-doc.org/stdlib/libdoc/rdoc/rdoc/index.html
Licence of RDocF95 conforms to that of original RDoc. see rdoc.rubyforge.org/