Nebenbei: eine Klasse bedeutet die Kapselung von Daten und Methoden, mit denen auf diese Daten zugegriffen wird. Von daher verstehe ich die Rolle von Functions.pm nicht, sondern wuerde diese als Methoden direkt in Document.pm legen.

zu main.pl:

in einem Modul sollte man meiner Meinung nach ausserhalb von Subroutinen keinen Code stehen haben (ausser vielleicht, wenn es sich um Konfiguration fuer dieses Modul handelt, oder ev. Caching-Variablen, auch wenn letztere meistens in einer eigenen Closure meist besser aufgehoben sind). Falls man dies doch tut, wird der Code ausgefuehrt, wenn das Modul geladen wird, und das kann leicht an der falschen Stelle sein. Ich bevorzuge den initialen Aufruf im Hauptprogramm, weil man dann genau sieht, wo es mit der Logik weitergeht, und man nicht bei 50 Modulen in jedem nachschauen muss, was denn da an Funktionalitaet direkt beim Laden ausgefuehrt wird. Sowas macht die Programmlogik naemlich ganz schoen undurchsichtig.