Permalink
Browse files

Document and prep for 0.2.0 release. Ignore .tgz release files.

  • Loading branch information...
1 parent 5c0be93 commit 8178949e3f4e8d63f86d4c1b078559c86d16bf6c @saltybeagle saltybeagle committed May 23, 2010
Showing with 93 additions and 8 deletions.
  1. +1 −0 RELEASE-0.2.0
  2. +46 −4 package.xml
  3. +46 −4 package_compatible.xml
View
@@ -1,3 +1,4 @@
+- Covert namespace to PEAR2
- Removed getCause() as it just uses the built in getPrevious() that was added in PHP 5.3
- Removed getUniqueId as it's used anywhere
- Removed toHtml, toText and __toString (which only handled calling the former two).
View
@@ -37,18 +37,60 @@ class for the package.</description>
<email>hans@velum.net</email>
<active>no</active>
</developer>
- <date>2009-07-07</date>
- <time>22:57:54</time>
+ <date>2010-05-23</date>
+ <time>08:39:48</time>
<version>
- <release>0.1.0</release>
+ <release>0.2.0</release>
<api>0.1.0</api>
</version>
<stability>
<release>alpha</release>
<api>alpha</api>
</stability>
<license uri="http://www.opensource.org/licenses/bsd-license.php">New BSD License</license>
- <notes>Initial Release</notes>
+ <notes>- Covert namespace to PEAR2
+- Removed getCause() as it just uses the built in getPrevious() that was added in PHP 5.3
+- Removed getUniqueId as it's used anywhere
+- Removed toHtml, toText and __toString (which only handled calling the former two).
+ People should implement their owny decorator calls.
+- Removed the built in outputs of the observer functions. Those where the class constants
+ OBSERVER_PRINT, OBSERVER_TRIGGER, OBSERVER_DIE
+ This can be achieved by writing a custom callback function, using the appropriate printf(),
+ trigger_error and die() to achieve the same result.
+- Removed getErroClass and getErrorMethod as it can be easily gotten from getTrace/getTraceSafe first array element
+- Add the proper LICENSE file and move Exception.php to the NEW BSD license as the package.xml already defines
+- Removed __toString, toText and toHtml. For those wanting to get pretty outputs they can use this approach:
+
+ $causes = array();
+ $this-&gt;getCauseMessage($causes);
+ foreach ($causes as $i =&gt; $cause) {
+ var_dump($cause);
+ }
+
+ And combine that with getTraceSafe() or getTraceAsString() if needed.
+
+ Put all that in a function and use set_exception_handler('exceptionHandler'); or similar to process
+ all Exceptions.
+
+ Example code or see the removed code at http://svn.php.net/viewvc/pear2/Exception/trunk/src/Exception.php?r1=295348&amp;r2=295352 :
+
+ function exceptionHandler($e)
+ {
+ if ($e instanceof \PEAR2\Exception) {
+ $causes = array();
+ $e-&gt;getCauseMessage($causes);
+ $causeMsg = '';
+ foreach ($causes as $i =&gt; $cause) {
+ $causeMsg .= str_repeat(' ', $i) . $cause['class'] . ': '
+ . $cause['message'] . &quot;\n&quot;;
+ }
+ echo $causeMsg;
+ } else {
+ echo $e-&gt;getMessage(), &quot;\n&quot;;
+ }
+ }
+
+ set_exception_handler('exceptionHandler');</notes>
<contents>
<dir name="/">
<dir name="src" baseinstalldir="PEAR2">
@@ -37,18 +37,60 @@ class for the package.</description>
<email>hans@velum.net</email>
<active>no</active>
</developer>
- <date>2009-07-07</date>
- <time>22:57:54</time>
+ <date>2010-05-23</date>
+ <time>08:39:48</time>
<version>
- <release>0.1.0</release>
+ <release>0.2.0</release>
<api>0.1.0</api>
</version>
<stability>
<release>alpha</release>
<api>alpha</api>
</stability>
<license uri="http://www.opensource.org/licenses/bsd-license.php">New BSD License</license>
- <notes>Initial Release</notes>
+ <notes>- Covert namespace to PEAR2
+- Removed getCause() as it just uses the built in getPrevious() that was added in PHP 5.3
+- Removed getUniqueId as it's used anywhere
+- Removed toHtml, toText and __toString (which only handled calling the former two).
+ People should implement their owny decorator calls.
+- Removed the built in outputs of the observer functions. Those where the class constants
+ OBSERVER_PRINT, OBSERVER_TRIGGER, OBSERVER_DIE
+ This can be achieved by writing a custom callback function, using the appropriate printf(),
+ trigger_error and die() to achieve the same result.
+- Removed getErroClass and getErrorMethod as it can be easily gotten from getTrace/getTraceSafe first array element
+- Add the proper LICENSE file and move Exception.php to the NEW BSD license as the package.xml already defines
+- Removed __toString, toText and toHtml. For those wanting to get pretty outputs they can use this approach:
+
+ $causes = array();
+ $this-&gt;getCauseMessage($causes);
+ foreach ($causes as $i =&gt; $cause) {
+ var_dump($cause);
+ }
+
+ And combine that with getTraceSafe() or getTraceAsString() if needed.
+
+ Put all that in a function and use set_exception_handler('exceptionHandler'); or similar to process
+ all Exceptions.
+
+ Example code or see the removed code at http://svn.php.net/viewvc/pear2/Exception/trunk/src/Exception.php?r1=295348&amp;r2=295352 :
+
+ function exceptionHandler($e)
+ {
+ if ($e instanceof \PEAR2\Exception) {
+ $causes = array();
+ $e-&gt;getCauseMessage($causes);
+ $causeMsg = '';
+ foreach ($causes as $i =&gt; $cause) {
+ $causeMsg .= str_repeat(' ', $i) . $cause['class'] . ': '
+ . $cause['message'] . &quot;\n&quot;;
+ }
+ echo $causeMsg;
+ } else {
+ echo $e-&gt;getMessage(), &quot;\n&quot;;
+ }
+ }
+
+ set_exception_handler('exceptionHandler');</notes>
<contents>
<dir name="/">
<file role="php" name="php/PEAR2/Exception.php"/>

0 comments on commit 8178949

Please sign in to comment.