Docment how CLABELS can affect calculations.

diff --git a/doc/automake.mk b/doc/automake.mk
index e99b82c6ee518e5b3aa4d645d164c84e775eac53..daf47cf975d5e3f55cd5ce545d2b26989ea1fc61 100644 (file)
--- a/doc/automake.mk
+++ b/doc/automake.mk
@@ -139,6 +139,8 @@ FIGURE_SYNTAX = \
  doc/pspp-figures/ctables20.sps \
  doc/pspp-figures/ctables21.sps \
  doc/pspp-figures/ctables22.sps \
  doc/pspp-figures/ctables20.sps \
  doc/pspp-figures/ctables21.sps \
  doc/pspp-figures/ctables22.sps \

+ doc/pspp-figures/ctables23.sps \
+ doc/pspp-figures/ctables24.sps \

  doc/pspp-figures/crosstabs.sps \
  doc/pspp-figures/descriptives.sps \
  doc/pspp-figures/flip.sps \
  doc/pspp-figures/crosstabs.sps \
  doc/pspp-figures/descriptives.sps \
  doc/pspp-figures/flip.sps \

diff --git a/doc/pspp-figures/ctables23.sps b/doc/pspp-figures/ctables23.sps
new file mode 100644 (file)
index 0000000..df37390
--- /dev/null
+++ b/doc/pspp-figures/ctables23.sps
@@ -0,0 +1,2 @@
+GET FILE='nhtsa.sav'.
+CTABLES /TABLE AgeGroup BY qns3a [ROWPCT, COLPCT].

diff --git a/doc/pspp-figures/ctables24.sps b/doc/pspp-figures/ctables24.sps
new file mode 100644 (file)
index 0000000..7a12c08
--- /dev/null
+++ b/doc/pspp-figures/ctables24.sps
@@ -0,0 +1,4 @@
+GET FILE='nhtsa.sav'.
+CTABLES
+    /TABLE AgeGroup BY qns3a [ROWPCT, COLPCT]
+    /CLABELS COLLABELS=OPPOSITE.

diff --git a/doc/statistics.texi b/doc/statistics.texi
index 7ac4191bb880d5b90d63c23bc99aa671af211ef9..2e133dd651ad3ded4525ef91f655ba6c1abd1344 100644 (file)
--- a/doc/statistics.texi
+++ b/doc/statistics.texi
@@ -1500,6 +1500,33 @@ column variable category labels, respectively, to the layer axis.
 Only one axis's labels may be moved, whether to the opposite axis or
 to the layer axis.
 
 Only one axis's labels may be moved, whether to the opposite axis or
 to the layer axis.
 

+@subsubheading Effect on Summary Statistics
+
+@code{CLABELS} primarily affects the appearance of tables, not the
+data displayed in them.  However, @code{CTABLES} can affect the values
+displayed for statistics that summarize areas of a table, since it can
+change the definitions of these areas.
+
+For example, consider the following syntax and output:
+
+@example
+CTABLES /TABLE AgeGroup BY qns3a [ROWPCT, COLPCT].
+@end example
+@psppoutput {ctables23}
+
+@noindent
+Using @code{COLLABELS=OPPOSITE} changes the definitions of rows and
+columns, so that column percentages display what were previously row
+percentages and the new row percentages become meaningless (because
+there is only one cell per row):
+
+@example
+CTABLES
+    /TABLE AgeGroup BY qns3a [ROWPCT, COLPCT]
+    /CLABELS COLLABELS=OPPOSITE.
+@end example
+@psppoutput {ctables24}
+

 @node CTABLES Per-Variable Category Options
 @subsection Per-Variable Category Options
 
 @node CTABLES Per-Variable Category Options
 @subsection Per-Variable Category Options