home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / Add-Ons / CodeWarrior / DASM 2.0 / DASM ReadMe < prev    next >
Encoding:
Text File  |  1997-04-22  |  4.6 KB  |  87 lines  |  [TEXT/ttxt]

  1. IFD Macro Data Assembler Readme, 10-Apr-97
  2.  
  3.  
  4. I—What is DASM?
  5.  
  6. The IFD Macro Data Assembler (DASM) is available as both an application and a plug-in compiler and panel for use with Metrowerks CodeWarrior IDE v1.3 or later. DASM allows you to write data "programs" which are assembled into binary data your program can later load and use. This data can be saved to a binary file or resource, or linked with a program in the CW IDE.
  7.  
  8.  
  9. II—Distribution.
  10.  
  11. You should have recieved the following files in this distribution:
  12.  
  13. 1. Data Assembler
  14. 2. Data Assembler Panel
  15. 3. DASM Documentation
  16. 4. DASM Read Me (this file)
  17. 5. Version History
  18. 6. TEST.SIT (compress test files)
  19. 7. DASMSRC.SIT (compressed source files & projects)
  20. 8. DASM application
  21.  
  22. If you recieved an incomplete distribution, please contact the author. (See "Contacting the Author" below.) And, before writing, the source to the MacOS and DOS applications is not missing, it is not included because these sources rely on ouside libraries and are thus much more difficult to distribute. If you really have a need for the application sources, let me know. I do include the main source file for the DOS application to show how easy it is to modify the actual assembler to fit inside an application shell. (yes, those really are MacOS calls, and yes, they do work…)
  23.  
  24. Re–Distribution
  25.  
  26. Non–profit distribution is allowed/encouraged as long as it is distributed as an entire package, without modifications! For-profit distribution (which includes shareware collections sold in any manner other than at user’s groups) requires that you not only obey the collection requirements (see next paragraph) but you must also donate five (5) copies (at no cost) of the collecction to a high school of your choice, and send the author proof of same w/the authors complimentary copies.
  27.  
  28. If you want to include this software in some sort of software collection (i.e. CD, etc.) you are required to contact the author to insure you distribute the latest version(s), and that you send the author two (2) copies of the collection. (See "Contacting the Author" below.)
  29.  
  30. III—Installation
  31.  
  32. Installation of the IDE compiler is simple, just copy the folder "DASM Plugins" to the CodeWarrior PlugIns folder.
  33. To install the Application, just drag it to any folder you wish. You may also wish to make an alias of the application to place on your desktop. Then, just drag files to be assembled onto the DASM application alias.
  34.  
  35. IV—Documentation
  36.  
  37. The documentation file is a Nisus Writer document, but you can read this file just as easily, if not as nicely formatted, by dragging it over the SimpleText, TeachText, or your favorite text document viewer's icon.
  38.  
  39. V—KNOWN BUGS:
  40.  
  41. none
  42.  
  43. VI—Desired Improvements
  44.  
  45. 1 -  Ability to output more than one resource / binary per source file.
  46.  
  47. 2 - Win95 / NT CW IDE Plug In version. Have not found the DOCS yet (do the exist?), but perhaps soon...
  48.  
  49. VII—Contacting the Author
  50.  
  51. Lane Roathe
  52. 115 Le Point St.
  53. Arroyo Grande, CA 93420
  54. <lane@xtremeplanet.com>
  55.  
  56. Lane is a partner in
  57.  
  58. genX Software LLC
  59. 4211 Braod St., Suite B
  60. San Luis Obispo, CA 93401
  61. 805-547-1182 / 805-547-1919 fax
  62. <http://www.genxsoftware.com>
  63.  
  64. and contracts for:
  65.  
  66. Ideas From the Deep, Ltd.
  67. P.O.Box F-42222
  68. Newport, Grand Bahama, Bahamas
  69. <http://www.ifd.com>
  70.  
  71. VIII—Notes
  72.  
  73. • MacOS Application Sources
  74.  
  75. The included Application, DASM, does not have accompanying source. This is because, a) the source for the actual assembler is the same, b) the source for the main program is nearly identical to that of the x86 source, and c) the actual application shell contains several outside libraries that are required to compile it (DropShell & WASTE, for example).
  76.  
  77. • x86 (MS-DOS) EXE sources
  78.  
  79. The source to the DOS application shell is included, but lacks a) the associated include file, and b) many associated library files. This is because the application, as you can tell by looking at it, requires a MacOS memory, resource, and file manager which I have written but not yet made public. I'm working on a clean up that can be distributed independent of the rest of my Mac emulation code (window, dialog, device, control, and other managers, as well as some of Color QuickDraw).
  80.  
  81. If, for some reason, you really want the sources to the MacOS or DOS applications, please drop me a line. No promises, but I'll do what I can, when I can. Thanks for your understanding!
  82.  
  83. IX—Copyright  & Liability Disclaimer
  84.  
  85. All software and source code Copyright © 1995-97 Ideas From the Deep, Ltd.
  86.  
  87. Neither Ideas From the Deep nor the program's author make any guarantees about the performance or reliability of this software. Any and all risk of it's use is your own.