# HG changeset patch
# User John W. Eaton <jwe@octave.org>
# Date 1284446305 14400
# Node ID c6dc5f6666955e09df9d9bb4300e4a3db3011a28
# Parent  a8235d26b57a5ca72b17b03178683ce6dc2eaa94
update comments for base_graphics_backend methods

diff --git a/src/graphics.h.in b/src/graphics.h.in
--- a/src/graphics.h.in
+++ b/src/graphics.h.in
@@ -1671,19 +1671,25 @@
       return Matrix (1, 2, 0.0);
     }
 
-  // Called when graphics object using this backend changes it's property.
+  // Callback function executed when the given graphics object
+  // changes.  This allows the grahpics backend to act on property
+  // changes if needed.
   virtual void update (const graphics_object&, int)
     { gripe_invalid ("base_graphics_backend::update"); }
 
   void update (const graphics_handle&, int);
   
-  // Called when new object using this backend is created.
+  // Callback function executed when the given graphics object is
+  // created.  This allows the graphics backend to do backend-specific
+  // initializations for a newly created object.
   virtual void initialize (const graphics_object&)
     { gripe_invalid ("base_graphics_backend::initialize"); }
 
   void initialize (const graphics_handle&);
 
-  // Called when object using this backend is destroyed.
+  // Callback function executed just prior to deleting the given
+  // graphics object.  This allows the graphics backend to perform
+  // backend-specific cleanup operations before an object is deleted.
   virtual void finalize (const graphics_object&)
     { gripe_invalid ("base_graphics_backend::finalize"); }