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

Raghotham Murthy commented on HIVE-691:
---------------------------------------

I meant adding the name of the function to the annotation. Something like this:

{code}

@description(
    name = "&&,AND",
    value = "a _FUNC_ b - Logical and",
    extended = "Example:\n" +
        "  > SELECT * FROM srcpart WHERE src.hr=12 _FUNC_ " +
        "src.hr='2008-04-08' LIMIT 1;\n" +
        "  27      val_27  2008-04-08      12"
)
{code}

If there's more than one name, you can return a comma separated list of names 
and that wont be confusing. If there is a name in the annotation, we can just 
extract the names associated with each UDF class and register that class with 
all of its associated names. Does that make sense?

> show documentation for user defined functions
> ---------------------------------------------
>
>                 Key: HIVE-691
>                 URL: https://issues.apache.org/jira/browse/HIVE-691
>             Project: Hadoop Hive
>          Issue Type: Improvement
>          Components: Query Processor
>            Reporter: Prasad Chakka
>            Assignee: Emil Ibrishimov
>             Fix For: 0.4.0
>
>         Attachments: HIVE-691.1.patch
>
>
> There are lot of functions and more of them will be added. I think it is 
> cumbersome to update wiki or ask users to go to wiki to find out 
> documentation. instead each user defined function can have an annotation 
> containing documentation and 'show functions' command or similar can show the 
> documentation to users on command line. it will also be easier to update the 
> documentation along with code.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to