docs: Document FreeTDS SSL requirement for Azure connections.

Ramiro Morales · Ramiro Morales · commit 72079e358bd9 · 2015-04-08T23:10:55.000-03:00
diff --git a/README_building_and_developing.rst b/README_building_and_developing.rst
@@ -15,6 +15,13 @@ To build pymssql you should have:
   software distribution channels, e.g, ``freetds-dev`` or ``freetds-devel``
   packages.
 
+.. note::
+    If you need to connect to Azure:
+
+    * Use FreeTDS 0.91 or newer
+    * Make sure FreeTDS is built with SSL support. Instructions on how to do
+      this are out of the scope of this document.
+
 Windows
 -------
 
diff --git a/docs/building_and_developing.rst b/docs/building_and_developing.rst
@@ -1,4 +1,4 @@
 .. include:: ../README_building_and_developing.rst
 
-.. Please see the `README:building_and_developing.rst` file located in the root of the pymssql source
+.. Please see the `README_building_and_developing.rst` file located in the root of the pymssql source
    code tree.
diff --git a/docs/ref/_mssql.rst b/docs/ref/_mssql.rst
@@ -98,7 +98,12 @@ Functions
         *conn_properties* wasn't customizable and its value was hard-coded to
         the literal shown above.
 
-    .. note:: If you need to connect to Azure make sure you use FreeTDS 0.91 or newer.
+    .. note::
+        If you need to connect to Azure:
+
+        * Use FreeTDS 0.91 or newer
+        * Make sure FreeTDS is built with SSL support
+        * Specify the database name you are connecting to in the *database* parameter
 
     .. versionadded:: 2.1.1
         The ability to connect to Azure.
diff --git a/docs/ref/pymssql.rst b/docs/ref/pymssql.rst
@@ -65,9 +65,11 @@ Functions
         timeouts have a global effect.
 
     .. note::
-        If you need to connect to Azure make sure you:
-        * Use FreeTDS 0.91 or newer.
-        * Specify the database name you are connecting to in the ``connect()`` call.
+        If you need to connect to Azure:
+
+        * Use FreeTDS 0.91 or newer
+        * Make sure FreeTDS is built with SSL support
+        * Specify the database name you are connecting to in the ``connect()`` call
 
     .. versionadded:: 2.1.1
         The ability to connect to Azure.
