X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=doc%2Fdata-file-format.texi;h=2186b6d411089552ca91d281d9f9388df43854a1;hb=a89f1b18969c1c9603fc67aee3055585af9d167c;hp=2973b6b5e71e583f780886c9964a6d1b9ccd772c;hpb=6bd42bf54c1e87d6e85d9fa6714f5e7e44a35916;p=pspp diff --git a/doc/data-file-format.texi b/doc/data-file-format.texi index 2973b6b5e7..2186b6d411 100644 --- a/doc/data-file-format.texi +++ b/doc/data-file-format.texi @@ -135,7 +135,7 @@ format and using 24-hour time. If the time is not available then this field is arbitrarily set to @samp{00:00:00}. @item char file_label[64]; -Set the the file label declared by the user, if any (@pxref{FILE LABEL}). +Set the file label declared by the user, if any (@pxref{FILE LABEL}). Padded on the right with spaces. @item char padding[3]; @@ -201,7 +201,7 @@ Write format for this variable. See below. @item char name[8]; Variable name. The variable name must begin with a capital letter or -the at-sign (@samp{@@}). Subsequent characters may also be octothorpes +the at-sign (@samp{@@}). Subsequent characters may also be digits, octothorpes (@samp{#}), dollar signs (@samp{$}), underscores (@samp{_}), or full stops (@samp{.}). The variable name is padded on the right with spaces. @@ -369,7 +369,9 @@ label record are to be applied. @item int32 vars[/* variable length */]; A list of variables to which to apply the value labels. There are -@code{count} elements. +@code{count} elements. Each element identifies a variable record, where +the first element is numbered 1 and long string variables are considered +to occupy multiple indexes. @end table @node Document Record, Machine int32 Info Record, Value Label Variable Record, Data File Format @@ -470,6 +472,7 @@ Machine endianness. 1 indicates big-endian, 2 indicates little-endian. @item int32 character_code; Character code. 1 indicates EBCDIC, 2 indicates 7-bit ASCII, 3 indicates 8-bit ASCII, 4 indicates DEC Kanji. +Windows code page numbers are also valid. @end table @node Machine flt64 Info Record, Auxiliary Variable Parameter Record, Machine int32 Info Record, Data File Format @@ -503,7 +506,7 @@ Record type. Always set to 7. Record subtype. Always set to 4. @item int32 size; -Size of each piece of data in the data part, in bytes. Always set to 4. +Size of each piece of data in the data part, in bytes. Always set to 8. @item int32 count; Number of pieces of data in the data part. Always set to 3. @@ -554,7 +557,9 @@ The total number of records in @code{aux_params}, multiplied by 3. @item 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: +to the order of the variables in the Variable Records. No element +corresponds to variable records that continue long string variables. +The @code{struct aux_params} type is defined as follows: @example struct aux_params @@ -705,8 +710,9 @@ The total length is @code{count} bytes. Miscellaneous informational records must follow the variable records and precede the dictionary termination record. -Miscellaneous informational records are ignored by PSPP when reading -system files. They are not written by PSPP when writing system files. +Some specific types of miscellaneous informational records are +documented here, but others are known to exist. PSPP ignores unknown +miscellaneous informational records when reading system files. @example struct sysfile_misc_info