svn commit: r1080223 - in /db/derby/docs/trunk/src: devguide/cdevdvlp25889.dita ref/rrefproper18151.dita ref/rrefproper33027.dita ref/rrefproper35028.dita

[ch...@apache.org]

Author: chaase3
Date: Thu Mar 10 13:52:10 2011
New Revision: 1080223

URL: http://svn.apache.org/viewvc?rev=1080223&view=rev
Log:
DERBY-5051 Update the docs to include the additional information available in derby.log. This information will be useful from product supportability stand point

Added more information about logging of the derby.stream.error properties.

Patches: DERBY-5051-2.diff

Modified:
    db/derby/docs/trunk/src/devguide/cdevdvlp25889.dita
    db/derby/docs/trunk/src/ref/rrefproper18151.dita
    db/derby/docs/trunk/src/ref/rrefproper33027.dita
    db/derby/docs/trunk/src/ref/rrefproper35028.dita

Modified: db/derby/docs/trunk/src/devguide/cdevdvlp25889.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdvlp25889.dita?rev=1080223&r1=1080222&r2=1080223&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdvlp25889.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdvlp25889.dita Thu Mar 10 13:52:10 2011
@@ -21,22 +21,24 @@ limitations under the License.
 <concept id="cdevdvlp25889" xml:lang="en-us">
 <title>The error log</title>
 <shortdesc>Once you create or connect to a database within a system, <ph conref="../conrefs.dita#prod/productshortname"></ph> begins
-outputting information and error messages to the error log.</shortdesc>
+outputting information and error messages to the error log. Typically,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> writes this information
+to a file called <i>derby.log</i> in the system directory.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>Error log<indexterm>description</indexterm></indexterm>
 </keywords>
 </metadata></prolog>
 <conbody>
-<p>Typically, <ph conref="../conrefs.dita#prod/productshortname"></ph> writes
-this information to a log called <i>derby.log</i> in the system directory.
-Alternatively, you can have <ph conref="../conrefs.dita#prod/productshortname"></ph> send
+<p>Alternatively, you can have <ph conref="../conrefs.dita#prod/productshortname"></ph> send
 messages to a stream, using the <i>derby.stream.error.method</i> or
 <i>derby.stream.error.field</i> property, or to a different file, using the
-<i>derby.stream.error.file</i> property.
+<i>derby.stream.error.file</i> property. If you use any of these
+properties, the property setting will appear in the log.</p>
+<p>
 By default, <ph conref="../conrefs.dita#prod/productshortname"></ph> overwrites <i>derby.log</i> when
 you start the system. You can configure <ph conref="../conrefs.dita#prod/productshortname"></ph> to
-append to the log with the <i>derby.infolog.append</i> property.
-For information on setting these properties, see the
+append to the log with the <i>derby.infolog.append</i> property.</p>
+<p>For information on setting all of these properties, see the
 <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/ref/rrefproper18151.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper18151.dita?rev=1080223&r1=1080222&r2=1080223&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper18151.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper18151.dita Thu Mar 10 13:52:10 2011
@@ -32,6 +32,8 @@ name is relative, it is taken as relativ
 and
 <i><xref href="rrefproper33027.dita#rrefproper33027">derby.stream.error.field</xref></i>
 properties are ignored.</p>
+<p>If you specify this property, the property setting appears in the error
+log.</p>
 </section>
 <section><title>Default</title>
 <p><i>derby.log</i>.</p>

Modified: db/derby/docs/trunk/src/ref/rrefproper33027.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper33027.dita?rev=1080223&r1=1080222&r2=1080223&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper33027.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper33027.dita Thu Mar 10 13:52:10 2011
@@ -37,7 +37,10 @@ stream (<i>java.lang.System.err</i>).</p
 <p>If the field does not exist or is inaccessible, the error stream defaults to
 the system error stream. 
 <ph conref="../conrefs.dita#prod/productshortname"></ph> will not call the
-<i>close()</i> method of the object obtained from the field.</p> </section>
+<i>close()</i> method of the object obtained from the field.</p>
+<p>If you specify this property, the property setting appears in the error
+log.</p>
+</section>
 <section><title>Default</title>
 <p>None.</p> </section>
 <example><title>Example</title>

Modified: db/derby/docs/trunk/src/ref/rrefproper35028.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper35028.dita?rev=1080223&r1=1080222&r2=1080223&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper35028.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper35028.dita Thu Mar 10 13:52:10 2011
@@ -42,7 +42,10 @@ null, the error stream defaults to the s
 not exist or is inaccessible, the error stream defaults to the system error
 stream (<i>java.lang.System.err</i>).</p>
 <p>If the value of this property is set, the property
-<i>derby.stream.error.field</i> is ignored.</p> </section>
+<i>derby.stream.error.field</i> is ignored.</p>
+<p>If you specify this property, the property setting appears in the error
+log.</p>
+</section>
 <section><title>Default</title>
 <p>Not set.</p> </section>
 <example><title>Example</title>