Perl ha questo metodo di documentazione davvero interessante che semplifica la documentazione. Si chiama POD (Plain Old Documentation) . Ecco un esempio:
=head1 NAME
Example::Module - an example
=head1 SYNOPSIS
use Example::Module;
my $object = Example::Module->new();
print $object->as_string;
=head1 DESCRIPTION
Just an example.
=head2 Methods
=over 12
=item C<new>
Returns a new My::Module object.
=item C<as_string>
Returns a stringified representation of
the object. This is mainly for debugging
purposes.
=back
=head1 LICENSE
This is released under the Artistic
License. See L<perlartistic>.
=head1 AUTHOR
Dynamic
=head1 SEE ALSO
L<perlpod>
=cut
L'output di questo sarebbe in HTML, come questo esempio su CPAN (non quello che ho scritto). Fantastico!
Quindi esiste un metodo simile al POD in cui uno sviluppatore può inserire la documentazione all'interno del codice stesso, senza che si tratti di un commento?