authentication doc

Jan Korte · Jan Korte · commit 9aad7615750d · 2015-06-22T18:58:49.000+02:00
diff --git a/couchdb/client.py b/couchdb/client.py
@@ -43,7 +43,9 @@
 class Server(object):
     """Representation of a CouchDB server.
 
-    >>> server = Server()
+    >>> server = Server() # connects to the local_server
+    >>> remote_server = Server('http://example.com:5984/')
+    >>> secure_remote_server = Server('https://username:password@example.com:5984/')
 
     This class behaves like a dictionary of databases. For example, to get a
     list of database names on the server, you can simply iterate over the
diff --git a/doc/getting-started.rst b/doc/getting-started.rst
@@ -14,6 +14,8 @@ running elsewhere, set it up like this:
 
     >>> couch = couchdb.Server('http://example.com:5984/')
 
+You can also pass authentication credentials or use SSL: https://username:password@host:port/
+
 You can create a new database from Python, or use an existing database:
 
     >>> db = couch.create('test') # newly created
