Unified the syntax of the XML root element (user-guide)

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: Ic59684221ba99632c71e3f9b5f97ec74f56793a4

doc/user-guide/app_cheat_sheet.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <appendix xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  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"
-    xml:id="app_cheat_sheet">
+  version="5.0"
+  xml:id="app_cheat_sheet">
     <?dbhtml stop-chunking?>
     <title>OpenStack command-line interface cheat sheet</title>
 

doc/user-guide/bk-user-guide.xml

@@ -2,9 +2,10 @@
 <!DOCTYPE book [
 ]>
 <book xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    xml:id="os-user-guide">
+  version="5.0"
+  xml:id="os-user-guide">
     <title>OpenStack End User Guide</title>
     <titleabbrev>End User Guide</titleabbrev>
     <info>

doc/user-guide/ch_cli.xml

@@ -2,10 +2,10 @@
 <!DOCTYPE chapter [
 ]>
 <chapter xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    version="5.0"
+  version="5.0"
-    xml:id="ch_cli">
+  xml:id="ch_cli">
     <info>
         <title>OpenStack command-line clients</title>
     </info>

doc/user-guide/ch_dashboard.xml

@@ -2,10 +2,10 @@
 <!DOCTYPE chapter [
 ]>
 <chapter xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    version="5.0"
+  version="5.0"
-    xml:id="ch_dashboard">
+  xml:id="ch_dashboard">
     <info>
         <title>OpenStack dashboard</title>
     </info>

doc/user-guide/ch_sdk.xml

@@ -1,7 +1,9 @@
 <?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" xml:id="ch_sdk">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_sdk">
   <info>
     <title>OpenStack Python SDK</title>
   </info>

doc/user-guide/section_cli_ceilometer.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    version="5.0"
+  version="5.0"
-    xml:id="ceilometer_cli_commands">
+  xml:id="ceilometer_cli_commands">
     <title>Measure cloud resources</title>
     <para>Telemetry measures cloud resources in OpenStack. It collects data related to billing. Currently, this metering service is available through
         only the <command>ceilometer</command> command-line client.</para>

doc/user-guide/section_cli_heat.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    version="5.0"
+  version="5.0"
-    xml:id="heat-stack-create">
+  xml:id="heat-stack-create">
     <?dbhtml stop-chunking?>
     <title>Create and manage stacks</title>
     <para>The Orchestration module enables you to orchestrate multiple composite cloud applications.

doc/user-guide/section_cli_nova_config-drive.xml

@@ -4,9 +4,10 @@
 %openstack;
 ]>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  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"
-    xml:id="config-drive">
+  version="5.0"
+  xml:id="config-drive">
     <title>Store metadata on a configuration drive</title>
     <para>You can configure OpenStack to write metadata to a special
         configuration drive that attaches to the instance when it boots. The

doc/user-guide/section_cli_nova_configure_instances.xml

@@ -4,9 +4,10 @@
 %openstack;
 ]>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  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"
-    xml:id="cli_configure_instances">
+  version="5.0"
+  xml:id="cli_configure_instances">
     <title>Configure access and security for instances</title>
     <?dbhtml stop-chunking?>
     <para>When you launch a virtual machine, you can inject a <emphasis

doc/user-guide/section_cli_nova_floating_ips.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xml:id="manage_ip_addresses"
+<section xmlns="http://docbook.org/ns/docbook"
-    xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+  version="5.0"
+  xml:id="manage_ip_addresses">
     <title>Manage IP addresses</title>
     <para>Each instance has a private, fixed IP address and can also have a public, or floating,
         address. Private IP addresses are used for communication between instances, and public

doc/user-guide/section_cli_nova_manage_instances.xml

@@ -1,8 +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: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"
-    xml:id="cli_manage_instances">
+  version="5.0"
+  xml:id="cli_manage_instances">
     <title>Manage instances and hosts</title>
     <para>Instances are virtual machines that run inside the cloud on
         physical compute nodes. The Compute service manages instances.

doc/user-guide/section_cli_nova_migrate_instances.xml

@@ -1,8 +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: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"
-    xml:id="cli_migrate_instances">
+  version="5.0"
+  xml:id="cli_migrate_instances">
     <?dbhtml stop-chunking?>
     <title>Use snapshots to migrate instances</title>
     <para>To use snapshots to migrate instances from OpenStack projects to clouds, complete these steps.</para>

doc/user-guide/section_cli_swift_howto.xml

@@ -1,8 +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: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"
-    xml:id="managing-openstack-object-storage-with-swift-cli">
+  version="5.0"
+  xml:id="managing-openstack-object-storage-with-swift-cli">
     <title>Manage objects and containers</title>
     <?dbhtml stop-chunking?>
     <para>The OpenStack Object Storage service provides the

doc/user-guide/section_cli_trove.xml

@@ -4,10 +4,10 @@
 %openstack;
 ]>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
-    version="5.0"
+  version="5.0"
-    xml:id="trove-manage-db">
+  xml:id="trove-manage-db">
     <?dbhtml stop-chunking?>
     <title>Create and manage databases</title>
     <para>The Database service provides scalable and reliable cloud provisioning functionality for both relational and non-relational database engines. Users can quickly and easily use database features without the burden of handling complex administrative tasks.</para>

doc/user-guide/section_dashboard_access_and_security.xml

@@ -1,8 +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: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"
-    xml:id="Launching_Instances_using_Dashboard">
+  version="5.0"
+  xml:id="Launching_Instances_using_Dashboard">
     <title>Configure access and security for instances</title>
     <?dbhtml stop-chunking?>
     <para>Before you launch an instance, you should add security group rules to

doc/user-guide/section_dashboard_create_networks.xml

@@ -1,8 +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: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"
-    xml:id="dashboard_create_networks">
+  version="5.0"
+  xml:id="dashboard_create_networks">
     <title>Create and manage networks</title>
     <?dbhtml stop-chunking?>
       <para>The OpenStack Networking service provides a scalable

doc/user-guide/section_dashboard_launch_instances.xml

@@ -1,8 +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: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"
-    xml:id="dashboard_launch_instances">
+  version="5.0"
+  xml:id="dashboard_launch_instances">
     <title>Launch and manage instances</title>
     <para>Instances are virtual machines that run inside the
         cloud.</para>

doc/user-guide/section_dashboard_launch_instances_from_image.xml

@@ -4,9 +4,10 @@
 %openstack;
 ]>
 <section xmlns="http://docbook.org/ns/docbook"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
+  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"
-    xml:id="dashboard_launch_instances_from_image">
+  version="5.0"
+  xml:id="dashboard_launch_instances_from_image">
     <title>Launch an instance</title>
     <?dbhtml stop-chunking?>
     <para>When you launch an instance from an image, OpenStack creates a local

doc/user-guide/section_dashboard_manage_containers.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: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="dashboard_manage_containers">
     <title>Create and manage object containers</title>
     <?dbhtml stop-chunking?>

doc/user-guide/section_dashboard_manage_images.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="dashboard_manage_images">
   <title>Upload and manage images</title>
   <para>A virtual machine image, referred to in this document simply

doc/user-guide/section_dashboard_manage_volumes.xml

@@ -1,8 +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: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"
-    xml:id="dashboard_manage_volumes">
+  version="5.0"
+  xml:id="dashboard_manage_volumes">
     <title>Create and manage volumes</title>
     <?dbhtml stop-chunking?>
     <para>Volumes are block storage devices that you attach to

doc/user-guide/section_dashboard_stacks.xml

@@ -1,8 +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: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"
-    xml:id="dashboard_stacks">
+  version="5.0"
+  xml:id="dashboard_stacks">
     <title>Launch and manage stacks</title>
     <?dbhtml stop-chunking?>
     <para>OpenStack Orchestration is a service that you can use to

doc/user-guide/section_sdk_auth_glance.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="sdk_auth_glance">
   <title>Authenticate against an Image Service endpoint</title>
   <para>To authenticate against an Image Service endpoint, instantiate

doc/user-guide/section_sdk_auth_keystone.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="sdk_auth_keystone">
   <title>Authenticate against an Identity endpoint</title>
   <para>To authenticate against the Identity v2.0 endpoint,

doc/user-guide/section_sdk_auth_neutron.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="sdk_auth_neutron">
   <title>Authenticate against a Networking endpoint</title>
   <para>To authenticate against a Networking endpoint, instantiate a

doc/user-guide/section_sdk_auth_nova.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="sdk_auth_nova">
   <title>Authenticate against a Compute endpoint</title>
   <para>To authenticate against a Compute endpoint, instantiate a

doc/user-guide/section_sdk_authenticate.xml

@@ -1,7 +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:xi="http://www.w3.org/2001/XInclude"
-xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="sdk_auth">
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="sdk_auth">
   <title>Authenticate</title>
   <para>When using the SDK, you must authenticate against an OpenStack
     endpoint before you can use OpenStack services. Each project uses

doc/user-guide/section_sdk_configure_instances.xml

@@ -1,8 +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: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"
-    xml:id="sdk_configure_instances">
+  version="5.0"
+  xml:id="sdk_configure_instances">
     <title>Configure access and security for instances</title>
     <para>When working with images in the SDK, you will call
             <literal>novaclient</literal> methods.</para>

doc/user-guide/section_sdk_install.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="sdk_install">
   <title>Install the OpenStack SDK</title>
   <para>Each OpenStack project has its own Python library. These

doc/user-guide/section_sdk_manage_images.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="sdk_manage_images">
   <?dbhtml stop-chunking?>
   <title>Manage images</title>

doc/user-guide/section_sdk_neutron.xml

@@ -1,8 +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: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"
-    xml:id="sdk_neutron_apis">
+  version="5.0"
+  xml:id="sdk_neutron_apis">
     <title>Networking</title>
     <?dbhtml stop-chunking?>
     <para>To use the information in this section, you should have a

doc/user-guide/section_sdk_nova.xml

@@ -1,8 +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: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"
-    xml:id="sdk_compute_apis">
+  version="5.0"
+  xml:id="sdk_compute_apis">
     <title>Compute</title>
     <?dbhtml stop-chunking?>
     <para>To use the information in this section, you must be familiar with OpenStack Compute.</para>