home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_100 / 149_01 / read.me < prev    next >
Text File  |  1989-01-13  |  4KB  |  105 lines
  1. /*
  2.     HEADER:        CUG149;
  3.     TITLE:        Cross-Assemblers (Portable);
  4.     FILENAME:    READ.ME;
  5.     VERSION:    1.0;
  6.     DATE:        09/25/1985;
  7.  
  8.     DESCRIPTION:    "This is the general introduction file for the portable
  9.             versions of the 1805A, 6801, and 6805 cross-assemblers.
  10.             Each assembler is explained in detail in its header
  11.             files.";
  12.  
  13.     SEE-ALSO:    1805A Cross-Assembler (Portable),
  14.             6801 Cross-Assembler (Portable),
  15.             6805 Cross-Assembler (Portable);
  16.  
  17.     AUTHORS:    William C. Colley III;
  18. */
  19.  
  20.      What's on this disk?  It goes like this:
  21.  
  22.     READ.ME        This notice.
  23.  
  24.     A68.DOC        The manual for the 6801 cross-assembler.  This file
  25.             can be printed with the following command line under
  26.             CP/M-80:
  27.  
  28.                 A>pip lst:=a68.doc[t8]
  29.  
  30.     A68.H        The source files for the 6801 cross-assembler.  The
  31.     A68.C        file A68.H also contains compile, assemble, and link
  32.     A68EVAL.C    instructions for all compilers that I have used with
  33.     A68UTIL.C    the package or that users have told me how to use with
  34.             the package.
  35.  
  36.     TEST68.ASM    The entire instruction set of the 6801 CPU to use in
  37.             testing the 6801 cross-assembler.
  38.  
  39.     A18.DOC        The manual for the 1805A cross-assembler.  This file
  40.             can be printed with the following command line under
  41.             CP/M-80:
  42.  
  43.                 A>pip lst:=a18.doc[t8]
  44.  
  45.     A18.H        The source files for the 1805A cross-assembler.  The
  46.     A18.C        file A18.H also contains compile, assemble, and link
  47.     A18EVAL.C    instructions for all compilers that I have used with
  48.     A18UTIL.C    the package or that users have told me how to use with
  49.             the package.
  50.  
  51.     TEST18.ASM    The entire instruction set of the 1805A processor to
  52.             use in testing the 1805A cross-assembler.
  53.  
  54.     A685.DOC    The manual for the 6805 cross-assembler.  This file
  55.             can be printed with the following command line under
  56.             CP/M-80:
  57.  
  58.                 A>pip lst:=a685.doc[t8]
  59.  
  60.     A685.H        The source files for the 6805 cross-assembler.  The
  61.     A685.C        file A685.H also contains compile, assemble, and link
  62.     A685EVAL.C    instructions for all compilers that I have used with
  63.     A685UTIL.C    the package or that users have told me how to use with
  64.             the package.
  65.  
  66.     TEST685.ASM    The entire instruction set of the 6805 processor to
  67.             use in testing the 6805 cross-assembler.
  68.  
  69.     HEXTOS.C    A conversion utility to convert Intel hex object files
  70.             to Motorola S-record object files.  The program's
  71.             documentation is at the top of its source file.
  72.  
  73.      I not only wrote these pieces of software originally and rewrote them in
  74. "portable" C for all of you UNIX and IBM-PC users out there, but I am also the
  75. librarian for the disk, and as such, I am responsible for maintaining the
  76. packages.  I can only do this with YOUR help.  During the re-write, I noticed a
  77. few bugs in the BDS C versions.  These were never reported to me by any of you
  78. users, so I never knew to fix them.  PLEASE report bugs to me promptly so that
  79. I can get them fixed.  I am only a letter or a phone call away.
  80.  
  81.      The lists of compile, assemble, and link instructions for the packages are
  82. limited by my personal experience if YOU do not contribute.  In particular, I
  83. have no access to a real UNIX system nor to an IBM-PC of any kind with any of
  84. its dozen or so C compilers.  I need YOU to tell me how to use the package with
  85. these systems and others.
  86.  
  87.      Once the first cross-assembler (the 6801 package) is written, adapting it
  88. to other 8-bit or 4-bit processors (like the 1805A) is easy.  In fact, I once
  89. adapted one of the BDS C versions to a 12-bit processor (the PIC1650).  It only
  90. takes a couple of evenings for me to do it. What processors should be next, if
  91. any?  Get your votes in, either to me or to the Users' Group.  Otherwise, the
  92. selection of cross-assemblers will reflect only my needs, not yours.
  93.  
  94.      Having the author double as the librarian allows this disk to be a living,
  95. growing entity, but its growth will be stunted by my lack of resources if YOU
  96. do not contribute your share.  Speak up, for everybody's sake!
  97.  
  98.                         William C. Colley, III
  99.                         14 Hawthorne Drive
  100.                         Oberlin, OH 44074
  101.  
  102.                         ph (216)288-1122 x469 (day)
  103.                            (216)775-3680      (nite)
  104.  a real UNIX system nor to an IBM-PC of any kind with any of
  105. its dozen or so C compiler