From: Ben Pfaff <blp@cs.stanford.edu>
Date: Wed, 17 Aug 2022 06:05:10 +0000 (-0700)
Subject: docs
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?p=pspp;a=commitdiff_plain;h=915ae62e6caddda59ac7c7b5e373fcb9b8da8a22

docs
---

diff --git a/doc/automake.mk b/doc/automake.mk
index daf47cf975..c39efe933a 100644
--- a/doc/automake.mk
+++ b/doc/automake.mk
@@ -141,6 +141,7 @@ FIGURE_SYNTAX = \
  doc/pspp-figures/ctables22.sps \
  doc/pspp-figures/ctables23.sps \
  doc/pspp-figures/ctables24.sps \
+ doc/pspp-figures/ctables25.sps \
  doc/pspp-figures/crosstabs.sps \
  doc/pspp-figures/descriptives.sps \
  doc/pspp-figures/flip.sps \
diff --git a/doc/pspp-figures/ctables25.sps b/doc/pspp-figures/ctables25.sps
new file mode 100644
index 0000000000..1cdc258809
--- /dev/null
+++ b/doc/pspp-figures/ctables25.sps
@@ -0,0 +1,5 @@
+GET FILE='nhtsa.sav'.
+CTABLES /TABLE (qn105ba + qn105bb) [COLPCT].
+CTABLES /TABLE (qn105ba + qn105bb) [ROWPCT]
+  /CLABELS ROW=OPPOSITE.
+
diff --git a/doc/statistics.texi b/doc/statistics.texi
index 927e27e008..473e57aeb2 100644
--- a/doc/statistics.texi
+++ b/doc/statistics.texi
@@ -1186,7 +1186,6 @@ CTABLES /TABLE=AgeGroup [COLPCT 'Gender %' PCT5.0,
 @end example
 @psppoutput {ctables11}
 
-@c TODO special CTABLES formats
 In addition to the standard formats, @code{CTABLES} allows the user to
 specify the following special formats:
 
@@ -1462,6 +1461,8 @@ counts:
 @code{UVARIANCE} (``Unweighted Variance'', F40.0)
 @end itemize
 
+@c TODO missing value treatment
+
 @node CTABLES Statistics Positions and Labels
 @subsection Statistics Positions and Labels
 
@@ -1528,8 +1529,8 @@ CTABLES /TABLE AgeGroup BY qns3a.
 
 @t{ROWLABELS=OPPOSITE} or @t{COLLABELS=OPPOSITE} move row or column
 variable category labels, respectively, to the opposite axis.  The
-setting affects only the innermost variable on the given axis.  For
-example:
+setting affects only the innermost variable or variables, which must
+be categorical, on the given axis.  For example:
 
 @example
 CTABLES /TABLE AgeGroup BY qns3a /CLABELS ROWLABELS=OPPOSITE.
@@ -1543,8 +1544,6 @@ 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.
 
-@c TODO Moving category labels for stacked variables
-
 @subsubheading Effect on Summary Statistics
 
 @code{CLABELS} primarily affects the appearance of tables, not the
@@ -1572,6 +1571,23 @@ CTABLES
 @end example
 @psppoutput {ctables24}
 
+@subsubheading Moving Categories for Stacked Variables
+
+If @code{CLABELS} moves category labels from an axis with stacked
+variables, the variables that are moved must have the same category
+specifications (@pxref{CTABLES Per-Variable Category Options}) and the
+same value labels.
+
+The following shows both moving stacked category variables and
+adapting to the changing definitions of rows and columns:
+
+@example
+CTABLES /TABLE (qn105ba + qn105bb) [COLPCT].
+CTABLES /TABLE (qn105ba + qn105bb) [ROWPCT]
+  /CLABELS ROW=OPPOSITE.
+@end example
+@psppoutput {ctables25}
+
 @node CTABLES Per-Variable Category Options
 @subsection Per-Variable Category Options