just a remark I like smart comments But from the past i documented my scripts (sh,perl,c,...) with many lines of form: ### @(#)description of prog, author, dependencies, ... Obviously there could arise problems if we use this style together with smart comments NB the '### @(#)' style documentation goes back to the (not more used?) "what" programm, part of the (not more used?) "documenters work bench" :-) Simple solution is "use Smart::Comments '####';"