Plain Old Documentation
# Plain Old Documentation

Plain Old Documentation (POD) ist eine vereinfachte Auszeichnungssprache, die 1994 von Larry Wall mit Perl 5 eingeführt wurde, um Dokumentation in den Quelltext von Perl-Programmen einzufügen.

## Eigenschaften von POD

POD ist eine einfache Sprache in mehrerer Hinsicht:

* einfach zu schreiben (für den Autor)
* leicht lesbarer Quellcode
* leicht zu parsen
* leicht in andere Sprachen und Formate umzuwandeln – etwa in UNIX-Manpages, LaTeX, troff oder HTML
* einfach, Quellcode darin unterzubringen

## Verbreitung

POD ist die meistbenutzte Sprache, um Perlprogramme und -module zu dokumentieren, Perl selbst eingeschlossen, und ist auch Standard für die Dokumentation der Module im CPAN.

## Beispiel-Dokument

Das folgende Dokument demonstriert die Verwendung aller Sprachelemente.

## Werkzeuge

Die folgenden Werkzeuge verarbeiten POD:

### pod2html

    erzeugt html aus POD

### pod2latex

    generiert LaTeX aus POD

### pod2man

    macht Manpages aus POD

### pod2text

    einfacher Text aus POD

### pod2usage

    druckt usage:-Zeile aus eingebettetem POD

### pod2wiki

    verwandelt POD in verschiedene Wikiformate, darunter auch mediawiki

### podchecker

    Syntaxchecker für POD

### podselect

    druckt ausgewählte Abschnitte aus POD auf stdout

### Weitere Werkzeuge wie Pod

    :ProjectDocs können die Dokumentation ganzer Projekte automatisiert beispielsweise nach HTML wandeln

## Ähnliche Werkzeuge

* Javadoc
* Doxygen
* Natural Docs
* PhpDocumentor
* Sphinx
