Mailing-List: contact dev-help@hive.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@hive.apache.org
Date: Wed, 30 Mar 2011 17:06:05 +0000 (UTC)
From: "Patrick Angeles (JIRA)" <jira@apache.org>
To: hive-dev@hadoop.apache.org
Message-ID: 
 <1145325859.21684.1301504765755.JavaMail.tomcat@hel.zones.apache.org>
In-Reply-To: 
 <547994760.20998.1301477525760.JavaMail.tomcat@hel.zones.apache.org>
Subject: [jira] [Commented] (HIVE-2085) Document GenericUD(A|T)F
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/HIVE-2085?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13013545#comment-13013545 ] 

Patrick Angeles commented on HIVE-2085:
---------------------------------------

FWIW, +1 on better documentation, particularly on extension points like UD*Fs, SerDes and StorageHandlers. These are things that are worth taking on up front because it increases user engagement and adoption and reduces the burden of support/education on core committers in the long term.

> Document GenericUD(A|T)F
> ------------------------
>
>                 Key: HIVE-2085
>                 URL: https://issues.apache.org/jira/browse/HIVE-2085
>             Project: Hive
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Lars Francke
>            Priority: Minor
>
> GenericUDFs are very poorly documented, this includes everything they relate to:
>   * ObjectInspector (JavaDoc not really helpful for someone not familiar with Hive)
>   * ObjectInspectorFactory
>   * ObjectInspectorConverters
>   * ...
> An example would help as well as a unit test for one of the built in GenericUDFs. Writing a normal UDF is pretty well documented but GenericUDFs (and UDTF/UDAF) require more knowledge about the inner workings of Hive and that could be documented better.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira