--- parser3/src/include/pa_exception.h	2001/03/11 08:16:32	1.7
+++ parser3/src/include/pa_exception.h	2001/03/19 17:42:12	1.11
@@ -1,9 +1,11 @@
-/*
-	Parser
+/** @file
+	Parser: exception decls.
+
 	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
+
 	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
 
-	$Id: pa_exception.h,v 1.7 2001/03/11 08:16:32 paf Exp $
+	$Id: pa_exception.h,v 1.11 2001/03/19 17:42:12 paf Exp $
 */
 
 #ifndef PA_EXCEPTION_H
@@ -14,23 +16,31 @@
 #include "pa_types.h"
 #include "pa_string.h"
 
+/// Just simple longjump mechanizm dressed in class clothes. use Temp_exception
 class Exception {
 public:
 
-	// address for long jump to jump to 
-	// regretfully public:
-	//   can't make local unless sure of inlining
-	//   for to-die stack frame ruins it all
+	/**
+		address for long jump to jump to 
+		regretfully public:
+		can't make local unless sure of inlining
+		for to-die stack frame ruins it all
+	*/
 	mutable jmp_buf mark;
 
+	/// throws an exception[really goes to mark-ed position
 	void _throw(
 		const String *atype, const String *acode,
 		const String *aproblem_source, 
 		const char *comment_fmt, ...) const;
 
+	/// extracts exception type
 	const String *type() const { return ftype; }
+	/// extracts exception code
 	const String *code() const { return fcode; }
+	/// extracts exception problem_source
 	const String *problem_source() const { return fproblem_source; }
+	/// extracts exception comment
 	const char *comment() const { return fcomment[0]?fcomment:0; }
 
 private:
@@ -39,8 +49,4 @@ private:
 	mutable char fcomment[MAX_STRING];
 };
 
-//#define EXCEPTION_TRY(e) (setjmp((e).mark)==0)
-// usage:
-//   if(EXCEPTION_TRY(e)) { ...; if(?) e.raise(?); ...; } else { catch-code }
-
 #endif