sys-file-reader, sys-file-writer: Fix encoding problems for mrsets.
[pspp-builds.git] / README
1 PSPP is a program for statistical analysis of sampled data. It
2 is a free replacement for the proprietary program SPSS.
3
4 PSPP development is ongoing. It already supports a large subset of
5 SPSS's syntax.  Its statistical procedure support is currently
6 limited, but growing.  At your option, PSPP will produce statistical
7 reports in ASCII, PostScript, PDF, HTML, SVG, or OpenDocument formats. 
8
9 Instructions for PSPP installation are in INSTALL, including a list of
10 prerequisite packages and other PSPP-specific information.  Full
11 documentation  on PSPP's language will be installed along with the
12 programs. 
13
14 For information on differences from previous versions, please see file
15 NEWS.  
16           
17 Source code for the latest release of PSPP is available at
18 ftp://ftp.gnu.org/pub/gnu/pspp/.  Older versions may be obtained from
19 ftp://alpha.gnu.org/gnu/pspp/.  Development sources are available
20 at http://savannah.gnu.org/projects/pspp
21
22 The following miscellaneous notes apply to this release:
23
24         * On a few operating systems, such as OpenBSD, some of the
25           tests may fail with messages similar to: 'Warning: cannot
26           create a convertor for "646" to "UTF-8"'.  These test
27           failures may safely be ignored.
28
29 Questions and comments about using PSPP may be sent to pspp-users@gnu.org.
30 Bug reports may be filed at http://savannah.gnu.org/bugs/?group=pspp
31 or emailed to bug-gnu-pspp@gnu.org.  We prefer the web-based system
32 because it makes it more difficult for us to lose track of bugs, but we
33 are happy to hear from users through any means.
34
35 The long term goals for PSPP are ambitious.  We wish to provide the
36 following support to users:
37
38         * All of the SPSS transformation language.  PSPP already
39           supports a large subset of it.
40
41         * All the statistical procedures that someone is willing to
42           implement, whether they exist in SPSS or not.
43
44         * Compatibility with SPSS syntax, including compatibility with
45           known bugs and warts, where it makes sense.  We also provide
46           an "enhanced" mode in certain cases where PSPP can output
47           better results that may surprise SPSS users.
48
49         * Friendly textual and graphical interfaces.  This release
50           includes the first version of PSPPIRE, the PSPP graphical
51           user interface.
52
53         * Attractive output, including graphs, in a variety of human-
54           and machine-readable formats.  PSPP currently produces
55           output in ASCII, PostScript, PDF, HTML, and SVG formats.  We
56           will enhance PSPP's output formatting in the future.
57
58         * Good documentation.  Currently the PSPP manual describes its
59           language completely, but we would like to add information on
60           how to select statistical procedures and interpret their
61           results.
62
63         * Efficient support for very large data sets.  For procedures
64           where it is practical, we wish to efficiently support data
65           sets many times larger than physical memory.  The framework
66           for this feature is already in place. It has not been tuned
67           or extensively tested, however initial experience has given
68           impressive results.
69
70 Over the long term, we also wish to provide support to developers who
71 wish to extend PSPP with new statistical procedures, by supplying the
72 following:
73
74         * Easy-to-use support for parsing language syntax.  Currently,
75           parsing is done by writing "recursive descent" code by hand,
76           with some support for automated parsing of the most common
77           constructs.  We wish to improve the situation by supplying a
78           more complete and flexible parser generator.
79
80         * Easy-to-use support for producing attractive output.
81           Currently, output is done by writing code to explicitly fill
82           in table cells with data.  We should be able to supply a
83           more convenient interface that also allows for providing
84           machine-readable output.
85
86         * Eventually, a plug-in interface for procedures.  Over the
87           short term, the interface between the PSPP core and
88           statistical procedures is evolving quickly enough that a
89           plug-in model does not make sense.  Over the long term, it
90           may make sense to introduce plug-ins.
91
92 For any copyright year range specified as YYYY-ZZZZ in this package note
93 that the range specifies every single year in that closed interval.