Kapitel 26. Plain Old Documentation

Ein dem Perl-Design zugrundeliegendes Prinzip besagt, daß einfache Dinge einfach und schwierige Dinge möglich sein sollen. Die Dokumentation sollte einfach sein.

Perl unterstützt ein einfaches Text-Markup-Format namens POD, das für sich allein stehen oder völlig frei mit Ihrem Quellcode vermischt werden kann, um die Dokumentation einzubetten. POD kann zum Drucken oder Betrachten in viele andere Formate umgewandelt oder auch direkt gelesen werden, weil es so »schlicht« (plain) ist.

POD ist nicht so ausdrucksstark wie Sprachen wie XML, LaTeX, troff(1) oder auch HTML. Das ist Absicht: Wir opfern die Ausdrucksstärke der Einfachheit und Bequemlichkeit. Einige Text-Markup-Sprachen lassen die Autoren mehr Markups als ...

Get Programmieren mit Perl now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.