[Geoserver-devel] Maven Quickstart

Hi,

The doc below is ready for review. Whoever is doing review please go ahead..

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

--
Kind Regards
Clint Lewis

Clint Lewis ha scritto:

Hi,

The doc below is ready for review. Whoever is doing review please go ahead..

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

I find two things a little funny:
* install does the testing as well... better put the section about testing before
   the one about deploying
* deploy seems to me the wrong term, since it does not deploy anything at all,
   just builds the output jars and installs them into the local repository.
   I would call it "building" (in the full meaning of the term).

Morever, are you sure that mvn compile does work if you haven't previoulsy installed
the jars? Try to wipe out geoserver from your local repository and do a mnv compile.
My gut feeling is that it won't work.

Finally, you miss mvn site to build the docs.

Cheers
Andrea

Wow thanks Andrea talk about speedy service.. I think my keyboard is still warm from typing the mail :wink:

Kind Regards
Clint Lewis

Andrea Aime wrote:

Clint Lewis ha scritto:

Hi,

The doc below is ready for review. Whoever is doing review please go ahead..

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

I find two things a little funny:
* install does the testing as well... better put the section about testing before
  the one about deploying
* deploy seems to me the wrong term, since it does not deploy anything at all,
  just builds the output jars and installs them into the local repository.
  I would call it "building" (in the full meaning of the term).

Morever, are you sure that mvn compile does work if you haven't previoulsy installed
the jars? Try to wipe out geoserver from your local repository and do a mnv compile.
My gut feeling is that it won't work.

Finally, you miss mvn site to build the docs.

Cheers
Andrea

Andrea Aime wrote:

Clint Lewis ha scritto:

Hi,

The doc below is ready for review. Whoever is doing review please go ahead..

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

I find two things a little funny:
* install does the testing as well... better put the section about testing before
   the one about deploying

Not sure this is required since it is a quickstart. The fact that tests are running on an install sholdn't throw anythign off. I think that someone checking out for the first time will be less interested in runnign the tests standalone.

* deploy seems to me the wrong term, since it does not deploy anything at all,
   just builds the output jars and installs them into the local repository.
   I would call it "building" (in the full meaning of the term).

I agree, these are poorly named. And +1 for changing the term to building to mean compile + install.

Morever, are you sure that mvn compile does work if you haven't previoulsy installed
the jars? Try to wipe out geoserver from your local repository and do a mnv compile.
My gut feeling is that it won't work.

You should be able to compile from scratch from the root. If you try to compile a spdecific module it will fail because it will be missing the parent pom from the repository. Definitley something worth noting. Good catch.

Finally, you miss mvn site to build the docs

The build isn't configured to do a site build. The javadocs are generated with the javadoc:javadoc goal alone. However, I have a question. Can the site plugin merge all the javadocs together. One of the problems is that the generated javadocs are just local to specific modules and need to merged after the fact. Be interesting to find out.

Cheers
Andrea

Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

!DSPAM:1004,44aa7569219161336712104!

--
Justin Deoliveira
The Open Planning Project
jdeolive@anonymised.com

Kind Regards
Clint Lewis

Justin Deoliveira wrote:

Andrea Aime wrote:

Clint Lewis ha scritto:

Hi,

The doc below is ready for review. Whoever is doing review please go ahead..

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

I find two things a little funny:
* install does the testing as well... better put the section about testing before
   the one about deploying

Not sure this is required since it is a quickstart. The fact that tests are running on an install sholdn't throw anythign off. I think that someone checking out for the first time will be less interested in runnign the tests standalone.

So I will remove the test!!

* deploy seems to me the wrong term, since it does not deploy anything at all,
   just builds the output jars and installs them into the local repository.
   I would call it "building" (in the full meaning of the term).

I agree, these are poorly named. And +1 for changing the term to building to mean compile + install.

Cool I will rename the term now problem

Morever, are you sure that mvn compile does work if you haven't previoulsy installed
the jars? Try to wipe out geoserver from your local repository and do a mnv compile.
My gut feeling is that it won't work.

You should be able to compile from scratch from the root. If you try to compile a spdecific module it will fail because it will be missing the parent pom from the repository. Definitley something worth noting. Good catch.

Justin is write you cant compile a module from scratch but if you compile from the root you wont have problems. I will make a note of this in the docs?

Finally, you miss mvn site to build the docs

The build isn't configured to do a site build. The javadocs are generated with the javadoc:javadoc goal alone. However, I have a question. Can the site plugin merge all the javadocs together. One of the problems is that the generated javadocs are just local to specific modules and need to merged after the fact. Be interesting to find out.

What should I do here???

Cheers
Andrea

Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

!DSPAM:1004,44aa7569219161336712104!

Justin Deoliveira ha scritto:

Finally, you miss mvn site to build the docs

The build isn't configured to do a site build.

It will generate the standard site then, with the basic reports

The javadocs are generated with the javadoc:javadoc goal alone. However, I have a question. Can the site plugin merge all the javadocs together. One of the problems is that the generated javadocs are just local to specific modules and need to merged after the fact. Be interesting to find out.

It can, sure, just add the aggregate option. The only problem is that
I stumbled in a bug that triggers only during aggregation when you use
annotation in source, and happens to be a javadoc bug: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442982

Anyway, since I don't have anything to do, I'll update the build
to generate a site similar to the geotools one.

Cheers
Andrea

There is now two build sections for mvn compile and mvn install please see site, they should be renamed separately!

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

Kind Regards
Clint Lewis

Andrea Aime wrote:

Justin Deoliveira ha scritto:

Finally, you miss mvn site to build the docs

The build isn't configured to do a site build.

It will generate the standard site then, with the basic reports

The javadocs are generated with the javadoc:javadoc goal alone. However, I have a question. Can the site plugin merge all the javadocs together. One of the problems is that the generated javadocs are just local to specific modules and need to merged after the fact. Be interesting to find out.

It can, sure, just add the aggregate option. The only problem is that
I stumbled in a bug that triggers only during aggregation when you use
annotation in source, and happens to be a javadoc bug: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442982

Anyway, since I don't have anything to do, I'll update the build
to generate a site similar to the geotools one.

Cheers
Andrea

Hi,

I have updated the docs to reflect some of the changes that we discussed, please review and let me know. I will chat to you all later..

Done none of the mvn site stuff mentioned.

http://docs.codehaus.org/display/GEOSDEV/2+Maven+Quickstart

Kind Regards
Clint Lewis

Andrea Aime wrote:

Justin Deoliveira ha scritto:

Finally, you miss mvn site to build the docs

The build isn't configured to do a site build.

It will generate the standard site then, with the basic reports

The javadocs are generated with the javadoc:javadoc goal alone. However, I have a question. Can the site plugin merge all the javadocs together. One of the problems is that the generated javadocs are just local to specific modules and need to merged after the fact. Be interesting to find out.

It can, sure, just add the aggregate option. The only problem is that
I stumbled in a bug that triggers only during aggregation when you use
annotation in source, and happens to be a javadoc bug: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442982

Anyway, since I don't have anything to do, I'll update the build
to generate a site similar to the geotools one.

Cheers
Andrea