From eaf0eb4f9e8521872d9eae59eb8a63eff9795064 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Mattias=20Engdeg=C3=A5rd?= Date: Sat, 25 May 2024 12:20:30 +0200 Subject: [PATCH] Omit `store-substring` from lisp manual (bug#70784) * doc/lispref/strings.texi (Modifying Strings): Remove `store-substring` which is not really useful enough to merit a mention here. (cherry picked from commit cb67c34bcfe525cbab75d7af8c6e6244d61eb228) --- doc/lispref/strings.texi | 18 +----------------- 1 file changed, 1 insertion(+), 17 deletions(-) diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi index 7f640255a7a..6e5c3521135 100644 --- a/doc/lispref/strings.texi +++ b/doc/lispref/strings.texi @@ -473,28 +473,12 @@ needed, but we recommend to always make sure @var{string} is multibyte Representations}), if @var{char} is a non-@acronym{ASCII} character, not a raw byte. - A more powerful function is @code{store-substring}: - -@defun store-substring string idx obj -This function alters part of the contents of the specified @var{string}, -by storing @var{obj} starting at character index @var{idx}. The -argument @var{obj} may be either a character (in which case the function -behaves exactly as @code{aset}) or a (smaller) string. If @var{obj} -is a multibyte string, we recommend to make sure @var{string} is also -multibyte, even if it's pure-@acronym{ASCII}. - -Since it is impossible to change the number of characters in an -existing string, it is an error if @var{obj} consists of more -characters than would fit in @var{string} starting at character index -@var{idx}. -@end defun - To clear out a string that contained a password, use @code{clear-string}: @defun clear-string string This makes @var{string} a unibyte string and clears its contents to -zeros. It may also change @var{string}'s length. +null characters. It may also change @var{string}'s length. @end defun @need 2000 -- 2.39.5