home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / Geneve / mdos / 80column_funnelweb / easm.txt < prev    next >
Text File  |  2006-10-19  |  9KB  |  315 lines
  1.  
  2.  
  3. .LM 8;RM 72;CE 3
  4. FUNNELWEB Vn 4.40 E/A EMULATION 
  5. ------------------------------- 
  6. .FI
  7.  
  8.  
  9. (1) Programmer's Editor 
  10. ~~~ ~~~~~~~~~~~~~~~~~~~ 
  11.  
  12. If the Central Menu Screen shows the
  13. Assembler side, selection of Editor
  14. loads the TI-Writer Editor modified for
  15. use as a program code Editor, including
  16. a new mode specifically for assembly
  17. source entry.  All relevant
  18. improvements listed in FWDOC/TIWR &
  19. EDAV still apply.  It is generally more
  20. convenient with these modifications
  21. than the E/A Editor ever was. 
  22.  
  23. .LM +3;RM -3
  24. (i) The Editor now functions with
  25. word-wrap disabled, E/A tab defaults
  26. set, and files are saved to disk with
  27. no final tab record appended.  Incoming
  28. tab records are still recognized.  The
  29. disabling of word-wrap may spare you
  30. the distressing sight of 99 sectors of
  31. source code reformatting into one giant
  32. paragraph.
  33.  
  34. (ii) If a DIS/FIX 80 file must be
  35. written to disk, say in editing of
  36. uncompressed object code, use the PF
  37. option as F DSKetc instead of SF.  This
  38. is described in the TI-Writer manual.  
  39.  
  40. (iii) The Source Editor loads C2 as its
  41. character set from the E/A system
  42. drive.  As supplied this contains a
  43. larger set than C1, quite suitable for
  44. Assembly source which typically has a
  45. high proportion of whitespace.  If this
  46. set is not wanted, copy C1 or character
  47. file of your choice over C2.  The
  48. 5-sector form saves disk space, but the
  49. 9-sector files from TI-Writer may be
  50. used.  
  51.  
  52. (iv) Pressing <ctrl-B> splits the
  53. current line much as <fctn-2> does in
  54. word-wrap mode in the TI-Writer editor.
  55. The effect is not recoverable except by
  56. retyping the blank part of either line.  
  57.  
  58. (v) The <ctrl-0> key toggles a new
  59. Editor mode for assembly source code
  60. editing (ASMode), indicated by a
  61. diamond shaped cursor.  In ASMode the
  62. alpha-lock may be left up for
  63. convenience in typing comments, and as
  64. each line is entered into the Text
  65. Buffer it is parsed as an assembly
  66. source line and converted to upper case
  67. where appropriate.  Some common typing
  68. errors are flagged by a bloop if found.
  69. This will also happen on COPY
  70. directives but does not indicate any
  71. error there however. 
  72.  
  73. .LM -3;RM +3
  74.  
  75. (2) Assembler 
  76. ~~~ ~~~~~~~~~ 
  77.  
  78. This loads the E/A Assembler, in a
  79. version modified for FUNNELWEB.  See
  80. FWDOC/SCLL for use of Script-Load with
  81. the Assembler as a multiple file MAKE
  82. utility.  
  83.  
  84. .LM +3;RM -3
  85. (i) The filenames remain visible on the
  86. screen while the Assembler is
  87. executing.  Some default entries are
  88. provided, but may be deleted or added
  89. to as desired. 
  90.  
  91. (ii) If a filename is found in the
  92. mailbox by the freshly loaded
  93. Assembler, it is written up as the
  94. source filename, and with the last two
  95. characters altered from /S or ;S to /O
  96. or ;O as the object filename, or else
  97. just repeated for the user to modify as
  98. desired. 
  99.  
  100. (iii) The AID <fctn-7> key calls up the
  101. Quick Directory routine at any time
  102. during the filename entry process.  For
  103. this to be available file QF must be
  104. present on the disk in the boot drive
  105. when the Assembler is loaded.  It
  106. returns on exit to the start of the
  107. entry screen with marked file installed
  108. as normal. 
  109.  
  110. (iv) The source filename is passed back
  111. to the Editor via the mailbox, and is
  112. immediately available for LF when the
  113. Editor is invoked after an Assembly.
  114.  
  115. (v) The object filename is passed back
  116. to the Object file loaders, and appears
  117. as default. 
  118.  
  119. (vi) Entering any single character for
  120. List Device and <enter>ing will cause
  121. the full system print device name to
  122. appear. 
  123.  
  124. (vii) The assembler files load as a
  125. normal Option 2 (E/A 5) program, so
  126. other Assemblers in this form may be
  127. substituted. . 
  128.  
  129. .LM -3;RM +3
  130.  
  131. (3) Program File Loader 
  132. ~~~ ~~~~~~~~~~~~~~~~~~~ 
  133.  
  134. Selection of Option 3 from this central
  135. menu screen sets up a selection screen
  136. with 8 choices of Load environment
  137. shown.  The AID <fctn-7> key for QD is
  138. available only in the Central Menu and
  139. Loaders screens.  Filenames entered
  140. after the Loaders option is chosen may
  141. use disk volume or hard disk patn names
  142. and be up to 25 characters long.  A
  143. full CRU search mechanism as used in SD
  144. and DR for sector access is implemented
  145. for program file loading, but not for
  146. the object loaders which use the normal
  147. E/A utilities. 
  148.  
  149. .LM +3;RM -3
  150. (i) Option 1 emulates the TI-Writer
  151. module which hands over control in the
  152. GPL workspace, with Text mode set, and
  153. with a full set of characters 0-127
  154. loaded from GROM even if they are
  155. immediately overwritten by CHARA1.  The
  156. utility must be in E/A program file
  157. format.  An attempt is made to load C1
  158. from the boot drive, but no error is
  159. issued if it is not found.
  160.  
  161. (ii) Option 2 sets up a GPL type of
  162. environment, as does E/A 5, adequate
  163. for most programs normally loaded by
  164. the E/A RUN PROGRAM FILE loader from
  165. GPL.  Handover is in the GPL workspace
  166. and the presence of the E/A utilities
  167. cannot be assumed. 
  168.  
  169. (iii) Option 3 supplies the E/A RUN
  170. PROGRAM FILE function for Program files
  171. that have been prepared from E/A object
  172. files which do use the E/A utilities.
  173. Handover is in the USRWSP at >20BA, but
  174. this is not written to after file
  175. loading starts so that it does not
  176. corrupt files which ignore the E/A
  177. utilities and load over them anyway. 
  178.  
  179. The utilities are loaded if file EA is
  180. present on the disk in the boot drive
  181. when the option is selected (not
  182. necessary when running from the E/A
  183. module).  If it is not found a warning
  184. honk is given and a discreet little
  185. message pops up.  GPLLNK has been
  186. modified to work with FUNNELWEB (see
  187. FWDOC/REPT for details) and the first
  188. free address in low memory is
  189. unaltered. 
  190.  
  191. (iv)  To load assembly program files
  192. from cassette, use either the E/A
  193. module directly or a special loader
  194. program such as CASSLOAD from XB.  
  195.  
  196. .LM -3;RM +3
  197.  
  198. The last program file in a sequence
  199. may overwrite FUNNELWEB at the top
  200. of high memory without trouble
  201. while loading, but if a utility
  202. overwrites FUNNELWEB either in
  203. loading or while running, it should
  204. return to the Title Screen on exit
  205. or else reload FUNNELWEB.
  206.  
  207.  
  208. (4) Object file loaders 
  209. ~~~ ~~~~~~~~~~~~~~~~~~~ 
  210.  
  211. LOAD/RUN handles E/A object files,
  212. compressed or not.  Files which load
  213. over FUNNELWEB in the top of high
  214. memory, if not auto-starting, will lock
  215. up the computer, and may be loaded with
  216. Script-Load instead.  Otherwise
  217. programs written strictly to E/A manual
  218. specifications should run correctly.
  219. Common sources of difficulty are
  220. discussed in FWDOC/REPT.  The EA file
  221. must be on the disk in the boot drive
  222. when this option is chosen or a warning
  223. is given (unless running with the E/A
  224. module).  DEBUG and SAVE from your E/A
  225. package both work normally.  
  226. .LM +3;RM -3
  227.  
  228. (i) Options 5-8 give variations on
  229. Load/Run.  The normal Load/Run option
  230. sets the last free address in high
  231. memory (LFHM) pointer in UTLTAB to
  232. protect FUNNELWEB as far down as the
  233. User List code and/or FSAVE (currently
  234. >E98F). 
  235.  
  236. (ii) SCRIPTLOAD (Option 5) is a batch
  237. file loader for object files.  The
  238. Utility pathname with SCRIPT as
  239. filename is supplied as default starter
  240. entry.  See FWDOC/SCLL for details of
  241. SL.
  242.  
  243. (iii) LOW-LOADER (Option 6) allows
  244. object files to be loaded starting in
  245. low memory at >2000, and then
  246. continuing in hi-mem.  All normal REFed
  247. utilities are available as REFs.  The
  248. REF/DEF table starts at >E200 and
  249. builds down from >E138.  Code must not
  250. be AORGed above this.  FSAVE recognizes
  251. Low-Loaded files.  See FWDOC/SCLL for
  252. details of LL.  
  253.  
  254. (iv) If Option 7 is selected the LFHM
  255. is reset to the E/A default of >FFD7.
  256. This allows the last relocatable
  257. autostarting object file to load over
  258. FUNNELWEB if necessary, there being no
  259. memory contention because the autostart
  260. hands over to the program without
  261. returning to FUNNELWEB. 
  262.  
  263. (v) Option 8 intercepts the Autostart
  264. of object files and the DEF table is
  265. displayed as for a normal file load.
  266. The LFHM is as for Option 4.  
  267.  
  268. (vi) If a Duplicate DEFinition load
  269. error occurs, the offending DEF is
  270. displayed after the error message. 
  271.  
  272.  
  273. .LM -3;RM +3
  274.  
  275. The Run part of the Load/Run procedure
  276. generally follows E/A conventions
  277. except that more information and help
  278. is provided along the way.  Pressing
  279. <enter> with a cleared filename entry
  280. (use <fctn-3> or clear to blanks)
  281. transfers to the RUN function.  This
  282. matches E/A module function.  
  283.  
  284. .LM +3;RM -3
  285. (i) RUN is activated by cursor driven
  286. selection from a screen display of the
  287. DEF table.  The DEF table may be
  288. inspected at any time during a multiple
  289. file load by pressing <enter> after
  290. clearing the filename.  The display
  291. shows both DEFs, and also now currently
  292. unresolved REFs which usually will
  293. appear with the first two characters
  294. either blank or with unrecognizable
  295. patterns.  Cursor keys <fn-S> and
  296. <fn-D> drive the cursor through the DEF
  297. entries on the current page, while
  298. PROC'D (or <ctrl-A>) transfers control
  299. to the program entry marked by the
  300. cursor, and REDO returns to load
  301. another file.  Pressing <enter> will
  302. page through DEF tables larger than a
  303. single screen.  Pressing BACK, <fn-9>
  304. or <ctrl-C>, aborts the load sequence.
  305.  
  306. (ii) If an Unresolved REFerence is
  307. detected when RUN is invoked, the first
  308. such REF found is displayed after the
  309. error message.  
  310.  
  311.  
  312. .LM -3;RM +3
  313.  
  314. ÇåÇ¡Éòƒ╒╒╒╒╒╒╒╒╒╒╒╒╒Çïáááááááááááááááááááááá
  315.