[ 
https://issues.apache.org/jira/browse/PIG-1182?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12798128#action_12798128
 ] 

David Ciemiewicz commented on PIG-1182:
---------------------------------------

Corinne, I made no changes.

I'm pointing out that it is an omission to not have the comment syntax 
documented in the reference manual.

Reference manuals for programming languages SHOULD ALWAYS have information on 
ALL syntax including comment syntax.

Once you are done with learning things in the User's Guide, most of the time 
programmer's just go back to the Reference Manual for quick look up of 
information and syntax.

So the documentation on comment syntax should be in BOTH the User's Guide AND 
the Reference Manual.



> Pig reference manual does not mention syntax for comments
> ---------------------------------------------------------
>
>                 Key: PIG-1182
>                 URL: https://issues.apache.org/jira/browse/PIG-1182
>             Project: Pig
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: David Ciemiewicz
>            Assignee: Corinne Chandel
>             Fix For: 0.7.0
>
>
> The Pig 0.5.0 reference manual does not mention how to write comments in your 
> pig code using -- (two dashes).
> http://hadoop.apache.org/pig/docs/r0.5.0/piglatin_reference.html
> Also, does /* */ also work?

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