work on docs
authorBen Pfaff <bpfaff@vmware.com>
Fri, 25 Feb 2022 01:02:05 +0000 (17:02 -0800)
committerBen Pfaff <blp@cs.stanford.edu>
Sat, 2 Apr 2022 01:48:55 +0000 (18:48 -0700)
doc/statistics.texi

index 06e8f94aaf002f631ae0c1141d2ef53b0b6e61c6..c7abe4d88d4cb94a88a9e098913bdaa07656f486 100644 (file)
@@ -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