From 1a2cf43290b29aafe57cbfc2dd776a3c15a59e20 Mon Sep 17 00:00:00 2001
From: Marko Lindqvist <cazfi74@gmail.com>
Date: Sun, 11 Jan 2026 10:11:11 +0200
Subject: [PATCH 64/64] README.graphics: Add a word about animations

See RM #1899

Signed-off-by: Marko Lindqvist <cazfi74@gmail.com>
---
 doc/README.graphics | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/README.graphics b/doc/README.graphics
index bc7385413c..5344fb2b9d 100644
--- a/doc/README.graphics
+++ b/doc/README.graphics
@@ -372,6 +372,22 @@ graphics. (The basic size may vary, as specified in the top-level
 tilespec file, but the individual tiles should be consistent with
 those sizes and/or the usage of those graphics.)
 
+----------------------------------------------------------------------
+Animations
+----------
+
+Some 'sprites' listed in the following section are actually animations.
+Work to turn single sprite support to animation support is ongoing.
+You can't have animation where a single sprite is expected, nor can
+you have a single sprite tag where animation is expected.
+However, you can of course have a single frame animation that acts
+exactly as a single sprite.
+Animations consist of tags suffixed with ":<frame number>"
+The very first frame (":0") is needed for the animation to exist
+at all - if the animation is mandatory, the client will refuse
+to start without that tag. More frame tags (":1", ":2" ...) can be
+added at will, and the animation will be shown accordingly.
+
 ----------------------------------------------------------------------
 Sprites
 -------
-- 
2.51.0

