Added configuration for Glance to authenticate via Keystone

Apparently the existing instructions lack the configuration keys
necessary for Glance to authenticate via Keystone which breaks various
features. I added 'flavor = keystone' to glance-api.conf and
glance-registry.conf to resolve this issue. However, this generated
a warning about the lack of 'auth_uri' which I also added to resolve
this issue. This patch also includes general clarifications.

Since this patch plays a significant role in building a functional
environment, I recommend considering it for backporting to Havana.

Change-Id: If112a7d039f3943238e915ef0066765529c7d668
backport: havana
Closes-Bug: #1262755
Closes-Bug: #1267854
Profile Install Guide by default for only Ubuntu

We do not profile anymore for "ubuntu;debian" but separately for each,
let's fix the default setup for this as well.

Change-Id: I405f4bf3507797d465f6d9b91784af14a6ebd89c
Install Guide: Break overlong lines

Break overlong lines that overflow PDF output.

Change-Id: I5e95f7eb6a18ffe3c47794a1cf385abd7d87cfbd
Fix overlong lines

Fix overlong lines in PDF output.

Change-Id: I5a3a1f24043682e3eb289729dc5b377d27476a13
Merge "Added configuration for Glance to authenticate via Keystone"
improved readability and markup

Removed whitespace

Added markup per conventions

Change-Id: I5808872930806c7bde90564d5fade0d5486083fb
Partial-Bug: #1217503
Merge "improved readability and markup"
Improve publishing of Admin Guide Cloud

Before this change, we have been publishing the whole of webhelp
to the website which is:
du -hs target/docbkx/webhelp/*
11M	target/docbkx/webhelp/admin-guide-cloud
2.3M	target/docbkx/webhelp/autopdf
836K	target/docbkx/webhelp/bk-admin-guide-cloud.xml
6.8M	target/docbkx/webhelp/cloud
22M	target/docbkx/webhelp/fonts
1.9M	target/docbkx/webhelp/images

This patch now cleanes up the publishing so that webhelp only
contains the admin-guide-cloud directory as it should.

The patch also does some minor cleanup of the pom file and removes
an unneeded generate-pdf execution.

Note: If this patch gets accepted, I will look at the other pom files
as well.

Change-Id: Iafcb227d9a65776f0beb9750463f7b54e9f05269
Merge "Fix overlong lines"
Merge "Profile Install Guide by default for only Ubuntu"
Merge "Install Guide: Break overlong lines"
Merge "Improve publishing of Admin Guide Cloud"