Marvin's Retriever 0.1 for OS/2 Warp                                 4.1.2002

   (This is alpha version software, untested and full of bugs, so be careful
    and don't complain too loudly, because now you know what you're doing ;-) )


This a the README file which tries to introduce people to Marvin's Retriever 0.1
  
  
Contents
  
1. What is Marvin's Retriever for OS/2?
2. Hardware and Software Requirements
3. Installation Instructions
4. Contact Information
5. Notices
  
    
1. What is Marvin's Retriever for OS/2?
  
   Marvin's Retriever is a small program similar to Netscape's SmartDownload
   but not as powerful (yet). It is not a download manager but could be part
   of one. Well actually it should have been. But I don't know if my download
   manager called Marvin will ever be released, so I thought at least release
   Marvin's Retriever! To be able to reliably download stuff and to save me
   some work it is using the software GNU wGet to get the job done. GNU wGet
   is GPL licensed Software as Marvin's Retriever is. 

2. Features

   - "nice" statistics window
   - ability to fetch URLs from the clipboard
   - Pause/Continue,Retry,Retransfer Buttons
   - Commandline interface

3. Revision History
   
   Marvin's Retriever 0.1   | 4.01.2002   First public version

4. To do list!
   
   -Settings dialog
   -Netscape plugin
   -Xcenter plugin?
   -a lot more
 
5. Files in the Package

   -readme.txt         |This file 
   -retrievr.exe       |The actual program
   -wget.exe           |GNU wGet
   -GPL.txt            |The license of GNU wGet and Marvin's Retriever
   
   
6. Hardware and Software Requirements

   Any PC with OS/2 Warp or EcomStation.
   Needs the emx 0.9d runtime installed.
   wget.exe which is included. (Included version is 1.53, others not tested)
   500 Kb Harddisk space
   
7. How to Install

   If you downloaded the .wpi install file, then just double click at
   it using the WPS and follow the instructions. A Folder with the
   Program object will be created.

   If you downloaded the .zip install file, then create a directory 
   somewhere and extract the .zip file in to it. You can then
   create an program object or just start Marvin's Retriever by
   executing "retrievr.exe".

8. How to use
  
   Well just use the program object to start it and you will be able to
   type in a URL. I normaly use Netscape's function "copy link to clipboard"
   when I want to download something on a website by using the right mouse
   button on the hyperlink.

   It is also possible to start Marvin's Retriever from the commandline
   shell like this:
   
       "retrievr.exe -d <directory> -c URL" 
      
       -d <directory>    sets the working directory (without brackets)
       -c                Tells Retriever to resume where the download stopped
                         the last time.
       URL               Well the internetadress of the file which should be
                         downloaded

   The Buttons are more or less meaningfull. 

   - Retransfer means start from the
     beginning and get the whole file again.
   - Retry means stop the present connection and restart at the saved position
   - Pause stops the present connection
   - Continue resumes the download
   - Cancel stops the connection and closes the program window. The partly
     downloaded file will not be deleted.

9. Problems
   -The launch button only launches .exe files
   -




10. Download and Contact

Marvin's Retriever can be downloaded from the following locaton.
   
    - http://homepages.compuserve.de/madmuid/retriever.html
 
    or from hobbes

    - http://hobbes.nmsu.edu  try one of the following
       
       - http://hobbes.nmsu.edu/cgi-bin/h-search?key=retriever01.zip
       - http://hobbes.nmsu.edu/cgi-bin/h-search?key=retriever01.wpi



I would like to hear of any ideas, bug reports (I expect there to be a lot
of bugs, and I know of quite a few myself, hence it is an alpha 0.1 release!)
I also would like to know if this is useful to anybody except me, myself and I!

So this is me
  Diarmuid Albers  -  madmuid@compuserve.de


11. License

This version of Marvin's Retriever doesn't have the source code included, 
so I am not fully supporting the GPL2 license, but the source code will be 
available soon!

Marvin's Retriever is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

Marvins's Retriever is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with Marvins's Retriever; see the file GPL.txt.  
If not, write to the 
Free Software Foundation, 
59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.

or visit them in the net 
  - http://www.gnu.org/licenses/licenses.html


