In die SYNOPSIS könntest du reinschreiben, wie man das Modul typischerweise benutzt --- im Idealfall muss der Benutzer dann nur Copy'n'Paste machen.

Es würde sich auch anbieten, aus dem Modul gleichzeitig ein ausführbares Skript zu machen. Einfach aus der letzten Zeile "return 1;" ein machen. Danach könnte der Skriptcode folgen (wahrscheinlich wieder das gleiche wie in der SYNOPSIS, mit ein bisschen Option-Handling).