Re: faqfiles [refentry is not so good]

on 10/07/01 12:42, derick@php.net at derick@php.net wrote: > Hello, Hi Derick! > as far as I know DocBook supports Q&A sections, see: > !™y¯ > L ‡inG³jÍhttp://www.oreilly.com/catalog/docbook/chapter/book/qandaset.html That is too easy : you read the docs =D OK, this sound MUCH better to me. Here is an updated version. Goba : can you test this on your Jade? Damien Seguy

Attachment: [application/applefile] general.xml
<reference id="faq.general"> <title>General Information</title> <titleabbrev>General Information about PHP</titleabbrev> <partintro> <para> This section holds the most general questions about PHP: what it is and what it does. </para> </partintro> <qandaset> <qandaentry id="faq.general.what"> <question> <para>What is PHP?</para> </question> <answer> <para> From the <ulink url="&faqurl.php.manual;">manual</ulink>: </para> <para> PHP is an HTML-embedded scripting language. Much of its syntax is borrowed from C, Java and Perl with a couple of unique PHP-specific features thrown in. The goal of the language is to allow web developers to write dynamically generated pages quickly. </para> <para> A nice introduction to PHP by Stig S&aelig;ther Bakken can be found <ulink url="&faqurl.zend.introduction;">here</ulink> on the Zend website. </para> </answer> </qandaentry> <qandaentry id="faq.general.relation-versions"> <question> <para> What is the relation between the versions ?</para> </question> <answer> <para> PHP/FI 2.0 is an early and no longer supported version of PHP. PHP 3 is the successor to PHP/FI 2.0 and is a lot nicer. PHP 4 is the latest generation of PHP, which uses the <ulink url="&faqurl.zend;">Zend engine</ulink> under the hood. </para> </answer> </qandaentry> <qandaentry id="faq.general.running-concurent"> <question> <para>Can I run several versions of PHP at the same time?</para> </question> <answer> <para> Yes. See the <filename>INSTALL</filename> file that is included in the PHP 4 source distribution. </para> </answer> </qandaentry> <qandaentry id="faq.general.differences-34"> <question> <para>What are the differences between PHP 3 and PHP 4?</para> </question> <answer> <para> There are <ulink url="&faqurl.zend.articles;">a couple of articles</ulink> written on this by the authors of PHP4. Here's a list of some of the more important new features: <itemizedlist> <listitem> <simpara>Extended API module.</simpara> </listitem> <listitem> <simpara>Generalized build process under UNIX</simpara> </listitem> <listitem> <simpara>Generic web server interface that also supports multi-threaded web servers</simpara> </listitem> <listitem> <simpara>Improved syntax highlighter</simpara> </listitem> <listitem> <simpara>Native HTTP session support</simpara> </listitem> <listitem> <simpara>Output buffering support</simpara> </listitem> <listitem> <simpara>More powerful configuration system</simpara> </listitem> <listitem> <simpara>Reference counting</simpara> </listitem> </itemizedlist> Please see the <ulink url="&faqurl.zend.new;">What's new in PHP4 overview</ulink> for a detailed explanation of these features and more. </para> </answer> </qandaentry> </qandaset> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->