home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / gnu / binutils-2.1 / binutils / README < prev    next >
Encoding:
Text File  |  1993-05-16  |  2.5 KB  |  56 lines
  1.   This is a collection of tests for the GNU binutils. These tests
  2. were developed by Cygnus Support as the beginning of a testsuite for
  3. all the binutils. These tests are included "as is". If any of the
  4. tests fail, don't report a bug, the problem is probably in the test
  5. case. Bug reports for DejaGnu can go to bug-dejagnu@prep.ai.mit.edu.
  6.  
  7.   In the future, all testsuites get released and maintained by the
  8. devlopment team for that tool. These testsuites are included at this
  9. time with the DejaGnu release to start the process of going through
  10. all the tests and verifing their accuracy.
  11.  
  12.   Since these are part of the development source tree at Cygnus, this
  13. tar file is supposed to be untarred so that the the testsuite
  14. directory is in the binutils source tree. Most of the time DejaGnu is
  15. run by hand using "runtest", but as we believe in solid testing, we've
  16. integrated it into our Makefile's as a target. We normally use these
  17. testsuites by doing a "make all; make check" at the top level and
  18. building and testing our whole tree.
  19.  
  20.   In the main binutils directory, there is a Makefile.in.test. This has
  21. the new target added called "make check". If it is merged into your
  22. existing binutils-2.1/binutils/Makefile.in then it'll work like the
  23. other GNU tools.
  24.  
  25.   DejaGnu can be run either installed, or uninstalled. Usually it gets
  26. installed so that anyone can just run the tests without having to
  27. configure or build DejaGnu.
  28.  
  29.   To run the tests, type:
  30. "[srcdir path]/runtest --all --tool binutils --srcdir [srcdir path]/binutils/testsuite"
  31.  
  32. Here's a brief explanation.
  33. runtest     - Is the name used to invoke DejaGnu. [srcdir path]
  34.           points to the directory where DejaGnu is. This is
  35.           likely to be "../dejagnu-x.x/dejagnu" if DejaGnu is
  36.           not installed. If it is installed, it can be invoked
  37.           as part of your path.
  38.  
  39. --all        - Print tests that pass and warnings. The default is
  40.           to only print tests that fail or internal error in
  41.           DejaGnu. All the test are recorded in the summary
  42.           file produced by running the tests.
  43. --tool        - This tells DejaGnu which tool you are testing. It is
  44.           mainly used to find the testsuite directories for a
  45.           particular tool when several testsuites are in the
  46.           same directory. (like the GCC and G++ testsuites)
  47.           For the binutils, this is a little more generic at
  48.           this point, but this will probably be split into
  49.           each tool at a later date.
  50. --srcdir    - This points to the top level of the directory
  51.           containing the sources of the testsuite.
  52.  
  53.     - rob -
  54.     rob@cygnus.com
  55.  
  56.