From fb959134d9212901e350e0c651f4f463d6fb2cf9 Mon Sep 17 00:00:00 2001
From: "jan.nijtmans" <nijtmans@users.sourceforge.net>
Date: Wed, 24 Jan 2024 20:46:04 +0000
Subject: Backport doc/eval.n from 9.0, and fix missing .CE

---
 doc/eval.n | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/doc/eval.n b/doc/eval.n
index 9fc2ae4..448a459 100644
--- a/doc/eval.n
+++ b/doc/eval.n
@@ -23,7 +23,14 @@ fashion as the \fBconcat\fR command, passes the concatenated string to the
 Tcl interpreter recursively, and returns the result of that
 evaluation (or any error generated by it).
 Note that the \fBlist\fR command quotes sequences of words in such a
-way that they are not further expanded by the \fBeval\fR command.
+way that they are not further expanded by the \fBeval\fR command;
+for \fIany\fR values, $a, $b, and $c, these two lines are effectively
+equivalent:
+.PP
+.CS
+\fBeval\fR [list $a $b $c]
+$a $b $c
+.CE
 .SH EXAMPLES
 .PP
 Often, it is useful to store a fragment of a script in a variable and
@@ -74,6 +81,12 @@ However, the last line would now normally be written without
 .CS
 set var [linsert $var 0 {*}$args]
 .CE
+.PP
+or indeed like this:
+.PP
+.CS
+set var [list {*}$args {*}$var]
+.CE
 .SH "SEE ALSO"
 catch(n), concat(n), error(n), errorCode(n), errorInfo(n), interp(n), list(n),
 namespace(n), subst(n), uplevel(n)
-- 
cgit v0.12