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: DocumentationSeverity: 5 - Average
Status: FixedAssigned to: John Darrington <jmd>
Open/Closed: ClosedRelease: 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 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 File(s):
   
   
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
  • -unavailable- added by blp (Posted a comment)
  • -unavailable- added by jmd (Submitted the item)
  •  

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

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 6 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Tue 31 Jan 2012 09:39:52 PM UTCjmdStatusIn Progress=>Fixed
      Open/ClosedOpen=>Closed
    Mon 30 Jan 2012 12:03:33 PM UTCjmdAttached File-=>Added recode.texi, #24919
      StatusNone=>In Progress
    Sat 14 May 2011 04:49:23 AM UTCblpReleaseNone=>Before 0.8.0
    Sat 23 Apr 2011 03:31:46 AM UTCblpAssigned toNone=>jmd

    Back to the top


    Powered by Savane 3.1-cleanup1