From 919daf4b00ff2072c0fc957ae8554d047336f984 Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Thu, 24 Feb 2022 17:02:05 -0800 Subject: [PATCH] work on docs --- doc/statistics.texi | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/doc/statistics.texi b/doc/statistics.texi index 06e8f94aaf..c7abe4d88d 100644 --- a/doc/statistics.texi +++ b/doc/statistics.texi @@ -911,10 +911,22 @@ person's occupation. @display @t{CTABLES} @dots{}@i{global subcommands}@dots{} - [@t{/TABLE} @i{rows} @t{BY} @i{columns} @t{BY} @i{layers} + [@t{/TABLE} @i{axis} [@t{BY} @i{axis} [@t{BY} @i{axis}]] @dots{}@i{per-table subcommands}@dots{}]@dots{} @end display +@noindent +where each @i{axis} may be empty or take one of the following forms: + +@display +@i{variable} +@i{variable} @t{[}@{@t{C} @math{|} @t{S}@}@t{]} +@i{axis} + @i{axis} +@i{axis} > @i{axis} +(@i{axis}) +@i{axis} @t{(}@i{summary} [@i{string}] [@i{format}]@t{)} +@end display + The following subcommands precede the first @code{TABLE} subcommand and apply to all of the output tables. All of these subcommands are optional: @@ -975,6 +987,17 @@ previous @code{TABLE}. All of these subcommands are optional: [@t{SHOWSIG=}@{@t{NO} @math{|} @t{YES}@}] @end display +The @code{CTABLES} (aka ``custom tables'') command outputs +multi-dimensional tables, offering many options for table +summarization and formatting. + +@code{TABLE}, the only required subcommand, specifies the variables to +include on each dimension, using the syntax @t{/TABLE} @i{rows} @t{BY} +@i{columns} @t{BY} @i{layers}, in which @i{rows}, @i{columns}, and +@i{layers} is each empty or an @i{axis}. The simplest form of +@i{axis} is just a variable name. + + @node FACTOR @section FACTOR -- 2.30.2