Add lots of comments. Some minor substantive changes too:

[pspp-builds.git] / src / data / casegrouper.h

diff --git a/src/data/casegrouper.h b/src/data/casegrouper.h
index e0a0e487d059f956bbfb1085c4dac12077b132b8..5f686ff99027b814c6bef09ec91789aec29a033a 100644 (file)
--- a/src/data/casegrouper.h
+++ b/src/data/casegrouper.h
@@ -16,6 +16,13 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
    02110-1301, USA. */
 
+/* Casegrouper.
+
+   Breaks up the cases from a casereader into sets of contiguous
+   cases based on some criteria, e.g. sets of cases that all have
+   the same values for some subset of variables.  Each set of
+   cases is made available to the client as a casereader. */
+
 #ifndef DATA_CASEGROUPER_H
 #define DATA_CASEGROUPER_H 1
 
@@ -36,7 +43,7 @@ casegrouper_create_func (struct casereader *,
                          void (*destroy) (void *aux),
                          void *aux);
 struct casegrouper *casegrouper_create_vars (struct casereader *,
-                                             struct variable *const *vars,
+                                             const struct variable *const *vars,
                                              size_t var_cnt);
 struct casegrouper *casegrouper_create_splits (struct casereader *,
                                                const struct dictionary *);