]> git.eshelyaron.com Git - emacs.git/commitdiff
Move generalized variable `substring' doc to elisp manual
authorStefan Kangas <stefankangas@gmail.com>
Tue, 23 Aug 2022 18:27:56 +0000 (20:27 +0200)
committerStefan Kangas <stefankangas@gmail.com>
Tue, 23 Aug 2022 18:28:25 +0000 (20:28 +0200)
* doc/misc/cl.texi (Setf Extensions): Move documentation on
'substring' generalized variable from here...
* doc/lispref/variables.texi (Setting Generalized Variables):
...to here.

doc/lispref/variables.texi
doc/misc/cl.texi

index b7b4f56212fae03750946030b3c340e6cea0e366..aa308348051a2d0788a3b78a5beb98b99bda6333 100644 (file)
@@ -2695,6 +2695,30 @@ terminal-parameter            window-point
 keymap-parent                 window-start
 match-data                    default-value
 @end smallexample
+
+@item
+A call of the form @code{(substring @var{subplace} @var{n} [@var{m}])},
+where @var{subplace} is itself a valid generalized variable whose
+current value is a string, and where the value stored is also a
+string.  The new string is spliced into the specified part of the
+destination string.  For example:
+
+@example
+(setq a (list "hello" "world"))
+     @result{} ("hello" "world")
+(cadr a)
+     @result{} "world"
+(substring (cadr a) 2 4)
+     @result{} "rl"
+(setf (substring (cadr a) 2 4) "o")
+     @result{} "o"
+(cadr a)
+     @result{} "wood"
+a
+     @result{} ("hello" "wood")
+@end example
+
+@c FIXME?  Also 'eq'? (see gv.el)
 @end itemize
 
 @noindent
index be286bbabcd871941908796b49425fc819419780..a6747b1096a9df040b0f79c44c6de47cc6dd9bd9 100644 (file)
@@ -920,30 +920,6 @@ cl-caaar@dots{}cl-cddddr          cl-first@dots{}cl-tenth
 Note that for @code{cl-getf} (as for @code{nthcdr}), the list argument
 of the function must itself be a valid @var{place} form.
 
-@item
-A call of the form @code{(substring @var{subplace} @var{n} [@var{m}])},
-where @var{subplace} is itself a valid generalized variable whose
-current value is a string, and where the value stored is also a
-string.  The new string is spliced into the specified part of the
-destination string.  For example:
-
-@example
-(setq a (list "hello" "world"))
-     @result{} ("hello" "world")
-(cadr a)
-     @result{} "world"
-(substring (cadr a) 2 4)
-     @result{} "rl"
-(setf (substring (cadr a) 2 4) "o")
-     @result{} "o"
-(cadr a)
-     @result{} "wood"
-a
-     @result{} ("hello" "wood")
-@end example
-
-@c FIXME?  Also 'eq'? (see cl-lib.el)
-
 @c Currently commented out in cl.el.
 @ignore
 @item