home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 May / VPR9705A.ISO / OLS / Internet / WSARCH32 / WSARCH32.TXT < prev   
Text File  |  1996-04-29  |  13KB  |  303 lines
  1. This client is a first stab at a win32 archie client.  It requires
  2. Windows 95 or Windows NT 3.51 to run as the query is a thread and 
  3. it uses Tree and List views.
  4.  
  5. To use it all you need to do is run the program.
  6.  
  7. New Features:
  8.  
  9. 1. Filter Using Path.  If this box is filled in then the archie
  10.    search will be restricted to directories containing the string.
  11.    eg:
  12.  
  13.    Path - "winsock"
  14.    Search for - "wsarchie.zip"
  15.  
  16.    will match:
  17.  
  18.    /pub/ibmpc/winsock/apps/wsarchie/wsarchie.zip
  19.  
  20.    but not:
  21.  
  22.    /pub/ibmpc/wsarchie.zip
  23.  
  24. 2. Wsarchie can now retrieve useing a browser.  No need to specify
  25.    a path or executable simply tick the box "Use Web Browser" and
  26.    when you retrieve a file the default Web Browser should be kicked
  27.    off and the file retrieved.  This might also work if a gopher
  28.    site was what was found.  I haven't been able to test this.
  29.    Obviously this feature depends on having a Web Browser like
  30.    Microsoft's Internet Explorer or Netscape Navigator installed.
  31.  
  32. 3. The edit menu items are implemented.  They work on items listed
  33.    in the lower window.  I'm not completely happy with this 
  34.    arrangement, but that's how it's done for now.
  35.    NB There are context menus for both lower boxes (use that right 
  36.    mouse button!).
  37.  
  38. 4. Matches:  Three parameters can be specified to restrict matches,
  39.    I quote the archie manual page:
  40.  
  41.      Max Hits
  42.           Allow the find command to generate at most  the  speci-
  43.           fied  number  of  matches  (permissible  range: 0-1000;
  44.           default: 10).
  45.  
  46.      Max Hits per Match
  47.           Across all the anonymous FTP archives on  the  Internet
  48.           (and  even  on  one  single anonymous FTP archive) many
  49.           files will have the same  name.  For  example,  if  you
  50.           search for a very common filename like "README" you can
  51.           get hundreds even thousands of matches. You  can  limit
  52.           the  number  of  files  with the same name through this
  53.           variable. For example a value of 100 tells  the  system
  54.           only 100 files  with  the  same  name.
  55.           Note  that the overall maximum number of files returned
  56.           is still controlled with the 'Max Hits' variable.
  57.  
  58.      Max Match
  59.           This variable will limit the number filenames returned.
  60.           For  example, if Max Match is set to 2 and you perform a
  61.           substring search for the string "etc", and the  catalog
  62.           contains  filenames  "etca", "betc" and "detc" only the
  63.           filenames "etca" and "betc" will be returned.  However,
  64.           depending  on  the  values of maxhitspm and maxhits you
  65.           will get back a  number  of  actual  files  with  those
  66.           names.
  67.  
  68. And that's it for now.  Help is not yet fully implemented, I will
  69. work on this soon.  An Uninstall facility (as if you would want 
  70. to...) is also on the cards, as well as outputing results as they
  71. arrive.
  72.  
  73.  
  74. Support for FTP clients is still there.  Enter the FTP setup 
  75. dialog and make sure that you enter the full path and name of 
  76. the FTP program you use. 
  77.  
  78. The command line parameters are now in a seperate box but they still
  79. work the same way, namely with substitution strings.
  80.  
  81. Where the existing directory which holds ws_ftp32.exe is d:\ws_ftp,
  82. and where the existing directory for the to be received files is 
  83. ws_ftp\newfiles, in the Option->Ftp Setup, you would use the 
  84. following for the Command:
  85.     
  86. d:\ws_ftp\ws_ftp32 
  87.  
  88. and the following for the Parameters:
  89.  
  90. //%h/%d/%f local:d:\ws_ftp\newfiles\%f
  91.  
  92. %h will be substituted with the host name
  93. %d will be substituted with the remote directory name
  94. %f will be substituted with the remote filename.
  95.  
  96. If you had it configured and working before, tough luck you will
  97. need to split the command and the parameters as I was too lazy
  98. to make the program work it out for itself.
  99.  
  100. Directory expansion is now possible, probably best done with the right mouse
  101. button after selecting the directory that you wish to expand.
  102.  
  103. The help file is not yet complete.  This will be improved over time.
  104.  
  105. Try it out and let me know how you get on via email or my WWW page
  106.  
  107. http://dspace.dial.pipex.com/david.woakes/
  108.  
  109. This archie client is based upon the archie client that is included in the
  110. Prospero V5.1a release.
  111.  
  112. It was written by Clifford Neuman with changes by Brendan Kehoe
  113. and George Ferguson.
  114.  
  115. If you want to know more about Prospero send an email message to 
  116. info-prospero@isi.edu.  Do not send questions about WSARCHIE to
  117. this address, send them to david.woakes@dial.pipex.com, PLEASE.
  118.  
  119. Keep an eye on my WWW home page for latest releases:
  120.  
  121. http://dspace.dial.pipex.com/town/square/cc83/
  122.  
  123.  
  124. Installation.
  125. =============
  126.  
  127. This instructions assume that you have some form of WINSOCK
  128. installed and working.
  129.  
  130. 1. Unzip wsarch32.zip in a directory by itself. There should be two
  131. files altogether:
  132.  
  133. wsarch32.exe    - this is the program itself.
  134. wsarch32.txt    - this file
  135.  
  136. Thats it.
  137.  
  138. To use, enter your search term in the "Search for" field, and then
  139. press return, or select the Search button.
  140.  
  141. At the moment you wont see anything about how your query is 
  142. progressing until either it completes or times out, and no error 
  143. message is returned in the latter case!  These things will be added 
  144. in time, I just wanted to get something out before I go away for 
  145. Christmas!  I will be refining and adding functionality then.
  146.  
  147. Regards
  148. David Woakes
  149.  
  150. ----------------------------------------------------------------
  151.  
  152. Currently this version of WSARCHIE may not be distributed or placed
  153. on FTP sites. This is because it is strictly speaking an ALPHA test
  154. release.
  155.  
  156. The address to send your donation to is:
  157.  
  158. David Woakes
  159. 88 Spottiswoode St
  160. Edinburgh
  161. EH9 1DJ
  162.  
  163. I attach a copy of the latest licensing agreement from the University of
  164. Southern California:
  165.  
  166. /* 
  167.  *  Copyright (c) 1991-1994 by the University of Southern California
  168.  *  All rights reserved.
  169.  *
  170.  *  PROSPERO(TM) LICENSE AGREEMENT
  171.  *
  172.  * 1. COPYRIGHT.  The Prospero software is owned by the University of
  173.  *    Southern California and is protected by the United States copyright 
  174.  *    laws and international treaty provisions.  Other copyrights may
  175.  *    apply to parts of the Prospero distribution and are so noted when
  176.  *    known to be applicable.
  177.  * 
  178.  * 2. DISCLAIMER OF WARRANTY.  THIS SOFTWARE IS PROVIDED "AS IS".  The
  179.  *    University of Southern California MAKES NO REPRESENTATIONS OR
  180.  *    WARRANTIES, EXPRESS OR IMPLIED.  By way of example, but not
  181.  *    limitation, the University of Southern California MAKES NO
  182.  *    REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY
  183.  *    PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE
  184.  *    COMPONENTS OR DOCUMENTATION WILL NOT INFRINGE ANY PATENTS,
  185.  *    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.  The University of Southern
  186.  *    California shall not be held liable for any liability nor for any
  187.  *    direct, indirect, or consequential damages with respect to any
  188.  *    claim by the user or distributor of the Prospero software or any
  189.  *    third party on account of or arising from this Agreement or the use
  190.  *    or distribution of the Prospero software. 
  191.  * 
  192.  * 3. GRANT OF LICENSE.
  193.  * 
  194.  *  a) Permission to use, copy, modify, and distribute this software and
  195.  *     its documentation in source and binary forms is hereby granted,
  196.  *     provided that:
  197.  * 
  198.  *       i) the use, copying, or distribution is not done for direct
  199.  *          commercial advantage;
  200.  * 
  201.  *      ii) any distribution of the software is on the same terms as in
  202.  *          this Prospero License Agreement, and each copy contains the
  203.  *          copyright notices and the license agreement that appear in
  204.  *          this software and supporting documentation; and  
  205.  * 
  206.  *     iii) any documentation or other materials related to such
  207.  *          distribution or use acknowledge that the software was developed
  208.  *          by the University of Southern California.  
  209.  * 
  210.  *  b) Permission to copy, modify, and distribute this software and its
  211.  *     documentation in source and binary forms AS PART OF ANOTHER
  212.  *     PRODUCT for commercial advantage is hereby granted, provided that:
  213.  * 
  214.  *       i) notice is provided to the University of Southern California
  215.  *          describing the use of Prospero in the product;    
  216.  * 
  217.  *      ii) any distribution of the software is on the same terms as in
  218.  *          this Prospero License Agreement, and those terms apply also to
  219.  *          the distribution and use of that part of the product derived
  220.  *          from the Prospero distribution (it is acceptable to
  221.  *          impose additional restrictions on other parts of the product), 
  222.  *          and each copy contains the copyright notices and the license
  223.  *          agreement that appear in this software and supporting
  224.  *          documentation; 
  225.  * 
  226.  *     iii) any documentation or other materials related to such
  227.  *          distribution or use acknowledge that the software was developed
  228.  *          by the University of Southern California; and
  229.  * 
  230.  *      iv) one of the following three conditions is met:
  231.  * 
  232.  *          a. The product so distributed has been developed
  233.  *             independently and it incorporates only files and related
  234.  *             functions (e.g. allocators) from the Prospero distribution
  235.  *             needed to providing compatibility with the Prospero
  236.  *             distribution; or  
  237.  * 
  238.  *          b. the product so distributed has been developed independently
  239.  *             and the parts of the Prospero distribution included
  240.  *             constitute less than 25% of the product, and the total annual
  241.  *             sales of products incorporating Prospero does not exceed
  242.  *             $100,000 (U.S. Dollars); or
  243.  * 
  244.  *          c. parties to which the product is sold or distributed are
  245.  *             allowed to use or distribute the product in source and binary
  246.  *             forms without fee if the party's use or distribution of the
  247.  *             product is not for direct commercial advantage. 
  248.  * 
  249.  *  c) Permission to use this software to provide a service for a fee is
  250.  *     granted provided that notice is provided to the University of
  251.  *     Southern California describing the nature of the service and
  252.  *     provided that the total annual revenues for the service provided
  253.  *     using Prospero does not exceed $250,000 (U.S. dollars).
  254.  * 
  255.  *  d) Any use, copying, modification, or distribution other than as
  256.  *     provided for above requires an additional license from the
  257.  *     University of Southern California.  The University of Southern
  258.  *     California is prepared to license this software for such use on
  259.  *     reasonable terms.  
  260.  * 
  261.  * 4. OTHER RESTRICTIONS.  Nothing in this Agreement shall be construed
  262.  *    as conferring rights to use in advertising, publicity, or
  263.  *    otherwise, the name of the University of Southern California, or
  264.  *    any trademark thereof. 
  265.  * 
  266.  *   This agreement shall be construed, interpreted, and applied in
  267.  *   accordance with the laws of the State of California, United States of
  268.  *   America.  If any part of this Agreement is held illegal or
  269.  *   unenforceable, the remaining portions shall not be affected.
  270.  * 
  271.  *   Any notice required under this agreement shall be sent to the Prospero
  272.  *   Project; Information Sciences Institute; University of Southern
  273.  *   California; 4676 Admiralty Way; Marina del Rey, California 90292-6695
  274.  *   USA. Any questions concerning the Prospero distribution should be
  275.  *   directed to info-prospero@isi.edu.
  276.  * 
  277.  *   Prospero was originally written by Clifford Neuman (bcn@isi.edu) while
  278.  *   a graduate student at the University of Washington, and subsequently at
  279.  *   the Information Sciences Institute of the University of Southern
  280.  *   California.  Contributors include Steven Seger Augart (swa@isi.edu),
  281.  *   Santosh Rao (srao@isi.edu), and other individuals identified in the
  282.  *   software distribution and accompanying documentation.
  283.  * 
  284.  *   Prospero, the Prospero Directory Service, the Prospero File System, 
  285.  *   and the Prospero Resource Manager are trademarks of the 
  286.  *   University of Southern California. 
  287.  * 
  288.  */
  289.  
  290. Release History
  291. ---------------
  292.  
  293. 1995.12.21
  294.  
  295. 1st release. No FTP support or domain support. Also no feedback
  296. on progress of query.
  297.  
  298. 1996.01.21
  299.  
  300. 2nd Release. No FTP support.
  301. Added support for domain option and also give feedback on
  302. progress.
  303.