home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / programming / msdos / xa214f.lzh / xa214f / README.1st < prev    next >
Text File  |  1998-03-03  |  3KB  |  79 lines
  1. --------------------------------------------------------------------------
  2. tHIS IS THE readme FILE FOR THE PACKAGE 'XA', WRITTEN BY a.fACHAT. 
  3.  
  4. tHE PACKAGE 'XA' IS PROVIDED 'AS IS', NO WARRANTY WILL BE TAKEN
  5. FOR ANY DAMAGE CAUSED BY IT OR BY ANY USE OF IT.
  6.  
  7. tHE PACKAGE CONTAINS THE SOURCE CODE FOR THE cROSS ASSEMBLER 'XA', SEVERAL
  8. UTILITIES IN THE 'MISC' SUBDIRECTORY, AS WELL AS EXAMPLE PROGRAMS AND
  9. THE REST OF THIS DIRECTORY TREE. aS OF RELEASE 2.1.4F A GCC-GO32 dos
  10. CROSS-COMPILING MAKE OPTION IS INCLUDED.
  11.  
  12. tHE CURRENT VERSION FOR 'XA' IS 2.1.4F, AS OF 03MAR1998
  13.  
  14. tHE WHOLE PACKAGE IS PLACED UNDER THE gnu pUBLIC lICENSE, FOR FURTHER
  15. INFORMATION ON REDISTRIBUTION SEE THE INCLUDED FILE "copying".
  16. --------------------------------------------------------------------------
  17.  
  18. xa IS A 6502 CROSS COMPILER:
  19.  
  20.  - UNDER gnu PUBLIC LICENSE
  21.  
  22.  - CAN PRODUCE _RELOCATABLE_ BINARIES
  23.  
  24.  - tHE FULL FILEFORMAT DESCRIPTION AND 6502 FILE LOADER INCLUDED.
  25.  
  26.  - ALSO INCLUDED RELOCATION AND INFO UTILITES, AS WELL AS LINKER
  27.  
  28.  - FOR ANY ansi-c COMPLIANT COMPUTER (ONLY UTILITIES NEED 'STAT' CALL 
  29.    FOR FILE SIZE). 
  30.  
  31.  - FAST BY HASHTABLES
  32.  
  33.  - rOCKWELL cmos OPCODES
  34.  
  35.  - RUNNING UNDER dos AND ANY ansi c SYSTEM (uNIX, aMIGA, aTARI st)
  36.  
  37. i DEVELOPED THIS CROSS ASSEMBLER FOR THE 6502 cpu FAMILY QUITE SOME TIME
  38. AGO ON MY aTARI st. tHE ASSEMBLER HAS SUCCESSFULLY BEEN PORTED TO aMIGA 
  39. AND uNIX COMPUTER (PORTED? JUST COMPILED... :-) 
  40. lATELY i CAME ACROSS THE PROBLEM TO NEED RELOCATABLE 6502 BINARY FILES, SO
  41. i REVISED THE ASSEMBLER FROM VERSION 2.0.7 TO 2.1.0, ADDING A (ADMITTEDLY
  42. PROPRIETARY) 6502 RELOCATABLE BINARY FORMAT. bUT THERE ARE NOT MANY OTHER
  43. FORMATS AROUND AND THEY DIDN'T FIT MY NEEDS. i HAVE DEVELOPED THIS FORMAT 
  44. MYSELF AND IT IS UNDER THE gnu PUBLIC LICENSE.
  45. wITH VERSION 2.1.1 THE 'OFFICIAL' VERSION OF THE FILEFORMAT IS SUPPORTED.
  46.  
  47. tO COMPILE IT, JUST TYPE "MAKE" (IF YOU HAVE THE gnu GCC. iF NOT, EDIT THE 
  48. mAKEFILE FOR THE COMPILER OPTIONS). tHIS PRODUCES "XA", THE CROSS ASSEMBLER;
  49. "UNCPK", A SMALL PACKING UTILITY (WHERE THE c64 COUNTERPART IS IN THE
  50. EXAMPLES SUBDIRECTORY), "PRINTCBM", THAT LISTS c64 basic FILES AND
  51. 'FILE65' THAT PRINTS SOME INFORMATION ABOUT O65 FILES.  tHE "LOADER" IN
  52. THE LOADER SUBDIRECTORY IS A BASIC 6502 IMPLEMENTATION OF A RELOCATING
  53. BINARY LOADER.
  54. "FILE65" PRINTS FILE INFORMATION ON 'O65' RELOCATABLE FILES. "RELOC65"
  55. CAN RELOCATE 'O65' FILES.
  56.  
  57. iF YOU WANT TO USE IT UNDER dos, YOU HAVE TO HAVE THE go32 dos CROSSCOMPILING
  58. TOOLS TO COMPILE. tHEN JUST TYPE "MAKE DOS" AND YOU'LL END UP WITH THE
  59. APPROPRIATE dos BINARIES. tHIS HAS BEEN TESTED ONLY UNDER I386 lINUX, HOWEVER. 
  60. aNOTHER ARCHIVE WITH THE dos BINARIES INCLUDED IS PROVIDED.
  61.  
  62. oNE PROBLEM ON THE aTARI WAS IT'S BROKEN "MALLOC". tHEREFORE i USED TO
  63. ALLOC EVERYTHING IN ONE CHUNK AND DIVIDE THE MEMORY BY HAND. sO EVERYTHING
  64. WAS KIND OF STATICALLY ALLOCATED. tHIS IS ALMOST GONE NOW. oNLY THE
  65. TEMPORARY STORAGE BETWEEN PASS1 AND PASS2 AND THE PREPROCESSOR ARE STILL
  66. ALLOCATED IN ONE CHUNK (SIZE DEFINITIONS IN XAH.H). tHE REST IS ALLOCATED
  67. AS NEEDED.
  68.  
  69. tHE DOCS ARE IN THE 'DOC' SUBDIR. tHERE ALSO IS A DESCRIPTION OF THE
  70. 6502 RELOCATABLE BINARY FORMAT. iF YOU THINK SOME THINGS COULD BE 
  71. EXPRESSED IN A BETTER WAY, FEEL FREE AND MAIL ME TO IMPROVE MY ENGLISH ;-)
  72.  
  73. fOR FURTHER INFORMATION:
  74.  
  75.          aNDRE fACHAT
  76.          EMAIL: A.FACHAT@PHYSIK.TU-CHEMNITZ.DE
  77.  
  78.  
  79.