Add more docstrings

[python-musicpdaio.git] / doc / source / tutorial.rst

diff --git a/doc/source/tutorial.rst b/doc/source/tutorial.rst
index b0280d7037ac95c73eb23b9f883c195f785d129a..0540df9a0551d93d7fc58cfda792ef34317e2953 100644 (file)
--- a/doc/source/tutorial.rst
+++ b/doc/source/tutorial.rst
@@ -44,10 +44,18 @@ Getting started
 
 .. index:: single: command; password
 
+**musicpdaio** tries to come with sane defaults, then running
+:py:class:`mpdaio.MPDClient` with no explicit argument will try default values
+to connect to MPD. Cf. :ref:`reference` for more about
+:ref:`defaults<default_settings>`.
+
 **Using a specific host, port and a password.**
 
-The password is sent when a connection is made, no need to explicitly send the
-password command.
+The password is sent when a connection is made, no need to explicitly use the
+password command. In the following code a client is constructed with a password argument, then when the ping method is called:
+ * the client fetch a connection from the pool
+ * then a password command is sent with the password
+ * finally the ping command is sent.
 
 .. sourcecode:: python