diff --git a/HACKING b/HACKING index d61b2fad8..ea5d586b1 100644 --- a/HACKING +++ b/HACKING @@ -72,10 +72,11 @@ Debian/Ubuntu * Download source code:: - $ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan + $ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan * Compile project:: + $ cd libreplan/ $ mvn clean install * Launch application:: @@ -121,10 +122,11 @@ Fedora * Download source code:: - $ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan + $ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan * Compile project:: + $ cd libreplan/ $ mvn clean install * Launch application:: @@ -181,10 +183,11 @@ openSUSE * Download source code:: - $ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan + $ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan * Compile project:: + $ cd libreplan/ $ mvn clean install * Launch application:: diff --git a/INSTALL b/INSTALL index 865ef74aa..3f167f4f5 100644 --- a/INSTALL +++ b/INSTALL @@ -29,13 +29,13 @@ Debian packages ~~~~~~~~~~~~~~~ There are Debian packages for Squeeze (i386 and amd64), you can download them -from: http://sourceforge.net/projects/navalplan/files/LibrePlan/ +from: http://sourceforge.net/projects/libreplan/files/LibrePlan/ Instructions: * Download the package:: - $ wget http://downloads.sourceforge.net/project/navalplan/files/LibrePlan/libreplan_1.2.0-1_amd64.deb + $ wget http://downloads.sourceforge.net/project/libreplan/files/LibrePlan/libreplan_1.2.0-1_amd64.deb * Install package:: @@ -73,7 +73,7 @@ Debian/Ubuntu * Download database installation script:: - $ wget -O install.sql http://downloads.sourceforge.net/project/navalplan/LibrePlan/install_1.2.0.sql + $ wget -O install.sql http://downloads.sourceforge.net/project/librelplan/LibrePlan/install_1.2.0.sql * Create database structure:: @@ -81,7 +81,7 @@ Debian/Ubuntu * Download ``.war`` file from SourceForge.net:: - $ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/LibrePlan/libreplan_1.2.0.war + $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.2.0.war * Create a new file ``/etc/tomcat6/Catalina/localhost/libreplan.xml`` (file name has to match with ``.war`` name) with database configuration for @@ -180,7 +180,7 @@ openSUSE * Download database installation script:: - $ wget -O install.sql http://downloads.sourceforge.net/project/navalplan/LibrePlan/install_1.2.0.sql + $ wget -O install.sql http://downloads.sourceforge.net/project/libreplan/LibrePlan/install_1.2.0.sql * Create database structure:: @@ -188,7 +188,7 @@ openSUSE * Download ``.war`` file from SourceForge.net:: - $ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/LibrePlan/libreplan_1.2.0.war + $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.2.0.war * Create a new file ``/etc/tomcat6/Catalina/localhost/libreplan.xml`` (file name has to match with ``.war`` name) with database configuration for diff --git a/README b/README index 215034dae..58192027f 100644 --- a/README +++ b/README @@ -126,10 +126,10 @@ Availability ------------ The cutting-edge version of this project is always available from the Git -repository at http://navalplan.git.sourceforge.net/. +repository at http://libreplan.git.sourceforge.net/. Released versions are available at -http://sourceforge.net/projects/navalplan/files. +http://sourceforge.net/projects/libreplan/files/. Webpage diff --git a/UPDATE b/UPDATE index 4364280f6..391279b93 100644 --- a/UPDATE +++ b/UPDATE @@ -26,7 +26,7 @@ Instructions: * Download the new package:: - $ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1-1_amd64.deb + $ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1-1_amd64.deb * Install package:: @@ -51,7 +51,7 @@ Debian/Ubuntu are upgrading from *LibrePlan 1.0.4* to *LibrePlan 1.1.1* you should download ``upgrade_1.1.0.sql``:: - $ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/upgrade_1.1.0.sql + $ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/upgrade_1.1.0.sql * Upgrade database:: @@ -59,7 +59,7 @@ Debian/Ubuntu * Download ``.war`` file of new version from SourceForge.net:: - $ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1.war + $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1.war * Backup current deployed application:: @@ -87,7 +87,7 @@ openSUSE are upgrading from *LibrePlan 1.0.4* to *LibrePlan 1.1.1* you should download ``upgrade_1.1.0.sql``:: - $ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/upgrade_1.1.0.sql + $ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/upgrade_1.1.0.sql * Upgrade database:: @@ -95,7 +95,7 @@ openSUSE * Download ``.war`` file of new version from SourceForge.net:: - $ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1.war + $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1.war * Backup current deployed application:: diff --git a/doc/src/technical/howto-start-development-with-eclipse.rst b/doc/src/technical/howto-start-development-with-eclipse.rst new file mode 100644 index 000000000..f4f2b6e87 --- /dev/null +++ b/doc/src/technical/howto-start-development-with-eclipse.rst @@ -0,0 +1,196 @@ +How To Start Development With Eclipse +===================================== + +.. sectnum:: + +:Author: Manuel Rego Casasnovas +:Contact: rego@igalia.com +:Date: 16/12/2011 +:Copyright: + Some rights reserved. This document is distributed under the Creative + Commons Attribution-ShareAlike 3.0 licence, available in + http://creativecommons.org/licenses/by-sa/3.0/. +:Abstract: + Quick guide to start the development of LibrePlan_ using Eclipse_ IDE. + As this is the most common way of work among LibrePlan developers team. + +.. contents:: Table of Contents + + +Download LibrePlan source code +------------------------------ + +You need to download LibrePlan_ source code to start hacking on it. You have two +options: + +a) Clone Git repository (recommended):: + + $ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan libreplan + +b) Download last version source code:: + + $ wget http://downloads.sourceforge.net/project/libreplan/files/LibrePlan/libreplan_1.2.0.tar.gz + $ tar -xzvf libreplan_1.2.0.tar.gz + +You should review ``HACKING`` file to check that you have installed all the +requirements. + + +Download Eclipse Java EE +------------------------ + +* Go to download Eclipse page: http://www.eclipse.org/downloads/ + +* Download Eclipse IDE for **Java EE Developers** for your architecture + +.. figure:: img/libreplan-download-eclipse.png + :alt: Eclipse downloads webpage + :width: 100% + + Eclipse downloads webpage + + +Install Ecliplse +---------------- + +* Go to ``/opt/`` (or any other folder when you want to install Eclipse):: + + # cd /opt/ + +* Uncompress downloaded file and set proper permissions:: + + # tar -xzvf ~/Downloads/eclipse-jee-indigo-SR1-linux-gtk-x86_64.tar.gz + # chown -R root:root eclipse/ + +* Add symbolic link to launch Eclipse:: + + # cd /usr/local/bin/ + # ln -s /opt/eclipse/eclipse + + +Install Eclipse Maven plugin (m2e) +---------------------------------- + +* Run Eclipse:: + + $ eclipse + +* Choose your workspace folder (or accept the default one) and mark to don't ask + about it again + +* Go to *Help* > *Install New Software...* + +* Click in option *Add* and set the following values and click *Ok*: + + * Name: m2e + * Location: http://download.eclipse.org/technology/m2e/releases/ + +* Click *Next* to install plugin + +.. figure:: img/libreplan-m2e.png + :alt: Instal Eclipse Maven plugin (m2e) + :width: 100% + + Install Eclipse Maven plugin (m2e) + +* Accept license agreements and click *Finish* + +* Restart Eclipse once plugin installation has finished + + +Import LibrePlan project +------------------------ + +* Go to *File* > *Import* + +* Select as import source *Maven* > *Exising Maven Projects* and click *Next* + +.. figure:: img/libreplan-import-maven.png + :alt: Import LibrePlan as Maven project + :width: 100% + + Import LibrePlan as Maven project + +* Set as *Root Directory* the path where you downloaded LibrePlan source code + +* Then mark all projects and click *Finish* + +.. figure:: img/libreplan-poms.png + :alt: Import LibrePlan from existent path + :width: 100% + + Import LibrePlan from existent path + +* It is recommended to close ``libreplan`` project (right click over the project + and choose *Close*) + + +Configure project to run +------------------------ + +* Go to *Run* > *Run Configurations...* + +* Create a new *Maven Build* called *New_configuration* + +* Change the following values: + + * Name: LibrePlan + * Base directory: Choose ``libreplan-webapp`` folder in your workspace + * Goals: ``jetty:stop jetty:run`` + * Profiles (optional): ``-userguide,-reports`` (to disable userguide and + reports profiles to save compilation time as they are not mandatory to run + LibrePlan) + * Mark the following checkboxes (recommended): + + * Resolve Workspace artifacts + * Update Snapshots + * Skip Tests + +.. figure:: img/libreplan-run-configurations.png + :alt: Configure how to run LibrePlan in Eclipse + :width: 100% + + Configure how to run LibrePlan in Eclipse + +* Click *Run* and application will be available at + http://localhost:8080/libreplan-webapp/ + + +Configure Eclipse to follow coding style guidelines +--------------------------------------------------- + +* Go to *Window* > *Preferences* + +* Look for the different options to use always spaces instead of tabs and use 4 + spaces size for indentation + +.. figure:: img/libreplan-preferences-tab.png + :alt: Eclipse Preferences window + :width: 100% + + Eclipse Preferences window + +* Create new profile to follow the coding style guidelines + +.. figure:: img/libreplan-eclipse-profile.png + :alt: New profile based on Eclipse default one + :width: 100% + + New profile based on Eclipse default one + +* Configure *Save Actions* marking the following options: + + * Perform the selected actions on save + * Format source code + * Format edited lines + * Organize imports + +.. figure:: img/libreplan-preferences-save-actions.png + :alt: Save Actions configuration + :width: 100% + + Save Actions configuration + + +.. _LibrePlan: http://www.libreplan.com/ +.. _Eclipse: http://www.eclipse.org