diff options
| author | Tom Lane | 2020-04-12 18:03:24 +0000 |
|---|---|---|
| committer | Tom Lane | 2020-04-12 18:03:24 +0000 |
| commit | 88d934f0387a66ba372643913f99e845d0ea144a (patch) | |
| tree | 9f517164f9277b24fc43ac579d2631bf829236d5 /doc/src/sgml/postgres.sgml | |
| parent | dbc60c5593f26dc777a3be032bff4fb4eab1ddd1 (diff) | |
Doc: introduce and document "&zwsp;" for allowing optional line breaks.
We already had a couple of places using zero-width spaces for formatting
hackery, and we're going to need more if we ever want the PDF manuals to
look decent. But please let's not write hard-coded Unicode escapes.
We can avoid that by using a custom entity, which also provides a place
to put a teeny bit of documentation about what it is and how to use it.
I'd previously posted a patch using "&break;" for this, but on reflection
that would be horrible to grep for. Instead let's use "&zwsp;", based
on the name of the Unicode symbol ("zero width space").
Discussion: https://postgr.es/m/9326.1581457869@sss.pgh.pa.us
Diffstat (limited to 'doc/src/sgml/postgres.sgml')
| -rw-r--r-- | doc/src/sgml/postgres.sgml | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml index ba3d6261029..f4a3c7e5e7c 100644 --- a/doc/src/sgml/postgres.sgml +++ b/doc/src/sgml/postgres.sgml @@ -11,6 +11,13 @@ <!ENTITY reference SYSTEM "reference.sgml"> +<!-- +Zero-width space. Use this to allow line breaks at desirable places in +table cells, examples, etc. without causing an unwanted space when the +break is not needed in a wider output rendering. +--> +<!ENTITY zwsp "​"> + ]> <book id="postgres"> |