Fix docs for Sphinx 1.6.6

rename included files to not have ".rst" extension,
otherwise they are being scanned for ref targets and found targets are
effectively counted twice (both in file that includes,
and in the file being included), producing a warning/error.

Change-Id: I2eec5b1b16d253998f45e6f0551a92c2ab6f5609
Closes-Bug: #1743780

doc/source/install/advanced.rst

@@ -3,18 +3,18 @@
 Advanced features
 =================
 
-.. include:: include/local-boot-partition-images.rst
+.. include:: include/local-boot-partition-images.inc
 
-.. include:: include/root-device-hints.rst
+.. include:: include/root-device-hints.inc
 
-.. include:: include/kernel-boot-parameters.rst
+.. include:: include/kernel-boot-parameters.inc
 
-.. include:: include/boot-mode.rst
+.. include:: include/boot-mode.inc
 
-.. include:: include/disk-label.rst
+.. include:: include/disk-label.inc
 
-.. include:: include/trusted-boot.rst
+.. include:: include/trusted-boot.inc
 
-.. include:: include/notifications.rst
+.. include:: include/notifications.inc
 
-.. include:: include/console.rst
+.. include:: include/console.inc

doc/source/install/install-obs.rst

@@ -12,7 +12,7 @@ for openSUSE Leap 42.2 and SUSE Linux Enterprise Server 12 SP2.
    Server is not officially supported. Nevertheless, installation should be
    possible.
 
-.. include:: include/common-prerequisites.rst
+.. include:: include/common-prerequisites.inc
 
 Install and configure components
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -30,10 +30,10 @@ Install and configure components
       # systemctl enable openstack-ironic-api openstack-ironic-conductor
       # systemctl start openstack-ironic-api openstack-ironic-conductor
 
-.. include:: include/common-configure.rst
+.. include:: include/common-configure.inc
 
-.. include:: include/configure-ironic-api.rst
+.. include:: include/configure-ironic-api.inc
 
-.. include:: include/configure-ironic-api-mod_wsgi.rst
+.. include:: include/configure-ironic-api-mod_wsgi.inc
 
-.. include:: include/configure-ironic-conductor.rst
+.. include:: include/configure-ironic-conductor.inc

doc/source/install/install-rdo.rst

@@ -8,7 +8,7 @@ Install and configure for Red Hat Enterprise Linux and CentOS
 This section describes how to install and configure the Bare Metal service
 for Red Hat Enterprise Linux 7 and CentOS 7.
 
-.. include:: include/common-prerequisites.rst
+.. include:: include/common-prerequisites.inc
 
 Install and configure components
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -34,10 +34,10 @@ Install and configure components
       # systemctl enable openstack-ironic-api openstack-ironic-conductor
       # systemctl start openstack-ironic-api openstack-ironic-conductor
 
-.. include:: include/common-configure.rst
+.. include:: include/common-configure.inc
 
-.. include:: include/configure-ironic-api.rst
+.. include:: include/configure-ironic-api.inc
 
-.. include:: include/configure-ironic-api-mod_wsgi.rst
+.. include:: include/configure-ironic-api-mod_wsgi.inc
 
-.. include:: include/configure-ironic-conductor.rst
+.. include:: include/configure-ironic-conductor.inc

doc/source/install/install-ubuntu.rst

@@ -7,7 +7,7 @@ Install and configure for Ubuntu
 This section describes how to install and configure the Bare Metal
 service for Ubuntu 14.04 (LTS).
 
-.. include:: include/common-prerequisites.rst
+.. include:: include/common-prerequisites.inc
 
 Install and configure components
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -22,10 +22,10 @@ Install and configure components
 
    Services are enabled by default on Ubuntu.
 
-.. include:: include/common-configure.rst
+.. include:: include/common-configure.inc
 
-.. include:: include/configure-ironic-api.rst
+.. include:: include/configure-ironic-api.inc
 
-.. include:: include/configure-ironic-api-mod_wsgi.rst
+.. include:: include/configure-ironic-api-mod_wsgi.inc
 
-.. include:: include/configure-ironic-conductor.rst
+.. include:: include/configure-ironic-conductor.inc