8ba9695dd0a51b772a5a0f826027f313d7c3d21a
angie
  Fri Jan 23 14:21:11 2015 -0800
Added header comments as suggested by Kate.  refs #14698
diff --git src/hg/hgChooseDb/hgChooseDb.c src/hg/hgChooseDb/hgChooseDb.c
index ef21448..7a02450 100644
--- src/hg/hgChooseDb/hgChooseDb.c
+++ src/hg/hgChooseDb/hgChooseDb.c
@@ -1,16 +1,26 @@
-/* hgChooseDb - auto-complete db/organism search */
+/* hgChooseDb - bootstrapper / back end for demo app: auto-complete db/organism search
+ * This CGI has three modes of operation:
+ *  - HTML output for minimal main page with a <div> container to be filled in by javascript
+ *    (default, in the absence of special CGI params)
+ *  - cart-based JSON responses to ajax requests from javascript (using hg/lib/cartJson.c)
+ *    (if CGI param CARTJSON_COMMAND exists)
+ *  - no cart; fast JSON responses to species-search autocomplete requests
+ *    (if CGI param SEARCH_TERM exists)
+ * The UI view top level is in ../js/react/hgChooseDb/hgChooseDb.jsx
+ * The UI model top level is in ../js/model/hgChooseDb/hgChooseDbModel.js
+ */
 #include "common.h"
 #include "cart.h"
 #include "cartJson.h"
 #include "cheapcgi.h"
 #include "hCommon.h"
 #include "hdb.h"
 #include "hui.h"
 #include "jsonParse.h"
 #include "obscure.h"  // for readInGulp
 #include "trackHub.h"
 #include "web.h"
 
 /* Global Variables */
 struct cart *cart = NULL;             /* CGI and other variables */