X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=doc%2Ffiles.texi;fp=doc%2Ffiles.texi;h=369a2e46f48737b483243748a4e521026a61801c;hb=a1c1a4ca100da5c40fe8637b1d460e61a4a8668e;hp=7a9782381980ea25e9783acd145d455fcc8ff7c7;hpb=9c1c557505cc8e35ea0569ad41c9e821ab885262;p=pspp diff --git a/doc/files.texi b/doc/files.texi index 7a97823819..369a2e46f4 100644 --- a/doc/files.texi +++ b/doc/files.texi @@ -684,7 +684,7 @@ Use of @cmd{IMPORT} to read a system file is a @pspp{} extension. SAVE /OUTFILE=@{'@var{file_name}',@var{file_handle}@} /UNSELECTED=@{RETAIN,DELETE@} - /@{COMPRESSED,UNCOMPRESSED@} + /@{UNCOMPRESSED,COMPRESSED,ZCOMPRESSED@} /PERMISSIONS=@{WRITEABLE,READONLY@} /DROP=@var{var_list} /KEEP=@var{var_list} @@ -706,9 +706,32 @@ By default, cases excluded with FILTER are written to the system file. These can be excluded by specifying @subcmd{DELETE} on the @subcmd{UNSELECTED} subcommand. Specifying @subcmd{RETAIN} makes the default explicit. -The @subcmd{COMPRESS} and @subcmd{UNCOMPRESS} subcommand determine whether -the saved system file is compressed. By default, system files are compressed. -This default can be changed with the SET command (@pxref{SET}). +The @subcmd{UNCOMPRESSED}, @subcmd{COMPRESSED}, and +@subcmd{ZCOMPRESSED} subcommand determine the system file's +compression level: + +@table @code +@item UNCOMPRESSED +Data is not compressed. Each numeric value uses 8 bytes of disk +space. Each string value uses one byte per column width, rounded up +to a multiple of 8 bytes. + +@item COMPRESSED +Data is compressed with a simple algorithm. Each integer numeric +value between @minus{}99 and 151, inclusive, or system missing value +uses one byte of disk space. Each 8-byte segment of a string that +consists only of spaces uses 1 byte. Any other numeric value or +8-byte string segment uses 9 bytes of disk space. + +@item ZCOMPRESSED +Data is compressed with the ``deflate'' compression algorithm +specified in RFC@tie{}1951 (the same algorithm used by +@command{gzip}). Files written with this compression level cannot be +read by PSPP 0.8.1 or earlier or by SPSS 20 or earlier. +@end table + +@subcmd{COMPRESSED} is the default compression level. The SET command +(@pxref{SET}) can change this default. The @subcmd{PERMISSIONS} subcommand specifies permissions for the new system file. WRITEABLE, the default, creates the file with read and write @@ -938,7 +961,7 @@ the data is read by a procedure or procedure-like command. @display XSAVE /OUTFILE='@var{file_name}' - /@{COMPRESSED,UNCOMPRESSED@} + /@{UNCOMPRESSED,COMPRESSED,ZCOMPRESSED@} /PERMISSIONS=@{WRITEABLE,READONLY@} /DROP=@var{var_list} /KEEP=@var{var_list}