[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master cb67c34bcfe: Omit `store-substring` from lisp manual (bug#70784)
From: |
Mattias Engdegård |
Subject: |
master cb67c34bcfe: Omit `store-substring` from lisp manual (bug#70784) |
Date: |
Sat, 25 May 2024 06:55:23 -0400 (EDT) |
branch: master
commit cb67c34bcfe525cbab75d7af8c6e6244d61eb228
Author: Mattias Engdegård <mattiase@acm.org>
Commit: Mattias Engdegård <mattiase@acm.org>
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.
---
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- master cb67c34bcfe: Omit `store-substring` from lisp manual (bug#70784),
Mattias Engdegård <=