[quote=lichtkind,25.Mar..2004, 03:20]@strat
noch zu meinen klingonen kommentar:
ich find es besser statt den quellcode mit kommentaren zu verstopfen, gut zu programmieren wenige kommentare für je einen block oder ne stelle wo nötig, ansonst im modulkopf oder an einer api alles weiter gehört in eine seperate POD || DOKU
(OT aber das ist hier ja eh ein allgemeiner Thread)
werde mich das nächste mal auch brav hinten einreihen (http://board.perl-community.de/cgi-bin....SF;f=22)[/quote]
Einverstanden. Das Offensichtliche muss man nicht kommentieren. Crians Vorschlag halte ich fuer Overkill: Name ist ueberfluessig, der steht ja hinter "sub"; Autoren auf Funktionsebene zu benennen ist zu fein, da reicht ein Vermerk im Copyright des Modulheaders und evtl. ein Logeintrag im Versionskontrollsystem; die Aufgabe sollte im Pod beschrieben sein (inline oder in einer externen Datei); Aenderungslogs sollten ebenfalls nur im CVS stehen.