home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma52.dms / ma52.adf / AWebAminet.lha / awebaminet.doc next >
Encoding:
Text File  |  1996-03-30  |  3.6 KB  |  120 lines
  1.  
  2.     AWebAminet.rexx 1.0 © 1996 Sami Itkonen
  3.  
  4.  
  5.     What does it do:
  6.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  7. Find Files from Aminet, using the TCP: device that comes with AmiTCP.
  8.  
  9.  
  10.     What does it not do:
  11.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  12. Parse Aminet RECENT files, thus it doesn't operate as an ADT client.
  13.  
  14.  
  15.     Disclaimer:
  16.     ¯¯¯¯¯¯¯¯¯¯¯
  17.  
  18. This software is provided as is, with no warranty. You can distribute
  19. it freely, provided you do it without charge. The author cannot be
  20. held responsible if you use this software for indecent purposes.
  21.  
  22.  
  23.     Installation:
  24.     ¯¯¯¯¯¯¯¯¯¯¯¯¯
  25. Place the script in the same directory as the AWeb executable.
  26.  
  27. Activate "Allow Shell commands in Links" in the 'Network1:General'
  28. settings of AWeb.
  29.  
  30.  
  31.     Usage:
  32.     ¯¯¯¯¯¯
  33. Click the 'Start ARexx Macro' (Amiga-!) in the AWeb menu, and select
  34. this script
  35.  
  36. OR execute 'run >NIL: rx AWebAminet.rexx' in the AmigaDOS shell.
  37. (AWeb has to be running!)
  38.  
  39.  
  40.     Options:
  41.     ¯¯¯¯¯¯¯¯
  42. Most of the options¹ in the form are pretty self-evident². Type
  43. the text you want to find in the text field, click 'Find' to
  44. find it or 'Reset' to reset it. You can also type multiple
  45. words. For example, if you type 'foo bar', all lines² that have
  46. 'foo' and 'bar' in it are matched. If 'Exact match' is checked,
  47. lines with the exact string 'foo bar' are matched.
  48.  
  49. ¹) In the 'Find Results' window there is only the text field.
  50.    Aminetsite and findserver are inherited from the 'parent'
  51.    document, other options are set to defaults.If you want
  52.    to use the options, go back to the full form, or click
  53.    the 'Full Form' gadget.
  54. ²) In the context as they appear in the Aminet INDEX file
  55.    the findserver has.
  56.  
  57.  
  58.     Configuration:
  59.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  60. At the moment you can set the following variables:
  61.     
  62.     def_site     : the default Aminet site
  63.     def_findsite    : the default Aminet findserver
  64.     def_maxhits    : the default number of maximum hits
  65.     use_http    : if set to "ON", will use http:// instead of ftp://
  66.               with certain sites (ftp.wustl.edu, namely)
  67.  
  68. These can be configured in the top of the script. You should
  69. note that if some of these variables does not exist, or it is
  70. invalid, the defaults will reset to 'ftp.wustl.edu' for Aminet
  71. site and findserver and 20 for the number of hits.
  72.  
  73. In the end of the script you can define what Aminet sites you
  74. want to have included in your AminetFind forms. Add your sites
  75. between the lines '/* AMINET' and 'ENDAMINET */'.
  76.  
  77.  
  78.     Known Bugs:
  79.     ¯¯¯¯¯¯¯¯¯¯¯
  80. The script may behave incorrectly if the keyword contains quotation
  81. marks.
  82.  
  83.  
  84.     Any problems?
  85.     ¯¯¯¯¯¯¯¯¯¯¯¯¯
  86. The most common problems are dealt with by the script (like the
  87. inaccessibility of TCP:). If the 'Submit' button in the form
  88. doesn't work, then either
  89.     1) you don't have 'Allow Shell commands in Links' checked
  90.     2) the script is not in the same directory as AWeb
  91.     3) accessing the findserver is simply slow. In that case you
  92.         consider using a different findserver.
  93.  
  94. Note about FTP:
  95.  
  96. Whatever (ftp://) URLs are in the Aminetfind Results are
  97. perfectly valid HTML. If they don't work, then either
  98.     1) the FTP site in question is inaccessible for the moment
  99.     2) you don't have FTP configured properly. See
  100.        Network3:External programs in AWeb settings.
  101.        For a suitable FTP script, you can use eg.
  102.            Josef Faulkner's AwebFTP (available in Aminet)
  103.  
  104. Any other problems, weird or not, outright bugs, HTML errors and
  105. such can be reported to the author.
  106.  
  107.  
  108.     Thanks and such:
  109.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  110.  
  111. To Yvon Rozijn, of course, for making such an excellent browser!
  112. Josef Faulker, for the nice mailto: script, and also for setting
  113. the example of how to use forms and rexx with AWeb.
  114.  
  115.  
  116.     Contacting the author:
  117.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  118.  
  119. Email: Sami.Itkonen@hut.fi
  120.