merged branch guillemc/patch-1 (PR #659)

This PR was merged into the master branch.

Discussion
----------

Add example of JsonUserPersister being managed

Reintroducing the example used at the beginning will make things clearer, I think.

Commits
-------

96574213 Add example of JsonUserPersister being managed

doc/services.rst

@@ -143,6 +143,15 @@ those definitions.
 
     This also works for shared services.
 
+Going back to our initial example, here's how we could use the container 
+to manage its dependencies::
+
+    $app['user.persist_path'] = '/tmp/users';
+    $app['user.persister'] = $app->share(function ($app) {
+        return new JsonUserPersister($app['user.persist_path']);
+    });
+
+
 Protected closures
 ~~~~~~~~~~~~~~~~~~