Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit88d934f

Browse files
committed
Doc: introduce and document "&zwsp;" for allowing optional line breaks.
We already had a couple of places using zero-width spaces for formattinghackery, and we're going to need more if we ever want the PDF manuals tolook decent. But please let's not write hard-coded Unicode escapes.We can avoid that by using a custom entity, which also provides a placeto 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 reflectionthat would be horrible to grep for. Instead let's use "&zwsp;", basedon the name of the Unicode symbol ("zero width space").Discussion:https://postgr.es/m/9326.1581457869@sss.pgh.pa.us
1 parentdbc60c5 commit88d934f

File tree

2 files changed

+12
-5
lines changed

2 files changed

+12
-5
lines changed

‎doc/src/sgml/func.sgml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2981,7 +2981,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
29812981
the result written in hexadecimal
29822982
</entry>
29832983
<entry><literal>md5('Th\000omas'::bytea)</literal></entry>
2984-
<entry><literal>8ab2d3c9689aaf18&#x200B;b4958c334c82d8b1</literal></entry>
2984+
<entry><literal>8ab2d3c9689aaf18&zwsp;b4958c334c82d8b1</literal></entry>
29852985
</row>
29862986

29872987
<row>
@@ -3032,7 +3032,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
30323032
SHA-224 <link linkend="functions-hash-note">hash</link>
30333033
</entry>
30343034
<entry><literal>sha224('abc'::bytea)</literal></entry>
3035-
<entry><literal>\x23097d223405d8228642a477bda2&#x200B;55b32aadbce4bda0b3f7e36c9da7</literal></entry>
3035+
<entry><literal>\x23097d223405d8228642a477bda2&zwsp;55b32aadbce4bda0b3f7e36c9da7</literal></entry>
30363036
</row>
30373037

30383038
<row>
@@ -3047,7 +3047,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
30473047
SHA-256 <link linkend="functions-hash-note">hash</link>
30483048
</entry>
30493049
<entry><literal>sha256('abc'::bytea)</literal></entry>
3050-
<entry><literal>\xba7816bf8f01cfea414140de5dae2223&#x200B;b00361a396177a9cb410ff61f20015ad</literal></entry>
3050+
<entry><literal>\xba7816bf8f01cfea414140de5dae2223&zwsp;b00361a396177a9cb410ff61f20015ad</literal></entry>
30513051
</row>
30523052

30533053
<row>
@@ -3062,7 +3062,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
30623062
SHA-384 <link linkend="functions-hash-note">hash</link>
30633063
</entry>
30643064
<entry><literal>sha384('abc'::bytea)</literal></entry>
3065-
<entry><literal>\xcb00753f45a35e8bb5a03d699ac65007&#x200B;272c32ab0eded1631a8b605a43ff5bed&#x200B;8086072ba1e7cc2358baeca134c825a7</literal></entry>
3065+
<entry><literal>\xcb00753f45a35e8bb5a03d699ac65007&zwsp;272c32ab0eded1631a8b605a43ff5bed&zwsp;8086072ba1e7cc2358baeca134c825a7</literal></entry>
30663066
</row>
30673067

30683068
<row>
@@ -3077,7 +3077,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
30773077
SHA-512 <link linkend="functions-hash-note">hash</link>
30783078
</entry>
30793079
<entry><literal>sha512('abc'::bytea)</literal></entry>
3080-
<entry><literal>\xddaf35a193617abacc417349ae204131&#x200B;12e6fa4e89a97ea20a9eeee64b55d39a&#x200B;2192992a274fc1a836ba3c23a3feebbd&#x200B;454d4423643ce80e2a9ac94fa54ca49f</literal></entry>
3080+
<entry><literal>\xddaf35a193617abacc417349ae204131&zwsp;12e6fa4e89a97ea20a9eeee64b55d39a&zwsp;2192992a274fc1a836ba3c23a3feebbd&zwsp;454d4423643ce80e2a9ac94fa54ca49f</literal></entry>
30813081
</row>
30823082

30833083
<row>

‎doc/src/sgml/postgres.sgml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,13 @@
1111

1212
<!ENTITY reference SYSTEM "reference.sgml">
1313

14+
<!--
15+
Zero-width space. Use this to allow line breaks at desirable places in
16+
table cells, examples, etc. without causing an unwanted space when the
17+
break is not needed in a wider output rendering.
18+
-->
19+
<!ENTITY zwsp "&#x200B;">
20+
1421
]>
1522

1623
<book id="postgres">

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp