In a Nutshell
Doctran is a cross-platform documentation generation tool for the Fortran programming language. It's purpose is
to take free-format Fortran files, and produce a collection of linked html files documenting their contents.
Doctran can currently create documentation from source codes that contain constructs from the Fortran 95 standard
and object oriented constructs from the Fortran 2003 standard.
Some key features of Doctran are listed below.
- Full support for Fortran 95 standard. More details ...
- Support for Fortran 2003's object oriented features. More details ...
- Creates linked HTML pages with breadcrumb and drop-down menu navigation.
- Procedure syntax is displayed as would be written in your Fortran codes.
The ultimate aim of this project is to create robust software for creating documentation for the Fortran
language, that will eventually be open-source. In order to show this intention, I have released the base
code under the Mozilla Public License Version 2.0 and made it
freely available on Doctran's GitHub page.
Doctran is a modular project and contains multiple components. Each of these components contain various related
features enhancing the standard capabilities.
To allow further development of Doctran, components will initially be released as proprietary. However, they will
be open sourced under the Mozilla Public License Version 2.0 once
a sales target has been achieved.
A full list of the available and upcoming components can be viewed within the list on the left, along with the
number of sales required until they will be open sourced.
A trial version that includes the Doctran base, Fortran 95 and Fortran 2003 components is available on the Downloads page.
Version 1.2.5 Released
Version 1.2.5 has been released. The updates includes fixes some display issues with the menu and better syntax highlighting.
Version 1.2.4 Released
Version 1.2.4 has been released. The updates adds extra reporting for invalid source files and fixes some issues.
Version 1.2.3 Released
Version 1.2.3 has been released. This update fixes a couple of small bugs and improves the error message outputs.
Version 1.2.2 Released
Version 1.2.2 has been released. This update introduces a new style for documentation that is better suited for wide screen and high resolution displays. Major enhancements are menu customization and inclusion user defined pages is now possible. Doctran can now also act as a basic static wiki generator, and the new documentation is now produced by Doctran. See here for a full list of what's new.
Next Plugin Chosen
The next plugin for Doctran will be the 'Fortran 2003: Interop plugin'. This will add the ability to document code containing the bind(C) attribute.
Version 1.2.1 Released
A new version is available. The new version includes an improved faster parser, as well as a couple of fixes.
New forums launched to discuss everything about Doctran.
Version 1.2 Released
Doctran version 1.2 has been released. This includes the new Fortran 2003: Object Orientation plugin allowing you to document your procedure components, abstract interfaces, extended types and more.
Version 1.1 Released
Version 1.1 has been released. This adds Markdown support, documentation search, color schemes, syntax highlighting, some visual enhancements and bug fixes.
Doctran has just been launched, so start documenting your Fortran codes today!!!