* regcache.h: Update comments describing the regcache_cpy family

of functions.
(regcache_save, regcache_restore): Delete declaration.
(regcache_save_no_passthrough): Delete declaration.
(regcache_restore_no_passthrough): Delete declaration.
* regcache.c (regcache_save): Delete function.
(regcache_save_no_passthrough): Delete function.
(regcache_restore): Delete function.
(regcache_restore_no_passthrough): Delete function.

gdb/ChangeLog

@@ -1,3 +1,15 @@
+2002-06-22  Andrew Cagney  <ac131313@redhat.com>
+
+	* regcache.h: Update comments describing the regcache_cpy family
+	of functions.
+	(regcache_save, regcache_restore): Delete declaration.
+	(regcache_save_no_passthrough): Delete declaration.
+	(regcache_restore_no_passthrough): Delete declaration.
+	* regcache.c (regcache_save): Delete function.
+	(regcache_save_no_passthrough): Delete function.
+	(regcache_restore): Delete function.
+	(regcache_restore_no_passthrough): Delete function.
+
 2002-06-21  Andrew Cagney  <ac131313@redhat.com>
 
 	* config/m68k/tm-m68k.h: Fix typo.

gdb/regcache.c

@@ -1185,41 +1185,6 @@ build_regcache (void)
   register_valid = deprecated_grub_regcache_for_register_valid (current_regcache);
 }
 
-void
-regcache_save (struct regcache *regcache)
-{
-  int i;
-  gdb_assert (current_regcache != NULL && regcache != NULL);
-  gdb_assert (current_regcache->descr->gdbarch == regcache->descr->gdbarch);
-  regcache_cpy (regcache, current_regcache);
-}
-
-void
-regcache_save_no_passthrough (struct regcache *regcache)
-{
-  gdb_assert (current_regcache != NULL && regcache != NULL);
-  gdb_assert (current_regcache->descr->gdbarch == regcache->descr->gdbarch);
-  regcache_cpy_no_passthrough (regcache, current_regcache);
-}
-
-void
-regcache_restore (struct regcache *regcache)
-{
-  int i;
-  gdb_assert (current_regcache != NULL && regcache != NULL);
-  gdb_assert (current_regcache->descr->gdbarch == regcache->descr->gdbarch);
-  regcache_cpy (current_regcache, regcache);
-}
-
-void
-regcache_restore_no_passthrough (struct regcache *regcache)
-{
-  char *regcache_registers;
-  gdb_assert (current_regcache != NULL && regcache != NULL);
-  gdb_assert (current_regcache->descr->gdbarch == regcache->descr->gdbarch);
-  regcache_cpy_no_passthrough (current_regcache, regcache);
-}
-
 void
 _initialize_regcache (void)
 {

gdb/regcache.h

@@ -58,18 +58,16 @@ extern char *registers;
 
 extern signed char *register_valid;
 
-/* Save/restore the register cache using the regbuf.  The operation is
-   write through - it is strictly for code that needs to restore the
-   target's registers to a previous state.
+/* Copy/duplicate the contents of a register cache.  By default, the
+   operation is pass-through.  Writes to DST and reads from SRC will
+   go through to the target.
+
+   The ``cpy'' functions can not have overlapping SRC and DST buffers.
 
    ``no passthrough'' versions do not go through to the target.  They
-   only save values already in the cache.  */
+   only transfer values already in the cache.  */
 
-extern void regcache_save (struct regcache *regcache);
-extern void regcache_restore (struct regcache *regcache);
 extern struct regcache *regcache_dup (struct regcache *regcache);
-extern void regcache_save_no_passthrough (struct regcache *regcache);
-extern void regcache_restore_no_passthrough (struct regcache *regcache);
 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);