diff --git a/doc/index.rst b/doc/index.rst
index d51e49c5..b459a46a 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -17,6 +17,7 @@ Besides the functionality required by DBAPI 2.0, pymonetdb also provides some
 MonetDB-specific functionality, in particular file transfers. These are detailed
 in the API section.
 
+This documentation covers pymonetdb version |version|.
 
 Contents
 ========
diff --git a/pymonetdb/__init__.py b/pymonetdb/__init__.py
index 086d98fc..5eda5840 100644
--- a/pymonetdb/__init__.py
+++ b/pymonetdb/__init__.py
@@ -97,7 +97,8 @@ def connect(    # noqa C901
     binary : int
         enable binary result sets when possible if > 0 (default: 1)
     replysize : str
-        number of rows to retrieve immediately after query execution (default: 100, -1 means everything)
+        number of rows to retrieve immediately after query execution,
+        the rest will be fetched on demand (default: 100, -1 means everything)
     maxprefetch : str
         max. number of additional rows to fetch during Cursor.fetchone() or Cursor.fetchmany()
     sock : str
@@ -121,7 +122,7 @@ def connect(    # noqa C901
     timezone : int
         the time zone to use, in minutes east of UTC
     dangerous_tls_nocheck : str
-        comma-separated list of certificate checks to skip during connecting:
+        comma-separated list of TLS certificate checks to skip during connecting:
         'host': ignore host name mismatch,
         'cert': ignore bad certificate chain
     """