Fortran: Anhang D: Natural Docs

<<< zur Fortran-Startseite
<< Anhang D: Quellcodedokumentation	Weblinks >>
< ROBODoc	Doxygen >

Auch der Dokumentationsgenerator Natural Docs unterstützt bereits Fortran ab dem Standard 90/95 (free source form) in einer Basisvariante. Natural Docs ist in der Programmiersprache Perl verfasst. Als Softwarelizenz wurde die General Public License gewählt. Zum Zeitpunkt der Kapitelerstellung war die Version 1.35 aktuell.

Ein einfaches Beispiel

Fortran 90/95-Code (free source form)

! Section: Beispielprogramm
!   Autor: Intruder, Datum: 04.08.2007


! Group: circle
!   Modul fuer Kreisfunktionen
module circle
  implicit none


  ! Constant: pi
  !   pi = 3.14
  real, parameter :: pi = 3.14


  contains
    ! Function: area
    !   Berechnet Kreisflaeche
    !
    ! Parameters:
    !   r ... Radius (real)
    !
    ! Returns:
    !    Kreisflaeche (real)
    real function area( r )
      implicit none 

      real, intent( in ) :: r
    
      area = r ** 2 * pi
    end function area
end module circle


! Group: main
!   Hauptprogramm
program main
  use circle
  implicit none
  
  real            :: r, a
  
  read( *, * ) r
  a = area( r )
  write( *, * ) "Flaeche = ", a
end program main

Erstellung der HTML-Dokumentation:

NaturalDocs -i . -o HTML bsp -p .

Screenshot:

Kurze Erläuterung

Natural Docs filtert die benötigten Informationen mit Hilfe von Schlüsselwörtern aus den Kommentarbereichen der Fortrandateien. Die im Beispielprogramm verwendeten Schlüsselwörter sind:

Section
Group
Constant
Function
Parameters
Returns

Groß- Kleinschreibung spielt bei diesen Schlüsselwörtern kein Rolle. Abgeschlossen wird ein Schlüsselwort mit einem Doppelpunkt.

Beim Ausgabeschalter (-o) muss neben einem Ausgabeverzeichnis auch noch ein Ausgabeformat angegeben werden. Möglich sind

HTML
FramedHTML

Beim Schalter -p ist ein (Projekt)Verzeichnis anzugeben, wo Natural Docs einige benötigte Dateien ablegen kann, die nicht direkt zur erstellten Dokumentation gehören.

Für weitergehende Infos zu Natural Docs wird auf die unten angegebene Webpräsenz zu dieser Software verwiesen.

Weblinks

Natural Docs

<<< zur Fortran-Startseite
<< Anhang D: Quellcodedokumentation	Weblinks >>
< ROBODoc	Doxygen >