Re: class.classId.html files aren't rendered
| From: | Hannes Magnusson | Date: | Fri, 25 Feb 2011 10:05:13 +0000 |
| Subject: | Re: class.classId.html files aren't rendered | ||
| References: | 1 2 3 4 5 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969382556@lists.php.net to get a copy of this message | ||
On 24/02/2011, Miroslav Kubelík <koubel@seznam.cz> wrote:
> On Thu, 24 Feb 2011 15:42:26 +0100, Moacir de Oliveira
> <moacirdeoliveira.eng@gmail.com> wrote:
>
>>
>> $phd -d ~/phpdocs/doc-base/.manual.xml -p book.rrd -o /var/www/phprrd/
>> -f
>> xhtml -t chunkedhtml
>>
>> -t chunkedhtml is a deprecated option that is not used by PhD anymore.
>>
>> When you don't pass the -P (--package) option PhD will use the Generic
>> Package which doesn't support 'phpdoc:classref', so the class references
>> will not be created.
>>
>> If you are rendering the PHP Manual you must use the -P PHP
>
> Ok, I understand, but I think if 'phpdoc:classref' isn't supported in
> Generic package,
> any links (<a href...>) for classref documentation musn't be rendered for
> final xhtml output. Nowadays <a href...> for each class is rendered, but
> no class manual exist. It isn't good behavior and makes end user little
> bit confused.
Yeah, good point.
At the very least we should throw out a warning of the fact the
package doesn't understand the element.
Please file a bugreport about that :)
- And you already do have phpdoc karma.. :)
-Hannes