dataset: Before deleting variables, make sure new values are added.
[pspp.git] / NEWS
blob79c0f000bf738fbaccdb01ba435bc655e9b990b1
1 PSPP NEWS -- history of user-visible changes.
2 Copyright (C) 1996-2000, 2008-2016, 2017, 2019, 2020, 2021,
3           2022  Free Software Foundation, Inc.
4 See the end for copying conditions.
6 Please send PSPP bug reports to bug-gnu-pspp@gnu.org.
8 Changes after 1.6.2:
10  * The CTABLES command is now implemented.
12  * FREQUENCIES now honors the LAYERED setting on SPLIT FILE.
14  * AGGREGATE:
16    - New aggregation functions CGT, CLT, CIN, and COUT.
18    - Break variables are now optional.
20  * DISPLAY MACROS is now implemented.
22  * Removed the MODIFY VARS command, which is not in SPSS.
24  * Building from a Git repository, which previously required GIMP, now
25    requires rsvg-convert from librsvg2 instead.
27  * The pspp-dump-sav program is no longer installed by default.
29 Changes from 1.6.1 to 1.6.2:
31  * Previously, numeric variables defaulted to "scale" measurement
32    level.  Now, the default is "unknown", with a better guess chosen
33    based on heuristics the first time the data is read.
35  * Bug fixes.
37 Changes from 1.6.0 to 1.6.1:
39  * The SET command now supports LEADZERO for controlling output of a
40    leading zero in F, COMMA, and DOT format.
42  * Bug fixes and translation updates.
44 Changes from 1.4.1 to 1.6.0:
46  * In the Kruskal-Wallis test, a misleading result could occur
47    if the lower bound specified by the user was in fact higher
48    than the upper bound specified.  This has been fixed.
50  * The DEFINE, MATRIX, MCONVERT, and MATRIX DATA commands are now
51    implemented.
53  * An error in the displayed signficance of oneway anova
54    contrasts tests has been corrected.
56  * Added Drag-N-Drop in output view.
58  * The Explore GUI dialog supports the "Plots" subdialog. Boxplots, Q-Q Plots
59    and Spreadlevel plots are now also available via the GUI.
61  * The graphical user interface for importing spreadsheets has been improved.
62    The new interface provides the user with a preview of the data to be imported
63    and interactive methods to select the desired ranges.
65  * The user manual, in its Info and HTML versions, now includes
66    graphical output examples and screenshots.
68  * New command SHOW SYSTEM to easily print system information useful
69    in bug reports.
71  * Build changes:
73    - Perl is no longer required to build.
75    - Build now requires Python 3.4 or later.  (Building PSPP 1.4.0
76      also required Python, but it wasn't properly documented at the
77      time.)
79    - The Cairo and Pango libraries are now required.
81    - gettext 0.20 or later is now required.
83    - gtksourceview 4.x is now supported (3.x also remains supported).
85  * Output improvements:
87    - New drivers for output to TeX source files and to PNG files.
89    - Table output styles may now be set with the new option
90      --table-look and the new SET TLOOK command.
92    - New driver option "trim" to remove empty space from PDF,
93      PostScript, SVG, and PNG output files.
95    - The PDF output driver now adds an outline to allow PDF viewers to display
96      as a "table of contents" for the file.
98    - The HTML output driver has a new option "bare".
100  * New features in pspp-output:
102    - New --table-look and --nth-commands options.
104    - New get-table-look and convert-table-look commands.
106 Changes from 1.4.0 to 1.4.1:
108  * Bug fixes.
110  * Translation updates.
112  * HTML output is now HTML5 instead of HTML4.0 Transitional.
114  * The HOST command has been reimplemented.  It now supports TIMELIMIT.
116 Changes from 1.2.0 to 1.4.0:
118  * The file pspp-mode.el (the pspp-mode for Emacs) is no longer distributed
119    with PSPP.  Instead, it can be installed directly in emacs and is available
120    from https://elpa.gnu.org/packages/pspp-mode.html
122  * The Find dialog box, when searching for numeric values, will match only
123    to the precision of the variable's print format.  This avoids behaviour
124    which is surprising to some users.
126  * PSPP now supports the SPSS viewer (.spv) format that SPSS 16 and later
127    use to save the contents of its output editor:
129    - PSPP and PSPPIRE can write output to .spv files.
131    - The new utility pspp-output can convert .spv files to other formats.
133    - The pspp-convert utility can now decrypt encrypted .spv files.  The
134      encrypted viewer file format is unacceptably insecure, so to
135      discourage its use PSPP and PSPPIRE do not directly read or write
136      this format.
138  * A bug where the Data|Select Cases|Random Sample menu would generate
139    invalid syntax has been fixed.
141  * FREQUENCIES will emit a warning if one or more weight values are missing.
143  * Plain text output is no longer divided into pages, since it is now
144    rarely printed on paper.
146  * pspp-convert improvements:
148    - New "-a", "-l", "--password-list" options to search for an
149      encrypted file's password.
151    - New "--keep" and "--drop" options to output only selected variables.
153    - New "--recode", "--no-var-name", "--labels", "--print-formats",
154      "--decimal", "--delimiter", and "--qualifier" options to control
155      CSV output.
157  * Improvements to SAVE DATA COLLECTION support for MDD files.
159  * Bug fix for CVE-2018-20230.
161  * The /RENAME subcommand in SAVE TRANSLATE et al. has been extended
162    to support the syntax also accepted by other software.
164  * The EXAMINE command will now perform the Shapiro-Wilk test when
165    one or more plots are requested.
167  * The REGRESSION command now supports the /STATISTICS=TOL option which
168    outputs tolerance and variance inflation factor metrics for the data.
170  * The QUICK CLUSTER command now supports the /SAVE option which can
171    be used to save the cases' cluster membership and/or their distance
172    from the cluster centre to the active file.
174  * The MEANS command has been re-implemented.
176  * The GUI now has a sub-dialog for post-hoc tests of the oneway
177    anova test.
179  * Gtk+3.22.0 or later must now be used when building.
181  * GRAPH: Categorical barcharts displaying percentages now show the
182    sub-category as a percentage of the primary category instead of the
183    total.
185  * The Syntax Window now has a Find function to perform simple text
186    searching.
188  * AUTORECODE:
190    - The PRINT subcommand is now implemented.
192    - Many bug fixes.
194 Changes from 1.0.1 to 1.2.0:
196  * New experimental command SAVE DATA COLLECTION to save MDD files.
198  * MTIME and YMDHMS variable formats now supported.
200  * Build changes:
202    - zlib is now a required dependency.  (Previously it was optional.)
204    - Gtk+3.18.0 or later must now be used when building.
206    - The code implementing the sheet rendering has been removed.  Instead we
207      use a third party library: spread-sheet-widget.
209  * The "NOMISSING" keyword when generating syntax for piecharts in the
210    frequencies command was omitted.  This has been corrected.
212 Changes from 1.0.0 to 1.0.1:
214  * Bug fixes, including fixes for CVE-2017-12958, CVE-2017-12959,
215    CVE-2017-12960, and CVE-2017-12961.
217 Changes from 0.11.0 to 1.0.0:
219  * Translation updates.
221 Changes from 0.10.2 to 0.11.0:
223  * The REGRESSION command now has a /ORIGIN subcommand to perform
224    regression through the origin.
226  * The FACTOR command can now analyse matrix files prepared with MATRIX DATA.
228  * The FACTOR command can now print the anti-image matrices.
230  * The MATRIX DATA command has been added.
232  * Some inappropriate properties in selection dialogs have been corrected.
234  * A bug which could cause the HTML driver to go into a tight loop
235    has been fixed.
237  * An error in the FREQUENCIES procedure, where the word "Mean" was
238    printed when "Variance" was appropriate has been fixed.
240  * The ncurses library is no longer required or used.
242  * A bug where the Mann-Whitney test would give misleading results
243    if run on multiple variables and MISSING=ANALAYSIS was specified
244    has been fixed.
246  * Gtk+3.14.5 or later must now be used when building.
248  * Graphical user interface changes:
250  ** There is a new menu: Edit|Options
252  ** The Non Parametric Statistics Menu has a new item: "K Independent Samples".
254  ** Dialog boxes can now be canceled using the <Escape> key.
256  * The AUTORECODE command now accepts an optional / before INTO.
258  * The short form of the VECTOR command can now create string variables.
260  * Bug fixes, including fixes for CVE-2017-10791 and CVE-2017-10792.
262 Changes from 0.10.1 to 0.10.2:
264  * CROSSTABS implements a new COUNT subcommand to round case or cell
265    weights.
267  * Help will be opened as HTML in default browser if yelp
268    is not available.
270  * When plotting scatterplots with only one dataset (the simple case)
271    the colour used for the dataset is now black.  The previous default
272    from the Tango palette was too faint to see easily.
274  * The varible info dialog could previously only paste a single variable.
275    Now it can paste multiple variables.
277  * Bug fixes, including the following:
279    - T-test with independent samples GUI crashed with string
280      type variable as group variable.
282    - The variable info dialog showed the previous selected variable
283      superimposed with the currently selected one.
285    - The GLM command did not properly deal with missing values.  This
286      has been fixed.
288 Changes from 0.10.0 to 0.10.1:
290  * Bug fixes, including the following:
292    - A bug where certain dialog boxes could not be properly populated
293      has been fixed.
295    - Various commands have been hardened against errors when called
296      with invalid syntax.
298  * Translation updates.  Thanks to our translators!
300 Changes from 0.8.5 to 0.10.0:
302  * The QUICK CLUSTER command has a  /PRINT subcommand which shows
303    the initial cluster centres and the final cluster membership of
304    each case.  The clustering algorithm has also been updated, so
305    as to produce better separated clusters.
307  * A Russian localisation has been contributed.
309  * The GRAPH command now has a /BAR subcommand to draw barcharts.
311  * If the DECIMAL character is set to COMMA then the ',' character
312    will not be treated as a separator by DATA LIST.
314  * The graphical user interface (psppire) has been changed as follows:
316    - It now uses Gtk+ version 3 instead of version 2.  Accordingly, it has a
317      somewhat different look and feel.
319    - There is now a Graphs menu to access the GRAPH command.
321    - The status of dialog box widgets are now preserved between calls
322      to the same dialog box for the same dataset.
324    - The dialog box for the Logistic Regression command will now
325      infer that string variables or any varible with a "measure"
326      of Nominal or Ordinal are to be treated as categorical variables
327      and will generate syntax accordingly.
329  * The pspp-convert utility can now decrypt encrypted syntax files.
330    The encrypted syntax file format is unacceptably insecure, so to
331    discourage its use PSPP and PSPPIRE do not directly read or write
332    this format.
334  * New commands:
336    - SORT VARIABLES.
338  * The following functions for transformation expressions are new:
340    - REPLACE, for search-and-replace of one string with another.
342    - STRUNC, to truncate a string and trim trailing spaces.
344    - MEDIAN, to compute the median of its arguments.
346    - The TRUNC function in expressions now supports additional arguments
347      for truncating to values other than integers and to indicate a level
348      of rounding fuzz.  The default rounding fuzz may now be controlled
349      and displayed with SET FUZZBITS and SHOW FUZZBITS, respectively.
351  * Bug fixes, including the following notable ones:
353    - The correlation coefficient in the paired samples t-test
354      procedure is now correctly calculated when presented with
355      weighted data.
357    - The ESCAPE subcommand has been removed from GET DATA /TYPE=TXT.
358      For compatibility, the behavior that ESCAPE enabled is now the
359      default and only supported behavior.
361    - Rendering of the variable and data sheets in right-to-left locales
362      now works properly.
364    - The Mann-Whitney test, when run on a dataset containing values
365      of the group variable, other than those defining the test groups,
366      would incorrectly calculate the ranks.  This has been corrected.
368  * The IMPORTCASES subcommand on GET DATA is now ignored, for
369    compatibility.
371 Changes from 0.8.4 to 0.8.5:
373  * The FREQUENCIES and CROSSTABS commands can now generate barcharts.
375  * The FACTOR command can now perform PROMAX rotations.
377  * SPSS/PC+ system files are now supported on GET and other commands
378    that read SPSS system files.  The pspp-convert program can now read
379    SPSS/PC+ system files.  Writing the obsolete SPSS/PC+ system file
380    format is not supported.
382  * SYSFILE INFO can now read SPSS/PC+ system files and SPSS portable
383    files.
385  * FREQUENCIES: A bug was fixed where an assertion failure occurred
386    when an empty dataset was presented.
388  * The GRAPH command is now available.  Initially it supports
389    scatterplots and histograms.
391  * The RND operator in expressions now supports additional operands
392    for rounding to values other than integers and to indicate a level
393    of rounding fuzz.  The default rounding fuzz may now be controlled
394    and displayed with SET FUZZBITS and SHOW FUZZBITS, respectively.
396 Changes from 0.8.3 to 0.8.4:
398  * Formatting of SYSFILE INFO output was made easier to read.
400  * Bug fixes, including the following notable ones:
402    - FREQUENCIES works properly for string variables.  (This bug was
403      introduced in 0.8.2.)
405    - CROSSTABS now correctly computes all of the measures that it
406      offers.  Some measures have been removed because they were not
407      computed correctly.
409    - The NPAR TESTS calculation of significance for the RUNS
410      subcommand has been corrected.
412    - Planned comparisons in ONEWAY ANOVA now correctly handle negative
413      T-values.
415    - The COUNT command now correctly treats missing values as
416      documented.
418    - Conformance fixes to Open Document output format.
420 Changes from 0.8.2 to 0.8.3:
422  * Independent T-Tests displayed the standard error of the difference
423    and the confidence interval for the unequal variances case, where
424    the equal variances case should have been.  This has been fixed.
426  * REGRESSION now recognises /STATISTICS=CI(x) which causes confidence
427    intervals for the coefficients to be printed.
429  * When DESCRIPTIVES calculates Z scores, it now omits cases filtered
430    by the current FILTER settings.
432  * PSPPIRE graphical user interface improvements:
434    - Dialog boxes with source  variable lists can now choose the sort
435      order;  right click and select from the popup menu.
437    - File|Open now allows an encoding to be selected for opening
438      system files.
440    - File|Display Data File Information|External File... now allows an
441      encoding to be selected.
443    - A problem with the Means dialog has been resolved (bug #41433).
445    - Several problems related to the input of spreadsheets have been
446      fixed (bug #41657, #41620
448  * System file related improvements:
450    - With ENCODING="DETECT", SYSFILE INFO can now help the user to
451      pick an encoding for reading a system file that does not identify
452      its own encoding
454    - SYSFILE INFO now accepts an ENCODING subcommand to specify the
455      character encoding of string data in the system file.
457    - Variable labels over 255 bytes long are now accepted without
458      truncation (bug #41863).
460    - System files that contain duplicate variable names may now be
461      read successfully (bug #41475).
463 Changes from 0.8.1 to 0.8.2:
465  * Charts are now rendered with colours from the Tango palette instead
466    of fully saturated primaries.
468  * Support for new system file variants:
470    - PSPP can now read and write ZCOMPRESSED system files, which
471      compress data much more effectively than older "compressed"
472      files.  (The older format is still supported.)
474    - PSPP can now decrypt encrypted system files, using the new
475      pspp-convert utility.  The encrypted system file format is
476      unacceptably insecure, so to discourage its use PSPP and PSPPIRE
477      do not directly read or write this format.
479  * Missing values for long string variables are now read from and
480    written to system files in an SPSS-compatible fashion.
482    (Earlier versions of PSPP that supported missing values for long
483    string variables wrote them to system files in an SPSS-incompatible
484    way.  To fix the problem, read the system file with this version of
485    PSPP and then save a new copy of it.)
487  * pspp-convert, a new standalone utility for converting SPSS system
488    and portable files to other formats, is now included.  The initial
489    version supports comma-separated value files as output format.
490    pspp-convert can also decrypt encrypted system files.
492  * Build changes:
494    - zlib is now a required dependency.  (Previously it was optional.)
496 Changes from 0.8.0 to 0.8.1:
498  * New commands:
500    - VARIABLE ROLE.
502  * Changes to existing commands:
504    - CROSSTABS: The requirement that one expected count must be less than five
505         before Fishers Exact Test will be reported has been removed.
507  * PSPPIRE graphical user interface improvements:
509    - A new set of icons has been contributed.
511    - Syntax windows now parse syntax in "auto" mode, which in practice
512      should mean that both "batch" and "interactive" syntax now works,
513      instead of just "interactive" syntax.
515    - The variable pane of data windows now include a Role column.
517  * Notable bug fixes:
519    - System files written by IBM SPSS 21 are now read without warnings.
521    - System files written by "VOXCO INTERVIEWER 4.3" are now read
522      without warnings.
524    - PSPPIRE should now more gracefully handle syntax files that contain
525      errors.
527 Changes from 0.6.2 to 0.8.0:
529  * New commands:
531    - ADD FILES
532    - CORRELATIONS
533    - DATAFILE ATTRIBUTES
534    - DATASET ACTIVATE
535    - DATASET CLOSE
536    - DATASET COPY
537    - DATASET DECLARE
538    - DATASET DISPLAY
539    - DATASET NAME
540    - LOGISTIC REGRESSION
541    - MATCH FILES
542    - MEANS
543    - MRSETS
544    - PRESERVE and RESTORE
545    - QUICK CLUSTER
546    - RELIABILITY
547    - ROC
548    - SAVE TRANSLATE to CSV and tab-delimited files
549    - UPDATE
550    - VARIABLE ATTRIBUTES
552  * Changes to existing commands:
554    - AUTORECODE has a new GROUP subcommand.
556    - CROSSTABS has been re-implemented to fix numerous bugs.
558    - EXAMINE: /MISSING=LISTWISE is now the default.
560    - DO REPEAT command has been reimplemented.  Now, when DO REPEAT
561      contains an INCLUDE or INSERT command, substitutions are not
562      applied to the included file.
564    - FILE HANDLE has a new ENDS subcommand to select CR or CRLF new-lines.
566    - HOST has been updated to use more modern syntax.
568    - Most commands that work with data files now support a new
569      ENCODING subcommand.
571    - MISSING VALUES can now assign missing values to long string
572      variables.
574    - ONEWAY: the POSTHOC subcommand is now implemented.
576    - The following new subcommands to NPAR TESTS have been implemented:
577      COCHRAN, FRIEDMAN, JONCKHEERE-TERPSTRA, KENDALL, KRUSKAL-WALLIS, MANN-WHITNEY,
578      MCNEMAR, SIGN, WILCOXON, and RUNS
580    - SET and SHOW no longer have ENDCMD, NULLINE, PROMPT, CPROMPT, and
581      DPROMPT subcommands.  The defaults are now fixed values.
583    - SHOW now has a JOURNAL subcommand, to show the location of the
584      journal file.
586    - VALUE LABELS can now assign value labels to long string
587      variables.
589  * Other language changes:
591    - The new DATASET commands replace the "scratch file" PSPP
592      extension, which is no longer supported.
594    - Strings may now include arbitrary Unicode code points specified
595      in hexadecimal, using the syntax U'hhhh'.  For example, Unicode
596      code point U+1D11E, the musical G clef character, may be
597      expressed as U'1D11E'.
599      See the "Tokens" section in the PSPP manual for more information.
601    - In previous versions of PSPP, in a string expressed in
602      hexadecimal with X'hh' syntax, the hexadecimal digits expressed
603      bytes in the locale encoding.  In this version of PSPP, X'hh'
604      syntax always expresses bytes in UTF-8 encoding.
606      See the "Tokens" section in the PSPP manual for more information.
608  * PSPPIRE graphical user interface improvements:
610    - Added support for non-ASCII characters in strings, labels and
611      variable names.
613    - A "Split Window" function is available, which makes it easier to
614      see different parts of a large data file.
616    - Data files can now be opened by specifing their name as the first
617      argument.  This means that on a properly configured desktop, double
618      clicking on an icon will open the file.
620    - Foreign formats, such as Gnumeric, OpenDocument and CSV can be imported
621      via using an "intelligent" application assistant dialog.
623  * Output changes:
625    - The new "cairo" output driver supports output in PostScript, PDF,
626      and SVG formats.  Its functionality is a superset of that of the
627      "postscript" driver, which has been removed.  You must have Cairo
628      and Pango installed to build the "cairo" driver.
630    - Charts are now produced with Cairo and Pango, instead of libplot.
631      Without them, the new graphing features will not work.  If you do
632      not have Cairo and Pango installed, you must run `configure' with
633      --without-cairo.
635    - The plain text output driver now properly supports multibyte UTF-8
636      characters, including double-width characters and combining
637      accents.
639    - Output to OpenDocument format is now supported.
641    - The HTML output is much improved.
643  * The "pspp" program has a new option --batch (or -b) that selects
644    "batch" syntax mode.  In previous versions of PSPP this syntax mode
645    was the default.  Now a new "auto" syntax mode is the default.  In
646    "auto" mode, PSPP interprets most syntax files correctly regardless
647    of their intended syntax mode.
649    See the "Syntax Variants" section in the PSPP manual for more
650    information.
652  * The "pspp" program has a new option --syntax-encoding that
653    specifies the encoding for syntax files listed on the command line,
654    as well as the default encoding for syntax files included with
655    INCLUDE or INSERT.  The default is to accept the system locale
656    encoding, UTF-8, UTF-16, or UTF-32, automatically detecting which
657    one the system file uses.
659    See the documentation for the INSERT command in the PSPP manual for
660    more information.
662  * Text data files that PRINT and WRITE creates now use the system
663    native line ends by default (CRLF on Windows, LF only elsewhere).
664    Use the new ENDS subcommand on FILE HANDLE to override the default.
666  * A new Perl module allows Perl programs to read and write PSPP
667    system files.
669  * A tutorial chapter has been added to the user manual.
671 Changes from 0.6.1 to 0.6.2:
673   * New translations:
675     - Dutch, thanks to Harry Thijssen.
677     - Brazilian Portuguese, thanks to Michel Boaventura.
679     Thanks for translations are also due to the coordinators at
680     translationproject.org.
682   * Statistical bug fixes:
684     - REGRESSION: Report correct standard error of the estimate (bug
685       #25677).
687     - T-TEST: Report correct significance of paired sample T-test in
688       the common case (bug #26936) and corner cases.  Thanks to Mike
689       Griffiths and Matej Cepl for reporting these bugs.
691   * Build fixes and changes:
693     - Fix build with GTK+ 2.17.4 and later.
695     - Make running "make" after running "configure" with different
696       settings reliably rebuild version.c.
698     - Cygwin and MinGW build fixes.
700     - Fixes for building with recent gnulib.
702     - The Makefile now honors two new variables, PSPP_LDFLAGS and
703       PSPPIRE_LDFLAGS, that affect linking of the PSPP and PSPPIRE
704       binaries, respectively.  This makes building easier for some
705       packagers.
707     - Fixes for "configure --enable-relocatable" (bug #25508).
709   * Data file bug fixes and changes:
711     - Fix reading text data files that contain a mix of white space
712       and commas.  Now "a ,b" is treated as two fields containing "a"
713       and "b"; previously it was treated as three, with an empty field
714       in the middle.
716     - Fix writing corrupted .sav files on Windows.
718     - Fix writing variable labels longer than 252 bytes to save files.
719       Thanks to Robert Westlund for reporting this bug.
721     - Fix writing corrupted .por files (bug #26034).
723     - Fix reading .por files whose initial lines are not padded out
724       with spaces as expected.
726     - PSPP will no longer issue warnings about some .sav file records
727       or values that it does not understand.  These warnings were
728       harmless, but needlessly alarmed some users.
730     - Fix crash reading empty string fields from PostgreSQL databases.
732   * Bug fixes that affect PSPP and PSPPIRE:
734     - Users may now control precision of output statistics.  Instead
735       of hard coding the width and decimals of output numbers, respect
736       the default format in most instances.  Counts are now normally
737       displayed with the format of the weight variable, if any.
739     - Fix crash when an INSERT command specifies the name of a file
740       that does not exist (bug #24569).
742     - Fix crash when CROSSTABS specifies a long-string variable (bugs
743       #24557 and #26131).
745     - Fix crash drawing pie charts with many segments.
747     - Fix crash when NUMERIC specifies an invalid format.
749   * PSPPIRE bug fixes and changes:
751     - On Windows, write the output file to the user's home directory
752       instead of the current directory, to better match user
753       expectations.
755     - Some data editor fixes.
757   * Documentation:
759     - Fix typo in BINOMIAL section of user manual (bug #25892).
761 Changes from 0.6.0 to 0.6.1:
763   * Statistical bug fixes:
765     - Report correct standardized regression coefficients in linear
766       regression output (bug #23567).
768   * Bug fixes that affect PSPP and PSPPIRE:
770     - Avoid crash with pie charts (bug #24014).
772     - Don't append % to count totals (bug #24003).
774     - Don't crash on bad input (bug #24031).
776     - Don't crash if "end data." is not left aligned (bug #24115).
778     - Change default workspace value to 64 MB, to avoid unnecessary
779       disk accesses on modern machines.
781   * PSPPIRE bug fixes:
783     - Add ".sav" or ".por" suffix to filename when saving with Save_As
784       (bug #23137).
786     - Make it possible to reopen the output window on Windows (bug
787       #24033).
789     - A POSIX regular expression library is now included and used
790       automatically if the host does not have one or has one that is
791       inadequate.
793   * Build fixes and changes:
795     - Work around bug in GSL that prevented build with recent GCC
796       versions without manually adding -fgnu89-inline to CFLAGS.
798     - Also warn about missing prerequisites as we encounter them (bug
799       #24445).
801     - Distribute necessary files to allow users working from the
802       distributed tarball to configure with --enable-gui-tools.
804     - Append $(EXEEXT_FOR_BUILD) to output file name when building
805       q2c, fixing build problems on Windows.
807     - GSL 1.8 or later is now required.
809     - Build errors with --enable-relocatable were fixed.
811   * The German translations were removed, since native German speakers
812     found them too poor to be useful.
814 Changes from 0.4.0 to 0.6.0:
816   * The PSPP license is now version 3 or later of the GNU General
817     Public License.  Previously, it was version 2 or later.
819   * PSPP now has a graphical interface, called PSPPIRE.  This
820     interface allows you to enter data and variable definitions
821     interactively.  Commands may be executed in syntax form, or by
822     using the interactive dialog boxes available from the dropdown
823     menus.
825   * A few sample syntax files are now included in the `examples'
826     directory.
828   * Numerous major and minor bugs have been fixed.
830   Build changes:
832     * The INSTALL file now reflects the details of how to install
833       PSPP.  It is a tailored version of the generic installation
834       instructions, instead of a verbatim copy.
836     * iconv, which is ordinarily installed as part of a Unix-like
837       system, is now required.  If you don't have it already, you can
838       install GNU libiconv (http://www.gnu.org/software/libiconv/).
840     * libxml2 and zlib are new optional dependencies.  They are
841       required to use PSPP's support for reading Gnumeric files.
843   Statistical procedure changes:
845     * REGRESSION is a new procedure for fitting linear models to data
846       via least-squares estimation.
848     * NPAR TESTS is a new procedure for non-parametric tests.  In this
849       release, it supports binomial and chi-square tests.
851     * RANK is a new procedure to rank variables.  It supports numerous
852       forms of ranking.
854     * FREQUENCIES can now output histograms and pie charts.  These
855       features were present in earlier releases, but not documented.
857   User interface changes:
859     * In many situations where PSPP once terminated with a fatal
860       error, PSPP now recovers and continues execution.
862     * PSPP is now able to start up and run even if it cannot find its
863       configuration files.
865     * Journaling of interactive commands to a disk file is now
866       implemented.  By default, journaling is enabled, to a file named
867       `pspp.jnl' in the current directory.  SET JOURNAL may be used to
868       control journaling.
870     * The use of `+' between syntax file names on the command line to
871       prevent the dictionary from being cleared between their
872       executions is no longer supported.  All syntax files are now
873       executed as if `+' had been specified.
875     * The -d/--define and -u/--undef command line options are no
876       longer supported.  Instead, use /usr/bin/env or shell primitives
877       to define or clear environment variables before invoking PSPP.
879     * If a syntax file named named `rc' is found in a configuration
880       directory (such as $HOME/.pspp), it is executed before any
881       syntax file specified on the command line.  The -r or
882       --no-statrc command line option may be used to disable this
883       behavior.
885   Output changes:
887     * Output configuration options have changed.  Please refer to the
888       manual for a full description of the available options.
890       In consequence, you will need to reinstall your "devices" file.
891       "make install" will do this for you.
893     * Most error messages are now written to PSPP output files by
894       default.  SET ERROR can be used to disable this behavior.
896     * When invoked interactively, PSPP now by default produces output
897       on the terminal, piping it through the "more" program.
898       Previously, by default output was written only to file
899       pspp.list.  On most terminals, the page length used for output
900       automatically adapts to the terminal size, even if the terminal
901       is resized.
903     * ASCII driver:
905       - This driver now supports charts in output.  Charts are written
906         as separate files that the main output file refers to.  By
907         default, charts are written in PNG format to files named
908         pspp-1.png, pspp-2.png, and so on.
910       - Configurations are provided that use VT100 (and xterm)
911         line-drawing characters in tables.  The option "-o list-vt100"
912         requests use of this device for output to pspp.list.
914     * PostScript driver:
916       - The default paper size is now determined using the PAPERSIZE
917         environment variable, or the LC_PAPER locale category on
918         systems that support it.  If these are not set, the default is
919         now A4, instead of US letter.  To make US letter the default,
920         set PAPERSIZE to "letter" in your environment.
922       - Font metrics are now read from AFM files, instead of
923         Groff-format metrics files.  PostScript fonts can now be
924         embedded in output.
926         In consequence, you will need to install an AFM file for each
927         font used in PostScript output.  "make install" will install
928         AFM files for the standard PostScript fonts, including the
929         ones that the PostScript driver uses by default.
931       - Standard paper sizes no longer need to be specified through a
932         configuration file.  The "papersize" configuration file is no
933         longer needed, or supported.
935       - The PostScript prologue is no longer obtained from the
936         "ps-prologue" configuration file.  This configuration file is
937         no longer needed, or supported.
939     * HTML driver:
941       - The HTML prologue is no longer obtained from the
942         "html-prologue" configuration file.  This configuration file
943         is no longer needed, or supported.
945   Command language changes:
947     * The following commands are new:
949       - GET DATA, which currently supports reading Gnumeric files and
950         text data files.  It will be extended later to read other
951         types of foreign data.
953       - CD, to change the current directory.
955       - INSERT, to execute a syntax file.
957       - DELETE VARIABLES, to remove variables from the active file
958         dictionary.
960       - ADD DOCUMENT, to add text to active file documents.
962       - CLOSE FILE HANDLE (a PSPP extension; see below).
964       - XEXPORT, a PSPP extension that is a transformation equivalent
965         to EXPORT.
967     * The following functions for transformation expressions are new:
969       - DATEDIFF, for computing the difference of two dates.
971       - DATESUM, for advancing a date by a specified duration.
973       - VALUELABEL, to obtain the value label for a value.
975     * PSPP now supports very long string variables (over 255 bytes
976       long).
978     * MATCH FILES now supports the FIRST and LAST subcommands.
980     * Previous versions of PSPP prohibited using commands to both read and
981       write a single file at the same time.  Now, PSPP allows this, and
982       the new version of the file atomically replaces the old version.
984     * The following commands are no longer available.  They will be
985       re-implemented in a later release:
987       - CLEAR TRANSFORMATIONS
989       - MATRIX DATA
991       - REPEATING DATA
993     * The PROCESS IF command, which was deprecated, has been removed.
994       You may replace any usage of it by SELECT IF following
995       TEMPORARY, which has the same effect.
997     * The output format for variables created by VECTOR may now be
998       specified as part of the VECTOR syntax.
1000   "Scratch files", a new PSPP extension:
1002     A scratch file, like a system file, consists of a dictionary and
1003     any number of cases.  Small scratch files are stored in memory;
1004     one that grows too large is written to disk.  By default, any file
1005     handle whose name begins with # is assumed to refer to a scratch
1006     file.
1008     Scratch files can be used just about anywhere a system or portable
1009     file can be used.  Also, portable files are now allowed in most
1010     places that system files were allowed in previous PSPP version.
1012     A new CLOSE FILE HANDLE command allows the storage associated with
1013     scratch files to be freed.  It also allows file handles to be
1014     reassigned to new files.
1016     For more information on scratch files, refer to the "File Handles"
1017     section in the PSPP manual.  For specifics of what commands now
1018     allow what kinds of files to be specified, refer to the
1019     documentation on those particular commands.
1021   Data access changes:
1023     * Binary formats and IBM/360 formats, including ASCII/EBCDIC
1024       translation, are now supported.  Use FILE HANDLE to specify the
1025       format of these files.
1027     * Little-endian, big-endian, and VAX-endian formats are now
1028       supported for integer binary formats when reading and writing
1029       data files.  The new RIB and WIB subcommands on the SET command
1030       control endianness of integer data.  The default is the host's
1031       native endianness.
1033     * IEEE 754, VAX, and IBM hexadecimal formats are now supported for
1034       floating point binary formats when reading and writing data
1035       files.  The new RRB and WRB subcommands on the SET command
1036       control the floating point format.  The default is the host's
1037       native floating point format.
1039     * DATA LIST now supports the SKIP subcommand, to skip records at
1040       the beginning of a file.  For compatibility, DATA LIST now
1041       treats N format as F format for FREE and LIST format input.
1043     * The SAVE and XSAVE commands now support the UNSELECTED,
1044       PERMISSIONS, NAMES, and MAP subcommands.
1046     * The EXPORT command has been re-implemented to obtain better
1047       results.  Support for the UNSELECTED, DIGITS, and TYPE
1048       subcommands has been added.
1050     * For compatibility, PRINT now inserts a space at the beginning of
1051       every output line, even lines that would otherwise be blank,
1052       when OUTFILE is specified.  (The behavior of WRITE is
1053       unchanged.)
1055     * For compatibility, PRINT EJECT now inserts the digit `1' at the
1056       beginning of each line that should begin a new page.
1058     * For compatibility, WRITE now outputs the system-missing value as
1059       a field filled with spaces.  Binary formats are an exception.
1060       (The behavior of PRINT is unchanged.)
1062   Documentation:
1064     * Input and output format descriptions have been rewritten.  They
1065       now precisely describe what is accepted on input and written on
1066       output.
1068     * The descriptions of the PSPP system and portable file formats
1069       have been extensively revised and improved.
1071   For developers, the build system now requires Autoconf 2.60 and
1072   Automake 1.10.
1074 Changes from 0.3.0 to 0.4.0:
1076   Changes in build dependencies:
1078     * The GNU Scientific Library (libgsl), version 1.6 or later, is
1079       now required.
1081     * libplot from GNU plotutils is optional.  Without it, the new
1082       graphing features will not work.  If you do not have it
1083       installed, you must run `configure' with --without-libplot.
1085     * libgmp2 is no longer a dependency.
1087   Newly implemented commands and statistical features:
1089     * EXAMINE, including its graphing features.
1091     * FREQUENCIES now supports percentiles.
1093     * ONEWAY.
1095     * PERMISSIONS.
1097     * SHOW.
1099     * SORT CASES now sorts stably, that is, two cases with equal sort
1100       criteria will be in the same relative order before and after the
1101       sort.
1103     * T-TEST (re-written).
1105     * DATE and USE.  These commands are parsed but otherwise ignored,
1106       to enhance compatibility with certain command files that invoke
1107       them unnecessarily.
1109     * VARIABLE WIDTH, VARIABLE ALIGNMENT, and VARIABLE LEVEL.  These
1110       currently have no effect on PSPP output, but their values are
1111       written to and read from system files and thus may affect
1112       third-party software.
1114     * SET EPOCH implemented.
1116     * DATA LIST FREE and DATA LIST LIST now support arbitrary field
1117       delimiters.
1119     * FILE HANDLE now supports custom tab widths.
1121   Long variable names (and other identifiers) are now supported.  Up
1122   to the first 64 bytes of each identifier is significant.  PSPP now
1123   reads and writes system files compatible with SPSS version 12.
1125   New --algorithm and --syntax command line options allow
1126   SPSS-compatible or enhanced modes to be selected.
1128   Support for transformation expressions has been rewritten and
1129   significantly improved.  Refer to the manual for details.
1131   Calculation of moments (mean, standard deviation, kurtosis,
1132   skewness) has been rewritten and should now be more accurate.  In
1133   --algorithm=enhanced mode moments may be more accurate than SPSS in
1134   some cases.
1136   Numerous bugs have been fixed, too many to mention here.  Many new
1137   tests have been added, leading to the discovery and fixing of many
1138   of these bugs.
1140   The ASCII output driver can now squeeze multiple blank lines into
1141   single blank lines.
1143   Much of the code has been rewritten and refactored.  It is now much
1144   cleaner.
1146   The FILE TYPE and REPEATING DATA commands have been disabled for
1147   this release because their implementations were deemed too buggy to
1148   be useful.  They will be fixed and replaced in a future release.
1150   New pspp-mode for Emacs (in pspp-mode.el).
1152   Added rudimentary command-line completion for interactive input.
1154   lib/julcal and lib/dcdflib are no longer used, so they have been
1155   removed.
1157   For developers, the build system now requires Autoconf 2.58 and
1158   Automake 1.7.  The included gettext has been updated to version
1159   0.12.1.
1161   Some reports state that Texinfo 4.8, the latest version, may be
1162   necessary to successfully format the documentation on some systems.
1164 Version 0.3.0 changes since 0.2.3:
1166   Bugs fixed:
1168     * Using alphanumeric variables in functions under AGGREGATE
1169       segfaulted.  Fixed.
1171     * Under certain circumstances, the final case would be omitted
1172       from the results of an AGGREGATE operation.  Fixed.
1174     * Undefined behavior was invoked by referencing a freed pointer
1175       under certain circumstances.  Fixed.
1177     * A wrong record size was displayed when paging the active file to
1178       disk.  Fixed.
1180     * Not having enough temporary space for sorting caused a core
1181       dump.  Fixed.
1183     * Syntax errors in function descriptions on AGGREGATE caused core
1184       dumps.  Fixed.
1186     * A null pointer was dereferenced, causing a core dump, when
1187       PERCENTILES was specified on FREQUENCIES.  This fixes the
1188       problem, but PSPP still doesn't calculate percentiles.
1190     * SORT always sorted in ascending order.  Fixed.
1192     * Some minor memory leaks in the expression parser were removed.
1194     * Many assertions fixed for strict ANSI C compliance.
1196   New features:
1198     * SET ECHO ON now implemented, but turned off by default.
1200     * PRINT specifier supported on END REPEAT.
1202   Other:
1204     * System libgmp2 library is used if installed instead of
1205       unconditionally using the included libgmp2 subset.
1207     * Extensive code cleanup, which continues.
1209     * Added CORRELATIONS command parser, but not implemented.
1211 Version 0.2.3 changes since 0.2.2:
1213   Bugs fixed:
1215     * SPLIT FILE with a string variable caused a core dump.  Fixed.
1217     * Nested INCLUDEs didn't work.  Fixed.
1219     * The MATCH FILES procedure set the values of variables not present
1220       to 0.  It should have been SYSMIS.  This is now fixed.
1222     * The REMARK command was too aggressive about skipping lines.  It
1223       didn't like being the last command in a file.
1225     * Comment parsing wasn't consistent with the rest of the code in its
1226       idea of where one command ends and another starts.  This meant
1227       that sometimes commands would be mysteriously ignored.  Thanks to
1228       Dr. Dirk Melcher <BZN-mdksh@t-online.de> for reporting this bug.
1230     * The TABLE subcommand on MATCH FILES worked only erratically at
1231       best.  This fixes it.  Thanks to Dr. Dirk Melcher
1232       <BZN-mdksh@t-online.de> for reporting this bug.
1234     * VARIABLE LABELS rejected a slash before the first variable
1235       specification, contradicting the documentation.  Thanks to Walter
1236       M. Gray <graywm@northernc.on.ca> for reporting this bug.
1238     * Because of an incorrect optimization in memory allocation,
1239       CROSSTABS sometimes segfaulted when asked to output multiple
1240       tables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1241       reporting this bug.
1243     * CROSSTABS didn't display value labels for column and row
1244       variables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1245       reporting this bug.
1247     * WRITE didn't write line ends.  Fixed.  Thanks to Dr. Dirk Melcher
1248       <BZN-mdksh@t-online.de> for reporting this bug.
1250     * The TABLE subcommand on MATCH FILES worked only erratically at
1251       best.  This fixes it.  Thanks to Dr. Dirk Melcher
1252       <BZN-mdksh@t-online.de> for reporting this bug.
1254     * VARIABLE LABELS rejected a slash before the first variable
1255       specification, contradicting the documentation.  Thanks to Walter
1256       M. Gray <graywm@northernc.on.ca> for reporting this bug.
1258     * Because of an incorrect optimization in memory allocation,
1259       CROSSTABS sometimes segfaulted when asked to output multiple
1260       tables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1261       reporting this bug.
1263     * CROSSTABS didn't display value labels for column and row
1264       variables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1265       reporting this bug.
1267     * WRITE didn't write line ends.  Fixed.  Thanks to Dr. Dirk Melcher
1268       <BZN-mdksh@t-online.de> for reporting this bug.
1270     * MATCH FILES corrupted memory and dumped core on some syntax
1271       errors.  Fixed.
1273     * MATCH FILES should set numeric values not available to the
1274       system-missing value, not to 0.  Thanks to Dr. Dirk Melcher
1275       <BZN-mdksh@t-online.de> for reporting this bug.
1277     * KEEP didn't work properly on the SAVE procedure.  Fixed.  Thanks
1278       to Ralf Geschke <ralf@kuerbis.org> for reporting this bug.
1280     * Memory leak fix.
1282     * Some systems didn't like the way open_file was coded.  Thanks to
1283       Hankin <hankin@rogue.consultco.com> for pointing this out.
1285     * The SAVE procedure didn't save long string variables properly.
1286       Fixed by this patch.  Thanks to Hankin
1287       <hankin@rogue.consultco.com> for this patch.
1289     * Minor documentation fixes for MATCH FILES.
1291 Version 0.2.2 changes since 0.2.1:
1293   Bugs fixed:
1295     * Fix behavior of PRINT SPACE for negative arguments.
1297     * Fix reading some unusual system files.
1299     * Fix LIST problems with very long variables.  Thanks to Hankin
1300       <hankin@dunno.com> for this bug report.
1302     * Fix problems with some string format specifiers.
1304     * Fix use of $CASENUM in expressions.  Thanks to Dirk Melcher
1305       <BZN-mdksh@t-online.de> for reporting this bug.
1307     * Additional DATA LIST FREE and DATA LIST LIST fixes.  Thanks to
1308       Hankin <hankin@dunno.com> again on this one.
1310     * Sometimes you may encounter a PSPP script that has to be
1311       interpreted in interactive mode.  Now you can use the -i flag to
1312       do this.
1314     * Warnings for egcs 1.1.1 cleaned up.  (However you'll get lots of
1315       `unused variable' warnings under gcc 2.7.2.3, fixing this will
1316       take more effort.)
1318     * Tests fixed.
1320     * The files in gmp need the internationalization directory in
1321       their include path.  Thanks to OKUJI Yoshinori
1322       <okuji@kuicr.kyoto-u.ac.jp> for pointing this out.
1324 Version 0.2.1 changes since 0.2.0:
1326   Bugs fixed:
1328     * Remember to include examples/ directory in distribution :-)
1330     * Fixed gmp compile problems for some non-i386 architectures.
1331       Thanks to Hans Olav Eggestad <olav@jordforsk.nlh.no> and others
1332       for reporting this.
1334     * DATA LIST FREE and DATA LIST LIST parsing of input files is now
1335       matches the documented behavior exactly, and error messages are
1336       more helpful.  Thanks to Mark H. Wood <mwood@IUPUI.Edu>.
1338 Version 0.2.0 changes since 0.1.0:
1340   Procedures now implemented:
1341     * CROSSTABS.  Please see documentation for caveats.
1343   Transformations and utilities now implemented:
1344     * AGGREGATE
1345     * APPLY DICTIONARY
1346     * CLEAR TRANSFORMATIONS
1347     * DISPLAY (all subcommands).
1348     * ERASE
1349     * FLIP
1350     * EXPORT
1351     * HOST
1352     * IMPORT
1353     * MATCH FILES
1354     * MATRIX DATA
1355     * NEW FILE
1356     * REPEATING DATA
1358   Support for input and output through pipes: "|command" and
1359   "command|" filenames; support for special filenames "-", "stdin",
1360   "stdout", "stderr".
1362   New command-line features:
1363     * New option --testing-mode: Invoke heuristics to assist testing.
1364     * New option --safer, -s: Don't allow certain unsafe operations.
1365     * New option --command=CMD, -c CMD: Perform literal command CMD.
1366     * rc file ~/.pspp/rc is executed before any other files.
1367     * Now multiple syntax files can be specified.
1369   Operator LAG is now implemented.
1371   Added missing FILE subcommand to REREAD.
1373   Table output manager completely rewritten.
1375   Device configuration file syntax changed.  You will need to
1376   reinstall your `devices' file.
1378   New output driver for HTML.
1380   PostScript driver and prologue simplified.
1382   Many bugs fixed.  General source-code cleanup.
1384   Added Texinfo documentation for:
1385     * PSPP system file format
1386     * PSPP portable file format
1387     * How to write input for q2c parser generator
1388     * HTML driver
1390   PSPP language is now fully documented.  Please report any
1391   inaccuracies or omissions in the documentation.
1393 Changes for version 0.1.0:
1395   First public release.  For changes from unreleased development
1396   versions, please see ONEWS.
1398 ----------------------------------------------------------------------
1399 Copyright information:
1401    Permission is granted to anyone to make or distribute verbatim
1402    copies of this document as received, in any medium, provided that
1403    the copyright notice and this permission notice are preserved, thus
1404    giving the recipient permission to redistribute in turn.
1406    Permission is granted to distribute modified versions of this
1407    document, or of portions of it, under the above conditions,
1408    provided also that they carry prominent notices stating who last
1409    changed them.
1411 Local variables:
1412 version-control: never
1413 mode: indented-text
1414 end: