cvs: peardoc /en/package/html/html-css api.xml errorhandler.xml whatsnew.xml
[email protected] ("Laurent Laville")
| Newsgroups | php.pear.doc |
|---|---|
| Message-ID | <cvsfarell1198404070@cvsserver> |
farell Sun Dec 23 10:01:10 2007 UTC
Modified files:
/peardoc/en/package/html/html-css api.xml errorhandler.xml
whatsnew.xml
Log:
fixed serious errors that break generation of HTML_CSS part manual
farell-20071223100110.txt
(text/plain, 13.4 KB)
http://cvs.php.net/viewvc.cgi/peardoc/en/package/html/html-css/api.xml?r1=1.1&r2=1.2&diff_format=u
Index: peardoc/en/package/html/html-css/api.xml
diff -u peardoc/en/package/html/html-css/api.xml:1.1 peardoc/en/package/html/html-css/api.xml:1.2
--- peardoc/en/package/html/html-css/api.xml:1.1 Sat Dec 22 15:35:56 2007
+++ peardoc/en/package/html/html-css/api.xml Sun Dec 23 10:01:10 2007
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<refentry id="package.html.html-css.api">
<refnamediv>
<refname>API</refname>
@@ -10,40 +10,62 @@
<para>
With the class constructor, you have ability to set many options :
<itemizedlist>
- <listitem><emphasis role="bold">xhtml</emphasis> option
- defines whether element selectors should be automatically lowercased.
- See also: <methodname>HTML_CSS::setXhtmlCompliance()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">tab</emphasis> option
- defines the string used to indent CSS text.
- See also: <methodname>HTML_CSS::setTab()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">filename</emphasis> option
- allow to parse an external css file.
- See also: <methodname>HTML_CSS::parseFile()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">cache</emphasis> option
- controls caching of the page.
- See also: <methodname>HTML_CSS::setCache()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">oneline</emphasis> option
- defines whether to output all properties on one line.
- See also: <methodname>HTML_CSS::setSingleLineOutput()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">groupsfirst</emphasis> option
- determines whether to output groups before elements.
- See also: <methodname>HTML_CSS::setOutputGroupsFirst()</methodname>.
- </listitem>
- <listitem><emphasis role="bold">allowduplicates</emphasis> option
- allow to have duplicate rules in selector.
+ <listitem>
+ <para>
+ <emphasis role="bold">xhtml</emphasis> option
+ defines whether element selectors should be automatically lowercased.
+ See also: <methodname>HTML_CSS::setXhtmlCompliance()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">tab</emphasis> option
+ defines the string used to indent CSS text.
+ See also: <methodname>HTML_CSS::setTab()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">filename</emphasis> option
+ allow to parse an external css file.
+ See also: <methodname>HTML_CSS::parseFile()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">cache</emphasis> option
+ controls caching of the page.
+ See also: <methodname>HTML_CSS::setCache()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">oneline</emphasis> option
+ defines whether to output all properties on one line.
+ See also: <methodname>HTML_CSS::setSingleLineOutput()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">groupsfirst</emphasis> option
+ determines whether to output groups before elements.
+ See also: <methodname>HTML_CSS::setOutputGroupsFirst()</methodname>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">allowduplicates</emphasis> option
+ allow to have duplicate rules in selector.
+ </para>
</listitem>
</itemizedlist>
</para>
<para>
<tip>
- HTML_CSS 1.4.0+ users may now set a single option directly like that:
- <programlisting role="php">
- <![CDATA[
+ <para>
+ HTML_CSS 1.4.0+ users may now set a single option directly like that:
+ <programlisting role="php">
+ <![CDATA[
<?php
require_once 'HTML/CSS.php';
@@ -55,8 +77,9 @@
// with PHP4 use
$css->__set('allowduplicates', true);
?>
- ]]>
- </programlisting>
+ ]]>
+ </programlisting>
+ </para>
</tip>
</para>
&package.html.html-css.html-css.html-css;
@@ -120,7 +143,7 @@
Ability to find if a selector or a property (with perl-compatible pattern)
is already defined.
<important>
- This function is available since version 1.1.0
+ <simpara>This function is available since version 1.1.0</simpara>
</important>
</para>
&package.html.html-css.html-css.grepstyle;
http://cvs.php.net/viewvc.cgi/peardoc/en/package/html/html-css/errorhandler.xml?r1=1.1&r2=1.2&diff_format=u
Index: peardoc/en/package/html/html-css/errorhandler.xml
diff -u peardoc/en/package/html/html-css/errorhandler.xml:1.1 peardoc/en/package/html/html-css/errorhandler.xml:1.2
--- peardoc/en/package/html/html-css/errorhandler.xml:1.1 Sat Dec 22 15:35:56 2007
+++ peardoc/en/package/html/html-css/errorhandler.xml Sun Dec 23 10:01:10 2007
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<refentry id="package.html.html-css.errorhandler">
<refnamediv>
<refname>Error Handler</refname>
@@ -20,12 +20,13 @@
will raise a <classname>HTML_CSS_Error</classname> object that will
be return to call script (user script).
<tip>
- Easy to distinct basic PEAR_Error from other PEAR packages to HTML_CSS errors,
- even if there is a better and more robust solution:
- <methodname>HTML_CSS::isError()</methodname>.
- But also provide a unique way to retrieve the level of error
- (warning, error, exception) with the <methodname>HTML_CSS_Error::getLevel()
- </methodname> method.
+ <para>
+ Easy to distinct basic PEAR_Error from other PEAR packages to HTML_CSS errors,
+ even if there is a better and more robust solution:
+ <methodname>HTML_CSS::isError()</methodname>.
+ But also provide a unique way to retrieve the level of error (warning, error,
+ exception) with the <methodname>HTML_CSS_Error::getLevel()</methodname> method.
+ </para>
</tip>
</para>
@@ -78,18 +79,24 @@
Perhaps this standard behavior is not what you want. Don't worry, you can
change everything :
<itemizedlist>
- <listitem>display or ignore the error </listitem>
- <listitem>display or hide part of message (error level, body, context) </listitem>
+ <listitem>
+ <simpara>display or ignore the error</simpara>
+ </listitem>
+ <listitem>
+ <simpara>display or hide part of message (error level, body, context)</simpara>
+ </listitem>
</itemizedlist>
</para>
<para>
<important>
- HTML_CSS obey at
- <ulink url="&url.php;manual/en/ref.errorfunc.php#ini.display-errors">display_errors</ulink>
- and
- <ulink url="&url.php;manual/en/ref.errorfunc.php#ini.log-errors">log_errors</ulink>
- protocol
+ <para>
+ HTML_CSS obey at
+ <ulink url="&url.php;manual/en/ref.errorfunc.php#ini.display-errors">display_errors</ulink>
+ and
+ <ulink url="&url.php;manual/en/ref.errorfunc.php#ini.log-errors">log_errors</ulink>
+ protocol
+ </para>
</important>
</para>
</refsect1>
@@ -197,10 +204,11 @@
<para>
<tip>
- If you want to ignore all errors raised (no display, no logs) and avoid to
- include PEAR core class, then you should have something like :
- <programlisting role="php">
- <![CDATA[
+ <para>
+ If you want to ignore all errors raised (no display, no logs) and avoid to
+ include PEAR core class, then you should have something like :
+ <programlisting role="php">
+ <![CDATA[
<?php
require_once 'HTML/CSS.php';
@@ -213,17 +221,19 @@
$css = new HTML_CSS(null, $errorConf);
// ...
?>
- ]]>
- </programlisting>
+ ]]>
+ </programlisting>
+ </para>
</tip>
</para>
<para>
<note><title>Note for users of HTML_CSS 1.4.0 or greater</title>
- You may want to decide to print (yes/no), log (yes/no) error messages
- with a full free user function local to HTML_CSS
- <programlisting role="php">
- <![CDATA[
+ <para>
+ You may want to decide to print (yes/no), log (yes/no) error messages
+ with a full free user function local to HTML_CSS
+ <programlisting role="php">
+ <![CDATA[
<?php
require_once 'HTML/CSS.php';
@@ -236,12 +246,12 @@
$css = new HTML_CSS(null, $errorConf);
// ...
?>
- ]]>
- </programlisting>
- rather than using global PEAR error handler (PEAR::setErrorHandling,
- PEAR::pushErrorHandling, PEAR::popErrorHandling).
- <programlisting role="php">
- <![CDATA[
+ ]]>
+ </programlisting>
+ rather than using global PEAR error handler (PEAR::setErrorHandling,
+ PEAR::pushErrorHandling, PEAR::popErrorHandling).
+ <programlisting role="php">
+ <![CDATA[
<?php
require_once 'HTML/CSS.php';
@@ -255,8 +265,9 @@
$css = new HTML_CSS();
// ...
?>
- ]]>
- </programlisting>
+ ]]>
+ </programlisting>
+ </para>
</note>
</para>
@@ -451,9 +462,9 @@
<entry><b>%1$s</b>: %2$s %3$s</entry>
<entry>Log line format specification:
<itemizedlist>
- <listitem>1$ = error level</listitem>
- <listitem>2$ = error message (body)</listitem>
- <listitem>3$ = error context</listitem>
+ <listitem><simpara>1$ = error level</simpara></listitem>
+ <listitem><simpara>2$ = error message (body)</simpara></listitem>
+ <listitem><simpara>3$ = error context</simpara></listitem>
</itemizedlist>
</entry>
</row>
@@ -465,9 +476,9 @@
</entry>
<entry>Context format (class, file, line) specification:
<itemizedlist>
- <listitem>1$ = script file name </listitem>
- <listitem>2$ = line in script file </listitem>
- <listitem>3$ = class/method names </listitem>
+ <listitem><simpara>1$ = script file name</simpara></listitem>
+ <listitem><simpara>2$ = line in script file</simpara></listitem>
+ <listitem><simpara>3$ = class/method names</simpara></listitem>
</itemizedlist>
</entry>
</row>
@@ -475,9 +486,11 @@
</tgroup>
</table>
<tip>
- If you don't wish to see context information in the error message, then
- remove the parameter %3$ in the <emphasis>lineFormat</emphasis> option
- even if <emphasis>contextFormat</emphasis> is set.
+ <para>
+ If you don't wish to see context information in the error message, then
+ remove the parameter %3$ in the <emphasis>lineFormat</emphasis> option
+ even if <emphasis>contextFormat</emphasis> is set.
+ </para>
</tip>
</para>
@@ -522,11 +535,11 @@
<entry>%1$s %2$s [%3$s] %4$s %5$s </entry>
<entry>Log line format specification:
<itemizedlist>
- <listitem>$1 = time error</listitem>
- <listitem>2$ = ident (client ip)</listitem>
- <listitem>3$ = error level </listitem>
- <listitem>4$ = error message (body) </listitem>
- <listitem>5$ = error context </listitem>
+ <listitem><simpara>$1 = time error</simpara></listitem>
+ <listitem><simpara>2$ = ident (client ip)</simpara></listitem>
+ <listitem><simpara>3$ = error level</simpara></listitem>
+ <listitem><simpara>4$ = error message (body)</simpara></listitem>
+ <listitem><simpara>5$ = error context</simpara></listitem>
</itemizedlist>
</entry>
</row>
@@ -536,9 +549,9 @@
<entry>in %3$s (file %1$s on line %2$s) </entry>
<entry>Context format (class, file, line) specification:
<itemizedlist>
- <listitem>1$ = script file name </listitem>
- <listitem>2$ = line in script file </listitem>
- <listitem>3$ = class/method names </listitem>
+ <listitem><simpara>1$ = script file name</simpara></listitem>
+ <listitem><simpara>2$ = line in script file</simpara></listitem>
+ <listitem><simpara>3$ = class/method names</simpara></listitem>
</itemizedlist>
</entry>
</row>
@@ -582,9 +595,11 @@
</tgroup>
</table>
<tip>
- If you don't wish to see context information in the error message, then
- remove the parameter %5$ in the <emphasis>lineFormat</emphasis> option
- even if <emphasis>contextFormat</emphasis> is set.
+ <para>
+ If you don't wish to see context information in the error message, then
+ remove the parameter %5$ in the <emphasis>lineFormat</emphasis> option
+ even if <emphasis>contextFormat</emphasis> is set.
+ </para>
</tip>
</para>
</refsect1>
http://cvs.php.net/viewvc.cgi/peardoc/en/package/html/html-css/whatsnew.xml?r1=1.1&r2=1.2&diff_format=u
Index: peardoc/en/package/html/html-css/whatsnew.xml
diff -u peardoc/en/package/html/html-css/whatsnew.xml:1.1 peardoc/en/package/html/html-css/whatsnew.xml:1.2
--- peardoc/en/package/html/html-css/whatsnew.xml:1.1 Sat Dec 22 15:35:56 2007
+++ peardoc/en/package/html/html-css/whatsnew.xml Sun Dec 23 10:01:10 2007
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<refentry id="package.html.html-css.whatsnew">
<refnamediv>
<refname>News</refname>
@@ -128,7 +128,7 @@
<listitem>
<para><emphasis role="bold">Manual license upgrades</emphasis> from
version 2.0 to 3.0 of
- <ulink url="&url.license.cc;">Creative Commons</ulink>
+ <ulink url="&url.license.cc;by/3.0/">Creative Commons</ulink>
</para>
</listitem>
</itemizedlist>