db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r1148776 - in /db/derby/docs/trunk/src: adminguide/ devguide/ ref/
Date Wed, 20 Jul 2011 13:54:35 GMT
Author: chaase3
Date: Wed Jul 20 13:54:31 2011
New Revision: 1148776

URL: http://svn.apache.org/viewvc?rev=1148776&view=rev
Log:
DERBY-5339  Sample domain names should follow RFC 2606 conventions

Updated 17 topics (3 Admin Guide, 7 Developer's Guide, 7 Reference Manual).

Patch: DERBY-5339.diff

Modified:
    db/derby/docs/trunk/src/adminguide/cadminappsclienttracing.dita
    db/derby/docs/trunk/src/adminguide/cadminnetservsecurity.dita
    db/derby/docs/trunk/src/adminguide/tadminnetservbasic.dita
    db/derby/docs/trunk/src/devguide/cdevcsecure876908.dita
    db/derby/docs/trunk/src/devguide/cdevspecialtfbasic.dita
    db/derby/docs/trunk/src/devguide/cdevspecialtfexample.dita
    db/derby/docs/trunk/src/devguide/cdevspecialtfoptexample.dita
    db/derby/docs/trunk/src/devguide/cdevspecialtfrestr.dita
    db/derby/docs/trunk/src/devguide/cdevspecialudt.dita
    db/derby/docs/trunk/src/devguide/rdevcsecure125.dita
    db/derby/docs/trunk/src/ref/rrefcallprocedure.dita
    db/derby/docs/trunk/src/ref/rrefcreateprocedurestatement.dita
    db/derby/docs/trunk/src/ref/rrefproper26978.dita
    db/derby/docs/trunk/src/ref/rrefproper27355.dita
    db/derby/docs/trunk/src/ref/rrefproperauthdn.dita
    db/derby/docs/trunk/src/ref/rrefsqljargmatching.dita
    db/derby/docs/trunk/src/ref/rrefsqljcreatetype.dita

Modified: db/derby/docs/trunk/src/adminguide/cadminappsclienttracing.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminappsclienttracing.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminappsclienttracing.dita (original)
+++ db/derby/docs/trunk/src/adminguide/cadminappsclienttracing.dita Wed Jul 20 13:54:31 2011
@@ -60,7 +60,7 @@ attribute" in the <ph conref="../conrefs
 level is <codeph>ClientDataSource.TRACE_ALL</codeph>. You can choose the tracing
 level by calling the <codeph>setTraceLevel(int level)</codeph> method or by
 setting the <codeph>traceLevel=<i>value</i></codeph> URL attribute:</p>
-<codeblock>String url = "jdbc:derby://samplehost.sampledomain.com:1528/mydb" +
+<codeblock>String url = "jdbc:derby://samplehost.example.com:1528/mydb" +
  ";traceFile=/u/user1/trace.out" +
  ";traceLevel=" +
  org.apache.derby.jdbc.ClientDataSource.TRACE_PROTOCOL_FLOWS;

Modified: db/derby/docs/trunk/src/adminguide/cadminnetservsecurity.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminnetservsecurity.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminnetservsecurity.dita (original)
+++ db/derby/docs/trunk/src/adminguide/cadminnetservsecurity.dita Wed Jul 20 13:54:31 2011
@@ -33,11 +33,11 @@ in the <codeph><i>java org.apache.derby.
 <p>In the following example the server will listen only on localhost and clients
 cannot access the server from another host.</p>
 <codeblock><b>java org.apache.derby.drda.NetworkServerControl start</b></codeblock>
-<p>In the following example, the server runs on host machine <codeph><i>sampleserver.sampledomain.com</i></codeph>
and
+<p>In the following example, the server runs on host machine <codeph><i>sampleserver.example.com</i></codeph>
and
 also listens for clients from other hosts. Clients must specify the server
-in the URL or DataSource as sampleserver.sampledomain.com:</p>
+in the URL or DataSource as sampleserver.example.com:</p>
 <codeblock><b>java org.apache.derby.drda.NetworkServerControl start 
-   -h sampleserver.sampledomain.com</b></codeblock>
+   -h sampleserver.example.com</b></codeblock>
 <p>To start the Network Server so that it will listen on all interfaces, start
 with an IP address of <codeph><i>0.0.0.0</i></codeph>, shown in the
following
 example:  <codeblock><b>java org.apache.derby.drda.NetworkServerControl start
-h 0.0.0.0</b></codeblock></p>

Modified: db/derby/docs/trunk/src/adminguide/tadminnetservbasic.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/tadminnetservbasic.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/tadminnetservbasic.dita (original)
+++ db/derby/docs/trunk/src/adminguide/tadminnetservbasic.dita Wed Jul 20 13:54:31 2011
@@ -145,7 +145,7 @@ grant codeBase "${derby.install.url}derb
 // org.apache.derby.drda.NetworkServerControl constructor in the API
 // or via the property derby.drda.host; the default is localhost.
 // You may want to restrict allowed hosts, e.g. to hosts in a specific
-// subdomain, e.g. "*.acme.com".
+// subdomain, e.g. "*.example.com".
 
   permission java.net.SocketPermission "*", "accept"; 
 

Modified: db/derby/docs/trunk/src/devguide/cdevcsecure876908.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevcsecure876908.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevcsecure876908.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevcsecure876908.dita Wed Jul 20 13:54:31 2011
@@ -29,9 +29,9 @@ by a unique name, called a DN (distingui
 of selected attributes from each entry in the tree along a path leading from
 the root down to the named entry, ordered from right to left. For example,
 a DN for a user might look like this:</p>
-<codeblock>cn=mary,ou=People,o=FlyTours.com
+<codeblock>cn=mary,ou=People,o=example.com
 
-uid=mary,ou=People,o=FlyTours.com</codeblock>
+uid=mary,ou=People,o=example.com</codeblock>
 <p>The allowable entries for the name are defined by the entry's <i>objectClass</i>.
</p>
 <p>An LDAP client can bind to the directory (successfully log in) if it provides
 a user ID and password. The user ID must be a DN, the fully qualified list
@@ -65,14 +65,14 @@ user DNs. This parameter is optional if 
 server. If specified, this value must be a DN recognized by the directory
 service, and it must also have the authority to search for the entries.</p> <p>If
 not set, it defaults to an anonymous search using the root DN specified by
-the <i>derby.authentication.ldap.searchBase</i> property. For example:</p>
<codeblock>uid=guest,o=FlyTours.com</codeblock></li>
+the <i>derby.authentication.ldap.searchBase</i> property. For example:</p>
<codeblock>uid=guest,o=example.com</codeblock></li>
 <li><i>derby.authentication.ldap.searchAuthPW (optional)</i>   <p>Specifies
 the password to use for the guest user configured above to bind to the directory
 service when looking up the DN. If not set, it defaults to an anonymous search
 using the root DN specified by the <i>derby.authentication.ldap.searchBase</i>
property.</p> <codeblock>myPassword</codeblock></li>
 <li><i>derby.authentication.ldap.searchBase (optional)</i>   <p>Specifies
 the root DN of the point in your hierarchy from which to begin a guest search
-for the user's DN. For example:</p> <codeblock>ou=people,o=FlyTours.com</codeblock><p>When
+for the user's DN. For example:</p> <codeblock>ou=people,o=example.com</codeblock><p>When
 using Netscape Directory Server, set this property to the root DN, the special
 entry to which access control does not apply (optional).</p></li>
 </ul>

Modified: db/derby/docs/trunk/src/devguide/cdevspecialtfbasic.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialtfbasic.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialtfbasic.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialtfbasic.dita Wed Jul 20 13:54:31 2011
@@ -82,7 +82,7 @@ RETURNS TABLE
 LANGUAGE JAVA
 PARAMETER STYLE DERBY_JDBC_RESULT_SET
 READS SQL DATA
-EXTERNAL NAME 'com.acme.hrSchema.EmployeeTable.read'
+EXTERNAL NAME 'com.example.hrSchema.EmployeeTable.read'
 </codeblock>
 
 <p>

Modified: db/derby/docs/trunk/src/devguide/cdevspecialtfexample.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialtfexample.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialtfexample.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialtfexample.dita Wed Jul 20 13:54:31 2011
@@ -29,7 +29,7 @@ database.</shortdesc>
 </metadata></prolog>
 <conbody>
 <codeblock>
-package com.acme.hrSchema;
+package com.example.hrSchema;
 
 import java.sql.*;
 

Modified: db/derby/docs/trunk/src/devguide/cdevspecialtfoptexample.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialtfoptexample.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialtfoptexample.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialtfoptexample.dita Wed Jul 20 13:54:31 2011
@@ -34,7 +34,7 @@ table function shown before in
 </p>
 
 <codeblock>
-package com.acme.hrSchema;
+package com.example.hrSchema;
 
 import java.io.Serializable;
 import java.sql.*;

Modified: db/derby/docs/trunk/src/devguide/cdevspecialtfrestr.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialtfrestr.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialtfrestr.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialtfrestr.dita Wed Jul 20 13:54:31 2011
@@ -117,7 +117,7 @@ returns table
 language java
 parameter style DERBY_JDBC_RESULT_SET
 no sql
-external name 'com.acme.portal.ForeignQueries.foreignDatabaseEmployeeTable'
+external name 'com.example.portal.ForeignQueries.foreignDatabaseEmployeeTable'
 </codeblock>
 <p>Finally, you invoke the table function in a query:</p>
 <codeblock>

Modified: db/derby/docs/trunk/src/devguide/cdevspecialudt.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialudt.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialudt.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialudt.dita Wed Jul 20 13:54:31 2011
@@ -58,7 +58,7 @@ header comment for <i>java.io.Serializab
 <i>java.io.Serializable</i> and can evolve itself over time. For example, here
 is the first version of such a class:</p>
 <codeblock>
-package com.acme.types;
+package com.example.types;
 
 import java.io.*;
 import java.math.*;
@@ -112,7 +112,7 @@ which adds a new field. When old version
 read from the database, they upgrade themselves on the fly. Changes are shown
 in <b>bold</b>:</p>
 <codeblock>
-package com.acme.types;
+package com.example.types;
 
 import java.io.*;
 import java.math.*;

Modified: db/derby/docs/trunk/src/devguide/rdevcsecure125.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/rdevcsecure125.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/rdevcsecure125.dita (original)
+++ db/derby/docs/trunk/src/devguide/rdevcsecure125.dita Wed Jul 20 13:54:31 2011
@@ -43,7 +43,7 @@ derby.authentication.provider=LDAP
 <b># the host name and port number of the LDAP server</b>
 derby.authentication.server=godfrey:389
 <b># the search base for user names</b>
-derby.authentication.ldap.searchBase=o=oakland.mycompany.com
+derby.authentication.ldap.searchBase=o=oakland.example.com
 <b># explicitly show the access mode for databases (this is default)</b>
 derby.database.defaultConnectionMode=fullAccess</codeblock></example>
 <section><p>With these settings, all users must be authenticated by the LDAP

Modified: db/derby/docs/trunk/src/ref/rrefcallprocedure.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefcallprocedure.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefcallprocedure.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefcallprocedure.dita Wed Jul 20 13:54:31 2011
@@ -50,7 +50,7 @@ current schema (and current role, if rel
 <codeblock><b>CREATE PROCEDURE SALES.TOTAL_REVENUE(IN S_MONTH INTEGER,
     IN S_YEAR INTEGER, OUT TOTAL DECIMAL(10,2))
     PARAMETER STYLE JAVA READS SQL DATA LANGUAGE JAVA EXTERNAL NAME 
-    'com.acme.sales.calculateRevenueByMonth';
+    'com.example.sales.calculateRevenueByMonth';
 CALL SALES.TOTAL_REVENUE(?,?,?);
 </b></codeblock></section>
 </refbody></reference>

Modified: db/derby/docs/trunk/src/ref/rrefcreateprocedurestatement.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefcreateprocedurestatement.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefcreateprocedurestatement.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefcreateprocedurestatement.dita Wed Jul 20 13:54:31 2011
@@ -150,6 +150,6 @@ elements: <ul>
 <section><title>Example</title> <codeblock><b>CREATE PROCEDURE
SALES.TOTAL_REVENUE(IN S_MONTH INTEGER,
 IN S_YEAR INTEGER, OUT TOTAL DECIMAL(10,2))
 PARAMETER STYLE JAVA READS SQL DATA LANGUAGE JAVA EXTERNAL NAME 
-'com.acme.sales.calculateRevenueByMonth'</b></codeblock></section>
+'com.example.sales.calculateRevenueByMonth'</b></codeblock></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rrefproper26978.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper26978.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper26978.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper26978.dita Wed Jul 20 13:54:31 2011
@@ -27,7 +27,7 @@ limitations under the License.
 <section><title>Function</title>
 <p>Specifies the root DN of the point in your hierarchy from which to begin
 a guest or anonymous search for the user's DN. For example:</p>
-<codeblock><b>ou=people,o=ExampleSite.com</b></codeblock>
+<codeblock><b>ou=people,o=example.com</b></codeblock>
 <p>When using Netscape Directory Server, set this property to the root DN,
 the special entry to which access control does not apply.</p>
 <p>For more information about LDAP user authentication, see the
@@ -36,11 +36,11 @@ the special entry to which access contro
 <example><title>Example</title>
 <codeblock><b><ph>-- system-wide property</ph>
 derby.authentication.ldap.searchBase=
-    ou=people,o=ExampleSite.com
+    ou=people,o=example.com
 <ph>-- database-wide property</ph>
 CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
     'derby.authentication.ldap.searchBase',
-    'ou=people,o=ExampleSite.com')</b></codeblock>
+    'ou=people,o=example.com')</b></codeblock>
 </example>
 <section><title>Dynamic or static</title>
 <p>Static. For system-wide properties, you must reboot

Modified: db/derby/docs/trunk/src/ref/rrefproper27355.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper27355.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper27355.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper27355.dita Wed Jul 20 13:54:31 2011
@@ -88,7 +88,7 @@ CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPE
 <ph>-- cache a userDN locally, database-level property</ph>
 CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
     'derby.user.richard',
-    'uid=richard, ou=People, o=ExampleSite.com')
+    'uid=richard, ou=People, o=example.com')
 </b></codeblock> </example>
 <section><title>Dynamic or static</title>
 <p>Dynamic; the change takes effect immediately. For information about dynamic

Modified: db/derby/docs/trunk/src/ref/rrefproperauthdn.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperauthdn.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperauthdn.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperauthdn.dita Wed Jul 20 13:54:31 2011
@@ -46,11 +46,11 @@ service" in the <ph conref="../conrefs.d
 <example><title>Example</title>
 <codeblock><b><ph>-- system-wide property</ph>
 derby.authentication.ldap.searchAuthDn=
-    cn=guest,o=ExampleSite.com
+    cn=guest,o=example.com
 <ph>-- database-wide property</ph>
 CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
     'derby.authentication.ldap.searchAuthDn',
-    'cn=guest,o=ExampleSite.com')</b></codeblock>
+    'cn=guest,o=example.com')</b></codeblock>
 </example>
 <section><title>Dynamic or static</title>
 <p>Static. For system-wide properties, you must reboot

Modified: db/derby/docs/trunk/src/ref/rrefsqljargmatching.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljargmatching.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljargmatching.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljargmatching.dita Wed Jul 20 13:54:31 2011
@@ -124,7 +124,7 @@ CREATE FUNCTION TO_DEGREES
 RETURNS DOUBLE
 PARAMETER STYLE JAVA
 NO SQL LANGUAGE JAVA
-EXTERNAL NAME 'acme.MathUtils.toDegrees'
+EXTERNAL NAME 'example.MathUtils.toDegrees'
 </b></codeblock>
 
 <p>

Modified: db/derby/docs/trunk/src/ref/rrefsqljcreatetype.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljcreatetype.dita?rev=1148776&r1=1148775&r2=1148776&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljcreatetype.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljcreatetype.dita Wed Jul 20 13:54:31 2011
@@ -59,7 +59,7 @@ instance of any subclass of C.</p>
 </refsyn>
 <example><title>Example</title>
 <codeblock><b>CREATE TYPE price
-EXTERNAL NAME 'com.acme.types.Price'
+EXTERNAL NAME 'com.example.types.Price'
 LANGUAGE JAVA</b></codeblock>
 </example>
 <section><title>Using user-defined types</title>



Mime
View raw message