225a9ac365d237639420aed284a51c3c9607a4bb
braney
  Fri Jul 31 10:32:44 2026 -0700
ex.hg.conf documents userDbTableName but the code reads userDbName refs #37925

A mirror that copied the example got no error, just silently kept using the
default userDb table, since nothing in the tree reads userDbTableName.
hg/inc/cartDb.h:80 defines the setting as userDbName, read at
hg/lib/cartDb.c:325 through cfgOptionEnvDefault.

Also documents sessionDbName, the matching setting for the session cart
table, which the example did not mention at all.

Found while building the hg.conf registry.

diff --git src/product/ex.hg.conf src/product/ex.hg.conf
index d0da11a980d..a20e90a4cd2 100644
--- src/product/ex.hg.conf
+++ src/product/ex.hg.conf
@@ -622,31 +622,34 @@
 # genbankDb=hgFixed
 
 # use a table other than clade to hold the mappings from clades to their labels
 # cladeTableName=clade
 #
 # use a table other than genomeClade to hold the mappings from genome to clade
 # genomeCladeTableName=genomeClade
 #
 # use a table other than defaultDb to hold the default assembly for a genome
 # defaultDbTableName=defaultDb
 #
 # use a table other than dbDb to describe attributes of installed assemblies
 # dbDbTableName=dbDb
 #
 # use a table other than userDb to describe the user database
-# userDbTableName=userDb
+# userDbName=userDb
+#
+# use a table other than sessionDb to hold the session carts
+# sessionDbName=sessionDb
 
 # put error lines from warnings about bigBeds in the apache error_log
 # bigWarn=on
 #
 
 # specify the root directory for a CGI to use instead of the directory the script lives in
 # browser.cgiRoot=/usr/local/apache/cgi-bin
 
 # Limit the number of bytes that the custom track loader for MAF or VCF track will read in
 # customTracks.maxBytes=52428800
 
 # Allows hgHubConnect to run hubCheck and present a tree of errors or the overall hub
 # layout. Requires the hubCheck program to be present in the loader directory.
 # On by default but can be turned off with this setting
 # hgHubConnect.validateHub=off