more doxygen docs

include/FLAC++/all.h

@@ -30,6 +30,10 @@
  * that encapsulate the encoders, decoders, and metadata interfaces
  * in libFLAC.
  *
+ * Note that Doxygen currently has some quirks (bugs?) in the way
+ * it deals with some member groups and C++ constructs.  You will find
+ * some document entries in the wrong place under [NOHEADER] sections.
+ * Hopefully this is not too annoying.
  */
 
 #endif

include/FLAC++/decoder.h

@@ -57,10 +57,10 @@ namespace FLAC {
 		// ============================================================
 		//
 		//  The only real difference here is that instead of passing
-		//  in C function pointers for callbacks, you inherit from
+		//  in C function pointers for callbacks, you inherit from the
-		//  stream and provide implementations for the callbacks in
+		//  decoder class and provide implementations for the callbacks
-		//  the derived class; because of this there is no need for a
+		//  in the derived class; because of this there is no need for
-		//  'client_data' property.
+		//  a 'client_data' property.
 		//
 		// ============================================================
 

include/FLAC++/encoder.h

@@ -62,10 +62,10 @@ namespace FLAC {
 		//  ----------------------------------------------------------
 		//
 		//  The only real difference here is that instead of passing
-		//  in C function pointers for callbacks, you inherit from
+		//  in C function pointers for callbacks, you inherit from the
-		//  stream and provide implementations for the callbacks in
+		//  encoder class and provide implementations for the callbacks
-		//  the derived class; because of this there is no need for a
+		//  in the derived class; because of this there is no need for
-		//  'client_data' property.
+		//  a 'client_data' property.
 		//
 		// ============================================================