supython-coder
diff --git a/‎Doxyfile‎
Lines changed: 12 additions & 4 deletions b/‎Doxyfile‎
Lines changed: 12 additions & 4 deletions
diff --git a/‎cppcms/steal_buf.h‎
Lines changed: 46 additions & 1 deletion b/‎cppcms/steal_buf.h‎
Lines changed: 46 additions & 1 deletion
@@ -460,7 +460,14 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories 
 # with spaces.
 
-INPUT                  = cppcms doc booster/booster booster/booster/aio booster/booster/locale booster/booster/nowide noicu/cppcms
+INPUT                  = 	cppcms \
+				doc \
+				booster/booster \
+				booster/booster/aio \
+				booster/booster/locale \
+				booster/booster/nowide \
+				noicu/cppcms \
+				examples
 
 # If the value of the INPUT tag contains directories, you can use the 
 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
@@ -469,13 +476,14 @@ INPUT                  = cppcms doc booster/booster booster/booster/aio booster/
 # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx 
 # *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py
 
-FILE_PATTERNS          = 
+FILE_PATTERNS          = *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx \
+	*.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.doxy
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories 
 # should be searched for input files as well. Possible values are YES and NO. 
 # If left blank NO is used.
 
-RECURSIVE              = NO
+RECURSIVE              = YES
 
 # The EXCLUDE tag can be used to specify files and/or directories that should 
 # excluded from the INPUT source files. This way you can easily exclude a 
@@ -501,7 +509,7 @@ EXCLUDE_PATTERNS       =
 # directories that contain example code fragments that are included (see 
 # the \include command).
 
-EXAMPLE_PATH           = 
+EXAMPLE_PATH           = examples 
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the 
 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
 
@@ -120,27 +120,52 @@ namespace util {
 		char on_stack_[OnStackSize + 1];
 	};
 
-	
+
+	///
+	/// \brief This is a special buffer that allows to "steal" some chunk
+	/// of text from the output stream.
+	///
+	/// It does this by replacing stream's streambuf object with temporary 
+	/// stream buffer that records all data written to the stream and then
+	/// returns the original buffer upon call to release() member function
+	/// it steal_buffer destruction.
+	///
+	/// The \a Size parameter defines the default chunk of memory allocated
+	/// on the stack before heap is used.
+	///	
 	template<size_t Size = 128>
 	class steal_buffer : public stackbuf<Size> {
 	public:
+		///
+		/// Create the buffer and "Steal" the buffer from \a out
+		///
 		steal_buffer(std::ostream &out) 
 		{
 			stolen_ = 0;
 			stream_ = 0;
 			steal(out);
 		}
+		///
+		/// Create an empty buffer
+		///
 		steal_buffer() 
 		{
 			stolen_ = 0;
 			stream_ = 0;
 		}
+		///
+		/// Steal the buffer from \a out
+		///
 		void steal(std::ostream &out)
 		{
 			release();
 			stolen_ = out.rdbuf(this);
 			stream_ = &out;
 		}
+		///
+		/// Release the "stolen" buffer back, now the buffer contains all
+		/// the data that was recorded.
+		///
 		void release()
 		{
 			if(stream_ && stolen_) {
@@ -158,25 +183,45 @@ namespace util {
 		std::ostream *stream_;
 	};
 
+	///
+	/// This is a special ostream that uses stack in order
+	/// to receive the data and faster then std::stringstream for
+	/// small chunks.
+	///
 	template<size_t Size = 128>
 	class stackstream : public std::ostream {
 	public:
+		///
+		/// Create a new stackstream
+		///
 		stackstream() : std::ostream(0)
 		{
 			rbbuf(&buf_);
 		}
+		///
+		/// Get the pointer to the first character in the range
+		///
 		char *begin()
 		{
 			return buf_->begin();
 		}
+		///
+		/// Get the pointer to the one past last character in the range
+		///
 		char *end()
 		{
 			return buf_->end();
 		}
+		///
+		/// Get a NUL terminated recorded string
+		///
 		char *c_str()
 		{
 			return buf_.c_str();
 		}
+		///
+		/// Get a recorded string
+		///
 		std::string str()
 		{
 			return buf_.str();