From: Bruce Momjian Date: Sat, 3 May 2025 18:45:26 +0000 (-0400) Subject: doc: update guidelines on non-ASCII characters in docs X-Git-Tag: REL_18_BETA1~14 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=fb21ed6c38da719149443e78048790c0347e2c9b;p=thirdparty%2Fpostgresql.git doc: update guidelines on non-ASCII characters in docs --- diff --git a/doc/src/sgml/README.non-ASCII b/doc/src/sgml/README.non-ASCII index 9c21e02e8f2..e9065a33ad6 100644 --- a/doc/src/sgml/README.non-ASCII +++ b/doc/src/sgml/README.non-ASCII @@ -22,13 +22,14 @@ others only support Latin-1 characters. Specifically, the PDF rendering engine can only display Latin-1 characters; non-Latin-1 Unicode characters are displayed as "###". -Therefore, in the SGML files, we only use Latin-1 characters. We -typically encode these characters as HTML entities, e.g., Álvaro. -It is also possible to safely represent Latin-1 characters in UTF8 -encoding for all output formats. +Therefore, in the SGML files, we can only use Latin-1 characters. We +can use UTF8 representations of Latin-1 characters, or HTML entities of +Latin-1 characters, e.g., Álvaro. Do not use UTF numeric character escapes (&#nnn;). +When building the PDF docs, problem characters will appear as warnings. + HTML entities official: http://www.w3.org/TR/html4/sgml/entities.html one page: http://www.zipcon.net/~swhite/docs/computers/browsers/entities_page.html