Commit96b8b8b

committed

Create INSTALL file using Pandoc

Replace using lynx with using pandoc. Pandoc creates better lookingoutput and it avoids the delicate locale/encoding issues of lynx becauseit always uses UTF-8 for both input and output.Note: requires Pandoc >=1.13Discussion:https://www.postgresql.org/message-id/flat/dcfaa74d-8037-bb32-f9e0-3fea7ccf4551@2ndquadrant.com/Reviewed-by: Mi Tar <mmitar@gmail.com>

1 parentff85306 commit96b8b8bCopy full SHA for 96b8b8b

File tree

-12

lines changed

-12

lines changed

Lines changed: 3 additions & 11 deletions

Original file line number	Diff line number	Diff line change
`@@ -100,18 +100,10 @@ errcodes-table.sgml: $(top_srcdir)/src/backend/utils/errcodes.txt generate-errco`
`100`	`100`	`##`
`101`	`101`
`102`	`102`	`ICONV = iconv`
`103`		`-LYNX = lynx`
`104`		`-`
`105`		`-# The documentation may contain non-ASCII characters (mostly for`
`106`		`-# contributor names), which lynx converts to the encoding determined`
`107`		`-# by the current locale. To get text output that is deterministic and`
`108`		`-# easily readable by everyone, we make lynx produce LATIN1 and then`
`109`		`-# convert that to ASCII with transliteration for the non-ASCII characters.`
`110`		`-# Official releases were historically built on FreeBSD, which has limited`
`111`		`-# locale support and is very picky about locale name spelling. The`
`112`		`-# below has been finely tuned to run on FreeBSD and Linux/glibc.`
	`103`	`+PANDOC = pandoc`
	`104`	`+`
`113`	`105`	`INSTALL:% :%.html`
`114`		`-$(PERL) -p -e's,<h(1\|2),<h\1 align=center,g'$<\| LC_ALL=en_US.ISO8859-1$(LYNX) -force_html -dump -nolist -stdin\|$(ICONV) -flatin1 -t us-ascii//TRANSLIT>$@`
	`106`	`+$(PANDOC)$<-t plain\|$(ICONV) -futf8 -t us-ascii//TRANSLIT>$@`
`115`	`107`
`116`	`108`	`INSTALL.html:%.html : stylesheet-text.xsl%.xml`
`117`	`109`	`$(XMLLINT) --noout --valid$*.xml`

Lines changed: 3 additions & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -358,7 +358,9 @@ ADDITIONAL_FLAGS='-Xmx1500m'`
`358`	`358`	`corresponds to <xref linkend="installation"/>, with some minor`
`359`	`359`	`changes to account for the different context. To recreate the`
`360`	`360`	`file, change to the directory <filename>doc/src/sgml</filename>`
`361`		`- and enter <userinput>make INSTALL</userinput>.`
	`361`	`+ and enter <userinput>make INSTALL</userinput>. Building text output`
	`362`	`+ requires <productname>Pandoc</productname> version 1.13 or newer as an`
	`363`	`+ additional build tool.`
`362`	`364`	`</para>`
`363`	`365`
`364`	`366`	`<para>`

Comments

(0)