[Hadoop Wiki] Trivial Update of "Hive/HowToContribute" by ZhengShao

[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 following page has been changed by ZhengShao:
http://wiki.apache.org/hadoop/Hive/HowToContribute

------------------------------------------------------------------------------
  
  This page describes the mechanics of ''how'' to contribute software to Apache Hive.  For ideas about ''what'' you might contribute, please see open tickets in [https://issues.apache.org/jira/browse/HIVE Jira].
  
+ [[TableOfContents(3)]]
+ 
- === Getting the source code ===
+ == Getting the source code ==
  
  First of all, you need the Hive source code.[[BR]]
  
@@ -14, +16 @@

  svn checkout http://svn.apache.org/repos/asf/hadoop/hive/trunk hive-trunk
  }}}
  
- === Setting up Eclipse Development Environment (Optional) ===
+ == Setting up Eclipse Development Environment (Optional) ==
  This is an optional step.  Eclipse has a lot of advanced features for Java development, and it makes the life much easier for Hive developers as well.
  
  [wiki:Hive/GettingStarted/EclipseSetup How to set up Eclipse for Hive development]
  
- === Making Changes ===
+ == Making Changes ==
  
  Before you start, send a message to the [http://hadoop.apache.org/hive/mailing_lists.html#Developers Hive developer mailing list], or file a bug report in [https://issues.apache.org/jira/browse/HIVE Jira].  Describe your proposed changes and check that they fit in with what others are doing and have planned for the project. Be patient, it may take folks a while to understand your requirements.
  
@@ -36, +38 @@

    * Define methods within your class whose names begin with {{{test}}}, and call JUnit's many assert methods to verify conditions; these methods will be executed when you run {{{ant test}}}.
    * You can run all the unit test with the command {{{ant test}}}, or you can run a specific unit test with the command {{{ant -Dtestcase=<class name without package prefix> test}}} (for example {{{ant -Dtestcase=TestFileSystem test}}})
  
- ==== Understanding Ant ====
+ == Understanding Ant ==
  
  Hive is built by Ant, a Java building tool.  
  
   * Good Ant tutorial: http://i-proving.ca/space/Technologies/Ant+Tutorial
  
- === Generating a patch ===
+ == Generating a patch ==
  
- ==== Unit Tests ====
+ === Unit Tests ===
  
  Please make sure that all unit tests succeed before and after applying your patch and that no new javac compiler warnings are introduced by your patch.
  
@@ -66, +68 @@

  }}}
  and examining the HTML report in {{{build/test}}} might be helpful.
  
- ==== Creating a patch ====
+ === Creating a patch ===
  Check to see what files you have modified with:
  {{{
  svn stat
@@ -106, +108 @@

  This way other developers can preview your change by running the script and then applying the patch.
  
  
- ==== Applying a patch ====
+ === Applying a patch ===
  
  To apply a patch either you generated or found from JIRA, you can issue 
  {{{
@@ -119, +121 @@

  
  If you are an Eclipse user, you can apply a patch by : 1. Right click project name in Package Explorer , 2. Team -> Apply Patch 
  
- === Contributing your work ===
+ == Contributing your work ==
  
  Finally, patches should be ''attached'' to an issue report in [http://issues.apache.org/jira/browse/HIVE Jira] via the '''Attach File''' link on the issue's Jira. Please add a comment that asks for a code review following our [:CodeReviewChecklist: code review checklist]. Please note that the attachment should be granted license to ASF for inclusion in ASF works (as per the [http://www.apache.org/licenses/LICENSE-2.0 Apache License] §5).