use POD or die $!; #### # function: foo # input : bar baz # output : qux # precond : bar and baz are defined # postcond: qux is defined sub foo { } #### =for comment function: foo input : bar baz output : qux precond : bar and baz are defined postcond: qux is defined =cut sub foo { }