aboutsummaryrefslogtreecommitdiff
path: root/sim/README-HACKING
diff options
context:
space:
mode:
authorTom Tromey <tromey@redhat.com>1998-04-24 21:00:29 +0000
committerTom Tromey <tromey@redhat.com>1998-04-24 21:00:29 +0000
commitc2816431f1da35c377ce3f5c6d79ae9af1cfed48 (patch)
treeb0cc7041245d29bb65ae377bcc71eee8b6e285b6 /sim/README-HACKING
parentcbd15dc12ab8be0d2482bed8b649d105ae564702 (diff)
downloadgdb-c2816431f1da35c377ce3f5c6d79ae9af1cfed48.zip
gdb-c2816431f1da35c377ce3f5c6d79ae9af1cfed48.tar.gz
gdb-c2816431f1da35c377ce3f5c6d79ae9af1cfed48.tar.bz2
* Makefile.in (autoconf-common autoheader-common): Pass `-l
../common' to autoconf and autoheader. Unconditionally run autoconf in every subdir. (autoconf-changelog autoheader-changelog): Unconditionally run commands in every subdir. (autoconf-install autoheader-install): Likewise.
Diffstat (limited to 'sim/README-HACKING')
-rw-r--r--sim/README-HACKING66
1 files changed, 52 insertions, 14 deletions
diff --git a/sim/README-HACKING b/sim/README-HACKING
index fd6aae1..6f4cb2d 100644
--- a/sim/README-HACKING
+++ b/sim/README-HACKING
@@ -8,6 +8,8 @@ Contents
- TAGS support
- Generating "configure" files
- tconfig.in
+- C Language Assumptions
+- "dump" commands under gdb
The "common" directory
======================
@@ -37,7 +39,6 @@ The configure.in of a simulator using the common framework should look like:
--- snip ---
dnl Process this file with autoconf to produce a configure script.
-sinclude(../common/aclocal.m4)
AC_PREREQ(2.5)dnl
AC_INIT(Makefile.in)
@@ -128,30 +129,30 @@ Generating "configure" files
============================
For target's using the common framework, "configure" can be generated
-by running autoconf. This works because configure.in contains
-"sinclude(../common/aclocal.m4)".
+by running `autoconf -l ../common'. This will ensure that the
+qaclocal.m4 from the `common' directory is found.
To regenerate the configure files for all targets using the common framework:
$ cd devo/sim
- $ make -f Makefile.in autoconf-common
+ $ make -f Makefile.in SHELL=/bin/sh autoconf-common
To add a change-log entry to the ChangeLog file for each updated
directory (WARNING - check the modified new-ChangeLog files before
renaming):
- $ make -f Makefile.in autoconf-changelog
+ $ make -f Makefile.in SHELL=/bin/sh autoconf-changelog
$ more */new-ChangeLog
- $ make -f Makefile.in autoconf-install
+ $ make -f Makefile.in SHELL=/bin/sh autoconf-install
In a similar vein, both the configure and config.in files can be
updated using the sequence:
$ cd devo/sim
- $ make -f Makefile.in autoheader-common
- $ make -f Makefile.in autoheader-changelog
+ $ make -f Makefile.in SHELL=/bin/sh autoheader-common
+ $ make -f Makefile.in SHELL=/bin/sh autoheader-changelog
$ more */new-ChangeLog
- $ make -f Makefile.in autoheader-install
+ $ make -f Makefile.in SHELL=/bin/sh autoheader-install
tconfig.in
==========
@@ -179,10 +180,47 @@ ANSI C compiler that supports a 64 bit data type. Consequently:
o The type `unsigned' is valid.
-However, the user should not assume:
+However, the user should be aware of the following:
- o `<number>LL' is acceptable. Microsoft-C
- doesn't reconize it.
+ o GCC's `<number>LL' is NOT acceptable.
+ Microsoft-C doesn't reconize it.
- o `long long' or `_int64' provides a 64 bit
- integer data type.
+ o MSC's `<number>i64' is NOT acceptable.
+ GCC doesn't reconize it.
+
+ o GCC's `long long' MSC's `_int64' can
+ NOT be used to define 64 bit integer data
+ types.
+
+ o An empty array (eg int a[0]) is not valid.
+
+When building with GCC it is effectivly a requirement that
+--enable-sim-warnings be specified during configuration.
+
+"dump" commands under gdb
+=========================
+
+gdbinit.in contains the following
+
+define dump
+set sim_debug_dump ()
+end
+
+Simulators that define the sim_debug_dump function can then have their
+internal state pretty printed from gdb.
+
+FIXME: This can obviously be made more elaborate. As needed it will be.
+
+"dump" commands under gdb
+=========================
+
+gdbinit.in contains the following
+
+define dump
+set sim_debug_dump ()
+end
+
+Simulators that define the sim_debug_dump function can then have their
+internal state pretty printed from gdb.
+
+FIXME: This can obviously be made more elaborate. As needed it will be.