renamed Awk::uponDemise() to Awk::uponClosing and added Awk::uponClearing()

qse/include/qse/awk/Awk.hpp

@@ -968,11 +968,19 @@ public:
 	void close ();
 
 	///
-	/// The uponClose() function is called back after Awk::close() 
+	/// The uponClosing() function is called back after Awk::close() 
 	/// has cleared most of the internal data but before destroying 
-	/// the underlying awk object.
+	/// the underlying awk object. This maps to the close callback
+	/// of #qse_awk_ecb_t.
 	/// 
-	virtual void uponDemise () {}
+	virtual void uponClosing ();
+
+	///
+	/// The uponClearing() function is called back when Awk::close()
+	/// begins clearing internal data. This maps to the clear callback
+	/// of #qse_awk_ecb_t.
+	///
+	virtual void uponClearing ();
 
 	///
 	/// The parse() function parses the source code read from the input

qse/include/qse/awk/StdAwk.hpp

@@ -95,7 +95,7 @@ public:
 	int open ();
 	void close ();
 
-	void uponDemise ();
+	void uponClosing ();
 
 	Run* parse (Source& in, Source& out);
 

qse/include/qse/awk/awk.h

@@ -923,7 +923,9 @@ struct qse_awk_mod_sym_t
 
 /**
  * The qse_awk_ecb_close_t type defines the callback function
- * called when an awk object is closed.
+ * called when an awk object is closed. The qse_awk_close() function
+ * calls this callback function after having called qse_awk_clear()
+ * but before actual closing.
  */
 typedef void (*qse_awk_ecb_close_t) (
 	qse_awk_t* awk  /**< awk */
@@ -931,7 +933,8 @@ typedef void (*qse_awk_ecb_close_t) (
 
 /**
  * The qse_awk_ecb_clear_t type defines the callback function
- * called when an awk object is cleared.
+ * called when an awk object is cleared. The qse_awk_clear() function
+ * calls this calllback function before it performs actual clearing.
  */
 typedef void (*qse_awk_ecb_clear_t) (
 	qse_awk_t* awk  /**< awk */