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 "ReleasePublication" by RichardHillegas
Date Tue, 08 Jan 2013 18:24:31 GMT
Dear Wiki user,

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

The "ReleasePublication" page has been changed by RichardHillegas:
http://wiki.apache.org/db-derby/ReleasePublication?action=diff&rev1=27&rev2=28

  
  
   1. Copy the latest version of the documentation to the doc directory on the website. 
-   The documentation is included in the release you uploaded, but unfortunately its directory
structure is not quite right for the website. You will need to create a zip file of docs in
the correct directory structure. To do this for a release on the 10.7 (or later) branch, do
the following at the top of the source tree. You will be prompted for the location of the
binzip distribution (db-derby-x.y.z.w-bin.zip) and the branch name (x.y). The zip file will
be created in the directory release/repackagedocs:
+   The documentation is included in the release you uploaded, but unfortunately its directory
structure is not quite right for the website. If you are working on a 10.6 or earlier release
branch, consult version 27 of this wiki page for instructions about what to do. Otherwise,
do the following at the top of the source tree of the release branch. You will be prompted
for the location of the binzip distribution (db-derby-x.y.z.w-bin.zip), the branch name (x.y),
and the location of your website subversion client:
  
  {{{
  ant repackagedocs
  }}}
  
  
- If you are on a 10.6 or earlier branch, then you create the zip of docs as follows. Unzip
the `db-derby-x.y.z.w-bin.zip` archive, rename some directories and copy the pdf files into
the html hierarchy. Here is a shell script outlining the process. The argument to the script
is the location of `db-derby-x.y.z.w-bin.zip`.
+ This will create a re-arranged subdirectory of release docs under the generated subtree
of your website client. The subdirectory will be called build/site/docs/x.y. If this is a
new, feature release, then you will need to "svn add" build/site/docs/x.y to your website
subversion space. Use "svn commit" to push the newly added docs to the production website.
  
- {{{
- mkdir ~/x.y
- cd ~/x.y
- unzip $1
- mv db*bin/docs .
- mv db*bin/javadoc ./publishedapi
- rm -r db*bin
- 
- for i in adminguide devguide getstart ref tools tuning
- do
-   mv docs/pdf/$i/*.pdf docs/html/$i
-   rmdir docs/pdf/$i
- done
- 
- mv docs/html/* .
- rmdir docs/html
- rm -rf docs/pdf/pt_BR
- rm -rf docs/pdf/ja_JP
- rmdir docs/pdf
- rmdir docs
- zip -r x.y.zip x.y
- }}}
- 
- 
- Now copy the zip file over to `/www/db.apache.org/derby/docs`.
- 
- {{{
- scp x.y.zip you@people.apache.org:/www/db.apache.org/derby/docs/
- ssh you@people.apache.org
- cd /www/db.apache.org/derby/docs/
- unzip x.y.zip
- rm x.y.zip }}}
-   <!> Make sure that all files and directories have permissions that make them accessible
on the web! Note that you will not be able to verify this in a web browser until the new directories
and files have been rsynced to real webserver.
-   <!> Make sure that the owning group is "db". You may need to issue this command:
"chown -R yourName:db x.y".
   
   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]]

Mime
View raw message