From: Steinar H. Gunderson <sgunderson@bigfoot.com>
Date: Fri, 19 Jul 2019 21:48:56 +0000 (+0200)
Subject: Document number of inputs for alternatives.
X-Git-Url: https://git.sesse.net/?p=nageru-docs;a=commitdiff_plain;h=b9f9ca1fbd67c405084615acc7fff044738417ac

Document number of inputs for alternatives.
---

diff --git a/theme.rst b/theme.rst
index 3fa5873..d43687f 100644
--- a/theme.rst
+++ b/theme.rst
@@ -184,7 +184,10 @@ directly by the GPU) that instead. The scaling is set up like this::
   -- Or by numerical index:
   input0_scaled:choose(1)  -- Chooses ResizeEffect
 
-Note that add_effect returns its input for convenience.
+Note that add_effect returns its input for convenience. All alternatives must
+have the same amount of inputs, with an exception for IdentityEffect, which can
+coexist with an effect requiring any amount of inputs (if selected, the IdentityEffect
+just passes its first input unchanged).
 
 Actually, add_optional_effect() is just a wrapper around add_effect() with
 IdentityEffect as the other alternative, and disable() is a convenience version of