added parameters to control the behaviour

test.py is a modified copy of validate.py. I introduced a new
name to not cause race conditions with the existing Jenkins
job which actually uses validate.py.

This patch introduces the following new parameters and changes
the default behaviour of the script. By default the script will
do nothing.

--check-build: With this parameter the script tries to build
               all books affected by modified files.

--check-syntax: With this parameter the script checks if modified
                files are still using valid XML syntax.

--with-niceness: Using this parameter together with --check-syntax
                 will also check the syntax for niceness issues (for
                 example trailing whitespaces).

--non-voting: With this parameter set the script always returns 0
              as exit code.

Possible Jenkins jobs:

./tools/test.py --check-build
./tools/test.py --check-syntax
./tools/test.py --check-syntax --with-niceness --non-voting

The force parameter is also available (as in validate.py). But
I think it's not meaningful to force the build of all books
or the syntax check of all files because this will result again
in very long runtimes.

We should not use the --non-voting parameter on Jenkins. It should
be possible to simply define non-voting jobs. Then the job is
failed in the review request, but Jenkins still gives +1.

Change-Id: I2ed6f80beb109c60bd7f0ca2417426f776383973
Add openSUSE Basic Install Guide to docs.o.o/trunk

Change-Id: Ife42fe26d42058aabc2864303475cd04c0c69929
Add preface Image Guide

The Image Guide did not show the revision history, a simple
preface that shows a history has been added.

Change-Id: Iff409277bc64e3a3b514607ce4038de0c35f0dea
Improve Debian support in Basic Install Guide

The Guide is built for both Debian and Ubuntu and there are a few
places that are only relevant for either of these. These sections
have been updated to clarify for which OS they are.

Some places used "deb" instead of "debian" or missed to add os="debian",
these were fixed as well.

Note: The basic install guide is build with os="ubuntu;debian", so some
of these changes do not change the generated code.

Change-Id: Ib50c5cee239c370a17d5462c2a6837357242425d
Closes-Bug: #1206328
Use localhost connection for cinder

As mentioned in “Set up the cinder database.”, the “PRIVILEGES” giving to cinder are local. Therefore I think it’s important to emphasize that:
“Edit /etc/cinder/cinder.conf to reflect your settings.” will give permission to local host.

try to fix Bug #1214764

Change-Id: I03f58f04f246a72f810492a7bf2e774e5b827921
Fixed various language and markup problems in install guide

Change-Id: I2c56e1e60121fe6d29d8fe9cfaf2eb84716c006f
Merge "added parameters to control the behaviour"
Merge "Add openSUSE Basic Install Guide to docs.o.o/trunk"
Merge "Add preface Image Guide"
Merge "Improve Debian support in Basic Install Guide"
Merge "Fixed various language and markup problems in install guide"
Merge "Use localhost connection for cinder"