db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject svn commit: r230861 - in /db/derby/site/trunk: build/site/faq.html src/documentation/content/xdocs/faq.xml
Date Mon, 08 Aug 2005 19:14:12 GMT
Author: jta
Date: Mon Aug  8 12:14:08 2005
New Revision: 230861

URL: http://svn.apache.org/viewcvs?rev=230861&view=rev
Log:
Updated Derby FAQs for the 10.1 release.

Modified:
    db/derby/site/trunk/build/site/faq.html
    db/derby/site/trunk/src/documentation/content/xdocs/faq.xml

Modified: db/derby/site/trunk/build/site/faq.html
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/faq.html?rev=230861&r1=230860&r2=230861&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/faq.html (original)
+++ db/derby/site/trunk/build/site/faq.html Mon Aug  8 12:14:08 2005
@@ -190,38 +190,43 @@
 <a href="#users_getstart">2. Using Derby: Getting Started</a>
 <ul class="minitoc">
 <li>
-<a href="#derby_jar">2.1. 
+<a href="#derby_ask">2.1. 
+        Where can I ask questions about how to use Derby?
+      </a>
+</li>
+<li>
+<a href="#derby_jar">2.2. 
         Where can I download the Derby jar files?
       </a>
 </li>
 <li>
-<a href="#derby_alpha">2.2. 
+<a href="#derby_alpha">2.3. 
       What are Derby alpha snaphots and should I use them?
       </a>
 </li>
 <li>
-<a href="#where_are_docs">2.3. 
+<a href="#where_are_docs">2.4. 
       Where can I find the Derby documentation?
       </a>
 </li>
 <li>
-<a href="#pda">2.4. 
-      Can you run Derby on PDAs and phones?
+<a href="#pda">2.5. 
+      Can you run Derby on PDAs?
       </a>
 </li>
 <li>
-<a href="#createdb_OS_X">2.5. 
+<a href="#createdb_OS_X">2.6. 
         Why can't I create a new database or modify an existing database 
 	on Mac OS X?
       </a>
 </li>
 <li>
-<a href="#derby_jdk51">2.6. 
+<a href="#derby_jdk51">2.7. 
       Can I use Derby on JDK 5.0?
       </a>
 </li>
 <li>
-<a href="#in_memory">2.7. 
+<a href="#in_memory">2.8. 
       Does Derby have a mode that causes it to run entirely in memory?
       </a>
 </li>
@@ -377,8 +382,28 @@
 </div>
 <a name="N10058"></a><a name="users_getstart"></a>
 <h3 class="boxed">2. Using Derby: Getting Started</h3>
-<a name="N1005C"></a><a name="derby_jar"></a>
+<a name="N1005C"></a><a name="derby_ask"></a>
 <h4 class="faq">2.1. 
+        Where can I ask questions about how to use Derby?
+      </h4>
+<div align="right">
+<a href="#derby_ask-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+        Please post questions about how to use Derby to the
+        <a href="derby_mail.html">derby-user@db.apache.org</a> mail list.
+        Sometimes you might receive a response that refers you 
+        to documentation, to a page on the Derby web site, or to another
+        post on the mail list.
+        Please don't be offended! 
+        We are constantly working to improve the available documentation.
+        And if the referenced post/page/documentation doesn't help, 
+        feel free to ask for more help.
+        </p>
+</div>
+<a name="N10068"></a><a name="derby_jar"></a>
+<h4 class="faq">2.2. 
         Where can I download the Derby jar files?
       </h4>
 <div align="right">
@@ -390,8 +415,8 @@
 	from the <a href="derby_downloads.html">Derby Downloads</a> page.
 	</p>
 </div>
-<a name="N10068"></a><a name="derby_alpha"></a>
-<h4 class="faq">2.2. 
+<a name="N10074"></a><a name="derby_alpha"></a>
+<h4 class="faq">2.3. 
       What are Derby alpha snaphots and should I use them?
       </h4>
 <div align="right">
@@ -408,8 +433,8 @@
       must not be used for production</a>.
       </p>
 </div>
-<a name="N10078"></a><a name="where_are_docs"></a>
-<h4 class="faq">2.3. 
+<a name="N10084"></a><a name="where_are_docs"></a>
+<h4 class="faq">2.4. 
       Where can I find the Derby documentation?
       </h4>
 <div align="right">
@@ -426,7 +451,7 @@
       Prebuilt documentation for Derby 10.1 is available from
 <a href="http://db.apache.org/derby/manuals/">http://db.apache.org/derby/manuals/</a>,

       which points to documentation in PDF and html format at
-      <a href="http://db.apache.org/derby/docs/">http://db.apache.org/derby/docs/</a>.
+      <a href="http://db.apache.org/derby/docs/10.1">http://db.apache.org/derby/docs/10.1</a>.
       </p>
 <p>
       You can also build the documents yourself; for more information, see
@@ -434,27 +459,24 @@
       instructions.
       </p>
 </div>
-<a name="N1009A"></a><a name="pda"></a>
-<h4 class="faq">2.4. 
-      Can you run Derby on PDAs and phones?
+<a name="N100A6"></a><a name="pda"></a>
+<h4 class="faq">2.5. 
+      Can you run Derby on PDAs?
       </h4>
 <div align="right">
 <a href="#pda-menu">^</a>
 </div>
 <div style="margin-left: 15px">
 <p>
-      Derby requires a JVM of 1.3 (J2SE) or higher, 
-      which is rarely what is found on PDAs and phones.
-      A feature on the <a href="DerbyToDo.html#Features">To Do list</a> 
-      will modify Derby to support 
+      Derby 10.1 added support for
       J2ME/CDC/Foundation with JSR169 as the JDBC api. 
-      Also see the 
-      <a class="external" href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-user/200411.mbox/%3c41A6478B.2020909@g2k.es%3e">"derby
inside pda"</a>
-      mail list topic.
+      For more information, see the 
+<a href="http://db.apache.org/derby/docs/10.1/ref/rrefjdbcjsr169.html">Reference
+      Guide</a>.
       </p>
 </div>
-<a name="N100AA"></a><a name="createdb_OS_X"></a>
-<h4 class="faq">2.5. 
+<a name="N100B2"></a><a name="createdb_OS_X"></a>
+<h4 class="faq">2.6. 
         Why can't I create a new database or modify an existing database 
 	on Mac OS X?
       </h4>
@@ -475,8 +497,8 @@
 	sync instead of write sync for log writes.
 	</p>
 </div>
-<a name="N100BA"></a><a name="derby_jdk51"></a>
-<h4 class="faq">2.6. 
+<a name="N100C2"></a><a name="derby_jdk51"></a>
+<h4 class="faq">2.7. 
       Can I use Derby on JDK 5.0?
       </h4>
 <div align="right">
@@ -489,13 +511,13 @@
       (<a class="external" href="http://issues.apache.org/jira/browse/DERBY-74">DERBY-74</a>
       and
       <a class="external" href="http://issues.apache.org/jira/browse/DERBY-83">DERBY-83</a>)
-      have been fixed in the Derby 10.1 development codeline.
+      were fixed in Derby 10.1.
       <a class="external" href="http://java.sun.com/j2se/naming_versioning_5_0.html">JDK

       5.0 is also known as JDK 1.5</a>.
       </p>
 </div>
-<a name="N100CE"></a><a name="in_memory"></a>
-<h4 class="faq">2.7. 
+<a name="N100D6"></a><a name="in_memory"></a>
+<h4 class="faq">2.8. 
       Does Derby have a mode that causes it to run entirely in memory?
       </h4>
 <div align="right">
@@ -511,9 +533,9 @@
       Check that mail list for current status.
       </p>
 </div>
-<a name="N100DE"></a><a name="users_sql"></a>
+<a name="N100E6"></a><a name="users_sql"></a>
 <h3 class="boxed">3. Using Derby: SQL</h3>
-<a name="N100E2"></a><a name="null_args"></a>
+<a name="N100EA"></a><a name="null_args"></a>
 <h4 class="faq">3.1. 
       Why can't my SQL function/procedure pass a NULL INTEGER?
       </h4>
@@ -532,7 +554,7 @@
       mail list topic.
       </p>
 </div>
-<a name="N100EE"></a><a name="limit"></a>
+<a name="N100F6"></a><a name="limit"></a>
 <h4 class="faq">3.2. 
       Does Derby support a LIMIT command? 
       </h4>
@@ -545,7 +567,7 @@
       <a class="external" href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200411.mbox/%3c41A95632.3010301@debrunners.com%3e">JDBC</a>.
       </p>
 </div>
-<a name="N100FA"></a><a name="schema_exist"></a>
+<a name="N10102"></a><a name="schema_exist"></a>
 <h4 class="faq">3.3. 
       Why do I get the error 'schema does not exist'?
       </h4>
@@ -577,7 +599,7 @@
       to create in a particular schema and no explicit CREATE SCHEMA was issued.
       </p>
 </div>
-<a name="N1010B"></a><a name="debug_lock_timeout"></a>
+<a name="N10113"></a><a name="debug_lock_timeout"></a>
 <h4 class="faq">3.4. 
       I get a lock timeout error. How do I debug this?
       </h4>
@@ -606,9 +628,9 @@
       to narrow down which statements may be holding the locks.
       </p>
 </div>
-<a name="N10125"></a><a name="users_client"></a>
+<a name="N1012D"></a><a name="users_client"></a>
 <h3 class="boxed">4. Using Derby: Client Programming</h3>
-<a name="N10129"></a><a name="clientserv"></a>
+<a name="N10131"></a><a name="clientserv"></a>
 <h4 class="faq">4.1. 
       Can you use Derby for client-server applications?
       </h4>
@@ -621,15 +643,15 @@
       A couple options are listed on the
       <a href="integrate/misc.html">Integration Topics: Summary</a> page,
       including 
+      the 10.1
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminappsclient.html">Derby
Network Client</a>,
       <a class="external" href="http://c-jdbc.objectweb.org/">C-JDBC</a>,
-      the
+      and the
       <a class="external" href="http://www.ibm.com/developerworks/db2/downloads/jcc/">IBM
-      DB2 JDBC Universal Driver</a>,
-      and now the new 
-      <a href="papers/DerbyClientSpec.html">Derby Network Client</a>.
+      DB2 JDBC Universal Driver</a>.
       </p>
 </div>
-<a name="N10141"></a><a name="netclient"></a>
+<a name="N10149"></a><a name="netclient"></a>
 <h4 class="faq">4.2. 
       Does Derby include a client-server ("network") jdbc driver?
       </h4>
@@ -639,25 +661,13 @@
 <div style="margin-left: 15px">
 <p>
       Yes, Apache Derby has a JDBC driver
-      that works with the Derby Network Server,
-      which is called the Derby Network Client.
-      As of this writing it is new
-      and isn't part of a formal Derby release yet, 
-      but it's ready and available for testing and development.
-      You'll find it in the
-      <a class="external" href="http://mail-archives.apache.org/mod_mbox/db-derby-user/200504.mbox/%3c3d373ffede6df85beea9340b280efa0b@gmail.com%3e">April
28 10.1.0.0 alpha snapshot
-     jars</a>
-     and the
-     <a href="papers/DerbyClientSpec.html">functional specification</a>
-     provides API descriptions and example usage.
-      </p>
-<p>
-      Just remember that 
-      <a href="derby_downloads.html#Development+trunk">the alpha snapshots 
-      must not be used for production</a>.
+      that works with the Derby Network Server.
+      It is called the
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminappsclient.html">Derby
Network Client</a>
+      and it became available in Derby 10.1.
       </p>
 </div>
-<a name="N10158"></a><a name="db2_jcc_errors"></a>
+<a name="N10155"></a><a name="db2_jcc_errors"></a>
 <h4 class="faq">4.3. 
       How can I get the message text for an error using the DB2 JDBC
       Universal Driver?
@@ -675,7 +685,7 @@
       mail list topic.
       </p>
 </div>
-<a name="N10167"></a><a name="derby_xa"></a>
+<a name="N10164"></a><a name="derby_xa"></a>
 <h4 class="faq">4.4. 
       Can you execute a query that spans two Derby databases 
       across different JVMs?
@@ -685,23 +695,13 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-      XA support using Network Server will allow you to do this. 
-      This functionality has been added to the Derby 10.1 development codeline. 
-      You can test drive the functionality using the 
-      Derby 10.1 alpha snapshot available on the
-      <a href="http://db.apache.org/derby/derby_downloads.html#Snapshot+Jars">downloads
page</a>.
-      There is an example of establishing an XA connection in the 10.1 
-      build of the 
-      <a href="http://db.apache.org/derby/docs/adminguide/cadminapps811478.html">Admin
and Server Guide</a>.
-      </p>
-<p>
-      If you decide to test drive XA on Derby 10.1, just remember that 
-      <a href="derby_downloads.html#Development+trunk">the development
-      codeline and alpha snapshots must not be 
-      used for production</a>.
+      XA support using Network Server allows you to do this and the
+      Derby Network Client, new in 10.1, supports this functionality.
+      An example of establishing an XA connection is in the 10.1 
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminapps811478.html">Admin
and Server Guide</a>.
       </p>
 </div>
-<a name="N1017E"></a><a name="derby_faster"></a>
+<a name="N10170"></a><a name="derby_faster"></a>
 <h4 class="faq">4.5. 
       Are there any tips to make Derby go faster?
       </h4>

Modified: db/derby/site/trunk/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/faq.xml?rev=230861&r1=230860&r2=230861&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/faq.xml Mon Aug  8 12:14:08 2005
@@ -108,6 +108,25 @@
   <faqsection id="users_getstart">
     <title>Using Derby: Getting Started</title>
 
+    <faq id="derby_ask">
+      <question>
+        Where can I ask questions about how to use Derby?
+      </question>
+      <answer>
+        <p>
+        Please post questions about how to use Derby to the
+        <a href="derby_mail.html">derby-user@db.apache.org</a> mail list.
+        Sometimes you might receive a response that refers you 
+        to documentation, to a page on the Derby web site, or to another
+        post on the mail list.
+        Please don't be offended! 
+        We are constantly working to improve the available documentation.
+        And if the referenced post/page/documentation doesn't help, 
+        feel free to ask for more help.
+        </p>
+      </answer>
+    </faq>
+
     <faq id="derby_jar">
       <question>
         Where can I download the Derby jar files?
@@ -151,7 +170,7 @@
       Prebuilt documentation for Derby 10.1 is available from
 <a href="http://db.apache.org/derby/manuals/">http://db.apache.org/derby/manuals/</a>,

       which points to documentation in PDF and html format at
-      <a href="http://db.apache.org/derby/docs/">http://db.apache.org/derby/docs/</a>.
+      <a href="http://db.apache.org/derby/docs/10.1">http://db.apache.org/derby/docs/10.1</a>.
       </p>
       <p>
       You can also build the documents yourself; for more information, see
@@ -162,18 +181,15 @@
     </faq>
     <faq id="pda">
       <question>
-      Can you run Derby on PDAs and phones?
+      Can you run Derby on PDAs?
       </question>
       <answer>
       <p>
-      Derby requires a JVM of 1.3 (J2SE) or higher, 
-      which is rarely what is found on PDAs and phones.
-      A feature on the <a href="DerbyToDo.html#Features">To Do list</a> 
-      will modify Derby to support 
+      Derby 10.1 added support for
       J2ME/CDC/Foundation with JSR169 as the JDBC api. 
-      Also see the 
-      <a href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-user/200411.mbox/%3c41A6478B.2020909@g2k.es%3e">"derby
inside pda"</a>
-      mail list topic.
+      For more information, see the 
+<a href="http://db.apache.org/derby/docs/10.1/ref/rrefjdbcjsr169.html">Reference
+      Guide</a>.
       </p>
       </answer>
     </faq>
@@ -208,7 +224,7 @@
       (<a href="http://issues.apache.org/jira/browse/DERBY-74">DERBY-74</a>
       and
       <a href="http://issues.apache.org/jira/browse/DERBY-83">DERBY-83</a>)
-      have been fixed in the Derby 10.1 development codeline.
+      were fixed in Derby 10.1.
       <a href="http://java.sun.com/j2se/naming_versioning_5_0.html">JDK 
       5.0 is also known as JDK 1.5</a>.
       </p>
@@ -337,12 +353,12 @@
       A couple options are listed on the
       <a href="integrate/misc.html">Integration Topics: Summary</a> page,
       including 
+      the 10.1
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminappsclient.html">Derby
Network Client</a>,
       <a href="http://c-jdbc.objectweb.org/">C-JDBC</a>,
-      the
+      and the
       <a href="http://www.ibm.com/developerworks/db2/downloads/jcc/">IBM
-      DB2 JDBC Universal Driver</a>,
-      and now the new 
-      <a href="papers/DerbyClientSpec.html">Derby Network Client</a>.
+      DB2 JDBC Universal Driver</a>.
       </p>
       </answer>
     </faq>
@@ -353,22 +369,10 @@
       <answer>
       <p>
       Yes, Apache Derby has a JDBC driver
-      that works with the Derby Network Server,
-      which is called the Derby Network Client.
-      As of this writing it is new
-      and isn't part of a formal Derby release yet, 
-      but it's ready and available for testing and development.
-      You'll find it in the
-      <a href="http://mail-archives.apache.org/mod_mbox/db-derby-user/200504.mbox/%3c3d373ffede6df85beea9340b280efa0b@gmail.com%3e">April
28 10.1.0.0 alpha snapshot
-     jars</a>
-     and the
-     <a href="papers/DerbyClientSpec.html">functional specification</a>
-     provides API descriptions and example usage.
-      </p>
-      <p>
-      Just remember that 
-      <a href="derby_downloads.html#Development+trunk">the alpha snapshots 
-      must not be used for production</a>.
+      that works with the Derby Network Server.
+      It is called the
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminappsclient.html">Derby
Network Client</a>
+      and it became available in Derby 10.1.
       </p>
       </answer>
     </faq>
@@ -395,20 +399,10 @@
       </question>
       <answer>
       <p>
-      XA support using Network Server will allow you to do this. 
-      This functionality has been added to the Derby 10.1 development codeline. 
-      You can test drive the functionality using the 
-      Derby 10.1 alpha snapshot available on the
-      <a href="http://db.apache.org/derby/derby_downloads.html#Snapshot+Jars">downloads
page</a>.
-      There is an example of establishing an XA connection in the 10.1 
-      build of the 
-      <a href="http://db.apache.org/derby/docs/adminguide/cadminapps811478.html">Admin
and Server Guide</a>.
-      </p>
-      <p>
-      If you decide to test drive XA on Derby 10.1, just remember that 
-      <a href="derby_downloads.html#Development+trunk">the development
-      codeline and alpha snapshots must not be 
-      used for production</a>.
+      XA support using Network Server allows you to do this and the
+      Derby Network Client, new in 10.1, supports this functionality.
+      An example of establishing an XA connection is in the 10.1 
+      <a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminapps811478.html">Admin
and Server Guide</a>.
       </p>
       </answer>
     </faq>



Mime
View raw message