Added deprecatioon information for mac.xstat().

This closes SF bug #505150.

Doc/mac/libmac.tex

@@ -31,12 +31,19 @@ as well as the exception \exception{error}. Note that the times
 returned by \function{stat()} are floating-point values, like all time
 values in MacPython.
 
-One additional function is available:
+One additional function is available, but only under Classic MacPython,
+not under Carbon MacPython:
 
 \begin{funcdesc}{xstat}{path}
   This function returns the same information as \function{stat()}, but
   with three additional values appended: the size of the resource fork
   of the file and its 4-character creator and type.
+  Availability: Classic MacPython only.
+  \deprecated{2.3}{Use the \function{\refmodule{macfs}.FSSpec()}
+                   function to get an FSSpec object for the file, then
+                   use the \method{GetCreatorType()} method to get the
+                   creator and type information.  It will no longer be
+                   possible to get the size of the resource fork.}
 \end{funcdesc}