[PATCH] Make manual validate against DocBook 4.2 DTD
Within a lists's items, we didn't include our text in a paragraph
properly.
To not let this happen again (hopefully), add a 'validate' target to
doc/Makefile which extracts the DTD url from the manual and tries to
validate against it using xmllint(1). This target has to be called
manually and is not intended to be used by end users but maintainers
and documentation hackers.
---
doc/Makefile.am | 5 +++++
doc/manual.xml.head | 12 ++++++------
2 files changed, 11 insertions(+), 6 deletions(-)
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 5469132..c7cc057 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -99,6 +99,11 @@ manual.tex: stamp-doc-xml
openjade -t tex -D $(DSLROOT) -d print/docbook.dsl dtds/decls/xml.dcl
manual.xml; \
fi
+validate: stamp-doc-xml
+ xmllint --noout --noblanks --postvalid --dtdvalid \
+ `grep http manual.xml | head -1 | sed -e 's/^.*http/http/' -e
's/\.dtd.*$$/.dtd/'` \
+ manual.xml
+
clean-local:
rm -f *~ *.html *.orig *.rej stamp-doc-* *.ps mutt.1 muttrc.man
rm -f *.aux *.log *.tex *.out
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index f5bad9e..f4dbce0 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -308,12 +308,12 @@ following categories:
<para>
<itemizedlist>
-<listitem>muttrc commands</listitem>
-<listitem>addresses and aliases</listitem>
-<listitem>shell commands</listitem>
-<listitem>filenames</listitem>
-<listitem>patterns</listitem>
-<listitem>everything else</listitem>
+<listitem><para>muttrc commands</para></listitem>
+<listitem><para>addresses and aliases</para></listitem>
+<listitem><para>shell commands</para></listitem>
+<listitem><para>filenames</para></listitem>
+<listitem><para>patterns</para></listitem>
+<listitem><para>everything else</para></listitem>
</itemizedlist>
</para>
--
1.5.0.rc4.g0f5c