Permalink
Browse files

Documentation: replace use of sectN tags by generic section

Publican issues the following message when building the docbook:

*WARNING: Unvalidated tag: 'sect1'. This tag may not be displayed
correctly, may generate invalid xhtml, or may breach Section 508
Accessibility standards.
  • Loading branch information...
dregad committed May 17, 2013
1 parent 190f745 commit ab5b37e8395c01b76e0ac6eb75c38743a127e586
@@ -6,7 +6,7 @@
<chapter id="dev.appendix">
<title>Appendix</title>
- <sect1 id="dev.appendix.git">
+ <section id="dev.appendix.git">
<title>Git References</title>
<itemizedlist>
@@ -36,5 +36,5 @@
</para></listitem>
</itemizedlist>
- </sect1>
+ </section>
</chapter>
@@ -13,7 +13,7 @@
<link linkend="dev.appendix.git">Appendix</link>.
</para>
- <sect1 id="dev.contrib.setup">
+ <section id="dev.contrib.setup">
<title>Initial Setup</title>
<para>
@@ -50,9 +50,9 @@ $ git config --global alias.co "checkout"
$ git config --global alias.ci "commit"
</programlisting>
- </sect1>
+ </section>
- <sect1 id="dev.contrib.clone">
+ <section id="dev.contrib.clone">
<title>Cloning the Repository</title>
<para>
@@ -94,9 +94,9 @@ $ git clone git@github.com:mantisbt/mantisbt.git
$ git checkout -b master-1.2.x origin/master-1.2.x
</programlisting>
- </sect1>
+ </section>
- <sect1 id="dev.contrib.branch">
+ <section id="dev.contrib.branch">
<title>Maintaining Tracking Branches</title>
<para>
@@ -132,9 +132,9 @@ $ git rebase origin/master
$ git checkout master
$ git pull --rebase
</programlisting>
- </sect1>
+ </section>
- <sect1 id="dev.contrib.prepare">
+ <section id="dev.contrib.prepare">
<title>Preparing Feature Branches</title>
<para>
@@ -146,7 +146,7 @@ $ git pull --rebase
your local tracking branches</link>.</emphasis>
</para>
- <sect2 id="dev.contrib.prepare.local">
+ <section id="dev.contrib.prepare.local">
<title>Private Branches</title>
<para>
@@ -175,9 +175,9 @@ $ git checkout feature
$ git fetch remote/feature
$ git rebase remote/feature
</programlisting>
- </sect2>
+ </section>
- <sect2 id="dev.contrib.prepare.public">
+ <section id="dev.contrib.prepare.public">
<title>Public Branches</title>
<para>
@@ -208,11 +208,11 @@ $ git merge master
local branch, either with another merge, or with a rebase, as necessitated
by the public or private status of their own changes.
</para>
- </sect2>
+ </section>
- </sect1>
+ </section>
- <sect1 id="dev.contrib.test">
+ <section id="dev.contrib.test">
<title>Running PHPUnit tests</title>
<para>
@@ -240,7 +240,7 @@ $ git merge master
$ phing test
</programlisting>
- <sect2 id="dev.contrib.test.soap">
+ <section id="dev.contrib.test.soap">
<title>Running the SOAP tests</title>
<para>
@@ -259,11 +259,11 @@ $ phing test
based on the skipped tests.</para></listitem>
</itemizedlist>
- </sect2>
+ </section>
- </sect1>
+ </section>
- <sect1 id="dev.contrib.submit">
+ <section id="dev.contrib.submit">
<title>Submitting Changes</title>
<para>
@@ -296,7 +296,7 @@ $ phing test
<ulink url="http://gitorious.com">Gitorious</ulink>.
</para>
- <sect2 id="dev.contrib.submit.patch">
+ <section id="dev.contrib.submit.patch">
<title>Via Formatted Patches</title>
<para>
@@ -323,9 +323,9 @@ $ git format-patch --binary --stdout origin/master..HEAD > feature_branch.patch
$ git am --signoff feature_branch.patch
</programlisting>
- </sect2>
+ </section>
- <sect2 id="dev.contrib.submit.repo">
+ <section id="dev.contrib.submit.repo">
<title>Via Public Repository</title>
<para>
@@ -406,9 +406,9 @@ $ git format-patch --binary --stdout master..HEAD > feature_branch.patch
$ git am --signoff feature_branch.patch
</programlisting>
- </sect2>
+ </section>
- </sect1>
+ </section>
</chapter>
@@ -6,19 +6,19 @@
<chapter id="dev.database">
<title>Database Schema Management</title>
- <sect1 id="dev.database.schema">
+ <section id="dev.database.schema">
<title>Schema Definition</title>
<para>
TODO: Discuss the ADODB datadict formats and the format MantisBT expects for schema definitions.
</para>
- </sect1>
+ </section>
- <sect1 id="dev.database.install">
+ <section id="dev.database.install">
<title>Installation / Upgrade Process</title>
<para>
TODO: Discuss how MantisBT handles a database installation / upgrade, including the use of the config system and schema definitions.
</para>
- </sect1>
+ </section>
</chapter>
@@ -6,7 +6,7 @@
<chapter id="dev.events">
<title>Event System</title>
- <sect1 id="dev.events.concepts">
+ <section id="dev.events.concepts">
<title>General Concepts</title>
<para>
@@ -22,9 +22,9 @@
values from hooked functions will be handled in different ways to make
certain types of common communication simplified.
</para>
- </sect1>
+ </section>
- <sect1 id="dev.events.api">
+ <section id="dev.events.api">
<title>API Usage</title>
<para>
@@ -105,9 +105,9 @@ event_hook( $events, [$plugin] );
determining the unique needs of each event when signalling and hooking them.
</para>
</blockquote>
- </sect1>
+ </section>
- <sect1 id="dev.events.types">
+ <section id="dev.events.types">
<title>Event Types</title>
<para>
@@ -227,5 +227,5 @@ event_hook( $events, [$plugin] );
<programlisting>$values = event_signal( $event_name, [ array( $param, ... ) ] );</programlisting>
</blockquote>
- </sect1>
+ </section>
</chapter>
@@ -6,7 +6,7 @@
<chapter id="dev.eventref">
<title>Events Reference</title>
- <sect1 id="dev.eventref.intro">
+ <section id="dev.eventref.intro">
<title>Introduction</title>
<para>
@@ -44,9 +44,9 @@
</blockquote>
</blockquote>
- </sect1>
+ </section>
- <sect1 id="dev.eventref.system">
+ <section id="dev.eventref.system">
<title>System Events</title>
<para>
@@ -116,7 +116,7 @@
</blockquote>
</blockquote>
- </sect1>
+ </section>
<xi:include href="Events_Reference_Output.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Events_Reference_Filter.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
@@ -1,7 +1,7 @@
-<sect1 id="dev.eventref.account">
+<section id="dev.eventref.account">
<title>User Account Events</title>
- <sect2 id="dev.eventref.account.prefs">
+ <section id="dev.eventref.account.prefs">
<title>Account Preferences</title>
<blockquote id="dev.eventref.account.prefs.updateform">
@@ -43,7 +43,7 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
-</sect1>
+</section>
@@ -3,10 +3,10 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "Developers_Guide.ent">
%BOOK_ENTITIES;
]>
-<sect1 id="dev.eventref.bug">
+<section id="dev.eventref.bug">
<title>Bug and Bugnote Events</title>
- <sect2 id="dev.eventref.bug.view">
+ <section id="dev.eventref.bug.view">
<title>Bug View</title>
<blockquote id="dev.eventref.bug.view.details">
@@ -54,9 +54,9 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
- <sect2 id="dev.eventref.bug.action">
+ <section id="dev.eventref.bug.action">
<title>Bug Actions</title>
<blockquote id="dev.eventref.bug.action.reportbugform">
@@ -276,9 +276,9 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
- <sect2 id="dev.eventref.bug.noteview">
+ <section id="dev.eventref.bug.noteview">
<title>Bugnote View</title>
<blockquote id="dev.eventref.bug.noteview.start">
@@ -349,9 +349,9 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
- <sect2 id="dev.eventref.bug.noteaction">
+ <section id="dev.eventref.bug.noteaction">
<title>Bugnote Actions</title>
<blockquote id="dev.eventref.bug.noteaction.addform">
@@ -480,6 +480,6 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
-</sect1>
+</section>
@@ -3,10 +3,10 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "Developers_Guide.ent">
%BOOK_ENTITIES;
]>
-<sect1 id="dev.eventref.filter">
+<section id="dev.eventref.filter">
<title>Bug Filter Events</title>
- <sect2 id="dev.eventref.filter.custom">
+ <section id="dev.eventref.filter.custom">
<title>Custom Filters and Columns</title>
<blockquote id="dev.eventref.filter.custom.fields">
@@ -47,6 +47,6 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
-</sect1>
+</section>
@@ -3,7 +3,7 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "Developers_Guide.ent">
%BOOK_ENTITIES;
]>
-<sect1 id="dev.eventref.manage">
+<section id="dev.eventref.manage">
<title>Management Events</title>
<blockquote id="dev.eventref.manage.overviewinfo">
@@ -22,7 +22,7 @@
</blockquote>
</blockquote>
- <sect2 id="dev.eventref.manage.project">
+ <section id="dev.eventref.manage.project">
<title>Projects and Versions</title>
<blockquote id="dev.eventref.manage.project.view">
@@ -172,7 +172,7 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
-</sect1>
+</section>
@@ -3,10 +3,10 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "Developers_Guide.ent">
%BOOK_ENTITIES;
]>
-<sect1 id="dev.eventref.notify">
+<section id="dev.eventref.notify">
<title>Notification Events</title>
- <sect2 id="dev.eventref.notify.user">
+ <section id="dev.eventref.notify.user">
<title>Recipient Selection</title>
<blockquote id="dev.eventref.notify.user.include">
@@ -58,6 +58,6 @@
</blockquote>
</blockquote>
- </sect2>
+ </section>
-</sect1>
+</section>
Oops, something went wrong.

0 comments on commit ab5b37e

Please sign in to comment.