Re: Regarding the use of PhD and docgen for extensions.
| From: | Philip Olson | Date: | Mon, 18 Oct 2010 05:22:22 +0000 |
| Subject: | Re: Regarding the use of PhD and docgen for extensions. | ||
| References: | 1 2 3 | Groups: | php.pecl.dev |
| Request: | Send a blank email to pecl-dev+get-7777@lists.php.net to get a copy of this message | ||
On Oct 15, 2010, at 4:32 AM, Mark Skilbeck wrote:
> On Thu, 14 Oct 2010 11:36:07 -0700
> Philip Olson <philip@roshambo.org> wrote:
>
>> That generates the reflection based skeletons, and now the PHP
>> documentation needs to know about them. Check this out:
>>
>> - http://wiki.php.net/doc/howto/pecldocs
>>
>> It also mentions that you should be passing in --pecl to docgen.php
>> for PECL extensions, because it adds some PECL specific goodies. It
>> also briefly mentions the requirement to edit manual.xml.in but the
>> FAQ should help too:
>>
>> - http://wiki.php.net/doc/howto/faq
>>
>> In summary: You need to add the extension to doc-base/manual.xml.in
>> and then both configure.php and phd will look for it. And just in
>> case, your directory needs to live within en/reference/.
>>
>> Regards,
>> Philip
>
> Thanks, Philip.
>
> Now, does the docgen script and PhD play nicely with namespaces, or
> will I have to do some hacking?
Hacking will be required. Also, please file a documentation bug report about this.
Regards,
Philip