You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by fb...@apache.org on 2008/01/05 00:40:59 UTC
svn commit: r609055 - in /incubator/river/trunk/jtsk: build.xml
build_common.xml doc/info-index.html doc/release-notes/outrigger.html
src/com/sun/jini/outrigger/package.html
Author: fbarnaby
Date: Fri Jan 4 15:40:55 2008
New Revision: 609055
URL: http://svn.apache.org/viewvc?rev=609055&view=rev
Log:
- Removed references in info-index.html related to former installation process.
- Removed top-level docs from source distribution.
- Fixed issues related to outrigger logstore and snaplogstore release notes.
- Fixed a typo in outrigger's package.html .
- Added note to top-level build.xml referring users to doc/build.html for build instructions.
Modified:
incubator/river/trunk/jtsk/build.xml
incubator/river/trunk/jtsk/build_common.xml
incubator/river/trunk/jtsk/doc/info-index.html
incubator/river/trunk/jtsk/doc/release-notes/outrigger.html
incubator/river/trunk/jtsk/src/com/sun/jini/outrigger/package.html
Modified: incubator/river/trunk/jtsk/build.xml
URL: http://svn.apache.org/viewvc/incubator/river/trunk/jtsk/build.xml?rev=609055&r1=609054&r2=609055&view=diff
==============================================================================
--- incubator/river/trunk/jtsk/build.xml (original)
+++ incubator/river/trunk/jtsk/build.xml Fri Jan 4 15:40:55 2008
@@ -16,7 +16,19 @@
! limitations under the License.
!-->
+
+
<!-- ################################################################## -->
+<!-- ## -->
+<!-- ## Building Apache River -->
+<!-- ## _____________________ -->
+<!-- ## -->
+<!-- ## Refer to doc/build.html to obtain detailed instructions for -->
+<!-- ## building the Apache River source distribution. -->
+<!-- ## -->
+<!-- ################################################################## -->
+
+
<project name="Jini" basedir="." default="all">
Modified: incubator/river/trunk/jtsk/build_common.xml
URL: http://svn.apache.org/viewvc/incubator/river/trunk/jtsk/build_common.xml?rev=609055&r1=609054&r2=609055&view=diff
==============================================================================
--- incubator/river/trunk/jtsk/build_common.xml (original)
+++ incubator/river/trunk/jtsk/build_common.xml Fri Jan 4 15:40:55 2008
@@ -423,24 +423,9 @@
<zip destfile="${src.zip.bundle}">
<zipfileset dir="${top}" prefix="${install.dir}">
- <include name="index.html"/>
-
<include name="DISCLAIMER"/>
<include name="LICENSE"/>
<include name="NOTICE"/>
-
- <include name="doc/api/**"/>
- <include name="doc/arch2_0.html"/>
- <include name="doc/info-index.html"/>
- <include name="doc/build.html"/>
- <include name="doc/manpages-index.html"/>
- <include name="doc/proxypreparation.pdf"/>
- <include name="doc/release-notes/**"/>
- <exclude name="doc/release-notes/new.html"/>
- <include name="doc/simpleproxyverification.pdf"/>
- <include name="doc/smartproxyverification.pdf"/>
- <include name="doc/spec-index.html"/>
- <include name="doc/specs/**"/>
</zipfileset>
<zipfileset dir="${top}" prefix="${install.dir}/source">
@@ -491,24 +476,9 @@
longfile="warn">
<tarfileset dir="${top}" prefix="${install.dir}">
- <include name="index.html"/>
-
<include name="DISCLAIMER"/>
<include name="LICENSE"/>
<include name="NOTICE"/>
-
- <include name="doc/api/**"/>
- <include name="doc/arch2_0.html"/>
- <include name="doc/info-index.html"/>
- <include name="doc/build.html"/>
- <include name="doc/manpages-index.html"/>
- <include name="doc/proxypreparation.pdf"/>
- <include name="doc/release-notes/**"/>
- <exclude name="doc/release-notes/new.html"/>
- <include name="doc/simpleproxyverification.pdf"/>
- <include name="doc/smartproxyverification.pdf"/>
- <include name="doc/spec-index.html"/>
- <include name="doc/specs/**"/>
</tarfileset>
<tarfileset dir="${top}" prefix="${install.dir}/source">
Modified: incubator/river/trunk/jtsk/doc/info-index.html
URL: http://svn.apache.org/viewvc/incubator/river/trunk/jtsk/doc/info-index.html?rev=609055&r1=609054&r2=609055&view=diff
==============================================================================
--- incubator/river/trunk/jtsk/doc/info-index.html (original)
+++ incubator/river/trunk/jtsk/doc/info-index.html Fri Jan 4 15:40:55 2008
@@ -22,7 +22,7 @@
<center><h1>Apache River Release<BR>Getting Started & More with v2.1.1</h1></center>
<UL><UL>
- <LI><a href="#examine">Examining the installed files</a>
+ <LI><a href="#examine">Examining the distribution</a>
<LI><a href="#install">Installing the <code>jsk-policy.jar</code> file</a>
<LI><a href="#example">Example program documentation</a>
<LI><a href="#build">Building from the source code</a>
@@ -34,28 +34,27 @@
<hr>
<UL>
<p>
-<a name="examine"><LI><B>Examining the installed files</B></LI></a>
+<a name="examine"><LI><B>Examining the Distribution</B></LI></a>
<p>
-Once you have installed this release, your installation folder
-should contain some or all of the following items. The actual items installed
-depend on the features selected during installation.
+Once you have unarchived this release, your installation folder
+should contain most if not all of the following items.
<p>
<blockquote>
<dl>
+ <dt><b>DISCLAIMER</b><dd>
+ The disclaimer regarding the fact that this project is currently under incubation at The Apache Software Foundation.
+ <dt><b>LICENSE</b><dd>
+ The Apache License.
+ <dt><b>NOTICE</b><dd>
+ The file containing contributor acknowledgments.
<dt><b>index.html</b><dd>
The starting page for all documentation
<dt><b>configentry</b><dd>
The directory that contains configuration entry description files
for all of the Jini services and utilities
- <dt><b>classes</b><dd>
- The directory that contains class files from the JAR files
- that are in the <code>lib</code> and <code>lib-dl</code> directories
<dt><b>doc</b><dd>
The directory that contains specifications, API documentation,
manual pages, release notes, license information, and other documentation
- <dt><b>installverify</b><dd>
- The directory that contains configurations and an executable for
- starting a service browser and six contributed Jini services
<dt><b>lib</b><dd>
The directory where the non-download JAR files are located
<dt><b>lib-dl</b><dd>
@@ -63,10 +62,7 @@
<dt><b>lib-ext</b><dd>
The directory where the dynamic security policy provider is located
<dt><b>source</b><dd>
- The directory that contains all of the source code and build files
- for the release and the hello example
- <dt><b>uninstall</b><dd>
- The directory that contains the uninstaller for the release
+ The directory where source code may be located if installed via the separate source release, which is only available as a separate download.
</dl>
</blockquote>
@@ -107,8 +103,11 @@
<a name="example"><LI><B>Example program documentation</B></a>
<p>
<ul>
- <li>The <a href="../source/src/com/sun/jini/example/hello/index.html">
- hello</a> example was installed if the source feature was selected during installation.
+ <li>The hello example is only included in the source release, which is available
+ as a separate download. Once the source release is downloaded and unarchived,
+ the example documentation will be located:
+ <p>
+ <install_dir>/source/src/com/sun/jini/example/hello/index.html
<li>Additional examples may be found at
<a href="http://starterkit-examples.jini.org">starterkit-examples.jini.org</a>.
@@ -118,10 +117,12 @@
<a name="build"><LI><B>Building from the source code</B></a>
<p>
<UL>
- <LI>The prebuilt binaries are included in the release, as is the
- source code.
- <LI>If you wish to rebuild the source code, please see the
- <a href="../doc/build.html">build instructions</a>.
+ <LI>The binaries can be build from the source code, which is available as a
+ separate download. If you wish to build the source code, you will need to
+ download the source release, unarchive it, and refer to the build instructions,
+ located:
+ <p>
+ <install_dir>/source/doc/build.html
</UL
<p>
<a name="background"><LI><B>Background Material</B></a>
Modified: incubator/river/trunk/jtsk/doc/release-notes/outrigger.html
URL: http://svn.apache.org/viewvc/incubator/river/trunk/jtsk/doc/release-notes/outrigger.html?rev=609055&r1=609054&r2=609055&view=diff
==============================================================================
--- incubator/river/trunk/jtsk/doc/release-notes/outrigger.html (original)
+++ incubator/river/trunk/jtsk/doc/release-notes/outrigger.html Fri Jan 4 15:40:55 2008
@@ -69,47 +69,32 @@
Included in Release</b>
<dd>
-The persistent version of Outrigger relies on a pluggable persistence layer,
-<a
-href="../api/com/sun/jini/outrigger/Store.html"><code>com.sun.jini.outrigger.Store</code></a>.
-Previous releases included one implementation of the <code>Store</code>
-interface, <a
-href="../api/com/sun/jini/outrigger/logstore/LogStore.html">logstore</a>.
-This release adds a second implementation, <a
-href="../api/com/sun/jini/outrigger/snaplogstore/LogStore.html">snaplogstore</a>.
-<p>
-
-While all the necessary classes are included with this release to run the
-transient version of Outrigger, or the persistent version using the new
-snaplogstore implementation of <code>Store</code>, the logstore
-implementation of <code>Store</code> requires the runtime classes for
-Progress Software's <i>ObjectStore PSEPro for Java</i>
-(PSEPro). Unfortunately, because of issues relating to the transition in
-licensing, this release does not include the PSEPro runtime classes,
-without which logstore will not work. We are sorry for any inconvenience
-this will cause. We hope to make a release with a complete version of
-logstore available as a separate download in the future.
-<p>
-
-Where v2.0.n releases used logstore as the default <code>Store</code>
-implementation, this release has no default store. In order to switch an
-existing set of configuration files, security policy files, etc., from
-using logstore to snaplogstore, you will need to change the <a
-href="../api/com/sun/jini/outrigger/package-summary.html#store">
-<code>com.sun.jini.outrigger.store</code></a> configuration entry (or add a
-<code>store</code> if you don't already have one) to yield a
-<code>com.sun.jini.outrigger.snaplogstore.LogStore</code> object. You will
-also need to ensure that <code>outrigger-snaplogstore.jar</code> has been
-granted sufficient permissions (see Outrigger's package <a
-href="../api/com/sun/jini/outrigger/package-summary.html#outrigger_all_policy">documentation</a>
-for a sample security policy file.).<p>
-
-Note that depending on the nature of your application snaplogstore can have
-a significantly different performance profile than logstore.<p>
-
-The storage formats used by snaplogstore and logstore are mutually
-incompatible.<p>
+ The persistent version of Outrigger relies on a pluggable persistence
+ layer, <code>com.sun.jini.outrigger.Store</code>. Previous releases
+ of the Starter Kit included two implementations of the Store interface,
+ <em>logstore</em> and <em>snaplogstore</em>. This release removes
+ logstore.
+<p>
+ Logstore has been around in various forms since the 1.0 version of
+ Outrigger. Snapstore was introduced in v2.1 of the Starter Kit.
<p>
+ The v2.0.n releases of the Starter Kit used logstore as the default Store
+ implementation, this release has no default Store. In order to switch an
+ existing set of configuration files, security policy files, etc., from using
+ logstore to snaplogstore, you will need to change the
+ <code>com.sun.jini.outrigger.store</code> configuration entry (or add a
+ store configuration entry if you don't already have one) to yield a
+ <code>com.sun.jini.outrigger.snaplogstore.LogStore</code> object. You
+ will also need to ensure that <code>outrigger-snaplogstore.jar</code> has
+ been granted sufficient permissions (see Outrigger's package documentation
+ for a sample security policy file.).
+<p>
+ Note that depending on the nature of your application snaplogstore can
+ have a significantly different performance profile than logstore.
+<p>
+ The storage formats used by snaplogstore and logstore are mutually
+ incompatible.
+
<dt><b>Incompatible Change Made to <code>Store</code> Interface</b>
@@ -186,7 +171,7 @@
To better support the layering of applications,
the JAR files, including those related to Outrigger, have
been restructured. The changes to the server-side files
-(e.g. <code>outrigger.jar</code>, <code>outrigger-logstore.jar</code>,
+(e.g. <code>outrigger.jar</code>, <code>outrigger-snaplogstore.jar</code>,
etc.) may require changes to the security policy files used for Outrigger
servers. Permissions must now be granted to <code>jsk-lib.jar</code> in
addition to Outrigger's other server side JAR files. The changes to
Modified: incubator/river/trunk/jtsk/src/com/sun/jini/outrigger/package.html
URL: http://svn.apache.org/viewvc/incubator/river/trunk/jtsk/src/com/sun/jini/outrigger/package.html?rev=609055&r1=609054&r2=609055&view=diff
==============================================================================
--- incubator/river/trunk/jtsk/src/com/sun/jini/outrigger/package.html (original)
+++ incubator/river/trunk/jtsk/src/com/sun/jini/outrigger/package.html Fri Jan 4 15:40:55 2008
@@ -50,7 +50,7 @@
scalability characteristics, so if you were using Logstore in the past you
many want to evaluate how your application works with Snaplogstore.
-Because there is no default <code>Store</code> implementation if your are
+Because there is no default <code>Store</code> implementation if you are
using <code>PersistentOutriggerImpl</code> you will need to provide a value
for the <a href="#store"><code>store</code></a> configuration entry (as
well as the <a