From 1fbe07c9e0a7674710c4ae8eaa380ba1cb94f9d2 Mon Sep 17 00:00:00 2001
From: Marcus Boerger <helly@php.net>
Date: Sun, 22 Feb 2004 18:50:47 +0000
Subject: [PATCH] Add some more obviously needed information

---
 Zend/ZEND_CHANGES | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/Zend/ZEND_CHANGES b/Zend/ZEND_CHANGES
index 78b0deb886..1b172eb91e 100644
--- a/Zend/ZEND_CHANGES
+++ b/Zend/ZEND_CHANGES
@@ -596,6 +596,32 @@ Changes in the Zend Engine 2.0
       If you derive your exception classes from this Exception base class
       your exceptions will be nicely shown in the builtin handler for 
       uncaught exceptions.
+      
+      Note: The method getMessage() is a final read only access method to 
+      the private proeprty message that is set in the constructor. If you
+      feel a need to overwrite the exception display then overload method
+      __toString() in your derived class or implement your own extneral 
+      exception display function to accomplish your desired formatting.
+      
+      Example:
+      
+      <?php
+      function display_exception(Exception $ex)
+      {
+          echo 'Exception: ' . $ex->getMessage() . 'with backtrace: <pre>';
+          echo $ex->getTrace();
+          echo '</pre>';
+      }
+      
+      try
+      {
+          // your code here
+      }
+      catch (Exception $ex)
+      {
+          display_exeption($ex);
+      }
+      ?>
 
     * Dereferencing objects returned from functions.
 
-- 
2.50.1