Move cli generated files out of common

There's no shared usage for these files, so move them into a
subdirectory of cli-reference.

Call the subdirectory generated and add a README so that it's clear that
these are generated files.

Fix also .gitignore to only ignore some top-level directories.

Change-Id: Ifb455a8640cc7e735ed81563b438d68522e73ded

.gitignore

@@ -4,8 +4,8 @@
 
 # Build results
 target/
-publish-docs/
-generated/
+/publish-docs/
+/generated/
 /build-*.log.gz
 
 # Ignore Vagrant Related Files

doc/cli-reference/bk-cli-reference.xml

@@ -78,17 +78,17 @@
     </info>
     <xi:include href="../common/ch_preface.xml"/>
     <xi:include href="ch_cli.xml"/>
-    <xi:include href="../common/ch_cli_cinder_commands.xml"/>
-    <xi:include href="../common/ch_cli_nova_commands.xml"/>
-    <xi:include href="../common/ch_cli_keystone_commands.xml"/>
-    <xi:include href="../common/ch_cli_glance_commands.xml"/>
+    <xi:include href="generated/ch_cli_cinder_commands.xml"/>
+    <xi:include href="generated/ch_cli_nova_commands.xml"/>
+    <xi:include href="generated/ch_cli_keystone_commands.xml"/>
+    <xi:include href="generated/ch_cli_glance_commands.xml"/>
     <xi:include href="ch_cli_glance_property_keys.xml"/>
-    <xi:include href="../common/ch_cli_neutron_commands.xml"/>
+    <xi:include href="generated/ch_cli_neutron_commands.xml"/>
     <xi:include href="ch_cli_neutron-debug_commands.xml"/>
-    <xi:include href="../common/ch_cli_swift_commands.xml"/>
-    <xi:include href="../common/ch_cli_heat_commands.xml"/>
-    <xi:include href="../common/ch_cli_ceilometer_commands.xml"/>
-    <xi:include href="../common/ch_cli_trove_commands.xml"/>
-    <xi:include href="../common/ch_cli_trove-manage_commands.xml"/>
+    <xi:include href="generated/ch_cli_swift_commands.xml"/>
+    <xi:include href="generated/ch_cli_heat_commands.xml"/>
+    <xi:include href="generated/ch_cli_ceilometer_commands.xml"/>
+    <xi:include href="generated/ch_cli_trove_commands.xml"/>
+    <xi:include href="generated/ch_cli_trove-manage_commands.xml"/>
     <xi:include href="../common/app_support.xml"/>
    </book>

doc/cli-reference/generated/README.rst

@@ -0,0 +1,10 @@
+Generated files
++++++++++++++++
+
+All files in this directory are generated from the output of the
+python commands they describe using the ``openstack-auto-commands``
+tool from the openstack-doc-tools package.
+
+Do not change these files - change openstack-auto-commands and the
+python commands itself.
+