Keith Grant wrote:
While I was ultimately successful the OJB documentation was misleading
or downright wrong. I hope you will make the corrections to the
document so that others will not have the same difficulty as I.
Specifically, in the âGetting Startedâ section the instructions state: âUnpack the source distribution and retrieve the additional required libaries. Place these jar files in the lib directory of the OJB distribution.â
After downloading and extracting several versions the source distribution I still could not find the necessary jar files. Of course you know the required jar files are not in the distribution. But the âAdditional jar archivesâ section listed the necessary files.
That section states, âOJB depends on several other jar archives. These jar files are shipped in the db-ojb-<version>/lib directoryâ.
It goes on to list eleven jar files, ejb.jar being one of them.
Since the error ant displayed was:
main-opt:
[javac] Compiling 553 source files to C:\Program Files\OJB\db-ojb-1.0.rc7\target\classes
[javac] C:\Program Files\OJB\db-ojb-1.0.rc7
\target\src\org\apache\ojb\broker\core\PersistenceBrokerBean.java:47:
package javax.ejb does not exist
I though that once I got the ejb.jar I would be able to successfully compile. So I downloaded j2ee SDK and looked for ejb.jar. Of course it wasnât there what I had to use was j2ee.jar.
I'll check the jar names in the doc and update them as necessary.
Most of the other jars listed as required to compile are actually not needed.
Some of the names have changed in recent releases (e.g. antlr now has only one archive, ant has split its archives), where others are only required to run the unit tests (e.g. torque, velocity). The doc simply states that usually you do not need them at runtime.
I hope you can update the documentation to addresses these problems. Who knows how many simply give up because they couldnât complete this very first step.
In the last days, the getting started doc has already recieved a significant rework, and now there is no need to build OJB from source anymore due to a prebuild ojb-blank archive containing the basic set of libraries needed to run OJB projects. The updated doc and archives are however not yet online, but will so in the next couple of days.
If you care, then grab OJB from CVS. For building the doc you'll however need Forrest (http://forrest.apache.org) from SVN (Subversion, a version control system similar to CVS).
Also note there are a number of deprecated API warnings.
This is by design because you cannot simply change an API when preparing for a final release (the API is supposed to be stable since rc6, I believe). The deprecation means that you should not use this API anymore because these parts are to be removed in future versions.
Similar for external dependencies because OJB strives to not only be compatible with the newest versions of the libraries but also with older ones where the API wasn't deprecated.
Tom
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
