home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / gnu / util_src / readme.st < prev    next >
Encoding:
Text File  |  1993-07-29  |  3.0 KB  |  65 lines
  1.  
  2. This archive contains miscellaneous tools from the GNU project, ported
  3. to the Atari ST.
  4.  
  5. Please read the file COPYING, or look in the sources, for a
  6. description of your rights and responsibilities as a user of GNU
  7. software.
  8.  
  9. These files don't need to live anyplace in relation to the other GNU
  10. stuff.
  11.  
  12. There are a bunch of things here; MAKE does the obvious thing with
  13. makefiles, although this make seems to have features out the wazoom
  14. compared to some other ones I've seen.  LD is the linker.  NM dumps
  15. object files.  Size and strip do something else with obj files, but I
  16. don't know what.  I haven't needed them so I haven't ported them, but I
  17. included them anyway, as they came with the other stuff.
  18.  
  19. You'll likely have to use this one when building GNU stuff, or at
  20. least the runtime libraries, as this make understands how to remake
  21. individual elements of OLB files.  The makefile that comes with the
  22. libraries is set up with that in mind.
  23.  
  24. Both MAKE and LD have been fairly well hacked to run on the ST.  All
  25. changes are conditionalized with #ifdef atarist.
  26.  
  27. MAKE:  Most of the changes here have to do with parsing pathnames
  28. correctly.  I also had to basically rip out the section that actually
  29. interprets command lines.  This MAKE knows how to ask Gulam to execute
  30. commands for it, but since that part of Gulam is so buggy, odds are
  31. about 2 to 1 you'll crash on the way back out of Gulam.  This is
  32. definitely Gulam's bug, but there's no fix in sight for it, so I've
  33. had to kludge around it.  To that end, when make decides it wants to
  34. execute a command line, it parses out the command name, and looks for
  35. an env var with that name.  If it finds one, it assumes that's the name
  36. of an image to spawn, and will just spawn that with the obvious
  37. argstring.  If it doesn't find it, it'll look for a program called
  38. that name in the current directory.  Failing that, it will finally ask
  39. Gulam to execute the command.  Sometimes it even works!
  40.  
  41. Finally, you should be careful about case in the names of things in
  42. your makefiles.  I tried real hard to make this thing be
  43. case-insensitive, but it's pretty hopeless.  You best bet is just
  44. leave everything in lower case.
  45.  
  46. LD:  This isn't really much changed, except in three areas, but they're
  47. biggies.  First, the header format it writes now are suitable for
  48. Ataris.  This is in contrast to the boject file format, which is still
  49. defined by the Eunuchs-ish GNU-OUT.H.  (I don't know who ever thought
  50. they were supposed to be the same anyway; they're used for completely
  51. different purposes...)
  52.  
  53. Second, the symbol-table writing stuff was completely replaced by
  54. a frob that tries to write Atari format symbol tables.  Since I can't
  55. find anything that reads them, that's probably pointless, and I know
  56. it's broken in at least one way.  
  57.  
  58. Finally, the relocation info writing stuff has been replaced by
  59. something that writes Atari format reloc info.
  60.  
  61. That's probably about all that's interesting.  As usual, bugs and
  62. question to me.  Good luck!
  63.  
  64. JRD@Stony-Brook.SCRC.Symbolics.COM
  65.