Hi,
the new faq section didn't build yesterday, du to missing tag refname.
This is commited now, and should work fine now.
I've a question : how should I configure Jade for it to use the
"faqurls.ent" file? As now, it doesn't use it, and generates errors.
> RE: [PHP-DOC] RFC : [PHP-DOC] FAQ porting to the manual?Would this not be
> better suited by using <sect1>... <sect2> blocks instead of <refentry>
> blocks? Since <refnamediv> requires a <refname> tag, it doesn't quite work
> so well as it is currently in cvs. What do you guys think?
I went into the refentry tag, as it seemed to me that it fit much better
the short question/answer style :
Question will easily fit within the refpurpose tag, and make an easy
extracting (for indexing purpose, par exemple).
Answers will fit on the rest of the section.
IMHO, sect* fit better for long explanatory texts (such as the language
section).
Best regards,
Damien Seguy
