Add some post-processing to the man page generation to fix up external/

petere · petere · commit 10e5a759aab5 · 2005-01-04T21:03:30.000Z
dangling cross-references.
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.74 2004/11/23 21:41:24 petere Exp $
+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.75 2005/01/04 21:03:30 petere Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -69,10 +69,13 @@ override SPFLAGS += -wall -wno-unused-param -wno-empty
 
 DEFAULTSECTION := $(sqlmansect_dummy)
 
+fix_man_xrefs = $(PERL) -npi -e 's{\[XRef to GUC-([A-Z0-9-]*)\]}{($$l = $$1) =~ tr/A-Z-/a-z_/, $$l}ge || s{\[XRef to [A-Z0-9-]*\]}{the documentation}g'
+
 man: postgres.sgml $(ALLSGML)
 	$(NSGMLS) $(NSGMLS_FLAGS) $< | $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
 # One more time, to resolve cross-references
 	$(NSGMLS) $(NSGMLS_FLAGS) $< | $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
+	$(fix_man_xrefs) *.1 *.$(DEFAULTSECTION)
 	$(mkinstalldirs) man1 man$(DEFAULTSECTION)
 	mv *.1 man1/
 	mv *.$(DEFAULTSECTION) man$(DEFAULTSECTION)/

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.74 2004/11/23 21:41:24 petere Exp $`
	`5`	`+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.75 2005/01/04 21:03:30 petere Exp $`
`6`	`6`	`#`
`7`	`7`	`#----------------------------------------------------------------------------`
`8`	`8`
`@@ -69,10 +69,13 @@ override SPFLAGS += -wall -wno-unused-param -wno-empty`
`69`	`69`
`70`	`70`	`DEFAULTSECTION := $(sqlmansect_dummy)`
`71`	`71`
	`72`	`+fix_man_xrefs = $(PERL) -npi -e 's{\[XRef to GUC-([A-Z0-9-])\]}{($$l = $$1) =~ tr/A-Z-/a-z_/, $$l}ge \|\| s{\[XRef to [A-Z0-9-]\]}{the documentation}g'`
	`73`	`+`
`72`	`74`	`man: postgres.sgml $(ALLSGML)`
`73`	`75`	$(NSGMLS) $(NSGMLS_FLAGS) $< \| $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
`74`	`76`	`# One more time, to resolve cross-references`
`75`	`77`	$(NSGMLS) $(NSGMLS_FLAGS) $< \| $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
	`78`	`+ $(fix_man_xrefs) .1 .$(DEFAULTSECTION)`
`76`	`79`	`$(mkinstalldirs) man1 man$(DEFAULTSECTION)`
`77`	`80`	`mv *.1 man1/`
`78`	`81`	`mv *.$(DEFAULTSECTION) man$(DEFAULTSECTION)/`