work on docs

diff --git a/doc/language.texi b/doc/language.texi
index 0bab21289791056153577106549a3bf6b57aef21..1c9a4f0105245a5550f7ad71f577be5db2be0c53 100644 (file)
--- a/doc/language.texi
+++ b/doc/language.texi
@@ -509,7 +509,32 @@ Similar to print format, but used by the @cmd{WRITE} command
 
 @cindex measurement level
 @item Measurement level
-Nominal, ordinal, or scale.
+One of the following:
+
+@table @asis
+@item Nominal
+Each value of a nominal variable represents a distinct category.  The
+possible categories are finite and often have value labels.  The order
+of categories is not significant.  Political parties, US states, and
+yes/no choices are nominal.  Numeric and string variables can be
+nominal.
+
+@item Ordinal
+Ordinal variables also represent distinct categories, but their values
+are arranged according to some natural order.  Likert scales, e.g.@:
+from strongly disagree to strongly agree, are ordinal.  Data grouped
+into ranges, e.g.@: age groups or income groups, are ordinal.  Both
+numeric and string variables can be ordinal.  String values are
+ordered alphabetically, so letter grades from A to F will work as
+expected, but @code{poor}, @code{satisfactory}, @code{excellent} will
+not.
+
+@item Scale
+Scale variables are ones for which differences and ratios are
+meaningful.  These are often values which have a natural unit
+attached, such as age in years, income in dollars, or distance in
+miles.  Only numeric variables are scalar.
+@end table
 
 @cindex custom attributes
 @item Custom attributes

diff --git a/doc/variables.texi b/doc/variables.texi
index 54ae51a687a667b87dd224d2208a17d48bebcb85..ab6f83daea2d91c815ebc42e5edd106dafd827d1 100644 (file)
--- a/doc/variables.texi
+++ b/doc/variables.texi
@@ -600,17 +600,12 @@ purposes.   It does not affect the display of variables in the @pspp{} output.
 @section VARIABLE LEVEL
 @vindex VARIABLE LEVEL
 @display
-VARIABLE LEVEL
-        @var{var_list} ( SCALE | NOMINAL | ORDINAL )
-        [ /@var{var_list} ( SCALE | NOMINAL | ORDINAL ) ]
-        .
-        .
-        .
-        [ /@var{var_list} ( SCALE | NOMINAL | ORDINAL ) ]
+@t{VARIABLE LEVEL} @i{variables} @t{(}@{@t{SCALE} @math{|} @t{NOMINAL} @math{|} @t{ORDINAL}@}@t{)}@dots{}
 @end display
 
-@cmd{VARIABLE LEVEL} sets the measurement level of variables.
-@xref{Attributes}.
+@cmd{VARIABLE LEVEL} sets the measurement level of @var{variables} as
+specified.  @xref{Attributes}, for the definitions of the available
+measurement levels.
 
 @node VARIABLE ROLE
 @section VARIABLE ROLE