From 4faea17df1052a4c4f44f75b6ed537ebe9598c24 Mon Sep 17 00:00:00 2001
From: Mark Wooding <mdw@distorted.org.uk>
Date: Sat, 3 Aug 2019 16:08:25 +0100
Subject: [PATCH] doc/structures.tex: Mention that the Sod examples are
 fictitious.

---
 doc/structures.tex | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/structures.tex b/doc/structures.tex
index 4940ca6..f000af0 100644
--- a/doc/structures.tex
+++ b/doc/structures.tex
@@ -87,6 +87,12 @@ metaclass, and @|SodClass| is a subclass of @|SodObject|.  Extensions can
 define additional root classes, but this is tricky, and not really to be
 recommended.
 
+The class definitions shown in the synopses are intended to be informative,
+but are fictional and can't really work: these classes are really defined by
+Lisp code in the Sod translator, in order to deal with the circularities
+involved at the top of the class/metaclass graph (see
+\xref{sec:concepts.metaclasses.runtime}).
+
 
 \subsection{The SodObject class} \label{sec:structures.root.sodobject}
 
-- 
2.11.0

