updated docs
remove the "one argument" restriction from replace

otherwise the automatically injected number variable won't work for
plural translations
don't overwrite the number argument

if it's been defined in the translation call - don't obliterate it
don't forget to pass the category
point at the docs folder
mention the supported config kes
remove incorrect warning

The plugin handles both
add some examples
add cli stub
add translate behavior stub
make the extract task accept paths

I.e. make it possible to do:

	Console\cake Translations.extract Plugin/foo

And for it to then extract from only this path (also accounting for the
webroot folder)
for plural functions - always define {number}

make it consistent. Will otherwise likely be a pending bug for any
language with more complex plural rules
move doc files
correct throw statements
add translate behavior and import/export tools