Add a note about how to check for bare < and & in SGML docs, before the

tglsfdc · tglsfdc · commit d5d552fa0104 · 2008-10-04T02:19:08.000Z
knowledge disappears again.
diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile
@@ -2,7 +2,7 @@
 #
 # PostgreSQL documentation makefile
 #
-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.107 2008/08/25 15:34:05 alvherre Exp $
+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.108 2008/10/04 02:19:08 tgl Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -53,6 +53,9 @@ endif
 # Enable some extra warnings
 # -wfully-tagged needed to throw a warning on missing tags 
 # for older tool chains, 2007-08-31
+# Note: try "make SPFLAGS=-wxml" to catch a lot of other dubious constructs,
+# in particular < and & that haven't been made into entities.  It's far too
+# noisy to turn on by default, unfortunately.
 override SPFLAGS += -wall -wno-unused-param -wno-empty -wfully-tagged
 
 ##

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`	`#`
`3`	`3`	`# PostgreSQL documentation makefile`
`4`	`4`	`#`
`5`		`-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.107 2008/08/25 15:34:05 alvherre Exp $`
	`5`	`+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.108 2008/10/04 02:19:08 tgl Exp $`
`6`	`6`	`#`
`7`	`7`	`#----------------------------------------------------------------------------`
`8`	`8`
`@@ -53,6 +53,9 @@ endif`
`53`	`53`	`# Enable some extra warnings`
`54`	`54`	`# -wfully-tagged needed to throw a warning on missing tags`
`55`	`55`	`# for older tool chains, 2007-08-31`
	`56`	`+# Note: try "make SPFLAGS=-wxml" to catch a lot of other dubious constructs,`
	`57`	`+# in particular < and & that haven't been made into entities. It's far too`
	`58`	`+# noisy to turn on by default, unfortunately.`
`56`	`59`	`override SPFLAGS += -wall -wno-unused-param -wno-empty -wfully-tagged`
`57`	`60`
`58`	`61`	`##`