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

[Lawrence Mitchell]

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
address@hidden if you need to differentiate between
address@hidden 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).
 
address@hidden 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.
+
address@hidden
address@hidden
+(equal "asdf" (propertize "asdf" '(asdf t)))
+     @result{} t
address@hidden group
address@hidden
+(equal-including-properties "asdf" 
+                            (propertize "asdf" '(asdf t)))
+     @result{} nil
address@hidden group
address@hidden example
address@hidden defun
 @ignore
    arch-tag: 9711a66e-4749-4265-9e8c-972d55b67096
 @end ignore


ChangeLog entry:

2008-02-08  Lawrence Mitchell  <address@hidden>

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

Cheers,
Lawrence
-- 
Lawrence Mitchell <address@hidden>