token: Update functional interface and add token_copy(), token_equal().
[pspp.git] / NEWS
blobbbf5f877a05d5d6dc1f8695fb0c278c384f5eaf8
1 PSPP NEWS -- history of user-visible changes.
2 Copyright (C) 1996-2000, 2008-2016, 2017, 2019, 2020, 2021 Free Software Foundation, Inc.
3 See the end for copying conditions.
5 Please send PSPP bug reports to bug-gnu-pspp@gnu.org.
7 Changes from 1.4.1 to 1.5.3:
9  * An error in the displayed signficance of oneway anova
10    contrasts tests has been corrected.
12  * Added Drag-N-Drop in output view.
14  * The Explore GUI dialog supports the "Plots" subdialog. Boxplots, Q-Q Plots
15    and Spreadlevel plots are now also available via the GUI.
17  * The graphical user interface for importing spreadsheets has been improved.
18    The new interface provides the user with a preview of the data to be imported
19    and interactive methods to select the desired ranges.
21  * The user manual, in its Info and HTML versions, now includes
22    graphical output examples and screenshots.
24  * Build changes:
26    - The Cairo and Pango libraries are now required.
28    - gettext 0.20 or later is now required.
30  * Output improvements:
32    - New drivers for output to TeX source files and to PNG files.
34    - Table output styles may now be set with the new option
35      --table-look and the new SET TLOOK command.
37    - New driver option "trim" to remove empty space from PDF,
38      PostScript, SVG, and PNG output files.
40    - The PDF output driver now adds an outline to allow PDF viewers to display
41      as a "table of contents" for the file.
43    - The HTML output driver has a new option "bare".
45  * New features in pspp-output:
47    - New --table-look and --nth-commands options.
49    - New get-table-look and convert-table-look commands.
51 Changes from 1.4.0 to 1.4.1:
53  * Bug fixes.
55  * Translation updates.
57  * HTML output is now HTML5 instead of HTML4.0 Transitional.
59  * The HOST command has been reimplemented.  It now supports TIMELIMIT.
61 Changes from 1.2.0 to 1.4.0:
63  * The file pspp-mode.el (the pspp-mode for Emacs) is no longer distributed
64    with PSPP.  Instead, it can be installed directly in emacs and is available
65    from https://elpa.gnu.org/packages/pspp-mode.html
67  * The Find dialog box, when searching for numeric values, will match only
68    to the precision of the variable's print format.  This avoids behaviour
69    which is surprising to some users.
71  * PSPP now supports the SPSS viewer (.spv) format that SPSS 16 and later
72    use to save the contents of its output editor:
74    - PSPP and PSPPIRE can write output to .spv files.
76    - The new utility pspp-output can convert .spv files to other formats.
78    - The pspp-convert utility can now decrypt encrypted .spv files.  The
79      encrypted viewer file format is unacceptably insecure, so to
80      discourage its use PSPP and PSPPIRE do not directly read or write
81      this format.
83  * A bug where the Data|Select Cases|Random Sample menu would generate
84    invalid syntax has been fixed.
86  * FREQUENCIES will emit a warning if one or more weight values are missing.
88  * Plain text output is no longer divided into pages, since it is now
89    rarely printed on paper.
91  * pspp-convert improvements:
93    - New "-a", "-l", "--password-list" options to search for an
94      encrypted file's password.
96    - New "--keep" and "--drop" options to output only selected variables.
98    - New "--recode", "--no-var-name", "--labels", "--print-formats",
99      "--decimal", "--delimiter", and "--qualifier" options to control
100      CSV output.
102  * Improvements to SAVE DATA COLLECTION support for MDD files.
104  * Bug fix for CVE-2018-20230.
106  * The /RENAME subcommand in SAVE TRANSLATE et al. has been extended
107    to support the syntax also accepted by other software.
109  * The EXAMINE command will now perform the Shapiro-Wilk test when
110    one or more plots are requested.
112  * The REGRESSION command now supports the /STATISTICS=TOL option which
113    outputs tolerance and variance inflation factor metrics for the data.
115  * The QUICK CLUSTER command now supports the /SAVE option which can
116    be used to save the cases' cluster membership and/or their distance
117    from the cluster centre to the active file.
119  * The MEANS command has been re-implemented.
121  * The GUI now has a sub-dialog for post-hoc tests of the oneway
122    anova test.
124  * Gtk+3.22.0 or later must now be used when building.
126  * GRAPH: Categorical barcharts displaying percentages now show the
127    sub-category as a percentage of the primary category instead of the
128    total.
130  * The Syntax Window now has a Find function to perform simple text
131    searching.
133  * AUTORECODE:
135    - The PRINT subcommand is now implemented.
137    - Many bug fixes.
139 Changes from 1.0.1 to 1.2.0:
141  * New experimental command SAVE DATA COLLECTION to save MDD files.
143  * MTIME and YMDHMS variable formats now supported.
145  * Build changes:
147    - zlib is now a required dependency.  (Previously it was optional.)
149    - Gtk+3.18.0 or later must now be used when building.
151    - The code implementing the sheet rendering has been removed.  Instead we
152      use a third party library: spread-sheet-widget.
154  * The "NOMISSING" keyword when generating syntax for piecharts in the
155    frequencies command was omitted.  This has been corrected.
157 Changes from 1.0.0 to 1.0.1:
159  * Bug fixes, including fixes for CVE-2017-12958, CVE-2017-12959,
160    CVE-2017-12960, and CVE-2017-12961.
162 Changes from 0.11.0 to 1.0.0:
164  * Translation updates.
166 Changes from 0.10.2 to 0.11.0:
168  * The REGRESSION command now has a /ORIGIN subcommand to perform
169    regression through the origin.
171  * The FACTOR command can now analyse matrix files prepared with MATRIX DATA.
173  * The FACTOR command can now print the anti-image matrices.
175  * The MATRIX DATA command has been added.
177  * Some inappropriate properties in selection dialogs have been corrected.
179  * A bug which could cause the HTML driver to go into a tight loop
180    has been fixed.
182  * An error in the FREQUENCIES procedure, where the word "Mean" was
183    printed when "Variance" was appropriate has been fixed.
185  * The ncurses library is no longer required or used.
187  * A bug where the Mann-Whitney test would give misleading results
188    if run on multiple variables and MISSING=ANALAYSIS was specified
189    has been fixed.
191  * Gtk+3.14.5 or later must now be used when building.
193  * Graphical user interface changes:
195  ** There is a new menu: Edit|Options
197  ** The Non Parametric Statistics Menu has a new item: "K Independent Samples".
199  ** Dialog boxes can now be canceled using the <Escape> key.
201  * The AUTORECODE command now accepts an optional / before INTO.
203  * The short form of the VECTOR command can now create string variables.
205  * Bug fixes, including fixes for CVE-2017-10791 and CVE-2017-10792.
207 Changes from 0.10.1 to 0.10.2:
209  * CROSSTABS implements a new COUNT subcommand to round case or cell
210    weights.
212  * Help will be opened as HTML in default browser if yelp
213    is not available.
215  * When plotting scatterplots with only one dataset (the simple case)
216    the colour used for the dataset is now black.  The previous default
217    from the Tango palette was too faint to see easily.
219  * The varible info dialog could previously only paste a single variable.
220    Now it can paste multiple variables.
222  * Bug fixes, including the following:
224    - T-test with independent samples GUI crashed with string
225      type variable as group variable.
227    - The variable info dialog showed the previous selected variable
228      superimposed with the currently selected one.
230    - The GLM command did not properly deal with missing values.  This
231      has been fixed.
233 Changes from 0.10.0 to 0.10.1:
235  * Bug fixes, including the following:
237    - A bug where certain dialog boxes could not be properly populated
238      has been fixed.
240    - Various commands have been hardened against errors when called
241      with invalid syntax.
243  * Translation updates.  Thanks to our translators!
245 Changes from 0.8.5 to 0.10.0:
247  * The QUICK CLUSTER command has a  /PRINT subcommand which shows
248    the initial cluster centres and the final cluster membership of
249    each case.  The clustering algorithm has also been updated, so
250    as to produce better separated clusters.
252  * A Russian localisation has been contributed.
254  * The GRAPH command now has a /BAR subcommand to draw barcharts.
256  * If the DECIMAL character is set to COMMA then the ',' character
257    will not be treated as a separator by DATA LIST.
259  * The graphical user interface (psppire) has been changed as follows:
261    - It now uses Gtk+ version 3 instead of version 2.  Accordingly, it has a
262      somewhat different look and feel.
264    - There is now a Graphs menu to access the GRAPH command.
266    - The status of dialog box widgets are now preserved between calls
267      to the same dialog box for the same dataset.
269    - The dialog box for the Logistic Regression command will now
270      infer that string variables or any varible with a "measure"
271      of Nominal or Ordinal are to be treated as categorical variables
272      and will generate syntax accordingly.
274  * The pspp-convert utility can now decrypt encrypted syntax files.
275    The encrypted syntax file format is unacceptably insecure, so to
276    discourage its use PSPP and PSPPIRE do not directly read or write
277    this format.
279  * New commands:
281    - SORT VARIABLES.
283  * The following functions for transformation expressions are new:
285    - REPLACE, for search-and-replace of one string with another.
287    - STRUNC, to truncate a string and trim trailing spaces.
289    - MEDIAN, to compute the median of its arguments.
291    - The TRUNC function in expressions now supports additional arguments
292      for truncating to values other than integers and to indicate a level
293      of rounding fuzz.  The default rounding fuzz may now be controlled
294      and displayed with SET FUZZBITS and SHOW FUZZBITS, respectively.
296  * Bug fixes, including the following notable ones:
298    - The correlation coefficient in the paired samples t-test
299      procedure is now correctly calculated when presented with
300      weighted data.
302    - The ESCAPE subcommand has been removed from GET DATA /TYPE=TXT.
303      For compatibility, the behavior that ESCAPE enabled is now the
304      default and only supported behavior.
306    - Rendering of the variable and data sheets in right-to-left locales
307      now works properly.
309    - The Mann-Whitney test, when run on a dataset containing values
310      of the group variable, other than those defining the test groups,
311      would incorrectly calculate the ranks.  This has been corrected.
313  * The IMPORTCASES subcommand on GET DATA is now ignored, for
314    compatibility.
316 Changes from 0.8.4 to 0.8.5:
318  * The FREQUENCIES and CROSSTABS commands can now generate barcharts.
320  * The FACTOR command can now perform PROMAX rotations.
322  * SPSS/PC+ system files are now supported on GET and other commands
323    that read SPSS system files.  The pspp-convert program can now read
324    SPSS/PC+ system files.  Writing the obsolete SPSS/PC+ system file
325    format is not supported.
327  * SYSFILE INFO can now read SPSS/PC+ system files and SPSS portable
328    files.
330  * FREQUENCIES: A bug was fixed where an assertion failure occurred
331    when an empty dataset was presented.
333  * The GRAPH command is now available.  Initially it supports
334    scatterplots and histograms.
336  * The RND operator in expressions now supports additional operands
337    for rounding to values other than integers and to indicate a level
338    of rounding fuzz.  The default rounding fuzz may now be controlled
339    and displayed with SET FUZZBITS and SHOW FUZZBITS, respectively.
341 Changes from 0.8.3 to 0.8.4:
343  * Formatting of SYSFILE INFO output was made easier to read.
345  * Bug fixes, including the following notable ones:
347    - FREQUENCIES works properly for string variables.  (This bug was
348      introduced in 0.8.2.)
350    - CROSSTABS now correctly computes all of the measures that it
351      offers.  Some measures have been removed because they were not
352      computed correctly.
354    - The NPAR TESTS calculation of significance for the RUNS
355      subcommand has been corrected.
357    - Planned comparisons in ONEWAY ANOVA now correctly handle negative
358      T-values.
360    - The COUNT command now correctly treats missing values as
361      documented.
363    - Conformance fixes to Open Document output format.
365 Changes from 0.8.2 to 0.8.3:
367  * Independent T-Tests displayed the standard error of the difference
368    and the confidence interval for the unequal variances case, where
369    the equal variances case should have been.  This has been fixed.
371  * REGRESSION now recognises /STATISTICS=CI(x) which causes confidence
372    intervals for the coefficients to be printed.
374  * When DESCRIPTIVES calculates Z scores, it now omits cases filtered
375    by the current FILTER settings.
377  * PSPPIRE graphical user interface improvements:
379    - Dialog boxes with source  variable lists can now choose the sort
380      order;  right click and select from the popup menu.
382    - File|Open now allows an encoding to be selected for opening
383      system files.
385    - File|Display Data File Information|External File... now allows an
386      encoding to be selected.
388    - A problem with the Means dialog has been resolved (bug #41433).
390    - Several problems related to the input of spreadsheets have been
391      fixed (bug #41657, #41620
393  * System file related improvements:
395    - With ENCODING="DETECT", SYSFILE INFO can now help the user to
396      pick an encoding for reading a system file that does not identify
397      its own encoding
399    - SYSFILE INFO now accepts an ENCODING subcommand to specify the
400      character encoding of string data in the system file.
402    - Variable labels over 255 bytes long are now accepted without
403      truncation (bug #41863).
405    - System files that contain duplicate variable names may now be
406      read successfully (bug #41475).
408 Changes from 0.8.1 to 0.8.2:
410  * Charts are now rendered with colours from the Tango palette instead
411    of fully saturated primaries.
413  * Support for new system file variants:
415    - PSPP can now read and write ZCOMPRESSED system files, which
416      compress data much more effectively than older "compressed"
417      files.  (The older format is still supported.)
419    - PSPP can now decrypt encrypted system files, using the new
420      pspp-convert utility.  The encrypted system file format is
421      unacceptably insecure, so to discourage its use PSPP and PSPPIRE
422      do not directly read or write this format.
424  * Missing values for long string variables are now read from and
425    written to system files in an SPSS-compatible fashion.
427    (Earlier versions of PSPP that supported missing values for long
428    string variables wrote them to system files in an SPSS-incompatible
429    way.  To fix the problem, read the system file with this version of
430    PSPP and then save a new copy of it.)
432  * pspp-convert, a new standalone utility for converting SPSS system
433    and portable files to other formats, is now included.  The initial
434    version supports comma-separated value files as output format.
435    pspp-convert can also decrypt encrypted system files.
437  * Build changes:
439    - zlib is now a required dependency.  (Previously it was optional.)
441 Changes from 0.8.0 to 0.8.1:
443  * New commands:
445    - VARIABLE ROLE.
447  * Changes to existing commands:
449    - CROSSTABS: The requirement that one expected count must be less than five
450         before Fishers Exact Test will be reported has been removed.
452  * PSPPIRE graphical user interface improvements:
454    - A new set of icons has been contributed.
456    - Syntax windows now parse syntax in "auto" mode, which in practice
457      should mean that both "batch" and "interactive" syntax now works,
458      instead of just "interactive" syntax.
460    - The variable pane of data windows now include a Role column.
462  * Notable bug fixes:
464    - System files written by IBM SPSS 21 are now read without warnings.
466    - System files written by "VOXCO INTERVIEWER 4.3" are now read
467      without warnings.
469    - PSPPIRE should now more gracefully handle syntax files that contain
470      errors.
472 Changes from 0.6.2 to 0.8.0:
474  * New commands:
476    - ADD FILES
477    - CORRELATIONS
478    - DATAFILE ATTRIBUTES
479    - DATASET ACTIVATE
480    - DATASET CLOSE
481    - DATASET COPY
482    - DATASET DECLARE
483    - DATASET DISPLAY
484    - DATASET NAME
485    - LOGISTIC REGRESSION
486    - MATCH FILES
487    - MEANS
488    - MRSETS
489    - PRESERVE and RESTORE
490    - QUICK CLUSTER
491    - RELIABILITY
492    - ROC
493    - SAVE TRANSLATE to CSV and tab-delimited files
494    - UPDATE
495    - VARIABLE ATTRIBUTES
497  * Changes to existing commands:
499    - AUTORECODE has a new GROUP subcommand.
501    - CROSSTABS has been re-implemented to fix numerous bugs.
503    - EXAMINE: /MISSING=LISTWISE is now the default.
505    - DO REPEAT command has been reimplemented.  Now, when DO REPEAT
506      contains an INCLUDE or INSERT command, substitutions are not
507      applied to the included file.
509    - FILE HANDLE has a new ENDS subcommand to select CR or CRLF new-lines.
511    - HOST has been updated to use more modern syntax.
513    - Most commands that work with data files now support a new
514      ENCODING subcommand.
516    - MISSING VALUES can now assign missing values to long string
517      variables.
519    - ONEWAY: the POSTHOC subcommand is now implemented.
521    - The following new subcommands to NPAR TESTS have been implemented:
522      COCHRAN, FRIEDMAN, JONCKHEERE-TERPSTRA, KENDALL, KRUSKAL-WALLIS, MANN-WHITNEY,
523      MCNEMAR, SIGN, WILCOXON, and RUNS
525    - SET and SHOW no longer have ENDCMD, NULLINE, PROMPT, CPROMPT, and
526      DPROMPT subcommands.  The defaults are now fixed values.
528    - SHOW now has a JOURNAL subcommand, to show the location of the
529      journal file.
531    - VALUE LABELS can now assign value labels to long string
532      variables.
534  * Other language changes:
536    - The new DATASET commands replace the "scratch file" PSPP
537      extension, which is no longer supported.
539    - Strings may now include arbitrary Unicode code points specified
540      in hexadecimal, using the syntax U'hhhh'.  For example, Unicode
541      code point U+1D11E, the musical G clef character, may be
542      expressed as U'1D11E'.
544      See the "Tokens" section in the PSPP manual for more information.
546    - In previous versions of PSPP, in a string expressed in
547      hexadecimal with X'hh' syntax, the hexadecimal digits expressed
548      bytes in the locale encoding.  In this version of PSPP, X'hh'
549      syntax always expresses bytes in UTF-8 encoding.
551      See the "Tokens" section in the PSPP manual for more information.
553  * PSPPIRE graphical user interface improvements:
555    - Added support for non-ASCII characters in strings, labels and
556      variable names.
558    - A "Split Window" function is available, which makes it easier to
559      see different parts of a large data file.
561    - Data files can now be opened by specifing their name as the first
562      argument.  This means that on a properly configured desktop, double
563      clicking on an icon will open the file.
565    - Foreign formats, such as Gnumeric, OpenDocument and CSV can be imported
566      via using an "intelligent" application assistant dialog.
568  * Output changes:
570    - The new "cairo" output driver supports output in PostScript, PDF,
571      and SVG formats.  Its functionality is a superset of that of the
572      "postscript" driver, which has been removed.  You must have Cairo
573      and Pango installed to build the "cairo" driver.
575    - Charts are now produced with Cairo and Pango, instead of libplot.
576      Without them, the new graphing features will not work.  If you do
577      not have Cairo and Pango installed, you must run `configure' with
578      --without-cairo.
580    - The plain text output driver now properly supports multibyte UTF-8
581      characters, including double-width characters and combining
582      accents.
584    - Output to OpenDocument format is now supported.
586    - The HTML output is much improved.
588  * The "pspp" program has a new option --batch (or -b) that selects
589    "batch" syntax mode.  In previous versions of PSPP this syntax mode
590    was the default.  Now a new "auto" syntax mode is the default.  In
591    "auto" mode, PSPP interprets most syntax files correctly regardless
592    of their intended syntax mode.
594    See the "Syntax Variants" section in the PSPP manual for more
595    information.
597  * The "pspp" program has a new option --syntax-encoding that
598    specifies the encoding for syntax files listed on the command line,
599    as well as the default encoding for syntax files included with
600    INCLUDE or INSERT.  The default is to accept the system locale
601    encoding, UTF-8, UTF-16, or UTF-32, automatically detecting which
602    one the system file uses.
604    See the documentation for the INSERT command in the PSPP manual for
605    more information.
607  * Text data files that PRINT and WRITE creates now use the system
608    native line ends by default (CRLF on Windows, LF only elsewhere).
609    Use the new ENDS subcommand on FILE HANDLE to override the default.
611  * A new Perl module allows Perl programs to read and write PSPP
612    system files.
614  * A tutorial chapter has been added to the user manual.
616 Changes from 0.6.1 to 0.6.2:
618   * New translations:
620     - Dutch, thanks to Harry Thijssen.
622     - Brazilian Portuguese, thanks to Michel Boaventura.
624     Thanks for translations are also due to the coordinators at
625     translationproject.org.
627   * Statistical bug fixes:
629     - REGRESSION: Report correct standard error of the estimate (bug
630       #25677).
632     - T-TEST: Report correct significance of paired sample T-test in
633       the common case (bug #26936) and corner cases.  Thanks to Mike
634       Griffiths and Matej Cepl for reporting these bugs.
636   * Build fixes and changes:
638     - Fix build with GTK+ 2.17.4 and later.
640     - Make running "make" after running "configure" with different
641       settings reliably rebuild version.c.
643     - Cygwin and MinGW build fixes.
645     - Fixes for building with recent gnulib.
647     - The Makefile now honors two new variables, PSPP_LDFLAGS and
648       PSPPIRE_LDFLAGS, that affect linking of the PSPP and PSPPIRE
649       binaries, respectively.  This makes building easier for some
650       packagers.
652     - Fixes for "configure --enable-relocatable" (bug #25508).
654   * Data file bug fixes and changes:
656     - Fix reading text data files that contain a mix of white space
657       and commas.  Now "a ,b" is treated as two fields containing "a"
658       and "b"; previously it was treated as three, with an empty field
659       in the middle.
661     - Fix writing corrupted .sav files on Windows.
663     - Fix writing variable labels longer than 252 bytes to save files.
664       Thanks to Robert Westlund for reporting this bug.
666     - Fix writing corrupted .por files (bug #26034).
668     - Fix reading .por files whose initial lines are not padded out
669       with spaces as expected.
671     - PSPP will no longer issue warnings about some .sav file records
672       or values that it does not understand.  These warnings were
673       harmless, but needlessly alarmed some users.
675     - Fix crash reading empty string fields from PostgreSQL databases.
677   * Bug fixes that affect PSPP and PSPPIRE:
679     - Users may now control precision of output statistics.  Instead
680       of hard coding the width and decimals of output numbers, respect
681       the default format in most instances.  Counts are now normally
682       displayed with the format of the weight variable, if any.
684     - Fix crash when an INSERT command specifies the name of a file
685       that does not exist (bug #24569).
687     - Fix crash when CROSSTABS specifies a long-string variable (bugs
688       #24557 and #26131).
690     - Fix crash drawing pie charts with many segments.
692     - Fix crash when NUMERIC specifies an invalid format.
694   * PSPPIRE bug fixes and changes:
696     - On Windows, write the output file to the user's home directory
697       instead of the current directory, to better match user
698       expectations.
700     - Some data editor fixes.
702   * Documentation:
704     - Fix typo in BINOMIAL section of user manual (bug #25892).
706 Changes from 0.6.0 to 0.6.1:
708   * Statistical bug fixes:
710     - Report correct standardized regression coefficients in linear
711       regression output (bug #23567).
713   * Bug fixes that affect PSPP and PSPPIRE:
715     - Avoid crash with pie charts (bug #24014).
717     - Don't append % to count totals (bug #24003).
719     - Don't crash on bad input (bug #24031).
721     - Don't crash if "end data." is not left aligned (bug #24115).
723     - Change default workspace value to 64 MB, to avoid unnecessary
724       disk accesses on modern machines.
726   * PSPPIRE bug fixes:
728     - Add ".sav" or ".por" suffix to filename when saving with Save_As
729       (bug #23137).
731     - Make it possible to reopen the output window on Windows (bug
732       #24033).
734     - A POSIX regular expression library is now included and used
735       automatically if the host does not have one or has one that is
736       inadequate.
738   * Build fixes and changes:
740     - Work around bug in GSL that prevented build with recent GCC
741       versions without manually adding -fgnu89-inline to CFLAGS.
743     - Also warn about missing prerequisites as we encounter them (bug
744       #24445).
746     - Distribute necessary files to allow users working from the
747       distributed tarball to configure with --enable-gui-tools.
749     - Append $(EXEEXT_FOR_BUILD) to output file name when building
750       q2c, fixing build problems on Windows.
752     - GSL 1.8 or later is now required.
754     - Build errors with --enable-relocatable were fixed.
756   * The German translations were removed, since native German speakers
757     found them too poor to be useful.
759 Changes from 0.4.0 to 0.6.0:
761   * The PSPP license is now version 3 or later of the GNU General
762     Public License.  Previously, it was version 2 or later.
764   * PSPP now has a graphical interface, called PSPPIRE.  This
765     interface allows you to enter data and variable definitions
766     interactively.  Commands may be executed in syntax form, or by
767     using the interactive dialog boxes available from the dropdown
768     menus.
770   * A few sample syntax files are now included in the `examples'
771     directory.
773   * Numerous major and minor bugs have been fixed.
775   Build changes:
777     * The INSTALL file now reflects the details of how to install
778       PSPP.  It is a tailored version of the generic installation
779       instructions, instead of a verbatim copy.
781     * iconv, which is ordinarily installed as part of a Unix-like
782       system, is now required.  If you don't have it already, you can
783       install GNU libiconv (http://www.gnu.org/software/libiconv/).
785     * libxml2 and zlib are new optional dependencies.  They are
786       required to use PSPP's support for reading Gnumeric files.
788   Statistical procedure changes:
790     * REGRESSION is a new procedure for fitting linear models to data
791       via least-squares estimation.
793     * NPAR TESTS is a new procedure for non-parametric tests.  In this
794       release, it supports binomial and chi-square tests.
796     * RANK is a new procedure to rank variables.  It supports numerous
797       forms of ranking.
799     * FREQUENCIES can now output histograms and pie charts.  These
800       features were present in earlier releases, but not documented.
802   User interface changes:
804     * In many situations where PSPP once terminated with a fatal
805       error, PSPP now recovers and continues execution.
807     * PSPP is now able to start up and run even if it cannot find its
808       configuration files.
810     * Journaling of interactive commands to a disk file is now
811       implemented.  By default, journaling is enabled, to a file named
812       `pspp.jnl' in the current directory.  SET JOURNAL may be used to
813       control journaling.
815     * The use of `+' between syntax file names on the command line to
816       prevent the dictionary from being cleared between their
817       executions is no longer supported.  All syntax files are now
818       executed as if `+' had been specified.
820     * The -d/--define and -u/--undef command line options are no
821       longer supported.  Instead, use /usr/bin/env or shell primitives
822       to define or clear environment variables before invoking PSPP.
824     * If a syntax file named named `rc' is found in a configuration
825       directory (such as $HOME/.pspp), it is executed before any
826       syntax file specified on the command line.  The -r or
827       --no-statrc command line option may be used to disable this
828       behavior.
830   Output changes:
832     * Output configuration options have changed.  Please refer to the
833       manual for a full description of the available options.
835       In consequence, you will need to reinstall your "devices" file.
836       "make install" will do this for you.
838     * Most error messages are now written to PSPP output files by
839       default.  SET ERROR can be used to disable this behavior.
841     * When invoked interactively, PSPP now by default produces output
842       on the terminal, piping it through the "more" program.
843       Previously, by default output was written only to file
844       pspp.list.  On most terminals, the page length used for output
845       automatically adapts to the terminal size, even if the terminal
846       is resized.
848     * ASCII driver:
850       - This driver now supports charts in output.  Charts are written
851         as separate files that the main output file refers to.  By
852         default, charts are written in PNG format to files named
853         pspp-1.png, pspp-2.png, and so on.
855       - Configurations are provided that use VT100 (and xterm)
856         line-drawing characters in tables.  The option "-o list-vt100"
857         requests use of this device for output to pspp.list.
859     * PostScript driver:
861       - The default paper size is now determined using the PAPERSIZE
862         environment variable, or the LC_PAPER locale category on
863         systems that support it.  If these are not set, the default is
864         now A4, instead of US letter.  To make US letter the default,
865         set PAPERSIZE to "letter" in your environment.
867       - Font metrics are now read from AFM files, instead of
868         Groff-format metrics files.  PostScript fonts can now be
869         embedded in output.
871         In consequence, you will need to install an AFM file for each
872         font used in PostScript output.  "make install" will install
873         AFM files for the standard PostScript fonts, including the
874         ones that the PostScript driver uses by default.
876       - Standard paper sizes no longer need to be specified through a
877         configuration file.  The "papersize" configuration file is no
878         longer needed, or supported.
880       - The PostScript prologue is no longer obtained from the
881         "ps-prologue" configuration file.  This configuration file is
882         no longer needed, or supported.
884     * HTML driver:
886       - The HTML prologue is no longer obtained from the
887         "html-prologue" configuration file.  This configuration file
888         is no longer needed, or supported.
890   Command language changes:
892     * The following commands are new:
894       - GET DATA, which currently supports reading Gnumeric files and
895         text data files.  It will be extended later to read other
896         types of foreign data.
898       - CD, to change the current directory.
900       - INSERT, to execute a syntax file.
902       - DELETE VARIABLES, to remove variables from the active file
903         dictionary.
905       - ADD DOCUMENT, to add text to active file documents.
907       - CLOSE FILE HANDLE (a PSPP extension; see below).
909       - XEXPORT, a PSPP extension that is a transformation equivalent
910         to EXPORT.
912     * The following functions for transformation expressions are new:
914       - DATEDIFF, for computing the difference of two dates.
916       - DATESUM, for advancing a date by a specified duration.
918       - VALUELABEL, to obtain the value label for a value.
920     * PSPP now supports very long string variables (over 255 bytes
921       long).
923     * MATCH FILES now supports the FIRST and LAST subcommands.
925     * Previous versions of PSPP prohibited using commands to both read and
926       write a single file at the same time.  Now, PSPP allows this, and
927       the new version of the file atomically replaces the old version.
929     * The following commands are no longer available.  They will be
930       re-implemented in a later release:
932       - CLEAR TRANSFORMATIONS
934       - MATRIX DATA
936       - REPEATING DATA
938     * The PROCESS IF command, which was deprecated, has been removed.
939       You may replace any usage of it by SELECT IF following
940       TEMPORARY, which has the same effect.
942     * The output format for variables created by VECTOR may now be
943       specified as part of the VECTOR syntax.
945   "Scratch files", a new PSPP extension:
947     A scratch file, like a system file, consists of a dictionary and
948     any number of cases.  Small scratch files are stored in memory;
949     one that grows too large is written to disk.  By default, any file
950     handle whose name begins with # is assumed to refer to a scratch
951     file.
953     Scratch files can be used just about anywhere a system or portable
954     file can be used.  Also, portable files are now allowed in most
955     places that system files were allowed in previous PSPP version.
957     A new CLOSE FILE HANDLE command allows the storage associated with
958     scratch files to be freed.  It also allows file handles to be
959     reassigned to new files.
961     For more information on scratch files, refer to the "File Handles"
962     section in the PSPP manual.  For specifics of what commands now
963     allow what kinds of files to be specified, refer to the
964     documentation on those particular commands.
966   Data access changes:
968     * Binary formats and IBM/360 formats, including ASCII/EBCDIC
969       translation, are now supported.  Use FILE HANDLE to specify the
970       format of these files.
972     * Little-endian, big-endian, and VAX-endian formats are now
973       supported for integer binary formats when reading and writing
974       data files.  The new RIB and WIB subcommands on the SET command
975       control endianness of integer data.  The default is the host's
976       native endianness.
978     * IEEE 754, VAX, and IBM hexadecimal formats are now supported for
979       floating point binary formats when reading and writing data
980       files.  The new RRB and WRB subcommands on the SET command
981       control the floating point format.  The default is the host's
982       native floating point format.
984     * DATA LIST now supports the SKIP subcommand, to skip records at
985       the beginning of a file.  For compatibility, DATA LIST now
986       treats N format as F format for FREE and LIST format input.
988     * The SAVE and XSAVE commands now support the UNSELECTED,
989       PERMISSIONS, NAMES, and MAP subcommands.
991     * The EXPORT command has been re-implemented to obtain better
992       results.  Support for the UNSELECTED, DIGITS, and TYPE
993       subcommands has been added.
995     * For compatibility, PRINT now inserts a space at the beginning of
996       every output line, even lines that would otherwise be blank,
997       when OUTFILE is specified.  (The behavior of WRITE is
998       unchanged.)
1000     * For compatibility, PRINT EJECT now inserts the digit `1' at the
1001       beginning of each line that should begin a new page.
1003     * For compatibility, WRITE now outputs the system-missing value as
1004       a field filled with spaces.  Binary formats are an exception.
1005       (The behavior of PRINT is unchanged.)
1007   Documentation:
1009     * Input and output format descriptions have been rewritten.  They
1010       now precisely describe what is accepted on input and written on
1011       output.
1013     * The descriptions of the PSPP system and portable file formats
1014       have been extensively revised and improved.
1016   For developers, the build system now requires Autoconf 2.60 and
1017   Automake 1.10.
1019 Changes from 0.3.0 to 0.4.0:
1021   Changes in build dependencies:
1023     * The GNU Scientific Library (libgsl), version 1.6 or later, is
1024       now required.
1026     * libplot from GNU plotutils is optional.  Without it, the new
1027       graphing features will not work.  If you do not have it
1028       installed, you must run `configure' with --without-libplot.
1030     * libgmp2 is no longer a dependency.
1032   Newly implemented commands and statistical features:
1034     * EXAMINE, including its graphing features.
1036     * FREQUENCIES now supports percentiles.
1038     * ONEWAY.
1040     * PERMISSIONS.
1042     * SHOW.
1044     * SORT CASES now sorts stably, that is, two cases with equal sort
1045       criteria will be in the same relative order before and after the
1046       sort.
1048     * T-TEST (re-written).
1050     * DATE and USE.  These commands are parsed but otherwise ignored,
1051       to enhance compatibility with certain command files that invoke
1052       them unnecessarily.
1054     * VARIABLE WIDTH, VARIABLE ALIGNMENT, and VARIABLE LEVEL.  These
1055       currently have no effect on PSPP output, but their values are
1056       written to and read from system files and thus may affect
1057       third-party software.
1059     * SET EPOCH implemented.
1061     * DATA LIST FREE and DATA LIST LIST now support arbitrary field
1062       delimiters.
1064     * FILE HANDLE now supports custom tab widths.
1066   Long variable names (and other identifiers) are now supported.  Up
1067   to the first 64 bytes of each identifier is significant.  PSPP now
1068   reads and writes system files compatible with SPSS version 12.
1070   New --algorithm and --syntax command line options allow
1071   SPSS-compatible or enhanced modes to be selected.
1073   Support for transformation expressions has been rewritten and
1074   significantly improved.  Refer to the manual for details.
1076   Calculation of moments (mean, standard deviation, kurtosis,
1077   skewness) has been rewritten and should now be more accurate.  In
1078   --algorithm=enhanced mode moments may be more accurate than SPSS in
1079   some cases.
1081   Numerous bugs have been fixed, too many to mention here.  Many new
1082   tests have been added, leading to the discovery and fixing of many
1083   of these bugs.
1085   The ASCII output driver can now squeeze multiple blank lines into
1086   single blank lines.
1088   Much of the code has been rewritten and refactored.  It is now much
1089   cleaner.
1091   The FILE TYPE and REPEATING DATA commands have been disabled for
1092   this release because their implementations were deemed too buggy to
1093   be useful.  They will be fixed and replaced in a future release.
1095   New pspp-mode for Emacs (in pspp-mode.el).
1097   Added rudimentary command-line completion for interactive input.
1099   lib/julcal and lib/dcdflib are no longer used, so they have been
1100   removed.
1102   For developers, the build system now requires Autoconf 2.58 and
1103   Automake 1.7.  The included gettext has been updated to version
1104   0.12.1.
1106   Some reports state that Texinfo 4.8, the latest version, may be
1107   necessary to successfully format the documentation on some systems.
1109 Version 0.3.0 changes since 0.2.3:
1111   Bugs fixed:
1113     * Using alphanumeric variables in functions under AGGREGATE
1114       segfaulted.  Fixed.
1116     * Under certain circumstances, the final case would be omitted
1117       from the results of an AGGREGATE operation.  Fixed.
1119     * Undefined behavior was invoked by referencing a freed pointer
1120       under certain circumstances.  Fixed.
1122     * A wrong record size was displayed when paging the active file to
1123       disk.  Fixed.
1125     * Not having enough temporary space for sorting caused a core
1126       dump.  Fixed.
1128     * Syntax errors in function descriptions on AGGREGATE caused core
1129       dumps.  Fixed.
1131     * A null pointer was dereferenced, causing a core dump, when
1132       PERCENTILES was specified on FREQUENCIES.  This fixes the
1133       problem, but PSPP still doesn't calculate percentiles.
1135     * SORT always sorted in ascending order.  Fixed.
1137     * Some minor memory leaks in the expression parser were removed.
1139     * Many assertions fixed for strict ANSI C compliance.
1141   New features:
1143     * SET ECHO ON now implemented, but turned off by default.
1145     * PRINT specifier supported on END REPEAT.
1147   Other:
1149     * System libgmp2 library is used if installed instead of
1150       unconditionally using the included libgmp2 subset.
1152     * Extensive code cleanup, which continues.
1154     * Added CORRELATIONS command parser, but not implemented.
1156 Version 0.2.3 changes since 0.2.2:
1158   Bugs fixed:
1160     * SPLIT FILE with a string variable caused a core dump.  Fixed.
1162     * Nested INCLUDEs didn't work.  Fixed.
1164     * The MATCH FILES procedure set the values of variables not present
1165       to 0.  It should have been SYSMIS.  This is now fixed.
1167     * The REMARK command was too aggressive about skipping lines.  It
1168       didn't like being the last command in a file.
1170     * Comment parsing wasn't consistent with the rest of the code in its
1171       idea of where one command ends and another starts.  This meant
1172       that sometimes commands would be mysteriously ignored.  Thanks to
1173       Dr. Dirk Melcher <BZN-mdksh@t-online.de> for reporting this bug.
1175     * The TABLE subcommand on MATCH FILES worked only erratically at
1176       best.  This fixes it.  Thanks to Dr. Dirk Melcher
1177       <BZN-mdksh@t-online.de> for reporting this bug.
1179     * VARIABLE LABELS rejected a slash before the first variable
1180       specification, contradicting the documentation.  Thanks to Walter
1181       M. Gray <graywm@northernc.on.ca> for reporting this bug.
1183     * Because of an incorrect optimization in memory allocation,
1184       CROSSTABS sometimes segfaulted when asked to output multiple
1185       tables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1186       reporting this bug.
1188     * CROSSTABS didn't display value labels for column and row
1189       variables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1190       reporting this bug.
1192     * WRITE didn't write line ends.  Fixed.  Thanks to Dr. Dirk Melcher
1193       <BZN-mdksh@t-online.de> for reporting this bug.
1195     * The TABLE subcommand on MATCH FILES worked only erratically at
1196       best.  This fixes it.  Thanks to Dr. Dirk Melcher
1197       <BZN-mdksh@t-online.de> for reporting this bug.
1199     * VARIABLE LABELS rejected a slash before the first variable
1200       specification, contradicting the documentation.  Thanks to Walter
1201       M. Gray <graywm@northernc.on.ca> for reporting this bug.
1203     * Because of an incorrect optimization in memory allocation,
1204       CROSSTABS sometimes segfaulted when asked to output multiple
1205       tables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1206       reporting this bug.
1208     * CROSSTABS didn't display value labels for column and row
1209       variables.  Thanks to Walter M. Gray <graywm@northernc.on.ca> for
1210       reporting this bug.
1212     * WRITE didn't write line ends.  Fixed.  Thanks to Dr. Dirk Melcher
1213       <BZN-mdksh@t-online.de> for reporting this bug.
1215     * MATCH FILES corrupted memory and dumped core on some syntax
1216       errors.  Fixed.
1218     * MATCH FILES should set numeric values not available to the
1219       system-missing value, not to 0.  Thanks to Dr. Dirk Melcher
1220       <BZN-mdksh@t-online.de> for reporting this bug.
1222     * KEEP didn't work properly on the SAVE procedure.  Fixed.  Thanks
1223       to Ralf Geschke <ralf@kuerbis.org> for reporting this bug.
1225     * Memory leak fix.
1227     * Some systems didn't like the way open_file was coded.  Thanks to
1228       Hankin <hankin@rogue.consultco.com> for pointing this out.
1230     * The SAVE procedure didn't save long string variables properly.
1231       Fixed by this patch.  Thanks to Hankin
1232       <hankin@rogue.consultco.com> for this patch.
1234     * Minor documentation fixes for MATCH FILES.
1236 Version 0.2.2 changes since 0.2.1:
1238   Bugs fixed:
1240     * Fix behavior of PRINT SPACE for negative arguments.
1242     * Fix reading some unusual system files.
1244     * Fix LIST problems with very long variables.  Thanks to Hankin
1245       <hankin@dunno.com> for this bug report.
1247     * Fix problems with some string format specifiers.
1249     * Fix use of $CASENUM in expressions.  Thanks to Dirk Melcher
1250       <BZN-mdksh@t-online.de> for reporting this bug.
1252     * Additional DATA LIST FREE and DATA LIST LIST fixes.  Thanks to
1253       Hankin <hankin@dunno.com> again on this one.
1255     * Sometimes you may encounter a PSPP script that has to be
1256       interpreted in interactive mode.  Now you can use the -i flag to
1257       do this.
1259     * Warnings for egcs 1.1.1 cleaned up.  (However you'll get lots of
1260       `unused variable' warnings under gcc 2.7.2.3, fixing this will
1261       take more effort.)
1263     * Tests fixed.
1265     * The files in gmp need the internationalization directory in
1266       their include path.  Thanks to OKUJI Yoshinori
1267       <okuji@kuicr.kyoto-u.ac.jp> for pointing this out.
1269 Version 0.2.1 changes since 0.2.0:
1271   Bugs fixed:
1273     * Remember to include examples/ directory in distribution :-)
1275     * Fixed gmp compile problems for some non-i386 architectures.
1276       Thanks to Hans Olav Eggestad <olav@jordforsk.nlh.no> and others
1277       for reporting this.
1279     * DATA LIST FREE and DATA LIST LIST parsing of input files is now
1280       matches the documented behavior exactly, and error messages are
1281       more helpful.  Thanks to Mark H. Wood <mwood@IUPUI.Edu>.
1283 Version 0.2.0 changes since 0.1.0:
1285   Procedures now implemented:
1286     * CROSSTABS.  Please see documentation for caveats.
1288   Transformations and utilities now implemented:
1289     * AGGREGATE
1290     * APPLY DICTIONARY
1291     * CLEAR TRANSFORMATIONS
1292     * DISPLAY (all subcommands).
1293     * ERASE
1294     * FLIP
1295     * EXPORT
1296     * HOST
1297     * IMPORT
1298     * MATCH FILES
1299     * MATRIX DATA
1300     * NEW FILE
1301     * REPEATING DATA
1303   Support for input and output through pipes: "|command" and
1304   "command|" filenames; support for special filenames "-", "stdin",
1305   "stdout", "stderr".
1307   New command-line features:
1308     * New option --testing-mode: Invoke heuristics to assist testing.
1309     * New option --safer, -s: Don't allow certain unsafe operations.
1310     * New option --command=CMD, -c CMD: Perform literal command CMD.
1311     * rc file ~/.pspp/rc is executed before any other files.
1312     * Now multiple syntax files can be specified.
1314   Operator LAG is now implemented.
1316   Added missing FILE subcommand to REREAD.
1318   Table output manager completely rewritten.
1320   Device configuration file syntax changed.  You will need to
1321   reinstall your `devices' file.
1323   New output driver for HTML.
1325   PostScript driver and prologue simplified.
1327   Many bugs fixed.  General source-code cleanup.
1329   Added Texinfo documentation for:
1330     * PSPP system file format
1331     * PSPP portable file format
1332     * How to write input for q2c parser generator
1333     * HTML driver
1335   PSPP language is now fully documented.  Please report any
1336   inaccuracies or omissions in the documentation.
1338 Changes for version 0.1.0:
1340   First public release.  For changes from unreleased development
1341   versions, please see ONEWS.
1343 ----------------------------------------------------------------------
1344 Copyright information:
1346    Permission is granted to anyone to make or distribute verbatim
1347    copies of this document as received, in any medium, provided that
1348    the copyright notice and this permission notice are preserved, thus
1349    giving the recipient permission to redistribute in turn.
1351    Permission is granted to distribute modified versions of this
1352    document, or of portions of it, under the above conditions,
1353    provided also that they carry prominent notices stating who last
1354    changed them.
1356 Local variables:
1357 version-control: never
1358 mode: indented-text
1359 end: