CXX-38 make the documentation better

- Create a docs folder for future use and for placing doxygen output
- Take ownership of the doxygenConfig and tweak some settings
- Document the mongo and mongo::client namespaces so functions inside of
  them are documented

Author: TylerBrock

docs/.gitkeep

@@ -2,8 +2,8 @@
 # Project related configuration options
 #---------------------------------------------------------------------------
 DOXYFILE_ENCODING      = UTF-8
-PROJECT_NAME           = MongoDB
-PROJECT_NUMBER         = 2.6.0-rc0
+PROJECT_NAME           = MongoDB C++ Driver
+PROJECT_NUMBER         = 0.0
 OUTPUT_DIRECTORY       = docs/doxygen
 CREATE_SUBDIRS         = NO
 OUTPUT_LANGUAGE        = English
@@ -31,7 +31,7 @@ QT_AUTOBRIEF           = NO
 MULTILINE_CPP_IS_BRIEF = NO
 INHERIT_DOCS           = YES
 SEPARATE_MEMBER_PAGES  = NO
-TAB_SIZE               = 8
+TAB_SIZE               = 4
 ALIASES                =
 OPTIMIZE_OUTPUT_FOR_C  = NO
 OPTIMIZE_OUTPUT_JAVA   = NO
@@ -51,9 +51,6 @@ SYMBOL_CACHE_SIZE      = 0
 # Build related configuration options
 #---------------------------------------------------------------------------
 
-# ***
-# ERH - this controls whether all classes in files are documented or just the ones with tags
-# ***
 EXTRACT_ALL            = NO
 
 EXTRACT_PRIVATE        = NO
@@ -313,4 +310,4 @@ DOT_CLEANUP            = YES
 #---------------------------------------------------------------------------
 # Options related to the search engine
 #---------------------------------------------------------------------------
-SEARCHENGINE           = NO
+SEARCHENGINE           = YES

doxygenConfig

@@ -1,3 +1,5 @@
+// @file init.h
+
 /* Copyright 2013 10gen Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +24,16 @@
 // library. The below functions are not defined in servers like mongos or mongod, which have
 // their own initialization strategy.
 
+/**
+ * @namespace mongo
+ * @brief the main MongoDB namespace
+ */
 namespace mongo {
+
+/**
+ * @namespace mongo::client
+ * @brief the MongoDB C++ driver namespace
+ */
 namespace client {
 
     const int kDefaultShutdownGracePeriodMillis = 250;