From 8a2967e3371bd2638da1c2511b968e5bbe1ab553 Mon Sep 17 00:00:00 2001
From: Petter Reinholdtsen <pere@hungry.com>
Date: Sun, 25 Oct 2020 21:46:19 +0100
Subject: [PATCH] Document DTD breaking parts of fixup-docbook.rb.

---
 fixup-docbook.rb | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/fixup-docbook.rb b/fixup-docbook.rb
index 0c99fc4..d7411ba 100755
--- a/fixup-docbook.rb
+++ b/fixup-docbook.rb
@@ -106,6 +106,7 @@ xml.css('dedication').each do |ded|
                                [auth_c, quote_c])
 end
 
+# FIXME the DTD do now allow this use of <attribution>
 %w(preface#foreword preface#introduction).each do |spec|
   sect = xml.css(spec)[0]
   paras = sect.css('para emphasis')
@@ -116,12 +117,14 @@ end
   paras.each {|i| i.parent.remove} # Remove both the 'emphasis' and its parent 'para'
 end
 
+# FIXME the DTD do now allow this use of <attribution>
 auth = xml.css('chapter')[0].css('para')[0]
 auth.content =~ /^\s*Paul Stacey\s*$/ or
   raise RuntimeError, 'Error finding author name in chapter 1 -- ' + auth.content
 auth.before('<blockquote><attribution>Paul Stacey</attribution></blockquote>')
 auth.remove
 
+# FIXME the DTD do now allow this use of <attribution>
 auth = xml.css('chapter')[1].css('para')[0]
 auth.content =~ /^\s*Sarah Hinchliff Pearson.*$/ or
   raise RuntimeError, 'Error finding author name in chapter 2 -- ' + auth.content
@@ -213,6 +216,7 @@ xml.css('figure').each do |fig|
   seq = seq + 1
 end
 
+# FIXME the DTD do now allow this use of <attribution>
 log 0, 'Set epigraph line in each case study'
 xml.css('blockquote para').select {|p| p.inner_text =~ /Profile written by/}.each do |epi|
   p = epi.parent
-- 
2.47.2