openstack/openstack-manuals
Code Issues Proposed changes

Avoid having twice Appendix A

Browse Source 
Both user-guide and user-guide-admin had two versions appendices
labelled "A". The problem was setting appendixAutolabel to 1 in
the pom.xml file and manual overrides of the number in the files.
The patch cleanes all of this up and renames ch_resources.xml
to an appendix part.

security-guide and training-guide also set this variable but did
not have an appendix yet, so remove the variable there as well.

Change-Id: I446f4968b675d3286f2302071ddfa8037425fd6f
This commit is contained in:
Andreas Jaeger
2013-09-28 18:43:15 +02:00
parent 153af26213
commit c12a0526ff
8 changed files with 6 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/common/app_command_reference.xml
View File

@@ -13,7 +13,7 @@
<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"
xml:id="nova_summary" label="A">
xml:id="nova_summary">
<title>Command reference</title>
<xi:include
href="section_keystone_cli_commands.xml"/>

6
doc/common/ch_resources.xml → doc/common/app_resources.xml
View File

@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook"
<appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns:m="http://www.w3.org/1998/Math/MathML"
xmlns:html="http://www.w3.org/1999/xhtml"
xmlns:db="http://docbook.org/ns/docbook" version="5.0"
xml:id="resources" label="A">
xml:id="resources">
<title>Resources</title>
<para>For the available OpenStack documentation, see <link
xlink:href="http://docs.openstack.org"
@@ -90,4 +90,4 @@
or <link
xlink:href="https://bugs.launchpad.net/openstack-manuals/+filebug"
>report a bug</link>.</para>
</chapter>
</appendix>

1
doc/security-guide/pom.xml
View File

@@ -43,7 +43,6 @@
<enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<chapterAutolabel>1</chapterAutolabel>
<appendixAutolabel>1</appendixAutolabel>
<sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<formalProcedures>0</formalProcedures>

1
doc/training-guide/pom.xml
View File

@@ -38,7 +38,6 @@
<enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<chapterAutolabel>1</chapterAutolabel>
<appendixAutolabel>1</appendixAutolabel>
<sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<formalProcedures>0</formalProcedures>

2
doc/user-guide-admin/bk-admin-user-guide.xml
View File

@@ -61,5 +61,5 @@
<xi:include href="ch_dashboard.xml"/>
<xi:include href="ch_cli.xml"/>
<xi:include href="../common/app_command_reference.xml"/>
<xi:include href="../common/ch_resources.xml"/>
<xi:include href="../common/app_resources.xml"/>
</book>

2
doc/user-guide-admin/pom.xml
View File

@@ -54,7 +54,6 @@
<configuration>
<profileOs>adminuser</profileOs>
<chapterAutolabel>1</chapterAutolabel>
<appendixAutolabel>1</appendixAutolabel>
<sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<formalProcedures>0</formalProcedures>
@@ -72,7 +71,6 @@
<suppressFooterNavigation>0</suppressFooterNavigation>
<formalProcedures>0</formalProcedures>
<sectionAutolabel>0</sectionAutolabel>
<appendixAutolabel>0</appendixAutolabel>
<tocSectionDepth>1</tocSectionDepth>
</configuration>
</plugin>

2
doc/user-guide/bk-user-guide.xml
View File

@@ -70,5 +70,5 @@
<xi:include href="ch_dashboard.xml"/>
<xi:include href="ch_cli.xml"/>
<xi:include href="../common/app_command_reference.xml"/>
<xi:include href="../common/ch_resources.xml"/>
<xi:include href="../common/app_resources.xml"/>
</book>

1
doc/user-guide/pom.xml
View File

@@ -54,7 +54,6 @@ set toc,title </generateToc>
<configuration>
<profileOs>enduser</profileOs>
<chapterAutolabel>1</chapterAutolabel>
<appendixAutolabel>1</appendixAutolabel>
<sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<formalProcedures>0</formalProcedures>