home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / asmed.zip / ASMED1.DOC < prev   
Text File  |  1989-04-30  |  9KB  |  191 lines
  1. ASMED (C) 1989 - The Integrated Assembly Language Editor
  2.  
  3.  
  4.  
  5. Thank you for trying ASMED. First, let me tell you what it does: 
  6.  
  7. ASMED is a Programmer's Editor that is especially suited to Assembly 
  8. Language. If you're using MASM or TASM or a similar assembler, you can 
  9. edit your programs and assemble them right from the Editor. If errors 
  10. are found during assembly, ASMED will flag them and the cursor will be 
  11. positioned on the line(s) with the error(s). You can then use function 
  12. keys to jump to the next/previous errors. This operates much like
  13. Turbo-C for those of you who have used the integrated environment. The
  14. Editor itself operates exactly like the Borland Editors, all the same
  15. editing commands are supported (TPascal, TC, Prolog, ETC.) 
  16.  
  17. BACKGROUND: The whole idea behind ASMED is to give you the same 
  18. effectiveness the integrated compiler/editors give you. It is much 
  19. easier and faster to write code and debug when the editor catches your 
  20. errors and highlights them than to have to keep loading and unloading 
  21. editors and assemblers. I wrote ASMED because I'm used to using the 
  22. great Borland products with integrated environments, and when TASM came
  23. out, there was no editor to accompany it. Well, this and the fact that 
  24. I couldn't afford a commercial editor that does the same thing. ASMED
  25. is especially useful to people learning to program in assembly (who 
  26. isn't, right?) because you can view your error messages on-screen while
  27. editing. ASMED is a simple program by nature, it is not fancy, and
  28. there is not alot of error checking performed. It does work nicely
  29. though. You might say it's in a beta test state right now...........I
  30. wanted to make it as small as possible to free up memory when
  31. assembling. It uses only about 45k so you should be able to assemble
  32. very large programs. Also included is an ASCII and Key Scan Code chart
  33. for reference. You should find ASMED useful until Borland comes out
  34. with a full-blown integrated environment for their assembler products.
  35. If not, I'll keep updating ASMED. 
  36.  
  37.  
  38. USER POLICY: Basically, there is no user policy, if you find ASMED 
  39. useful, use it! You do not have to send in any money (but if you want 
  40. to, go ahead.) I would ask that you send me your comments though. If 
  41. there's any sort of response I will implement the changes you desire. 
  42.  
  43.  
  44. OPERATING INSTRUCTIONS: Since most people with access to this file 
  45. already know how the Borland Turbo xxxxx editors work, I won't bother 
  46. to explain the editing commands, they're all there though. In addition 
  47. to the edit commands, there are 8 functions (F1-F8) that can be used.
  48. These are reflected in the top and bottom status lines of the editor 
  49. window.  
  50.  
  51. F1 - HELP (N/A AT THIS TIME, SORRY) 
  52. F2 - SAVE CURRENT FILE 
  53. F3 - LOAD A NEW FILE 
  54. F4 - DOS SHELL (TO LINK, RUN ???) 
  55. F5 - NEXT ERROR - JUMP TO NEXT ERROR AND HIGHLIGHT WITH MESSAGE 
  56. F6 - PREVIOUS ERROR - SAME AS ABOVE WITH PREVIOUS ERRORS 
  57. F7 - CHARTS - VIEW ASCII CODES AND KEY SCAN VALUES IN WINDOW 
  58. F8 - ASSEMBLE - THIS WILL CALL YOUR ASSEMBLER AND ASSEMBLE YOUR CODE 
  59.  
  60. Take note that you must have an assembler to assemble programs! This is
  61. not a language but a connection to an assembler product.  
  62.  
  63. INSTALLING ASMED: You should take a couple of steps to ensure that 
  64. ASMED can find your assembler and linker. No, there isn't an 
  65. extravagant install program, just a simple config file that contains 
  66. the path names where your assembler files reside, and an error flag 
  67. character used to catch errors. Explanation is this: ASMED reads the 
  68. config file (if it exists) and uses the paths to run the assembler, if 
  69. you have your "PATH= " set, or use any memres path programs, you won't 
  70. even need to bother with this. The config file is as follows:
  71.  
  72. A plain ascii file, 8 lines long in this format -  
  73.  
  74. line 1 - assembler name (TASM, MASM, etc.) 
  75. line 2 - linker name (LINK, TLINK, etc.) 
  76. line 3 - error flag. This is the character(s) that the assembler 
  77. produces when it finds an error. For TASM, it is the * character, for 
  78. MASM, it is the ( character. You get this information by looking at the
  79.  
  80. output the assembler produces when it finds an error. As an example,
  81. consider this TASM example session assembling the file "test.asm": 
  82. ---------------------------------------------------------------------- 
  83. C:TASM>TASM TEST.ASM 
  84.  
  85. Turbo Assembler  Version 1.0   (c) 1988 Borland International 
  86.  
  87. Assembling file: \TASM\TEST.ASM 
  88.  
  89. **Error** (31) open procedure xxxx 
  90.  
  91. Error messages: 1 
  92. Warning messages: None 
  93. Remaining Memory: 475k
  94. -----------------------------------------------------------------------
  95.  
  96. See the * characters surrounding the "Error" message? That is all ASMED
  97.  
  98. needs to find the error messages and line numbers. Although the *'s 
  99. occur in multiples of two, only one is needed by ASMED to distinguish 
  100. an error. In MASM, the errors look more like: ERROR: (31) 127:xxxxx 
  101. And the "(" character is enough. At any rate, you have up to 3 
  102. characters you can use for this depending on your particular assembler.
  103.  
  104. But make sure this character ONLY appears on lines with errors. If 
  105. you're using TASM, just use the *. 
  106.  
  107. line 4 - assembler path (\tasm, etc.) 
  108. line 5 - linker path (\tasm\link, etc.) 
  109. line 6 - ASMED path (\Editor, etc.) 
  110. line 7 - This tells ASMED how many parameters your assembler takes.
  111. For example: TASM only takes one parameter, the .asm code file name.
  112. MASM, on the other hand, takes 4: ASM, LST, CRF, NUL. So in order
  113. to operate correctly, if you use MASM set this to 4, TASM set this to
  114. 1. Any other assembler and you'll have to enter your own number. The
  115. maximum is 4 however. If your assembler takes more than 4, ASMED will
  116. prompt you for the other names on line 24. It is MUCH easier to just
  117. set this paramter correctly and not have to enter ANY filenames.
  118.  
  119. line 8 - Command line paramters. If you want to set switches with your
  120. assembler, (/M, /L, etc...) enter them on this line. They will be sent
  121. along with the other assembler commands.
  122.  
  123. When you put it all together, a config file might look like this:
  124.  
  125. TASM
  126. TLINK
  127. *
  128. \ASSEMBLY
  129. \LINK
  130. \EDITOR
  131. 1
  132. /M /T /Z /S-
  133.  
  134. If you want to use the current directory, just use a blank line. This 
  135. is probably a bit confusing, the sole purpose of the config file is to 
  136. let ASMED know where to find your assembler files. If you have pathing 
  137. setup (ie:PATH=C:\TASM;C:\EDITOR...), you don't have to worry about 
  138. this. The config file must be named "ASMED.CNF" and can reside in any 
  139. directory. You can use any ascii editor to change the file, even ASMED.
  140.  
  141. Remember, if you botch up this file, ASMED won't be able to find the 
  142. right files needed to work properly, but will still be a good editor. 
  143. If you need help, leave me a message on CIS (72207, 247.) 
  144.  
  145. Next, there are up to two (2) command line parameters you can send 
  146. while starting ASMED. 1) filename, 2) subdir that the ASMED.CNF file is
  147.  
  148. in. The reasoning behind this is simple, so you can run ASMED from 
  149. anywhere on your hard drive and still load the config file, even if 
  150. it's in yet another subdir. Say you have pathing set up so you can run 
  151. ASMED from anywhere, well, the config file might not be in the 
  152. directory you type "ASMED" from so you can specify a path. Example: 
  153.  
  154. ASMED test /\bin 
  155.  
  156. This will run ASMED, load the file TEST.ASM, and look for the config 
  157. file in the \bin directory. The config parameter must start with a 
  158. slash (/) and include the full pathname. You know you're doing it right
  159.  
  160. when you get the little tree symbol (/\) The parameters can be in any 
  161. order (filename path or path filename.) If you omit a filename, you 
  162. will be prompted to enter a file to edit. If you omit the config path, 
  163. ASMED will look in the default directory. If no config file exists, 
  164. defaults for TASM go into effect. 
  165.  
  166. Once you load the editor, everything is pretty cut-and-dried. Look at 
  167. the top and bottom lines for function key instructions, everything else
  168.  
  169. is just like the turbo editors, using the ctrl key command sequences 
  170. (ie:ctrl-k-p to print a block.) <ESC> will exit the program. 
  171.  
  172. NOTE: After you assemble, if there were errors, they will be 
  173. highlighted along with the assembler error message, displayed on line 
  174. two, and the cursor will be on the actual line of your code where the 
  175. error took place. ALL messages are displayed on line 2 or line 24. If 
  176. you can't figure out what's going on, check these lines! Also, if there
  177.  
  178. is a problem when you try and assemble, look at line 24, if it says  
  179. "bad command or filename" then chances are your assembler was not 
  180. found.  
  181.  
  182. I thinks that's it. If there's anyone out there that wants to learn 
  183. assembly, there's no excuses not to now right?   
  184.  
  185. GOOD LUCK, JOE 
  186.  
  187.  
  188.                           CHICAGO SOFTWARE 
  189.                           1805 BRUNETTI WAY 
  190.                           SPARKS, NV 89431 
  191.                           CIS 72207, 247