[Pspp-cvs] Changes to pspp/doc/data-file-format.texi

[John Darrington]

Index: pspp/doc/data-file-format.texi
diff -u pspp/doc/data-file-format.texi:1.1 pspp/doc/data-file-format.texi:1.2
--- pspp/doc/data-file-format.texi:1.1  Sat Oct 30 10:14:05 2004
+++ pspp/doc/data-file-format.texi      Wed Apr 13 10:09:59 2005
@@ -43,6 +43,8 @@
 * Document Record::             
 * Machine int32 Info Record::   
 * Machine flt64 Info Record::   
+* Auxilliary Variable Parameter Record::
+* Long Variable Names Record::
 * Miscellaneous Informational Records::  
 * Dictionary Termination Record::  
 * Data Record::                 
@@ -467,7 +469,7 @@
 indicates 8-bit ASCII, 4 indicates DEC Kanji.
 @end table
 
address@hidden Machine flt64 Info Record, Miscellaneous Informational Records, 
Machine int32 Info Record, Data File Format
address@hidden Machine flt64 Info Record, Auxilliary Variable Parameter Record, 
Machine int32 Info Record, Data File Format
 @section Machine @code{flt64} Info Record
 
 There must be no more than one machine @code{flt64} info record per
@@ -513,7 +515,136 @@
 The value used for LOWEST in missing values.
 @end table
 
address@hidden Miscellaneous Informational Records, Dictionary Termination 
Record, Machine flt64 Info Record, Data File Format
address@hidden Auxilliary Variable Parameter Record, Long Variable Names 
Record, Machine flt64 Info Record, Data File Format
address@hidden Auxilliary Variable Parameter Record
+
+There must be no more than one auxilliary variable parameter record per
+system file.  This  record must follow the variable
+records and precede the dictionary termination record.
+
address@hidden
+struct sysfile_aux_var_parameter
+  @{
+    /* Header. */
+    int32               rec_type;
+    int32               subtype;
+    int32               size;
+    int32               count;
+
+    /* Data. */
+    struct aux_params   aux_params[/* variable length */];
+  @};
address@hidden example
+
address@hidden @code
address@hidden int32 rec_type;
+Record type.  Always set to 7.
+
address@hidden int32 subtype;
+Record subtype.  Always set to 11.
+
address@hidden int32 size;
+The size  @code{int32}. Always set to 4.
+
address@hidden int32 count;
+The total number of bytes in @code{aux_params} divided by 3.
+
address@hidden struct aux_params aux_params[];
+An array of @code{struct aux_params}.   The order of the elements corresponds 
+to the order of the variables in the Variable Records.  The @code{struct 
aux_params} type is defined as follows:
+
address@hidden
+struct aux_params
+  @{
+    int32 measure;
+    int32 width;
+    int32 alignment;
+  @};
address@hidden example
+
address@hidden @code
address@hidden int32 measure
+The measurement type of the variable:  
address@hidden @asis
address@hidden 0
+Nominal Scale
address@hidden 1
+Ordinal Scale
address@hidden 2
+Continuous Scale
address@hidden table
+
address@hidden int32 width
+The width of the display column for the variable in characters.
+
address@hidden int32 alignment 
+The alignment of the variable for display purposes:
+
address@hidden @asis
address@hidden 0
+Left aligned
address@hidden 1
+Right aligned
address@hidden 2
+Centre aligned
address@hidden table
+
address@hidden table
+
+
+
address@hidden table
+
+
+
address@hidden Long Variable Names Record, Miscellaneous Informational Records, 
Auxilliary Variable Parameter Record,  Data File Format
address@hidden Long Variable Names Record
+
+There must be no more than one long variable names record per
+system file.  This  record must follow the variable
+records and precede the dictionary termination record.
+
address@hidden
+struct sysfile_long_variable_names
+  @{
+    /* Header. */
+    int32               rec_type;
+    int32               subtype;
+    int32               size;
+    int32               count;
+
+    /* Data. */
+    char                var_name_pairs[/* variable length */];
+  @};
address@hidden example
+
address@hidden @code
address@hidden int32 rec_type;
+Record type.  Always set to 7.
+
address@hidden int32 subtype;
+Record subtype.  Always set to 13.
+
address@hidden int32 size;
+The size of each element in the @code{var_name_pairs} member. Always set to 1.
+
address@hidden int32 count;
+The total number of bytes in @code{var_name_pairs}.
+
address@hidden char var_name_pairs[/* variable length];
+A list of @address@hidden tuples, where @var{key} is the name
+of a variable, and @var{value} is its long variable name. 
+The @var{key} field is at most 8 bytes long and must match the
+name of a variable which appears in the variable record @xref{Variable Record}.
+The @var{value} field is at most 64 bytes long.
+The @var{key} and @var{value} fields are separated by a @samp{=} byte.
+Each tuple is separated by a byte whose value is 09.  There is no
+trailing separator following the last tuple.
+The total length is @code{count} bytes.
address@hidden table
+
+
address@hidden Miscellaneous Informational Records, Dictionary Termination 
Record, Long Variable Names Record, Data File Format
 @section Miscellaneous Informational Records
 
 Miscellaneous informational records must follow the variable records and