Re: Re: documentation generation question
| From: | Tony Bibbs | Date: | Thu, 03 Apr 2003 20:09:08 +0000 |
| Subject: | Re: Re: documentation generation question | ||
| References: | 1 | Groups: | php.pear.general |
| Request: | Send a blank email to pear-general+get-4637@lists.php.net to get a copy of this message | ||
Oh, I'm noticing all my descriptions are missing (file descriptors, class descriptors, etc)
--Tony
On Thu, 3 Apr 2003, Demian Turner wrote:
> Greg/Joshua,
>
> wow - talk about upgrading from PHPDoc :-) Fantastic package, congratulations
> on what looks like a mountain of work.
>
> Install went smooth as silk, took about 2 seconds to get up and running on Windows.
>
> Couple of questions while I have your attention:
>
> - had the same problem as Tony, with empty output for Author/version/copyright -
> bug?
> - is there a simmple way to disable listing of Files for any given package?
> - any alternative stylesheets kicking around? Being able to widen the left
> contents div would be handy
>
> Other than that great work,
>
> cheers,
>
> Demian
>
> Greg Beaver wrote:
> > Hi Demian,
> >
> > Um, install phpDocumentor :)
> >
> > Seriously, the time it takes to install will be justified by the time
> > saved trying to work around the oddities of phpdoc.de's PHPDoc.
> > Installation involves unzipping the archive into any directory, and
> > running ./phpdoc. It's not really complicated. Of course, you could
> > also sync from anonymous cvs, as it is MUCH more stable and feature-full
> > than the 1.2.0beta3 release (we'll be doing a 1.2.0rc1 release in about
> > 2 weeks, when I have time to finish the docs and wrap up a few other
> > loose ends)
> >
> > Once you're installed, use @package tags in the inherited classes to
> > specify a different package.
> >
> >
> > http://www.phpdoc.org/docs/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.package.pkg.html
> >
> >
> >
> > Greg
> > --
> > phpDocumentor
> > http://www.phpdoc.org
> >
> > Demian Turner wrote:
> >
> >> Hi, I have a general question about document generation in PHP.
> >> Currently I'm using PHPdoc from
> >> http://www.phpdoc.de and am trying to
> >> sort my docs into packages to follow the class structure.
> >>
> >> I know I should be using PHPdocumentor, haven't had time to install it
> >> yet ;-) But following the logic PHPdoc uses, any class that inherits
> >> from a class belonging to package A becomes part of package A.
> >>
> >> This can't be right, and as I'm using a java-style Object base class,
> >> I cannot 'force' anything into separate packages.
> >>
> >> Anyone come up with a solution to this problem?
> >>
> >> cheers,
> >>
> >> Demian
> >>
> >
>
>
>
--
Tony Bibbs "I guess you have to remember that those who don't
tony@tonybibbs.com hunt or fish often see those of us who do as
harmlessly strange and sort of amusing. When you
think about it, that might be a fair assessment."
--Unknown