bjori Tue Feb 6 18:47:10 2007 UTC
Modified files:
/phpdoc/en/appendices about.xml
Log:
Upgrade to talk about current XSL based manual
Remove link to books.php (doesn't exist anymore)
http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/about.xml?r1=1.47&r2=1.48&diff_format=u
Index: phpdoc/en/appendices/about.xml
diff -u phpdoc/en/appendices/about.xml:1.47 phpdoc/en/appendices/about.xml:1.48
--- phpdoc/en/appendices/about.xml:1.47 Sat Feb 3 23:19:56 2007
+++ phpdoc/en/appendices/about.xml Tue Feb 6 18:47:10 2007
@@ -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 -- 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 @@
</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 @@
<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 @@
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 @@
<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>,
