Eliminate some uses of __STDC__.
[deliverable/binutils-gdb.git] / gdb / TODO
index 82a2008b97d6869ce9f66720d1d6ce3c22ae073f..1f9a77f09a2c67dcf12e9212daf589c7f896423f 100644 (file)
--- a/gdb/TODO
+++ b/gdb/TODO
@@ -4,31 +4,45 @@ of these, you should consider sending mail to the same address, to
 find out whether anyone else is working on it.
 
 
-               Known problems in GDB 5.0
-               =========================
+                       GDB 5.1 - Fixes
+                       ===============
 
 Below is a list of problems identified during the GDB 5.0 release
-cycle.  People hope to have these problems fixed in a follow-on
-release.
+cycle.  People hope to have these problems fixed in 5.1.
 
---
+-- 2001-03-08
 
-The BFD directory requires bug-fixed AUTOMAKE et.al.
+Update GDB's coding standard documentation.  Known topics:
 
-AUTOMAKE 1.4 incorrectly set the TEXINPUTS environment variable.  It
-contained the full path to texinfo.tex when it should have only
-contained the directory.  The bug has been fixed in the current
-AUTOMAKE sources.  Automake snapshots can be found in:
-       ftp://sourceware.cygnus.com/pub/gdb/snapshots
-and    ftp://sourceware.cygnus.com/pub/binutils
+       o     alloca/malloc et.al.
+
+       o     typedef and structs
+
+       o       ISO-C
+
+and most likely also:
+
+       o        include conventions
 
 --
 
-RFD: infrun.c: No bpstat_stop_status call after proceed over break?
-http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00665.html
+Wow, three bug reports for the same problem in one day!  We should
+probably make fixing this a real priority :-).
 
-GDB misses watchpoint triggers after proceeding over a breakpoint on
-x86 targets.
+Anyway, thanks for reporting.
+
+The following patch will fix the problems with setting breakpoints in
+dynamically loaded objects:
+
+   http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00230.html
+
+This patch isn't checked in yet (ping Michael/JimB), but I hope this
+will be in the next GDB release.
+
+There should really be a test in the testsuite for this problem, since
+it keeps coming up :-(.  Any volunteers?
+
+Mark
 
 --
 
@@ -41,6 +55,228 @@ http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00309.html
 
 Mark
 
+[The test has been submitted for approval - cagney]
+
+--
+
+RFD: infrun.c: No bpstat_stop_status call after proceed over break?
+http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00665.html
+
+GDB misses watchpoint triggers after proceeding over a breakpoint on
+x86 targets.
+
+--
+
+GDB 5.0 doesn't work on Linux/SPARC
+
+There are two parts to this.
+
+      o          GDB 5.0 doesn't work on GNU/Linux/SPARC32
+
+      o          GDB 5.0 doesn't work on the new target
+         GNU/Linux/SPARC64
+
+GDB does build on both these targets.
+
+The first problem is the one that should be fixed.
+
+--
+
+               GDB 5.1 - New features
+               ======================
+
+The following new features should be included in 5.1.
+
+--
+
+Enable MI by default.  Old code can be deleted after 5.1 is out.
+
+Issues:
+
+       o       syntax change where a list would
+               look like:
+                    [ foo=a, foo=b, foo=c ]
+               instead of
+                    { foo=a, foo=b, foo=c }
+
+       o       kill off the idea of a reverse
+               query.
+
+       o       review test cases
+
+       o       enable it
+
+--
+
+Pascal (Pierre Muller, David Taylor)
+
+Pierre Muller has contributed patches for adding Pascal Language
+support to GDB.
+
+2 pascal language patches inserted in database
+http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00521.html
+
+Indent -gnu ?
+http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00496.html
+
+[I think this has been merged, need to confirm - cagney]
+
+--
+
+Java (Anthony Green, David Taylor)
+
+Anthony Green has a number of Java patches that did not make it into
+the 5.0 release.  The first two are in cvs now, but the third needs
+some fixing up before it can go in.
+
+Patch: java tests
+http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00512.html
+
+Patch: java booleans
+http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00515.html
+
+Patch: handle N_MAIN stab
+http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00527.html
+
+-- 2001-03-08
+
+Add CRIS target.
+
+A predicate to this is the multi-arching of SOFTWARE_SINGLE_STEP().  A
+patch has been submitted.
+
+--
+
+               GDB 5.1 - Cleanups
+               ==================
+
+The following code cleanups will hopefully be applied to GDB 5.1.
+
+-- 2001-03-08
+
+Resolve the status of all broken targets as identified by the MAINTAINERS
+file.
+
+--
+
+Change documentation to GFDL license.
+
+``It is time to make an effort to start using the GFDL more
+thoroughly.  Would all GNU maintainers please change the license to
+the GFDL, for all manuals and other major documentation files?
+
+The GFDL and some instructions for using it can be found in
+http://www.gnu.org/copyleft/''
+
+       RMS
+
+--
+
+Fix copyright notices.
+
+Turns out that ``1998-2000'' isn't considered valid :-(
+
+http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00467.html
+
+--
+
+               GDB 5.1 - Known Problems
+               ========================
+
+--
+
+z8k
+
+The z8k has suffered bit rot and is known to not build.  The problem
+was occuring in the opcodes directory.
+
+--
+
+Solaris 8 x86 CURSES_H problem
+http://sources.redhat.com/ml/gdb/2000-07/msg00038.html
+
+The original problem was worked around with:
+
+    2000-06-06  Michael Snyder  <msnyder@cygnus.com>
+
+        * configure.in: Enable autoconf to find curses.h on Solaris 2.8.
+        * configure: Regenerate.
+
+When building both GDB and SID using the same source tree the problem
+will still occure. sid/component/configure.in mis-configures
+<curses.h> and leaves wrong information in the config cache.
+
+--
+
+               GDB 5.2 - Fixes
+               ===============
+
+--
+
+Thread support.  Right now, as soon as a thread finishes and exits,
+you're hosed.  This problem is reported once a week or so.
+
+--
+
+               GDB 5.2 - New features
+               ======================
+
+--
+
+GCC 3.0 ABI support (but hopefully sooner...).
+
+--
+
+Objective C/C++ support (but hopefully sooner...).
+
+--
+
+               GDB 5.2 - Cleanups
+               ==================
+
+The following cleanups have been identified as part of GDB 5.2.
+
+--
+
+Remove old code that does not use ui_out functions and all the related
+"ifdef"s.  This also allows the elimination of -DUI_OUT from
+Makefile.in and configure.in.
+
+--
+
+Compiler warnings.
+
+Eliminate all warnings for at least one host/target for the flags:
+-Wimplicit -Wreturn-type -Wcomment -Wtrigraphs -Wformat -Wparentheses
+-Wpointer-arith -Wuninitialized
+
+--
+
+Restructure gdb directory tree so that it avoids any 8.3 and 14
+filename problems.
+
+--
+
+Convert GDB build process to AUTOMAKE.
+
+See also sub-directory configure below.
+
+The current convention is (kind of) to use $(<header>_h) in all
+dependency lists.  It isn't done in a consistent way.
+
+--
+
+               GDB 5.2 - Known Problems
+               ========================
+
+--
+
+               Code Cleanups: General
+               ======================
+
+The following are more general cleanups and fixes.  They are not tied
+to any specific release.
+
 --
 
 Revised UDP support (was: Re: [Fwd: [patch] UDP transport support])
@@ -49,6 +285,11 @@ http://sourceware.cygnus.com/ml/gdb-patches/2000-04/msg00000.html
 (Broken) support for GDB's remote protocol across UDP is to be
 included in the follow-on release.
 
+It should be noted that UDP can only work when the [Gg] packet fits in
+a single UDP packet.
+
+There is also much debate over the merit of this.
+
 --
 
 Can't build IRIX -> arm GDB.
@@ -71,19 +312,18 @@ Dan Nicolaescu writes:
 > stoping in weak functions. 
 > 
 > It stops in a function that is defined as weak, not in the function
-> that is actualy run... 
+> that is actually run... 
 
 --
 
-GDB 5.0 doesn't work on Linux/SPARC
-
---
+Follow through `make check' with --enable-shared.
 
-               Code Cleanups: Next Release
-               ===========================
+When the srcware tree is configured with --enable-shared, the `expect'
+program won't run properly.  Jim Wilson found out gdb has a local hack
+to set LD_LIBRARY_PATH, but, AFAIK, no other project has been hacked
+similarly.
 
-The following are small cleanups that will hopefully be completed by
-the follow on to 5.0.
+http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00845.html
 
 --
 
@@ -93,17 +333,23 @@ Patches in the database.
 
 --
 
-Purge PARAMS.
+printcmd.c (print_address_numeric):
 
-Eliminate all uses of PARAMS in GDB's source code.
+NOTE: This assumes that the significant address information is kept in
+the least significant bits of ADDR - the upper bits were either zero
+or sign extended.  Should ADDRESS_TO_POINTER() or some
+ADDRESS_TO_PRINTABLE() be used to do the conversion?
 
 --
 
-Fix copyright notices.
-
-Turns out that ``1998-2000'' isn't considered valid :-(
+The BFD directory requires bug-fixed AUTOMAKE et.al.
 
-http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00467.html
+AUTOMAKE 1.4 incorrectly set the TEXINPUTS environment variable.  It
+contained the full path to texinfo.tex when it should have only
+contained the directory.  The bug has been fixed in the current
+AUTOMAKE sources.  Automake snapshots can be found in:
+       ftp://sourceware.cygnus.com/pub/gdb/snapshots
+and    ftp://sourceware.cygnus.com/pub/binutils
 
 --
 
@@ -112,17 +358,9 @@ determine the default isa/byte-order.
 
 --
 
-Rely on BFD_BIG_ENDIAN and BFD_LITTLE_ENDIAN instead of host dependant
+Rely on BFD_BIG_ENDIAN and BFD_LITTLE_ENDIAN instead of host dependent
 BIG_ENDIAN and LITTLE_ENDIAN.
 
---
-
-               Code Cleanups: General
-               ======================
-
-The following are more general cleanups and fixes.  They are not tied
-to any specific release.
-
 --
 
 Eliminate more compiler warnings.
@@ -146,6 +384,9 @@ Like make_cleanup_func it isn't portable.
 http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00791.html
 http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00814.html
 
+--
+
+Nuke #define CONST_PTR.
 
 --
 
@@ -169,17 +410,6 @@ needed.
 
 --
 
-Replace asprintf() calls with xasprintf() calls.
-
-As with things like strdup() most calls to asprintf() don't check the
-return value.
-
---
-
-Replace strsave() + mstrsave() with libiberty:xstrdup().
-
---
-
 Replace savestring() with something from libiberty.
 
 An xstrldup()? but that would have different semantics.
@@ -211,7 +441,7 @@ how.
 
 --
 
-Eliminate mmalloc() from GDB.
+Eliminate mmalloc(), mstrsave() et.al. from GDB.
 
 Also eliminate it from defs.h.
 
@@ -237,14 +467,6 @@ suffer bit rot.
 
 --
 
-Updated readline
-
-Readline 4.? is out.  A merge wouldn't hurt.  Patches are in:
-
-http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00436.html
-
---
-
 Deprecate "fg".  Apparently ``fg'' is actually continue.
 
 http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00417.html
@@ -277,17 +499,6 @@ http://sourceware.cygnus.com/ml/gdb-patches/2000-05/msg00466.html
 
 --
 
-Follow through `make check' with --enable-shared.
-
-When the srcware tree is configured with --enable-shared, the `expect'
-program won't run properly.  Jim Wilson found out gdb has a local hack
-to set LD_LIBRARY_PATH, but, AFAIK, no other project has been hacked
-similarly.
-
-http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00845.html
-
---
-
 The ``maintenance deprecate set endian big'' command doesn't notice
 that it is deprecating ``set endian'' and not ``set endian big'' (big
 is implemented using an enum).  Is anyone going to notice this?
@@ -326,13 +537,31 @@ http://sourceware.cygnus.com/ml/gdb-patches/2000-07/msg00042.html
 Apart from the d30v, are there any sim/common simulators that make use
 of this?
 
-A brief summary of what happended is that sim/common/sim-break.c was
+A brief summary of what happened is that sim/common/sim-break.c was
 created as a good idea.  It turned out a better idea was to use
 SIM_SIGBREAK and have GDB pass back sim_resume (..., SIGBREAK).
 
 --
 
-parse.c:build_parse() has a buffer overrun.
+Move remote_remove_hw_breakpoint, remote_insert_hw_breakpoint,
+remote_remove_watchpoint, remote_insert_watchpoint into target vector.
+
+--
+
+Eliminate ``extern'' from C files.
+
+--
+
+Replace ``STREQ()'' et.al. with ``strcmp() == 0'' et.al.
+
+Extreme care is recommeded - perhaps only modify tests that are
+exercised by the testsuite (as determined using some type of code
+coverage analysis).
+
+--
+
+Replace the file gdb/CONTRIBUTE with a file that is generated from the
+gdb/doc/*.texinfo directory.
 
 --
 
@@ -344,15 +573,29 @@ fundamental architectural change.
 
 --
 
+Hardware watchpoint problems on x86 OSes, including Linux:
+
+1. Delete/disable hardware watchpoints should free hardware debug
+registers. 
+2. Watch for different values on a viariable with one hardware debug
+register.
+
+According to Eli Zaretskii <eliz@delorie.com>:
+
+These are not GDB/ia32 issues per se: the above features are all
+implemented in the DJGPP port of GDB and work in v5.0.  Every
+x86-based target should be able to lift the relevant parts of
+go32-nat.c and use them almost verbatim.  You get debug register
+sharing through reference counts, and the ability to watch large
+regions (up to 16 bytes) using multiple registers.  (The required
+infrastructure in high-level GDB application code, mostly in
+breakpoint.c, is also working since v5.0.)
+
+--
+
 Add built-by, build-date, tm, xm, nm and anything else into gdb binary
 so that you can see how the GDB was created.
 
-Some of these (*m.h) would be added to the generated config.h.  That
-in turn would fix a long standing bug where by the build process many
-not notice a changed tm.h file.  Since everything depends on config.h,
-a change to *m.h forces a change to config.h and, consequently forces
-a rebuild.
-
 --
 
 Add an "info bfd" command that displays supported object formats,
@@ -368,12 +611,10 @@ This requires internationalization.
 
 --
 
-Convert GDB build process to AUTOMAKE.
-
-See also sub-directory configure below.
-
-The current convention is (kind of) to use $(<header>_h) in all
-dependency lists.  It isn't done in a consistent way.
+Add support for:
+(gdb) p fwprintf(stdout,L"%S\n", f)
+No symbol "L" in current context.
 
 --
 
@@ -387,11 +628,6 @@ See also automake above.
 
 --
 
-Restructure gdb directory tree so that it avoids any 8.3 and 14
-filename problems.
-
---
-
 Add a transcript mechanism to GDB.
 
 Such a mechanism might log all gdb input and output to a file in a
@@ -416,8 +652,6 @@ http://sourceware.cygnus.com/ml/gdb/2000-04/msg00121.html
 
 Update texinfo.tex to latest?
 
-
-
 --
 
 Incorporate agentexpr.texi into gdb.texinfo
@@ -436,7 +670,7 @@ Document overlay machinery.
 
 ``(gdb) catch signal SIGNAL''
 
-Overlaps with ``handle SIGNAL'' but the implied behavour is different.
+Overlaps with ``handle SIGNAL'' but the implied behavior is different.
 You can attach commands to a catch but not a handle.  A handle has a
 limited number of hardwired actions.
 
@@ -479,6 +713,14 @@ deprecated ``set archdebug'' and expand to ``set architecture''.
 Replace the code that uses the host FPU with an emulator of the target
 FPU.
 
+--
+
+The "ocd reset" command needs to flush the dcache, which requires breaking
+the abstraction layer between the target independent and target code.  One
+way to address this is provide a generic "reset" command and target vector.
+
+http://sources.redhat.com/ml/gdb-patches/2000-10/msg00011.html
+
 --
 
                        Thread Support
@@ -553,41 +795,6 @@ New languages come onto the scene all the time.
 
 --
 
-Pascal (Pierre Muller, David Taylor)
-
-Pierre Muller has contributed patches for adding Pascal Language
-support to GDB.
-
-2 pascal language patches inserted in database
-http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00521.html
-
-Indent -gnu ?
-http://sourceware.cygnus.com/ml/gdb/2000-q1/msg00496.html
-
---
-
-Java (Anthony Green, David Taylor)
-
-Anthony Green has a number of Java patches that did not make it into
-the 5.0 release.
-
-Patch: java tests
-http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00512.html
-
-Patch: java booleans
-http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00515.html
-
-Patch: handle N_MAIN stab
-http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00527.html
-
---
-
-[Comming...]
-
-Modify gdb to work correctly with Pascal.
-
---
-
 Re: Various C++ things
 
 value_headof/value_from_vtable_info are worthless, and should be
@@ -620,13 +827,6 @@ Get DEC/Compaq to contribute their Modula-3 support.
 
 --
 
-set/show remote X-packet ...
-
-``(gdb) help set remote X-packet'' doesn't list the applicable
-responses.  The help message needs to be expanded.
-
---
-
 Remote protocol doco feedback.
 
 Too much feedback to mention needs to be merged in (901660).  Search
@@ -646,7 +846,7 @@ ignored and a timeout is required before GDB retries.  A pre-cursor to
 fixing this this is making GDB's remote protocol packet more robust.
 
 While downloading to a remote protocol target, gdb ignores packet
-errors in so far as it will continue to edownload with chunk N+1 even
+errors in so far as it will continue to download with chunk N+1 even
 if chunk N was not correctly sent.  This causes gdb.base/remote.exp to
 take a painfully long time to run.  As a PS that test needs to be
 fixed so that it builds on 16 bit machines.
@@ -669,6 +869,10 @@ on the fly - should it be returned in the ``T'' packet?
 Underlying problem is that the register file is target endian.  If the
 target endianess changes gdb doesn't know.
 
+--
+
+Rename read_register{,_pid}() to read_unsigned_register{,_pid}().
+
 --
 
                        Symbol Support
@@ -676,7 +880,7 @@ target endianess changes gdb doesn't know.
 
 If / when GDB starts to support the debugging of multi-processor
 (rather than multi-thread) applications the symtab code will need to
-be updated a little so that several independant symbol tables are
+be updated a little so that several independent symbol tables are
 active at a given time.
 
 The other interesting change is a clarification of the exact meaning
@@ -772,7 +976,7 @@ did have a frame pointer register.  Modern architectures typically
 construct a virtual frame-handle from the stack pointer and various
 other bits of string.
 
-Unfortunatly GDB still treats this synthetic FP register as though it
+Unfortunately GDB still treats this synthetic FP register as though it
 is real.  That in turn really confuses users (arm and ``print $fp'' VS
 ``info registers fp'').  The synthetic FP should be separated out of
 the true register set presented to the user.
@@ -826,10 +1030,10 @@ How I would like the register file to work is more like:
              |
         map random cache
         bytes to target
-        dependant i-face
+        dependent i-face
             /|\
              |
-       target dependant
+       target dependent
         such as [gG] packet
         or ptrace buffer
 
@@ -860,7 +1064,7 @@ The main objectives being:
 
         o       a mechanism that clearly separates the
                 gdb internal register cache from any
-                target (not architecture) dependant
+                target (not architecture) dependent
                 specifics such as [gG] packets.
 
 Of course, like anything, it sounds good in theory.  In reality, it
@@ -945,7 +1149,7 @@ Fix target_signal_from_host() etc.
 
 The name is wrong for starters.  ``target_signal'' should probably be
 ``gdb_signal''.  ``from_host'' should be ``from_target_signal''.
-After that it needs to be multi-arched and made independant of any
+After that it needs to be multi-arched and made independent of any
 host signal numbering.
 
 --
@@ -1092,7 +1296,7 @@ The serial code already does this.
 
 --
 
-Make MI interface accessable from existing CLI.
+Make MI interface accessible from existing CLI.
 
 --
 
@@ -1207,7 +1411,7 @@ What should happen is that ``target xxxx'' should call a generic
 open an asynchronous target that may need to perform background tasks
 as part of the ``attach'' phase.
 
-Unfortunatly, due to limitations in the old/creaking command.h
+Unfortunately, due to limitations in the old/creaking command.h
 interface, that isn't possible.  The function being called isn't told
 of the ``xxx'' or any other context information.
 
This page took 0.030781 seconds and 4 git commands to generate.