From 8d952432c8b961e4e0891eb78620615a8ae14f05 Mon Sep 17 00:00:00 2001
From: Mark Wooding <mdw@distorted.org.uk>
Date: Thu, 26 May 2016 09:26:09 +0100
Subject: [PATCH] doc/syntax.tex: Mention superclass list is mandatory.

And discuss the difficulties of actually defining new root classes.
---
 doc/syntax.tex | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/syntax.tex b/doc/syntax.tex
index 15948cb..64b10f4 100644
--- a/doc/syntax.tex
+++ b/doc/syntax.tex
@@ -616,7 +616,10 @@ names, to distinguish them from other kinds of identifiers.
 
 The @<list>$[\mbox{@<identifier>}]$ names the direct superclasses for the new
 class.  It is an error if any of these @<identifier>s does not name a defined
-class.
+class.  The superclass list is required, and must not be empty; listing
+@|SodObject| as your class's superclass is a good choice if nothing else
+seems suitable.  It's not possible to define a \emph{root class} in the Sod
+language: you must use Lisp to do this, and it's quite involved.
 
 The @<properties> provide additional information.  The standard class
 properties are as follows.
-- 
2.11.0