X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fvariables.texi;h=1436158ec83b7dc9c3136ad297fe127974580aa8;hb=4a157bd7b6b04607965dd36d24b1f29d844ddee4;hp=17ddb52f6c1f66c6514be9f30644d07bd9e54de5;hpb=1fc3af93c0ba6cbaf7ef09edc979096b6f16dd6f;p=pspp-builds.git diff --git a/doc/variables.texi b/doc/variables.texi index 17ddb52f..1436158e 100644 --- a/doc/variables.texi +++ b/doc/variables.texi @@ -6,6 +6,7 @@ several utility functions for examining and adjusting them. @menu * ADD VALUE LABELS:: Add value labels to variables. +* DELETE VARIABLES:: Delete variables. * DISPLAY:: Display variable names & descriptions. * DISPLAY VECTORS:: Display a list of vectors. * FORMATS:: Set print and write formats. @@ -18,11 +19,14 @@ several utility functions for examining and adjusting them. * VALUE LABELS:: Set value labels for variables. * STRING:: Create new string variables. * VARIABLE LABELS:: Set variable labels for variables. +* VARIABLE ALIGNMENT:: Set the alignment for display. +* VARIABLE WIDTH:: Set the display width. +* VARIABLE LEVEL:: Set the measurement level. * VECTOR:: Declare an array of variables. * WRITE FORMATS:: Set variable write formats. @end menu -@node ADD VALUE LABELS, DISPLAY, Variable Attributes, Variable Attributes +@node ADD VALUE LABELS, DELETE VARIABLES, Variable Attributes, Variable Attributes @section ADD VALUE LABELS @vindex ADD VALUE LABELS @@ -35,7 +39,24 @@ ADD VALUE LABELS LABELS} (@pxref{VALUE LABELS}), but it does not clear value labels from the variables before adding the ones specified. -@node DISPLAY, DISPLAY VECTORS, ADD VALUE LABELS, Variable Attributes +@node DELETE VARIABLES, DISPLAY, ADD VALUE LABELS, Variable Attributes +@section DELETE VARIABLES +@vindex DELETE VARIABLES + +@display +DELETE VARIABLES var_list. +@end display + +@cmd{DELETE VARIABLES} deletes the specified variables from the +dictionary. It may not be used to delete all variables from the +dictionary; use @cmd{NEW FILE} to do that (@pxref{NEW FILE}). + +@cmd{DELETE VARIABLES} should not used after defining transformations +and before executing a procedure. If it is used in such a context, it +causes the data to be read. If it is used while @cmd{TEMPORARY} is in +effect, it causes the temporary transformations to become permanent. + +@node DISPLAY, DISPLAY VECTORS, DELETE VARIABLES, Variable Attributes @section DISPLAY @vindex DISPLAY @@ -97,8 +118,8 @@ FORMATS var_list (fmt_spec). @end display @cmd{FORMATS} set both print and write formats for the specified -variables to the specified format specification. @xref{Input/Output -Formats}. +numeric variables to the specified format specification. +@xref{Input and Output Formats}. Specify a list of variables followed by a format specification in parentheses. The print and write formats of the specified variables @@ -253,7 +274,7 @@ setting their output formats. Specify a slash (@samp{/}), followed by the names of the new numeric variables. If you wish to set their output formats, follow their names -by an output format specification in parentheses (@pxref{Input/Output +by an output format specification in parentheses (@pxref{Input and Output Formats}); otherwise, the default is F8.2. Variables created with @cmd{NUMERIC} are initialized to the @@ -268,7 +289,7 @@ PRINT FORMATS var_list (fmt_spec). @end display @cmd{PRINT FORMATS} sets the print formats for the specified -variables to the specified format specification. +numeric variables to the specified format specification. Its syntax is identical to that of @cmd{FORMATS} (@pxref{FORMATS}), but @cmd{PRINT FORMATS} sets only print formats, not write formats. @@ -330,60 +351,129 @@ transformations. Specify a slash (@samp{/}), followed by the names of the string variables to create and the desired output format specification in -parentheses (@pxref{Input/Output Formats}). Variable widths are +parentheses (@pxref{Input and Output Formats}). Variable widths are implicitly derived from the specified output formats. Created variables are initialized to spaces. -@node VARIABLE LABELS, VECTOR, STRING, Variable Attributes + +@node VARIABLE LABELS, VARIABLE ALIGNMENT, STRING, Variable Attributes @section VARIABLE LABELS @vindex VARIABLE LABELS @display VARIABLE LABELS - /var_list 'var_label'. + var_list 'var_label' + [ /var_list 'var_label'] + . + . + . + [ /var_list 'var_label'] @end display @cmd{VARIABLE LABELS} associates explanatory names with variables. This name, called a @dfn{variable label}, is displayed by statistical procedures. -To assign a variable label to a group of variables, specify a slash -(@samp{/}), followed by the list of variable names and the variable -label as a string. +To assign a variable label to a group of variables, specify a +list of variable names and the variable label as a string. +To assign different labels to different variables in the same command, +preceed the subsequent variable list with a slash (@samp{/}). + + +@node VARIABLE ALIGNMENT, VARIABLE WIDTH, VARIABLE LABELS, Variable Attributes +@comment node-name, next, previous, u +@section VARIABLE ALIGNMENT +@vindex VARIABLE ALIGNMENT + +@display +VARIABLE ALIGNMENT + var_list ( LEFT | RIGHT | CENTER ) + [ /var_list ( LEFT | RIGHT | CENTER ) ] + . + . + . + [ /var_list ( LEFT | RIGHT | CENTER ) ] +@end display + +@cmd{VARIABLE ALIGNMENT} sets the alignment of variables for display editing +purposes. This only has effect for third party software. It does not affect +the display of variables in the PSPP output. + -@node VECTOR, WRITE FORMATS, VARIABLE LABELS, Variable Attributes + + +@node VARIABLE WIDTH, VARIABLE LEVEL, VARIABLE ALIGNMENT, Variable Attributes +@comment node-name, next, previous, up +@section VARIABLE WIDTH +@vindex VARIABLE WIDTH +@display +VARIABLE WIDTH + var_list (width) + [ /var_list (width) ] + . + . + . + [ /var_list (width) ] +@end display + +@cmd{VARIABLE WIDTH} sets the column width of variables for display editing +purposes. This only affects third party software. It does not affect +the display of variables in the PSPP output. + + +@node VARIABLE LEVEL, VECTOR, VARIABLE WIDTH, Variable Attributes +@comment node-name, next, previous, up +@section VARIABLE LEVEL +@vindex VARIABLE LEVEL +@display +VARIABLE LEVEL + var_list ( SCALE | NOMINAL | ORDINAL ) + [ /var_list ( SCALE | NOMINAL | ORDINAL ) ] + . + . + . + [ /var_list ( SCALE | NOMINAL | ORDINAL ) ] +@end display + +@cmd{VARIABLE LEVEL} sets the measurement level of variables. +Currently, this has no effect except for certain third party software. + + +@node VECTOR, WRITE FORMATS, VARIABLE LEVEL, Variable Attributes @section VECTOR @vindex VECTOR @display Two possible syntaxes: VECTOR vec_name=var_list. - VECTOR vec_name_list(count). + VECTOR vec_name_list(count [format]). @end display @cmd{VECTOR} allows a group of variables to be accessed as if they were consecutive members of an array with a vector(index) notation. -To make a vector out of a set of existing variables, specify a name for -the vector followed by an equals sign (@samp{=}) and the variables that -belong in the vector. +To make a vector out of a set of existing variables, specify a name +for the vector followed by an equals sign (@samp{=}) and the variables +to put in the vector. All the variables in the vector must be the same +type. String variables in a vector must all have the same width. To make a vector and create variables at the same time, specify one or more vector names followed by a count in parentheses. This will cause variables named @code{@var{vec}1} through @code{@var{vec}@var{count}} -to be created as numeric variables with print and write format F8.2. -Variable names including numeric suffixes may not exceed 8 characters -in length, and none of the variables may exist prior to @cmd{VECTOR}. - -All the variables in a vector must be the same type. +to be created as numeric variables. By default, the new variables +have print and write format F8.2, but an alternate format may be +specified inside the parentheses before or after the count and +separated from it by white space or a comma. Variable names including +numeric suffixes may not exceed 64 characters in length, and none of +the variables may exist prior to @cmd{VECTOR}. Vectors created with @cmd{VECTOR} disappear after any procedure or procedure-like command is executed. The variables contained in the vectors remain, unless they are scratch variables (@pxref{Scratch Variables}). -Variables within a vector may be references in expressions using +Variables within a vector may be referenced in expressions using @code{vector(index)} syntax. @node WRITE FORMATS, , VECTOR, Variable Attributes @@ -394,7 +484,8 @@ Variables within a vector may be references in expressions using WRITE FORMATS var_list (fmt_spec). @end display -@cmd{WRITE FORMATS} sets the write formats for the specified variables +@cmd{WRITE FORMATS} sets the write formats for the specified numeric +variables to the specified format specification. Its syntax is identical to that of FORMATS (@pxref{FORMATS}), but @cmd{WRITE FORMATS} sets only write formats, not print formats.