home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / comm / fido / spot / rexx / areafixman.doc < prev    next >
Text File  |  1993-12-21  |  11KB  |  244 lines
  1.  
  2.                                __  ___
  3.                                |_)( |_)
  4.                                |  _)| \
  5.                            S O F T W A R E
  6. ______________________________________________________________________
  7.  
  8.    Presents: AreaFix Manager (AFM)
  9. Description: An Arexx script to handle AreaFixes
  10. Requirement: Registered copy of Spot
  11.     Version: 2.6
  12.        Date: 19/09/93
  13.  
  14.       Status: Freeware.   
  15. Contribution: n/a
  16.  
  17.  Acknowledge: Spot, Nico Francois; Arexx, William S. Hawes
  18. ______________________________________________________________________
  19.  
  20.   "It is custom with new users to send their areafixes to the largest
  21. of the echoes available to them..."
  22.  
  23. Brief ________________________________________________________________
  24.  
  25. AreaFix Manager, or AFM is an Arexx script for use with Spot which
  26. automizes the sending of AreaFixes.  A preference file is created and
  27. modified to hold the password and name of area, for each of your
  28. netmail areas so that to send a netmail, you simply have to enter the
  29. echoes you wish to attach and detach to/from.  In fact, to attach to
  30. an echo, you are only required to click the mouse button three times!
  31. (Of course the area name has to be entered!).
  32.  
  33. NEW FEATURES
  34. ¯¯¯¯¯¯¯¯¯¯¯¯
  35. o Allows other password line options to be used -H etc.
  36.   thanks to Richard Galezowski.
  37. o New future proof prefs file format.
  38. o Bug which prevented OKAY from working with empty areafix sessions fixed.
  39.   thanks to Daniel Smith.
  40.  
  41. FEATURES
  42. ¯¯¯¯¯¯¯¯
  43. o Remembers password and boss address for every netmail (matrix area)
  44. o Simple to use menu
  45. o Allows you to enter up to 15 attaches/detaches per message
  46. o Area list may be requested from within AFM
  47. o Works with most Areafix programs, easily customizable to different
  48.   Areafix names ie, Areafix, Areamanager etc.
  49. o Optional comment for each area which appears on the options menu.
  50.  
  51. Usage ________________________________________________________________
  52.  
  53. INSTALLING AFM
  54. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  55. The script can be copied to where you keep all of your Spot scripts
  56. (usually REXX:, although mine are kept in Rexx:Spot).  The script can
  57. be run from the option 'Execute Script' from the 'Arexx' menu or else,
  58. and this is a better option, it can be installed directly to the Arexx
  59. menu.  To do this, select 'Arexx' from the settings menu.  Up will pop
  60. a window aptly named Arexx.  From here you must click on the button
  61. marked 'Add'.  Once you have done this, a number of gadgets will
  62. become unghosted.  The first we are interessted in is called 'Name'
  63. and is below the 'Add' gadget you clicked on.
  64.    In here you must type the name you want to appear in the menu.  In
  65. this case it would be 'AreaFixMan' although you may call it anything
  66. you like such as, 'lollipop' or 'pencil' although these won't aid your
  67. memory into remembering what the option is for...but it will give your
  68. friends a laugh...
  69.    The next string gadget is called 'Script' and is directly below the
  70. 'Name' gadget.  In here you can type the full path of the script, or
  71. better still select the button along side it with a piece of paper
  72. with a bent corner on it.  This will open a file requester where you
  73. can select the script.  It defaults to open in Rexx: so you must find
  74. the correct directory if the script is not in Rexx:.
  75.    The last gadget is called 'Output' and determines where the output
  76. will go.  As AFM does not give out text output this can be left as it
  77. is ie, blank.
  78.  
  79. SETTING UP AFM
  80. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  81. To use AFM you simply select the menu option like any other (providing
  82. you have chosen to install the script as instructed above.)  Once you
  83. have done this you may be told a number of things such as "Do not use
  84. from arealist".  AFM is designed to be used from the Message List
  85. screen or the Message reading screen.  Also, it should be used from
  86. Netmail areas (these are by default labelled NET_xxxxx, where xxxxx is
  87. your address).  It MAY be called from other areas, but this is not
  88. wise as it will tell everyone who gets that area your password so that
  89. they can pretend to be you!
  90.    Once inside your netmail area, simply call the program.  You will
  91. probably be told "A new prefs file has been created" or else that the
  92. program cannot create the file.  If it is the latter, make sure there
  93. is an assign called ENVARC: and ENV:.  Click on 'Ok' and you will be
  94. asked for the address of your boss.  Whatever you do, DO NOT type in
  95. the road and city of your employer :-).  What it requires is for you
  96. to enter the person who sends you your mail's address ie. 2:253/516
  97. is mine. Enter it in and press Return or click on 'Ok' and another 
  98. window will pop up.  This is for your password.
  99.    Enter the password you have arranged with your boss to use.
  100. Beware, make sure that this is the correct one as you will have two,
  101. one for use with your mailer (ie. Trapdoor) and one for use with
  102. Areafix - but often these are the same.  Check first though.  Once you
  103. have entered the password in, hit Return or click 'Ok'.
  104.    The next piece of information you must enter is the name of the Areafix
  105. program.  This is the name which you would send Areafixes to, the name
  106. you use in the 'to' field.  Usually this is 'Areafix' (the default)
  107. although you may change it to whatever your board uses.  Simply hit
  108. Return or click 'Ok' to keep the default setting.
  109.    The next window will ask you for an optional comment.  This
  110. comment will appear on the menu and is useful for reminding you which
  111. board the areafix will go to, and whether the area is Fidonet or
  112. Amiganet etc.  It may be left blank where it will be replaced with
  113. 'Options'.
  114.    You will be asked if you want to add the details to your prefs
  115. file.  Select 'Use' to save your settings to RAM: this will mean that
  116. they will be erased when you reboot.  Selecting 'Save' will save the
  117. settings to disk so that they are used every time you load AreaFixMan.
  118. This works the same way as the WB2.0+ prefs settings.
  119.    If you later find that the details are wrong, delete the files
  120. ENVARC:AreaFixMan.prefs and ENV:AreaFixMan.prefs and do this 'Setting Up'
  121. section again.  'Cancel' will result in the password etc. not being saved,
  122. so you will need to repeat the above section next time.
  123.    If you do not wish to send an AreaFix now, simply click on 'Cancel'
  124. from the attach/detach menu that follows.
  125.  
  126. USING AFM
  127. ¯¯¯¯¯¯¯¯¯
  128. Once you have set AFM up it is done forever!  Or until you need to
  129. change something where you will have to delete the prefs file and
  130. start again.  After setting up, or when you select AFM from the menu,
  131. you will be presented with a requester with four options.  Your
  132. comment, if you chose to have one, will be shown in the title bar.
  133.    Attach and Detach both bring up a string requester where you can
  134. type the area you want to attach to (don't type '+' or '-' before
  135. it!).  After entering one in and hitting Return or clicking 'Ok' the
  136. requester will re-appear allowing you to add/remove multiple areas.
  137. When you have done, click 'Ok' or hit Return on an empty requester, or
  138. else click 'Cancel'.  You will be taken back to the requester where you
  139. can decide to attach/detach further areas.
  140.    When you have finished, simply select 'Okay'.  You will be asked
  141. if you want to request an arealist.  If your board supports it, you
  142. can click 'Yes' and then you will receive a list of all the areas
  143. available to you when your boss board has processed the message.  Even
  144. if you haven't attached to, or detached from ANY areas, you can still
  145. 'claim' your free arealist...simply send back the 'Yes' envelope...or
  146. better still click on 'Yes' when you are asked if you want one :-).
  147. Also, by selecting 'Other' from the arealist requester, you can enter
  148. in any other options such as '-H' for help or '-Q' for a query list
  149. IF, and only if, your board supports it.  Make any changes additions
  150. etc and select 'Okay' to keep the new password line options or 'Cancel'
  151. which will abort the message.
  152.    The last option from the requester arealist requester is 'Cancel' which
  153. will simply abort the message.
  154.    After adding an entry, ie. attaching or detaching to/from and area, a
  155. new option will become available.  This is called 'Erase' and will erase
  156. the last entry in the list when clicked upon (or activated via