db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject svn commit: r226837 - in /db/derby/site/trunk: build/site/index.html build/site/papers/derby_web.html src/documentation/content/xdocs/index.xml src/documentation/content/xdocs/papers/derby_web.xml
Date Mon, 01 Aug 2005 16:42:33 GMT
Author: jta
Date: Mon Aug  1 09:42:28 2005
New Revision: 226837

URL: http://svn.apache.org/viewcvs?rev=226837&view=rev
Log:
Added more updates for moving Derby from Incubator to the DB project, based
on suggestions by danesh.i@gmail.com. Also brought papers/derby_web.html more
up to date; for example, forrest 0.7 is now the production release but was 
still being mentioned as a development release.

Modified:
    db/derby/site/trunk/build/site/index.html
    db/derby/site/trunk/build/site/papers/derby_web.html
    db/derby/site/trunk/src/documentation/content/xdocs/index.xml
    db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml

Modified: db/derby/site/trunk/build/site/index.html
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/build/site/index.html?rev=226837&r1=226836&r2=226837&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/index.html (original)
+++ db/derby/site/trunk/build/site/index.html Mon Aug  1 09:42:28 2005
@@ -348,13 +348,14 @@
 mainly focussing on embedded use with IBM's Java products and middleware. 
 In August 2004 IBM contributed the code to the Apache Software Foundation
 as Derby, an incubator project sponsored by the Apache DB project.
+In July 2005 Derby graduated from the Incubator into the Apache DB project.
 </p>
 </div>
 
 
 <p>
 
-<em>Last updated: 31-July-2004</em>
+<em>Last updated: 1-August-2005</em>
 
 </p>
 

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=226837&r1=226836&r2=226837&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/papers/derby_web.html (original)
+++ db/derby/site/trunk/build/site/papers/derby_web.html Mon Aug  1 09:42:28 2005
@@ -226,11 +226,14 @@
 <a href="#Web+Site+Change+Notes">Web Site Change Notes</a>
 <ul class="minitoc">
 <li>
-<a href="#27-Jan-2005%3A+Web+site+upgraded+to+Forrest+0.6">27-Jan-2005: Web site upgraded
to Forrest 0.6</a>
+<a href="#31-Jul-2005%3A+Web+site+moved+from+Incubator+to+Apache+DB">31-Jul-2005: Web
site moved from Incubator to Apache DB</a>
 </li>
 <li>
 <a href="#15-May-2005%3A+Version+10.0+manuals+moved">15-May-2005: Version 10.0 manuals
moved</a>
 </li>
+<li>
+<a href="#27-Jan-2005%3A+Web+site+upgraded+to+Forrest+0.6">27-Jan-2005: Web site upgraded
to Forrest 0.6</a>
+</li>
 </ul>
 </li>
 <li>
@@ -298,7 +301,38 @@
 <a name="N10017"></a><a name="Web+Site+Change+Notes"></a>
 <h2 class="boxed">Web Site Change Notes</h2>
 <div class="section">
-<a name="N1001D"></a><a name="27-Jan-2005%3A+Web+site+upgraded+to+Forrest+0.6"></a>
+<a name="N1001D"></a><a name="31-Jul-2005%3A+Web+site+moved+from+Incubator+to+Apache+DB"></a>
+<h3 class="boxed">31-Jul-2005: Web site moved from Incubator to Apache DB</h3>
+<p>
+Derby graduated from the Incubator to the Apache DB project,
+so the web site moved from
+http://incubator.apache.org/derby to
+<a href="http://db.apache.org/derby">http://db.apache.org/derby</a>.
+Specific changes, beginning with SVN revision 226719, included:
+</p>
+<ul>
+  
+<li>
+<span class="codefrag">src/documentation/skinconf.xml</span>: 
+       Changed the group logo, which appears on the masthead,
+       from the Incubator logo to the Apache DB logo, and updated the bread
+       crumb trail.
+  </li>
+  
+<li>Updated references and URLs throughout the site from 
+      incubator to db or from incubator.apache.org to db.apache.org.
+  </li>
+
+</ul>
+<a name="N10036"></a><a name="15-May-2005%3A+Version+10.0+manuals+moved"></a>
+<h3 class="boxed">15-May-2005: Version 10.0 manuals moved</h3>
+<p>
+The files that comprise the 10.0 manuals are numerous (about 750), static,
+and take a while to build (20-40 minutes, depending on the machine).
+In May they were moved to a separate "mini" forrest site, which is now at
+<a href="http://db.apache.org/derby/docs/10.0/index.html">http://db.apache.org/derby/docs/10.0/index.html</a>.
+</p>
+<a name="N10044"></a><a name="27-Jan-2005%3A+Web+site+upgraded+to+Forrest+0.6"></a>
 <h3 class="boxed">27-Jan-2005: Web site upgraded to Forrest 0.6</h3>
 <p>
 The Derby web site was initialized in August 2004 with Forrest 0.5.1.
@@ -334,18 +368,10 @@
 </li>
 
 </ul>
-<a name="N1004B"></a><a name="15-May-2005%3A+Version+10.0+manuals+moved"></a>
-<h3 class="boxed">15-May-2005: Version 10.0 manuals moved</h3>
-<p>
-The files that comprise the 10.0 manuals are numerous (about 750), static,
-and take a while to build.
-In May they were moved to a separate "mini" forrest site at
-<a href="http://db.apache.org/derby/docs/10.0/index.html">http://db.apache.org/derby/docs/10.0/index.html</a>.
-</p>
 </div>
 
 
-<a name="N1005A"></a><a name="Forrest+in+a+Nutshell"></a>
+<a name="N10073"></a><a name="Forrest+in+a+Nutshell"></a>
 <h2 class="boxed">Forrest in a Nutshell</h2>
 <div class="section">
 <p>
@@ -374,10 +400,8 @@
 <div class="frame warning">
 <div class="label">Warning</div>
 <div class="content">
-The Derby web site uses Forrest 0.6,
-which is the
-<a class="external" href="http://forrest.apache.org/mirrors.cgi">current official release</a>.
-Forrest 0.7 is in development, but must not be used to build the Derby site
+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.
 </div>
 </div>
@@ -385,24 +409,17 @@
 
 
 
-<a name="N10089"></a><a name="Testing+New+Pages+for+the+Derby+Site"></a>
+<a name="N1009E"></a><a name="Testing+New+Pages+for+the+Derby+Site"></a>
 <h2 class="boxed">Testing New Pages for the Derby Site</h2>
 <div class="section">
 <p>
 The information in this section is intended for anyone 
 who wants to develop content for the Derby web site
 (in other words, for both committers and non-committers).
-</p>
-<p>
-It takes 20-40 minutes to build the Derby web site, 
-depending on the machine and the scope of the change. 
-By comparison, 
-the seed site used for testing the <em>Papers</em> tab 
-took only 25 seconds to build.
-So, it is much easier to integrate new pages by first
+It is much easier to integrate new pages by first
 testing them outside the Derby web site source tree.
 </p>
-<a name="N10098"></a><a name="Create+a+Forrest+seed+site"></a>
+<a name="N100A7"></a><a name="Create+a+Forrest+seed+site"></a>
 <h3 class="boxed">Create a Forrest seed site</h3>
 <p>
 To get started:
@@ -425,7 +442,7 @@
 <li> Look at the sample pages that are included in the seed site.</li>
 
 </ul>
-<a name="N100BD"></a><a name="Add+your+new+page+to+the+seed+site"></a>
+<a name="N100CC"></a><a name="Add+your+new+page+to+the+seed+site"></a>
 <h3 class="boxed">Add your new page to the seed site</h3>
 <p>
 Next, incorporate the new page(s) into the newly-created seed site:
@@ -433,16 +450,15 @@
 <ul>
    
 <li> If you have an HTML file, perhaps named <em>your_file.html</em>,
-        one option is to copy it to a file named <em>your_file.ihtml</em>.
+        one option is to leave it as is
+        (previous forrest releases had you rename it to a file 
+         named <em>your_file.ihtml</em>).
 	Forrest will convert it into a new
         <em>your_file.html</em> file in the build tree -- and you may or may
not
 	like how Forrest formatted it.
 	The <a href="JDBCImplementation.html">Derby JDBC Implementation
         Notes</a> paper is an example of an HTML document
         that is stored in the project source tree as an <span class="codefrag">ihtml</span>
file.
-	Likewise, the Derby document files in the
-	<span class="codefrag">manuals</span> directory hierarchy are 
-        <span class="codefrag">ihtml</span> files.
    </li>
    
 <li> You can also create an XML file that uses the Forrest DTD.
@@ -503,26 +519,20 @@
 <p>
 When you're satisfied with how your new page looks on your seed site,
 then it is ready to be added to the Derby web site.
-You can do a first pass by checking out a local copy of the web site:
-</p>
-<pre class="code">
-svn co http://svn.apache.org/repos/asf/db/derby/site/trunk
-</pre>
-<p>
-The physical structure of the web site is described in the next section.
+The mechanics of doing that is described in the next section.
 </p>
 </div>
 
 
 
-<a name="N10121"></a><a name="Updating+the+Apache+Derby+web+site+"></a>
+<a name="N10123"></a><a name="Updating+the+Apache+Derby+web+site+"></a>
 <h2 class="boxed">Updating the Apache Derby web site </h2>
 <div class="section">
 <p>
 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.
 </p>
-<a name="N1012A"></a><a name="1.+Install+Forrest+on+your+machine"></a>
+<a name="N1012C"></a><a name="1.+Install+Forrest+on+your+machine"></a>
 <h3 class="boxed">1. Install Forrest on your machine</h3>
 <p>
 If you haven't installed Forrest yet,
@@ -532,7 +542,7 @@
 as described in the previous section,
 and play with it to get comfortable working with Forrest.
 </p>
-<a name="N10138"></a><a name="2.+Check+out+the+Derby+web+site+pages+"></a>
+<a name="N1013A"></a><a name="2.+Check+out+the+Derby+web+site+pages+"></a>
 <h3 class="boxed">2. Check out the Derby web site pages </h3>
 <p>
 Check the Derby web site files out of the Subversion repository:
@@ -540,7 +550,7 @@
 <pre class="code">
 svn co https://svn.apache.org/repos/asf/db/derby/site/trunk
 </pre>
-<a name="N10146"></a><a name="3.+Modify+files+in+the+src+tree+"></a>
+<a name="N10148"></a><a name="3.+Modify+files+in+the+src+tree+"></a>
 <h3 class="boxed">3. Modify files in the src tree </h3>
 <p>
 Source files are in the places listed below:
@@ -626,7 +636,7 @@
 </li>
 
 </ul>
-<a name="N101D3"></a><a name="4.+Build+the+site+"></a>
+<a name="N101D5"></a><a name="4.+Build+the+site+"></a>
 <h3 class="boxed">4. Build the site </h3>
 <p>
 After modifying files, you need to rebuild the site with the
@@ -637,13 +647,7 @@
 <span class="codefrag">build</span> 
 directories.
 </p>
-<p>
-Because the Derby manuals are included in the web site,
-'<span class="codefrag">forrest site</span>' takes a while, 
-anywhere from 20 - 40 minutes, depending
-on the machine.
-</p>
-<a name="N101EC"></a><a name="5.+Test+the+changes+"></a>
+<a name="N101E8"></a><a name="5.+Test+the+changes+"></a>
 <h3 class="boxed">5. Test the changes </h3>
 <p>
 There are a couple ways (at least) to review changes.
@@ -678,7 +682,7 @@
 won't be added when the site is viewed locally.</a>
 
 </p>
-<a name="N1021E"></a><a name="6.+Commit+changes+to+the+src+and+build%2Fsite+directories"></a>
+<a name="N1021A"></a><a name="6.+Commit+changes+to+the+src+and+build%2Fsite+directories"></a>
 <h3 class="boxed">6. Commit changes to the src and build/site directories</h3>
 <p>
 Commit modified pages in the <span class="codefrag">src</span> and
@@ -687,10 +691,6 @@
 <span class="codefrag">build/webapp</span> and
 <span class="codefrag">build/tmp</span> directories,
 but they aren't checked into the Subversion repository.
-(Checking built pages into subversion is a side effect from 
-<a class="external" href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200409.mbox/%3c41375CD8.4030501@Golux.Com%3e">how

-the project was originally set up</a>
-and is likely to change at some point.)
 </p>
 <p>
 If you add or delete a file, you must 'svn add' or 'svn delete' it in the
@@ -701,12 +701,20 @@
 </p>
 <p>
 One more note about adding new text files.
-After you add the file to the repository
-set the end-of-line for the file to <span class="codefrag">native</span>:
+After you add the file to the repository,
+it's important to set the end-of-line for the file to <span class="codefrag">native</span>.
+You can do so explicitly with the command shown below:
 </p>
 <pre class="code">svn propset svn:eol-style native <em>filename</em>
 </pre>
 <p>
+However,
+the easiest way to manage <span class="codefrag">svn:eol-style</span> is to 
+automatically set common file types by adding the 
+<a class="external" href="http://www.apache.org/dev/svn-eol-style.txt">Apache dev list
to 
+your ~/.subversion/config file</a>.
+</p>
+<p>
 When you're ready to commit,
 one way is to enter the command shown below
 from the directory that is one level above the
@@ -716,31 +724,30 @@
 <pre class="code">
 svn commit --message "here is my commit message" src build/site 
 </pre>
-<a name="N1025D"></a><a name="7.+Make+web+site+changes+visible"></a>
+<a name="N1025F"></a><a name="7.+Make+web+site+changes+visible"></a>
 <h3 class="boxed">7. Make web site changes visible</h3>
 <p>
 A Derby committer can make web site changes visible as follows:
 </p>
 <pre class="code">
-ssh -l <em>your_apache_login</em> minotaur.apache.org
+ssh -l <em>your_apache_login</em> people.apache.org
 cd /www/db.apache.org/derby
 svn update
 </pre>
 <p>
-As of this writing on March 23, 2005, 
-www.apache.org automatically syncs up with minotaur.apache.org every four hours
-(this specific schedule could change).
+www.apache.org automatically syncs up with people.apache.org every couple hours
+(the specific schedule could change).
 </p>
-<a name="N10271"></a><a name="8.+Considering+a+quick+fix+to+the+build+tree%3F"></a>
+<a name="N10273"></a><a name="8.+Considering+a+quick+fix+to+the+build+tree%3F"></a>
 <h3 class="boxed">8. Considering a quick fix to the build tree?</h3>
 <p>
 If you modify a file in the <span class="codefrag">build/site</span> tree, 
 be sure to also change the source file in the <span class="codefrag">src</span>
tree.
-Otherwise, the next '<span class="codefrag">forrest site</span>' / 'svn commit'
-might overwrite your changes to the build tree.
+Otherwise, the next '<span class="codefrag">forrest site</span>' followed by
'<span class="codefrag">svn commit</span>'
+will likely overwrite your changes to the build tree.
 </p>
 <p>
-<em>Last updated July 31, 2005</em>
+<em>Last updated August 1, 2005</em>
 </p>
 </div>
 

Modified: db/derby/site/trunk/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/index.xml?rev=226837&r1=226836&r2=226837&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/index.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/index.xml Mon Aug  1 09:42:28 2005
@@ -144,12 +144,13 @@
 mainly focussing on embedded use with IBM's Java products and middleware. 
 In August 2004 IBM contributed the code to the Apache Software Foundation
 as Derby, an incubator project sponsored by the Apache DB project.
+In July 2005 Derby graduated from the Incubator into the Apache DB project.
 </p>
 
 </section>
 
 <p>
-<em>Last updated: 31-July-2004</em>
+<em>Last updated: 1-August-2005</em>
 </p>
 
 </body>

Modified: db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml
URL: http://svn.apache.org/viewcvs/db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml?rev=226837&r1=226836&r2=226837&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml Mon Aug  1 09:42:28
2005
@@ -25,6 +25,40 @@
 <title>Web Site Change Notes</title>
 
 <section>
+<title>31-Jul-2005: Web site moved from Incubator to Apache DB</title>
+<p>
+Derby graduated from the Incubator to the Apache DB project,
+so the web site moved from
+http://incubator.apache.org/derby to
+<a href="http://db.apache.org/derby">http://db.apache.org/derby</a>.
+Specific changes, beginning with SVN revision 226719, included:
+</p>
+
+<ul>
+  <li><code>src/documentation/skinconf.xml</code>: 
+       Changed the group logo, which appears on the masthead,
+       from the Incubator logo to the Apache DB logo, and updated the bread
+       crumb trail.
+  </li>
+  <li>Updated references and URLs throughout the site from 
+      incubator to db or from incubator.apache.org to db.apache.org.
+  </li>
+</ul>
+</section>
+
+<section>
+<title>15-May-2005: Version 10.0 manuals moved</title>
+
+<p>
+The files that comprise the 10.0 manuals are numerous (about 750), static,
+and take a while to build (20-40 minutes, depending on the machine).
+In May they were moved to a separate "mini" forrest site, which is now at
+<a href="http://db.apache.org/derby/docs/10.0/index.html">http://db.apache.org/derby/docs/10.0/index.html</a>.
+</p>
+
+</section>
+
+<section>
 <title>27-Jan-2005: Web site upgraded to Forrest 0.6</title>
 <p>
 The Derby web site was initialized in August 2004 with Forrest 0.5.1.
@@ -52,18 +86,8 @@
 </ul>
 </section>
 
-<section>
-<title>15-May-2005: Version 10.0 manuals moved</title>
-
-<p>
-The files that comprise the 10.0 manuals are numerous (about 750), static,
-and take a while to build.
-In May they were moved to a separate "mini" forrest site at
-<a href="http://db.apache.org/derby/docs/10.0/index.html">http://db.apache.org/derby/docs/10.0/index.html</a>.
-</p>
 
 </section>
-</section>
 
 <section><title>Forrest in a Nutshell</title>
 
@@ -94,10 +118,8 @@
 </p>
 
 <warning>
-The Derby web site uses Forrest 0.6,
-which is the
-<a href="http://forrest.apache.org/mirrors.cgi">current official release</a>.
-Forrest 0.7 is in development, but must not be used to build the Derby site
+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.
 </warning>
 
@@ -111,15 +133,7 @@
 The information in this section is intended for anyone 
 who wants to develop content for the Derby web site
 (in other words, for both committers and non-committers).
-</p>
-
-<p>
-It takes 20-40 minutes to build the Derby web site, 
-depending on the machine and the scope of the change. 
-By comparison, 
-the seed site used for testing the <em>Papers</em> tab 
-took only 25 seconds to build.
-So, it is much easier to integrate new pages by first
+It is much easier to integrate new pages by first
 testing them outside the Derby web site source tree.
 </p>
 
@@ -152,16 +166,15 @@
 
 <ul>
    <li> If you have an HTML file, perhaps named <em>your_file.html</em>,
-        one option is to copy it to a file named <em>your_file.ihtml</em>.
+        one option is to leave it as is
+        (previous forrest releases had you rename it to a file 
+         named <em>your_file.ihtml</em>).
 	Forrest will convert it into a new
         <em>your_file.html</em> file in the build tree -- and you may or may
not
 	like how Forrest formatted it.
 	The <a href="JDBCImplementation.html">Derby JDBC Implementation
         Notes</a> paper is an example of an HTML document
         that is stored in the project source tree as an <code>ihtml</code> file.
-	Likewise, the Derby document files in the
-	<code>manuals</code> directory hierarchy are 
-        <code>ihtml</code> files.
    </li>
    <li> You can also create an XML file that uses the Forrest DTD.
 	The <a href="derby_arch.html">Derby Engine 
@@ -216,15 +229,7 @@
 <p>
 When you're satisfied with how your new page looks on your seed site,
 then it is ready to be added to the Derby web site.
-You can do a first pass by checking out a local copy of the web site:
-</p>
-
-<source>
-svn co http://svn.apache.org/repos/asf/db/derby/site/trunk
-</source>
-
-<p>
-The physical structure of the web site is described in the next section.
+The mechanics of doing that is described in the next section.
 </p>
 
 </section>
@@ -348,12 +353,6 @@
 directories.
 </p>
 
-<p>
-Because the Derby manuals are included in the web site,
-'<code>forrest site</code>' takes a while, 
-anywhere from 20 - 40 minutes, depending
-on the machine.
-</p>
 </section>
 
 <section>
@@ -411,10 +410,6 @@
 <code>build/webapp</code> and
 <code>build/tmp</code> directories,
 but they aren't checked into the Subversion repository.
-(Checking built pages into subversion is a side effect from 
-<a href="http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200409.mbox/%3c41375CD8.4030501@Golux.Com%3e">how

-the project was originally set up</a>
-and is likely to change at some point.)
 </p>
 
 <p>
@@ -427,13 +422,22 @@
 
 <p>
 One more note about adding new text files.
-After you add the file to the repository
-set the end-of-line for the file to <code>native</code>:
+After you add the file to the repository,
+it's important to set the end-of-line for the file to <code>native</code>.
+You can do so explicitly with the command shown below:
 </p>
 
 <source>svn propset svn:eol-style native <em>filename</em></source>
 
 <p>
+However,
+the easiest way to manage <code>svn:eol-style</code> is to 
+automatically set common file types by adding the 
+<a href="http://www.apache.org/dev/svn-eol-style.txt">Apache dev list to 
+your ~/.subversion/config file</a>.
+</p>
+
+<p>
 When you're ready to commit,
 one way is to enter the command shown below
 from the directory that is one level above the
@@ -454,15 +458,14 @@
 </p>
 
 <source>
-ssh -l <em>your_apache_login</em> minotaur.apache.org
+ssh -l <em>your_apache_login</em> people.apache.org
 cd /www/db.apache.org/derby
 svn update
 </source>
 
 <p>
-As of this writing on March 23, 2005, 
-www.apache.org automatically syncs up with minotaur.apache.org every four hours
-(this specific schedule could change).
+www.apache.org automatically syncs up with people.apache.org every couple hours
+(the specific schedule could change).
 </p>
 
 </section>
@@ -472,13 +475,13 @@
 <p>
 If you modify a file in the <code>build/site</code> tree, 
 be sure to also change the source file in the <code>src</code> tree.
-Otherwise, the next '<code>forrest site</code>' / 'svn commit'
-might overwrite your changes to the build tree.
+Otherwise, the next '<code>forrest site</code>' followed by '<code>svn
commit</code>'
+will likely overwrite your changes to the build tree.
 </p>
 
 </section>
 
-<p><em>Last updated July 31, 2005</em></p>
+<p><em>Last updated August 1, 2005</em></p>
 </section>
 
 </body>



Mime
View raw message