Re: PHPod documentation
| From: | Stig S. Bakken | Date: | Wed, 01 Aug 2001 07:11:10 +0000 |
| Subject: | Re: PHPod documentation | ||
| References: | 1 2 3 4 5 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-1208@lists.php.net to get a copy of this message | ||
"Stig S. Bakken" wrote:
>
> Chuck Hagenbuch wrote:
> >
> > Quoting Jon Parise <jon@php.net>:
> >
> > > I'm sort of leaning toward developing our own PearDoc system that
> > > is based on the existing PHPDoc / JavaDoc syntax (because of
> > > legacy code and familiarity), but I would really like to see the
> > > capabilities of POD-style documentation be added, too.
> >
> > For those of us who've never used POD, maybe if someone were to explain what
> > those (the capabilities of POD-style documentation) are, it would help?
>
> POD stands for "Plain Old Documentation" and is an embedded
> documentation format used by Perl. For examples, look at any .pm file
> in /usr/lib/perl5/site_perl. POD is very plain text-centric, but that
> doesn't mean we can steal the ideas and use them in a different way.
^^^
can't
- Stig