Document DTD breaking parts of fixup-docbook.rb.

diff --git a/fixup-docbook.rb b/fixup-docbook.rb
index 0c99fc45b10d4a39200471f83642f3f03fba201c..d7411badd42b87e31711ddf7c8797f8211f487a2 100755 (executable)
--- 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