synapse-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mukund Balasubramanian" <muk...@infravio.com>
Subject RE: Handling javadoc
Date Wed, 11 Jan 2006 19:25:46 GMT
In the short term, I believe placing the docs along with the distro
would be more user-friendly, especially because distribution size is not
a big problem right now.

In the long term, separating the two is "cleaner" a. la. JDK. 

What was the reasoning to do this for Axis2?

Mukund Balasubramanian

-----Original Message-----
From: Eran Chinthaka [mailto:chinthaka@opensource.lk] 
Sent: Wednesday, January 11, 2006 5:04 PM
To: synapse-dev@ws.apache.org
Subject: Re: Handling javadoc

Copied from new Axis2 distribution plan ? ;-)

Saminda Abeyruwan wrote:

>Hi Devs,
>
>In root level of the project, we can see two folders "xdocs" and
"docs".
>"xdocs" contains all the documentation of Synapse, ex: userguide.html,
etc.
>"docs" contains all  Java documents related to the project. Content in
>"docs" is pretty much obsolete now. We need to remove it from the root
>level.
>
>The best way to generate java doc is  on the fly. Using a goal in maven
>"javadoc" we can easily generate java docs and lets have different
>distributions for documents as well.
>
>We already have Binary distribution and Source distribution in place.
Lets
>have a another distribution as "document distribution" which only
contain
>Synapse and java documents. Binary/Source distribution doesn't contain
any
>documentation.
>
>This seems pretty clean and clear.
>
>What would be you thought on prior.
>
>Saminda
>
>  
>

---------------------------------------------------------------------
To unsubscribe, e-mail: synapse-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: synapse-dev-help@ws.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: synapse-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: synapse-dev-help@ws.apache.org


Mime
View raw message