Upgrade to talk about current XSL based manual

Remove link to books.php (doesn't exist anymore)


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@229174 c90b9560-bf6c-de11-be94-00142212c4b1

appendices/about.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.47 $ -->
+<!-- $Revision: 1.48 $ -->
 
 <appendix id="about">
  <title>About the manual</title>
@@ -20,9 +20,8 @@
   <para>
    The manual can be read online at the <ulink url="&url.php;">PHP.net website</ulink>,
    and on the numerous mirror sites. For best performance, choose
-   the closest mirror. The HTML version of the PHP manual is in either plain
-   (print-friendly) HTML format or an HTML format that integrates the manual
-   into the look and feel of the PHP website itself.
+   the closest mirror. The online version of the PHP manual has currently two
+   <acronym>CSS</acronym> stylesheets, web friendly and a printer-friendly stylesheet.
   </para>
   <para>
    Two notable advantages of the online manual over most of the offline formats is the
@@ -142,9 +141,9 @@ strlen
 strlen -- Get string length
 
 Description
-int strlen ( string str )
+int strlen ( string $string )
 
-Returns the length of string.
+Returns the length of given string.
 ]]>
     </screen>
    </para>
@@ -187,11 +186,11 @@ Returns the length of string.
         </row>
         <row>
          <entry>
-          ( string str )
+          ( string $string )
          </entry>
          <entry>
           The first (and in this case the only) parameter/argument for this 
-          function is named <parameter>str</parameter>, and it's a 
+          function is named <parameter>string</parameter>, and it's a 
           <type>string</type>.
          </entry>
         </row>
@@ -216,7 +215,7 @@ Returns the length of string.
     <para>
      <screen>    
 <![CDATA[
-      bool in_array ( mixed needle, array haystack [, bool strict])
+      bool in_array ( mixed $needle, array $haystack [, bool $strict])
 ]]>
      </screen>
     </para>
@@ -305,8 +304,7 @@ Returns the length of string.
    programming practices. First-time - or even just beginning -
    programmers may find it difficult to learn how to program in PHP using
    this manual exclusively. Instead, seek out a text more oriented towards
-   beginners. Or a book, see also a list of PHP-related books at <ulink
-   url="&url.php.books;">&url.php.books;</ulink>.
+   beginners.
   </para>
   <para>
    There are a number of active mailing lists for discussion on all aspects of
@@ -363,18 +361,17 @@ Returns the length of string.
   <para>
    This manual is written in <acronym>XML</acronym> using the <ulink
    url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <ulink
-   url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
-   Style and Semantics Specification Language) for formatting, and
-   experimentally the <ulink url="&url.xslt;"><acronym>XSLT</acronym></ulink> 
-   (Extensible Stylesheet Language Transformations)
-   for maintenance and formatting.
+   url="&url.xslt;"><acronym>XSLT</acronym></ulink> (Extensible
+   Stylesheet Language Transformations) for maintenance and formatting.
   </para>
   <para>
    Using <acronym>XML</acronym> as a source format gives 
    the ability to generate many output formats from the source
    files, while only maintaining one source document for all formats.
-   The tools used for formatting <acronym>HTML</acronym> and
-   <acronym>TeX</acronym> versions are
+   The tools used for formatting the online manual are <ulink
+    url="&url.xsltproc;">xsltproc</ulink> and <ulink
+    url="&url.dbxsl;">DocBook XSL Stylesheets</ulink>.
+   The <acronym>HTML</acronym> and <acronym>TeX</acronym> versions use
    <ulink url="&url.jade;">Jade</ulink>, written by <ulink
    url="&url.jclark;">James Clark</ulink>; and <ulink
    url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>,