Fix translation of special characters in psql's LaTeX output modes.
authorTom Lane <[email protected]>
Mon, 26 Nov 2018 22:32:51 +0000 (17:32 -0500)
committerTom Lane <[email protected]>
Mon, 26 Nov 2018 22:32:51 +0000 (17:32 -0500)
latex_escaped_print() mistranslated \ and failed to provide any translation
for # ^ and ~, all of which would typically lead to LaTeX document syntax
errors.  In addition it didn't translate < > and |, which would typically
render as unexpected characters.

To some extent this represents shortcomings in ancient versions of LaTeX,
which if memory serves had no easy way to render these control characters
as ASCII text.  But that's been fixed for, um, decades.  In any case there
is no value in emitting guaranteed-to-fail output for these characters.

Noted while fooling with test cases added by commit 9a98984f4.  Back-patch
the code change to all supported versions.

src/fe_utils/print.c

index cb9a9a06131931dbb23809ec2ea9d9f6a908fae1..22f67710d2ac43a92b9e47ade7b75c40e352de61 100644 (file)
@@ -2187,14 +2187,34 @@ latex_escaped_print(const char *in, FILE *fout)
        for (p = in; *p; p++)
                switch (*p)
                {
-                       case '&':
-                               fputs("\\&", fout);
+                               /*
+                                * We convert ASCII characters per the recommendations in
+                                * Scott Pakin's "The Comprehensive LATEX Symbol List",
+                                * available from CTAN.  For non-ASCII, you're on your own.
+                                */
+                       case '#':
+                               fputs("\\#", fout);
+                               break;
+                       case '$':
+                               fputs("\\$", fout);
                                break;
                        case '%':
                                fputs("\\%", fout);
                                break;
-                       case '$':
-                               fputs("\\$", fout);
+                       case '&':
+                               fputs("\\&", fout);
+                               break;
+                       case '<':
+                               fputs("\\textless{}", fout);
+                               break;
+                       case '>':
+                               fputs("\\textgreater{}", fout);
+                               break;
+                       case '\\':
+                               fputs("\\textbackslash{}", fout);
+                               break;
+                       case '^':
+                               fputs("\\^{}", fout);
                                break;
                        case '_':
                                fputs("\\_", fout);
@@ -2202,13 +2222,17 @@ latex_escaped_print(const char *in, FILE *fout)
                        case '{':
                                fputs("\\{", fout);
                                break;
+                       case '|':
+                               fputs("\\textbar{}", fout);
+                               break;
                        case '}':
                                fputs("\\}", fout);
                                break;
-                       case '\\':
-                               fputs("\\backslash", fout);
+                       case '~':
+                               fputs("\\~{}", fout);
                                break;
                        case '\n':
+                               /* This is not right, but doing it right seems too hard */
                                fputs("\\\\", fout);
                                break;
                        default: