cvs: /pearweb/public_html/doc pear.xml

ssb Mon Feb 28 08:19:17 2000 EDT Modified files: /pearweb/public_html/doc pear.xml Log: add a note about errors Index: pearweb/public_html/doc/pear.xml diff -u pearweb/public_html/doc/pear.xml:1.3 pearweb/public_html/doc/pear.xml:1.4 --- pearweb/public_html/doc/pear.xml:1.3 Sun Feb 27 21:36:08 2000 +++ pearweb/public_html/doc/pear.xml Mon Feb 28 08:18:47 2000 @@ -12,8 +12,8 @@ </authorgroup> <revhistory> <revision> - <revnumber>$Revision: 1.3 $</revnumber> - <date>$Date: 2000/02/28 05:36:08 $</date> + <revnumber>$Revision: 1.4 $</revnumber> + <date>$Date: 2000/02/28 16:18:47 $</date> <authorinitials>$Author: ssb $</authorinitials> </revision> </revhistory> @@ -124,6 +124,19 @@ </section> </section> + <section id="pear-errors"> + <title>Returning Errors</title> + <simpara> + Your code should <emphasis>never</emphasis> use + <function>exit</function> or <function>die</function> if it + encounters an error. This would make developers using your code + unable to catch these errors, handle them or even display their + own error message. As far as possible, use some way of giving + errors back to the caller, even if it is just a boolean return + value. + </simpara> + </section> + <section id="pear-options"> <title>Depending on Optional Features</title> <simpara> @@ -228,7 +241,8 @@ <!-- Keep this comment at the end of the file Local variables: mode:sgml -sgml-omittag:t +sgml-set-face:t +sgml-omittag:nil sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t