I was looking for the javadoc issue, and the issue is that
maven-dependency-plugin:unpack-javadoc just copy and unpack each
module javadoc files, overriding files with same name from previous
modules javadoc, this is why we only see the index.html from the last
module processed, instead of having a "aggregated" index.html.

I have tried various options to aggregate these javadocs from multiple
modules, without any success.

Does anybody know about some maven hacks to accomplish this ?


On 5/24/07, Simon Laws <[EMAIL PROTECTED]> wrote:
OK, below is an errata based on the points that people have highlighted as
important in this thread. Anything else need to be added? Anyone have any
better words for installing samples from the binary distro in Eclipse or any
words at all for IDEA. Now we have most people's comments in, this is quite
a long list!

Simon

Samples
=======
* Some sample READMEs don't match the code as it stands
  calculator-rmi-reference
    The README describes how to start client and server processes from this
project. This is now not
    the case. This project now only supports the client process. Use the
calculator-rmi-service sample
    to start the server using "ant-f build-server.xml run" first and then
run the client here.

  calculator-rmi-service
    The README describes how to start client and server processes from this
project. This is now not
    the case. This project now only supports the server process. Run the
server here first and then
    use the calculator-rmi-reference sample to start the client using "ant
-f build-client.xml run".

* The implementation-crud-client sample has the wrong package name for the
test client
  In both README and build.xml "crud.CRUDClient" should read "
crud.client.CRUDClient"

* The calculator-web and helloworld-jsonrpc build.xml produces a war that is
not deployable. To fix the build.xml file. Move the line

  <include name="sca-api-0.90-incubating-SNAPSHOT.jar"/>

  From the <lib> section to the <zipfileset> section.

* At the top of the web page provided by the helloworld-jsonrpc sample there
is the text.
  "... to make JSON-RPC requests to the service located at
services/HelloWorldService"
  Selecting the link "service/HelloWorldService" causes and error.

* There is no sample for how to use the META_INF/sca-deployables feature in
this release.

Build
=====

* There is a problem building the source distribution on linux with the IBM
JDK 1.5.0. The problem manifests itself
  with a problem building the databinding-jaxb module. Maven reports that it
is unable to process the
  maven-jaxb-plugin pom. This occurs because this pom has non-UTF8
characters. The manual fix is to remove the
  offending characters manually from the pom in your local repo and restart
the build:

  .m2/repository/com/sun/tools/xjc/maven2/maven-jaxb-plugin/1.1/maven-
jaxb-plugin-1.1.pom

  remove the non-UTF8 characters from this block.

    <developer>
      <id>MÆlfweald</id>
      <name>Malachi de Ælfweald</name>
      <email>[EMAIL PROTECTED]</email>
      <roles>
        <role>Developer</role>
      </roles>
    </developer>

Documentation
=============

* Java doc for some of the SPI packages listed in the the CHANGES file are
missing from the docs directory
* Java doc for org.osoa.sca.* packages is provided but not included on the
index page
* Java doc to the Tuscany Java SCA APIs is not provided with this release
* Instructions for loading the binary distribution samples into an IDE
without using maven to generate suitable project
  files are missing.

  For Eclipse - in a new or existing workspace
    Create a new java project to represent the sample you want to work on,
e.g.
        calculator
    Import all of the sample code and resources into this project, e.g.
        File, Import and then select
tuscany-sca-0.90-incubating\samples\calculator from the filesystem
    Configure the source path to include
        src/main/java
        src/main/resources
    Configure the output folder to be
        calculator/target
    Configure the build path to include all of the jars provided in
        lib
        modules
     If you select calculator.CalculatorClient.java and run as "Java
Application" you should see
        3 + 2=5.0
        3 - 2=1.0
        3 * 2=6.0
        3 / 2=1.5

Other
=====

* Some non-working modules have been included in the distribution and should
be ignored
  modules/binding-jms
  modules/discovery-jms
  modules/implementation-spring
  modules/jmx



--
Luciano Resende
Apache Tuscany Committer
http://people.apache.org/~lresende
http://lresende.blogspot.com/

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to