Use @file to tell doxygen to document globals, add more doc for BSON() and QUERY()

Author: astaple

client/connpool.h

@@ -1,4 +1,4 @@
-/* connpool.h */
+/** @file connpool.h */
 
 /**
 *    Copyright (C) 2008 10gen Inc.

client/dbclient.h

@@ -1,4 +1,4 @@
-// dbclient.h - connect to a Mongo database as a database, from C++
+/** @file dbclient.h - connect to a Mongo database as a database, from C++ */
 
 /**
 *    Copyright (C) 2008 10gen Inc.
@@ -75,7 +75,7 @@ namespace mongo {
     };
 #pragma pack()
 
-    /** Represents a query.  Typically one uses the QUERY(...) macro to construct a query object. 
+    /** Represents a query.  Typically one uses the QUERY(...) macro to construct a Query object. 
         Example:
            QUERY( "age" << 33 << "school" << "UCLA" ).sort("name")
     */    
@@ -135,6 +135,9 @@ namespace mongo {
         Query& where(const char *jscode) { return where(jscode, BSONObj()); }
     };
 
+/** Typically one uses the QUERY(...) macro to construct a Query object.
+    Example: QUERY( "age" << 33 << "school" << "UCLA" )
+*/
 #define QUERY(x) Query( BSON(x) )
 
     /**

client/gridfs.h

@@ -1,4 +1,4 @@
-// gridfs.h
+/** @file gridfs.h */
 
 #pragma once
 

client/model.h

@@ -1,4 +1,4 @@
-// model.h
+/** @file model.h */
 
 /**
 *    Copyright (C) 2008 10gen Inc.

db/jsobj.h

@@ -1,4 +1,4 @@
-/* jsobj.h */
+/** @file jsobj.h */
 
 /**
    BSONObj and its helpers
@@ -732,6 +732,11 @@ namespace mongo {
 /** Use BSON macro to build a BSONObj from a stream 
     e.g., 
        BSON( "name" << "joe" << "age" << 33 )
+ 
+    The labels GT, GTE, LT, LTE, NE can be helpful for stream-oriented construction
+    of a BSONObj, particularly when assembling a Query.  For example,
+    BSON( "a" << GT << 23.4 << NE << 3 << "b" << 2 ) produces the object
+    { a: { \$gt: 23.4, \$ne: 3 }, b: 2 }.
 */
 #define BSON(x) (( BSONObjBuilder() << x ).obj())
 

db/json.h

@@ -1,4 +1,4 @@
-// json.h
+/** @file json.h */
 
 /**
 *    Copyright (C) 2008 10gen Inc.