> #File: Foo.pm
> sub foo : doc( <<EOS )
> Function: Foo
> In: scalar - int - foo identifier
> Out: array - decomposed foo
> Effects: Queries Foo DB
> Exceptions: DBI, "bad foo id"
> EOS
> {
This is an interesting and powerful idea, but I can't help thinking that it
needs to be implemented in terms of pod, or we will end up with 2
incompatible systems for documenting Perl code. Something more like (off
the top of my head):
sub foo: apidoc
=for apidoc
In: scalar - int - foo identifier
Out: array - decomposed foo
Effects: Queries Foo DB
Exceptions: DBI, "bad foo id"
=cut
{
====================================================
Mark Leighton Fisher Thomson Consumer Electronics
[EMAIL PROTECTED] Indianapolis, IN, USA
"Display some adaptability." -- Doug Shaftoe, _Cryptonomicon_
