Merge topic 'doc_clarify_list_pop' into release-3.22

67f8d20a8e Help: clarify list(POP_* <in_out> <in_out>) behavior

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6620

1 files changed, 6 insertions, 4 deletions

diff --git a/Help/command/list.rst b/Help/command/list.rst
index f46641f..9b49cb4 100644
--- a/Help/command/list.rst
+++ b/Help/command/list.rst
@@ -161,8 +161,9 @@ Inserts elements to the list to the specified location.
 .. versionadded:: 3.15
 
 If no variable name is given, removes exactly one element. Otherwise,
-assign the last element's value to the given variable and removes it,
-up to the last variable name given.
+with `N` variable names provided, assign the last `N` elements' values
+to the given variables and then remove the last `N` values from
+``<list>``.
 
 .. _POP_FRONT:
 
@@ -173,8 +174,9 @@ up to the last variable name given.
 .. versionadded:: 3.15
 
 If no variable name is given, removes exactly one element. Otherwise,
-assign the first element's value to the given variable and removes it,
-up to the last variable name given.
+with `N` variable names provided, assign the first `N` elements' values
+to the given variables and then remove the first `N` values from
+``<list>``.
 
 .. _PREPEND: