[Hadoop Wiki] Update of "EclipseEnvironment" by QwertyManiac

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.

The "EclipseEnvironment" page has been changed by QwertyManiac:
http://wiki.apache.org/hadoop/EclipseEnvironment?action=diff&rev1=49&rev2=50

Comment:
Changes based on some contributions by Mark Pollack on HADOOP-7944

  = Working with Hadoop under Eclipse =
  Here are instructions for setting up a development environment for Hadoop under the Eclipse IDE. Please feel free to make additions or modifications to this page.
  
- This document (currently) assumes you already have Eclipse downloaded, installed, and configured to your liking.
+ This document assumes you already have Eclipse downloaded, installed, and configured to your liking. It also assumes that you are aware of the HowToContribute page and have given that a read.
  
  == Quick Start ==
  We will begin by downloading the Hadoop source. The hadoop-common source tree has three subprojects underneath it that you will see after you pull down the source code: hadoop-common, hdfs, and mapreduce.
@@ -13, +13 @@

  {{{
  git clone git://git.apache.org/hadoop-common.git
  }}}
- This will create a hadoop-common folder in your current directory, if you "cd" into that folder you will see the 3 subprojects. Now we will build the code to get it ready for importing into Eclipse.
+ This will create a hadoop-common folder in your current directory, if you "cd" into that folder you will see all the available subprojects. Now we will build the code to get it ready for importing into Eclipse.
  
- From a Hadoop checkout (see HowToContribute) in your Eclipse base directory type (assuming you're in the hadoop-common top level directory)
+ From this directory you just 'cd'-ed into (Which is also known as the top-level directory of a branch or a trunk checkout), perform:
+ {{{
+ $ mvn install -DskipTests
+ $ mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true
+ }}}
  
+ '''Note:''' This may take a while the first time, as all libraries are fetched from the internet, and the whole build is performed.
- {{{
- mvn test -DskipTests
- mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true
- cd ../; cd mapreduce; ant compile eclipse
- }}}
- *Note: If the mapreduce compile fails try to compile just the core "ant compile-core eclipse"
  
- Then in Eclipse
+ == In Eclipse ==
+ 
+ After the above, do the following to finally have projects in Eclipse ready and waiting for you to go on that scratch-itching development spree:
  
  For Common
  
@@ -58, +59 @@

   * Select the hadoop-mapreduce-project project
   * Click "Finish"
  
- Note: in the case of
- 
- MapReducethe
- 
- `testjar`package is broken. This is expected since it is a part of a testcase that checks for incorrect packaging.
+ Note: in the case of MapReduce the `testjar` package is broken. This is expected since it is a part of a testcase that checks for incorrect packaging. This is not to be worried about.
  
  To run tests from Eclipse you need to additionally do the following:
  
   * Under project Properties, select Java Build Path, and the Libraries tab
   * Click "Add External Class Folder" and select the `build` directory of the current project
  
+ == Footnotes ==
+ 
+  * With the new release of the m2e plug-in, this doesn't work anymore as pretty much all targets are not supported by the new 'connector framework' - Yes, it is a giant mess. This means falling back to m2eclipse or just doing the eclipse generation via mvn as mentioned in this page.
+