Fortran: Anhang D: ROBODoc

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

ROBODoc ist freie Software unter der GNU General Public License. Dieses Tool verwendet die normalen Kommentarzeichen der jeweiligen Programmiersprache und nutzt für die Dokumentationsgenerierung eigene Auszeichnungstags innerhalb dieser Kommentare.

Ein einfaches Beispiel

Beispielcode

Fortran 90/95-Code (free source form)

!****h* Beispielprogramm/circle
! NAME
!   circle
!
! DESCRIPTION
!   Modul fuer Kreisfunktionen
!
! AUTHOR
!   Intruder
!
! CREATION DATE
!   04.08.2007
!******
module circle
  implicit none


  !****d* circle/pi
  ! NAME
  !  pi
  !
  ! DESCRIPTION
  !  pi = 3.14
  !******
  real, parameter :: pi = 3.14


  contains
    !****f* circle/area
    ! NAME
    !   area
    !
    ! DESCRIPTION
    !   Berechnet Kreisflaeche
    !
    ! INPUTS
    !   r ... Radius (real)
    !
    ! RESULT
    !    Kreisflaeche (real)
    !******
    real function area( r )
      implicit none 

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

Fortran 90/95-Code (free source form)

!****h* Beispielprogramm/main
! NAME
!   main
!
! DESCRIPTION
!   Hauptprogramm
!
! AUTHOR
!   Intruder
!
! CREATION DATE
!   04.08.2007
!******
program main
  use circle
  implicit none
  
  real            :: r, a
  
  read( *, * ) r
  a = area( r )
  write( *, * ) "Flaeche = ", a
end program main

Erstellen der Dokumentation

Erstellen der Dokumentation im HTML-Format als Multidokument mit Index:

robodoc --src . --doc doc --multidoc --html --index

Screenshot

Kurze Erläuterung

ROBODoc filtert die erforderlichen Angaben für die Dokumentation aus den Fortran-Kommentaren heraus. Zu diesem Zweck sind in den Kommentaren Header einzubauen. Diese Header bestehen aus

begin marker
items
end marker

Ein begin marker beginnt immer mit 4 Sternchen, dann kommt ein Buchstabe als Elementkennzeichner. Es folgt ein Stern und dann Angaben zur Stellung des Elementes in der Dokumentationshierarchie.

In diesem Beispiel wurden folgende Elementkennzeichner verwendet:

h ... Modul
f ... Funktion
d ... Konstante (Definition)

Der Hierarchiebaum wird durch die strikte Angabe von

übergeordnetes Element/aktuelles Element

erstellt.

Die verschiedenen Items sind dann unterhalb dieses begin markers durch Schlüsselworte gekennzeichnet:

NAME
DESCRIPTION
AUTHOR
etc.

Sie dienen zur konkreten Beschreibung des jeweiligen Elementes.

Abgeschlossen wir ein solcher Dokumentations-Header durch den end marker. Dieser wird durch mindestens drei Sternchen gebildet.

Zwecks Erstellung der Dokumentation sind viele Optionen verfügbar. Die unbedingt erforderlichen Angaben sind

--src mit Angabe der Quelldatei bzw. dem Verzeichnis, in dem die Quelldateien liegen
--doc mit einem Vornamen für die Dokumentationsdateien bzw. der Bezeichnung des gewünschten Dokumentationsverzeichnisses
eine Angabe zu der Dokumentationsform:
- --multidoc ... Die Dokumentation wird in Form mehrerer Einzeldateien in des Dokumentationsverzeichnis geschrieben
- --singledoc ... Der Dokumentationsinhalt wird in eine einzige Datei geschrieben
die Angabe des Dokumentationsformates:
- --html ... HTML
- --rtf ... RTF
- --latex ... LaTeX
- --dbxml ... XML DocBook

Für dieses Beispielprojekt wird auch noch ein Index erstellt (--index).

Detaillierte Informationen zu ROBODoc sind unter dem nachfolgend angeführten Weblink zur ROBODoc-Homepage abrufbar.

Weblinks

ROBODoc

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