db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Db-derby Wiki] Update of "DerbySnapshotOrRelease" by DyreTjeldvoll
Date Thu, 01 May 2008 17:24:36 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.

The following page has been changed by DyreTjeldvoll:
http://wiki.apache.org/db-derby/DerbySnapshotOrRelease

------------------------------------------------------------------------------
   1. Create a page for the release, build/update site
    {i} For instructions on how to build the website using Forrest, please see: [http://db.apache.org/derby/papers/derby_web.html]
  
-   a. Create an .html file for the release. The main thing to remember is that the .cgi file
should have the same name as the .html file. 
+   a. Create an HTML file for the release. 
     (!) It is a good idea to use the previous release pages as templates, filling in the
changed details as necessary. 
  
     {{{cd src/documentation/content/xdocs/releases
@@ -504, +504 @@

  
    a. In order for the release HTML file to be pulled into the build, it is necessary to
add a line to the <uris> section of `src/documentation/conf/cli.xconf`. Near line 310
of that file, add: `<uri type="append" src="releases/release-x.y.z.w.html"/>` (with
the correct version for your release).
  
-   a. You should add a .cgi 
+   a. Add a mirroring CGI script for the release. The CGI file should have the same name
as the HTML file, but obviously a `.cgi` extension.
+    (!) The easiest thing is probably just to copy the CGI script for an existing release.

-    * Forrest will not copy the release .cgi script over unless you make a link to it from
another page. Add the link to derby_downloads.html before building.
+    * Forrest will not copy the release CGI script over unless you make a link to it from
another page. Add the link to derby_downloads.html, as described below, before building.
-    * Make sure that the .cgi script is made executable by setting svn:executable on it with
{{{svn propset 
+    * Make sure that the CGI script is made executable by setting svn:executable on it 
- svn:executable ON release-10.1.2.1.cgi}}}. Be sure to do this for both the precursor version
you created in src/documentation/content/xdocs/releases and for the generated copy which forrest
builds into build/site/releases.
+ 
+    {{{cd src/documentation/content/xdocs/releases 
+ cp release-x'.y'.z'.w'.cgi release-x.y.z.w.cgi
+ svn add release-x.y.z.w.cgi      
+ svn propset svn:executable ON release-x.y.z.w.cgi }}}. 
+ 
+    <!> Be sure to set `svn:executable` also for the generated copy which forrest builds
into `build/site/releases`.
+ 
+   a. Remove mirroring for older releases which no longer require it. 
+    * Svn delete the CGI script. <!> Make sure you do this both in `src/documentation/content/xdocs/releases`
and `build/site/releases`. 
+    * Edit the release page to remove the CGI boilerplate and convert the distribution links
from mirror references to ordinary links. This means replacing the [preferred] tags with the
URL of the archive, i.e. `http://archive.apache.org/dist/`. 
+    
+    (!) To see what the release page should look like, look at the release page for an even
older release.
+ 
+    {{{cd build/site/releases
+ svn delete release-x'.y'.z'.w'.cgi
+ cd -
+ cd src/documentation/content/xdocs/releases
+ svn delete release-x'.y'.z'.w'.cgi
+ vi release-x'.y'.z'.w'.html }}}
  
    a. Update the `derby_downloads.xml` page in the `src/documentation/content/xdocs` directory
so that the links to the new files are included.
- 
-   a. Svn delete the cgi script for the previous release. Also, edit its release page to
remove the cgi boilerplate and convert the distribution links from mirror references to ordinary
links. This means removing the [preferred] tags. To see what this should look like, look at
the release page for an even older release.
  
    a. Run 'forrest site' at the top of the site tree.
     {i} [http://db.apache.org/derby/papers/derby_web.html Forrest instructions]

Mime
View raw message