home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / UNIX / ARCHIE / CLIENTS / PERL_ARC / README < prev    next >
Encoding:
Text File  |  1991-08-28  |  5.7 KB  |  146 lines
  1. # Copyright (C) Khun Yee Fung clipper@csd.uwo.ca 1991
  2. # You can do anything to this program except selling it for profit or
  3. # pretending you wrote it.
  4. # $Id: README,v 3.6 1991/08/03 00:15:22 clipper Exp clipper $
  5.  
  6. This README file is for version 3.x of the archie program.
  7.  
  8. New
  9. ---
  10.  
  11. I forgot to include fixpath and Makefile in the last distribution.
  12. Sorry. They are now included.
  13.  
  14. Changes for Version 3.6
  15. -----------------------
  16.  
  17. 1. The -along option is on again. This option is useful for at least
  18. one person and I think is useful if the query dies in midway. At least
  19. a partial result is better than nothing.
  20.  
  21. 2. Some other small changes are done.
  22.  
  23. 3. Some details in the man page are changed.
  24.  
  25. 4. Consider this a gamma release.
  26.  
  27. Changes since version 2.xx
  28. --------------------------
  29.  
  30.   1. A sort option is added. The lists can be sorted by the domain of
  31.   the host or by the date. Reverse ordering is supported too. The host
  32.   ordering is by a user definable array. This is useful if the list
  33.   has the domains in order of nearest to farthest from the system the
  34.   user is using. Check  system.archierc to set the system default ordering.
  35.  
  36.   2. Version option is supported. When this option is specified, the
  37.   version number of the program will be printed.
  38.  
  39.   3. A different startup file can be specified.
  40.  
  41.   4. I have decided not to do packet ordering myself. So the -along
  42.   option is gone.
  43.  
  44.   5. The part on networking has been completely rewritten. I hope it
  45.   is more correct than the last two releases.
  46.  
  47.   6. There are other small changes. I can't list them all.
  48.  
  49. I will not add any more features in the program. It is too big even now.
  50.  
  51. Feature not implemented
  52. -----------------------
  53.  
  54.   I have thought about implementing a auto-ftp option in the program
  55.   so that the program will ask the user if a file should be transferred
  56.   from the host by anonymous ftp. I have all the code for a ftp client
  57.   in perl (I have always used this perl ftp than the standard ftp). I
  58.   have thought out how it should be implemented. The host sorting
  59.   method was thought out initially to support this option so that the
  60.   nearest hosts are always asked first. But the option will add
  61.   another 10k bytes to the program. I am not happy about the size of
  62.   the program even now. As we can always set the format of the output
  63.   to a particular format and pipe the output to another program for
  64.   anonymous ftp, I have decided against implementing this feature. If
  65.   you want to implement it, I can supply you the perl ftp client code.
  66.  
  67. Brief Introduction
  68. ------------------
  69.  
  70. This is a archie client written in Perl using the prospero protocol.
  71. It is standalone with no dependance on the prospero code in
  72. prospero.tar.Z on june.cs.washington.edu. I am not sure this program
  73. is useful as there is also a standalone archie program in that file
  74. archive, except that you have to compile the prospero file system too.
  75. So, if you think you are more interested in a C archie client, do grab
  76. that file archive and install the archie client that comes with it.
  77.  
  78. To get more information about prospero, you can send a message to
  79. info-prospero@isi.edu.
  80.  
  81. About Prospero
  82. --------------
  83.  
  84. With prospero, many things that are tedious to do by login
  85. interactively to an archie server are simple. For example, the output
  86. from an archie client using the prospero protocol can be parsed and
  87. further processed without going through the mail system. The system
  88. load on the archie server will surely lower because of the absence of
  89. interactive processes. The attributes of a directory or a file also
  90. makes the output look like a part of a file system.
  91.  
  92. System Requirements
  93. -------------------
  94.  
  95.   1. The program probably needs Perl 4.010. Perl 3.044 causes it to
  96.   core dump.
  97.  
  98. Installation
  99. ------------
  100.  
  101. To start things off, modify the file archie.depend. You should also
  102. move archie in the directory where you store you perl scripts. The
  103. library files should be in the perl library. If you want to, you can
  104. use the Makefile in this distribution.
  105.  
  106. Please also check the file system.archierc. Change the sorting order
  107. of hosts in the domain option. Put the domains nearest to your site in
  108. the beginning of the option and farthest at the end. For a site in
  109. Finland, probably the order is very different, with .de .nl.dk nearer
  110. to the beginning of the list than .ca, .edu, .com, or .ca.
  111.  
  112. Acknowledgement file
  113. --------------------
  114.  
  115. I guess I know the header information much better now. The program has
  116. been modified. Thanks very much to Clifford Neuman
  117. (bcn@cs.washington.edu) for providing information on prospero. Please
  118. read ACKNOWLEDGE for acknowledgements.
  119.  
  120. Status of the program
  121. ---------------------
  122.  
  123. This program is in the gamma testing stage.  However, I will not add
  124. any more features. Also, I will only modify the file to correct bugs.
  125. This is basically a stable version.  I need people to test, improve,
  126. and suggest, to make it better.  It is written on a Sun 3/50.  I tried
  127. it on a MIPS RISC/os 4.51. It worked. I have also tried it on a
  128. Sequent symmetry Dynix Version something. These are the machines that
  129. I have access to.  Brendan Kehoe reports that it works under some
  130. HP's, an Encore, and DecStations too.  Peter (poe@daimi.aau.dk) says
  131. it works on his HP9000/300 under HP-UX 7.0 too. Billy Barron says it
  132. works under Solbourne OS/MP 4.0D.  It might not work on other
  133. machines.  If you port it to another machine type, please send me the
  134. diffs, thanks. If you find bugs on other machine types, please also
  135. tell me. I would like to know how portable the program is.
  136.  
  137. Others
  138. ------
  139.  
  140. Please send your comments, criticisms, diffs, bug reports, etc. to me
  141. at clipper@csd.uwo.ca. Yes, you can even criticise my programming
  142. style.
  143.  
  144. Khun Yee
  145. August 2
  146.