You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@pig.apache.org by "Charles Ferreira Gonçalves (JIRA)" <ji...@apache.org> on 2010/12/23 14:26:00 UTC

[jira] Created: (PIG-1780) Update the Documentation in PIG site

Update the Documentation in PIG site
------------------------------------

                 Key: PIG-1780
                 URL: https://issues.apache.org/jira/browse/PIG-1780
             Project: Pig
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 0.8.0
            Reporter: Charles Ferreira Gonçalves
            Priority: Minor
             Fix For: site


The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
It desirable that this documentation could fast introduce new users by working out-of-the-box 

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


[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Tuomas Koski (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12996016#comment-12996016 ] 

Tuomas Koski commented on PIG-1780:
-----------------------------------

Yeah, I also tried the ant earlier but it sadly fails as well:

tkoski@desktop:~/pig/pig-0.8.0/tutorial$ ant
Buildfile: build.xml

init:
    [mkdir] Created dir: /home/tkoski/pig/pig-0.8.0/tutorial/build
    [mkdir] Created dir: /home/tkoski/pig/pig-0.8.0/tutorial/build/classes
    [mkdir] Created dir: /home/tkoski/pig/pig-0.8.0/tutorial/build/output
    [mkdir] Created dir: /home/tkoski/pig/pig-0.8.0/tutorial/build/output/pigtmp

compile:
     [echo]  *** Compiling Tutorial files ***
    [javac] Compiling 7 source files to /home/tkoski/pig/pig-0.8.0/tutorial/build/classes
    [javac] /home/tkoski/pig/pig-0.8.0/tutorial/src/org/apache/pig/tutorial/ExtractHour.java:24: cannot find symbol
    [javac] symbol  : class EvalFunc
    [javac] location: package org.apache.pig
    [javac] import org.apache.pig.EvalFunc;
    [javac]                      ^
    
    ...
    (i think this is enough to get the point)

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Tuomas Koski (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12996057#comment-12996057 ] 

Tuomas Koski commented on PIG-1780:
-----------------------------------

Thanks Charles, that did the trick. 

Maybe it would be enough if we would add one more step to explain this. Between the steps 4. and 5. of the chapter http://pig.apache.org/docs/r0.8.0/tutorial.html#Check+Your+Setup.


The other small detail that seems to be wrong is the step 3 in the chapter "Running the Pig Scripts in Local Mode": 3. Review the result files, located in the part-r-00000 directory.

The directory is not called part-r-00000 but it's a file in the script1-local-results.txt -directory.

$ file script1-local-results.txt/part-r-00000 
script1-local-results.txt/part-r-00000: ASCII English text

They are wrong way around?

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] [Resolved] (PIG-1780) Update the Documentation in PIG site

Posted by "Corinne Chandel (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Corinne Chandel resolved PIG-1780.
----------------------------------

    Resolution: Fixed

Fix for Pig-080 included in Pig-1936 patch-1 patch.

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Corinne Chandel
>            Priority: Minor
>             Fix For: 0.8.0
>
>         Attachments: pig-1780.patch
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Charles Ferreira Gonçalves (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12996030#comment-12996030 ] 

Charles Ferreira Gonçalves commented on PIG-1780:
-------------------------------------------------

You have to edit your build.xml

<property name="pigjar" value="../pig.jar" />

to 
<property name="pigjar" value="../pig-0.8.0-core.jar" />


I opened this ticket but in that time I couldn't properly report all the documentations problems.
And sadly, now, I don't remenber all of them.



> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Olga Natkovich (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12995968#comment-12995968 ] 

Olga Natkovich commented on PIG-1780:
-------------------------------------

Corinne, Pig 0.8 documentation need to match what is out in the release. For 0.9 we can choose to change the process and update the docs or leave things as is.

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Updated: (PIG-1780) Update the Documentation in PIG site

Posted by "Corinne Chandel (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Corinne Chandel updated PIG-1780:
---------------------------------

    Attachment: pig-1780.patch

Patch

Apply to Branch-8 only.



> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Corinne Chandel
>            Priority: Minor
>             Fix For: 0.8.0
>
>         Attachments: pig-1780.patch
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

[jira] Assigned: (PIG-1780) Update the Documentation in PIG site

Posted by "Corinne Chandel (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Corinne Chandel reassigned PIG-1780:
------------------------------------

    Assignee: Olga Natkovich  (was: Corinne Chandel)

I'm aware of the doc problem. Olga, how are we going to resolve this?  Thanks/C

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Alan Gates (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12974662#action_12974662 ] 

Alan Gates commented on PIG-1780:
---------------------------------

Charles,

Can you give us details of which examples didn't work and the error messages you got?  That way we can fix them.

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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


[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Tuomas Koski (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12995919#comment-12995919 ] 

Tuomas Koski commented on PIG-1780:
-----------------------------------

1. Go to http://pig.apache.org/docs/r0.8.0/tutorial.html
2. follow the steps until you end up with Step 5 of Check Your Setup: "Unzip the Pig tutorial file (the files are stored in a newly created directory, pigtmp)."

What happens that should not happen:
 * pigtutorial.tar.gz cannot be found

What should happen (or at least what I expect, I might be wrong):
 * pigtutorial.tar.gz can be found and example commands can be executed.



> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Corinne Chandel
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Assigned: (PIG-1780) Update the Documentation in PIG site

Posted by "Alan Gates (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Alan Gates reassigned PIG-1780:
-------------------------------

    Assignee: Corinne Chandel

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Corinne Chandel
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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


[jira] Updated: (PIG-1780) Update the Documentation in PIG site

Posted by "Olga Natkovich (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Olga Natkovich updated PIG-1780:
--------------------------------

    Fix Version/s:     (was: site)
                   0.8.0
         Assignee: Corinne Chandel  (was: Olga Natkovich)

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Corinne Chandel
>            Priority: Minor
>             Fix For: 0.8.0
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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

       

[jira] Commented: (PIG-1780) Update the Documentation in PIG site

Posted by "Corinne Chandel (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/PIG-1780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12995964#comment-12995964 ] 

Corinne Chandel commented on PIG-1780:
--------------------------------------

As a workaround, you can create a tar file by running the "ant" command from the tutorial directory.

> Update the Documentation in PIG site
> ------------------------------------
>
>                 Key: PIG-1780
>                 URL: https://issues.apache.org/jira/browse/PIG-1780
>             Project: Pig
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.8.0
>            Reporter: Charles Ferreira Gonçalves
>            Assignee: Olga Natkovich
>            Priority: Minor
>             Fix For: site
>
>
> The Tutorial, Setup and others documentation in the pig site has directives that didn't work and are outdated.
> It desirable that this documentation could fast introduce new users by working out-of-the-box 

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