diff --git a/RELEASENOTES.md b/RELEASENOTES.md
index 0fa768c..e7917ce 100644
--- a/RELEASENOTES.md
+++ b/RELEASENOTES.md
@@ -5,6 +5,9 @@ Release Notes
 
 ### Minor revisions
 
+#### v1.12.5
+- updated documentation
+
 #### v1.12.4
 - updated dependencies
 - fixed README.me HANA client link
diff --git a/driver/connector.go b/driver/connector.go
index 8926145..160b3f3 100644
--- a/driver/connector.go
+++ b/driver/connector.go
@@ -47,6 +47,7 @@ func NewBasicAuthConnector(host, username, password string) *Connector {
 }
 
 // NewX509AuthConnector creates a connector for X509 (client certificate) authentication.
+// Parameters clientCert and clientKey in PEM format, clientKey not password encryped.
 func NewX509AuthConnector(host string, clientCert, clientKey []byte) (*Connector, error) {
 	c := NewConnector()
 	c._host = host
@@ -59,6 +60,7 @@ func NewX509AuthConnector(host string, clientCert, clientKey []byte) (*Connector
 
 // NewX509AuthConnectorByFiles creates a connector for X509 (client certificate) authentication
 // based on client certificate and client key files.
+// Parameters clientCertFile and clientKeyFile in PEM format, clientKeyFile not password encryped.
 func NewX509AuthConnectorByFiles(host, clientCertFile, clientKeyFile string) (*Connector, error) {
 	c := NewConnector()
 	c._host = host
diff --git a/driver/driver.go b/driver/driver.go
index 660538f..39a4443 100644
--- a/driver/driver.go
+++ b/driver/driver.go
@@ -10,7 +10,7 @@ import (
 )
 
 // DriverVersion is the version number of the hdb driver.
-const DriverVersion = "1.12.4"
+const DriverVersion = "1.12.5"
 
 // DriverName is the driver name to use with sql.Open for hdb databases.
 const DriverName = "hdb"