Unified the syntax of the XML root element (config-reference)

The XML root element of Docbook XML files should match the following
format:

<ELEMENT xmlns="http://docbook.org/ns/docbook"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0"
  xml:id="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: I02a75b63d0fb3ea4a7d015794b9229a94ddad279

doc/config-reference/app_firewalls-ports.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <appendix xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="firewalls-default-ports">
     <title>Firewalls and default ports</title>
     <para>On some deployments, such as ones where restrictive

doc/config-reference/bk-config-ref.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <book xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="bk-openstack-config-reference-icehouse"
   status="draft">
     <title>OpenStack Configuration Reference</title>

doc/config-reference/block-storage/section_backup-drivers.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_backup-drivers">
     <title>Backup drivers</title>
     <para>This section describes how to configure the <systemitem

doc/config-reference/block-storage/section_block-storage-overview.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_block-storage-overview">
     <title>Introduction to the Block Storage service</title>
     <para>The OpenStack Block Storage service provides persistent block storage resources that

doc/config-reference/block-storage/section_block-storage-sample-configuration-files.xml

@@ -1,5 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_block-storage-sample-configuration-files">
     <title>Block Storage sample configuration files</title>
     <para>All the files in this section can be found in <systemitem>/etc/cinder</systemitem>.</para>

doc/config-reference/block-storage/section_cinder-log-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_cinder-logs">
     <title>Log files used by Block Storage</title>
     <para>The corresponding log file of each Block Storage service

doc/config-reference/block-storage/section_fc-zoning.xml

@@ -1,6 +1,8 @@
-<section xml:id="section_fc-zoning" xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_fc-zoning">
     <title>Fibre Channel Zone Manager</title>
     <para>The Fibre Channel Zone Manager allows FC SAN Zone/Access
         control management in conjunction with Fibre Channel block

doc/config-reference/block-storage/section_misc.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_volume-misc">
     <title>Additional options</title>
 

doc/config-reference/block-storage/section_volume-drivers.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_volume-drivers">
     <title>Volume drivers</title>
     <para>To use different volume drivers for the <systemitem

doc/config-reference/ch_blockstorageconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-block-storage"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-block-storage">
   <title>Block Storage</title>
   <para>The OpenStack Block Storage service works with many different
     storage drivers that you can configure by using these instructions.</para>

doc/config-reference/ch_computeconfigure.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="ch_configuring-openstack-compute">
   <title>Compute</title>
   <para>The OpenStack Compute service is a cloud computing fabric

doc/config-reference/ch_config-overview.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <preface xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="config_overview">
     <title>OpenStack configuration overview</title>
     <para>OpenStack is a collection of open source project components

doc/config-reference/ch_dashboardconfigure.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="ch_configuring-dashboard">
     <title>Dashboard</title>
     <para>This chapter describes how to configure the OpenStack

doc/config-reference/ch_databaseserviceconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-trove"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-trove">
   <title>Database Service</title>
   <para>The Database Service provides a scalable and reliable Cloud
   Database-as-a-Service functionality for both relational and

doc/config-reference/ch_identityconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-identity"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-identity">
   <title>Identity service</title>
     <para>This chapter details the OpenStack Identity service configuration
 options. For installation prerequisites and step-by-step walkthroughs, see the

doc/config-reference/ch_imageservice.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-image-service"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-image-service">
   <title>Image Service</title>
     <para>Compute relies on an external image service to store virtual
     machine images and maintain a catalog of available images. By

doc/config-reference/ch_networkingconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-networking"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-networking">
     <title>Networking</title>
     <para>This chapter explains the OpenStack Networking configuration options. For installation
         prerequisites, steps, and use cases, see the <citetitle>OpenStack Installation

doc/config-reference/ch_objectstorageconfigure.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="ch_configuring-object-storage">
     <title>Object Storage</title>
     <para>OpenStack Object Storage uses multiple configuration files

doc/config-reference/ch_orchestrationconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-orchestration"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-orchestration">
   <title>Orchestration</title>
   <para>The Orchestration service is designed to manage the lifecycle of
       infrastructure and applications within OpenStack clouds. Its

doc/config-reference/ch_telemetryconfigure.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="ch_configuring-openstack-telemetry"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<chapter xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0" >
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_configuring-openstack-telemetry">
   <title>Telemetry</title>
   <para>The Telemetry service collects measurements within OpenStack. Its
       various agents and services are configured in the

doc/config-reference/compute/section_compute-cells.xml

@@ -1,7 +1,8 @@
-<section xml:id="section_compute-cells"
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink"
-    xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
+  version="5.0"
+  xml:id="section_compute-cells">
     <title>Cells</title>
     <?dbhtml stop-chunking?>
     <para><emphasis role="italic">Cells</emphasis> functionality

doc/config-reference/compute/section_compute-config-samples.xml

@@ -1,8 +1,8 @@
-<section xml:id="section_compute-config-samples"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_compute-config-samples">
     <title>Example <filename>nova.conf</filename> configuration
         files</title>
     <para>The following sections describe the configuration options in

doc/config-reference/compute/section_compute-configure-backing-storage.xml

@@ -1,8 +1,8 @@
-<section xml:id="section_configure-backing-storage"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_configure-backing-storage">
   <title>Configure Compute backing storage</title>
   <para>
     Backing Storage is the storage used to provide the expanded

doc/config-reference/compute/section_compute-configure-console.xml

@@ -1,5 +1,4 @@
-<section
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink"
   version="5.0"

doc/config-reference/compute/section_compute-configure-db.xml

@@ -1,8 +1,8 @@
-<section xml:id="section_configuring-database-connections"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_configuring-database-connections">
     <title>Database configuration</title>
     <para>You can configure OpenStack Compute to use any
         SQLAlchemy-compatible database. The database name is

doc/config-reference/compute/section_compute-configure-xen.xml

@@ -1,8 +1,8 @@
-<section xml:id="section_compute-configure-xen"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_compute-configure-xen">
 <title>Xen configuration reference</title>
 <para>The following section discusses some commonly changed options in XenServer.
       The table below provides a complete reference of all

doc/config-reference/compute/section_compute-hypervisors.xml

@@ -1,8 +1,8 @@
-<section xml:id="section_compute-hypervisors"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_compute-hypervisors">
     <title>Hypervisors</title>
     <para>OpenStack Compute supports many hypervisors, which might
         make it difficult for you to choose one. Most installations

doc/config-reference/compute/section_compute-options-reference.xml

@@ -1,8 +1,9 @@
 <?xml version= "1.0" encoding= "UTF-8"?>
-<section xml:id="section-compute-config-samples"
-    xmlns= "http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink= "http://www.w3.org/1999/xlink" version= "5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section-compute-config-samples">
     <title>Compute sample configuration files</title>
     <section xml:id="list-of-compute-config-options">
     <title>nova.conf - configuration options</title>

doc/config-reference/compute/section_compute-sample-configuration-files.xml

@@ -1,5 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="compute-sample-configuration-files">
     <title>Additional sample configuration files</title>
     <para>Files in this section can be found in <systemitem>/etc/nova</systemitem>.</para>

doc/config-reference/compute/section_compute-scheduler.xml

@@ -3,10 +3,11 @@
 <!ENTITY % openstack SYSTEM "../../common/entities/openstack.ent">
 %openstack;
 ]>
-<section xml:id="section_compute-scheduler"
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink"
-    xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
+  version="5.0"
+  xml:id="section_compute-scheduler">
     <?dbhtml stop-chunking?>
     <title>Scheduling</title>
     <para>Compute uses the <systemitem class="service"

doc/config-reference/compute/section_hypervisor_baremetal.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="baremetal">
     <title>Baremetal driver</title>
     <para>The baremetal driver is a hypervisor driver for OpenStack Nova

doc/config-reference/compute/section_hypervisor_hyper-v.xml

@@ -1,6 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="hyper-v-virtualization-platform">
     <?dbhtml stop-chunking?>
     <title>Hyper-V virtualization platform</title>

doc/config-reference/compute/section_hypervisor_kvm.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="kvm">
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="kvm">
     <?dbhtml stop-chunking?>
     <title>KVM</title>
     <para>KVM is configured as the default hypervisor for Compute.</para>

doc/config-reference/compute/section_hypervisor_lxc.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="lxc">
   <title>LXC (Linux containers)</title>
   <para>LXC (also known as Linux containers) is a virtualization technology that works at the

doc/config-reference/compute/section_hypervisor_qemu.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="qemu">
     <?dbhtml stop-chunking?>
     <title>QEMU</title>

doc/config-reference/compute/section_hypervisor_vmware.xml

@@ -3,7 +3,11 @@
 <!ENTITY % openstack SYSTEM "../../common/entities/openstack.ent">
 %openstack;
 ]>
-<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="vmware">
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="vmware">
   <title>VMware vSphere</title>
   <?dbhtml stop-chunking?>
   <section xml:id="vmware-intro">

doc/config-reference/compute/section_introduction-to-xen.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="introduction-to-xen">
     <?dbhtml stop-chunking?>
     <title xml:id="introduction-to-xen.title">Xen, XenAPI, XenServer,

doc/config-reference/compute/section_nova-conf.xml

@@ -1,8 +1,9 @@
 <?xml version= "1.0" encoding= "UTF-8"?>
-<section xml:id="compute-nova-conf"
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="compute-nova-conf">
     <title>Overview of nova.conf</title>
     <para>The <filename>nova.conf</filename> configuration file is
         an <link xlink:href="https://en.wikipedia.org/wiki/INI_file"

doc/config-reference/compute/section_nova-log-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_nova-logs">
         <title>Compute log files</title>
     <para>The corresponding log file of each Compute service

doc/config-reference/dashboard/section_dashboard-log-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_dashboard-logs">
     <title>Dashboard log files</title>
     <para>The dashboard is served to users through the Apache web

doc/config-reference/dashboard/section_dashboard-sample-configuration-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_dashboard-sample-configuration-files">
     <title>Additional sample configuration files</title>
     <para>Find the following files in <systemitem>/etc/openstack-dashboard</systemitem>.</para>

doc/config-reference/database-service/section-databaseservice-db.xml

@@ -1,8 +1,8 @@
-<section xml:id="database-configuring-db"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="database-configuring-db">
   <?dbhtml stop-chunking?>
    <title>Configure the database</title>
 

doc/config-reference/database-service/section-databaseservice-rpc.xml

@@ -1,8 +1,8 @@
-<section xml:id="database-configuring-rpc"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="database-configuring-rpc">
   <?dbhtml stop-chunking?>
    <title>Configure the RPC messaging system</title>
    <para>OpenStack projects use an open standard for messaging

doc/config-reference/identity/section_keystone-sample-conf-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="sample-configuration-files">
     <title>Identity service sample configuration files</title>
     <para>You can find the files described in this section in the

doc/config-reference/image-service/section_image-service-ISO-support.xml

@@ -1,7 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xml:id="iso-support" xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="iso-support">
     <title>Support for ISO images</title>
     <para>You can load ISO images into the Image Service. You can
         subsequently boot an ISO image using Compute.</para>

doc/config-reference/image-service/section_image-service-api.xml

@@ -1,8 +1,8 @@
-<section xml:id="image-configuring-api"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="image-configuring-api">
    <title>Configure the API</title>
    <para>The Image Service has two APIs: the user-facing API, and
    the registry API, which is for internal requests that require

doc/config-reference/image-service/section_image-service-backend-vmware.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="vmware-glance-backend">
     <title>Configure vCenter data stores for the Image Service back
         end</title>

doc/config-reference/image-service/section_image-service-backends.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section version="5.0" xml:id="configuring-image-service-backends"
-  xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink"
-  xmlns:xi="http://www.w3.org/2001/XInclude">
+  version="5.0"
+  xml:id="configuring-image-service-backends">
   <title>Configure back ends</title>
     <para>The Image Service supports several back ends for storing
     virtual machine images:<itemizedlist>

doc/config-reference/image-service/section_image-service-rpc.xml

@@ -1,8 +1,8 @@
-<section xml:id="image-configuring-rpc"
-  xmlns="http://docbook.org/ns/docbook"
-  xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="image-configuring-rpc">
   <title>Configure the RPC messaging system</title>
   <para>OpenStack projects use an open standard for messaging
     middleware known as AMQP. This messaging middleware enables the

doc/config-reference/image-service/section_image-service-sample-configuration-files.xml

@@ -1,5 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_image-service-sample-configuration-files">
     <title>Image Service sample configuration files</title>
     <para>You can find the files that are described in this section in

doc/config-reference/networking/section_networking-log-files.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_neutron-logs">
     <title>Log files used by Networking</title>
     <para>The corresponding log file of each Networking service is

doc/config-reference/networking/section_networking-options-reference.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xml:id="section_networking-options-reference"
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="section_networking-options-reference">
     <title>Networking configuration options</title>
 <para>The options and descriptions listed in this introduction are auto generated from the code in
         the Networking service project, which provides software-defined networking between VMs run

doc/config-reference/networking/section_networking-plugins-ml2.xml

@@ -1,9 +1,9 @@
 <?xml version= "1.0" encoding= "UTF-8"?>
-<section xml:id="networking-options-plugins-ml2"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="networking-options-plugins-ml2">
     <title>Modular Layer 2 (ml2) configuration options</title>
     <para>The Modular Layer 2 (ml2) plug-in has two components:
         network types and mechanisms. You can configure these

doc/config-reference/networking/section_networking-plugins.xml

@@ -1,9 +1,9 @@
 <?xml version= "1.0" encoding= "UTF-8"?>
-<section xml:id="networking-options-plugins"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="networking-options-plugins">
          <title>Networking plug-ins</title>
          <para>OpenStack Networking introduces the concept of a
                   plug-in, which is a back-end implementation of the

doc/config-reference/networking/section_networking-sample-configuration-files.xml

@@ -1,5 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="block-storage-sample-configuration-files">
     <title>Networking sample configuration files</title>
     <para>All the files in this section can be found in <filename class="directory">/etc/neutron/</filename>.</para>

doc/config-reference/object-storage/section_configure_s3.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="configuring-openstack-object-storage-with-s3_api">
     <title>Configure Object Storage with the S3 API</title>
     <para>The Swift3 middleware emulates the S3 REST API on top of

doc/config-reference/object-storage/section_object-storage-cors.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="object-storage-cores">
     <title>Cross-origin resource sharing</title>
     <para>Cross-Origin Resource Sharing (CORS) is a mechanism that allows code running in a browser

doc/config-reference/object-storage/section_object-storage-features.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xml:id="configuring-object-storage-features"
-    xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="configuring-object-storage-features">
     <title>Configure Object Storage features</title>
     <section xml:id="swift-zones">
         <title>Object Storage zones</title>

doc/config-reference/object-storage/section_object-storage-general-service-conf.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="swift-general-service-configuration">
     <title>Object Storage general service configuration</title>
     <para>

doc/config-reference/object-storage/section_object-storage-listendpoints.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="object-storage-listendpoints">
     <title>Endpoint listing middleware</title>
     <para>The endpoint listing middleware enables third-party services that use data locality

doc/config-reference/orchestration/section_orchestration-api.xml

@@ -1,8 +1,8 @@
-<section xml:id="orchestration-configuring-api"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="orchestration-configuring-api">
   <?dbhtml stop-chunking?>
    <title>Configure APIs</title>
    <para>The following options allow configuration of the APIs that

doc/config-reference/orchestration/section_orchestration-clients.xml

@@ -1,8 +1,8 @@
-<section xml:id="orchestration-configuring-clients"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="orchestration-configuring-clients">
   <?dbhtml stop-chunking?>
    <title>Configure Clients</title>
    <para>The following options allow configuration of the clients that

doc/config-reference/orchestration/section_orchestration-rpc.xml

@@ -1,8 +1,8 @@
-<section xml:id="orchestration-configuring-rpc"
-    xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+<section xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-    version="5.0">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="orchestration-configuring-rpc">
   <?dbhtml stop-chunking?>
    <title>Configure the RPC messaging system</title>
    <para>OpenStack projects use an open standard for messaging

doc/config-reference/telemetry/section_telemetry-sample-configuration-files.xml

@@ -1,5 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+<?xml version="1.0" encoding="UTF-8"?><section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
   xml:id="section_telemetry-sample-configuration-files">
     <title>Telemetry sample configuration files</title>
     <para>All the files in this section can be found in the <filename