From: Doug Evans <dje@google.com>
Date: Tue, 3 Mar 1998 00:45:10 +0000 (+0000)
Subject: Good grief.  Detailed function descriptions should accompany their definition.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=2307e0ee986cd939edc2f7286c1cf51cad21911b;p=binutils-gdb.git

Good grief.  Detailed function descriptions should accompany their definition.
---

diff --git a/sim/common/sim-core.c b/sim/common/sim-core.c
index e3e34360807..d1f9de14358 100644
--- a/sim/common/sim-core.c
+++ b/sim/common/sim-core.c
@@ -255,17 +255,7 @@ sim_core_map_attach (SIM_DESC sd,
 }
 
 /* Attach memory or a memory mapped device to the simulator.
-   LEVEL is ... ?
-   ACCESS is the kind of access to grant (some collection of r/w/x).
-   SPACE is ... ?
-   ADDR is the starting address of the section.
-   NR_BYTES is the size of the section.
-   MODULO is non-zero if this the section is to be split into several MODULO
-   sized identical chunks.
-   CLIENT is non-zero for devices, otherwise NULL.
-   OPTIONAL_BUFFER is the address of a pre-allocated buffer to use.
-   OPTIONAL_BUFFER is a sub-optimal hook that allows clients to do nasty
-   things that the interface doesn't accomodate.  */
+   See sim-core.h for a full description.  */
 
 EXTERN_SIM_CORE\
 (void)
diff --git a/sim/common/sim-core.h b/sim/common/sim-core.h
index 5bd098469eb..3dee6859b87 100644
--- a/sim/common/sim-core.h
+++ b/sim/common/sim-core.h
@@ -122,7 +122,9 @@ EXTERN_SIM_CORE\
    data read & written to the region.  Normally a more efficient
    internal structure is used.  It is assumed that buffer is allocated
    such that the byte alignmed of OPTIONAL_BUFFER matches ADDR vis
-   (OPTIONAL_BUFFER % 8) == (ADDR % 8)) */
+   (OPTIONAL_BUFFER % 8) == (ADDR % 8)).  It is defined to be a sub-optimal
+   hook that allows clients to do nasty things that the interface doesn't
+   accomodate.  ??? That seems unnecessarily restrictive.  */
 
 EXTERN_SIM_CORE\
 (void) sim_core_attach