docs

diff --git a/doc/automake.mk b/doc/automake.mk
index daf47cf975d5e3f55cd5ce545d2b26989ea1fc61..c39efe933a43dd6e4d50c30b6dfb15a0c90c94cb 100644 (file)
--- 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/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 \
  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 (file)
index 0000000..1cdc258
--- /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 927e27e008f8c769aab1bd7f21115b1028ccb4b3..473e57aeb238bce42934774dc683834662a4eeb2 100644 (file)
--- a/doc/statistics.texi
+++ b/doc/statistics.texi
@@ -1186,7 +1186,6 @@ CTABLES /TABLE=AgeGroup [COLPCT 'Gender %' PCT5.0,
 @end example
 @psppoutput {ctables11}
 
 @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:
 
 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
 
 @code{UVARIANCE} (``Unweighted Variance'', F40.0)
 @end itemize
 

+@c TODO missing value treatment
+

 @node CTABLES Statistics Positions and Labels
 @subsection Statistics Positions and Labels
 
 @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
 
 @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.
 
 @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.
 
 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
 @subsubheading Effect on Summary Statistics
 
 @code{CLABELS} primarily affects the appearance of tables, not the


@@ -1572,6 +1571,23 @@ CTABLES
 @end example
 @psppoutput {ctables24}
 
 @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
 
 @node CTABLES Per-Variable Category Options
 @subsection Per-Variable Category Options