bugPSPP - Bugs: bug #21379, Documentation for RECODE needs...

 
 

bug #21379: Documentation for RECODE needs attention

Submitted by:  John Darrington <jmd>
Submitted on:  Sun 21 Oct 2007 02:10:12 AM UTC  
 
Category:  Documentation Severity:  5 - Average
Status:  Fixed Assigned to:  John Darrington <jmd>
Open/Closed:  Closed Release:  Before 0.8.0
Effort:  0.00

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

( Jump to the original submission)

Tue 31 Jan 2012 09:39:52 PM UTC, comment #6: 

Thanks.  I corrected this, and checked it in.

John Darrington <jmd>
Project AdministratorIn charge of this item.
Tue 31 Jan 2012 06:29:26 AM UTC, comment #5: 

>I noticed a few suspicious statements about CONVERT.


Just one, in the end.  I had another candidate, but I looked closer and I was wrong about it., so I didn't mention it.

Ben Pfaff <blp>
Project Administrator
Tue 31 Jan 2012 06:16:28 AM UTC, comment #4: 

On a quick skim, this seemed like an improvement.  I suspect that the examples, especially, will be helpful.  Please commit it, as long as you are happy with it.

I noticed a few suspicious statements about CONVERT.  I believe that this starts from a string variable, but the text says "If the source variable is numeric".

Ben Pfaff <blp>
Project Administrator
Mon 30 Jan 2012 12:03:33 PM UTC, comment #3: 

I rewrote this section.

Rather than a patch, I think it's easier to see the entire new section as a whole which I've attached for comment.

(file #24919)

John Darrington <jmd>
Project AdministratorIn charge of this item.
Sat 23 Apr 2011 03:31:46 AM UTC, comment #2: 

John, I'm assigning this one to you.  I don't think that I should try to rewrite this documentation to be clearer, since I originally wrote it and know what I meant.

Ben Pfaff <blp>
Project Administrator
Sun 28 Oct 2007 06:40:49 PM UTC, comment #1: 

>"This is only value...


Should be "This is only valid...".  I checked in the fix.

>There generally seems to be no coherence to the text, which I find
>hard to follow.


A rewrite is welcome.

Ben Pfaff <blp>
Project Administrator
Sun 21 Oct 2007 02:10:12 AM UTC, original submission:  

IMO the manual entry for recode needs a complete rewrite.

Some of the sentences don't make any grammatical sense, for example : "This is only value if the source and target variables are of the same type.", and sentences are which don't seem to have any connection with each other are concatenated into paragraphs.  Paragraph breaks are seemingly arbitrary.

There generally seems to be no coherence to the text, which I find hard to follow.

John Darrington <jmd>
Project AdministratorIn charge of this item.

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files
file #24919:  recode.texi added by jmd (8KiB - application/octet-stream)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by blp (Posted a comment)
  • -email is unavailable- added by jmd (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2012-01-31 jmd StatusIn Progress => Fixed
        Open/ClosedOpen => Closed
    2012-01-30 jmd Attached File- => Added recode.texi, #24919
        StatusNone => In Progress
    2011-05-14 blp ReleaseNone => Before 0.8.0
    2011-04-23 blp Assigned toNone => jmd

    Back to the top


    Powered by Savane 3.5