]> granicus.if.org Git - postgresql/commitdiff
Escape < and & in SGML
authorPeter Eisentraut <peter_e@gmx.net>
Wed, 6 Sep 2017 15:22:43 +0000 (11:22 -0400)
committerPeter Eisentraut <peter_e@gmx.net>
Wed, 6 Sep 2017 15:22:43 +0000 (11:22 -0400)
This is not required in SGML, but will be in XML, so this is a step to
prepare for the conversion to XML.  (It is still not required to escape
>, but we did it here in some cases for symmetry.)

Add a command-line option to osx/onsgmls calls to warn about unescaped
occurrences in the future.

Author: Alexander Law <exclusion@gmail.com>
Author: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>

14 files changed:
doc/src/sgml/Makefile
doc/src/sgml/array.sgml
doc/src/sgml/fdwhandler.sgml
doc/src/sgml/plpgsql.sgml
doc/src/sgml/ref/alter_operator.sgml
doc/src/sgml/ref/create_view.sgml
doc/src/sgml/ref/pgtesttiming.sgml
doc/src/sgml/release-8.4.sgml
doc/src/sgml/release-9.0.sgml
doc/src/sgml/release-9.1.sgml
doc/src/sgml/release-9.2.sgml
doc/src/sgml/release-9.3.sgml
doc/src/sgml/rules.sgml
doc/src/sgml/syntax.sgml

index 8a73cc796f8fbe666e1e3fb523cdaaa3791aa061..7458ef4de23b4e21c7aa13114f94adb3361effa5 100644 (file)
@@ -66,10 +66,13 @@ ALLSGML := $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml) $(GENERATED_SGML)
 # Enable some extra warnings
 # -wfully-tagged needed to throw a warning on missing tags
 # for older tool chains, 2007-08-31
-# Note: try "make SPFLAGS=-wxml" to catch a lot of other dubious constructs,
-# in particular < and & that haven't been made into entities.  It's far too
-# noisy to turn on by default, unfortunately.
 override SPFLAGS += -wall -wno-unused-param -wno-empty -wfully-tagged
+# Additional warnings for XML compatibility.  The conditional is meant
+# to detect whether we are using OpenSP rather than the ancient
+# original SP.
+ifneq (,$(filter o%,$(notdir $(OSX))))
+override SPFLAGS += -wdata-delim
+endif
 
 
 ##
index 58878451f007c85aae2a05877d0087ec713edaaf..dd0d20e541f8947d97932abfc020718649340148 100644 (file)
@@ -654,7 +654,7 @@ SELECT * FROM
   For instance:
 
 <programlisting>
-SELECT * FROM sal_emp WHERE pay_by_quarter && ARRAY[10000];
+SELECT * FROM sal_emp WHERE pay_by_quarter &amp;&amp; ARRAY[10000];
 </programlisting>
 
   This and other array operators are further described in
index cfa68084179102e43d5d5bfd155a1b12ea2116a4..edf1029fe692a33d398ef5f75a45449c9e8e0c8a 100644 (file)
@@ -696,9 +696,9 @@ IsForeignRelUpdatable (Relation rel);
      The return value should be a bit mask of rule event numbers indicating
      which operations are supported by the foreign table, using the
      <literal>CmdType</> enumeration; that is,
-     <literal>(1 << CMD_UPDATE) = 4</> for <command>UPDATE</>,
-     <literal>(1 << CMD_INSERT) = 8</> for <command>INSERT</>, and
-     <literal>(1 << CMD_DELETE) = 16</> for <command>DELETE</>.
+     <literal>(1 &lt;&lt; CMD_UPDATE) = 4</> for <command>UPDATE</>,
+     <literal>(1 &lt;&lt; CMD_INSERT) = 8</> for <command>INSERT</>, and
+     <literal>(1 &lt;&lt; CMD_DELETE) = 16</> for <command>DELETE</>.
     </para>
 
     <para>
index 2f166d2d5939bc76936f0d8528402fee10c34efe..6dc438a15256630f264786909a08ec13a199943a 100644 (file)
@@ -1823,8 +1823,8 @@ $BODY$
 BEGIN
     RETURN QUERY SELECT flightid
                    FROM flight
-                  WHERE flightdate >= $1
-                    AND flightdate < ($1 + 1);
+                  WHERE flightdate &gt;= $1
+                    AND flightdate &lt; ($1 + 1);
 
     -- Since execution is not finished, we can check whether rows were returned
     -- and raise exception if not.
index b2eaa7a263e937351ed36e54bbd733bcfc49bfec..9579d00b7866e8deadc9d2d8184bc75a7e757f3e 100644 (file)
@@ -134,9 +134,9 @@ ALTER OPERATOR @@ (text, text) OWNER TO joe;
 </programlisting></para>
 
   <para>
-    Change the restriction and join selectivity estimator functions of a custom operator <literal>a && b</literal> for type <type>int[]</type>:
+    Change the restriction and join selectivity estimator functions of a custom operator <literal>a &amp;&amp; b</literal> for type <type>int[]</type>:
 <programlisting>
-ALTER OPERATOR && (_int4, _int4) SET (RESTRICT = _int_contsel, JOIN = _int_contjoinsel);
+ALTER OPERATOR &amp;&amp; (_int4, _int4) SET (RESTRICT = _int_contsel, JOIN = _int_contjoinsel);
 </programlisting></para>
 
  </refsect1>
index a83d9564e5a3e8788e9c442691da212a9b66a97b..319335051b34feec07612d58c6df31c293090ed0 100644 (file)
@@ -466,7 +466,7 @@ CREATE VIEW comedies AS
 CREATE RECURSIVE VIEW public.nums_1_100 (n) AS
     VALUES (1)
 UNION ALL
-    SELECT n+1 FROM nums_1_100 WHERE n < 100;
+    SELECT n+1 FROM nums_1_100 WHERE n &lt; 100;
 </programlisting>
    Notice that although the recursive view's name is schema-qualified in this
    <command>CREATE</>, its internal self-reference is not schema-qualified.
index e3539cf76498bdb3937e258d49984bfbe8987ea6..c659101361a0cb71a1ce45639cb503abad0f537e 100644 (file)
@@ -94,7 +94,7 @@
    nanoseconds. This example from an Intel i7-860 system using a TSC clock
    source shows excellent performance:
 
-<screen>
+<screen><![CDATA[
 Testing timing overhead for 3 seconds.
 Per loop time including overhead: 35.96 ns
 Histogram of timing durations:
@@ -104,7 +104,7 @@ Histogram of timing durations:
      4      0.00015        126
      8      0.00002         13
     16      0.00000          2
-</screen>
+]]></screen>
   </para>
 
   <para>
@@ -152,7 +152,7 @@ EXPLAIN ANALYZE SELECT COUNT(*) FROM t;
    possible from switching to the slower acpi_pm time source, on the same
    system used for the fast results above:
 
-<screen>
+<screen><![CDATA[
 # cat /sys/devices/system/clocksource/clocksource0/available_clocksource
 tsc hpet acpi_pm
 # echo acpi_pm > /sys/devices/system/clocksource/clocksource0/current_clocksource
@@ -165,7 +165,7 @@ Histogram of timing durations:
      4      0.07810       3241
      8      0.01357        563
     16      0.00007          3
-</screen>
+]]></screen>
   </para>
 
   <para>
@@ -201,7 +201,7 @@ kern.timecounter.hardware: ACPI-fast -> TSC
    implementation, which can have good resolution when it's backed by fast
    enough timing hardware, as in this example:
 
-<screen>
+<screen><![CDATA[
 $ cat /sys/devices/system/clocksource/clocksource0/available_clocksource
 jiffies
 $ dmesg | grep time.c
@@ -218,7 +218,7 @@ Histogram of timing durations:
      8      0.00007         22
     16      0.00000          1
     32      0.00000          1
-</screen></para>
+]]></screen></para>
 
  </refsect2>
 
index 16004edb74203aa407d7e796c91aeed946e8daea..53e319ff33e5e99ddbdfb59df43273dab0b63f0a 100644 (file)
       to fix all pre-existing data errors.  However, an installation can be
       presumed safe after performing this vacuuming if it has executed fewer
       than 2^31 update transactions in its lifetime (check this with
-      <literal>SELECT txid_current() < 2^31</>).
+      <literal>SELECT txid_current() &lt; 2^31</>).
      </para>
     </listitem>
 
index e7d2ffddaf15d9b73df098b97119476c33e0fe72..f7c63fc5677a8b2f414c3557150ebef41df5d021 100644 (file)
       to fix all pre-existing data errors.  However, an installation can be
       presumed safe after performing this vacuuming if it has executed fewer
       than 2^31 update transactions in its lifetime (check this with
-      <literal>SELECT txid_current() < 2^31</>).
+      <literal>SELECT txid_current() &lt; 2^31</>).
      </para>
     </listitem>
 
index 0454f849d446c18dbb7325db297263f293f2a62c..c354b7d1bc0fd0944225a461a443aa492638c833 100644 (file)
@@ -4654,7 +4654,7 @@ Branch: REL9_0_STABLE [9d6af7367] 2015-08-15 11:02:34 -0400
       to fix all pre-existing data errors.  However, an installation can be
       presumed safe after performing this vacuuming if it has executed fewer
       than 2^31 update transactions in its lifetime (check this with
-      <literal>SELECT txid_current() < 2^31</>).
+      <literal>SELECT txid_current() &lt; 2^31</>).
      </para>
     </listitem>
 
index 57a8e93b43e0a569a6a65ef0b91848a8c1057935..faa7ae4d575f488c6cd086e597df6f00019d6b9b 100644 (file)
@@ -6553,7 +6553,7 @@ Branch: REL9_2_STABLE [6b700301c] 2015-02-17 16:03:00 +0100
       to fix all pre-existing data errors.  However, an installation can be
       presumed safe after performing this vacuuming if it has executed fewer
       than 2^31 update transactions in its lifetime (check this with
-      <literal>SELECT txid_current() < 2^31</>).
+      <literal>SELECT txid_current() &lt; 2^31</>).
      </para>
     </listitem>
 
index 2ad5dee09c4e1179bd5cbba75c5fe45db016e762..f3b00a70d52a70a46e6bd1d7a580a0b5d9838e59 100644 (file)
@@ -9930,7 +9930,7 @@ Branch: REL8_4_STABLE [c0c2d62ac] 2014-02-14 21:59:56 -0500
       to fix all pre-existing data errors.  However, an installation can be
       presumed safe after performing this vacuuming if it has executed fewer
       than 2^31 update transactions in its lifetime (check this with
-      <literal>SELECT txid_current() < 2^31</>).
+      <literal>SELECT txid_current() &lt; 2^31</>).
      </para>
     </listitem>
 
index bcbc1703355384bdcb065f7392a00cefa3f3bf18..61423c25efd5e38c419ef80450b938cdf6021749 100644 (file)
@@ -970,7 +970,7 @@ CREATE MATERIALIZED VIEW sales_summary AS
       invoice_date,
       sum(invoice_amt)::numeric(13,2) as sales_amt
     FROM invoice
-    WHERE invoice_date < CURRENT_DATE
+    WHERE invoice_date &lt; CURRENT_DATE
     GROUP BY
       seller_no,
       invoice_date
@@ -1058,7 +1058,7 @@ SELECT count(*) FROM words WHERE word = 'caterpiler';
     have wanted.  Again using <literal>file_fdw</literal>:
 
 <programlisting>
-SELECT word FROM words ORDER BY word <-> 'caterpiler' LIMIT 10;
+SELECT word FROM words ORDER BY word &lt;-&gt; 'caterpiler' LIMIT 10;
 
      word     
 ---------------
index a2d136eaf81aede6ddba86105ab35766ee4a0f08..06f0f0b8e0c1eef86dc477d9beca6c392954b209 100644 (file)
@@ -1725,7 +1725,7 @@ SELECT percentile_cont(0.5) WITHIN GROUP (ORDER BY income) FROM households;
 <programlisting>
 SELECT
     count(*) AS unfiltered,
-    count(*) FILTER (WHERE i < 5) AS filtered
+    count(*) FILTER (WHERE i &lt; 5) AS filtered
 FROM generate_series(1,10) AS s(i);
  unfiltered | filtered
 ------------+----------