Here is a patch to make more use of – and — in the docs, instead of the plain ASCII "-". I think this is nicer to read in some cases and in other cases makes the appearance consistent with the text generated by the DocBook stylesheets (see for example mdash use in the TOC for the SQL commands).
-- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
From 953847e5d5ead9987e29817c75a2a6ae990befd7 Mon Sep 17 00:00:00 2001 From: Peter Eisentraut <pe...@eisentraut.org> Date: Sat, 19 Oct 2019 18:43:18 +0200 Subject: [PATCH] doc: Use proper em and en dashes --- doc/src/sgml/biblio.sgml | 6 +-- doc/src/sgml/bki.sgml | 4 +- doc/src/sgml/brin.sgml | 2 +- doc/src/sgml/catalogs.sgml | 2 +- doc/src/sgml/charset.sgml | 32 ++++++------- doc/src/sgml/datetime.sgml | 6 +-- doc/src/sgml/ecpg.sgml | 36 +++++++------- doc/src/sgml/func.sgml | 68 +++++++++++++-------------- doc/src/sgml/high-availability.sgml | 28 +++++------ doc/src/sgml/history.sgml | 2 +- doc/src/sgml/isn.sgml | 2 +- doc/src/sgml/legal.sgml | 6 +-- doc/src/sgml/libpq.sgml | 2 +- doc/src/sgml/planstats.sgml | 2 +- doc/src/sgml/plperl.sgml | 2 +- doc/src/sgml/plpgsql.sgml | 2 +- doc/src/sgml/plpython.sgml | 2 +- doc/src/sgml/pltcl.sgml | 2 +- doc/src/sgml/ref/alter_table.sgml | 4 +- doc/src/sgml/ref/copy.sgml | 4 +- doc/src/sgml/ref/create_sequence.sgml | 2 +- doc/src/sgml/ref/create_table.sgml | 2 +- doc/src/sgml/syntax.sgml | 6 +-- doc/src/sgml/textsearch.sgml | 2 +- 24 files changed, 112 insertions(+), 114 deletions(-) diff --git a/doc/src/sgml/biblio.sgml b/doc/src/sgml/biblio.sgml index bf3aebd2a8..b40c06eb38 100644 --- a/doc/src/sgml/biblio.sgml +++ b/doc/src/sgml/biblio.sgml @@ -309,7 +309,7 @@ <title>ERL Technical Memorandum M90/33</title> </biblioset> <confgroup> <conftitle>Eleventh International Conference on Data Engineering</conftitle> - <confdates>6-10 March 1995</confdates> + <confdates>6–10 March 1995</confdates> <address>Taipeh, Taiwan</address> </confgroup> <pubsnumber>Cat. No.95CH35724</pubsnumber> @@ -318,7 +318,7 @@ <title>ERL Technical Memorandum M90/33</title> <address>Los Alamitos, California</address> </publisher> <pubdate>1995</pubdate> - <pagenums>420-7</pagenums> + <pagenums>420–7</pagenums> </biblioentry> <biblioentry id="ston86"> @@ -427,7 +427,7 @@ <title>SIGMOD Record 18(3)</title> <biblioset relation="journal"> <title>SIGMOD Record 18(4)</title> <date>Dec. 1989</date> - <pagenums>4-11</pagenums> + <pagenums>4–11</pagenums> </biblioset> </biblioentry> diff --git a/doc/src/sgml/bki.sgml b/doc/src/sgml/bki.sgml index 6523dd5032..6776c4a3c1 100644 --- a/doc/src/sgml/bki.sgml +++ b/doc/src/sgml/bki.sgml @@ -385,8 +385,8 @@ <title>OID Assignment</title> To find an available OID for a new pre-loaded row, run the script <filename>src/include/catalog/unused_oids</filename>. It prints inclusive ranges of unused OIDs (e.g., the output - line <quote>45-900</quote> means OIDs 45 through 900 have not been - allocated yet). Currently, OIDs 1-9999 are reserved for manual + line <literal>45-900</literal> means OIDs 45 through 900 have not been + allocated yet). Currently, OIDs 1–9999 are reserved for manual assignment; the <filename>unused_oids</filename> script simply looks through the catalog headers and <filename>.dat</filename> files to see which ones do not appear. You can also use diff --git a/doc/src/sgml/brin.sgml b/doc/src/sgml/brin.sgml index da0c911153..176f1cfbd0 100644 --- a/doc/src/sgml/brin.sgml +++ b/doc/src/sgml/brin.sgml @@ -781,7 +781,7 @@ <title>Function and Support Numbers for Inclusion Operator Classes</title> </table> <para> - Support function numbers 1-10 are reserved for the BRIN internal + Support function numbers 1 through 10 are reserved for the BRIN internal functions, so the SQL level functions start with number 11. Support function number 11 is the main function required to build the index. It should accept two arguments with the same data type as the operator class, diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 520d3198b5..55694c4368 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -9883,7 +9883,7 @@ <title><structname>pg_replication_slots</structname> Columns</title> <entry><structfield>slot_type</structfield></entry> <entry><type>text</type></entry> <entry></entry> - <entry>The slot type - <literal>physical</literal> or <literal>logical</literal></entry> + <entry>The slot type: <literal>physical</literal> or <literal>logical</literal></entry> </row> <row> diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index 45290bd27b..55669b5cad 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -1004,7 +1004,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Traditional Chinese</entry> <entry>No</entry> <entry>No</entry> - <entry>1-2</entry> + <entry>1–2</entry> <entry><literal>WIN950</literal>, <literal>Windows950</literal></entry> </row> <row> @@ -1013,7 +1013,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Simplified Chinese</entry> <entry>Yes</entry> <entry>Yes</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1022,7 +1022,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Japanese</entry> <entry>Yes</entry> <entry>Yes</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1031,7 +1031,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Japanese</entry> <entry>Yes</entry> <entry>No</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1040,7 +1040,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Korean</entry> <entry>Yes</entry> <entry>Yes</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1049,7 +1049,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Traditional Chinese, Taiwanese</entry> <entry>Yes</entry> <entry>Yes</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1058,7 +1058,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Chinese</entry> <entry>No</entry> <entry>No</entry> - <entry>1-4</entry> + <entry>1–4</entry> <entry></entry> </row> <row> @@ -1067,7 +1067,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Simplified Chinese</entry> <entry>No</entry> <entry>No</entry> - <entry>1-2</entry> + <entry>1–2</entry> <entry><literal>WIN936</literal>, <literal>Windows936</literal></entry> </row> <row> @@ -1112,7 +1112,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Korean (Hangul)</entry> <entry>No</entry> <entry>No</entry> - <entry>1-3</entry> + <entry>1–3</entry> <entry></entry> </row> <row> @@ -1229,7 +1229,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Multilingual Emacs</entry> <entry>Yes</entry> <entry>No</entry> - <entry>1-4</entry> + <entry>1–4</entry> <entry></entry> </row> <row> @@ -1238,7 +1238,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Japanese</entry> <entry>No</entry> <entry>No</entry> - <entry>1-2</entry> + <entry>1–2</entry> <entry><literal>Mskanji</literal>, <literal>ShiftJIS</literal>, <literal>WIN932</literal>, <literal>Windows932</literal></entry> </row> <row> @@ -1247,7 +1247,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Japanese</entry> <entry>No</entry> <entry>No</entry> - <entry>1-2</entry> + <entry>1–2</entry> <entry></entry> </row> <row> @@ -1265,7 +1265,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry>Korean</entry> <entry>No</entry> <entry>No</entry> - <entry>1-2</entry> + <entry>1–2</entry> <entry><literal>WIN949</literal>, <literal>Windows949</literal></entry> </row> <row> @@ -1274,7 +1274,7 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <entry><emphasis>all</emphasis></entry> <entry>Yes</entry> <entry>Yes</entry> - <entry>1-4</entry> + <entry>1–4</entry> <entry><literal>Unicode</literal></entry> </row> <row> @@ -1390,8 +1390,8 @@ <title><productname>PostgreSQL</productname> Character Sets</title> <para> The <literal>SQL_ASCII</literal> setting behaves considerably differently from the other settings. When the server character set is - <literal>SQL_ASCII</literal>, the server interprets byte values 0-127 - according to the ASCII standard, while byte values 128-255 are taken + <literal>SQL_ASCII</literal>, the server interprets byte values 0–127 + according to the ASCII standard, while byte values 128–255 are taken as uninterpreted characters. No encoding conversion will be done when the setting is <literal>SQL_ASCII</literal>. Thus, this setting is not so much a declaration that a specific encoding is in use, as a declaration diff --git a/doc/src/sgml/datetime.sgml b/doc/src/sgml/datetime.sgml index 23561b19c9..7cce826e2d 100644 --- a/doc/src/sgml/datetime.sgml +++ b/doc/src/sgml/datetime.sgml @@ -167,7 +167,7 @@ <title>Date/Time Input Interpretation</title> <tip> <para> - Gregorian years AD 1-99 can be entered by using 4 digits with leading + Gregorian years AD 1–99 can be entered by using 4 digits with leading zeros (e.g., <literal>0099</literal> is AD 99). </para> </tip> @@ -671,9 +671,9 @@ <title>History of Units</title> calendar, unrelated to the Julian calendar though it is confusingly named similarly to that calendar. The Julian Date system was invented by the French scholar - Joseph Justus Scaliger (1540-1609) + Joseph Justus Scaliger (1540–1609) and probably takes its name from Scaliger's father, - the Italian scholar Julius Caesar Scaliger (1484-1558). + the Italian scholar Julius Caesar Scaliger (1484–1558). In the Julian Date system, each day has a sequential number, starting from JD 0 (which is sometimes called <emphasis>the</emphasis> Julian Date). JD 0 corresponds to 1 January 4713 BC in the Julian calendar, or diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml index d225eb3c20..8fe2a90c48 100644 --- a/doc/src/sgml/ecpg.sgml +++ b/doc/src/sgml/ecpg.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/ecpg.sgml --> <chapter id="ecpg"> - <title><application>ECPG</application> - Embedded <acronym>SQL</acronym> in C</title> + <title><application>ECPG</application> — Embedded <acronym>SQL</acronym> in C</title> <indexterm zone="ecpg"><primary>embedded SQL</primary><secondary>in C</secondary></indexterm> <indexterm zone="ecpg"><primary>C</primary></indexterm> @@ -2989,7 +2989,7 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%d</literal> - is replaced by the day of the month as a - decimal number (01-31). + decimal number (01–31). </para> </listitem> <listitem> @@ -3025,7 +3025,7 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%e</literal> - is replaced by the day of month as a decimal - number (1-31); single digits are preceded by a blank. + number (1–31); single digits are preceded by a blank. </para> </listitem> <listitem> @@ -3044,13 +3044,13 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <para> <literal>%g</literal> - is replaced by the same year as in <literal>%G</literal>, but as a decimal number without century - (00-99). + (00–99). </para> </listitem> <listitem> <para> <literal>%H</literal> - is replaced by the hour (24-hour clock) as a - decimal number (00-23). + decimal number (00–23). </para> </listitem> <listitem> @@ -3061,37 +3061,37 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%I</literal> - is replaced by the hour (12-hour clock) as a - decimal number (01-12). + decimal number (01–12). </para> </listitem> <listitem> <para> <literal>%j</literal> - is replaced by the day of the year as a - decimal number (001-366). + decimal number (001–366). </para> </listitem> <listitem> <para> <literal>%k</literal> - is replaced by the hour (24-hour clock) as a - decimal number (0-23); single digits are preceded by a blank. + decimal number (0–23); single digits are preceded by a blank. </para> </listitem> <listitem> <para> <literal>%l</literal> - is replaced by the hour (12-hour clock) as a - decimal number (1-12); single digits are preceded by a blank. + decimal number (1–12); single digits are preceded by a blank. </para> </listitem> <listitem> <para> <literal>%M</literal> - is replaced by the minute as a decimal - number (00-59). + number (00–59). </para> </listitem> <listitem> <para> <literal>%m</literal> - is replaced by the month as a decimal number - (01-12). + (01–12). </para> </listitem> <listitem> @@ -3124,7 +3124,7 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%S</literal> - is replaced by the second as a decimal - number (00-60). + number (00–60). </para> </listitem> <listitem> @@ -3146,19 +3146,19 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%U</literal> - is replaced by the week number of the year - (Sunday as the first day of the week) as a decimal number (00-53). + (Sunday as the first day of the week) as a decimal number (00–53). </para> </listitem> <listitem> <para> <literal>%u</literal> - is replaced by the weekday (Monday as the - first day of the week) as a decimal number (1-7). + first day of the week) as a decimal number (1–7). </para> </listitem> <listitem> <para> <literal>%V</literal> - is replaced by the week number of the year - (Monday as the first day of the week) as a decimal number (01-53). + (Monday as the first day of the week) as a decimal number (01–53). If the week containing January 1 has four or more days in the new year, then it is week 1; otherwise it is the last week of the previous year, and the next week is week 1. @@ -3173,13 +3173,13 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%W</literal> - is replaced by the week number of the year - (Monday as the first day of the week) as a decimal number (00-53). + (Monday as the first day of the week) as a decimal number (00–53). </para> </listitem> <listitem> <para> <literal>%w</literal> - is replaced by the weekday (Sunday as the - first day of the week) as a decimal number (0-6). + first day of the week) as a decimal number (0–6). </para> </listitem> <listitem> @@ -3203,7 +3203,7 @@ <title>Valid Input Formats for <function>PGTYPEStimestamp_from_asc</function></t <listitem> <para> <literal>%y</literal> - is replaced by the year without century as a - decimal number (00-99). + decimal number (00–99). </para> </listitem> <listitem> diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index 0aa399dc2f..28eb322f3f 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -5331,7 +5331,7 @@ <title>Regular Expression Character-Entry Escapes</title> <para> Numeric character-entry escapes specifying values outside the ASCII range - (0-127) have meanings dependent on the database encoding. When the + (0–127) have meanings dependent on the database encoding. When the encoding is UTF-8, escape values are equivalent to Unicode code points, for example <literal>\u1234</literal> means the character <literal>U+1234</literal>. For other multibyte encodings, character-entry escapes usually just @@ -6263,59 +6263,59 @@ <title>Template Patterns for Date/Time Formatting</title> <tbody> <row> <entry><literal>HH</literal></entry> - <entry>hour of day (01-12)</entry> + <entry>hour of day (01–12)</entry> </row> <row> <entry><literal>HH12</literal></entry> - <entry>hour of day (01-12)</entry> + <entry>hour of day (01–12)</entry> </row> <row> <entry><literal>HH24</literal></entry> - <entry>hour of day (00-23)</entry> + <entry>hour of day (00–23)</entry> </row> <row> <entry><literal>MI</literal></entry> - <entry>minute (00-59)</entry> + <entry>minute (00–59)</entry> </row> <row> <entry><literal>SS</literal></entry> - <entry>second (00-59)</entry> + <entry>second (00–59)</entry> </row> <row> <entry><literal>MS</literal></entry> - <entry>millisecond (000-999)</entry> + <entry>millisecond (000–999)</entry> </row> <row> <entry><literal>US</literal></entry> - <entry>microsecond (000000-999999)</entry> + <entry>microsecond (000000–999999)</entry> </row> <row> <entry><literal>FF1</literal></entry> - <entry>tenth of second (0-9)</entry> + <entry>tenth of second (0–9)</entry> </row> <row> <entry><literal>FF2</literal></entry> - <entry>hundredth of second (00-99)</entry> + <entry>hundredth of second (00–99)</entry> </row> <row> <entry><literal>FF3</literal></entry> - <entry>millisecond (000-999)</entry> + <entry>millisecond (000–999)</entry> </row> <row> <entry><literal>FF4</literal></entry> - <entry>tenth of a millisecond (0000-9999)</entry> + <entry>tenth of a millisecond (0000–9999)</entry> </row> <row> <entry><literal>FF5</literal></entry> - <entry>hundredth of a millisecond (00000-99999)</entry> + <entry>hundredth of a millisecond (00000–99999)</entry> </row> <row> <entry><literal>FF6</literal></entry> - <entry>microsecond (000000-999999)</entry> + <entry>microsecond (000000–999999)</entry> </row> <row> <entry><literal>SSSS</literal>, <literal>SSSSS</literal></entry> - <entry>seconds past midnight (0-86399)</entry> + <entry>seconds past midnight (0–86399)</entry> </row> <row> <entry><literal>AM</literal>, <literal>am</literal>, @@ -6399,7 +6399,7 @@ <title>Template Patterns for Date/Time Formatting</title> </row> <row> <entry><literal>MM</literal></entry> - <entry>month number (01-12)</entry> + <entry>month number (01–12)</entry> </row> <row> <entry><literal>DAY</literal></entry> @@ -6427,15 +6427,15 @@ <title>Template Patterns for Date/Time Formatting</title> </row> <row> <entry><literal>DDD</literal></entry> - <entry>day of year (001-366)</entry> + <entry>day of year (001–366)</entry> </row> <row> <entry><literal>IDDD</literal></entry> - <entry>day of ISO 8601 week-numbering year (001-371; day 1 of the year is Monday of the first ISO week)</entry> + <entry>day of ISO 8601 week-numbering year (001–371; day 1 of the year is Monday of the first ISO week)</entry> </row> <row> <entry><literal>DD</literal></entry> - <entry>day of month (01-31)</entry> + <entry>day of month (01–31)</entry> </row> <row> <entry><literal>D</literal></entry> @@ -6447,15 +6447,15 @@ <title>Template Patterns for Date/Time Formatting</title> </row> <row> <entry><literal>W</literal></entry> - <entry>week of month (1-5) (the first week starts on the first day of the month)</entry> + <entry>week of month (1–5) (the first week starts on the first day of the month)</entry> </row> <row> <entry><literal>WW</literal></entry> - <entry>week number of year (1-53) (the first week starts on the first day of the year)</entry> + <entry>week number of year (1–53) (the first week starts on the first day of the year)</entry> </row> <row> <entry><literal>IW</literal></entry> - <entry>week number of ISO 8601 week-numbering year (01-53; the first Thursday of the year is in week 1)</entry> + <entry>week number of ISO 8601 week-numbering year (01–53; the first Thursday of the year is in week 1)</entry> </row> <row> <entry><literal>CC</literal></entry> @@ -6471,11 +6471,11 @@ <title>Template Patterns for Date/Time Formatting</title> </row> <row> <entry><literal>RM</literal></entry> - <entry>month in upper case Roman numerals (I-XII; I=January)</entry> + <entry>month in upper case Roman numerals (I–XII; I=January)</entry> </row> <row> <entry><literal>rm</literal></entry> - <entry>month in lower case Roman numerals (i-xii; i=January)</entry> + <entry>month in lower case Roman numerals (i–xii; i=January)</entry> </row> <row> <entry><literal>TZ</literal></entry> @@ -8006,7 +8006,7 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <listitem> <para> For <type>timestamp</type> values, the day (of the month) field - (1 - 31) ; for <type>interval</type> values, the number of days + (1–31) ; for <type>interval</type> values, the number of days </para> <screen> @@ -8017,8 +8017,6 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <lineannotation>Result: </lineannotation><computeroutput>40</computeroutput> </screen> - - </listitem> </varlistentry> @@ -8061,7 +8059,7 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <term><literal>doy</literal></term> <listitem> <para> - The day of the year (1 - 365/366) + The day of the year (1–365/366) </para> <screen> @@ -8106,7 +8104,7 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <term><literal>hour</literal></term> <listitem> <para> - The hour field (0 - 23) + The hour field (0–23) </para> <screen> @@ -8217,7 +8215,7 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <term><literal>minute</literal></term> <listitem> <para> - The minutes field (0 - 59) + The minutes field (0–59) </para> <screen> @@ -8232,8 +8230,8 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <listitem> <para> For <type>timestamp</type> values, the number of the month - within the year (1 - 12) ; for <type>interval</type> values, - the number of months, modulo 12 (0 - 11) + within the year (1–12) ; for <type>interval</type> values, + the number of months, modulo 12 (0–11) </para> <screen> @@ -8253,7 +8251,7 @@ <title><function>EXTRACT</function>, <function>date_part</function></title> <term><literal>quarter</literal></term> <listitem> <para> - The quarter of the year (1 - 4) that the date is in + The quarter of the year (1–4) that the date is in </para> <screen> @@ -17541,7 +17539,7 @@ <title>Session Information Functions</title> <row> <entry><literal><function>pg_notification_queue_usage()</function></literal></entry> <entry><type>double</type></entry> - <entry>fraction of the asynchronous notification queue currently occupied (0-1)</entry> + <entry>fraction of the asynchronous notification queue currently occupied (0–1)</entry> </row> <row> @@ -17827,7 +17825,7 @@ <title>Session Information Functions</title> to. <function>pg_notification_queue_usage</function> returns the fraction of the total available space for notifications currently occupied by notifications that are waiting to be processed, as a - <type>double</type> in the range 0-1. + <type>double</type> in the range 0–1. See <xref linkend="sql-listen"/> and <xref linkend="sql-notify"/> for more information. </para> diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml index a42541f420..bc4d98fe03 100644 --- a/doc/src/sgml/high-availability.sgml +++ b/doc/src/sgml/high-availability.sgml @@ -1715,22 +1715,22 @@ <title>User's Overview</title> <itemizedlist> <listitem> <para> - Query access - <command>SELECT</command>, <command>COPY TO</command> + Query access: <command>SELECT</command>, <command>COPY TO</command> </para> </listitem> <listitem> <para> - Cursor commands - <command>DECLARE</command>, <command>FETCH</command>, <command>CLOSE</command> + Cursor commands: <command>DECLARE</command>, <command>FETCH</command>, <command>CLOSE</command> </para> </listitem> <listitem> <para> - Parameters - <command>SHOW</command>, <command>SET</command>, <command>RESET</command> + Settings: <command>SHOW</command>, <command>SET</command>, <command>RESET</command> </para> </listitem> <listitem> <para> - Transaction management commands + Transaction management commands: <itemizedlist> <listitem> <para> @@ -1758,13 +1758,13 @@ <title>User's Overview</title> </listitem> <listitem> <para> - Plans and resources - <command>PREPARE</command>, <command>EXECUTE</command>, + Plans and resources: <command>PREPARE</command>, <command>EXECUTE</command>, <command>DEALLOCATE</command>, <command>DISCARD</command> </para> </listitem> <listitem> <para> - Plugins and extensions - <command>LOAD</command> + Plugins and extensions: <command>LOAD</command> </para> </listitem> <listitem> @@ -1783,7 +1783,7 @@ <title>User's Overview</title> <itemizedlist> <listitem> <para> - Data Manipulation Language (DML) - <command>INSERT</command>, + Data Manipulation Language (DML): <command>INSERT</command>, <command>UPDATE</command>, <command>DELETE</command>, <command>COPY FROM</command>, <command>TRUNCATE</command>. Note that there are no allowed actions that result in a trigger @@ -1795,7 +1795,7 @@ <title>User's Overview</title> </listitem> <listitem> <para> - Data Definition Language (DDL) - <command>CREATE</command>, + Data Definition Language (DDL): <command>CREATE</command>, <command>DROP</command>, <command>ALTER</command>, <command>COMMENT</command>. This restriction applies even to temporary tables, because carrying out these operations would require updating the system catalog tables. @@ -1848,7 +1848,7 @@ <title>User's Overview</title> </listitem> <listitem> <para> - Two-phase commit commands - <command>PREPARE TRANSACTION</command>, + Two-phase commit commands: <command>PREPARE TRANSACTION</command>, <command>COMMIT PREPARED</command>, <command>ROLLBACK PREPARED</command> because even read-only transactions need to write WAL in the prepare phase (the first phase of two phase commit). @@ -1856,7 +1856,7 @@ <title>User's Overview</title> </listitem> <listitem> <para> - Sequence updates - <function>nextval()</function>, <function>setval()</function> + Sequence updates: <function>nextval()</function>, <function>setval()</function> </para> </listitem> <listitem> @@ -2223,18 +2223,18 @@ <title>Administrator's Overview</title> <itemizedlist> <listitem> <para> - Data Definition Language (DDL) - e.g. <command>CREATE INDEX</command> + Data Definition Language (DDL): e.g. <command>CREATE INDEX</command> </para> </listitem> <listitem> <para> - Privilege and Ownership - <command>GRANT</command>, <command>REVOKE</command>, + Privilege and Ownership: <command>GRANT</command>, <command>REVOKE</command>, <command>REASSIGN</command> </para> </listitem> <listitem> <para> - Maintenance commands - <command>ANALYZE</command>, <command>VACUUM</command>, + Maintenance commands: <command>ANALYZE</command>, <command>VACUUM</command>, <command>CLUSTER</command>, <command>REINDEX</command> </para> </listitem> @@ -2351,7 +2351,7 @@ <title>Administrator's Overview</title> <para> In normal (non-recovery) mode, if you issue <command>DROP USER</command> or <command>DROP ROLE</command> for a role with login capability while that user is still connected then - nothing happens to the connected user - they remain connected. The user cannot + nothing happens to the connected user — they remain connected. The user cannot reconnect however. This behavior applies in recovery also, so a <command>DROP USER</command> on the primary does not disconnect that user on the standby. </para> diff --git a/doc/src/sgml/history.sgml b/doc/src/sgml/history.sgml index 180695afd9..aa171823a8 100644 --- a/doc/src/sgml/history.sgml +++ b/doc/src/sgml/history.sgml @@ -106,7 +106,7 @@ <title><productname>Postgres95</productname></title> and trimmed in size by 25%. Many internal changes improved performance and maintainability. <productname>Postgres95</productname> release - 1.0.x ran about 30-50% faster on the Wisconsin Benchmark compared + 1.0.x ran about 30–50% faster on the Wisconsin Benchmark compared to <productname>POSTGRES</productname>, Version 4.2. Apart from bug fixes, the following were the major enhancements: diff --git a/doc/src/sgml/isn.sgml b/doc/src/sgml/isn.sgml index 598dda2e9a..21174549eb 100644 --- a/doc/src/sgml/isn.sgml +++ b/doc/src/sgml/isn.sgml @@ -379,7 +379,7 @@ <title>Bibliography</title> <sect2> <title>Author</title> <para> - Germán Méndez Bravo (Kronuz), 2004 - 2006 + Germán Méndez Bravo (Kronuz), 2004–2006 </para> <para> diff --git a/doc/src/sgml/legal.sgml b/doc/src/sgml/legal.sgml index 9bb1d7983b..e33dae59a2 100644 --- a/doc/src/sgml/legal.sgml +++ b/doc/src/sgml/legal.sgml @@ -3,7 +3,7 @@ <date>2019</date> <copyright> - <year>1996-2019</year> + <year>1996–2019</year> <holder>The PostgreSQL Global Development Group</holder> </copyright> @@ -11,12 +11,12 @@ <title>Legal Notice</title> <para> - <productname>PostgreSQL</productname> is Copyright © 1996-2019 + <productname>PostgreSQL</productname> is Copyright © 1996–2019 by the PostgreSQL Global Development Group. </para> <para> - <productname>Postgres95</productname> is Copyright © 1994-5 + <productname>Postgres95</productname> is Copyright © 1994–5 by the Regents of the University of California. </para> diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index c58527b0c3..258b09cf8e 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/libpq.sgml --> <chapter id="libpq"> - <title><application>libpq</application> - C Library</title> + <title><application>libpq</application> — C Library</title> <indexterm zone="libpq"> <primary>libpq</primary> diff --git a/doc/src/sgml/planstats.sgml b/doc/src/sgml/planstats.sgml index 94b6b22947..ad66282fab 100644 --- a/doc/src/sgml/planstats.sgml +++ b/doc/src/sgml/planstats.sgml @@ -112,7 +112,7 @@ <title>Row Estimation Examples</title> into equal frequency buckets, so all we have to do is locate the bucket that our value is in and count <emphasis>part</emphasis> of it and <emphasis>all</emphasis> of the ones before. The value 1000 is clearly in - the second bucket (993-1997). Assuming a linear distribution of + the second bucket (993–1997). Assuming a linear distribution of values inside each bucket, we can calculate the selectivity as: <programlisting> diff --git a/doc/src/sgml/plperl.sgml b/doc/src/sgml/plperl.sgml index 967efba3b5..e4769c0e38 100644 --- a/doc/src/sgml/plperl.sgml +++ b/doc/src/sgml/plperl.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/plperl.sgml --> <chapter id="plperl"> - <title>PL/Perl - Perl Procedural Language</title> + <title>PL/Perl — Perl Procedural Language</title> <indexterm zone="plperl"> <primary>PL/Perl</primary> diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml index 70bcce700b..2987a555a3 100644 --- a/doc/src/sgml/plpgsql.sgml +++ b/doc/src/sgml/plpgsql.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/plpgsql.sgml --> <chapter id="plpgsql"> - <title><application>PL/pgSQL</application> - <acronym>SQL</acronym> Procedural Language</title> + <title><application>PL/pgSQL</application> — <acronym>SQL</acronym> Procedural Language</title> <indexterm zone="plpgsql"> <primary>PL/pgSQL</primary> diff --git a/doc/src/sgml/plpython.sgml b/doc/src/sgml/plpython.sgml index 31458e71a8..4c2f7e85fd 100644 --- a/doc/src/sgml/plpython.sgml +++ b/doc/src/sgml/plpython.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/plpython.sgml --> <chapter id="plpython"> - <title>PL/Python - Python Procedural Language</title> + <title>PL/Python — Python Procedural Language</title> <indexterm zone="plpython"><primary>PL/Python</primary></indexterm> <indexterm zone="plpython"><primary>Python</primary></indexterm> diff --git a/doc/src/sgml/pltcl.sgml b/doc/src/sgml/pltcl.sgml index 7ff828de70..87735af34f 100644 --- a/doc/src/sgml/pltcl.sgml +++ b/doc/src/sgml/pltcl.sgml @@ -1,7 +1,7 @@ <!-- doc/src/sgml/pltcl.sgml --> <chapter id="pltcl"> - <title>PL/Tcl - Tcl Procedural Language</title> + <title>PL/Tcl — Tcl Procedural Language</title> <indexterm zone="pltcl"> <primary>PL/Tcl</primary> diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index cb9b60415d..62542cd8a1 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -569,8 +569,8 @@ <title>Description</title> These forms control the application of row security policies belonging to the table. If enabled and no policies exist for the table, then a default-deny policy is applied. Note that policies can exist for a table - even if row level security is disabled - in this case, the policies will - NOT be applied and the policies will be ignored. + even if row level security is disabled. In this case, the policies will + <emphasis>not</emphasis> be applied and the policies will be ignored. See also <xref linkend="sql-createpolicy"/>. </para> diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 3e6f9cd532..d9b7c4d0d4 100644 --- a/doc/src/sgml/ref/copy.sgml +++ b/doc/src/sgml/ref/copy.sgml @@ -827,8 +827,8 @@ <title>File Header</title> are numbered from 0 (<acronym>LSB</acronym>) to 31 (<acronym>MSB</acronym>). Note that this field is stored in network byte order (most significant byte first), as are all the integer fields used in the file format. Bits -16-31 are reserved to denote critical file format issues; a reader -should abort if it finds an unexpected bit set in this range. Bits 0-15 +16–31 are reserved to denote critical file format issues; a reader +should abort if it finds an unexpected bit set in this range. Bits 0–15 are reserved to signal backwards-compatible format issues; a reader should simply ignore any unexpected bits set in this range. Currently only one flag bit is defined, and the rest must be zero: diff --git a/doc/src/sgml/ref/create_sequence.sgml b/doc/src/sgml/ref/create_sequence.sgml index 3e0d339c85..e4085804a4 100644 --- a/doc/src/sgml/ref/create_sequence.sgml +++ b/doc/src/sgml/ref/create_sequence.sgml @@ -98,7 +98,7 @@ <title>Parameters</title> Do not throw an error if a relation with the same name already exists. A notice is issued in this case. Note that there is no guarantee that the existing relation is anything like the sequence that would have - been created - it might not even be a sequence. + been created — it might not even be a sequence. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index a7d351308f..e9a31aa257 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -1348,7 +1348,7 @@ <title id="sql-createtable-storage-parameters-title">Storage Parameters</title> we try to move long column values into TOAST tables, and is also the target length we try to reduce the length below once toasting begins. This only affects columns marked as either External or Extended - and applies only to new tuples - there is no effect on existing rows. + and applies only to new tuples; there is no effect on existing rows. By default this parameter is set to allow at least 4 tuples per block, which with the default blocksize will be 2040 bytes. Valid values are between 128 bytes and the (blocksize - header), by default 8160 bytes. diff --git a/doc/src/sgml/syntax.sgml b/doc/src/sgml/syntax.sgml index ddc5ad3e30..c908e0bc39 100644 --- a/doc/src/sgml/syntax.sgml +++ b/doc/src/sgml/syntax.sgml @@ -392,7 +392,7 @@ <title>Backslash Escape Sequences</title> <literal>\<replaceable>o</replaceable></literal>, <literal>\<replaceable>oo</replaceable></literal>, <literal>\<replaceable>ooo</replaceable></literal> - (<replaceable>o</replaceable> = 0 - 7) + (<replaceable>o</replaceable> = 0–7) </entry> <entry>octal byte value</entry> </row> @@ -400,7 +400,7 @@ <title>Backslash Escape Sequences</title> <entry> <literal>\x<replaceable>h</replaceable></literal>, <literal>\x<replaceable>hh</replaceable></literal> - (<replaceable>h</replaceable> = 0 - 9, A - F) + (<replaceable>h</replaceable> = 0–9, A–F) </entry> <entry>hexadecimal byte value</entry> </row> @@ -408,7 +408,7 @@ <title>Backslash Escape Sequences</title> <entry> <literal>\u<replaceable>xxxx</replaceable></literal>, <literal>\U<replaceable>xxxxxxxx</replaceable></literal> - (<replaceable>x</replaceable> = 0 - 9, A - F) + (<replaceable>x</replaceable> = 0–9, A–F) </entry> <entry>16 or 32-bit hexadecimal Unicode character value</entry> </row> diff --git a/doc/src/sgml/textsearch.sgml b/doc/src/sgml/textsearch.sgml index 3f00ae3bd9..9839eaa8dd 100644 --- a/doc/src/sgml/textsearch.sgml +++ b/doc/src/sgml/textsearch.sgml @@ -2253,7 +2253,7 @@ <title>Dictionaries</title> <listitem> <para> - Linguistic - Ispell dictionaries try to reduce input words to a + Linguistic — Ispell dictionaries try to reduce input words to a normalized form; stemmer dictionaries remove word endings </para> </listitem> -- 2.23.0