you can get the current version by calling the phar without arguments:

    $ php silex.phar
    Silex version 1ee6b36

there is only one single `update` command:

    $ php silex.phar update

this will fetch the latest version of the phar from silex-project.org
and replace the current one with it.

this makes it easier for users because they can easily update. we could
potentially even provide a changelog on running the command.

this commit also introduces a Silex\Application::VERSION constant that
currently is set to the current git SHA-1, as I proposed in PR 33. This
is done by the Compiler. It can later be adjusted to use `git describe`.

this is an implementation of PR 35 without the console component.

* igorw/master:
  fix extension test namespaces
  rename WebTestCase::{createApp => createApplication}
  do not read files twice when compiling

Usage:

    $app->register(new SwiftmailerExtension(), array(
        'swiftmailer.options' => array(
            'host'       => 'smtp.gmail.com',
            'port'       => 465,
            'encryption' => 'ssl',
            'auth_mode'  => 'login',
            'username'   => 'xxxxxx',
            'password'   => 'yyyyyy',
        )
    ));

    $app['mailer']->send($app['mailer']
        ->createMessage()
        ->setFrom('foo@example.com')
        ->addTo('bar@example.com')
        ->setSubject('Foo Title')
        ->setBody('Foo Body')
    );

* igorw/escape-docs:
  [docs] some docs for escape()

Usage:

    $form = $app['form.factory']->createBuilder('form')
       ->add('first_name', 'text')
       ->add('last_name', 'text');

    return $app['twig']->render('form', array('form' => $form->getView()));

* igorw/session2:
  add some docs about extension conventions
  [SessionExtension] docs on how to use the SessionExtension

* igorw/escape:
  [escape] html escaping shortcut

* igorw/callable-controller:
  fix documentation on callable controllers (thanks Bart)

* igorw/more-docs:
  [docs] a section about common pitfalls
  [docs] style adjustment
  [docs] emphasis on "let's go"
  [docs] explain the purpose of the JsonUserPersister
  [docs] add cross-references to Symfony2 API docs
  [docs] several small adjustments

* igorw/httpexception:
  rename BaseHttpException to HttpException

Dashes are common in URL patterns, so it would be helpful to convert them to underscores for default route generation. Any invalid characters (according to Symfony\Component\Routing\RouteCollection) should be stripped entirely, lest an exception is raised.

If a route ends with a / and the user forgets the / (and a similar route without a / does not exist),
then, the user will be redirected to the real URL:

If you have a /doc/ URL pattern, a request to /doc will redirect you to /doc/

This is especially useful for the root URL (/):

/index.php (which does not make sense as the path info is / at a minimum)
redirects to /index.php/