(Modifying Strings): Add clear-string.

(Text Comparison): Add assoc-string and remove
assoc-ignore-case, assoc-ignore-representation.

diff --git a/lispref/strings.texi b/lispref/strings.texi
index acab7286d0dd632b42ec8d6fc5fca98157903a79..7cc182cc0581a2f4181bfbbfc715f64f9b387b51 100644 (file)
--- a/lispref/strings.texi
+++ b/lispref/strings.texi
@@ -377,6 +377,14 @@ Since it is impossible to change the length of an existing string, it is
 an error if @var{obj} doesn't fit within @var{string}'s actual length,
 or if any new character requires a different number of bytes from the
 character currently present at that point in @var{string}.
+@end defun
+
+  To clear out a string that contained a password, use
+@code{clear-string}:
+
+@defun clear-string string
+This clears the contents of @var{string} to zeros
+and may change its length.
 @end defun
 
 @need 2000
@@ -518,13 +526,10 @@ two strings.  The sign is negative if @var{string1} (or its specified
 portion) is less.
 @end defun
 
-@defun assoc-ignore-case key alist
-@defunx assoc-ignore-representation key alist
-These functions work like @code{assoc}, except that @var{key} must be
-a string, all elements of @var{alist} must be cons cells whose
-@sc{car} is a string, and comparison is done using
-@code{compare-strings}.  @code{assoc-ignore-case} ignores case
-differences, whereas @code{assoc-ignore-representation} does not.
+@defun assoc-string key alist &optional case-fold
+This function works like @code{assoc}, except that @var{key} must be a
+string, and comparison is done using @code{compare-strings}.  If
+@var{case-fold} is non-@code{nil}, it ignores case differences.
 @xref{Association Lists}.
 @end defun