From: Ben Pfaff <bpfaff@vmware.com>
Date: Fri, 25 Feb 2022 01:02:05 +0000 (-0800)
Subject: work on docs
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?p=pspp;a=commitdiff_plain;h=60b749cb3e39789ba69930085eb1deec2b24330e

work on docs
---

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