home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / geturl.zip / read.me < prev    next >
Text File  |  1996-03-07  |  10KB  |  236 lines
  1. GETURL - a program for copying files from the Internet
  2.  
  3.  
  4. WHAT IS GETURL?
  5.  
  6. GetURL is a program for copying files from WWW sites, FTP sites,  
  7. News Servers, Gopher sites, or local computer to your local OS/2 
  8. computer.  GetURL may be used in conjunction with REXX to automate
  9. a number of Internet search and retrieval applications. 
  10.  
  11. GetURL retrieves these files as type www/source, meaning that all
  12. text is retrieved as HTML, and binaries (like pictures) are retrieved
  13. as is.  Suggestions for enhancements to this behaviour are encouraged. 
  14.  
  15. A couple of demonstration REXX Programs are included as illustration.
  16.  
  17. INSTALLING GETURL
  18.  
  19. If you are reading this, you probably know how to unzip a file.  Unzip
  20. the GetURL.zip into a suitable directory - I have mine in x:\tcpip\bin.
  21. You should have the following files:
  22.  
  23. GETURL.EXE     - The GetURL Program
  24. READ.ME        - The extensive and complete documentation  
  25. FILEID.DIZ     - The Obligatory Fileid.diz
  26. GETURL.TXT     - The Small Descriptive Text File
  27. SRCHOBB.CMD    - The Hobbes Search Demonstration
  28. HOBFILT.EXE    - Required for the Hobbes Search Demonstration 
  29. WTHRBCK.CMD    - The WPS Backround Weather Map Loader Demonstration
  30. WTHRUTL.CMD     - Retrieval of Utils required for Weather Map Loader
  31.  
  32. If you haven't already installed it, you will require the EMX runtime 
  33. package for OS/2 in order to use this program.  This can be obtained at:
  34. ftp://hobbes.nmsu.edu/os2/unix/emx09a/emxrt.zip.  Please read the 
  35. instructions inside this zip file for information on EMX runtime 
  36. installation.
  37.  
  38. RUNNING GETURL
  39.  
  40. GetURL is a VIO mode command line program. It accepts the following 
  41. command line parameters, in any order:
  42.  
  43. <URL>:
  44.  
  45. GetURL can deal with URLs of the following types and formats:
  46.  
  47.     http://www.cris.com/~djd
  48.     ftp://hobbes.nmsu.edu/
  49.     news:comp.os.os2.network.tcpip
  50.     gopher://gopher.iglou.com
  51.     file://localhost/c:/config.sys
  52.  
  53. Occasionally, GetURL will ask for a TMP file name before retrieving a file
  54. from the Internet.  This will normally happen when specifying a directory via
  55. http: protocol instead of a full file name, as in the first example above. If
  56. this is annoying to you (it always is for non-intercative use), try adding a 
  57. final '/' character to the URL, to tell GetURL. For instance, the first URL above 
  58. would become:
  59.  
  60.     http://www.cris.com/~djd/
  61.  
  62. -o <filename>
  63.  
  64. A -o on the command line, followed by a filename, will save the 
  65. retrieved document in that file. A -o with no following filename will 
  66. save the document in the current directory with the same file name as 
  67. the host.  No -o specified on the command line retrieves a file to 
  68. screen (ie stdout).
  69.  
  70. -trace
  71.  
  72. The -trace option shows a lot of information regarding the operation of
  73. GetURL.  This is mostly handy for debugging, and is included so that I 
  74. can help you make GetURL work in case of difficulty.  Trace information 
  75. is sent to the Stderr device.
  76.  
  77. -timeout <seconds>
  78.  
  79. The -timeout parameter sets the number of seconds to timeout a 
  80. connection. If you have a slow link, you may want to set the timeout to
  81. a value greater than the 10 second default. For using 
  82. file://localhost/ URLs, you may want to set it smaller. The seconds 
  83. parameter must be an integer > 0.
  84.  
  85. -news <news server>
  86.  
  87. Currently, the default news server used by GetURL is news. Performance may be 
  88. greatly enhanced by using a local news server, which you may specify here.
  89.  
  90. RUNNING THE DEMOS
  91.  
  92. Hobbes Search Demo - SRCHOBB.CMD
  93.  
  94. Syntax:    SRCHOBB <search term>
  95.  
  96. Returns:   an E editor window with all the matches from the Hobbes 
  97.            00index.txt file.
  98.  
  99. Operation: 1) The 00index.txt file is retrieved.
  100.            2) The 00index.txt file is modified to include the full
  101.               URL of each file.
  102.            3) The OS/2 Find command is used to locate the search term
  103.               of interest
  104.            4) Those lines are displayed using the E editor
  105.            5) all temporary files are removed.
  106.  
  107. Example:   The call:
  108.  
  109.            srchobb lynx
  110.  
  111.            produces the lines:
  112.  
  113.            ---------- hobbes.idx
  114.            ftp://hobbes.nmsu.edu/os2/unix/lynxos2.zip      435705  Lynx text-based WWW browser (req. emxrt.zip)
  115.  
  116.  
  117.  
  118. WPS Backround Weather Map Loader
  119.  
  120. Syntax:    WTHRBACK
  121.  
  122. Returns:   Loads US Weather map into WPS backround
  123.  
  124. Operation: 1) The Gif file is retrieved, as tmp.gif
  125.            2)     Gbmsize is used to convert the GIF to a BMP, and size it 
  126.               to 1024x768 (other sizes may be specified)
  127.            3) The current working directory is determined
  128.            4) The BMP file is loaded to the backround  
  129.  
  130.  
  131. Retreival of Utils required for Weather Map Loader
  132.  
  133. The Weather Map Loader, above, requires two additional utilities in order
  134. to operate.  This Demo retrieves these utils from the Hobbes FTP site, and
  135. unzips the necessary files.  It is assumed that unzip.exe is available
  136. on the path for this to operate.
  137.  
  138. Please consult the archives retreived for information regarding additional
  139. functionality of these programs.
  140.  
  141. Syntax:    WTHRUTL
  142.  
  143. Operation: 1) gets GBM files from Hobbes
  144.            2) unzips GbmSize.exe and GbM.Dll to the local Directory
  145.            3) get Backgrnd from Hobbes
  146.            4) unzips Backrnd.exe to the local directory
  147.  
  148. WHAT TO DO IF IT DOESN'T WORK, OR DOESN'T WORK WELL ENOUGH FOR YOU
  149.  
  150. Email me, Derek J Decker, at djd@cris.com - I'll try to determine what
  151. is going wrong and come up with a fix.  You may also try to catch me in
  152. the #os/2 channel on IRC - I show up there from time to time, with a nick
  153. of either Derek or _Derek_.
  154.  
  155. Before you send me email, you may want to try running GetURL with the
  156. -trace command line option, and including the section of the resulting
  157. trace that shows where the problem occurs. A good description of how
  158. GetURL is installed on your system, what you are trying to do that is
  159. causing a problem, and specific problem symptoms always helps to ensure
  160. an accurate and enthusiastic response.
  161.  
  162. Unfortunately, the press of other work at Decker Automation prevents me
  163. from being able to support this via telephone.
  164.  
  165. REQUIRED LEGAL STUFF
  166.  
  167. It's a sad world we live in, but this is kinda obligatory these days:
  168.  
  169.      THERE IS NO WARRANTY FOR THIS PROGRAM, TO THE EXTENT PERMITTED BY
  170.      APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING DECKER
  171.      AUTOMATION PROVIDES THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY
  172.      KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
  173.      THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  174.      PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND
  175.      PERFORMANCE OF THE PROGRAM LIES WITH THE USER.
  176.  
  177.      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  178.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  179.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
  180.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  181.      INCIDENTAL OR CONSEQUENTIAL DAMANGES ARISING OUT OF THE USE OF
  182.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO THE
  183.      LOSS OF DATA OR DATA BEING RENDERED INACURATE OR LOSSES SUSTAINED BY
  184.      YOU OR THIRD PARTIES OR A FIALURE OF THE PROGRAM TO OPERATE WITH
  185.      ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  186.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  187.  
  188. LICENSE AGREEMENT
  189.  
  190. GetURL is released as Freeware. There is no License Agreement.
  191.  
  192. ABOUT DECKER AUTOMATION
  193.  
  194. Heck - you've got a WWW Browser - point it at http://www.cris.com/~djd and
  195. find out more about Decker Automation, Derek J Decker, and what we REALLY
  196. do here.
  197.  
  198. ACKNOWLEDGEMENTS and Additional Legal things
  199.  
  200. GetURL is based on the WWW Consortium Reference Library version 4.0pre7,
  201. ported to OS/2 via the EMX port of the GNU C Compiler.  Like Newton, I
  202. stand on the shoulders of Giants.  I'd like to thank both the WWW Consortium
  203. and Eberhard Mattes (author of EMX) for the excellent work they have done.
  204.  
  205. In addition, the W3C wants me to say this about the WWW Reference Library
  206. code used in GetURL:
  207.  
  208.                                                                Copyright NOTICE
  209.                                     NOTICE
  210.  
  211. Copyright 1995 by: Massachusetts Institute of Technology (MIT), INRIA
  212.  
  213.    This W3C software is being provided by the copyright holders under the
  214.    following license. By obtaining, using and/or copying this software, you
  215.    agree that you have read, understood, and will comply with the following
  216.    terms and conditions:
  217.  
  218.    Permission to use, copy, modify, and distribute this software and its
  219.    documentation for any purpose and without fee or royalty is hereby granted,
  220.    provided that the full text of this NOTICE appears on ALL copies of the
  221.    software and documentation or portions thereof, including modifications,
  222.    that you make.
  223.  
  224.    THIS SOFTWARE IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO
  225.    REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED.  BY WAY OF EXAMPLE, BUT
  226.    NOT LIMITATION, COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES OF
  227.    MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE
  228.    SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS,
  229.    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. COPYRIGHT HOLDERS WILL BEAR NO
  230.    LIABILITY FOR ANY USE OF THIS SOFTWARE OR DOCUMENTATION.
  231.  
  232.    The name and trademarks of copyright holders may NOT be used in advertising
  233.    or publicity pertaining to the software without specific, written prior
  234.    permission.  Title to copyright in this software and any associated
  235.    documentation will at all times remain with copyright holders.
  236.