no message

git-svn-id: https://svn.grrrr.org/ext/trunk@253 4d9ac71a-51e6-0310-8455-cad1006bcd31

source/flbase.cpp

@@ -8,7 +8,11 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
-// This is all derived from GEM by Mark Danks
+/*! \file flbase.cpp
+    \brief Implementation of the internal flext base classes.
+
+	\remark This is all derived from GEM by Mark Danks
+*/
  
 #include "flbase.h"
 #include "flinternal.h"

source/flbuf.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file flbuf.cpp
+    \brief Implementation of the buffer abstraction class.
+*/
+ 
 #include "flext.h"
 
 #ifdef MAXMSP

source/flclass.h

@@ -188,7 +188,9 @@ public:
 	
 //	void AddInDef() { AddInlet(xlet::tp_def,1); }
 
-	//! Add inlet(s) for anythings
+	/*! \brief Add inlet(s) for anythings
+		That's the one to choose for the left-most (first) inlet unless it's a signal inlet.
+	*/
 	void AddInAnything(int m = 1) { AddInlet(xlet::tp_any,m); } // leftmost or via proxy
 	void AddInAnything(const char *desc,int m = 1) { AddInlet(xlet::tp_any,m,desc); } // leftmost or via proxy
 	//! Add inlet(s) for floats
@@ -613,7 +615,7 @@ public:
 		//! Set anything
 		AtomAnything &operator()(const t_symbol *h = NULL,int argc = 0,const t_atom *argv = NULL)
 		{ 
-			hdr = h; AtomList::operator(argc,argv);	
+			hdr = h; AtomList::operator()(argc,argv);	
 			return *this; 
 		}
 

source/fldoxygen.h

 #ifndef __FLEXT_DOXYGEN_H
 #define __FLEXT_DOXYGEN_H
 
+/*! \file fldoxygen.h
+	\brief Doxygen definitions
+	\remark There is no code in here, just documentation stuff.
+*/
+
 /*! \mainpage flext - C++ layer for cross-platform development of PD and Max/MSP objects
 
 	\section intro Introduction

source/fldsp.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file fldsp.cpp
+    \brief Implementation of the flext dsp base class.
+*/
+ 
 #include "flext.h"
 #include "flinternal.h"
 #include <string.h>

source/flext.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file flext.cpp
+    \brief Implementation of the flext base class.
+*/
+ 
 #include "flext.h"
 #include "flinternal.h"
 #include <string.h>

source/flinternal.h

@@ -10,6 +10,7 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 /*! \file flinternal.h
     \brief Definitions for internal flext usage
+	\internal
     
     Here, a few shortcuts for common MaxMSP or PD library calls and type definitions 
 	are declared

source/flmspbuffer.h

@@ -8,8 +8,13 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
-// this file comes from David Zicarellis inofficial package index.sit
-// The latter is not easily found so i included the original file buffer.h with flext
+/*! \file flmspbuffer.h
+    \brief Definition of the Max/MSP buffer structure
+	\internal
+    
+	This file comes from David Zicarellis inofficial package index.sit
+	The latter is not easily found so i included the original file buffer.h with flext
+*/
 
 #if defined(MAXMSP) && !defined(__FLEXT_MSPBUFFER_H)
 #define __FLEXT_MSPBUFFER_H

source/flsetup.cpp

@@ -9,15 +9,14 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 */
 
 /*! \file flsetup.cpp
-    \brief Helper functions for object setup
-    
-    !Lacking Details.!
+    \brief Implementation of helper functions for object setup.
 */
 
 #include "flext.h"
 #include <ctype.h>
 #include <string.h>
 
+//! C++ strcup function
 const char *fl_strdup(const char *t)
 {
 	if(!t) return NULL;
@@ -27,6 +26,7 @@ const char *fl_strdup(const char *t)
 	return r;
 }
 
+//! Extract space-delimited words from a string
 const char *fl_extract(const char *name,int ix)
 {
 	static char tmp[1024];
@@ -48,13 +48,8 @@ const char *fl_extract(const char *name,int ix)
 }
 
 
-/////////////////////////////////////////////////////////
-// check if tilde object's name ends with a tilde
-//
-/////////////////////////////////////////////////////////
-
-
 #ifdef _DEBUG
+//! Check if object's name ends with a tilde
 bool fl_chktilde(const char *objname)
 {
 //	int stplen = strlen(setupfun);

source/flthr.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file flthr.cpp
+    \brief Implementation of the flext thread functionality.
+*/
+ 
 #ifdef FLEXT_THREADS
 
 #include "flext.h"

source/flutil.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file flutil.cpp
+    \brief Implementation of the various utility functions.
+*/
+ 
 #include "flext.h"
 #include <string.h>
 

source/flxlet.cpp

@@ -8,6 +8,10 @@ WARRANTIES, see the file, "license.txt," in this distribution.
 
 */
 
+/*! \file flxlet.cpp
+    \brief Implementation of the variable inlet/outlet functionality.
+*/
+ 
 #include "flext.h"
 #include "flinternal.h"
 #include <string.h>
@@ -42,7 +46,7 @@ void flext_base::AddXlet(xlet::type tp,int mult,const char *desc,xlet *&root)
 
 void flext_base::DescXlet(int ix,const char *desc,xlet *&root)
 {
-	post("flext - sorry, not implemented");
+	post("%s - sorry, not implemented",thisName());
 }
 
 unsigned long flext_base::XletCode(xlet::type tp,...)