From b3a249c2cb90dc462316e69ccb4a9c7b5ba14618 Mon Sep 17 00:00:00 2001
From: Adriaan de Groot <groot@kde.org>
Date: Tue, 21 Dec 2021 15:37:38 +0100
Subject: Help: clarify range for list(INSERT), mention nonexistent / empty
 case

---
 Help/command/list.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/Help/command/list.rst b/Help/command/list.rst
index bd8277d..621eeb4 100644
--- a/Help/command/list.rst
+++ b/Help/command/list.rst
@@ -152,7 +152,12 @@ For more information on regular expressions look under
 
   list(INSERT <list> <element_index> <element> [<element> ...])
 
-Inserts elements to the list to the specified index.
+Inserts elements to the list to the specified index. It is an
+error to specify an out-of-range index. Valid indexes are 0 to `N`
+where `N` is the length of the list, inclusive. An empty list
+has length 0. If no variable named ``<list>`` exists in the
+current scope its value is treated as empty and the elements are
+inserted in that empty list.
 
 .. _POP_BACK:
 
-- 
cgit v0.12