Spring cleaning in docs

This is nearly all about spiffing up stack.sh to improve comment
content and readability.  Shocco has been fixed so the comments and
code line up properly again in http://devstack.org/stack.sh.html so
the comments are being cleaned up and updated.

Change-Id: I2add0351106fb832fbf6e236cbd90630df97dec3
Remove references to deprecated ec2 authorizor.

 * remove replace_pipeline
 * removes references to sysadmin and netadmin roles
 * removes references to admin ec2 api
 * fixes bug 953744
 * related fix in nova: https://review.openstack.org/#change,5024

Change-Id: I8792dae0157b8596a5f946670742411781fe47c0
Add exercises/client-args.sh to test the pending cli changes for Keystone, Nova,
Glance and Swift.

Change-Id: I05aeda9be61e9c556d23ebc33076477c71708460
Add exercise that boots an instance from a volume.

 * Launches a cirros builder instance
 * Mounts a disk to the builder instance
 * Creates a bootable volume from builder
 * Launches the volume-backed instance
 * Update glance syntax
 * Don't require instance-to-web communication (that only works with
   fully configured floating ips)
 * Add footer/header

Change-Id: Ia6dcf399ee49154aaf4e597b060164c2f41cf3d2
Use sudo+virsh to clean instances frm previous run

 * fixes bug 955782

Change-Id: I8868132d5e18908d309da025760582a778ab4e72
Ubuntu precise support.

- Fixes bug 954249.
- Install python-argparse only on oneiric (tks: dtroyer for
  suggestions).

Change-Id: I5ba8424a9cd172ac5246106163d21ca6a67ef6ef
Merge "Ubuntu precise support."
Only do a nova-manage db_sync when we have nova.

- Fixes bug 956226.

Change-Id: I823e8f43425c2d629219bb426fb6aa5d1ab9ff34
Merge "Add exercises/client-args.sh to test the pending cli changes for Keystone, Nova, Glance and Swift."
Update Swift doc.

Update README.md with the latest changes.

Change-Id: I63e8094cce31e0490b72a131f8a3bcf928c5881a
Converts bundle exercise to use swift/s3

- Fix keystone s3token configuration (in admin api not public api).
- Set s3 service in keystone to swift if installed.
- Fixes a bug in bundle.sh
- Adds config options for nova to use swift as s3 store

Change-Id: Ic2fca5aba06a25c0b3a74f1e97d062390a8e2ab1
Merge "Converts bundle exercise to use swift/s3"
Merge "Only do a nova-manage db_sync when we have nova."
Run swift-proxy from screen.

- Fixes bug 956172

Change-Id: I9a83d6afc04596bf84e3cf27a3f3f6f7b7d05180
Add python-mysqldb to keystone apt package list.

- Fixes bug 957065.

Change-Id: If811a725c2348cebfb326e08ef69909905e46420
Fix swift restart error

'swift-init all {restart|stop}' exits with '1' if there are any problems
sutting down any swift server, including if they were not running to begin with.
An attempt to address this has already been ignored by the Swift team, and it
would not have completely eliminated the problem, so we'll just be defensive here.

Change-Id: Ib8e30221e1c8873d0e849add89dc87d5ccda9d82
Merge "Add python-mysqldb to keystone apt package list."
Don't enabled nova-objectstore if swift is enabled

- Fixes bug 957178.

Change-Id: Ieb2840344bf8c0d9a1da50925f5ca0649d9dad21
Some tweaks for xen + devstack.

 * Import functions for git_clone (allows RECLONE for xen plugins)
 * Fix a potential xvas path issue
 * Tweaks to docs

Change-Id: I34f5c57a53884dfe944f3b0eb8896c57e348e389
Remove default quantum-keystoneclient dep.

 * Don't automatically install q-cli with horizon
 * Always install q-cli if ENABLED_SERVICES includes 'quantum'
 * Completely remove quantum config from horizon (there is no quantum+horizon in essex)

Change-Id: I0897437326abd757b6c792fd6ec946fa6e7981c9