home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / barfly / editor-support / barflyinced / basmscripts.doc < prev   
Text File  |  1977-12-31  |  6KB  |  154 lines
  1.  
  2.  
  3.         BarflyInCED (BasmAssemble.ced & BasmNextError.ced)
  4.        ====================================================
  5.  
  6. Two ARexx scripts for the use of Basm directly from within CygnusED.
  7.  
  8.  
  9.  0. CONTENTS
  10. -------------
  11.  
  12.  1. Disclaimer
  13.  2. Requirements
  14.  3. Installation
  15.  4. Usage
  16.  5. Limitations
  17.  6. Author
  18.  
  19.  
  20.  1. DISCLAIMER
  21. ---------------
  22.  
  23. Copyright (c) 1995 by Christian Rattei.
  24.  
  25. Use  these  scripts  at  your  own  risk.  I,  the  author, cannot be made
  26. responsible  for  any  damage  that  is  directly  or indirectly caused by
  27. the use of these scripts.
  28.  
  29. These  scripts  are  freeware.  This  means  they  may be copied freely as
  30. long  as  all  files  are kept together and remain unchanged. This package
  31. may   be  uploaded  to  Bulletin  Board  Systems  and  FTP  servers.  This
  32. package    may    be   included   in   Public-Domain   collections,   too.
  33. Please only upload/spread the original archive 'BarflyInCED.lha'.
  34.  
  35. If  you  have  paid  more  than  some units on your phonebill or the price
  36. of an empty floppy disc only for these scripts, someone betrayed you.
  37.  
  38.  
  39.  2. REQUIREMENTS
  40. -----------------
  41.  
  42. To  work with these scripts it is required that you have installed Barfly,
  43. CygnusED 2.12 or newer and last but not least ARexx on your Amiga.
  44.  
  45.  
  46.  3. INSTALLATION
  47. -----------------
  48.  
  49. Copy  the  two  files  'BasmAssemble.ced'  and 'BasmNextError.ced' to your
  50. 'REXX:' directory.
  51.  
  52. Start  CygnusED  and  assign  the  scripts  to two F keys (select the menu
  53. Special,  DOS/ARexx  interface  »  Install  DOS/ARexx  cammand...),  let's
  54. say 'BasmNextError.ced' to F9 and 'BasmAssemble.ced' to F10.
  55.  
  56. If  CygnusED  was started from the Workbench, Basm has to be in 'C:' or in
  57. the  current directory, otherwise BasmAssemble.ced will not work correctly
  58. (if  CygnusED was started from the CLI, Basm may be anywhere in the path).
  59.  
  60.  
  61.  4. USAGE
  62. ----------
  63.  
  64. Load  the  source  file  you  want  to assemble into CED. When you want to
  65. assemble  the  file,  press  F10  (or  the  key  that  you  have  assigned
  66. 'BasmAssemble.ced' to) while CED's active view is one of the views of your
  67. source  file.  If you made some changes to the source file you do not need
  68. to  save before, BasmAssemble.ced does this automatically if the number of
  69. changes displayed in the view's title is not equal to 0.
  70.  
  71. BasmAssemble.ced  now  invokes  Basm,  directing all output of Basm to the
  72. file  'RAM:Basm_Errors'.  When  Basm  is done, BasmAssemble.ced looks if a
  73. file  named 'RAM:Basm_Errors' is already loaded in the current CED. If so,
  74. that  view  is  made CED's active view; otherwise a new one will be opened
  75. just  below the current active view. Then 'RAM:Basm_Errors' will be loaded
  76. to the active view and BasmAssemble.ced will anlyse that file.
  77.  
  78. If  everything  during  assembly went fine, a little requester will appear
  79. stating that no errors/warnigs were found. After answering this requester,
  80. the  view  from which you started BasmAssemble.ced will be the active view
  81. again.
  82.  
  83. If  any  errors/warnings  occured  during  the  assembly, BasmAssemble.ced
  84. automatically invokes BasmNextError.ced.
  85.  
  86. BasmNextError.ced,  started from BasmAssemble.ced or by pressing F9 or the
  87. key you have assigned it to, does the following:
  88.  
  89. Beginning  at  the  current cursor position in 'RAM:Basm_Errors' it starts
  90. searching for errors/warnings. If none were found, a little requester will
  91. appear  stating  that  no more errors/warnings were found. After answering
  92. this requester the previously active view will be re-activated.
  93.  
  94. If  any  error/warning  is  found, BasmNextError.ced highlights the error/
  95. warning  message in 'RAM:Basm_Errors', then it re-activates the previously
  96. acitve  view  and moves the cursor to the line and column where the error/
  97. warning occured. Now you can correct your source file or do anything else.
  98. If   you   want   to   jump   to   the   next  error/warning,  just  start
  99. BasmNextError.ced again.
  100.  
  101. When  done  with  all  errors/warnings,  just start BasmAssemble.ced again
  102. until everything goes fine.
  103.  
  104.  
  105.  5. LIMITATIONS
  106. ----------------
  107.  
  108. · If  you want to assemble your source file with any assembler options you
  109.   have  to  specify  them  at  the beginning of your source file or in the
  110.   global  options  file 'ENV:BasmOption'. You cannot give BasmAssemble.ced
  111.   any assembler options for Basm.
  112.  
  113. · If   you   are   a   user   of   CygnusED   2.12,  BasmAssemble.ced  and
  114.   BasmNextError.ced  only work in the first running copy of CED. This is a
  115.   limitation  of  CED  2.12  which only has one ARexx port for all running
  116.   copies  of  itself  and  directs  all  ARexx commands to the first copy.
  117.   Sorry,  there  is  no  chance  for an ARexx script to even find out from
  118.   which copy it was invoked, so there can be no error message or something
  119.   like that.
  120.  
  121. · ARexx  scripts  are executed significantly faster (about 30% to 40% !!!)
  122.   when  started  from the CLI (via the rx command) compared to scripts run
  123.   directly  from  CED.  I  am not sure for 100% but this seems to be CED's
  124.   fault.  I  played  a lot with task priorities of CED, RexxMaster and the
  125.   CLI from which the scripts were started, but that problem didn't seem to
  126.   have anything to do with task priorities.
  127.  
  128.   Both  scripts  may  be  given  the  name  of CygnusED's Arexx port as an
  129.   argument.  So  it  is  possible  to  start  the scripts via rx even from
  130.   within  CED,  giving the ARexx port of CED as an argument to the scripts
  131.   (e. g. 'rx BasmAssemble.ced rexx_ced').
  132.  
  133.   This  is a perfect solution for users of CED 2.12, but if you are a user
  134.   of CED 3.5 this solution is only perfect as long as you always work with
  135.   one  copy  of  CED; if you work with multiple copies of CED in memory at
  136.   the  same  time  the  scripts  are  fixed to the copy with the specified
  137.   ARexx port.
  138.  
  139.   Note:  CLI commands started from ARexx scripts (via address command) are
  140.   not  slowed  down  when  the  script is started from within CED (so Basm
  141.   itself always runs with the same speed).
  142.  
  143.  
  144.  6. AUTHOR
  145. -----------
  146.  
  147. If you have any suggestions, ideas or bug reports, feel free to contact me
  148. (e-mail preferred). Gifts are welcome ;-).
  149.  
  150. Christian Rattei
  151. Wankstraße 10
  152. 82362 Weilheim          e-mail: rattei@informatik.tu-muenchen.de
  153. Germany                 irc:    chrisR (#amigager)
  154.