fixup docs

Author: methane

Makefile

@@ -2,6 +2,11 @@
 build:
 	python3 setup.py build_ext -if
 
+.PHONY: doc
+doc:
+	pip install .
+	pip install sphinx
+	cd doc && make html
 
 .PHONY: clean
 clean:

MySQLdb/__init__.py

@@ -18,8 +18,8 @@
 from . import _mysql
 
 if version_info != _mysql.version_info:
-    raise ImportError("this is MySQLdb version %s, but _mysql is version %r" %
-                      (version_info, _mysql.version_info))
+    raise ImportError("this is MySQLdb version %s, but _mysql is version %r\n_mysql: %r" %
+                      (version_info, _mysql.version_info, _mysql.__file__))
 
 threadsafety = 1
 apilevel = "2.0"

doc/MySQLdb.rst

@@ -41,6 +41,23 @@ MySQLdb Package
     :undoc-members:
     :show-inheritance:
 
+:mod:`_mysql` Module
+--------------------
+
+.. automodule:: MySQLdb._mysql
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+:mod:`_exceptions` Module
+-------------------------
+
+.. automodule:: MySQLdb._exceptions
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
 Subpackages
 -----------
 

doc/_exceptions.rst

@@ -546,7 +546,7 @@ nextset()
 Some examples
 .............
 
-The ``connect()`` method works nearly the same as with `_mysql`_::
+The ``connect()`` method works nearly the same as with `MySQLDB._mysql`_::
 
     import MySQLdb
     db=MySQLdb.connect(passwd="moonpie",db="thangs")