renamed IsRefTo() to IsSameAs() (do complain if this is not more clear) and

changed its signature to take a const reference instead of a pointer which
simplifies the code and makes it safer as well


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@42776 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/changes.txt

@@ -30,7 +30,7 @@ Changes in behaviour which may result in compilation errors
   used to work in somewhat unexpected way as it compared only internal pointers
   and not the object data. The code using it will have to be updated:
   * If the object was compared with wxNullXXX, use IsOk() method instead
-  * If valid object need to be compated, use IsRefTo() to reproduce the old
+  * If valid object need to be compated, use IsSameAs() to reproduce the old
     behaviour or change the code to avoid comparing bitmaps &c
 - wxFontData::GetColour() now returns a const colour.
 - wxDC objects can't be created directly now (this never worked, now it doesn't

docs/latex/wx/object.tex

@@ -116,12 +116,15 @@ this one or is derived from it.
   bool tmp = obj->IsKindOf(CLASSINFO(wxFrame));
 \end{verbatim}
 
-\membersection{wxObject::IsRefTo}\label{wxobjectisrefto}
+\membersection{wxObject::IsSameAs}\label{wxobjectissameas}
 
-\func{bool}{IsRefTo}{\param{const wxObject *}{ obj}}
+\func{bool}{IsSameAs}{\param{const wxObject\& }{ obj}}
 
-Returns \true if this object is referencing the \arg{obj}'s data.
-Note that this function only does a {\tt shallow} comparison.
+Returns \true if this object has the same data pointer as \arg{obj}. Notice
+that \true is returned if the data pointers are \NULL in both objects.
+
+This function only does a \emph{shallow} comparison, i.e. it doesn't compare
+the objects pointed to by the data pointers of these objects.
 
 \membersection{wxObject::Ref}\label{wxobjectref}
 

docs/latex/wx/trefcount.tex

@@ -35,7 +35,7 @@ That's why not all reference-counted wxWidgets classes provide comparison operat
 
 Also note that if you only need to do a {\tt shallow} comparison between two
 \helpref{wxObject}{wxobject}-derived classes, you should not use the $==$ and $!=$ operators
-but rather the \helpref{wxObject::IsRefTo}{wxobjectisrefto} function.
+but rather the \helpref{wxObject::IsSameAs}{wxobjectissameas} function.
 
 
 \subsection{Object destruction}\label{refcountdestruct}