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).
