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/20 22:03:20 UTC
svn commit: r1604269 [2/2] - /db/derby/docs/trunk/src/ref/
Modified: db/derby/docs/trunk/src/ref/rrefproperdefaultfileperms.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperdefaultfileperms.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperdefaultfileperms.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperdefaultfileperms.dita Fri Jun 20 20:03:18 2014
@@ -18,8 +18,11 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperdefaultfileperms">
<title>derby.storage.useDefaultFilePermissions</title>
+<shortdesc>The <i>derby.storage.useDefaultFilePermissions</i> property overrides
+the default access to files on systems that run on the Java SE 7
+platform.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.useDefaultFilePermissions</indexterm>
+<keywords><indexterm>derby.storage.useDefaultFilePermissions property</indexterm>
<indexterm>database files<indexterm>specifying permissions with Java SE 7 and up</indexterm></indexterm>
<indexterm>file permissions<indexterm>specifying with Java SE 7 and up</indexterm></indexterm>
<indexterm>permissions<indexterm>file, specifying with Java SE 7 and up</indexterm></indexterm>
@@ -27,7 +30,7 @@ limitations under the License.
</metadata>
</prolog>
<refbody>
-<section><title>Function</title>
+<section>
<p>If you run with Java SE 7 or later, and if you start the
<ph conref="../conrefs.dita#prod/productshortname"></ph> Network Server from the
command line, access to databases and to other files created by
@@ -37,7 +40,7 @@ access is not restricted for embedded da
servers that are started programmatically inside application code using the
<ph conref="../conrefs.dita#prod/productshortname"></ph> API.</p>
<p>You can override this default behavior by setting the system property
-<i>derby.storage.useDefaultFilePermissions</i> to either true or false:</p>
+<i>derby.storage.useDefaultFilePermissions</i> to either true or false.</p>
<p>If you run with the Java SE 6 platform, this property is
ignored, and <ph conref="../conrefs.dita#prod/productshortname"></ph> uses the
default file permissions the user has set for their system.</p>
@@ -130,7 +133,7 @@ property. If you want all the files in t
permissions, do not change the property while
<ph conref="../conrefs.dita#prod/productshortname"></ph> is running.</p>
<p>For information about dynamic changes to properties, see
-<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+<xref href="crefproperdynstat.dita"/>.</p>
</section>
</refbody>
</reference>
Modified: db/derby/docs/trunk/src/ref/rrefproperdurability.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperdurability.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperdurability.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperdurability.dita Fri Jun 20 20:03:18 2014
@@ -19,17 +19,18 @@ limitations under the License.
-->
<reference id="rrefproperdurability" xml:lang="en-us">
<title>derby.system.durability</title>
+<shortdesc>The <i>derby.system.durability</i> property changes the default
+durability of <ph conref="../conrefs.dita#prod/productshortname"></ph> to
+improve performance at the expense of consistency and durability of the
+database.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.system.durability</indexterm></keywords>
+<keywords><indexterm>derby.system.durability property</indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>This property changes the default durability of
-<ph conref="../conrefs.dita#prod/productshortname"></ph> to improve performance
-at the expense of consistency and durability of the database. The only valid
-supported case insensitive value is <codeph>test</codeph>. If this property is
-set to any value other than <codeph>test</codeph>, this property setting is
-ignored. When <codeph>derby.system.durability</codeph> is set to
+<section>
+<p>The only valid supported case insensitive value is <codeph>test</codeph>. If
+this property is set to any value other than <codeph>test</codeph>, this
+property setting is ignored. When <i>derby.system.durability</i> is set to
<codeph>test</codeph>, the store system will not force I/O synchronization calls
for:</p>
<ul>
Modified: db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita Fri Jun 20 20:03:18 2014
@@ -18,16 +18,18 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperextdiagsevlevel">
<title>derby.stream.error.extendedDiagSeverityLevel</title>
+<shortdesc>The <i>derby.stream.error.extendedDiagSeverityLevel</i> property
+specifies whether thread dump information and extended diagnostic information
+are created, and at what level, in the event of a system crash or session
+error.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.extendedDiagSeverityLevel</indexterm>
+<keywords><indexterm>derby.stream.error.extendedDiagSeverityLevel property</indexterm>
<indexterm>thread dumps<indexterm>configuring</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies whether thread dump information and extended diagnostic information
-are created, and at what level, in the event of a system crash or session
-error. If errors have a severity level greater than or equal to the value of the
+<section>
+<p>If errors have a severity level greater than or equal to the value of the
<i>derby.stream.error.extendedDiagSeverityLevel</i> property, thread dump and
diagnostic information will appear in the <i>derby.log</i> file. In addition,
with IBM Java Virtual Machines (JVMs), a javacore file with additional
Modified: db/derby/docs/trunk/src/ref/rrefproperindexstatsauto.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperindexstatsauto.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperindexstatsauto.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperindexstatsauto.dita Fri Jun 20 20:03:18 2014
@@ -18,8 +18,11 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperindexstatsauto">
<title>derby.storage.indexStats.auto</title>
+<shortdesc>The <i>derby.storage.indexStats.auto</i> property, if set to true
+(the default), specifies that outdated index cardinality statistics are updated
+automatically during query compilation.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.indexStats.auto</indexterm>
+<keywords><indexterm>derby.storage.indexStats.auto property</indexterm>
<indexterm>databases<indexterm>configuring automatic updating of statistics</indexterm></indexterm>
<indexterm>statistics<indexterm>configuring automatic updating</indexterm></indexterm>
<indexterm>index statistics<indexterm>configuring automatic updating</indexterm></indexterm>
@@ -27,19 +30,17 @@ limitations under the License.
</metadata>
</prolog>
<refbody>
-<section><title>Function</title>
-<p>If this property is set to true (the default), outdated index cardinality
-statistics are updated automatically during query compilation. The query
-compiler schedules a job that updates the statistics in a separate thread.</p>
+<section>
+<p>The query compiler schedules a job that updates the statistics in a separate
+thread.</p>
<p>The thread that updates the statistics in the background may affect the
performance of the user threads. If this causes problems, you can set
<i>derby.storage.indexStats.auto</i> to false.</p>
<p>To diagnose problems with automatic updating of index statistics, an
application can set the property
-<i><xref href="rrefproperindexstatslog.dita#rrefproperindexstatslog"></xref></i>
-to true. The
-<i><xref href="rrefproperindexstatstrace.dita#rrefproperindexstatstrace"></xref></i>
-property can be used to provide more detailed information.</p>
+<i><xref href="rrefproperindexstatslog.dita"/></i> to true. The
+<i><xref href="rrefproperindexstatstrace.dita"/></i> property can be used to
+provide more detailed information.</p>
<p>For more information about index statistics, see "Working with cardinality
statistics" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
</section>
Modified: db/derby/docs/trunk/src/ref/rrefproperindexstatslog.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperindexstatslog.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperindexstatslog.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperindexstatslog.dita Fri Jun 20 20:03:18 2014
@@ -18,8 +18,13 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperindexstatslog">
<title>derby.storage.indexStats.log</title>
+<shortdesc>The <i>derby.storage.indexStats.log</i> property, if set to true,
+specifies that the thread that updates index cardinality statistics during query
+compilation will write messages to the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> system log
+(<i>derby.log</i>) every time it performs a task.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.indexStats.log</indexterm>
+<keywords><indexterm>derby.storage.indexStats.log property</indexterm>
<indexterm>databases<indexterm>logging automatic updating of statistics</indexterm></indexterm>
<indexterm>statistics<indexterm>logging automatic updating</indexterm></indexterm>
<indexterm>index statistics<indexterm>logging automatic updating</indexterm></indexterm>
@@ -27,20 +32,14 @@ limitations under the License.
</metadata>
</prolog>
<refbody>
-<section><title>Function</title>
-<p>If this property is set to true, the thread that updates index cardinality
-statistics during query compilation will write messages to the
-<ph conref="../conrefs.dita#prod/productshortname"></ph> system log
-(<i>derby.log</i>) every time it performs a task. The log entries should help
-you to diagnose problems with the automatic updating of index statistics.</p>
-<p>The
-<i><xref href="rrefproperindexstatstrace.dita#rrefproperindexstatstrace"></xref></i>
-property can be used to provide more detailed information and to specify where
-the trace output should appear.</p>
+<section>
+<p>The log entries should help you to diagnose problems with the automatic
+updating of index statistics.</p>
+<p>The <i><xref href="rrefproperindexstatstrace.dita"/></i> property can be used
+to provide more detailed information and to specify where the trace output
+should appear.</p>
<p>To disable the automatic updating of index statistics, set the database
-property
-<i><xref href="rrefproperindexstatsauto.dita#rrefproperindexstatsauto"></xref></i>
-to false.</p>
+property <i><xref href="rrefproperindexstatsauto.dita"/></i> to false.</p>
<p>For more information about index statistics, see "Working with cardinality
statistics" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
</section>
Modified: db/derby/docs/trunk/src/ref/rrefproperindexstatstrace.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperindexstatstrace.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperindexstatstrace.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperindexstatstrace.dita Fri Jun 20 20:03:18 2014
@@ -18,8 +18,11 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperindexstatstrace">
<title>derby.storage.indexStats.trace</title>
+<shortdesc>The <i>derby.storage.indexStats.trace</i> property allows you to
+enable more detailed logging of index cardinality statistics than the
+<i>derby.storage.indexStats.log</i> property provides.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.indexStats.trace</indexterm>
+<keywords><indexterm>derby.storage.indexStats.trace property</indexterm>
<indexterm>databases<indexterm>tracing automatic updating of statistics</indexterm></indexterm>
<indexterm>statistics<indexterm>tracing automatic updating</indexterm></indexterm>
<indexterm>index statistics<indexterm>tracing automatic updating</indexterm></indexterm>
@@ -27,11 +30,8 @@ limitations under the License.
</metadata>
</prolog>
<refbody>
-<section><title>Function</title>
-<p>This property allows you to enable more detailed logging of index cardinality
-statics than the
-<i><xref href="rrefproperindexstatslog.dita#rrefproperindexstatslog"></xref></i>
-property provides. It also allows you to specify where the tracing output should
+<section>
+<p>This property also allows you to specify where the tracing output should
appear. Valid values are as follows:</p>
<ul>
<li><codeph>off</codeph>
@@ -47,8 +47,9 @@ appear. Valid values are as follows:</p>
<p>Tracing output goes to both <i>derby.log</i> and standard output.</p>
</li>
</ul>
-<p>For more information about index statistics, see "Working with cardinality
-statistics" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
+<p>See <i><xref href="rrefproperindexstatslog.dita"/></i> for details on that
+property. For more information about index statistics, see "Working with
+cardinality statistics" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
</section>
<refsyn><title>Syntax</title>
<codeblock><b>derby.storage.indexStats.trace=
Modified: db/derby/docs/trunk/src/ref/rrefproperiterations.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperiterations.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperiterations.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperiterations.dita Fri Jun 20 20:03:18 2014
@@ -18,21 +18,22 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="rrefproperiterations" xml:lang="en-us">
<title>derby.authentication.builtin.iterations</title>
+<shortdesc>The <i>derby.authentication.builtin.iterations</i> property specifies
+the number of times to apply the hash function (which is specified by the
+<i>derby.authentication.builtin.algorithm</i> property) on the
+credentials.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.authentication.builtin.iterations</indexterm>
+<keywords><indexterm>derby.authentication.builtin.iterations property</indexterm>
<indexterm>password hashing<indexterm>configuring</indexterm></indexterm>
</keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Specifies the number of times to apply the hash function (which is specified
-by the
-<i><xref href="rrefproperbuiltinalgorithm.dita#rrefproperbuiltinalgorithm">derby.authentication.builtin.algorithm</xref></i>
-property) on the credentials. Iteration slows down attackers by forcing them to
-spend more time calculating hashes.</p>
-<p>This property is in effect only if NATIVE authentication is
-specified by the
-<i><xref href="rrefproper13766.dita#rrefproper13766">derby.authentication.provider</xref></i>
+<section>
+<p>Iteration slows down attackers by forcing them to spend more time calculating
+hashes. See <i><xref href="rrefproperbuiltinalgorithm.dita"/></i> for more
+information.</p>
+<p>This property is in effect only if NATIVE authentication is specified by the
+<i><xref href="rrefproper13766.dita">derby.authentication.provider</xref></i>
property and if the <i>derby.authentication.builtin.algorithm</i> property has a
non-null value.</p>
</section>
@@ -53,8 +54,7 @@ CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPE
</example>
<section><title>Dynamic or static</title>
<p>Dynamic; the change takes effect immediately. For information about dynamic
-changes to properties, see
-<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+changes to properties, see <xref href="crefproperdynstat.dita"/>.</p>
</section>
</refbody>
</reference>
Modified: db/derby/docs/trunk/src/ref/rrefproperlogboottrace.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperlogboottrace.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperlogboottrace.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperlogboottrace.dita Fri Jun 20 20:03:18 2014
@@ -19,15 +19,16 @@ limitations under the License.
-->
<reference id="rrefproperlogboottrace" xml:lang="en-us">
<title>derby.stream.error.logBootTrace</title>
+<shortdesc>The <i>derby.stream.error.logBootTrace</i> property specifies whether
+boot errors are written to the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> log file.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.logBootTrace</indexterm>
+<keywords><indexterm>derby.stream.error.logBootTrace property</indexterm>
<indexterm>Error log<indexterm>adding boot errors to</indexterm></indexterm>
<indexterm>double-booting issues<indexterm>diagnosing</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Specifies whether boot errors are written to the
-<ph conref="../conrefs.dita#prod/productshortname"></ph> log file.</p>
+<section>
<p>This property helps in diagnosing double-booting problems. Typically, when
two Java Virtual Machines (JVMs) or class loaders attempt to boot
<ph conref="../conrefs.dita#prod/productshortname"></ph>, an error
Modified: db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita Fri Jun 20 20:03:18 2014
@@ -18,27 +18,28 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperlogbuffersize">
<title>derby.replication.logBufferSize</title>
+<shortdesc>The <i>derby.replication.logBufferSize</i> property specifies the
+size of the replication log buffers in bytes.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.replication.logBufferSize</indexterm>
+<keywords><indexterm>derby.replication.logBufferSize property</indexterm>
<indexterm>replication<indexterm>specifying log buffer size</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies the size of the replication log buffers in bytes. These buffers
-store the log on the master side before it is shipped to the slave. There is a
-total of 10 such buffers. Large buffers increase memory usage but reduce
-the chance that the buffers will fill up (in turn increasing response time for
-transactions on the master, as described in the failure situation "The master
+<section>
+<p>These buffers store the log on the master side before it is shipped to the
+slave. There is a total of 10 such buffers.</p>
+<p>Large buffers increase memory usage but reduce the chance that the buffers
+will fill up (in turn increasing response time for transactions on the master,
+as described in the failure situation "The master
<ph conref="../conrefs.dita#prod/productshortname"></ph> instance is not able
to send log data to the slave at the same pace as the log is generated" in the
topic "Replication failure handling" in the
<ph conref="../conrefs.dita#pub/citadmin"></ph>).</p>
<p>You can also use the properties
-<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
-and
-<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
-to tune the rate at which the log is shipped from the master to the slave.</p>
+<i><xref href="rrefproperminlogshippinginterval.dita"/></i> and
+<i><xref href="rrefpropermaxlogshippinginterval.dita"/></i> to tune the rate at
+which the log is shipped from the master to the slave.</p>
</section>
<section><title>Minimum value</title>
<p>8192 (8 KB).</p>
Modified: db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita Fri Jun 20 20:03:18 2014
@@ -18,25 +18,26 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefpropermaxlogshippinginterval">
<title>derby.replication.maxLogShippingInterval</title>
+<shortdesc>The <i>derby.replication.maxLogShippingInterval</i> property
+specifies, in milliseconds, the longest interval between two consecutive
+shipments of the transaction log from the master to the slave.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.replication.maxLogShippingInterval</indexterm>
+<keywords><indexterm>derby.replication.maxLogShippingInterval property</indexterm>
<indexterm>replication<indexterm>specifying maximum log shipping interval</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies, in milliseconds, the longest interval between two consecutive
-shipments of the transaction log from the master to the slave. This property
-provides a "soft" guarantee that the slave will not deviate more than this
-number of milliseconds from the master.</p>
+<section>
+<p>This property provides a "soft" guarantee that the slave will not deviate
+more than this number of milliseconds from the master.</p>
<p>The value specified for the <i>derby.replication.maxLogShippingInterval</i>
property must be at least ten times the value specified for the
-<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
+<i><xref href="rrefproperminlogshippinginterval.dita"/></i>
property. If you set <i>derby.replication.maxLogShippingInterval</i> to a lower
value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes the
-<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
-property value to the value of the
-<i>derby.replication.maxLogShippingInterval</i> property divided by 10.</p>
+<i><xref href="rrefproperminlogshippinginterval.dita"/></i> property value to
+the value of the <i>derby.replication.maxLogShippingInterval</i> property
+divided by 10.</p>
</section>
<section><title>Default</title>
<p>5000 milliseconds (5 seconds).</p>
@@ -51,4 +52,6 @@ property value to the value of the
<p>This property is static; if you change it while
<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
does not take effect until you reboot.</p>
-</section></refbody></reference>
+</section>
+</refbody>
+</reference>
Modified: db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita Fri Jun 20 20:03:18 2014
@@ -18,24 +18,24 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperminlogshippinginterval">
<title>derby.replication.minLogShippingInterval</title>
+<shortdesc>The <i>derby.replication.minLogShippingInterval</i> property
+specifies, in milliseconds, the shortest interval between two consecutive
+shipments of the transaction log from the master to the slave.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.replication.minLogShippingInterval</indexterm>
+<keywords><indexterm>derby.replication.minLogShippingInterval property</indexterm>
<indexterm>replication<indexterm>specifying minimum log shipping interval</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies, in milliseconds, the shortest interval between two consecutive
-shipments of the transaction log from the master to the slave.</p>
+<section>
<p>The value specified for the <i>derby.replication.minLogShippingInterval</i>
property must be no more than one-tenth the value specified for the
-<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
-property. If you set <i>derby.replication.minLogShippingInterval</i> to a
-higher value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes
-the <i>derby.replication.minLogShippingInterval</i> property value to the value
-of the
-<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
-property divided by 10.</p>
+<i><xref href="rrefpropermaxlogshippinginterval.dita"/></i> property. If you set
+<i>derby.replication.minLogShippingInterval</i> to a higher value,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> changes the
+<i>derby.replication.minLogShippingInterval</i> property value to the value of
+the <i><xref href="rrefpropermaxlogshippinginterval.dita"/></i> property divided
+by 10.</p>
</section>
<section><title>Default</title>
<p>100 milliseconds.</p>
Modified: db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita Fri Jun 20 20:03:18 2014
@@ -18,19 +18,18 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefpropernoautoboot">
<title>derby.database.noAutoBoot</title>
+<shortdesc>The <i>derby.database.noAutoBoot</i> property specifies that a
+database should not be automatically booted at startup time.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.database.noAutoBoot</indexterm>
+<keywords><indexterm>derby.database.noAutoBoot property</indexterm>
<indexterm>databases<indexterm>configuring autobooting</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies that a database should not be automatically booted at startup
-time.</p>
+<section>
<p>When this property is set to true, this database is booted only on the first
connection. Otherwise, the database is booted at startup if the
-<i>derby.system.bootAll</i> property is set to true. See
-<i><xref href="rrefproperbootall.dita#rrefproperbootall"/></i> for details.</p>
+<i><xref href="rrefproperbootall.dita"/></i> property is set to true.</p>
</section>
<section><title>Default</title>
<p>False.</p>
Modified: db/derby/docs/trunk/src/ref/rrefproperpasswordmillis.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperpasswordmillis.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperpasswordmillis.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperpasswordmillis.dita Fri Jun 20 20:03:18 2014
@@ -18,22 +18,22 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="rrefproperpasswordmillis" xml:lang="en-us">
<title>derby.authentication.native.passwordLifetimeMillis</title>
+<shortdesc>The <i>derby.authentication.native.passwordLifetimeMillis</i>
+property specifies the number of milliseconds a NATIVE authentication password
+remains valid after being created, reset, or modified.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.authentication.native.passwordLifetimeMillis</indexterm>
+<keywords><indexterm>derby.authentication.native.passwordLifetimeMillis property</indexterm>
<indexterm>password expiration<indexterm>specifying</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Specifies the number of milliseconds a NATIVE authentication password remains
-valid after being created, reset, or modified. If the value is less than or
-equal to zero, the password never expires.</p>
+<section>
+<p>If the value is less than or equal to zero, the password never expires.</p>
<p>To avoid locking out the super-user, the password of the database owner of a
credentials database never expires.</p>
<p>If a connection attempt is made when the password's remaining lifetime is
less than a proportion of the maximum lifetime, a warning is issued. The
proportion is specified by the
-<i><xref href="rrefproperpasswordthreshold.dita#rrefproperpasswordthreshold">derby.authentication.native.passwordLifetimeThreshold</xref></i>
-property.</p>
+<i><xref href="rrefproperpasswordthreshold.dita"/></i> property.</p>
</section>
<refsyn><title>Syntax</title>
<codeblock><b>derby.authentication.native.passwordLifetimeMillis=<i>millis</i></b></codeblock>
Modified: db/derby/docs/trunk/src/ref/rrefproperpasswordthreshold.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperpasswordthreshold.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperpasswordthreshold.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperpasswordthreshold.dita Fri Jun 20 20:03:18 2014
@@ -18,15 +18,16 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="rrefproperpasswordthreshold" xml:lang="en-us">
<title>derby.authentication.native.passwordLifetimeThreshold</title>
+<shortdesc>The <i>derby.authentication.native.passwordLifetimeThreshold</i>
+property specifies the threshold that triggers a connection-time warning that a
+password is about to expire.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.authentication.native.passwordLifetimeThreshold</indexterm>
+<keywords><indexterm>derby.authentication.native.passwordLifetimeThreshold property</indexterm>
<indexterm>password expiration warning threshold<indexterm>specifying</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Specifies the threshold that triggers a connection-time warning that a
-password is about to expire. The threshold must be a DOUBLE value greater than
-0.0.</p>
+<section>
+<p>The threshold must be a DOUBLE value greater than 0.0.</p>
<p>To avoid locking out the super-user, the password of the database owner of a
credentials database never expires.</p>
<p>A warning is raised when a user logs in and the remaining lifetime of that
Modified: db/derby/docs/trunk/src/ref/rrefproperpreallocator.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperpreallocator.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperpreallocator.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperpreallocator.dita Fri Jun 20 20:03:18 2014
@@ -18,15 +18,16 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperpreallocator">
<title>derby.language.sequence.preallocator</title>
+<shortdesc>The <i>derby.language.sequence.preallocator</i> property specifies
+how many values to preallocate for sequences.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.language.sequence.preallocator</indexterm>
+<keywords><indexterm>derby.language.sequence.preallocator property</indexterm>
<indexterm>Sequence preallocation</indexterm>
<indexterm>Identity preallocation</indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies how many values to preallocate for sequences.</p>
+<section>
<p>If the database is shut down in an orderly fashion,
<ph conref="../conrefs.dita#prod/productshortname"></ph> will not leak unused
preallocated values. Instead, any unused values will be thrown away, and the
@@ -65,8 +66,7 @@ preallocates 100 values for each sequenc
</example>
<section><title>Scope</title>
<p>
-<xref
-href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref>,
+<xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref>,
<xref href="crefproper51399.dita#crefproper51399/rrefproper15705">database-wide</xref>
</p>
</section>
Modified: db/derby/docs/trunk/src/ref/rrefproperrollingfile.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrollingfile.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrollingfile.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperrollingfile.dita Fri Jun 20 20:03:18 2014
@@ -19,14 +19,15 @@ limitations under the License.
-->
<reference id="rrefproperrollingfile" xml:lang="en-us">
<title>derby.stream.error.style</title>
+<shortdesc>The <i>derby.stream.error.style</i> property specifies that the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> log file should be
+rolled over when it reaches a certain size.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.style</indexterm>
+<keywords><indexterm>derby.stream.error.style property</indexterm>
<indexterm>Error log<indexterm>rolling over</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
<section><title>Function</title>
-<p>Specifies that the <ph conref="../conrefs.dita#prod/productshortname"></ph>
-log file should be rolled over when it reaches a certain size.</p>
<p>If you set this property to <codeph>rollingFile</codeph> (the only supported
value), <ph conref="../conrefs.dita#prod/productshortname"></ph> by default
creates up to 10 rolling files named <i>derby-0.log</i>, <i>derby-1.log</i>, and
@@ -35,22 +36,21 @@ bytes.</p>
<p>You can override any of these defaults by setting one or more of the
following properties:</p>
<ul>
-<li><i><xref href="rrefproperrollingfilecount.dita#rrefproperrollingfilecount"></xref></i></li>
-<li><i><xref href="rrefproperrollingfilelimit.dita#rrefproperrollingfilelimit"></xref></i></li>
-<li><i><xref href="rrefproperrollingfilepattern.dita#rrefproperrollingfilepattern"></xref></i></li>
+<li><i><xref href="rrefproperrollingfilecount.dita"/></i></li>
+<li><i><xref href="rrefproperrollingfilelimit.dita"/></i></li>
+<li><i><xref href="rrefproperrollingfilepattern.dita"/></i></li>
</ul>
<p>If you set this property, the
-<i><xref href="rrefproper33027.dita#rrefproper33027">derby.stream.error.field</xref></i>,
-<i><xref href="rrefproper18151.dita#rrefproper18151">derby.stream.error.file</xref></i>,
-and
-<i><xref href="rrefproper35028.dita#rrefproper35028">derby.stream.error.method</xref></i>
+<i><xref href="rrefproper33027.dita">derby.stream.error.field</xref></i>,
+<i><xref href="rrefproper18151.dita">derby.stream.error.file</xref></i>, and
+<i><xref href="rrefproper35028.dita">derby.stream.error.method</xref></i>
properties are ignored.</p>
<p>This property works in accordance with the setting of the
-<i><xref href="rrefproper13217.dita#rrefproper13217">derby.infolog.append</xref></i>
-property. If <i>derby.infolog.append</i> is not set or is set to false, any
-existing log files will be rolled over and a new log file will be created when
-the <ph conref="../conrefs.dita#prod/productshortname"></ph> engine is started.
-If <i>derby.infolog.append</i> is set to true, the latest existing log file, if
+<i><xref href="rrefproper13217.dita">derby.infolog.append</xref></i> property.
+If <i>derby.infolog.append</i> is not set or is set to false, any existing log
+files will be rolled over and a new log file will be created when the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> engine is started. If
+<i>derby.infolog.append</i> is set to true, the latest existing log file, if
any, will be appended to.</p>
</section>
<refsyn><title>Syntax</title>
Modified: db/derby/docs/trunk/src/ref/rrefproperrollingfilecount.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrollingfilecount.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrollingfilecount.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperrollingfilecount.dita Fri Jun 20 20:03:18 2014
@@ -19,26 +19,22 @@ limitations under the License.
-->
<reference id="rrefproperrollingfilecount" xml:lang="en-us">
<title>derby.stream.error.rollingFile.count</title>
+<shortdesc>The <i>derby.stream.error.rollingFile.count</i> property specifies
+the number of rolling log files to permit before deleting the oldest file when
+rolling to the next file, if <i>derby.stream.error.style</i> is set to
+<codeph>rollingFile</codeph>.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.rollingFile.count</indexterm>
+<keywords><indexterm>derby.stream.error.rollingFile.count property</indexterm>
<indexterm>Error log<indexterm>number of files</indexterm></indexterm>
<indexterm>Error log<indexterm>rolling over</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is set to
-<codeph>rollingFile</codeph>, this property specifies the number of rolling log
-files to permit before deleting the oldest file when rolling to the next
-file.</p>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is not set,
-this property setting is ignored.</p>
+<section>
+<p>If <i><xref href="rrefproperrollingfile.dita"/></i> is not set, this
+property setting is ignored.</p>
<p>You can override other rolling log file defaults by setting
-<i><xref href="rrefproperrollingfilelimit.dita#rrefproperrollingfilelimit"></xref></i>
-or
-<i><xref href="rrefproperrollingfilepattern.dita#rrefproperrollingfilepattern"></xref></i>.
-</p>
+<i><xref href="rrefproperrollingfilelimit.dita"/></i> or
+<i><xref href="rrefproperrollingfilepattern.dita"/></i>.</p>
</section>
<refsyn><title>Syntax</title>
<codeblock><b>derby.stream.error.rollingFile.count=<i>count</i></b></codeblock>
Modified: db/derby/docs/trunk/src/ref/rrefproperrollingfilelimit.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrollingfilelimit.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrollingfilelimit.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperrollingfilelimit.dita Fri Jun 20 20:03:18 2014
@@ -19,26 +19,22 @@ limitations under the License.
-->
<reference id="rrefproperrollingfilelimit" xml:lang="en-us">
<title>derby.stream.error.rollingFile.limit</title>
+<shortdesc>The <i>derby.stream.error.rollingFile.limit</i> property specifies
+the number of bytes to which to limit each rolling log file before it is rolled
+over to the next file, if <i>derby.stream.error.style</i> is set to
+<codeph>rollingFile</codeph>.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.rollingFile.limit</indexterm>
+<keywords><indexterm>derby.stream.error.rollingFile.limit property</indexterm>
<indexterm>Error log<indexterm>size limit</indexterm></indexterm>
<indexterm>Error log<indexterm>rolling over</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is set to
-<codeph>rollingFile</codeph>, this property specifies the number of bytes to
-which to limit each rolling log file before it is rolled over to the next
-file.</p>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is not set,
-this property setting is ignored.</p>
+<section>
+<p>If <i><xref href="rrefproperrollingfile.dita"/></i> is not set, this property
+setting is ignored.</p>
<p>You can override other rolling log file defaults by setting
-<i><xref href="rrefproperrollingfilecount.dita#rrefproperrollingfilecount"></xref></i>
-or
-<i><xref href="rrefproperrollingfilepattern.dita#rrefproperrollingfilepattern"></xref></i>.
-</p>
+<i><xref href="rrefproperrollingfilecount.dita"/></i> or
+<i><xref href="rrefproperrollingfilepattern.dita"/></i>.</p>
</section>
<refsyn><title>Syntax</title>
<codeblock><b>derby.stream.error.rollingFile.limit=<i>limit</i></b></codeblock>
Modified: db/derby/docs/trunk/src/ref/rrefproperrollingfilepattern.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrollingfilepattern.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrollingfilepattern.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperrollingfilepattern.dita Fri Jun 20 20:03:18 2014
@@ -19,25 +19,22 @@ limitations under the License.
-->
<reference id="rrefproperrollingfilepattern" xml:lang="en-us">
<title>derby.stream.error.rollingFile.pattern</title>
+<shortdesc>The <i>derby.stream.error.rollingFile.pattern</i> property specifies
+the naming pattern to use for the rolling log files, if
+<i>derby.stream.error.style</i> is set to
+<codeph>rollingFile</codeph>.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.stream.error.rollingFile.pattern</indexterm>
+<keywords><indexterm>derby.stream.error.rollingFile.pattern property</indexterm>
<indexterm>Error log<indexterm>file name pattern</indexterm></indexterm>
<indexterm>Error log<indexterm>rolling over</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is set to
-<codeph>rollingFile</codeph>, this property specifies the naming pattern to use
-for the rolling log files.</p>
-<p>If <i><xref
-href="rrefproperrollingfile.dita#rrefproperrollingfile"></xref></i> is not set,
-this property setting is ignored.</p>
+<section>
+<p>If <i><xref href="rrefproperrollingfile.dita"/></i> is not set, this property
+setting is ignored.</p>
<p>You can override other rolling log file defaults by setting
-<i><xref href="rrefproperrollingfilecount.dita#rrefproperrollingfilecount"></xref></i>
-or
-<i><xref href="rrefproperrollingfilelimit.dita#rrefproperrollingfilelimit"></xref></i>.
-</p>
+<i><xref href="rrefproperrollingfilecount.dita"/></i> or
+<i><xref href="rrefproperrollingfilelimit.dita"/></i>.</p>
<p>A pattern consists of a string that includes the following special components
that will be replaced at runtime.</p>
<table frame="all"><title>Rolling log file pattern components</title>
Modified: db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita Fri Jun 20 20:03:18 2014
@@ -18,8 +18,10 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperrowlocking">
<title>derby.storage.rowLocking</title>
+<shortdesc>The <i>derby.storage.rowLocking</i> property, if set to true, enables
+row-level locking.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.rowLocking</indexterm>
+<keywords><indexterm>derby.storage.rowLocking property</indexterm>
<indexterm>databases<indexterm>configuring row-level locking</indexterm></indexterm>
<indexterm>databases<indexterm>configuring table-level locking</indexterm></indexterm>
<indexterm>lock granularity<indexterm>configuring</indexterm></indexterm>
@@ -27,9 +29,8 @@ limitations under the License.
</metadata>
</prolog>
<refbody>
-<section><title>Function</title>
-<p>If set to true, enables row-level locking. When you disable row-level
-locking, you use table-level locking.</p>
+<section>
+<p>When you disable row-level locking, you use table-level locking.</p>
<p>Row-level locking uses more system resources but allows greater concurrency,
which works better in multi-user systems. Table-level locking works best with
single-user applications or read-only applications.</p>
Modified: db/derby/docs/trunk/src/ref/rrefpropersaltlength.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropersaltlength.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropersaltlength.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefpropersaltlength.dita Fri Jun 20 20:03:18 2014
@@ -18,21 +18,21 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="rrefpropersaltlength" xml:lang="en-us">
<title>derby.authentication.builtin.saltLength</title>
+<shortdesc>The <i>derby.authentication.builtin.saltLength</i> property specifies
+the number of bytes of random salt that will be added to users' credentials
+before hashing them.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.authentication.builtin.saltLength</indexterm>
+<keywords><indexterm>derby.authentication.builtin.saltLength property</indexterm>
<indexterm>password hashing<indexterm>configuring</indexterm></indexterm>
</keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Specifies the number of bytes of random salt that will be added to users'
-credentials before hashing them. Random salt has the effect of making it
-difficult for attackers to decode passwords by constructing rainbow tables.</p>
-<p>This property is in effect only if NATIVE authentication is
-specified by the
-<i><xref href="rrefproper13766.dita#rrefproper13766">derby.authentication.provider</xref></i>
-property and if the
-<i><xref href="rrefproperbuiltinalgorithm.dita#rrefproperbuiltinalgorithm">derby.authentication.builtin.algorithm</xref></i>
+<section>
+<p>Random salt has the effect of making it difficult for attackers to decode
+passwords by constructing rainbow tables.</p>
+<p>This property is in effect only if NATIVE authentication is specified by the
+<i><xref href="rrefproper13766.dita">derby.authentication.provider</xref></i>
+property and if the <i><xref href="rrefproperbuiltinalgorithm.dita"/></i>
property has a non-null value.</p>
</section>
<refsyn><title>Syntax</title>
@@ -51,8 +51,7 @@ CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPE
</example>
<section><title>Dynamic or static</title>
<p>Dynamic; the change takes effect immediately. For information about dynamic
-changes to properties, see
-<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+changes to properties, see <xref href="crefproperdynstat.dita"/>.</p>
</section>
</refbody>
</reference>
Modified: db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita Fri Jun 20 20:03:18 2014
@@ -21,16 +21,17 @@ specific language governing permissions
under the License.-->
<reference id="rrefpropersqlauth" xml:lang="en-us">
<title>derby.database.sqlAuthorization</title>
+<shortdesc>The <i>derby.database.sqlAuthorization</i> property, one of the user
+authorization properties, enables the SQL standard authorization mode for the
+database or system on which this property is set.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.database.sqlAuthorization</indexterm>
+<keywords><indexterm>derby.database.sqlAuthorization property</indexterm>
<indexterm>properties<indexterm>derby.database.sqlAuthorization</indexterm></indexterm>
</keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>One of the user authorization properties.</p>
-<p>Enables the SQL standard authorization mode for the database or system on
-which this property is set. The possible values are:</p>
+<section>
+<p>The possible values are:</p>
<ul>
<li><i>TRUE</i> <p>SQL authorization for the database or system is enabled,
which allows the use of GRANT and REVOKE statements.</p></li>
@@ -45,7 +46,7 @@ If the databases already exist, you can
property.</note>
<p><ph conref="../conrefs.dita#prod/productshortname"></ph> uses the type of
user authentication that is specified with the
-<i><xref href="rrefproper13766.dita#rrefproper13766">derby.authentication.provider</xref></i>
+<i><xref href="rrefproper13766.dita">derby.authentication.provider</xref></i>
property.</p>
<p>If the <i>derby.authentication.provider</i> property specifies
NATIVE authentication, <ph conref="../conrefs.dita#prod/productshortname"></ph>
Modified: db/derby/docs/trunk/src/ref/rrefproperstatementcachesize.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperstatementcachesize.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperstatementcachesize.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperstatementcachesize.dita Fri Jun 20 20:03:18 2014
@@ -20,16 +20,17 @@ limitations under the License.
-->
<reference id="rrefproperstatementcachesize" xml:lang="en-us">
<title>derby.language.statementCacheSize</title>
+<shortdesc>The <i>derby.language.statementCacheSize</i> property defines the
+size, in number of statements, of the database statement cache (prepared
+statements kept in memory).</shortdesc>
<prolog><metadata>
<keywords>
-<indexterm>derby.language.statementCacheSize</indexterm>
+<indexterm>derby.language.statementCacheSize property</indexterm>
<indexterm>statement cache size<indexterm>configuring</indexterm></indexterm>
</keywords>
</metadata></prolog>
<refbody>
-<section><title>Function</title>
-<p>Defines the size, in number of statements, of the database statement cache
-(prepared statements kept in memory).</p>
+<section>
<p>This property controls the number of precompiled statements which
<ph conref="../conrefs.dita#prod/productshortname"></ph> keeps in its statement
cache. Consider raising this number if statement preparation is taking too much
Modified: db/derby/docs/trunk/src/ref/rrefproperstormin.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperstormin.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperstormin.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperstormin.dita Fri Jun 20 20:03:18 2014
@@ -18,21 +18,24 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperstormin">
<title>derby.storage.minimumRecordSize</title>
+<shortdesc>The <i>derby.storage.minimumRecordSize</i> property indicates the
+minimum user row size in bytes for on-disk database pages for tables when you
+are creating a table.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.storage.minimumRecordSize</indexterm>
+<keywords><indexterm>derby.storage.minimumRecordSize property</indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Indicates the minimum user row size in bytes for on-disk database pages for
-tables when you are creating a table. This property ensures that there is enough
-room for a row to grow on a page when updated without having to overflow. This
-is generally most useful for VARCHAR and VARCHAR FOR BIT DATA data types and for
-tables that are updated a lot, in which the rows start small and grow due to
-updates. Reserving the space at the time of insertion minimizes row overflow
-due to updates, but it can result in wasted space. Set the property prior to
-issuing the CREATE TABLE statement.</p>
-<p>See also <i><xref href="rrefproper28026.dita#rrefproper28026"/>.</i></p>
+<section>
+<p>This property ensures that there is enough room for a row to grow on a page
+when updated without having to overflow. This is generally most useful for
+VARCHAR and VARCHAR FOR BIT DATA data types and for tables that are updated
+often, in which the rows start small and grow due to updates. Reserving the
+space at the time of insertion minimizes row overflow due to updates, but it can
+result in wasted space. Set the property prior to issuing the CREATE TABLE
+statement.</p>
+<p>See also
+<i><xref href="rrefproper28026.dita">derby.storage.pageReservedSpace</xref></i>.</p>
</section>
<section><title>Valid conglomerates</title>
<p>Tables only.</p>
@@ -44,8 +47,8 @@ issuing the CREATE TABLE statement.</p>
<p>12 bytes.</p>
</section>
<section><title>Maximum value</title>
-<p><i><xref href="rrefproper40688.dita#rrefproper40688">derby.storage.pageSize</xref></i> * (1
-- <i><xref href="rrefproper28026.dita#rrefproper28026">derby.storage.pageReservedSpace</xref></i>/100) "
+<p><i><xref href="rrefproper40688.dita">derby.storage.pageSize</xref></i> * (1
+- <i><xref href="rrefproper28026.dita">derby.storage.pageReservedSpace</xref></i>/100) "
100.</p>
<p>If you set this property to a value outside the legal range, <ph conref="../conrefs.dita#prod/productshortname"></ph> uses
the default value.</p>
@@ -62,5 +65,5 @@ CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPE
<section><title>Dynamic or static</title>
<p>This property is dynamic; if you change it while <ph conref="../conrefs.dita#prod/productshortname"></ph> is running,
the change takes effect immediately. For information about dynamic changes
-to properties, see <xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+to properties, see <xref href="crefproperdynstat.dita"/>.</p>
</section></refbody></reference>
Modified: db/derby/docs/trunk/src/ref/rrefproperverbose.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperverbose.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperverbose.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperverbose.dita Fri Jun 20 20:03:18 2014
@@ -18,16 +18,15 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperverbose">
<title>derby.replication.verbose</title>
+<shortdesc>The <i>derby.replication.verbose</i> property specifies whether
+replication messages are written to the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> log.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.replication.verbose</indexterm>
+<keywords><indexterm>derby.replication.verbose property</indexterm>
<indexterm>replication<indexterm>specifying message logging</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies whether replication messages are written to the
-<ph conref="../conrefs.dita#prod/productshortname"></ph> log.</p>
-</section>
<section><title>Default</title>
<p>True.</p>
</section>
Modified: db/derby/docs/trunk/src/ref/rrefproperxatrantimeout.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperxatrantimeout.dita?rev=1604269&r1=1604268&r2=1604269&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperxatrantimeout.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperxatrantimeout.dita Fri Jun 20 20:03:18 2014
@@ -18,18 +18,20 @@ limitations under the License.
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="rrefproperxatrantimeout">
<title>derby.jdbc.xaTransactionTimeout</title>
+<shortdesc>The <i>derby.jdbc.xaTransactionTimeout</i> property specifies the
+default value of the XA transaction timeout that is used when a user either does
+not specify the XA transaction timeout or requests to use the default
+value.</shortdesc>
<prolog><metadata>
-<keywords><indexterm>derby.jdbc.xaTransactionTimeout</indexterm>
+<keywords><indexterm>derby.jdbc.xaTransactionTimeout property</indexterm>
<indexterm>XA Transactions<indexterm>transaction timeout property</indexterm></indexterm>
</keywords>
</metadata>
</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies the default value of the XA transaction timeout that is used when
-a user either does not specify the XA transaction timeout or requests to use the
-default value. It is possible to use the
-<codeph>XAResource.setTransactionTimeout</codeph> method to specify the XA
-transaction timeout value for the global transaction.</p>
+<section>
+<p>It is possible to use the <codeph>XAResource.setTransactionTimeout</codeph>
+method to specify the XA transaction timeout value for the global
+transaction.</p>
<p>A zero or negative value for this property means that the transaction timeout
is not used.</p>
</section>
@@ -45,6 +47,7 @@ CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPE
</example>
<section><title>Dynamic or static</title>
<p>Dynamic; the change takes effect immediately. For information about dynamic
-changes to properties, see
-<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
-</section></refbody></reference>
+changes to properties, see <xref href="crefproperdynstat.dita"/>.</p>
+</section>
+</refbody>
+</reference>