Added information on hardware to aid in debugging. Primarily this is

information on gdb and bdm for the MPC8xx, MC683xx, and ColdFire.

doc/FAQ/FAQ.texi

@@ -64,8 +64,10 @@ END-INFO-DIR-ENTRY
 
 @include basic.texi
 @include tools.texi
+@include concepts.texi
 @include debug.texi
 @include freesw.texi
+@include hwdebugaids.texi
 
 @ifinfo
 @node Top, Basic Information, (dir), (dir)
@@ -81,8 +83,10 @@ Common questions have been divided into the following categories.
 @menu
 * Basic Information::
 * General Development Tool Hints::
+* RTEMS Concepts::
 * Debugging Hints::
 * Free Software that Works with RTEMS::
+* Hardware to Ease Debugging::
 @end menu
 
 @c * Command and Variable Index::

doc/FAQ/Makefile

@@ -18,7 +18,7 @@ dirs:
 COMMON_FILES=../common/cpright.texi ../common/setup.texi
 
 GENERATED_FILES= \
-    basic.texi tools.texi debug.texi freesw.texi
+    basic.texi tools.texi concepts.texi debug.texi freesw.texi hwdebugaids.texi
 
 FILES=$(PROJECT).texi $(GENERATED_FILES)
 
@@ -69,6 +69,11 @@ tools.texi: tools.t Makefile
 	    -u "Top" \
 	    -n "" ${*}.t
 
+concepts.texi: concepts.t Makefile
+	$(BMENU) -c -p "" \
+	    -u "Top" \
+	    -n "" ${*}.t
+
 debug.texi: debug.t Makefile
 	$(BMENU) -c -p "" \
 	    -u "Top" \
@@ -79,3 +84,9 @@ freesw.texi: freesw.t Makefile
 	    -u "Top" \
 	    -n "" ${*}.t
 
+
+hwdebugaids.texi: hwdebugaids.t Makefile
+	$(BMENU) -c -p "" \
+	    -u "Top" \
+	    -n "" ${*}.t
+

doc/FAQ/debug.t

@@ -46,3 +46,4 @@ $9 = @{back_flag = 1, front_flag = 8058280, next = 0x7ea5b4,
 
 In this case, the first block on the C Heap has 8,058,280 bytes left.
 
+

doc/FAQ/freesw.t

@@ -11,7 +11,9 @@
 This section describes other free software packages that are known to work
 with RTEMS.
 
-@section GNU Development Tools
+@section Development Tools
+
+@subsection Basic Development Environment
 
 The standard RTEMS development environment consists of the following GNU
 components:
@@ -28,8 +30,14 @@ Although not from the Free Software Foundation, the Cygnus newlib C
 library integrates well with the GNU tools and is a standard part of the
 RTEMS development environment.
 
+@subsection GNU Ada
+
 For those interested in using the Ada95 programming language, the GNU Ada
-compiler (GNAT) is available.  
+compiler (GNAT) is available and has excellent support for RTEMS.
+
+@subsection DDD
+
+XXX insert information from Charles Gauthier and Jiri Gaisler
 
 @section omniORB
 
@@ -68,3 +76,12 @@ ditto
 
 Free version of curses.
 
+ditto
+
+
+@section zlib
+
+Free compression/decompression library.
+
+ditto
+

doc/FAQ/hwdebugaids.t

@@ -13,7 +13,65 @@ debugging assistants that are available.
 
 @section MC683xx BDM Support for GDB
 
-@section MC683xx BDM Support for GDB
+Eric Norum (eric@@skatter.usask.ca) wrote a driver for a parallel
+port interface to a BDM module.  He and Chris John (ccj@@acm.org)
+have put together a package containing everything you need to
+use this.  From the README: "This
+package contains everything you need to be able to run GDB on
+Linux and control a Motorola CPU32+ (68360) or Coldfire (5206) target
+through a standard PC parallel port." Information on this is
+available at the following URL:
+http://www.calm.hw.ac.uk/davidf/coldfire/gdb-bdm-linux.htm.
+
+The efi332 project has a home-built BDM module and gdb driver for 
+Linux.  See http://egi332.eng.ohio-state.edu/efi332/hardware.html)
+for details.
+
+Huntsville Microsystems (HMI) has GDB support for their BDM module
+available upon request.  It is also available from their ftp site:
+ftp://ftp.hmi.com/pub/gdb
+
+The Macraigor OCD BDM module has a driver for Linux
+written by Gunter Magin (Gunter.Magin@@skil.camelot.de).  
+No URLs yet.
+
+Information in this section from:
+
+@itemize @bullet
+@item Brendan Simon <brendan@@dgs.monash.edu.au>
+@item W Gerald Hicks <wghicks@@bellsouth.net>
+@item Chris Johns <cjohns@@plessey.com.au>
+@item Eric Norum <eric@@skatter.usask.ca>
+
+@end itemize
 
 @section MPC8xx BDM Support for GDB
 
+Christian Haan <chn@@intego.de> has written a driver for FreeBSD 
+based for"a slightly changed ICD BDM module (because of changes
+in the BDM interface on the PowerPC)" that "probably will work with
+the PD module too."  His work is based on the M68K BDM work by
+Gunter Magin (Gunter.Magin@@skil.camelot.de) and 
+the PPC BDM for Linux work by Sergey Drazhnikov (swd@@agua.comptek.ru).
+This is not yet publicly available.
+
+Sergey Drazhnikov (swd@@agua.comptek.ru) has written a PPC BDM driver for
+Linux.  Information is available at http://cyclone.parad.ru/ppcbdm.
+
+Huntsville Microsystems (HMI) has GDB support for their BDM module
+available upon request.  It is also available from their ftp site:
+ftp://ftp.hmi.com/pub/gdb
+
+GDB includes support for a set of primitives to support the Macraigor
+Wiggler (OCD BDM).  Unfortunately, this requires the use of a
+proprietary interface and is supported only on Windows.  This forces
+one to use CYGWIN.  Reports are that this results in a slow
+interface.  Scott Howard (http://www.objsw.com) has announced 
+that support for the gdb+wiggler combination under DJGPP which should
+run significantly faster.
+
+@itemize @bullet
+@item Leon Pollak <leonp@@plris.com>
+@item Christian Haan <chn@@intego.de> 
+@end itemize
+