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

Emil Ibrishimov commented on HIVE-691:
--------------------------------------

The reasen I put _FUNC_ instead of directly using the name of the function is 
that for classes that implement several functions, we can get situations like:
{noformat} 
DESCRIBE FUNCTION &&;
a AND b - Logical and
{noformat} 
Such description is a little bit confusing because you ask for one function and 
it outputs another so I decided to use _FUNC_ and replace it with the actual 
function name that was used to call describe. 
Maybe we can replace _FUNC_ by _FUNC_NAME_ ?


> 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