X-Git-Url: http://git.kaliko.me/?a=blobdiff_plain;f=doc%2Fsource%2Ftutorial.rst;h=0aee9a4e48631c6f4182e457266cd8aca45b1344;hb=refs%2Fheads%2Fmain;hp=b0280d7037ac95c73eb23b9f883c195f785d129a;hpb=baa907b0e0378dd0ed09f6e1202f5ed605f3f344;p=python-musicpdaio.git

diff --git a/doc/source/tutorial.rst b/doc/source/tutorial.rst
index b0280d7..0aee9a4 100644
--- a/doc/source/tutorial.rst
+++ b/doc/source/tutorial.rst
@@ -44,10 +44,19 @@ 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