* gdbarch.sh (gdbarch_update_p): Keep the list of architectures

sorted in most most-recent-used order.  Document.
* gdbarch.h, gdbarch.c: Regenerate.

1 files changed, 10 insertions, 3 deletions

diff --git a/gdb/gdbarch.h b/gdb/gdbarch.h
index 7e66522..f6a690d 100644
--- a/gdb/gdbarch.h
+++ b/gdb/gdbarch.h
@@ -2406,9 +2406,16 @@ extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
    architecture; ARCHES which is a list of the previously created
    ``struct gdbarch'' for this architecture.
 
-   The INIT function parameter INFO shall, as far as possible, be
-   pre-initialized with information obtained from INFO.ABFD or
-   previously selected architecture (if similar).
+   The INFO parameter is, as far as possible, be pre-initialized with
+   information obtained from INFO.ABFD or the previously selected
+   architecture.
+
+   The ARCHES parameter is a linked list (sorted most recently used)
+   of all the previously created architures for this architecture
+   family.  The (possibly NULL) ARCHES->gdbarch can used to access
+   values from the previously selected architecture for this
+   architecture family.  The global ``current_gdbarch'' shall not be
+   used.
 
    The INIT function shall return any of: NULL - indicating that it
    doesn't recognize the selected architecture; an existing ``struct