home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / asmutil / asmed_1.zip / ASMED.MAN < prev    next >
Text File  |  1989-10-26  |  11KB  |  241 lines
  1. ASMED (C) 1989 - The Integrated Programmer's Editor
  2.  
  3. (Hey, I know most people won't bother to read this file. It's only a
  4. couple of short pages - and you NEED to read it to get anything out of
  5. this program!)
  6.  
  7. Thank you for trying ASMED. First, let me tell you what it does:
  8.  
  9. ---------------------------------------------------------------------
  10. Turbo Assembler   Turbo C++  Turbo Cobol   Turbo Fortan   Turbo ?????
  11. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12.  
  13. ASMED is a Programmer's Editor that is especially suited to Assembly
  14. Language, or any Command-Line compiler. If you're using MASM or TASM or
  15. a similar product, you can edit your programs and assemble them right
  16. from the Editor. If errors are found during assembly, ASMED will flag
  17. them and the cursor will be positioned on the line(s) with the
  18. error(s). You can then use function keys to jump to the next/previous
  19. errors. This operates much like Turbo C for those of you who have used
  20. the integrated environment. The Editor itself operates exactly like the
  21. Borland Editors, all the same editing commands are supported (TPascal,
  22. TC, Prolog, ETC.) You can also get help with your errors by pressing F1
  23. while the error is highlighted! ASMED maintains a Pick-List of the last
  24. 20 files you worked with. Also, you may have several Config files, and
  25. load the one you want for any particular compiler. This means you can
  26. have an integrated environment for just about any language you have.
  27.  
  28. BACKGROUND: The whole idea behind ASMED is to give you the same
  29. effectiveness the integrated compiler/editors give you. It is much
  30. easier and faster to write code and debug when the editor catches your
  31. errors and highlights them than to have to keep loading and unloading
  32. editors and assemblers. I wrote ASMED because I'm used to using the
  33. great Borland products with integrated environments, and when TASM came
  34. out, there was no editor to accompany it. Well, this and the fact that
  35. there is no Editor's that do this, outside of expensive commercial
  36. ones. ASMED is especially useful to people learning to program in
  37. assembly (who isn't, right?) because you can view your error messages
  38. on-screen while editing. ASMED is a simple program by nature, it is not
  39. fancy.
  40.  
  41. There is a pop-up help facility that references registers,
  42. interfacing languages, and some general Assembly help, mostly geared
  43. towards TASM. If anyone bothers to register and wants online help for a
  44. specific assembler/compiler, separate help files can be created for any
  45. product, sort of a Norton-Guides approach.
  46. ------------
  47. USER POLICY: You've seen it before - If you wish to use ASMED you need
  48. to register the program by sending $20.00 to the below address.
  49. Registration entitles you to many privileges, and updates. If enough
  50. people register, I'll put out a version with more error checking,
  51. multiple windows, extensive help, macros, and more even.
  52. ------------
  53. OPERATING INSTRUCTIONS: Since most people with access to this file
  54. already know how the Borland Turbo xxxxx editors work, I won't bother
  55. to explain the editing commands, they're all there though.
  56. Take note that you must have an assembler/Compiler to assemble
  57. programs! This is not a language but a connection to a Command-Line
  58. product.
  59.  
  60. INSTALLING ASMED: You should take a couple of steps to ensure that
  61. ASMED can find your assembler and linker. The first thing you should do
  62. after loading for the first time is select "Options." Then "Directory"
  63. and enter the directories where your programs are stored. Then select
  64. "Configure" and set up for the specific language you're using.
  65.  
  66. CONFIGURING: You need to enter the name of your language (whatever you
  67. type to start compiling (ie: TASM) You also must enter information
  68. about the way the product flags errors. This entails a little knowledge
  69. of the language you're using. To simplify, create a source file that
  70. you KNOW has errors in it, and compile/assemble it. You might want to
  71. dump the output to the printer. ASMED Needs to know three things about
  72. the way your compiler flags errors:
  73.  
  74. 1) What characters/strings it uses to signify an error
  75. 2) What characters/string it uses to signify the error line
  76. 3) ""   ""                   ""         ""  the error message
  77.  
  78. The following example explains how to configure ASMED for TASM.....
  79.  
  80. (The file TEST.ASM contains errors)
  81.  
  82. C:\TASM>TASM TEST.ASM
  83.  
  84. Turbo Assembler  Version 1.0   (c) 1988 Borland International
  85.  
  86. Assembling file: \TASM\TEST.ASM
  87.  
  88. **Error** (31) open procedure xxxx
  89. ^         ^  ^ Error Msg Flag (msg starts after this string)
  90. |         | Error Line Flag (Error Line # starts after this string)
  91. | Error Start Flag (Signals this line is an error)
  92.  
  93. **Warning** (42) Pointer Value Open
  94. (another sample error line)
  95.  
  96. Error messages: 2
  97. Warning messages: None
  98. Remaining Memory: 475k
  99. -----------------------------------------------------------------------
  100. See the * characters surrounding the "Error" messages? That is the
  101. Error Start Flag. You'd enter * (or **) in this field.
  102.  
  103. See the (  That is the Error Line Flag.
  104.  
  105. See the )  That is the Error Message Flag.
  106.  
  107. With these three fields set ( "*", "(", ")" ) you can use ASMED with
  108. TASM. Note there are additional fields (up to 3) for alternate flags.
  109. You need only enter them if they are needed. If your language uses more
  110. than one 'keyword' to flag errors, enter them in the alternate fields.
  111.  
  112. The rest of the config process is self-explanatory.
  113.  
  114. Including in this archive are configs for TASM, MASM, and the Turbo C
  115. Command-Line compiler. Refer to them if you need more assistance
  116. figuring out how to configure.
  117.  
  118. Error flagging in include files is not supported in this version.
  119.  
  120. NOTE: If you create config files, make sure and use the "SAVE CNF FILE"
  121. option, and give it an appropriate name (ie: CHASM.CNF) This way you
  122. can use any language products you want. ASMED will keep separate pick
  123. files for each product, providing you use separate names.
  124.  
  125. Linking and Running - You may Link and Run your programs from ASMED if
  126. you wish. Be sure and enter the correct Linker Name first. As the
  127. program is being linked, you view the process on screen. If you elect
  128. to RUN your program, memory will be compacted and ASMED will attempt to
  129. execute your program (only .EXE, .COM files!) Afterwards you will pop-
  130. back to the Editor.
  131.  
  132. Several steps are performed when you compile, link, or run a program to
  133. free up as much memory as possible (mem compacting.) So you should be
  134. able to assemble large programs.
  135.  
  136. ASMED Command-Line options.
  137. ---------------------------
  138.  
  139. ASMED [filename] [/Cconfig file] [/Ppick file]
  140.  
  141. /C will attempt to load the specified config file.
  142. /P ""   ""                            Pick File.
  143. You can also quick-load a file by typing the filename (WITH EXT IF IT'S
  144. NOT THE DEFAULT.)
  145.  
  146. Example:  ASMED GRAPH.ASM /CTASM.CNF /PTASM.PCK
  147.   Load GRAPH.ASM, TASM.CNF, and TASM.PCK
  148.  
  149. Editor Short-Cuts:
  150. ------------------
  151. F1      - HELP or Error Help when an error is highlighted
  152. Alt-X   - EXIT
  153. Alt-F3  - Pick List
  154. F3      - Load File
  155. F8      - Assemble or Compile
  156. F5      - Show Next Error
  157. F6      - Show Previous Error
  158. F10,ESC - Menu/Editor Toggle
  159.  
  160. Look to line 25 for a help line for every menu item.
  161.  
  162. A final thought: If you want to see the EXACT output the
  163. assembler/compiler produced, load the file "ASMERROR." It will be
  164. located in the "ASMED" directory you specified. If you're not sure of
  165. things, or you feel there was a 'wierd' error not flagged, check this
  166. file to see what happened.
  167. ---------------
  168. ***NOTE Also included for you is a nifty little printer program that
  169. can be used to send anything to the printer (PR.EXE.) You may specify
  170. line no's, margins, page len, condensed mode (Epson types), and send
  171. any file masks (*.ASM, *.TXT.....) Just type PR ? for a list. This is
  172. a good alternative to using PRINT or COPY xxx PRN because it will
  173. skip over the perfs in TF paper. Just put the file in your BIN
  174. directory and you'll be all set. PR.EXE is meant to go with ASMED
  175. only, not to be distributed alone. Thanks.
  176. ---------------
  177.  
  178. That should cover it. This doc is brief, but the program is VERY SIMPLE
  179. to use.
  180.  
  181. UTILITIES!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  182. -----------------------------------------------------------------------
  183.  
  184. ASMED now comes with some useful utilites to make developement easier for
  185. you. The are written in ASSEMBLER ans should be put in your path (BIN)
  186. so you can access them from anywhere. There are 6 programs now, but
  187. the list will grow rapidly so register your copy now. Only a couple
  188. of the utilities use parameters, so just type the name by itself for
  189. a list. The utilities are named by taking the first and last letter
  190. of the general purpose - ie: PR.EXE is the PrinteR program.
  191.  
  192. PR.EXE     - File printing program. Can set switches for page len,
  193.              print mode, margins, line #'s, etc. Also you can send
  194.              PR a mask (*.ASM) and it will print all files. It uses
  195.              nice internal buffers so it is fast. Use this instead
  196.              of COPY or PRINT if you want to skip the perfs on
  197.              tractor paper.
  198.  
  199. CR.COM     - Restores cursor. If you ever lose your cursor and
  200.              want it back, just type CR.
  201.  
  202. CT.EXE     - Convert numbers. Type in any number like 9d, Ah, 101b,
  203.              etc. and CT will show all values (hex, dc, bin) Use H
  204.              for Hex, D for Dec, and B for Binary.
  205.  
  206. MY.COM     - Shows you free memory (available.) This can help you
  207.              figure out how big a program is.
  208.  
  209. SE.COM     - Space on disk. Will tell you maximum and avalable
  210.              space on the current disk.
  211.  
  212. TL.EXE     - Terminal Emulator. A small term program. You can pass
  213.              baud, port, Sb, Db, Parity, toggle CR/LF, and Echo. Also
  214.              a DOS Shell for transfers, etc. This is a nice little
  215.              'always available' term program.
  216.  
  217. PE.EXE     - Mem-Res Paste program. A simple paste program that lets
  218.              you define all or part of the current screen and then
  219.              save it to a plain ascii file. The file saved to is
  220.              called "PASTE.CS" and is appended-to if it already
  221.              exists. F-10 will unload PE from memory.
  222.  
  223.  
  224.  
  225. THANKS, AND ENJOY!!!!!!!
  226.  
  227. Register At:                                 Comments ALWAYS welcome.
  228.  
  229.              CHICAGO SOFTWARE
  230.              1805 BRUNETTI WAY
  231.              SUITE 555
  232.              SPARKS, NV 89431
  233.              CIS 72207, 247
  234.              GENIEMAIL  J.CHICAGO
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.