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 rh...@apache.org on 2017/09/09 23:45:38 UTC
svn commit: r1807935 - in
/db/derby/site/trunk/src/documentation/content/xdocs: derby_charter.xml
derby_downloads.xml faq.xml index.xml license.xml
Author: rhillegas
Date: Sat Sep 9 23:45:38 2017
New Revision: 1807935
URL: http://svn.apache.org/viewvc?rev=1807935&view=rev
Log:
DERBY-6941: Re-organize downloads page in order to highlight which Java versions support which Derby releases.
Modified:
db/derby/site/trunk/src/documentation/content/xdocs/derby_charter.xml
db/derby/site/trunk/src/documentation/content/xdocs/derby_downloads.xml
db/derby/site/trunk/src/documentation/content/xdocs/faq.xml
db/derby/site/trunk/src/documentation/content/xdocs/index.xml
db/derby/site/trunk/src/documentation/content/xdocs/license.xml
Modified: db/derby/site/trunk/src/documentation/content/xdocs/derby_charter.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/derby_charter.xml?rev=1807935&r1=1807934&r2=1807935&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/derby_charter.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/derby_charter.xml Sat Sep 9 23:45:38 2017
@@ -39,14 +39,14 @@ The Derby project develops open source d
<p>
Database technology is defined as software that processes data related
requests from applications.
- Data requests include data definition, data modification and data retrieval.
- Database GUI tooling and IDEs are not developed by the Derby project.
+ Data requests include data definition, data modification, and data retrieval.
+ The Derby project does not develop database GUI tools or IDEs.
</p>
</section>
<section><title>Pure Java</title>
<p>
- Derby technology is written in Java to take advantage of Javaâs write
+ Derby technology is written in Java in order to take advantage of Javaâs write
once, run anywhere promise.
Java platforms such as OSGi, J2ME, J2SE and J2EE are supported as appropriate.
</p>
@@ -54,29 +54,28 @@ The Derby project develops open source d
<section><title>Easy to Use</title>
<p>
- Derby technology aims to be easy to use for software developers and zero administration for end users.
+ Derby intends to be easy for software developers to use and to impose no administrative burden on end users.
</p>
</section>
<section><title>Small Footprint</title>
<p>
- Derby technologies are designed to provide significant useful
- functionality in a small code size footprint with efficient runtime
- resource usage.
+ Derby provides significant
+ functionality, fits in a small code size footprint, and uses runtime
+ resources efficiently.
</p>
</section>
<section><title>Standards based</title>
<p>
- Derby technology adheres to database standards such as JDBC
- and ANSI SQL standards.
- This means Derby provides the functionality expected of a modern relational
- database,
+ Derby adheres to database standards such as JDBC
+ and the ANSI/ISO SQL specification.
+ This means that Derby provides modern relational
+ database functionality,
including SQL syntax, transaction management, concurrency, triggers,
and online backups.
- And it also means developers can later migrate to other databases if they
- so choose.
+ It also means that developers can migrate easily to other databases later on.
</p>
@@ -84,11 +83,11 @@ The Derby project develops open source d
<section><title>Secure</title>
<p>
- Derby technology provides secure data management appropriate to environment
- the engine is executing in. Traditional enterprise database systems rely on
- the machine being physically protected (locked machine room) for security,
- Derby databases are often in unprotected environments, such as laptops and
- unattended hardware.
+ Derby provides secure data management appropriate to the environment
+ where the engine runs. While traditional enterprise database systems rely on
+ machines being physically isolated in a locked room,
+ Derby databases often reside on unprotected laptops and
+ other unattended hardware.
</p>
</section>
@@ -98,31 +97,29 @@ The Derby project develops open source d
<section><title>Derby embedded database engine</title>
<p>
- The core of the technology, Derbyâs database engine is a full
- functioned relational embedded database engine. JDBC and SQL are the
- programming APIs.
+ The core Derby technology is a fully functional, embedded database engine.
+ The engine can be programmed using SQL over JDBC.
</p>
</section>
<section><title>Derby network server</title>
<p>
- The Derby network server increases the reach of the Derby database
- engine by providing traditional client server functionality.
- The network server allows clients to connect over TCP/IP using the standard
+ The Derby network server provides traditional client/server access to the Derby engine.
+ The network server lets clients connect over TCP/IP using a subset of the
DRDA protocol.
- The network server allows the Derby engine to support networked JDBC,
- ODBC/CLI, Perl and PHP.
+ The network server supports connections from networked JDBC,
+ ODBC/CLI, Perl, and PHP clients.
</p>
</section>
<section><title>Database Utilities</title>
<ul>
<li> <code>ij</code> -- a tool that allows SQL scripts to be executed
- against any JDBC database.
+ against any JDBC database, including non-Derby databases.
</li>
- <li> <code>dblook</code> -- Schema extraction tool for a Derby database.
+ <li> <code>dblook</code> -- a schema extraction tool for a Derby database.
</li>
- <li> <code>sysinfo</code> -- Utility to display version numbers and
+ <li> <code>sysinfo</code> -- a utility to display version numbers and
class path.
</li>
</ul>
@@ -133,26 +130,25 @@ The Derby project develops open source d
<section><title>Derby History</title>
<p>
-Cloudscape Inc, an Oakland, California start-up, was founded in 1996 to
-develop Java database technology. The first release of the database engine,
-then called JBMS, was in 1997.
-Subsequently the product was renamed Cloudscape and releases were made about
-every six months.
-In 1999 Informix Software, Inc., acquired Cloudscape, Inc.
-In 2001 IBM acquired the database assets of Informix Software,
+In 1996, a start-up called Cloudscape Inc. was founded in Oakland, California in order to
+develop Java database technology. In 1997, Cloudscape released the first version of its database engine,
+then called JBMS.
+Subsequently, the product was renamed as Cloudscape and the company adopted a six month release cadence.
+In 1999, Informix Software, Inc., acquired Cloudscape, Inc..
+In 2001, IBM acquired the database assets of Informix Software,
including Cloudscape.
-The database engine was re-branded to IBM Cloudscape and releases continued,
+IBM re-branded the database engine as IBM Cloudscape and releases continued,
mainly focussing on embedded use with IBM's Java products and middleware.
-In August 2004 IBM contributed the code to the Apache Software Foundation
+In August 2004, IBM contributed the code to the Apache Software Foundation
as Derby, an Incubator project sponsored by the Apache DB project
(<a href="derby_proposal.html">see the Incubator proposal</a>).
-In July 2005 Derby graduated from the Incubator into the Apache DB project.
+In July 2005, Derby graduated from the Incubator as an Apache DB sub-project.
</p>
</section>
<p>
-<em>Last updated: 14-February-2006</em>
+<em>Last updated: 09-September-2017</em>
</p>
</body>
Modified: db/derby/site/trunk/src/documentation/content/xdocs/derby_downloads.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/derby_downloads.xml?rev=1807935&r1=1807934&r2=1807935&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/derby_downloads.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/derby_downloads.xml Sat Sep 9 23:45:38 2017
@@ -26,22 +26,29 @@
<section>
-<title> Latest Official Releases </title>
+<title>For Java 8 and Higher</title>
<ul>
<li> <a href="releases/release-10.13.1.1.cgi">10.13.1.1</a>
(October 25, 2016 / SVN 1766613)
</li>
- <li> <a href="releases/release-10.12.1.1.cgi">10.12.1.1</a>
- (October 11, 2015 / SVN 1704137)
- </li>
</ul>
</section>
+
<section>
-<title>Archived Official Releases</title>
+<title>For Java 6 and Higher</title>
<ul>
+ <li> <a href="releases/release-10.12.1.1.cgi">10.12.1.1</a>
+ (October 11, 2015 / SVN 1704137)
+ </li>
<li> <a href="releases/release-10.11.1.1.html">10.11.1.1</a>
(August 26, 2014 / SVN 1616546)
</li>
+</ul>
+</section>
+
+<section>
+<title>For Java 1.4 and Higher</title>
+<ul>
<li> <a href="releases/release-10.10.2.0.html">10.10.2.0</a>
(April 15, 2014 / SVN 1582446)
</li>
@@ -84,6 +91,12 @@
<li> <a href="releases/release-10.4.1.3.html">10.4.1.3</a>
(April 24, 2008 / SVN 648739)
</li>
+</ul>
+</section>
+
+<section>
+<title>For Java 1.3 and Higher</title>
+<ul>
<li> <a href="releases/release-10.2.2.0.html">10.2.2.0</a>
(Dec 12, 2006 / SVN 485682)
</li>
Modified: db/derby/site/trunk/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/faq.xml?rev=1807935&r1=1807934&r2=1807935&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/faq.xml Sat Sep 9 23:45:38 2017
@@ -93,10 +93,10 @@
<a href="http://www.google.com/help/refinesearch.html">domain
search</a>.
For example, the search string below looks for all references
- to "create table" in the 10.7 documentation set:
+ to "create table" in the 10.13 documentation set:
</p>
<source>
-"create table" site:db.apache.org/derby/docs/10.7
+"create table" site:db.apache.org/derby/docs/10.13
</source>
</answer>
@@ -186,10 +186,10 @@
</faq>
<faq id="derby_eclipse">
<question>
- How do you build Derby using Eclipse?
+ How do you build Derby using Eclipse or Netbeans?
</question>
<answer>
- <p>See the Eclipse instructions in the
+ <p>See the Eclipse and Netbeans instructions on the
<a href="http://wiki.apache.org/db-derby/BuildingDerby">BuildingDerby</a>
Wiki page.
</p>
@@ -256,7 +256,7 @@
</faq>
<faq id="pda">
<question>
- Can you run Derby on PDAs?
+ Can you run Derby on small devices?
</question>
<answer>
<p>
@@ -264,52 +264,18 @@
J2ME/CDC/Foundation with JSR169 as the JDBC api.
For more information, see the
<a href="http://db.apache.org/derby/docs/10.7/ref/rrefjdbcjsr169.html">Reference
- Guide</a>.
+ Guide</a>. Starting with 10.11, Derby added support for running on the small Java 8 compact profile 2 platform.
</p>
</answer>
</faq>
- <faq id="createdb_OS_X">
- <question>
- Why can't I create a new database or modify an existing database
- on Mac OS X?
- </question>
- <answer>
- <p>
- This appears to be a JVM issue with Derby on Mac OS X and
- was logged as
- <a href="http://issues.apache.org/jira/browse/DERBY-1">DERBY-1</a>.
- DERBY-1 is fixed in 10.1.2.1 and higher. If you are using an earlier
- version of Derby, upgrading to 10.1.2.1 or higher will prevent the need
- to use the workaround described below.
- The underlying JVM issue is fixed in Mac OS X 10.4 (Tiger) with J2SE 1.4.2,
- but remains a problem on Mac OS X 10.3 with Java 1.4.2 Update 2 and
- Mac OS X 10.4 with J2SE 5.0 Release 1. It has been fixed in more recent
- releases of the J2SE 5.0 JVM.
- The workaround is to set
- <a href="http://issues.apache.org/jira/browse/DERBY-1?page=comments#action_53617">derby.storage.fileSyncTransactionLog=true</a>
- in the derby.properties files to use file
- sync instead of write sync for log writes.
- </p>
- </answer>
- </faq>
<faq id="derby_javax">
<question>
Can I use Derby on Java release X?
</question>
<answer>
<p>
- Derby runs on Java 1.4 and newer (Derby 10.2 and earlier also
- runs with Java 1.3, should you need that).
- </p>
- <p>
- Two problems with handling Decimal conversion on
- Java 5.0 and newer:
- (<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>)
- were fixed in Derby 10.1. Note: Java 5.0 is also known as
- <a href="http://java.sun.com/j2se/naming_versioning_5_0.html">
- Java 1.5</a>.
+ See the <a href="derby_downloads.html">Derby Downloads</a> page
+ for the compatibility between Derby and Java versions.
</p>
</answer>
</faq>
@@ -320,7 +286,7 @@
</question>
<answer>
<p>
- Yes, Derby now supports such a configuration! For more information,
+ Of course! For more information,
start <a href="http://wiki.apache.org/db-derby/InMemoryBackEndPrimer">
here</a>.
</p>
@@ -338,7 +304,7 @@
<a href="integrate/SQuirreL_Derby.html">SQuirreL SQL</a>
with Derby, and the
<a href="http://wiki.apache.org/db-derby/UsesOfDerby">UsesOfDerby</a>
- Wiki page list GUIs that work with Derby.
+ Wiki page list other GUIs that work with Derby.
</p>
</answer>
</faq>
@@ -351,7 +317,7 @@
You can specify a
database name using an absolute or relative path.
Details are in the
- <a href="http://db.apache.org/derby/docs/10.7/devguide/cdevdvlp34964.html">Developer's Guide</a>
+ <a href="http://db.apache.org/derby/docs/10.13/devguide/cdevdvlp34964.html">Developer's Guide</a>
and helpful tips are on the
<a href="http://wiki.apache.org/db-derby/DatabaseNamesRelativeAbsolute">Derby
Wiki</a>.
@@ -411,9 +377,9 @@
<answer>
<p>
Derby does not support the LIMIT syntax. However, Derby 10.4
- added the <a href="http://db.apache.org/derby/docs/10.7/ref/rreffuncrownumber.html">ROW_NUMBER function</a>
+ added the <a href="http://db.apache.org/derby/docs/10.13/ref/rreffuncrownumber.html">ROW_NUMBER function</a>
and Derby 10.7 added the
- <a href="http://db.apache.org/derby/docs/10.7/ref/rrefsqljoffsetfetch.html">OFFSET and FETCH clauses</a>.
+ <a href="http://db.apache.org/derby/docs/10.13/ref/rrefsqljoffsetfetch.html">OFFSET and FETCH clauses</a>.
</p><p>
Derby also supports limiting the number of rows returned by a query through
<a href="http://mail-archives.apache.org/mod_mbox/db-derby-dev/200411.mbox/%3c41A95632.3010301@debrunners.com%3e">JDBC</a>. For example, to fetch the first 5 rows of a large table:
@@ -548,9 +514,9 @@
<p>
Also, Derby supports generated "identity" columns; examples are in
the
- <a href="http://db.apache.org/derby/docs/10.7/ref/rrefsqlj37836.html">Reference Guide</a>.
+ <a href="http://db.apache.org/derby/docs/10.13/ref/rrefsqlj37836.html">Reference Guide</a>.
The
- <a href="http://db.apache.org/derby/docs/10.7/ref/rrefidentityvallocal.html#rrefidentityvallocal">IDENTITY_VAL_LOCAL</a>
+ <a href="http://db.apache.org/derby/docs/10.13/ref/rrefidentityvallocal.html#rrefidentityvallocal">IDENTITY_VAL_LOCAL</a>
function returns the most recently assigned number.
</p>
</answer>
@@ -565,15 +531,14 @@
<answer>
<p>
Yes, you can use derby for client-server applications.
- Starting in 10.1 Derby includes the
- <a href="http://db.apache.org/derby/docs/10.7/adminguide/cadminappsclient.html">Derby Network Client jdbc driver</a>.
+ Starting in 10.1 Derby included the
+ <a href="http://db.apache.org/derby/docs/10.13/adminguide/cadminappsclient.html">Derby Network Client jdbc driver</a>.
The <a href="http://wiki.apache.org/db-derby/UsesOfDerby">UsesOfDerby</a>
Wiki pages lists additional drivers, including
- <a href="http://c-jdbc.objectweb.org/">C-JDBC</a>,
- the
+ <a href="http://c-jdbc.objectweb.org/">C-JDBC</a>
+ and the
<a href="http://www.ibm.com/developerworks/db2/downloads/jcc/">IBM
- DB2 JDBC Universal Driver</a>, and
- <a href="http://sequoia.continuent.org/HomePage">Sequoia</a>.
+ DB2 JDBC Universal Driver</a>.
</p>
</answer>
</faq>
@@ -586,7 +551,7 @@
Yes, Apache Derby has a JDBC driver
that works with the Derby Network Server.
It is called the
- <a href="http://db.apache.org/derby/docs/10.7/adminguide/cadminappsclient.html">Derby Network Client</a>
+ <a href="http://db.apache.org/derby/docs/10.13/adminguide/cadminappsclient.html">Derby Network Client</a>
and it became available starting with Derby 10.1.
</p>
</answer>
@@ -617,7 +582,7 @@
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
- <a href="http://db.apache.org/derby/docs/10.7/adminguide/cadminapps811478.html">Admin and Server Guide</a>.
+ <a href="http://db.apache.org/derby/docs/10.13/adminguide/cadminapps811478.html">Admin and Server Guide</a>.
</p>
</answer>
</faq>
@@ -634,18 +599,18 @@
Use PreparedStatement with dynamic markers('?') instead of Statement.
This will be faster since the statement does not need to be
recompiled every time. See the
-<a href="http://db.apache.org/derby/docs/10.7/tuning/ctunperf18705.html">Use prepared statements with substitution parameters</a> and
-<a href="http://db.apache.org/derby/docs/10.7/tuning/ctundepth29804.html#ctundepth29804">Avoid compiling SQL statements</a> sections of the Tuning Derby guide.
+<a href="http://db.apache.org/derby/docs/10.13/tuning/ctunperf18705.html">Use prepared statements with substitution parameters</a> and
+<a href="http://db.apache.org/derby/docs/10.13/tuning/ctundepth29804.html#ctundepth29804">Avoid compiling SQL statements</a> sections of the Tuning Derby guide.
</li>
<li>
Avoid inserts in autocommit mode if possible.
- Inserts can be painfully slow in autocommit mode.
- The reason is that each commit involves a flush of the
+ Autocommitted inserts
+ flush of the
log to the disk for each insert statement.
- The commit will not return until a physical disk write has been
+ The commit does not return until a physical disk write has been
executed.
- So to speed things up, run in autocommit false mode and
- execute a number of inserts in one transaction and then explicitly
+ So to speed things up, run in autocommit false mode,
+ execute a number of inserts in one transaction, and then explicitly
issue a commit.
</li>
</ol>
@@ -658,7 +623,7 @@
<answer>
<p>
The <em>Reference Guide</em> includes an
- <a href="http://db.apache.org/derby/docs/10.7/ref/rrefclob.html">example
+ <a href="http://db.apache.org/derby/docs/10.13/ref/rrefclob.html">example
that shows how to insert a CLOB</a>.
Also
<a href="http://mail-archives.apache.org/mod_mbox/db-derby-user/200509.mbox/%3c1126857139.2375.75.camel@pc977.sb.statsbiblioteket.dk%3e">this
Modified: db/derby/site/trunk/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/index.xml?rev=1807935&r1=1807934&r2=1807935&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/index.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/index.xml Sat Sep 9 23:45:38 2017
@@ -33,7 +33,7 @@ Some key advantages include:
</p>
<ul>
- <li> Derby has a small footprint -- about 2.6 megabytes for the base engine
+ <li> Derby has a small footprint -- about 3.5 megabytes for the base engine
and embedded JDBC driver.</li>
<li> Derby is based on the Java, JDBC, and
<a href="http://wiki.apache.org/db-derby/SQLvsDerbyFeatures">SQL</a>
Modified: db/derby/site/trunk/src/documentation/content/xdocs/license.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/license.xml?rev=1807935&r1=1807934&r2=1807935&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/license.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/license.xml Sat Sep 9 23:45:38 2017
@@ -33,8 +33,6 @@ Also see:
</p>
<ul>
- <li> <a href="http://www.apache.org/foundation/licence-FAQ">Apache
- Licensing FAQ</a></li>
<li> <a href="http://www.apache.org/dev/apply-license.html">Applying the
Apache License, Version 2.0</a></li>
<li> Cliff Schmidt's ApacheCon presentation titled
@@ -52,7 +50,7 @@ Also see:
</p>
<p>
-<em>This page last updated: 1-November-2005</em>
+<em>This page last updated: 09-September-2017</em>
</p>
</body>