PDF manual from dblatex renders fancy quotes for programlisting

[Mike Taves]

As ​described in this Q/A, parts of the PostGIS manual e.g. ​ST_MLineFromText define an example like this within programlisting:

<programlisting>SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');</programlisting>

which renders fine for HTML outputs, however the PDF rendering via dblatex on ​page 29 shows:

SELECT ST_MLineFromText(’MULTILINESTRING((1 2, 3 4), (4 5, 6 7))’);

which has fancy, but bad quotes. Straight quotes need to be preserved in the programlisting environment. The PostgreSQL PDF manual does not have this issue.

Possible fixes are to use the "-s latex_style, —texstyle=latex_style" ​option for dblatex in the doc/Makefile.in, which would reference a static customized LaTeX style file that may modify how LaTeX handles these characters (e.g. ​this or other method).

[Mike Taves]

See fix here: ​https://github.com/postgis/postgis/pull/128

dblatex uses the ​listings LaTeX package, so the fix was to set the option upquote=true

[robe]

In 15365:

PDF manual from dblatex renders fancy quotes for programlisting
Change to use regular quotes
patch from Mike Toews
References #3726 for PostGIS 2.3

[Mike Taves]

Almost there, you need to also add the doc/texstyle.sty file too.

[Mike Taves]

… nevermind, it was there … thanks!

[robe]

In 15366:

PDF manual from dblatex renders fancy quotes for programlisting
Change to use regular quotes
patch from Mike Toews
Closes #3726 for PostGIS 2.4 (trunk)

[Mike Taves]

In [15366] it seems you copied astyle (a copy of astyle.sh) instead of doc/texstyle.sty

[robe]

In 15373:

Revert committ of astyle and commit the intended textstyle.sty
References #3726 for PostGIS 2.4 trunk