You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by vg...@apache.org on 2006/06/13 14:45:20 UTC

svn commit: r413889 - /cocoon/trunk/README.txt

Author: vgritsenko
Date: Tue Jun 13 05:45:19 2006
New Revision: 413889

URL: http://svn.apache.org/viewvc?rev=413889&view=rev
Log:
add note on how to build

Modified:
    cocoon/trunk/README.txt

Modified: cocoon/trunk/README.txt
URL: http://svn.apache.org/viewvc/cocoon/trunk/README.txt?rev=413889&r1=413888&r2=413889&view=diff
==============================================================================
--- cocoon/trunk/README.txt (original)
+++ cocoon/trunk/README.txt Tue Jun 13 05:45:19 2006
@@ -18,6 +18,24 @@
 http://cocoon.zones.apache.org/daisy/documentation/g2/756.html
 http://cocoon.zones.apache.org/daisy/documentation/g1/798.html
 
+HOW TO BUILD THE COCOON WEBAPP (NON OSGI MODE)
+----------------------------------------------
+
+Since Cocoon release 2.2, Cocoon relies on Maven 2 for its build
+process. You have to install Maven 2.0.4 (or later) first. Once
+Maven is installed, use following command:
+
+  $ mvn -Dmaven.test.skip=true install
+
+In case of any failures, repeat command as necessary till you see
+the message:
+
+  BUILD SUCCESSFUL
+
+You may need anywhere from 5 minutes to 4 hours for this step to
+complete.
+
+ 
 HOW TO MOUNT THE PROJECTS IN ECLIPSE
 ------------------------------------
 
@@ -35,26 +53,29 @@
 You can also get eclipse to download the sources of the dependent libraries and attach them 
 to the jars in eclipse :
 
-$ mvn -Declipse.downloadSources=true eclipse:eclipse
+  $ mvn -Declipse.downloadSources=true eclipse:eclipse
 
 For further information about the maven eclipse plugin visit 
 
-http://maven.apache.org/plugins/maven-eclipse-plugin/
+  http://maven.apache.org/plugins/maven-eclipse-plugin/
+
 
 HOW TO START THE COCOON WEBAPP (NON OSGI MODE)
 ----------------------------------------------
 
-0. checkout complete trunk and
+Checkout complete trunk and build it. If clean rebuild is desired,
+use command:
   $ mvn clean install
 
-  Call this until you get "BUILD SUCCESSFUL" - sometimes downloads from maven
-  repositories are temporarily unaccessible and cause the build to fail.
+Call this until you get "BUILD SUCCESSFUL" - sometimes downloads from maven
+repositories are temporarily unaccessible and cause the build to fail.
 
-1. go to core/cocoon-webapp
+Go to core/cocoon-webapp:
   $ mvn cocoon:deploy
   $ mvn jetty6:run-exploded
 
-2. point your browser to http://localhost:8888/
+Point your browser to http://localhost:8888/
+
 
 HOW TO START THE COCOON WEBAPP (OSGI MODE)
 ------------------------------------------



Re: svn commit: r413889 - /cocoon/trunk/README.txt

Posted by Bertrand Delacretaz <bd...@apache.org>.
On 6/13/06, Jorg Heymans <jh...@domek.be> wrote:

> ...Unless you want absolutely nobody to try the new build I suggest you
> remove this witty comment...

Just a thought, as the situation w.r.t. Maven repositories and mirrors
seems to be evolving quite a lot, it might be good to point from the
readme to a wiki "Maven tips and tricks" page, where people can find
up-to-date info, and advice as to which mirrors to use.

-Bertrand

Re: svn commit: r413889 - /cocoon/trunk/README.txt

Posted by Giacomo Pati <gi...@apache.org>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Tue, 13 Jun 2006, Vadim Gritsenko wrote:

> Jorg Heymans wrote:
>>  vgritsenko@apache.org wrote:
>> 
>> >  +
>> >  +You may need anywhere from 5 minutes to 4 hours for this step to
>> >  +complete.
>> >  +
>>
>>  Unless you want absolutely nobody to try the new build I suggest you
>>  remove this witty comment.
>
> It's not witty, it's factual. Giacomo recently reported that it can be in as 
> little as 5 minutes.

Yes, with all the artifacts already downloaded. And as we all know 
download can be very slow. I think this make the very wide span of 5 
mins to 4 h and could be explained (which I did right now).

>>  Why not insert a few lines describing how to change the primary mirror
>
> Please do, especially since you know how.

+1

>>  like i suggested to you yesterday [1] ? That would convey a much more
>>  positive message.
>
> The mirror you suggested seems to be noticeably slower than default.

IIRC the mirror was mentione for European locations.

- -- 
Giacomo Pati
Otego AG, Switzerland - http://www.otego.com
Orixo, the XML business alliance - http://www.orixo.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)

iD8DBQFEj8PTLNdJvZjjVZARAsWJAKDpxnQzi3K13BwrPTHgwL4VBuxpdgCgqzAe
QT/aQbNjbfPt/5eTH/K9mzk=
=hHyL
-----END PGP SIGNATURE-----

Re: svn commit: r413889 - /cocoon/trunk/README.txt

Posted by Antonio Gallardo <ag...@agssa.net>.
Vadim Gritsenko escribió:
> Jorg Heymans wrote:
>> vgritsenko@apache.org wrote:
>>
>>> +
>>> +You may need anywhere from 5 minutes to 4 hours for this step to
>>> +complete.
>>> +
>>
>> Unless you want absolutely nobody to try the new build I suggest you
>> remove this witty comment.
>
> It's not witty, it's factual. Giacomo recently reported that it can be 
> in as little as 5 minutes.
Agreed [1]. But as a positive comment, we should add: "this might 
happens to you only the first time. The maven community is already aware 
of this issue and they are working to solve it. The 2nd and next builds 
takes 1-5 minutes, because there is no need to download again the 
required jars."

[1] Technically this time, it depends of what jars we have already 
downloaded to our local repository. The contacted Maven Repository 
Server (MRS) load, etc. I personally found the best time for downloading 
from a MRS are weekends. The worse time in a working day is one hour 
after Europe start working to when NY/LA ends the working day. Hence, 
weekends are the best time for downloading. :-)


>
>
>> Why not insert a few lines describing how to change the primary mirror
>
> Please do, especially since you know how.
>
>
>> like i suggested to you yesterday [1] ? That would convey a much more
>> positive message.
>
> The mirror you suggested seems to be noticeably slower than default.
You are not in *Europe*, right? ;-)

Best Regards,

Antonio Gallardo


Re: svn commit: r413889 - /cocoon/trunk/README.txt

Posted by Vadim Gritsenko <va...@reverycodes.com>.
Jorg Heymans wrote:
> vgritsenko@apache.org wrote:
> 
>> +
>> +You may need anywhere from 5 minutes to 4 hours for this step to
>> +complete.
>> +
> 
> Unless you want absolutely nobody to try the new build I suggest you
> remove this witty comment.

It's not witty, it's factual. Giacomo recently reported that it can be in as 
little as 5 minutes.


> Why not insert a few lines describing how to change the primary mirror

Please do, especially since you know how.


> like i suggested to you yesterday [1] ? That would convey a much more
> positive message.

The mirror you suggested seems to be noticeably slower than default.

Vadim


> Thanks
> Jorg
> 
> [1] http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=115013968125520&w=2
> and http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=115014066901259&w=2


Re: svn commit: r413889 - /cocoon/trunk/README.txt

Posted by Jorg Heymans <jh...@domek.be>.
vgritsenko@apache.org wrote:

> +
> +You may need anywhere from 5 minutes to 4 hours for this step to
> +complete.
> +

Unless you want absolutely nobody to try the new build I suggest you
remove this witty comment.

Why not insert a few lines describing how to change the primary mirror
like i suggested to you yesterday [1] ? That would convey a much more
positive message.


Thanks
Jorg

[1] http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=115013968125520&w=2
and http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=115014066901259&w=2