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

 
 

bug #21379: Documentation for RECODE needs attention

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

Add a New Comment Rich Markup
   

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

 

(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)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    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.13-758e.
    Corresponding source code