23.0.60; equal-including-properties not mentioned in Elisp manual

[Lawrence Mitchell <wence@gmx.li>]

In GNU Emacs 23.0.60.2 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2008-01-11 on lamacq.ph.ed.ac.uk

The function equal-including-properties is not mentioned in the
Elisp manual.  How about the following text?

diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index b68e2d6..da954b7 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -2007,7 +2007,9 @@ always true.
 @end example
 
 Comparison of strings is case-sensitive, but does not take account of
-text properties---it compares only the characters in the strings.  For
+text properties---it compares only the characters in the strings---use
+@code{equal-including-properties} if you need to differentiate between
+@code{equal} strings with differing text properties.  For
 technical reasons, a unibyte string and a multibyte string are
 @code{equal} if and only if they contain the same sequence of
 character codes and all these codes are either in the range 0 through
@@ -2038,6 +2040,22 @@ returns @code{t} if and only if both the expressions below return
 Because of this recursive method, circular lists may therefore cause
 infinite recursion (leading to an error).
 
+@defun equal-including-properties object1 object2
+This function behaves like @code{equal} in all cases but also requires
+that for two strings to be equal, they have the same text properties.
+
+@example
+@group
+(equal "asdf" (propertize "asdf" '(asdf t)))
+     @result{} t
+@end group
+@group
+(equal-including-properties "asdf" 
+                            (propertize "asdf" '(asdf t)))
+     @result{} nil
+@end group
+@end example
+@end defun
 @ignore
    arch-tag: 9711a66e-4749-4265-9e8c-972d55b67096
 @end ignore


ChangeLog entry:

2008-02-08  Lawrence Mitchell  <wence@gmx.li>

	* objects.texi (Equality Predicates): Mention
	equal-including-properties.

Cheers,
Lawrence
-- 
Lawrence Mitchell <wence@gmx.li>