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 jt...@apache.org on 2006/02/02 00:19:12 UTC
svn commit: r374201 - in /db/derby/site/trunk: build/site/faq.html
src/documentation/content/xdocs/faq.xml
Author: jta
Date: Wed Feb 1 15:19:09 2006
New Revision: 374201
URL: http://svn.apache.org/viewcvs?rev=374201&view=rev
Log:
Added an ICLA faq.
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=374201&r1=374200&r2=374201&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/faq.html (original)
+++ db/derby/site/trunk/build/site/faq.html Wed Feb 1 15:19:09 2006
@@ -100,7 +100,7 @@
<a href="#Questions">Questions</a>
<ul class="minitoc">
<li>
-<a href="#general">1. General</a>
+<a href="#legal">1. Legal</a>
<ul class="minitoc">
<li>
<a href="#derby_license">1.1.
@@ -108,155 +108,165 @@
</a>
</li>
<li>
-<a href="#faq_add">1.2.
+<a href="#derby_icla">1.2.
+ Who needs to file an Individual Contributor License Agreement (ICLA)?
+ </a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#general">2. General</a>
+<ul class="minitoc">
+<li>
+<a href="#faq_add">2.1.
How can I add a new entry to the Derby FAQ?
</a>
</li>
</ul>
</li>
<li>
-<a href="#developers">2. Developing Derby</a>
+<a href="#developers">3. Developing Derby</a>
<ul class="minitoc">
<li>
-<a href="#derby_source">2.1.
+<a href="#derby_source">3.1.
Where is the Derby source code?
</a>
</li>
<li>
-<a href="#derby_internals">2.2.
+<a href="#derby_internals">3.2.
Where can I read about Derby internals?
</a>
</li>
<li>
-<a href="#derby_issues">2.3.
+<a href="#derby_issues">3.3.
Where are Apache Derby bugs logged?
</a>
</li>
<li>
-<a href="#derby_update">2.4.
+<a href="#derby_update">3.4.
Who can create a new Apache Derby issue?
</a>
</li>
<li>
-<a href="#derby_eclipse">2.5.
+<a href="#derby_eclipse">3.5.
How do you build Derby using Eclipse?
</a>
</li>
</ul>
</li>
<li>
-<a href="#users_getstart">3. Using Derby: Getting Started</a>
+<a href="#users_getstart">4. Using Derby: Getting Started</a>
<ul class="minitoc">
<li>
-<a href="#derby_ask">3.1.
+<a href="#derby_ask">4.1.
Where can I ask questions about how to use Derby?
</a>
</li>
<li>
-<a href="#derby_jar">3.2.
+<a href="#derby_jar">4.2.
Where can I download the Derby jar files?
</a>
</li>
<li>
-<a href="#derby_alpha">3.3.
+<a href="#derby_alpha">4.3.
What are Derby alpha snaphots and should I use them?
</a>
</li>
<li>
-<a href="#where_are_docs">3.4.
+<a href="#where_are_docs">4.4.
Where can I find the Derby documentation?
</a>
</li>
<li>
-<a href="#pda">3.5.
+<a href="#pda">4.5.
Can you run Derby on PDAs?
</a>
</li>
<li>
-<a href="#createdb_OS_X">3.6.
+<a href="#createdb_OS_X">4.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">3.7.
+<a href="#derby_jdk51">4.7.
Can I use Derby on JDK 5.0?
</a>
</li>
<li>
-<a href="#in_memory">3.8.
+<a href="#in_memory">4.8.
Does Derby have a mode that causes it to run entirely in memory?
</a>
</li>
<li>
-<a href="#derby_gui">3.9.
+<a href="#derby_gui">4.9.
Does Derby have a GUI?
</a>
</li>
</ul>
</li>
<li>
-<a href="#users_sql">4. Using Derby: SQL</a>
+<a href="#users_sql">5. Using Derby: SQL</a>
<ul class="minitoc">
<li>
-<a href="#null_args">4.1.
+<a href="#null_args">5.1.
Why can't my SQL function/procedure pass a NULL INTEGER?
</a>
</li>
<li>
-<a href="#limit">4.2.
+<a href="#limit">5.2.
Does Derby support a LIMIT command?
</a>
</li>
<li>
-<a href="#schema_exist">4.3.
+<a href="#schema_exist">5.3.
Why do I get the error 'schema does not exist'?
</a>
</li>
<li>
-<a href="#debug_lock_timeout">4.4.
+<a href="#debug_lock_timeout">5.4.
I get a lock timeout error. How do I debug this?
</a>
</li>
<li>
-<a href="#identity">4.5.
+<a href="#identity">5.5.
Can Derby generate unique identifiers like sequences?
</a>
</li>
</ul>
</li>
<li>
-<a href="#users_client">5. Using Derby: Client Programming</a>
+<a href="#users_client">6. Using Derby: Client Programming</a>
<ul class="minitoc">
<li>
-<a href="#clientserv">5.1.
+<a href="#clientserv">6.1.
Can you use Derby for client-server applications?
</a>
</li>
<li>
-<a href="#netclient">5.2.
+<a href="#netclient">6.2.
Does Derby include a client-server ("network") jdbc driver?
</a>
</li>
<li>
-<a href="#db2_jcc_errors">5.3.
+<a href="#db2_jcc_errors">6.3.
How can I get the message text for an error using the DB2 JDBC
Universal Driver?
</a>
</li>
<li>
-<a href="#derby_xa">5.4.
+<a href="#derby_xa">6.4.
Can you execute a query that spans two Derby databases
across different JVMs?
</a>
</li>
<li>
-<a href="#derby_faster">5.5.
+<a href="#derby_faster">6.5.
Are there any tips to make Derby go faster?
</a>
</li>
<li>
-<a href="#jdbc_lob">5.6.
+<a href="#jdbc_lob">6.6.
Where is an example that shows how to insert a CLOB?
</a>
</li>
@@ -269,8 +279,8 @@
<a name="N10008"></a><a name="Questions"></a>
<h2 class="boxed">Questions</h2>
<div class="section">
-<a name="N1000C"></a><a name="general"></a>
-<h3 class="boxed">1. General</h3>
+<a name="N1000C"></a><a name="legal"></a>
+<h3 class="boxed">1. Legal</h3>
<a name="N10010"></a><a name="derby_license"></a>
<h4 class="faq">1.1.
What License is Derby under? (Quick Answer: ASL 2.0)
@@ -284,8 +294,33 @@
</p>
</div>
-<a name="N1001C"></a><a name="faq_add"></a>
+<a name="N1001C"></a><a name="derby_icla"></a>
<h4 class="faq">1.2.
+ Who needs to file an Individual Contributor License Agreement (ICLA)?
+ </h4>
+<div align="right">
+<a href="#derby_icla-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+ The ASF <em>desires</em> contributors to submit an ICLA, but
+ <em>requires</em> committers to do so.
+ (See the "Contributor License Agreements" section on the
+ <a class="external" href="http://www.apache.org/licenses/">Licenses</a> page.)
+ Contributors who are not committers are in a somewhat fuzzy spot.
+ Small fixes posted to Jira probably don't require an ICLA,
+ especially since Jira includes an upload option to "Grant license
+ to ASF for inclusion in ASF works (as per the
+ <a class="external" href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ Software License</a>)".
+ However, if you make a large contribution, or many contributions,
+ a Derby committer will likely ask you to submit an ICLA.
+ </p>
+</div>
+<a name="N10032"></a><a name="general"></a>
+<h3 class="boxed">2. General</h3>
+<a name="N10036"></a><a name="faq_add"></a>
+<h4 class="faq">2.1.
How can I add a new entry to the Derby FAQ?
</h4>
<div align="right">
@@ -300,10 +335,10 @@
if you don't already have one.
</p>
</div>
-<a name="N1002C"></a><a name="developers"></a>
-<h3 class="boxed">2. Developing Derby</h3>
-<a name="N10030"></a><a name="derby_source"></a>
-<h4 class="faq">2.1.
+<a name="N10046"></a><a name="developers"></a>
+<h3 class="boxed">3. Developing Derby</h3>
+<a name="N1004A"></a><a name="derby_source"></a>
+<h4 class="faq">3.1.
Where is the Derby source code?
</h4>
<div align="right">
@@ -320,8 +355,8 @@
interface to view Derby source code using your web browser.
</p>
</div>
-<a name="N10040"></a><a name="derby_internals"></a>
-<h4 class="faq">2.2.
+<a name="N1005A"></a><a name="derby_internals"></a>
+<h4 class="faq">3.2.
Where can I read about Derby internals?
</h4>
<div align="right">
@@ -337,8 +372,8 @@
mail list and post any questions you have.
</p>
</div>
-<a name="N10050"></a><a name="derby_issues"></a>
-<h4 class="faq">2.3.
+<a name="N1006A"></a><a name="derby_issues"></a>
+<h4 class="faq">3.3.
Where are Apache Derby bugs logged?
</h4>
<div align="right">
@@ -351,8 +386,8 @@
tracker</a> to track bugs.
</p>
</div>
-<a name="N1005C"></a><a name="derby_update"></a>
-<h4 class="faq">2.4.
+<a name="N10076"></a><a name="derby_update"></a>
+<h4 class="faq">3.4.
Who can create a new Apache Derby issue?
</h4>
<div align="right">
@@ -370,8 +405,8 @@
request that it be added to the derby-developers Jira list.
</p>
</div>
-<a name="N1006C"></a><a name="derby_eclipse"></a>
-<h4 class="faq">2.5.
+<a name="N10086"></a><a name="derby_eclipse"></a>
+<h4 class="faq">3.5.
How do you build Derby using Eclipse?
</h4>
<div align="right">
@@ -384,10 +419,10 @@
</p>
</div>
-<a name="N10078"></a><a name="users_getstart"></a>
-<h3 class="boxed">3. Using Derby: Getting Started</h3>
-<a name="N1007C"></a><a name="derby_ask"></a>
-<h4 class="faq">3.1.
+<a name="N10092"></a><a name="users_getstart"></a>
+<h3 class="boxed">4. Using Derby: Getting Started</h3>
+<a name="N10096"></a><a name="derby_ask"></a>
+<h4 class="faq">4.1.
Where can I ask questions about how to use Derby?
</h4>
<div align="right">
@@ -406,8 +441,8 @@
feel free to ask for more help.
</p>
</div>
-<a name="N10088"></a><a name="derby_jar"></a>
-<h4 class="faq">3.2.
+<a name="N100A2"></a><a name="derby_jar"></a>
+<h4 class="faq">4.2.
Where can I download the Derby jar files?
</h4>
<div align="right">
@@ -419,8 +454,8 @@
from the <a href="derby_downloads.html">Derby Downloads</a> page.
</p>
</div>
-<a name="N10094"></a><a name="derby_alpha"></a>
-<h4 class="faq">3.3.
+<a name="N100AE"></a><a name="derby_alpha"></a>
+<h4 class="faq">4.3.
What are Derby alpha snaphots and should I use them?
</h4>
<div align="right">
@@ -437,8 +472,8 @@
must not be used for production</a>.
</p>
</div>
-<a name="N100A4"></a><a name="where_are_docs"></a>
-<h4 class="faq">3.4.
+<a name="N100BE"></a><a name="where_are_docs"></a>
+<h4 class="faq">4.4.
Where can I find the Derby documentation?
</h4>
<div align="right">
@@ -463,8 +498,8 @@
instructions.
</p>
</div>
-<a name="N100C6"></a><a name="pda"></a>
-<h4 class="faq">3.5.
+<a name="N100E0"></a><a name="pda"></a>
+<h4 class="faq">4.5.
Can you run Derby on PDAs?
</h4>
<div align="right">
@@ -479,8 +514,8 @@
Guide</a>.
</p>
</div>
-<a name="N100D2"></a><a name="createdb_OS_X"></a>
-<h4 class="faq">3.6.
+<a name="N100EC"></a><a name="createdb_OS_X"></a>
+<h4 class="faq">4.6.
Why can't I create a new database or modify an existing database
on Mac OS X?
</h4>
@@ -505,8 +540,8 @@
sync instead of write sync for log writes.
</p>
</div>
-<a name="N100E2"></a><a name="derby_jdk51"></a>
-<h4 class="faq">3.7.
+<a name="N100FC"></a><a name="derby_jdk51"></a>
+<h4 class="faq">4.7.
Can I use Derby on JDK 5.0?
</h4>
<div align="right">
@@ -524,8 +559,8 @@
5.0 is also known as JDK 1.5</a>.
</p>
</div>
-<a name="N100F6"></a><a name="in_memory"></a>
-<h4 class="faq">3.8.
+<a name="N10110"></a><a name="in_memory"></a>
+<h4 class="faq">4.8.
Does Derby have a mode that causes it to run entirely in memory?
</h4>
<div align="right">
@@ -541,8 +576,8 @@
Check that mail list for current status.
</p>
</div>
-<a name="N10106"></a><a name="derby_gui"></a>
-<h4 class="faq">3.9.
+<a name="N10120"></a><a name="derby_gui"></a>
+<h4 class="faq">4.9.
Does Derby have a GUI?
</h4>
<div align="right">
@@ -556,10 +591,10 @@
that work with Derby.
</p>
</div>
-<a name="N10112"></a><a name="users_sql"></a>
-<h3 class="boxed">4. Using Derby: SQL</h3>
-<a name="N10116"></a><a name="null_args"></a>
-<h4 class="faq">4.1.
+<a name="N1012C"></a><a name="users_sql"></a>
+<h3 class="boxed">5. Using Derby: SQL</h3>
+<a name="N10130"></a><a name="null_args"></a>
+<h4 class="faq">5.1.
Why can't my SQL function/procedure pass a NULL INTEGER?
</h4>
<div align="right">
@@ -577,8 +612,8 @@
mail list topic.
</p>
</div>
-<a name="N10122"></a><a name="limit"></a>
-<h4 class="faq">4.2.
+<a name="N1013C"></a><a name="limit"></a>
+<h4 class="faq">5.2.
Does Derby support a LIMIT command?
</h4>
<div align="right">
@@ -590,8 +625,8 @@
<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="N1012E"></a><a name="schema_exist"></a>
-<h4 class="faq">4.3.
+<a name="N10148"></a><a name="schema_exist"></a>
+<h4 class="faq">5.3.
Why do I get the error 'schema does not exist'?
</h4>
<div align="right">
@@ -622,8 +657,8 @@
to create in a particular schema and no explicit CREATE SCHEMA was issued.
</p>
</div>
-<a name="N1013F"></a><a name="debug_lock_timeout"></a>
-<h4 class="faq">4.4.
+<a name="N10159"></a><a name="debug_lock_timeout"></a>
+<h4 class="faq">5.4.
I get a lock timeout error. How do I debug this?
</h4>
<div align="right">
@@ -651,8 +686,8 @@
to narrow down which statements may be holding the locks.
</p>
</div>
-<a name="N10159"></a><a name="identity"></a>
-<h4 class="faq">4.5.
+<a name="N10173"></a><a name="identity"></a>
+<h4 class="faq">5.5.
Can Derby generate unique identifiers like sequences?
</h4>
<div align="right">
@@ -668,10 +703,10 @@
function returns the most recently assigned number.
</p>
</div>
-<a name="N10169"></a><a name="users_client"></a>
-<h3 class="boxed">5. Using Derby: Client Programming</h3>
-<a name="N1016D"></a><a name="clientserv"></a>
-<h4 class="faq">5.1.
+<a name="N10183"></a><a name="users_client"></a>
+<h3 class="boxed">6. Using Derby: Client Programming</h3>
+<a name="N10187"></a><a name="clientserv"></a>
+<h4 class="faq">6.1.
Can you use Derby for client-server applications?
</h4>
<div align="right">
@@ -691,8 +726,8 @@
DB2 JDBC Universal Driver</a>.
</p>
</div>
-<a name="N10185"></a><a name="netclient"></a>
-<h4 class="faq">5.2.
+<a name="N1019F"></a><a name="netclient"></a>
+<h4 class="faq">6.2.
Does Derby include a client-server ("network") jdbc driver?
</h4>
<div align="right">
@@ -707,8 +742,8 @@
and it became available in Derby 10.1.
</p>
</div>
-<a name="N10191"></a><a name="db2_jcc_errors"></a>
-<h4 class="faq">5.3.
+<a name="N101AB"></a><a name="db2_jcc_errors"></a>
+<h4 class="faq">6.3.
How can I get the message text for an error using the DB2 JDBC
Universal Driver?
</h4>
@@ -725,8 +760,8 @@
mail list topic.
</p>
</div>
-<a name="N101A0"></a><a name="derby_xa"></a>
-<h4 class="faq">5.4.
+<a name="N101BA"></a><a name="derby_xa"></a>
+<h4 class="faq">6.4.
Can you execute a query that spans two Derby databases
across different JVMs?
</h4>
@@ -741,8 +776,8 @@
<a href="http://db.apache.org/derby/docs/10.1/adminguide/cadminapps811478.html">Admin and Server Guide</a>.
</p>
</div>
-<a name="N101AC"></a><a name="derby_faster"></a>
-<h4 class="faq">5.5.
+<a name="N101C6"></a><a name="derby_faster"></a>
+<h4 class="faq">6.5.
Are there any tips to make Derby go faster?
</h4>
<div align="right">
@@ -776,8 +811,8 @@
</ol>
</div>
-<a name="N101C5"></a><a name="jdbc_lob"></a>
-<h4 class="faq">5.6.
+<a name="N101DF"></a><a name="jdbc_lob"></a>
+<h4 class="faq">6.6.
Where is an example that shows how to insert a CLOB?
</h4>
<div align="right">
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=374201&r1=374200&r2=374201&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/faq.xml Wed Feb 1 15:19:09 2006
@@ -20,8 +20,8 @@
<faqs>
<title>Frequently Asked Questions</title>
- <faqsection id="general">
- <title>General</title>
+ <faqsection id="legal">
+ <title>Legal</title>
<faq id="derby_license">
<question>
What License is Derby under? (Quick Answer: ASL 2.0)
@@ -32,6 +32,30 @@
</p>
</answer>
</faq>
+ <faq id="derby_icla">
+ <question>
+ Who needs to file an Individual Contributor License Agreement (ICLA)?
+ </question>
+ <answer>
+ <p>
+ The ASF <em>desires</em> contributors to submit an ICLA, but
+ <em>requires</em> committers to do so.
+ (See the "Contributor License Agreements" section on the
+ <a href="http://www.apache.org/licenses/">Licenses</a> page.)
+ Contributors who are not committers are in a somewhat fuzzy spot.
+ Small fixes posted to Jira probably don't require an ICLA,
+ especially since Jira includes an upload option to "Grant license
+ to ASF for inclusion in ASF works (as per the
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ Software License</a>)".
+ However, if you make a large contribution, or many contributions,
+ a Derby committer will likely ask you to submit an ICLA.
+ </p>
+ </answer>
+ </faq>
+ </faqsection>
+ <faqsection id="general">
+ <title>General</title>
<faq id="faq_add">
<question>
How can I add a new entry to the Derby FAQ?