FAQ.xml
| From: | Damien Seguy | Date: | Tue, 10 Jul 2001 07:11:07 +0000 |
| Subject: | FAQ.xml | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969336048@lists.php.net to get a copy of this message | ||
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