[LON-CAPA-dev] Commenting standards.

Scott Harrison lon-capa-dev@mail.lon-capa.org
Wed, 29 May 2002 14:10:08 -0400


Dear All:

> On the whole, most modules already have this information,

Actually, I think only about 10% of all the Apache perl modules have any
POD documentation.

I do agree with distributing the pod documentation throughout the subroutines.

(Note that each POD subsection must begin with '=pod'.
 Quite often, people just start with '=head2' or some other
 POD statement.)

Regards,
Scott

-- 
Scott Harrison, harris41@msu.edu