You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by ch...@apache.org on 2014/06/11 16:41:04 UTC

svn commit: r1601918 - /db/derby/docs/trunk/src/ref/

Author: chaase3
Date: Wed Jun 11 14:41:04 2014
New Revision: 1601918

URL: http://svn.apache.org/r1601918
Log:
DERBY-6379  Manuals are inconsistent in their use of the <shortdesc> element

Modified 12 Reference Manual topics.

Patch: DERBY-6379-ref-clauses.diff

Modified:
    db/derby/docs/trunk/src/ref/rrefsqlj13658.dita
    db/derby/docs/trunk/src/ref/rrefsqlj14854.dita
    db/derby/docs/trunk/src/ref/rrefsqlj15309.dita
    db/derby/docs/trunk/src/ref/rrefsqlj21583.dita
    db/derby/docs/trunk/src/ref/rrefsqlj31783.dita
    db/derby/docs/trunk/src/ref/rrefsqlj32654.dita
    db/derby/docs/trunk/src/ref/rrefsqlj33602.dita
    db/derby/docs/trunk/src/ref/rrefsqljexternalname.dita
    db/derby/docs/trunk/src/ref/rrefsqljoffsetfetch.dita
    db/derby/docs/trunk/src/ref/rrefsqljusing.dita
    db/derby/docs/trunk/src/ref/rrefsqljwhenclause.dita
    db/derby/docs/trunk/src/ref/rrefsqljwindow.dita

Modified: db/derby/docs/trunk/src/ref/rrefsqlj13658.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj13658.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj13658.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj13658.dita Wed Jun 11 14:41:04 2014
@@ -20,6 +20,8 @@ limitations under the License.
 -->
 <reference id="rrefsqlj13658" xml:lang="en-us">
 <title>ORDER BY clause</title>
+<shortdesc>The ORDER BY clause is an optional element of several statements,
+expressions, and subqueries.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>ORDER BY clause<indexterm>syntax</indexterm></indexterm>
 <indexterm>ASC<indexterm>implied in ORDER BY clause</indexterm></indexterm>
@@ -29,14 +31,14 @@ limitations under the License.
 </keywords>
 </metadata></prolog>
 <refbody>
-<section><p>The ORDER BY clause is an optional element of the following:
+<section><p>It can be an element of the following:</p>
 <ul>
 <li>A <xref href="rrefsqlj41360.dita#rrefsqlj41360">SELECT statement</xref></li> 
 <li>A <i><xref href="rrefselectexpression.dita#rrefselectexpression"></xref></i></li>
 <li>A <xref href="rrefsqlj11277.dita#rrefsqlj11277">VALUES expression</xref></li>
 <li>A <i><xref href="rrefscalarsubquery.dita#rrefscalarsubquery"></xref></i></li>
 <li>A <i><xref href="rreftablesubquery.dita#rreftablesubquery"></xref></i></li> 
-</ul></p>
+</ul>
 <p>It can also be used in an
 <xref href="rrefsqlj40774.dita#rrefsqlj40774">INSERT statement</xref> or a
 <xref href="rrefsqlj15446.dita#rrefsqlj15446">CREATE VIEW statement</xref>.</p>

Modified: db/derby/docs/trunk/src/ref/rrefsqlj14854.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj14854.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj14854.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj14854.dita Wed Jun 11 14:41:04 2014
@@ -18,18 +18,22 @@ limitations under the License.
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
 <reference xml:lang="en-us" id="rrefsqlj14854">
 <title>HAVING clause</title>
+<shortdesc>A HAVING clause restricts the results of a GROUP BY in a
+<i>selectExpression</i>.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>HAVING clause</indexterm>
 </keywords>
 </metadata>
 </prolog><refbody>
 <section>
-<p>A HAVING clause restricts the results of a GROUP BY in a <i><xref href="rrefselectexpression.dita#rrefselectexpression"/>.</i> The HAVING clause is applied
-to each group of the grouped table, much as a WHERE clause is applied to a
-select list. If there is no GROUP BY clause, the HAVING clause is applied
-to the entire result as a single group. The SELECT clause cannot refer directly
-to any column that does not have a GROUP BY clause. It can, however, refer
-to constants, aggregates, and special registers.</p></section>
+<p>The HAVING clause is applied to each group of the grouped table, much as a
+WHERE clause is applied to a select list. If there is no
+<xref href="rrefsqlj32654.dita">GROUP BY clause</xref>, the HAVING clause is
+applied to the entire result as a single group. The SELECT clause cannot refer
+directly to any column that does not have a GROUP BY clause. It can, however,
+refer to constants, aggregates, and special registers.</p>
+<p>See <i><xref href="rrefselectexpression.dita"/></i> for more information.</p>
+</section>
 <refsyn><title>Syntax</title>
 <codeblock><b>HAVING <i><xref
 href="rrefsqlj23075.dita#rrefsqlj23075">booleanExpression</xref></i></b></codeblock>

Modified: db/derby/docs/trunk/src/ref/rrefsqlj15309.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj15309.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj15309.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj15309.dita Wed Jun 11 14:41:04 2014
@@ -18,20 +18,23 @@ limitations under the License.
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
 <reference xml:lang="en-us" id="rrefsqlj15309">
 <title>WHERE CURRENT OF clause</title>
+<shortdesc>The WHERE CURRENT OF clause is a clause in some UPDATE and DELETE
+statements. It allows you to perform positioned updates and deletes on updatable
+cursors.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>WHERE CURRENT OF clause</indexterm>
 </keywords>
 </metadata>
 </prolog><refbody>
 <section>
-<p>The WHERE CURRENT OF clause is a clause in some UPDATE and DELETE
-statements. It allows you to perform positioned updates and deletes on updatable
-cursors. Updatable and/or scrollable JDBC <i>ResultSet</i>s can provide a
-simpler and easier way to perform these tasks.</p>
-<p> For more information about updatable cursors, see
-<xref href="rrefsqlj41360.dita#rrefsqlj41360"/>. For information on scrollable
-and updatable <i>ResultSet</i>s, see the Java SE API documentation on the
-<i>java.sql.ResultSet</i> interface as well as the information on the
+<p>Updatable and/or scrollable JDBC <i>ResultSet</i>s can provide a simpler and
+easier way to perform these tasks.</p>
+<p>See <xref href="rrefsqlj26498.dita">UPDATE statement</xref> and
+<xref href="rrefsqlj35981.dita">DELETE statement</xref> for more information on
+those statements. For more information about updatable cursors, see
+<xref href="rrefsqlj41360.dita">SELECT statement</xref>. For information on
+scrollable and updatable <i>ResultSet</i>s, see the Java SE API documentation on
+the <i>java.sql.ResultSet</i> interface as well as the information on the
 <ph conref="../conrefs.dita#prod/productshortname"></ph> implementation at
 <xref href="rrefjdbc23502.dita#rrefjdbc23502"/>.</p></section>
 <refsyn><title>Syntax</title>

Modified: db/derby/docs/trunk/src/ref/rrefsqlj21583.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj21583.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj21583.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj21583.dita Wed Jun 11 14:41:04 2014
@@ -20,13 +20,18 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqlj21583" xml:lang="en-us">
 <title>FROM clause</title>
+<shortdesc>The FROM clause is a mandatory clause in a
+<i>selectExpression</i>.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>FROM clause</indexterm></keywords>
 </metadata></prolog>
 <refbody>
-<section> <p>The FROM clause is a mandatory clause in a <i><xref href="rrefselectexpression.dita#rrefselectexpression">selectExpression</xref>.</i> It
-specifies the tables (<i><xref href="rreftableexpression.dita#rreftableexpression">tableExpression</xref></i>)
-from which the other clauses of the query can access columns for use in expressions. </p></section>
+<section>
+<p>It specifies the tables
+(<i><xref href="rreftableexpression.dita"/></i>) from which the other clauses of
+the query can access columns for use in expressions. See
+<i><xref href="rrefselectexpression.dita"/></i> for more information.</p>
+</section>
 <refsyn><title>Syntax</title> <codeblock><b>FROM <i>tableExpression</i> [ , <i>tableExpression</i> ]*</b></codeblock> </refsyn>
 <example><title>Examples</title>
 <codeblock><b>SELECT Cities.city_id

Modified: db/derby/docs/trunk/src/ref/rrefsqlj31783.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj31783.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj31783.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj31783.dita Wed Jun 11 14:41:04 2014
@@ -20,18 +20,22 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqlj31783" xml:lang="en-us">
 <title>FOR UPDATE clause</title>
+<shortdesc>The FOR UPDATE clause is an optional part of a SELECT
+statement.</shortdesc>
 <prolog><metadata>
-<keywords><indexterm>FOR UPDATE clause</indexterm><indexterm>Cursors</indexterm>
+<keywords><indexterm>FOR UPDATE clause</indexterm>
+<indexterm>cursors</indexterm>
+<indexterm>in-place updates</indexterm>
 </keywords>
 </metadata></prolog>
 <refbody>
-<section> <indexterm>Cursors</indexterm><indexterm>In-place updates</indexterm> <p> The
-FOR UPDATE clause is an optional part of a <xref href="rrefsqlj41360.dita#rrefsqlj41360">SELECT statement</xref>.
-Cursors are read-only by default. The FOR UPDATE clause specifies that the cursor should be updatable, and 
-enforces a check during compilation that
-the SELECT statement meets the requirements for an updatable <i>cursor</i>.
-For more information about updatability, see
-<xref href="rrefsqlj41360.dita#rrefsqlj41360/sqlj15384"></xref>.</p> </section>
+<section>  
+<p>Cursors are read-only by default. The FOR UPDATE clause specifies that the
+cursor should be updatable, and enforces a check during compilation that the
+<xref href="rrefsqlj41360.dita">SELECT statement</xref> meets the requirements
+for an updatable cursor. For more information about updatability, see
+<xref href="rrefsqlj41360.dita#rrefsqlj41360/sqlj15384"/>.</p>
+</section>
 <refsyn><title>Syntax</title> <codeblock><b>FOR
 {
     READ ONLY |

Modified: db/derby/docs/trunk/src/ref/rrefsqlj32654.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj32654.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj32654.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj32654.dita Wed Jun 11 14:41:04 2014
@@ -20,17 +20,20 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqlj32654" xml:lang="en-us">
 <title>GROUP BY clause</title>
+<shortdesc>A GROUP BY clause, part of a <i>selectExpression</i>, groups a result
+into subsets that have matching values for one or more columns.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>GROUP BY clause</indexterm></keywords>
 </metadata></prolog>
 <refbody>
-<section> <p>A GROUP BY clause, part of a <i><xref href="rrefselectexpression.dita#rrefselectexpression">selectExpression</xref>,</i> groups
-a result into subsets that have matching values for one or more columns. In
-each group, no two rows have the same value for the grouping column or columns.
-NULLs are considered equivalent for grouping purposes.</p>  <p>You typically
-use a GROUP BY clause in conjunction with an aggregate expression.</p>
+<section>
+<p>In each group, no two rows have the same value for the grouping column or
+columns. NULLs are considered equivalent for grouping purposes. See 
+<i><xref href="rrefselectexpression.dita"/></i> for more information.</p>
+<p>You typically use a GROUP BY clause in conjunction with an aggregate
+expression.</p>
 <p>Using the ROLLUP syntax, you can specify that multiple levels of grouping
-    should be computed at once.</p>
+should be computed at once.</p>
 </section>
 <refsyn><title>Syntax</title>
     <codeblock><b>

Modified: db/derby/docs/trunk/src/ref/rrefsqlj33602.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj33602.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj33602.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj33602.dita Wed Jun 11 14:41:04 2014
@@ -20,16 +20,19 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqlj33602" xml:lang="en-us">
 <title>WHERE clause</title>
+<shortdesc>A WHERE clause is an optional part of a <i>selectExpression</i>,
+DELETE statement, or UPDATE statement. The WHERE clause lets you select rows
+based on a boolean expression.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>WHERE clause</indexterm></keywords>
 </metadata></prolog>
 <refbody>
-<section> <p>A WHERE clause is an optional part of a <i><xref href="rrefselectexpression.dita#rrefselectexpression">selectExpression</xref>,</i> <xref
-href="rrefsqlj35981.dita#rrefsqlj35981">DELETE statement</xref>, or <xref href="rrefsqlj26498.dita#rrefsqlj26498">UPDATE statement</xref>.
-The WHERE clause lets you select rows based on a boolean expression. Only
-rows for which the expression evaluates to TRUE are returned in the result,
-or, in the case of a DELETE statement, deleted, or, in the case of an UPDATE
-statement, updated.</p></section>
+<section>
+<p>Only rows for which the <i><xref href="rrefselectexpression.dita"/></i>
+evaluates to TRUE are returned in the result, or, in the case of a
+<xref href="rrefsqlj35981.dita">DELETE statement</xref>, deleted, or, in the
+case of an <xref href="rrefsqlj26498.dita">UPDATE statement</xref>, updated.</p>
+</section>
 <refsyn><title>Syntax</title> <codeblock><b>WHERE <i><xref
 href="rrefsqlj23075.dita#rrefsqlj23075">booleanExpression</xref></i></b></codeblock> <p><indexterm>WHERE
 clause<indexterm>SQL extensions to</indexterm></indexterm>Boolean expressions

Modified: db/derby/docs/trunk/src/ref/rrefsqljexternalname.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljexternalname.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljexternalname.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljexternalname.dita Wed Jun 11 14:41:04 2014
@@ -20,21 +20,19 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqljexternalname" xml:lang="en-us">
 <title>EXTERNAL NAME clause</title>
+<shortdesc>The EXTERNAL NAME clause specifies the Java method to be called in a
+CREATE FUNCTION or CREATE PROCEDURE statement, and it specifies a Java class in
+a CREATE AGGREGATE or CREATE TYPE statement.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>EXTERNAL NAME clause</indexterm>
 </keywords>
 </metadata></prolog>
 <refbody>
 <section>
-<p>The EXTERNAL NAME clause specifies the Java method to be called in a <xref
-href="rrefcreatefunctionstatement.dita#rrefcreatefunctionstatement">CREATE
-FUNCTION statement</xref> or a <xref
-href="rrefcreateprocedurestatement.dita#rrefcreateprocedurestatement">CREATE
-PROCEDURE statement</xref>, and it specifies a Java class in a <xref
-href="rrefsqljcreateaggregate.dita#rrefsqljcreateaggregate">CREATE AGGREGATE
-statement</xref> or a <xref
-href="rrefsqljcreatetype.dita#rrefsqljcreatetype">CREATE TYPE statement</xref>.
-</p>
+<p>See <xref href="rrefcreatefunctionstatement.dita"/>,
+<xref href="rrefcreateprocedurestatement.dita"/>,
+<xref href="rrefsqljcreateaggregate.dita"/>, and
+<xref href="rrefsqljcreatetype.dita"/> for more information.</p>
 </section>
 <refsyn><title>Syntax</title>
 <codeblock><b>EXTERNAL NAME <i>singleQuotedString</i></b></codeblock>

Modified: db/derby/docs/trunk/src/ref/rrefsqljoffsetfetch.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljoffsetfetch.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljoffsetfetch.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljoffsetfetch.dita Wed Jun 11 14:41:04 2014
@@ -19,9 +19,12 @@ limitations under the License.
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
  "../dtd/reference.dtd">
 <reference id="rrefsqljoffsetfetch" xml:lang="en-us">
-
 <title>The result offset and fetch first clauses</title>
-
+<shortdesc>The <i>result offset clause</i> provides a way to skip the first
+<i>N</i> rows in a result set before starting to return any rows. The
+<i>fetch first clause</i>, which can be combined with the <i>result offset
+clause</i> if desired, limits the number of rows returned in the result
+set.</shortdesc>
 <prolog>
   <metadata>
     <keywords>
@@ -30,19 +33,12 @@ limitations under the License.
     </keywords>
   </metadata>
 </prolog>
-
 <refbody>
 <section> 
-  <p> The <i>result offset clause</i> provides a way to skip the N
-    first rows in a result set before starting to return any
-    rows. The <i>fetch first clause</i>, which can be combined with
-    the <i>result offset clause</i> if desired, limits the number of rows
-    returned in the result set. The <i>fetch first clause</i> can
-    sometimes be useful for retrieving only a few rows from an
-    otherwise large result set, usually in combination with an ORDER BY
-    clause. The use of this clause can give efficiency benefits. In
-    addition, it can make programming the application simpler.
-  </p> 
+<p>The <i>fetch first clause</i> can sometimes be useful for retrieving only a
+few rows from an otherwise large result set, usually in combination with an
+ORDER BY clause. The use of this clause can give efficiency benefits. In
+addition, it can make programming the application simpler.</p> 
 </section>
 
 <refsyn>

Modified: db/derby/docs/trunk/src/ref/rrefsqljusing.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljusing.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljusing.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljusing.dita Wed Jun 11 14:41:04 2014
@@ -19,9 +19,9 @@ limitations under the License.
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
  "../dtd/reference.dtd">
 <reference id="rrefsqljusing" xml:lang="en-us">
-
 <title>USING clause</title>
-
+<shortdesc>The USING clause specifies which columns to test for equality when
+two tables are joined.</shortdesc>
 <prolog>
   <metadata>
     <keywords>
@@ -29,18 +29,11 @@ limitations under the License.
     </keywords>
   </metadata>
 </prolog>
-
 <refbody>
-
 <section>
-
-<p>
-The USING clause specifies which columns to test for equality when two
-tables are joined. It can be used instead of an ON clause in the
+<p>It can be used instead of an ON clause in the
 <xref href="rrefsqlj29840.dita#rrefsqlj29840">JOIN operations</xref>
-that have an explicit join clause.
-</p>
-
+that have an explicit join clause.</p>
 </section>
 
 <refsyn>

Modified: db/derby/docs/trunk/src/ref/rrefsqljwhenclause.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljwhenclause.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljwhenclause.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljwhenclause.dita Wed Jun 11 14:41:04 2014
@@ -19,6 +19,8 @@ limitations under the License.
 -->
 <reference id="rrefsqljwhenclause" xml:lang="en-us">
 <title>WHEN clause</title>
+<shortdesc>The WHEN clause is an optional part of a CREATE TRIGGER
+statement.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>CREATE TRIGGER statement<indexterm>WHEN clause</indexterm></indexterm>
 <indexterm>triggers<indexterm>WHEN clause</indexterm></indexterm>
@@ -26,9 +28,6 @@ limitations under the License.
 </keywords>
 </metadata></prolog>
 <refbody>
-<section><p>The WHEN clause is an optional part of a
-<xref href="rrefsqlj43125.dita#rrefsqlj43125">CREATE TRIGGER statement</xref>.</p>
-</section>
 <refsyn><title>Syntax</title>
 <codeblock><b>WHEN ( <i><xref
 href="rrefsqlj23075.dita#rrefsqlj23075">booleanExpression</xref></i> )</b></codeblock>
@@ -42,8 +41,9 @@ evaluates to TRUE. If it evaluates to FA
 <i>triggeredSQLStatement</i> will not be executed.</p>
 <p>The transition tables or transition variables defined in the REFERENCING
 clause can be referenced from the WHEN clause.</p>
-<p>The restrictions listed for the <i>triggeredSQLStatement</i>
-in the CREATE TRIGGER statement also apply to the WHEN clause.</p>
+<p>The restrictions listed for the <i>triggeredSQLStatement</i> in the
+<xref href="rrefsqlj43125.dita">CREATE TRIGGER statement</xref> also apply to
+the WHEN clause.</p>
 <note>The use of a WHEN clause in a CREATE TRIGGER statement is valid only after
 a database has been fully upgraded to
 <ph conref="../conrefs.dita#prod/productshortname"></ph> Release 10.11 or

Modified: db/derby/docs/trunk/src/ref/rrefsqljwindow.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljwindow.dita?rev=1601918&r1=1601917&r2=1601918&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljwindow.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljwindow.dita Wed Jun 11 14:41:04 2014
@@ -19,15 +19,15 @@ limitations under the License.
  "../dtd/reference.dtd">
 <reference id="rrefsqljwindow" xml:lang="en-us">
 <title>WINDOW clause</title>
+<shortdesc>The WINDOW clause allows you to refer to a window by name when you
+use a ROW NUMBER function in a <i>selectExpression</i>.</shortdesc>
 <prolog><metadata><keywords>
 <indexterm>WINDOW clause</indexterm>
 </keywords></metadata></prolog>
 <refbody>
 <section>
-<p>The WINDOW clause allows you to refer to a window by name when you use a
-<xref href="rreffuncrownumber.dita#rreffuncrownumber"></xref> in a
-<i><xref href="rrefselectexpression.dita#rrefselectexpression">SelectExpression</xref></i>.
-</p>
+<p>See <xref href="rreffuncrownumber.dita"/> and
+<xref href="rrefselectexpression.dita"/> for more information.</p>
 </section>
 <refsyn>
 <title>Syntax</title>