spelling: use "email" consistently

The common English spelling is "email", not "e-mail" (and was indeed
also the most common, but not only, variant in the Kallithea UI).

http://grammarist.com/style/e-mail-email/

docs: improve documentation of beaker session configuration

beaker.session.auto is dropped; it defaults to false and there is no reason to
ever set it true for Kallithea.

beaker.session.cookie_path and secure are dropped; like cookie_domain, they
should automatically be set to the right value.
* * *
beaker.session.cookie_expires MUST have the default value of True to provide the default value of 'browser session lifetime' when not enabling 'remember' in the login box. The cookie life is hardcoded to 365 days when remember is selected.

e-mail: add documentation about configuration settings

Document e-mail related configuration settings in the documentation
(overview) and the .ini file itself (technical details and example
settings).

e-mail: add some default values and some examples to .ini file as comments

This includes a replacement of @localhost examples to @example.com, to
indicate that real addresses should normally be used.

e-mail: clarify that smtp_use_ssl defaults to false

Commented settings in configuration files conventionally indicate the
default value.

e-mail: remove unused setting error_message from ini files

The ini files and templates contain a commented setting of 'error_message'
which does not seem to be used. It is referring to the error_message
variable in Paste, which has as description (Paste:ErrorMiddleware):

When debug mode is off, the error message to show to users.

However, setting this value apparently made no effect at all in Kallithea.

i18n: drop redundant english translation

lang should thus be set empty instead of 'en', but we keep the en .mo around
to avoid upgrade issues.

ini file: clarify that beaker.session.key should be unique

When several instances of Kallithea are running on the same machine, the
same browser cannot be logged into both instances at the same time without
conflicts. The login session are saved into the same cookie; logging into
one instance closes the session on the second instance and vice-versa.

This is caused because the cookie name is simply 'kallithea', combined with
the fact that the cookie specification (RFC6265) states that there is no
isolation of cookies based on port. This means that the browser sends all
cookies from a given domain with all services (Kallithea instances) running
on that domain, irrespective of port.

The services thus need to handle any such issue themselves, for example by
using unique cookie names and only interacting with one's own cookie.

Making the key unique when creating the configuration file proved difficult:
- it does not seem possible to hook into 'paster make-config'
- since Beaker directly interprets the beaker.session.key, changing it on
the fly from SessionMiddleware will not work correctly.

There is a kallithea-config script that is an alternative to 'paster
make-config' which would be the ideal place to make such changes. However,
it seems this method is not advocated over 'paster make-config' (yet?).

Instead, simply add a comment in the config file and let the user take care
of it.

Align and update the outdated ini files and templates

Change default database for development.ini to sqlite

First step in two-part process to rename directories to kallithea.
This first step is to change all references in the files where they refer
to the old directory name.

synced vcs with upstream

- moved subprocessio module to VCS
- many small changes to make embedded vcs as similar to to external lib
- use only absolute imports
- patch vcs config during load pylons env

added initial_repo_scan flag for controll if repo scaning should be performed on every startup.
There's always paster repo-scan or repo scann triggered from admin pannel

config: rename options to show_revision_number and show_sha_length

'sha_show_numeric_rev' had nothing to do with the sha value.

The revision numbers are kind of native to Mercurial and there they are known
as 'revision numbers'.

'sha_len' was very short and didn't clarify that it only controlled what was shown.

These settings are currently only used in the changelog, but they should be used everywhere.

made git refs filter configurable ref issue #797
- default --all was kept and --branches --tags (or even other variations) is possible to use via .ini file

fixed ip restriction tests when runned multiple times.
Added sleep to fix cache issues

Reimplemented file-browser using partial-ajax
- improves the speed of browsing of files for revision
- url push state via html5 History
- also cache the results of calls for even faster handling the content

Switch to waitress wsgi server by default in rhodecode.
- waitress is fast, handles chunked encoding correctly (needed for git)
- waitress works on linux and windows
- it's now default because it can handle git properly out of the box.

Mysql fixes
- force INNODB engine
- set utf8 charset
- fix convert_unicode flag in .ini files
- fix constraints and FK

#227 Initial version of repository groups permissions system
- implemented none/read/write/admin permissions for groups
- wrote more tests for permissions, and new permissions groups
- a lot of code garden, splitted logic into proper models
- permissions on groups doesn't propagate yet to repositories
- deprecated some methods on api for managing permissions on
repositories for users, and users groups

Cached readme generation
- cleaned up cache system

Fixes issue #201
Fixed bug when repository was deleted on filesystem, and not from rhodecode

fixes #200, rewrote the whole caching mechanism to get rid of such problems. Now cached instances are attached
to db repository instance, and then fetched from cache. Also made all current test work.

changed dev and tests to postgressql for more error proof setup.
Fixed postgresql database wipe

Celery is configured by the .ini files and run from paster now
removed celeryconfig, added homebrew celery-pylons,
added paster celeryd command, fixed tasks to use pylons configs, sqlalchemy sessions

Tests rewrite for 1.2 added some globals configs to make tests easier.
Fixed search index_location to take from configuration files now
fixed git http_user_agent bug

Code refactoring,models renames
cleaned up sqlalchemy sessions,
added cache support to most queries in models
fixed test.ini file

removed egg info, update files for distutils build
updated READMES some config files

Improved testing scenarios. Made test env creator
Fixed hg_model error message
some other tweeks and fixes
Models fixe for uniq email, and removed some extra not needed imports from model main module