X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Ftransformation.texi;h=03d697913676b280c0c9d676454e4a7797512835;hb=eb182278adbaa6f7dd9cdeaf18b26c2885b32f41;hp=63f85e9ee929bc517bd254ac1898077159aff3f8;hpb=f60b01a710b3b3b478c8c7a999bf30de3347b9e1;p=pspp diff --git a/doc/transformation.texi b/doc/transformation.texi index 63f85e9ee9..03d6979136 100644 --- a/doc/transformation.texi +++ b/doc/transformation.texi @@ -1,3 +1,12 @@ +@c PSPP - a program for statistical analysis. +@c Copyright (C) 2017 Free Software Foundation, Inc. +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.3 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". +@c @node Data Manipulation @chapter Data transformations @cindex transformations @@ -528,11 +537,9 @@ If the source variables are string variables then @var{src_value} may be a literal string (like all strings, enclosed in single or double quotes). @item @var{num1} THRU @var{num2} This form is valid only when the source variables are numeric. -It specifies all values in the range [@var{num1}, @var{num2}]. -Normally you would ensure that @var{num2} is greater than or equal to -@var{num1}. -If @var{num1} however is greater than @var{num2}, then the range -[@var{num2},@var{num1}] will be used instead. +It specifies all values in the range between @var{num1} and @var{num2}, +including both endpoints of the range. By convention, @var{num1} +should be less than @var{num2}. Open-ended ranges may be specified using @samp{LO} or @samp{LOWEST} for @var{num1} or @samp{HI} or @samp{HIGHEST} for @var{num2}. @@ -581,13 +588,17 @@ The behaviour of the command is slightly different depending on whether it appears or not. If @samp{INTO @var{dest_vars}} does not appear, then values will be recoded -``in place´´. This means that the recoded values are written back to the +``in place''. +This means that the recoded values are written back to the source variables from whence the original values came. In this case, the @var{dest_value} for every mapping must imply a value which has the same type as the @var{src_value}. For example, if the source value is a string value, it is not permissible for @var{dest_value} to be @samp{SYSMIS} or another forms which implies a numeric result. +It is also not permissible for @var{dest_value} to be longer than the width +of the source variable. + The following example two numeric variables @var{x} and @var{y} are recoded in place. Zero is recoded to 99, the values 1 to 10 inclusive are unchanged, @@ -670,7 +681,7 @@ recode @end example @noindent Here we have two recodings. The first affects the source variable @var{a} and recodes in-place the value 2 into 22 and all other values to 99. -The second recoding copies the values of @var{b} into the the variable @var{z}, +The second recoding copies the values of @var{b} into the variable @var{z}, changing any instances of 1 into 3. @node SORT CASES