fixed markup

doc/changelog.rst

@@ -8,7 +8,7 @@ Changelog
   one.
 * Made dispatcher proxy methods ``on``, ``before``, ``after`` and ``error``
   lazy, so that they will not instantiate the dispatcher early.
-* Dropped support for 2.1 and 2.2 versions of symfony.
+* Dropped support for 2.1 and 2.2 versions of Symfony.
 
 1.0.1 (2013-07-04)
 ------------------

doc/cookbook/error_handler.rst

@@ -16,9 +16,9 @@ user to register them.
 Registering the ErrorHandler
 ----------------------------
 
-Fortunately, the `Symfony/Debug` package has an `ErrorHandler` that solves this
-issue. It converts all errors to exceptions, and exceptions can be caught by
-Silex.
+Fortunately, the ``Symfony/Debug`` package has an ``ErrorHandler`` class that
+solves this issue. It converts all errors to exceptions, and exceptions can be
+caught by Silex.
 
 You register it by calling the static ``register`` method::
 

doc/testing.rst

@@ -78,9 +78,9 @@ use it by making your test extend it::
 
 .. note::
 
-    If you want to use the Symfony2 `WebTestCase` you will need to explicitly
-    install its dependencies for your project. Add the following to your
-    `composer.json` file:
+    If you want to use the Symfony2 ``WebTestCase`` class you will need to
+    explicitly install its dependencies for your project. Add the following to
+    your ``composer.json`` file:
 
     .. code-block:: json
 

src/Silex/Application/SwiftmailerTrait.php

@@ -23,7 +23,8 @@ trait SwiftmailerTrait
      *
      * @param \Swift_Message $message          A \Swift_Message instance
      * @param array          $failedRecipients An array of failures by-reference
-     * @return int
+     *
+     * @return int The number of sent messages
      */
     public function mail(\Swift_Message $message, &$failedRecipients = null)
     {