From: Rocco Rutte <pdmef@gmx.net>
Date: Fri, 9 Mar 2007 18:58:20 +0000 (-0800)
Subject: Make manual validate against DocBook 4.2 DTD for "book"
X-Git-Tag: mutt-1-5-15-rel~47^2~18^2~45
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6c5d6aff7bc57e222bb64a8ee86166b63dd1e7d3;p=mutt

Make manual validate against DocBook 4.2 DTD for "book"
This adds a 'validate' target to doc/Makefile which uses xmllint(1)
to validate manual.xml against the DTD given in the doctype (intended
for developers only).

Running it revealed two validation errors which this patch fixes:

1) We declare 'article' as the doctype but want to use 'book'
2) Within a lists's items, we didn't include our text in a paragraph
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 5469132d..32978de4 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -99,6 +99,9 @@ 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 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 f5bad9e4..2376817b 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -1,5 +1,5 @@
 <?xml version="1.0" standalone="no"?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <book>
 
@@ -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>