added escaping to the examples in the doc

README.md

@@ -11,8 +11,8 @@ require_once __DIR__.'/silex.phar';
 
 $app = new Silex\Application();
 
-$app->get('/hello/{name}', function ($name) {
-  return "Hello $name";
+$app->get('/hello/{name}', function ($name) use ($app) {
+  return 'Hello '.$app->escape($name);
 });
 
 $app->run();

doc/intro.rst

@@ -26,8 +26,8 @@ step.
 
     $app = new Silex\Application();
 
-    $app->get('/hello/{name}', function ($name) {
-        return "Hello $name";
+    $app->get('/hello/{name}', function ($name) use ($app) {
+        return 'Hello '.$app->escape($name);
     });
 
     $app->run();

src/Silex/Application.php

@@ -257,9 +257,9 @@ class Application extends \Pimple implements HttpKernelInterface, EventSubscribe
      * @param string $text The input text to be escaped
      * @return string Escaped text
      */
-    public function escape($text)
+    public function escape($text, $flags = ENT_COMPAT, $charset = 'UTF-8', $doubleEncode = true)
     {
-        return htmlspecialchars($text, ENT_COMPAT, 'UTF-8');
+        return htmlspecialchars($text, $flags, $charset, $doubleEncode);
     }
 
     /**