Author: ilor
Date: Mon Sep 22 22:28:52 2008
New Revision: 29650

URL: http://svn.gna.org/viewcvs/wesnoth?rev=29650&view=rev
Log:
editor2 action doc comment

Modified:
    trunk/src/editor2/action.hpp

Modified: trunk/src/editor2/action.hpp
URL: 
http://svn.gna.org/viewcvs/wesnoth/trunk/src/editor2/action.hpp?rev=29650&r1=29649&r2=29650&view=diff
==============================================================================
--- trunk/src/editor2/action.hpp (original)
+++ trunk/src/editor2/action.hpp Mon Sep 22 22:28:52 2008
@@ -14,7 +14,13 @@
 
 /**
  * @file action.hpp
- * Editor action classes
+ * Editor action classes. Some important points:
+ * - This is a polymorphic hierarchy of classes, so actions are usually passed 
around
+ *   as editor_action pointers
+ * - The pointers can, in general, be null. Always check for null before doing 
anything.
+ *   The helper functions perform_ that take a pointer do that.
+ * - The perform() functions can throw when an error occurs. Use smart 
pointers if you
+ *   need to ensure the pointer is deleted.
  */
 
 #ifndef EDITOR2_ACTION_HPP


_______________________________________________
Wesnoth-commits mailing list
[email protected]
https://mail.gna.org/listinfo/wesnoth-commits

Reply via email to