Basmify
                                  =======
                                    1.0

ARexx  scripts for using the assembler Basm of Barfly from within the editor
CygnusED.


 0. CONTENTS
-------------

 1. Disclaimer
 2. Requirements
 3. Installation
 4. Usage
 5. Limitations
 6. Author
 7. Credits


 1. DISCLAIMER
---------------

Copyright (c) 1995 by Ulrich Flegel.

Permission  is granted to make and distribute verbatim copies of this manual
provided  the  copyright  notice and this permission notice are preserved on
all copies.

No  guarantee  of  any  kind  is  given  that the programs described in this
document  are  100% reliable.  You are using this material at your own risk.
The  author  can  not  be made responsible for any damage which is caused by
using these programs.

Permission is granted to include this package in Aminet CD-ROMs.

None  of  the programs may be included or used in commercial programs unless
by written permission from the author.

None  of  the programs may be modified in any way.  For improvements contact
the author.

None  of  the  programs  may  be  used  on any machine which is used for the
research,  development,  construction,  testing  or production of weapons or
other  military  applications.  This also includes any machine which is used
for training persons for any of the above mentioned purposes.


 2. REQUIREMENTS
-----------------


· Barfly

· CygnusEd 3.0 or higher

· ARexx


 3. INSTALLATION
-----------------

Copy  the files 'Assemble.ced' and 'NextError.ced' to any directory.  Assign
'Basmify:'  to  this directory.  If you don't the scripts will not find each
other.   Then you have to change the 'NextError' and 'Assemble' variables in
the scripts to fit the pathnames.

Adapt  the BAsmPath variable in the 'Assemble.ced' script to the pathname of
the directory where your BAsm is, so BAsm needs not to be in your path.

In  CygnusED  assign  the  scripts  to  two  function  keys (menu:  Special;
DOS/ARexx interface »; Install DOS/ARexx cammand...), say 'NextError.ced' to
F9 and 'Assemble.ced' to F8.


 4. USAGE
----------

Start  CygnusEd and load the source code you want to assemble.  For assembly
press  F8 (or the key you have assigned 'Assemble.ced' to) in the view where
the  source code is located.  'Assemble.ced' saves automatically any changes
to the source before assembly.

'Assemble.ced'  invokes  Basm  and  if  no  errors  occured  you will get an
apropriate  message.   If  there  were  errors  or  warnigs you are told and
'NextError.ced' is invoked automatically to display the first error/warning.

Subsequent   keypresses  on  the  'NextError.ced'  assigned  key  result  in
displaying  the  next error/warning.  First all errors are shown, afterwards
all warnings.

When all errors/warnings have been shown and you press 'NextError' again you
will be asked if you want to assemble the source again.


 5. LIMITATIONS
----------------

· The scripts don't yet handle multiple CygnusED instances.

· The  scripts  could handle language localizaton if I knew how to find out
  the language CygnusEd is currently using (any status number for this?).


 6. AUTHOR
-----------

If you have any suggestions or bug-reports, feel free to contact me
(e-mail preferred).

Ulrich Flegel
e-mail: flegel@ibr.cs.tu-bs.de
irc:    Froody (#amigager)
phone:  ++49-5307-5660


 7. CREDITS
------------

I  will  constantly  insert  any  contribution  to  Basmify  here  for  your
information.  You might find it amusing or interesting.

____________________________________________________________________________

95Oct2.114549+0100mesz.395394-2+180@hphalle0.informatik.tu-muenchen.de   was
originally sent by rattei@informatik.tu-muenchen.de.

Christian  Rattei  wrote  (Mon,  2  Oct 1995 11:45:37 +0100 (MEZ)) in a Mail
about "Basmify":

Following the forwarded message:

Hi,

Ich bin der Autor der BarflyInCED ARexx Scripte. Wie ich feststellen
mußte, hast Du große Teile der Dokumentation, sowie des Readme-Files
Deines Basmify Paketes (so, wie ich sie in aminet/dev/asm fand) von
den Files meines Archivs übernommen. Da nicht nur meine Scripte,
sondern _sämtliche_ Files des Archivs (also insbesondere _auch_ die
Dokumentation) meinem Copyright unterliegen, betrachte ich dies als
Verletzung meiner Urheberrechte.

Ich erwarte hiermit eine umgehende Entschuldigung Deinerseits _und_
verlange für zukünftige Versionen Deines Basmify Archivs (falls es
welche geben sollte und diese weiterhin, zumindest teilweise, auf
meinen Dateien beruhen sollten) die Nennung meines Namens als Mitautor
der betroffenen Teile des Archivs bzw. einen Verweis auf mein Original-
Archiv mit Nennung meines Namens als Autor.

Sollte dies nicht geschehen, behalte ich mir weitere Schritte vor.

Bye,
  Chris

-- 
Christian Rattei (rattei@informatik.tu-muenchen.de)
--------------------------------------------------------------------------------
____________________________________________________________________________