Progress config reference for networking

This update structures and fleshes various sections of the
configuration reference for networking and misc other changes,
including:

* making a new section for RPC as related to networking
* splitting out plugin tables into a separate file
* sectionin out tables for other sections
* adding zeromq to the RPC section for compute

patchset2/3: fixes whitespace

patchset4 fixes based on review -thanks!

Change-Id: Ic2dc88118f5057c985bfe4cf5671ac9c9f8b2c6e
bp:restructure-documentation
Fix OpenStack capitalization

I noticed a couple of places where OpenStack was capitalized wrongly and
searched and updated them.

Change-Id: Ia15c58459ba0a2392ec5e2f93988443ac74fa7e1
Use egg:swift3#swift3 instead of egg:swift#swift3

From the bugreport:
"I also want to point that "use = egg:swift#swift3" is wrongly stated in
the doc. It has to be "use = egg:swift3#swift3" - as swift3 is not a
module of swift but of swift3."

The above change is confirmed by
https://github.com/fujita/swift3/blob/master/README.md

Change-Id: Icc190cf01586f3d41faaf57a2771dc1af5883876
Closes-Bug: #1209254
cleaned up section customizing flavors

  * removed/added some spaces/newlines
  * transformed a listing in a table

Change-Id: I354960b304de3c17ef00da383b9dd0651d1acc68
validate modified files and build affected books

At the moment the validation script simply validates all
files and builds all books afterwards. This results in a
very long runtime (appr. 30 minutes at the moment).

With this patch only modified files are validated and only
affected books are built. A book is affected if one XML
file includes a modified file. If no book is directly
affected all books are built.

In this way, resources can be saved and validation is
performed much faster.

Change-Id: I17dcf119c0bafc4656c9f267f0d3f5ae884ea76e
cleaning up network connectivity admin

Change-Id: I331e83ef5f4ea5c0020f483e5b36e8f6db747e1c
generalizing highlighting of glance-{api,registry}

Also fixed some highlights of configuration files.

Change-Id: I84358640a3f5046d752adb3987c267046da6ab04
Merge "Use egg:swift3#swift3 instead of egg:swift#swift3"
Merge "Fix OpenStack capitalization"
Final changes to OpenStack Admin User Guide

bug: #1208507

Change-Id: I6c35b2a50be25a3aa06e3f951dec8598315503ec
author: diane fleming
Merge "Final changes to OpenStack Admin User Guide"
Merge "validate modified files and build affected books"
Adds where to set the compute_driver info.

Change-Id: Ifb47d480d6633dedd5c281eb49ac21caca3ccf8f
Do not use -y for package install

As a followup to a patch for basic-install (see
https://review.openstack.org/#/c/30263/), here's an update
for the rest of the manual to remove -y as option for package
installations.

See also
http://lists.openstack.org/pipermail/openstack-docs/2013-May/001787.html

Change-Id: I3d3bcfac4d3ae41933b587f026e1f1c75f02ea08
Basic Install document: Add first openSUSE information

This patch set adds information about openSUSE. I used os="opensuse" for
it. The document as is will not build for opensuse since additional
files need to be changes first. I will add those additional changes once
this review is done.

Change-Id: Ib6bdaf206816c250ec216d878ec1bdc5620f9f64
clone sources into repo

avoiding remote raw.github.com includes for now by cloning included reposities into training

bug 1211135

Change-Id: Ib702cbc2c1d554f1578e8fbe1d3d67749bc3e1be
Update storage admin guide for newly supported api(s) in HDS volume driver

* Clone Volume
* Extend Volume

Change-Id: I26715c2a0785bfa709bd49c262935b10cdfd5aa6
Merge "Basic Install document: Add first openSUSE information"
Merge "clone sources into repo"
Extend, structure Keystone troubleshooting section

This patch creates a new section in common for identity
troubleshooting, which supercedes the existing stub sections
in common and openstack install and adds PKI middleware
troubleshooting information.

The section is included in the basic install guide
(install identity chapter) and compute admin manual
(via the common identity chapter that is only used in this guide).

fixes bug 1204640

Conflicts:
	doc/src/docbkx/common/ch_identity_mgmt.xml
	doc/src/docbkx/common/section_identity_troubleshooting.xml
	doc/src/docbkx/openstack-install/identity-troubleshooting.xml

Change-Id: Ibce5d404d1a5d1c413f1324c897eca4b36f6edf2
bp:restructure-documentation