(Modifying Strings): Clarify that `clear-string' always

[gnu-emacs] / lispref / strings.texi

diff --git a/lispref/strings.texi b/lispref/strings.texi
index 12abc38ee02efe69df8d4ffc9d372a9b14d2049b..4a8531cd6ce7f9fd9ff6e85968c47b33b057c322 100644 (file)
--- a/lispref/strings.texi
+++ b/lispref/strings.texi
@@ -1,7 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2002, 2003,
-@c   2004, 2005, 2006 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001,
+@c   2002, 2003, 2004, 2005, 2006, 2007  Free Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/strings
 @node Strings and Characters, Lists, Numbers, Top
@@ -390,9 +390,8 @@ character currently present at that point in @var{string}.
 @code{clear-string}:
 
 @defun clear-string string
-This clears the contents of @var{string} to zeros.
-It may also change @var{string}'s length and convert it to
-a unibyte string.
+This makes @var{string} a unibyte string and clears its contents to
+zeros.  It may also change @var{string}'s length.
 @end defun
 
 @need 2000
@@ -700,7 +699,8 @@ in the copy with encodings of the corresponding @var{objects}.  The
 arguments @var{objects} are the computed values to be formatted.
 
 The characters in @var{string}, other than the format specifications,
-are copied directly into the output; if they have text properties,
+are copied directly into the output, including their text properties,
+if any.
 @end defun
 
 @cindex @samp{%} in format