home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / guide / ami2guide.lha / aminet2guide / Aminet2Guide.doc < prev    next >
Encoding:
Text File  |  1994-10-16  |  5.2 KB  |  159 lines
  1.  
  2. Aminet2Guide - Converts file containing Aminet RECENT or INDEX listing
  3.                into AmigaGuide format; AmigaGuide can then be used for
  4.                retrieving files from Aminet via Term
  5.  
  6.  
  7. Copyright ©1994 by Timothy B. Kreuzer.  All rights reserved.
  8.  
  9. Version: 1.0
  10.  
  11. Author: Tim Kreuzer
  12.  
  13. Language: SAS/C V6.5
  14.  
  15.  
  16. Description
  17. -----------
  18. "Aminet2Guide" is a CLI-only command which accepts a file containing
  19. a RECENT or INDEX listing obtained from Aminet, and converts it into
  20. an AmigaGuide database file.  The AmigaGuide database file can then
  21. be used in combination with the Term telecommunications program in
  22. order to either download binary files or view the ".readme" files by
  23. simply selecting a button containing the file's name.
  24.  
  25.  
  26. Usage
  27. -----
  28. Aminet2Guide [path]infile [path]outfile
  29.  
  30. where:  [path]infile  =  File containing Aminet RECENT or INDEX listing
  31.  
  32.         [path]outfile =  Generated AmigaGuide file, ready for usage with
  33.                          the Term telecommunications program
  34.  
  35.  
  36. Installation
  37. ------------
  38. Copy the Aminet2Guide file into your "C:" directory.
  39.  
  40.  
  41. Limitations
  42. -----------
  43. 1) Usage of the "Aminet2Guide" AmigaGuide database requires the following:
  44.  
  45.    - The Term telecommunications program
  46.    - The AmigaGuide program or MultiView (with the AmigaGuide datatype)
  47.    - ARexx
  48.  
  49. 2) The "Aminet2Guide" AmigaGuide database has only been tested/used
  50.    accessing the Aminet via the Delphi on-line service.  I am far to
  51.    ignorant of any "standard" approach to Internet access to assume that
  52.    the database will work for ANY carrier.  My hope is that it will.
  53.  
  54.  
  55. Example
  56. -------
  57.  1) Using Term, access the Aminet via your preferred carrier.
  58.  
  59.  2) Make sure the Term buffer is in "Recording" mode (i.e., you have
  60.     not selected "Freeze buffer" from Term's "Buffer" menu).
  61.  
  62.  3) Issue the command(s) to display a listing of either an Aminet RECENT
  63.     or INDEX file.
  64.  
  65.     Assume for this example you have displayed an Aminet RECENT listing
  66.     by typing the commands: 
  67.  
  68.        ascii           <return>   and 
  69.        get "RECENT" TT <return>
  70.  
  71.     while at the main Aminet directory level.
  72.  
  73.  4) Save the Term buffer (containing the Aminet RECENT or INDEX listing)
  74.     to disk using the "Save Buffer as..." option of the "Buffer" menu.
  75.  
  76.     Assume for this example you have saved the buffer containing the
  77.     INDEX listing to "RAM:Aminet_RECENT".
  78.  
  79.  5) Switch back to the Workbench screen.  From a shell, issue the following
  80.     command:
  81.  
  82.        Aminet2Guide RAM:Aminet_RECENT RAM:Aminet_RECENT.guide
  83.  
  84.  6) When you are returned to the shell prompt, you will now have a file
  85.     called Aminet_RECENT.guide on your RAM: disk.
  86.  
  87.  7) Switch back the Term screen.  Select the "Screen..." option from the
  88.     "Settings" menu.  This will cause the "Screen Settings" window to open.
  89.  
  90.  8) Select the "Shanghai windows" option on the "Screen Settings" window,
  91.     then select "Use".
  92.  
  93.  9) Switch back the Workbench screen.  Make sure the ARexx is active 
  94.     (issue the "RexxMast" command if you want to be certain).
  95.  
  96. 10) Issue the following command from the shell:
  97.  
  98.        AmigaGuide RAM:Aminet_RECENT.guide   or perhaps
  99.  
  100.        MultiView RAM:Aminet_RECENT.guide
  101.  
  102.     This should cause a AmigaGuide window, containing the contents of
  103.     the converted Aminet RECENT listing to be displayed on the Term
  104.     screen.
  105.  
  106. 11) Switch back to the Term screen (if you aren't already there).
  107.  
  108.     MAKE SURE you're at the Aminet directory level corresponding with
  109.     where you obtained the converted RECENT or INDEX listing.
  110.  
  111.     If you've just gotten the listing, you're already there.
  112.  
  113. 12) Resize the AmigaGuide window so you can see the bottom of the Term
  114.     screen.
  115.  
  116.     Note that this is NOT required, but I sure like to see what's going
  117.     on!
  118.  
  119. 13) You're now set to retrieve files and/or read ".readme" files simply
  120.     by pushing a button!
  121.  
  122.     By selecting the button with a filename on it, the AmigaGuide
  123.     database will issue (to Term) a "binary" command, followed by
  124.     a "get <filename>".
  125.  
  126.     By selecting the "+" button next to a filename, the AmigaGuide
  127.     database will issue (to Term) an "ascii" command, followed by a
  128.     "get <filename>.readme TT".
  129.  
  130.     The file's size and it's short description are listed next to the
  131.     file's name in order to allow you to browse through the AmigaGuide
  132.     window to see what file's you may be interested in.
  133.  
  134. 14) When you're done downloading and/or reading "readme"'s, simply quit
  135.     the AmigaGuide window.
  136.  
  137.     You may want to also set the Term screen back to having "Shanghai
  138.     windows" turned off.  This is purely optional.
  139.  
  140. Of course, the above example assumes a number of things which you can
  141. make easier by setting things up in advance of your Aminet session, such
  142. as having ARexx active, having a shell open on the Workbench screen, and
  143. having the Term screen set to "Shanghai windows".
  144.  
  145. Also, the above is not necessarily the ONLY way in which Aminet2Guide or
  146. it's output AmigaGuide database file could be used.  It is, however,
  147. guaranteed (boy, that's a strong statement) to work this way.
  148.  
  149.  
  150. Feedback
  151. -------
  152. I'd be interesting in knowing if you find Aminet2Guide useful, or if you
  153. have any problems (or questions/suggestions).
  154.  
  155. I can be reached via Internet at the following address:
  156.  
  157.    tkreuzer@delphi.com
  158.  
  159.