Handle removed files in tools/validate.py

Previously if a file was removed, no checks were done that the file
was not referenced anywhere.

Now you get e.g.:
Checking for removed files
  Removed file: doc/src/docbkx/common/section_keystone_cli_users_tenants_roles.xml
  Removed file: doc/src/docbkx/openstack-user-admin/src/section_cli_set_block_storage_quotas.xml
  Removed file: doc/src/docbkx/openstack-user-admin/src/section_cli_set_compute_quotas.xml
  Removed file: doc/src/docbkx/openstack-user-admin/src/section_keystone_cli_manage_projects_users.xml
  Removed file: doc/src/docbkx/openstack-user/src/section_cli_help.xml
  Removed file: doc/src/docbkx/openstack-user/src/section_cli_install.xml
  Removed file: doc/src/docbkx/openstack-user/src/section_cli_openrc.xml
  Removed file: doc/src/docbkx/openstack-user/src/section_cli_overview.xml
  Removed file: doc/src/docbkx/openstack-user/src/section_cli_version.xml
  File section_compute-configure-quotas.xml has an xi:include on deleted file ../openstack-user-admin/src/section_cli_set_compute_quotas.xml

And validate.py exists with error code to mark this as failure.

Also, limit number of parallel build jobs to 4 to reduce Jenkins load,
hope we see less org.apache.fop.fonts.FontTriplet.
Related-Bug: # 1221721

Change-Id: I3e47217958840f61347f71b159414928f266d6d5
Adjust validate.py for flattened directory structure

With this change validate.py validates and builds again the manuals.

I disabled validation of basic-install-pom.xml as it's a pom.xml
file.
Currently the basic-install guide is not build at all.

Change-Id: I9cabab5e03266ac7d5d4452ddbf97ea6d9dcdf3a
Fixes reference to glossary in the security-guide

Change-Id: I725a333423342de26ad04a264ad8d5336a3a5751
Merge "Adjust validate.py for flattened directory structure"
Merge "Handle removed files in tools/validate.py"
Build User Guide

Fix include and pom after directory flatten so that the book builds
again.

Change-Id: I641363f55c38a78ac9d0510712c297a2242909c5
Fix Install Guide rename

The install guide still used openstack-compute in the pom.xml file,
fix for renamed structure.

Change-Id: I0d89eb2e30694b8dcac0dd6b7b29a75bdfc0e5d4
Merge "Build User Guide"