work on docs

diff --git a/doc/automake.mk b/doc/automake.mk
index b90dbaa18df29d0351a3f973143d2592fa094379..7cc5595d2cb015cacb634c6a6c8f272a005ee9d5 100644 (file)
--- a/doc/automake.mk
+++ b/doc/automake.mk
@@ -129,6 +129,11 @@ FIGURE_SYNTAX = \
  doc/pspp-figures/ctables10.sps \
  doc/pspp-figures/ctables11.sps \
  doc/pspp-figures/ctables12.sps \
+ doc/pspp-figures/ctables13.sps \
+ doc/pspp-figures/ctables14.sps \
+ doc/pspp-figures/ctables15.sps \
+ doc/pspp-figures/ctables16.sps \
+ doc/pspp-figures/ctables17.sps \
  doc/pspp-figures/crosstabs.sps \
  doc/pspp-figures/descriptives.sps \
  doc/pspp-figures/flip.sps \

diff --git a/doc/pspp-figures/ctables13.sps b/doc/pspp-figures/ctables13.sps
new file mode 100644 (file)
index 0000000..723dbed
--- /dev/null
+++ b/doc/pspp-figures/ctables13.sps
@@ -0,0 +1,2 @@
+GET FILE='nhtsa.sav'.
+CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a.

diff --git a/doc/pspp-figures/ctables14.sps b/doc/pspp-figures/ctables14.sps
new file mode 100644 (file)
index 0000000..168d237
--- /dev/null
+++ b/doc/pspp-figures/ctables14.sps
@@ -0,0 +1,2 @@
+GET FILE='nhtsa.sav'.
+CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a /SLABELS POSITION=ROW.

diff --git a/doc/pspp-figures/ctables15.sps b/doc/pspp-figures/ctables15.sps
new file mode 100644 (file)
index 0000000..c8b86f7
--- /dev/null
+++ b/doc/pspp-figures/ctables15.sps
@@ -0,0 +1,2 @@
+GET FILE='nhtsa.sav'.
+CTABLES /TABLE=AgeGroup [TABLEPCT] /SLABELS VISIBLE=NO.

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

diff --git a/doc/pspp-figures/ctables17.sps b/doc/pspp-figures/ctables17.sps
new file mode 100644 (file)
index 0000000..590e600
--- /dev/null
+++ b/doc/pspp-figures/ctables17.sps
@@ -0,0 +1,4 @@
+GET FILE='nhtsa.sav'.
+*CTABLES /TABLE AgeGroup BY qns3a /CLABELS ROWLABELS=OPPOSITE.
+CTABLES /TABLE AgeGroup BY qns3a /CLABELS COLLABELS=OPPOSITE.
+

diff --git a/doc/statistics.texi b/doc/statistics.texi
index dfc3aad875bc3d32b5b12b81966700a2703c684c..be57f1a735d70f4df9cf410528d95f2ba8ce94a5 100644 (file)
--- a/doc/statistics.texi
+++ b/doc/statistics.texi
@@ -1371,6 +1371,86 @@ counts:
 @code{UVARIANCE} (``Unweighted Variance'')
 @end itemize
 
+@node CTABLES Statistics Positions and Labels
+@subsection Statistics Positions and Labels
+
+@display
+@t{/SLABELS}
+    [@t{POSITION=}@{@t{COLUMN} @math{|} @t{ROW} @math{|} @t{LAYER}@}]
+    [@t{VISIBLE=}@{@t{YES} @math{|} @t{NO}@}]
+@end display
+
+The @code{SLABELS} subcommand controls the position and visibility of
+summary statistics for the @code{TABLE} subcommand that it follows.
+
+@code{POSITION} sets the axis on which summary statistics appear.
+With @t{POSITION=COLUMN}, which is the default, each summary statistic
+appears in a column.  For example:
+
+@example
+CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a.
+@end example
+@psppoutput {ctables13}
+
+@noindent
+With @t{POSITION=ROW}, each summary statistic appears in a row, as
+shown below:
+
+@example
+CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a /SLABELS POSITION=ROW.
+@end example
+@psppoutput {ctables14}
+
+@noindent
+@t{POSITION=LAYER} is also available to place each summary statistic in
+a separate layer.
+
+Labels for summary statistics are shown by default.  Use
+@t{VISIBLE=NO} to suppress them.  Because unlabeled data can cause
+confusion, it should only be considered if the meaning of the data is
+evident, as in a simple case like this:
+
+@example
+CTABLES /TABLE=AgeGroup [TABLEPCT] /SLABELS VISIBLE=NO.
+@end example
+@psppoutput {ctables15}
+
+@node CTABLES Category Label Positions
+@subsection Category Label Positions
+
+@display
+@t{/CLABELS} @{@t{AUTO} @math{|} @{@t{ROWLABELS}@math{|}@t{COLLABELS}@}@t{=}@{@t{OPPOSITE}@math{|}@t{LAYER}@}@}
+@end display
+
+The @code{CLABELS} subcommand controls the position of category
+labels.  By default, category labels for a given variable nest inside
+the variable's label on the same axis.  For example, the command below
+results in age categories nesting within the age group variable on the
+rows axis and gender categories within the gender variable on the
+columns axis:
+
+@example
+CTABLES /TABLE AgeGroup BY qns3a.
+@end example
+@psppoutput {ctables16}
+
+With @t{ROWLABELS=OPPOSITE} or @t{COLLABELS=OPPOSITE}, row or column
+variable labels, respectively, move to the opposite axis.  Only one
+axis's labels may be moved, and the setting affects only the innermost
+variable on the given axis.  For example:
+
+@example
+CTABLES /TABLE AgeGroup BY qns3a /CLABELS ROWLABELS=OPPOSITE.
+CTABLES /TABLE AgeGroup BY qns3a /CLABELS COLLABELS=OPPOSITE.
+@end example
+@psppoutput {ctables17}
+
+@node CTABLES Per-Variable Category Options
+@subsection Per-Variable Category Options
+
+@node CTABLES Titles
+@subsection Titles
+
 @node FACTOR
 @section FACTOR