1 files changed, 31 insertions, 0 deletions

diff --git a/include/konforka/exception.h b/include/konforka/exception.h
index 5e0bf96..dbfe27c 100644
--- a/include/konforka/exception.h
+++ b/include/konforka/exception.h
@@ -1,92 +1,123 @@
 #ifndef __KONFORKA_EXCEPTION_H
 #define __KONFORKA_EXCEPTION_H
 
 #include <exception>
 #include <string>
 #include <list>
 
 /**
  * @file
  * @brief exception-related stuff.
  *
  * Basic exception-related declarations and definitions.
  */
 
 /**
  * @def CODEPOINT
  * the convenience definition of the parameters passed to the
  * konforka::code_point constructor.
  */
         #defineCODEPOINT __FILE__,__PRETTY_FUNCTION__,__LINE__
 /**
  * @def NOCODEPOINT
  * the convenience definition for the codepoint denoting no particular point in
  * code.
  */
 #define NOCODEPOINT "no information"
 
 /**
+ * @def KONFORKA_RETHROW
+ * the convenience definition for seeing the exception and rethrowing it further.
+ */
+#define KONFORKA_RETHROW catch(konforka::exception& e) { e.see(CODEPOINT); throw; }
+
+/**
+ * @def KONFORKA_E_ARGS
+ * the convenience definition for naming codepoint parameters
+ */
+#define KONFORKA_E_PARS const string& fi,const string& fu,int l,const string& w
+
+/**
+ * @def KONFORKA_E_CONS
+ * the convenience definition for passing parameters to constructor
+ */
+#define KONFORKA_E_CONS fi,fu,l,w
+
+/**
+ * @def KONFORKA_E_SUBCLASS
+ * the convenience definition for subclassing konforka exceptions
+ * @param base base class
+ * @param derived derived class
+ */
+#define KONFORKA_E_SUBCLASS(derived,base) \
+    class derived : public base { \
+        public: \
+                explicit derived(KONFORKA_E_PARS) \
+                : base(KONFORKA_E_CONS) { } \
+    }
+
+/**
  * @brief The main konforka namespace.
  */
 namespace konforka {
     using std::string;
     using std::list;
 
     /**
      * @brief Pinpoint the code context.
      *
      * Class, holding the point in code, for instance, where the exception
      * occured.
      */
     class code_point {
         public:
             /**
              * The string describing the point in code.
              */
             string where;
             /**
              * The file (as provided by __FILE__) if available.
              */
             string file;
             /**
              * The function name (as provided by __PRETTY_FUNCTION__) if
              * available.
              */
             string function;
             /**
              * The line number (as provided by __LINE__) if available.
              */
             int line;
 
             /**
              * Constructs the object, using only textual description of the
              * point in code (no file, function, line information).
              * @param w the description of the point in code.
              */
             code_point(const string& w);
             /**
              * Constructs the object, specifying the exact position in code.
              * @param fi source file name.
              * @param fu function name.
              * @param l the line number.
              */
             code_point(const string& fi,const string& fu,int l);
 
             /**
              * Extract the information on the point in code.
              * @return the reference to the character string.
              * @see where
              */
             const char *c_str() const throw();
 
             /**
              * Build the textual description from the broken down information on
              * the point in code.
              * @see where
              * @see file
              * @see function
              * @see line
              */
             void make_where();
     };