Drush documentation

We need to document only three aliases we introduced. All the rest is documented on the drush.ws website.

drush up* is denied for good reasons, but still available.

It is a bit hidden in the configuration to discourage this insecure practice, as you should never run updates on live sites - instead you should create a new platform with updated modules and use Aegir migration task (first testing the migration on cloned site).

The correct commands are "drush mup", which is an alias for original "drush up" and "drush dbup" which is an alias for original "drush updatedb", but really, avoid using it, as it is completely against all Aegir best practices and has no roll-back option so you will run this on your own risk - "upgrade & pray it will not crash the site".

Of course both commands are still useful to create new platform with updated code - if you know what are you doing.

So here is a quick docs draft:

drush gm is an alias for drush generate-makefile, see http://drupalcode.org/project/barracuda.git/commit/356caaa

drush dbup is an alias for drush updatedb

drush mup is an alias for drush upc

drush sm existed in Drush 3 and is now replaced with drush pml in Drush 4 - we need to fix this one.

Yes, this is normal, because drush *anything* is allowed, unless drush *something* is denied or hidden with non-standard aliases. We need to document it anyway.

Both drush pmi and drush pml are now added to the list of displayed/allowed commands (in HEAD).

There is an excellent article about it: http://cms.about.com/od/omega8/a/Using-The-Shell-With-Omega8-Aegir-Web-H...