Return-Path: Delivered-To: apmail-db-derby-commits-archive@www.apache.org Received: (qmail 24648 invoked from network); 14 Aug 2005 02:16:28 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 14 Aug 2005 02:16:28 -0000 Received: (qmail 47363 invoked by uid 500); 14 Aug 2005 02:16:27 -0000 Delivered-To: apmail-db-derby-commits-archive@db.apache.org Received: (qmail 47215 invoked by uid 500); 14 Aug 2005 02:16:26 -0000 Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Derby Development" List-Id: Delivered-To: mailing list derby-commits@db.apache.org Received: (qmail 47007 invoked by uid 99); 14 Aug 2005 02:16:24 -0000 X-ASF-Spam-Status: No, hits=-9.8 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Sat, 13 Aug 2005 19:16:17 -0700 Received: (qmail 24476 invoked by uid 65534); 14 Aug 2005 02:16:17 -0000 Message-ID: <20050814021617.24474.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r232570 [5/6] - in /db/derby/site/trunk: build/site/ build/site/binaries/ build/site/integrate/ build/site/integrate/plugin_help/ build/site/manuals/ build/site/papers/ build/site/releases/ src/documentation/content/xdocs/ src/documentation... Date: Sun, 14 Aug 2005 02:16:04 -0000 To: derby-commits@db.apache.org From: jta@apache.org X-Mailer: svnmailer-1.0.3 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Modified: db/derby/site/trunk/build/site/papers/JDBCImplementation.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/JDBCImplementation.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/JDBCImplementation.html (original) +++ db/derby/site/trunk/build/site/papers/JDBCImplementation.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + @@ -23,22 +23,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -695,21 +748,30 @@

+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/MiscPresentations.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/MiscPresentations.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/MiscPresentations.html (original) +++ db/derby/site/trunk/build/site/papers/MiscPresentations.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Miscellaneous Derby Presentations @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -227,21 +280,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/alloc-page.png URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/alloc-page.png?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== Binary files - no diff available. Modified: db/derby/site/trunk/build/site/papers/container-format.png URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/container-format.png?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== Binary files - no diff available. Modified: db/derby/site/trunk/build/site/papers/derby_arch.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/derby_arch.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/derby_arch.html (original) +++ db/derby/site/trunk/build/site/papers/derby_arch.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby Engine Architecture Overview @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -391,21 +444,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/derby_htw.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/derby_htw.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/derby_htw.html (original) +++ db/derby/site/trunk/build/site/papers/derby_htw.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + How Things Work @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -379,21 +432,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/derby_web.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/derby_web.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/derby_web.html (original) +++ db/derby/site/trunk/build/site/papers/derby_web.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Apache Derby Web Site @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -362,9 +415,7 @@
Warning
-The Derby web site uses Forrest 0.6 and it will be upgraded to 0.7 "soon". -Forrest 0.7 must not be used to build the Derby site until it is upgraded -because the directory structure is different. +The Derby web site uses Forrest 0.7 and must be built using Forrest 0.7.
@@ -412,16 +463,31 @@
  • If you have an HTML file, perhaps named your_file.html, - one option is to leave it as is +
      + +
    • One option is to leave the file as is (previous forrest releases had you rename it to a file - named your_file.ihtml). - Forrest will convert it into a new - your_file.html file in the build tree -- and you may or may not - like how Forrest formatted it. + named your_file.ihtml, but support for the ihtml extension + is deprecated in forrest 0.7). + Forrest will convert the file into a new + your_file.html file in the build tree and will add the site + decoration and navigation to it. The Derby JDBC Implementation Notes paper is an example of an HTML document - that is stored in the project source tree as an ihtml file. -
    • + that is stored in the project source tree as an html file. + + +
    • Another option is to rename the file with a .htm + extension. Forrest won't touch it, but will just copy it as is + to the build tree; it won't add site decoration and navigation. + This is useful for documents that Forrest has trouble converting. + The Running DOTS (Database Open + Source Test Suite) with Derby is an example of this approach. +
    • + +
    + +
  • You can also create an XML file that uses the Forrest DTD. The Derby Engine @@ -487,24 +553,24 @@ - +

    Updating the Apache Derby web site

    The information in this section is intended for committers who need to add a page to the Derby web site or modify an existing page.

    - +

    1. Install Forrest on your machine

    If you haven't installed Forrest yet, -install Forrest 0.6 +install Forrest 0.7 on your local system. Then generate a seed project, as described in the previous section, and play with it to get comfortable working with Forrest.

    - +

    2. Check out the Derby web site pages

    Check the Derby web site files out of the Subversion repository: @@ -512,7 +578,7 @@

     svn co https://svn.apache.org/repos/asf/db/derby/site/trunk
     
    - +

    3. Modify files in the src tree

    Source files are in the places listed below: @@ -530,9 +596,9 @@ src/documentation/content/xdocs - Source files in formats Forrest can consume (*.xml and *.ihtml). - Forrest ingests these files, adds navigation and - decorations, and outputs them as .html files to + Source files in formats Forrest can consume, such as *.xml and *.html. + Forrest ingests these files, adds site navigation and + decoration, and outputs them as .html files to build/site and build/app. @@ -541,7 +607,7 @@ src/documentation/content/xdocs/papers - Source HTML files you don't want Forrest to touch. + Source HTML files you don't want Forrest to touch (*.htm). Forrest copies these files without modifying them to build/site/papers. @@ -561,13 +627,6 @@

    -The default directory structure -is somewhat different for the src and build trees -(and the Derby web site uses default locations). -Links in source files -need to point to the name and the location of the target file in the build tree. -

    -

    Two files in src/documentation/content/xdocs don't get output to the build tree; they control the information and links in the resulting navigation bar: @@ -598,7 +657,7 @@

- +

4. Build the site

After modifying files, you need to rebuild the site with the @@ -609,7 +668,7 @@ build directories.

- +

5. Test the changes

There are a couple ways (at least) to review changes. @@ -644,7 +703,7 @@ won't be added when the site is viewed locally.

- +

6. Commit changes to the src and build/site directories

Commit modified pages in the src and @@ -659,7 +718,7 @@ src and build/site directory hierarchies. Do this after 'forrest site' has been run but -before committing changes into Subversion. +before committing changes to the the subversion repository.

One more note about adding new text files. @@ -672,9 +731,9 @@

However, the easiest way to manage svn:eol-style is to -automatically set common file types by adding the -Apache dev list to -your ~/.subversion/config file. +automatically set end of line for common file types by adding the +Apache dev list +of files to your ~/.subversion/config file.

When you're ready to commit, @@ -686,7 +745,7 @@

 svn commit --message "here is my commit message" src build/site 
 
- +

7. Make web site changes visible

A Derby committer can make web site changes visible as follows: @@ -700,7 +759,7 @@ www.apache.org automatically syncs up with people.apache.org every couple hours (the specific schedule could change).

- +

8. Considering a quick fix to the build tree?

If you modify a file in the build/site tree, @@ -709,27 +768,36 @@ will likely overwrite your changes to the build tree.

-Last updated August 1, 2005 +Last updated August 13, 2005

+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/field-header-non-overflow.png URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/field-header-non-overflow.png?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== Binary files - no diff available. Modified: db/derby/site/trunk/build/site/papers/field-header-overflow.png URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/field-header-overflow.png?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== Binary files - no diff available. Modified: db/derby/site/trunk/build/site/papers/fortune_tut.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/fortune_tut.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/fortune_tut.html (original) +++ db/derby/site/trunk/build/site/papers/fortune_tut.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Apache Derby Fortune Server Tutorial @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -401,21 +454,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/index.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/index.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/index.html (original) +++ db/derby/site/trunk/build/site/papers/index.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Apache Derby White Papers @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ +
-
Built with Apache Forrest - logo
-
- + + + +
-Font size: + Font size:       @@ -484,7 +536,7 @@
+
 
Valid HTML 4.01!Valid CSS!
@@ -524,6 +582,9 @@ Send feedback about the website to: derby-dev@db.apache.org + Modified: db/derby/site/trunk/build/site/papers/logformats.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/logformats.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/logformats.html (original) +++ db/derby/site/trunk/build/site/papers/logformats.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby Write Ahead Log Format @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -812,21 +865,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/optimizer.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/optimizer.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/optimizer.html (original) +++ db/derby/site/trunk/build/site/papers/optimizer.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby Optimizer Design @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -476,21 +529,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/page-format.png URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/page-format.png?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== Binary files - no diff available. Modified: db/derby/site/trunk/build/site/papers/pageformats.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/pageformats.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/pageformats.html (original) +++ db/derby/site/trunk/build/site/papers/pageformats.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby On Disk Page Format @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -1300,21 +1353,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/recovery.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/recovery.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/recovery.html (original) +++ db/derby/site/trunk/build/site/papers/recovery.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby Logging and Recovery @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -537,7 +590,7 @@

Transactions can be at the following states w/r to a checkpoint - consider the log as a continous stream and not as series of log files for the sake of clarity:
- +

@@ -763,21 +816,30 @@
 
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/papers/versionupgrade.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/papers/versionupgrade.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/papers/versionupgrade.html (original) +++ db/derby/site/trunk/build/site/papers/versionupgrade.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Derby Versioning Scheme @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -483,21 +536,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/releases/release-10.0.2.1.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/releases/release-10.0.2.1.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/releases/release-10.0.2.1.html (original) +++ db/derby/site/trunk/build/site/releases/release-10.0.2.1.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Apache Derby 10.0.2.1 Release @@ -16,22 +16,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -1005,21 +1058,30 @@
+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Modified: db/derby/site/trunk/build/site/releases/release-10.1.1.0.html URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/releases/release-10.1.1.0.html?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/build/site/releases/release-10.1.1.0.html (original) +++ db/derby/site/trunk/build/site/releases/release-10.1.1.0.html Sat Aug 13 19:13:50 2005 @@ -3,7 +3,7 @@ - + Apache Derby 10.1.1.0 Release @@ -17,22 +17,49 @@
+ +
+ + + + + + + +
+
- -
+ + +
+
 
+ + + +
-Font size: + Font size:       @@ -1101,7 +1154,13 @@

Use the links below to download a distribution of Apache Derbyfrom one of our mirrors. It is good practice to verify the integrity of the distribution files.

You are currently using [preferred]. If you encounter a problem with this mirror, then please select another. If all mirrors are failing, there are backup mirrors at the end of the list. See status of mirrors.

-Other mirrors: +Other mirrors:

There are three different distributions:

    @@ -1227,21 +1286,30 @@

    We strongly recommend you verify your downloads with both PGP and MD5.

+
 
Send feedback about the website to: derby-dev@db.apache.org
+ Copied: db/derby/site/trunk/src/documentation/content/xdocs/integrate/DOTS_Derby.htm (from r232402, db/derby/site/trunk/src/documentation/content/xdocs/DOTS_Derby.htm) URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/integrate/DOTS_Derby.htm?p2=db/derby/site/trunk/src/documentation/content/xdocs/integrate/DOTS_Derby.htm&p1=db/derby/site/trunk/src/documentation/content/xdocs/DOTS_Derby.htm&r1=232402&r2=232570&rev=232570&view=diff ============================================================================== --- db/derby/site/trunk/src/documentation/content/xdocs/DOTS_Derby.htm (original) +++ db/derby/site/trunk/src/documentation/content/xdocs/integrate/DOTS_Derby.htm Sat Aug 13 19:13:50 2005 @@ -5011,7 +5011,7 @@

-[Back to Derby Papers] +[Back to Derby Papers]

Modified: db/derby/site/trunk/src/documentation/content/xdocs/integrate/index.xml URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/integrate/index.xml?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/src/documentation/content/xdocs/integrate/index.xml (original) +++ db/derby/site/trunk/src/documentation/content/xdocs/integrate/index.xml Sat Aug 13 19:13:50 2005 @@ -30,7 +30,7 @@ DOTS Derby - Running DOTS + Running DOTS (Database Open Source Test Suite) with Derby Modified: db/derby/site/trunk/src/documentation/content/xdocs/integrate/misc.xml URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/integrate/misc.xml?rev=232570&r1=232569&r2=232570&view=diff ============================================================================== --- db/derby/site/trunk/src/documentation/content/xdocs/integrate/misc.xml (original) +++ db/derby/site/trunk/src/documentation/content/xdocs/integrate/misc.xml Sat Aug 13 19:13:50 2005 @@ -97,7 +97,7 @@ DOTS is the Database Opensource Test Suite. Sunitha Kambhampati provided a writeup on - Running DOTS with Derby + Running DOTS with Derby and Ramandeep Kaur provided a writeup on