2002-11-02 Andrew Cagney <ac131313@redhat.com>

	* regcache.h: Add coment indicating replacements for deprecated
	functions.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 61f6723b5ef5da5c2d95a51f72e75bf6a4f9e705..35999484b8d115abfaf38e9348f5e2697f214d9b 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2002-11-02  Andrew Cagney  <ac131313@redhat.com>
+
+       * regcache.h: Add coment indicating replacements for deprecated
+       functions.
+
 2002-11-02  Andrew Cagney  <cagney@redhat.com>
 
        * reggroups.h, reggroups.c: New files.

diff --git a/gdb/regcache.h b/gdb/regcache.h
index 48112b31bcc491338076035892cd75ccd1c4cc55..a15fc369d99e6d5156645ea6c3de4250a3da0df2 100644 (file)
--- a/gdb/regcache.h
+++ b/gdb/regcache.h
@@ -169,8 +169,24 @@ extern struct regcache *regcache_dup_no_passthrough (struct regcache *regcache);
 extern void regcache_cpy (struct regcache *dest, struct regcache *src);
 extern void regcache_cpy_no_passthrough (struct regcache *dest, struct regcache *src);
 
+/* NOTE: cagney/2002-11-02: The below have been superseded by the
+   regcache_cooked_*() functions found above, and the frame_*()
+   functions found in "frame.h".  Take care though, often more than a
+   simple substitution is required when updating the code.  The
+   change, as far as practical, should avoid adding references to
+   global variables (e.g., current_regcache, current_frame,
+   current_gdbarch or selected_frame) and instead refer to the FRAME
+   or REGCACHE that has been passed into the containing function as
+   parameters.  Consequently, the change typically involves modifying
+   the containing function so that it takes a FRAME or REGCACHE
+   parameter.  In the case of an architecture vector method, there
+   should already be a non-deprecated variant that is parameterized
+   with FRAME or REGCACHE.  */
+
 extern char *deprecated_grub_regcache_for_registers (struct regcache *);
 extern char *deprecated_grub_regcache_for_register_valid (struct regcache *);
+extern void deprecated_read_register_gen (int regnum, char *myaddr);
+extern void deprecated_write_register_gen (int regnum, char *myaddr);
 
 extern int register_cached (int regnum);
 
@@ -184,10 +200,6 @@ extern void registers_fetched (void);
 
 extern void read_register_bytes (int regbyte, char *myaddr, int len);
 
-extern void deprecated_read_register_gen (int regnum, char *myaddr);
-
-extern void deprecated_write_register_gen (int regnum, char *myaddr);
-
 extern void write_register_bytes (int regbyte, char *myaddr, int len);
 
 /* Rename to read_unsigned_register()? */