PG 14 全量更新原文注释

Author: ChenHuajun

postgresql/doc/src/sgml/amcheck.sgml

@@ -596,7 +596,7 @@ ____________________________________________________________________________-->
        <listitem>
 <!--==========================orignal english content==========================
         <para>
-		 A message describing the problem detected.
+         A message describing the problem detected.
         </para>
 ____________________________________________________________________________-->
         <para>
@@ -778,8 +778,6 @@ ____________________________________________________________________________-->
     </para>
    </listitem>
   </itemizedlist>
-  In general, <filename>amcheck</filename> can only prove the presence of
-  corruption; it cannot prove its absence.
  </para>
 ____________________________________________________________________________-->
  <para>

postgresql/doc/src/sgml/datatype.sgml

@@ -9092,9 +9092,9 @@ ____________________________________________________________________________-->
 
   <sect1 id="datatype-pg-lsn">
 <!--==========================orignal english content==========================
-   <title><acronym>pg_lsn Type</acronym></title>
+   <title><type>pg_lsn</type> Type</title>
 ____________________________________________________________________________-->
-   <title><acronym>pg_lsn 类型</acronym></title>
+   <title><type>pg_lsn</type> 类型</title>
 
 <!--==========================orignal english content==========================
    <indexterm zone="datatype-pg-lsn">

postgresql/doc/src/sgml/datetime.sgml

@@ -1552,31 +1552,32 @@ ____________________________________________________________________________-->
 
   </sect1>
 
-<!--==========================orignal english content==========================
   <sect1 id="datetime-julian-dates">
+<!--==========================orignal english content==========================
   <title>Julian Dates</title>
+____________________________________________________________________________-->
+  <title>儒略日期</title>
 
+<!--==========================orignal english content==========================
   <indexterm zone="datetime-julian-dates">
    <primary>Julian date</primary>
   </indexterm>
 ____________________________________________________________________________-->
-  <sect1 id="datetime-julian-dates">
-  <title>儒略日期</title>
-
   <indexterm zone="datetime-julian-dates">
    <primary>儒略日期</primary>
   </indexterm>
 
 <!--==========================orignal english content==========================
   <para>
    The <firstterm>Julian Date</firstterm> system is a method for
-   numbering days.  It is unrelated to the Julian calendar though it is confusingly
+   numbering days.  It is
+   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&ndash;1609)
    and probably takes its name from Scaliger's father,
    the Italian scholar Julius Caesar Scaliger (1484&ndash;1558).
-  </para> 
+  </para>
 ____________________________________________________________________________-->
   <para>
    <firstterm>儒略日期</firstterm>系统是一种计算天数的方法。它虽然在命名上很相似，但是它和儒略历法无关。儒略日期系统是法国学者 Joseph Justus Scaliger(1540&ndash;1609)（可能是取自其父亲的名字，即意大利学者 Julius Caesar Scaliger(1484&ndash;1558)发明的。
@@ -1603,7 +1604,8 @@ ____________________________________________________________________________-->
    Although <productname>PostgreSQL</productname> supports Julian Date notation for
    input and output of dates (and also uses Julian dates for some internal
    datetime calculations), it does not observe the nicety of having dates
-   run from noon to noon.  <productname>PostgreSQL</productname> treats a Julian Date as running from local midnight to local midnight, the same as a normal
+   run from noon to noon.  <productname>PostgreSQL</productname> treats a Julian Date
+   as running from local midnight to local midnight, the same as a normal
    date.
   </para>
 ____________________________________________________________________________-->

postgresql/doc/src/sgml/dml.sgml

@@ -48,9 +48,9 @@ ____________________________________________________________________________-->
   <para>
    When a table is created, it contains no data.  The first thing to
    do before a database can be of much use is to insert data.  Data is
-   conceptually inserted one row at a time.  Of course you can also
-   insert more than one row, but there is no way to insert less than
-   one row.  Even if you know only some column values, a
+   inserted one row at a time.  You can also insert more than one row
+   in a single command, but it is not possible to insert something that
+   is not a complete row.  Even if you know only some column values, a
    complete row must be created.
   </para>
 ____________________________________________________________________________-->
@@ -429,7 +429,7 @@ ____________________________________________________________________________-->
   <para>
    You use the <xref linkend="sql-delete"/>
    command to remove rows; the syntax is very similar to the
-   <command>UPDATE</command> command.  For instance, to remove all
+   <xref linkend="sql-update"/> command.  For instance, to remove all
    rows from the products table that have a price of 10, use:
 <programlisting>
 DELETE FROM products WHERE price = 10;

postgresql/doc/src/sgml/ecpg.sgml

@@ -7434,34 +7434,58 @@ ____________________________________________________________________________-->
      <step><!--==========================orignal english content==========================
 <simpara>Prepare a query, and declare a cursor for it.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Prepare a query, and declare a cursor for it.</simpara>
+____________________________________________________________________________-->
 <simpara>准备一个查询，并且为它声明一个游标。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Declare an SQLDA for the result rows.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Declare an SQLDA for the result rows.</simpara>
+____________________________________________________________________________-->
 <simpara>为结果行声明一个 SQLDA 。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Declare an SQLDA for the input parameters, and initialize them (memory allocation, parameter settings).</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Declare an SQLDA for the input parameters, and initialize them (memory allocation, parameter settings).</simpara>
+____________________________________________________________________________-->
 <simpara>为输入参数声明一个 SQLDA，并且初始化它们（内存分配、参数设置）。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Open a cursor with the input SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Open a cursor with the input SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>用输入 SQLDA 打开一个游标。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Fetch rows from the cursor, and store them into an output SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Fetch rows from the cursor, and store them into an output SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>从游标中取得行，并且把它们存储到一个输出 SQLDA。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Read values from the output SQLDA into the host variables (with conversion if necessary).</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Read values from the output SQLDA into the host variables (with conversion if necessary).</simpara>
+____________________________________________________________________________-->
 <simpara>从输出 SQLDA 读取值到主变量中（必要时使用转换）。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Close the cursor.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Close the cursor.</simpara>
+____________________________________________________________________________-->
 <simpara>关闭游标。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Free the memory area allocated for the input SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Free the memory area allocated for the input SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>关闭为输入 SQLDA 分配的内存区域。</simpara></step>
     </procedure>
 
@@ -7915,26 +7939,44 @@ ____________________________________________________________________________-->
      <step><!--==========================orignal english content==========================
 <simpara>Declare an <type>sqlda_t</type> structure to receive the result set.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Declare an <type>sqlda_t</type> structure to receive the result set.</simpara>
+____________________________________________________________________________-->
 <simpara>声明一个<type>sqlda_t</type>结构来接收结果集。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Execute <command>FETCH</command>/<command>EXECUTE</command>/<command>DESCRIBE</command> commands to process a query specifying the declared SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Execute <command>FETCH</command>/<command>EXECUTE</command>/<command>DESCRIBE</command> commands to process a query specifying the declared SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>执行 <command>FETCH</command>/<command>EXECUTE</command>/<command>DESCRIBE</command> 命令来处理一个指定已声明 SQLDA 的查询。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Check the number of records in the result set by looking at <structfield>sqln</structfield>, a member of the <type>sqlda_t</type> structure.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Check the number of records in the result set by looking at <structfield>sqln</structfield>, a member of the <type>sqlda_t</type> structure.</simpara>
+____________________________________________________________________________-->
 <simpara>通过查看<type>sqlda_t</type>结构的成员<structfield>sqln</structfield>来检查结果集中记录的数量。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Get the values of each column from <literal>sqlvar[0]</literal>, <literal>sqlvar[1]</literal>, etc., members of the <type>sqlda_t</type> structure.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Get the values of each column from <literal>sqlvar[0]</literal>, <literal>sqlvar[1]</literal>, etc., members of the <type>sqlda_t</type> structure.</simpara>
+____________________________________________________________________________-->
 <simpara>从<type>sqlda_t</type>结构的成员<literal>sqlvar[0]</literal>、<literal>sqlvar[1]</literal>等中得到每一列的值。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Go to next row (<type>sqlda_t</type> structure) by following the <structfield>desc_next</structfield> pointer, a member of the <type>sqlda_t</type> structure.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Go to next row (<type>sqlda_t</type> structure) by following the <structfield>desc_next</structfield> pointer, a member of the <type>sqlda_t</type> structure.</simpara>
+____________________________________________________________________________-->
 <simpara>沿着<type>sqlda_t</type>结构的成员<structfield>desc_next</structfield>指针到达下一行（<type>sqlda_t</type>）。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Repeat above as you need.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Repeat above as you need.</simpara>
+____________________________________________________________________________-->
 <simpara>根据你的需要重复上述步骤。</simpara></step>
     </procedure>
 
@@ -8103,22 +8145,37 @@ ____________________________________________________________________________-->
      <step><!--==========================orignal english content==========================
 <simpara>Create a prepared query (prepared statement)</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Create a prepared query (prepared statement)</simpara>
+____________________________________________________________________________-->
 <simpara>创建一个预备查询（预备语句）。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Declare an sqlda_t structure as an input SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Declare an sqlda_t structure as an input SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>声明一个 sqlda_t 结构作为输入 SQLDA。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Allocate memory area (as sqlda_t structure) for the input SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Allocate memory area (as sqlda_t structure) for the input SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>为输入 SQLDA 分配内存区域（作为 sqlda_t 结构）。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Set (copy) input values in the allocated memory.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Set (copy) input values in the allocated memory.</simpara>
+____________________________________________________________________________-->
 <simpara>在分配好的内存中设置（复制）输入值。</simpara></step>
      <step><!--==========================orignal english content==========================
 <simpara>Open a cursor with specifying the input SQLDA.</simpara>
 ____________________________________________________________________________-->
+<!--==========================orignal english content==========================
+<simpara>Open a cursor with specifying the input SQLDA.</simpara>
+____________________________________________________________________________-->
 <simpara>打开一个说明了输入 SQLDA 的游标。</simpara></step>
     </procedure>
 

postgresql/doc/src/sgml/extend.sgml

@@ -1087,7 +1087,7 @@ ____________________________________________________________________________-->
 
 <!--==========================orignal english content==========================
     <para>
-     The <xref linkend="sql-createextension"/> command relies on a control
+     The <command>CREATE EXTENSION</command> command relies on a control
      file for each extension, which must be named the same as the extension
      with a suffix of <literal>.control</literal>, and must be placed in the
      installation's <literal>SHAREDIR/extension</literal> directory.  There

postgresql/doc/src/sgml/func.sgml

@@ -26841,7 +26841,7 @@ ____________________________________________________________________________-->
     </para>
 
 <!--==========================orignal english content==========================
-    <para>
+   <para>
      The second argument must be a well formed XML document. In particular,
      it must have a single root node element.
     </para>