Contents
 Help Contents

© 1996-1997 James D. Borror

    All rights reserved.

Introduction

An Overview

System Requirements, Installation

Requirements for running WingFlyer

First-Time Installation

Quick Start and Tutorials

Quick Start

Command Line and Batch Downloads

 	What makes a Webpage?

Basics

Licenses, Copyrights and other Legal stuff

Shareware License and Registration

Order Form

Version History

Acknowledgements

Advanced Features

Advanced Options on the Configuration Screen

Registered Version Features

Auto-Download New Versions

Troubleshooting and Tips

Support

Frequently Asked Questions

Known Problems

Some Tips with WingFlyer


Overview
 An Overview

WingFlyer is a (relatively) small utility that allows the user to download any webpage, graphic, or file  including any CGI-generated images and webpages over the internet (or intranet) that can be addressed with the standard http addressing scheme.

In other words, WingFlyer is a utility that will allows you to download the same webpages that you can see in your webbrowsers, such as Netscape`s Navigator, or Microsofts Interner Explorer.  You can also configure WingFlyer to download the webpages that are pointed to by other webpages.

For example, say you are looking at a company homepage that gives you an overview of what the company does.  This page includes information  like address, contact, and maybe a brief description of services.  WingFlyer, by default, will download that webpage and its pictures.  BUT, suppose that webpage has links or it points to other webpages with more information - like details on the products the company carries.  You can configure WingFlyer to not only download the first page, but to automatically download the webpages that it links or points to.

Another example : You are looking at the main page of an online newspaper.  This page also has links to the the columns or articles associated with that newspaper or magazine.  WingFlyer can be configured to just download the main page, and it will still keep the links pointing to the other pages, or you can have WingFlyer download the main page and the other pages it points to all at once.

Of course the next question is, can WingFlyer download the pages that the second page points to?  Of course it can.  You control how many levels deep you want WingFlyer to download.  Of course, keep in mind that as the number of levels increase by 1, the number of webpages you download may increased dramatically more.  For example : if the main page points to five new pages and each new page points to ten additional new pages, then just going 2 levels deep will get you 56 webpages.

Actually, I am being conservative.  My experience has shown that the number of webpages increase much more.  I downloaded 2 levels at the main Microsoft site and came up with about 355 different webpages.  Keeping in mind that each webpage probably had 8 to 10 images on it, the number of files downloaded was well over 1500 files.

Anyway, if you are ready to try WingFlyer, you can check out the Requirements for running WingFlyer and how to install WingFlyer under Windows. After that, you are ready to try the quick start demo.


 Requirements for running WingFlyer

A PC with MS Windows : This can be Win 3.1, Win 3.11, Windows for Workgroups, Win95, or WinNT.  Recommended 386-25 or better, but it will run on slower machines.  Personally, I have not tested it on OS/2, but I have been told it will run.

Vbrun300.dll (Visual Basic 3.0 runtime module) : Check in your windows or windows/system directory.  Otherwise,you can download it from any number of sites including AOL, Compuserve, Prodigy, Simtel, Cica, or go to shareware.com and do a search on the net for vbrun300.dll.

Ctl3dv2.dll (Windows library) :  Though this file is commonly found with most windows installations, there are occassions where it may be missing.  If you try to run WingFlyer and you dont have this file, then you will a error message entitled No Resume.  Check the common distribution sites (as listed above) for a copy.

A network connection - either a direct or dial-up connection.  WingFlyer is a winsock 1.1 compatible application. Since many network applications today are winsock compatible, the odds are that if you are already running programs such as Eudora, Ewan, or Netscape, then you probably will be able to run WingFlyer.  If you have a problem starting up WingFlyer, check out the known problems.

A WebBrowser : Netscape, Mosaic, MSIE, or some other webbrowser is recommended though WingFlyer does not require a webbrowser to run, only to view the files downloaded.

Some basic Windowing skills, including how to add a program to Windows, how to copy and paste in Windows, how to click and double-click, and how to select text with the mouse.  And, of course, some Network browsing experience and some familiarity with common internet terms is a plus.


  First-time Installation

First, make sure that you have the file vbrun300.dll.

Second, check the files you unzipped from the package and make sure you have the following files :

     ipp20.vbx wingflyr.exe threed.vbx wingfly.hlp wfstuff.dll install.txt printall.dll reson.dat

Please verify that these files are correct.

Third, if you havent already, create a directory(or folder) for WingFlyer and place all the files in that directory(folder).  The files THREED.VBX, and IPP20.VBX could also be placed in your windows/system directory(folder), but I recommend you put them in with the other files first.  It makes it easier to move or reinstall the software later on.

Fourth, add a program icon to Windows, making sure that you give the full pathname of the wingflyr.exe as the application name, and the full path of where you put the files (wingflyr.exe, wingfly.hlp, wfstuff.dll, install.txt, reson.dat, printall.dll) as the working directory.

For example if you installed the files in :	D:\APPS\WINGFLY\

the application name would be :	D:\APPS\WINGFLY\WINGFLYR.EXE

and the working directory would be :	D:\APPS\WINGFLY\


A quick start tutorial
 Quick Start

Step 1 - Startup the application.

Make sure you have an active internet connection. WingFlyer will not work until you have an active connection to the internet.  Once you are connected, start up WingFlyer.

Step 2 - Enter the webpage URL into WingFlyer.

Choose a webpage to download.  Pick a URL address.  If you want to copy and paste the address, then go ahead and select and copy the URL at this time.  For this example, I have chosen the webpage entitled Dr Download (URL : http://www.drdownload.com/).

Enter the URL. Click on the entry box labeled WebSite Name to highlight any text there.

Either by typing or pasting, enter the complete URL in the WebSite box.

Step 3 - Enter the name of the downloaded file.

Activate the WingFlyer parsing feature by clicking on the entry box labeled D/L Name.  Notice that WingFlyer has stripped off the http prefix and placed the website name and URL Path into the proper places.

Choose a directory and filename. If there is more than one file associated with this webpage then they will be saved in separate files, with WingFlyer choosing the most appropriate name.

So it is a good idea to choose a separate subdirectory for your download to keep all the webpages and picture files together.  In this case, I chose c:\temp\drdown\ as the place and index.htm as the name to save my webpage.   So now the entry form looks like this :

Step 4 - Set your options.

For the purpose of this tutorial, the default options are fine, but lets go over each one briefly.

Download Graphics Files(Checked by default).  This option allows you to download the graphics files in the webpage.  Normally, this option is checked by default since you usually want the pictures downloaded with the webpage.  If this option is unchecked, then WingFlyer will still download any webpages, but the graphics files will not be downloaded, thus saving a significant amount of time if you are only interested in the text of the webpage.

Overwrite, Skip, or AutoRename Existing Files Without Asking(Overwrite is checked by default). This option handles any case where a file already exists by that name.  Overwrite will automatically overwrite the file without asking.  Skipping will keep the original file and will not save any file with an exisiting filename.  Autorename will automatically rename new file if its name already exists.  The fourth option (neither option checked), is to prompt the user each time there is a filename conflict and give them the option of what to do, including overwriting, skipping, or renaming the new file.  When you want to run WingFlyer unattended, it is best to check either the Overwrite or Skip exisiting Files to avoid making the program wait for periodic user input.

Current Selection Only, or Multi-Level download(Current Selection is checked by default).  Current Selection allows only the webpage name to be downloaded.  Multi-Level allows the user the ability to download not only the current download, but other referenced webpages as well.

Step 5 - Download the files.

Check your information.  Make sure it is correct, and click on the Send Request button.  When the download is done, you will hear a simple beep to single the end of the download, the connection box will show Download Complete and the Files Remaining box in the Status window will show zeroes.

View your webpage.  Open your webbrowser and use the open file option and view your webpage.


Command Line and Batch Command Options
  Command Line and Batch Downloads

WingFlyer allows three different ways to "automatically" download one or more webpages at a time - two by command line options, and one from within the program.

1.  To automatically download one webpage :

Use the following command line parameters.

wingflyr    options      URL       destination file

Where :

options can be any combination of the following options:

-i	Run as an icon.

-g	Same as checking the Download Referenced Files option.

-o	Same as checking the Overwrite Files option.

-k	Same as the Skip Files option.

-a	Same as the Auto-Rename option.

-s	Same as the Strip HTTP option.

These options can be in any combination and can be entered individually like this :

wingflyr -i -g -o ……

or all together like this :

wingflyr -igo ……

URL is the full URL address (combination of the WebSite Name and URL Path) of the webpage such as :

http://www.chevrolet.com/car/a141.htm

destination file is the same filename that goes in the D/L Name such as :

c:\temp\gm\a141.htm

If we were to automatically download this file, this is how the command line look :

wingflyr -igos http://www.chevrolet.com/car/a141.htm c:\tem\gm\a141.htm

2.  To automatically download a number of webpages  :

Use the following parameters

wingflyr /F filename.txt

Where :

filename.txt is a command file that contains a number of lines, one per webpage, with the same format used in the first example.  You can include comments by prefixing them with a single quote ().  An example command could look like this (Comments are italicized) :

`Common webpages that I like to download

-gios  http://www.yahoo.com/ c:\temp\yahoo\index.htm

-gios  http://www.cnet.com/ c:\temp\cnet\index.htm `I can even put comments here.

`Download only a zip file

-si  http://www.updates.net/month_summary.zip c:\temp\updates\mon_sum.zip

In addition to the above options, you can now load a configuration file completely defining any option that Wingflyer gives you  including password protection, number of levels, etc.  Add a line like the following :

`-L filename.ini

*Note that the single quote (`) is significant.

Where :

filename.ini is the nameof a special configuration file.  Keep in mind that the configuration includes the name of the file to be downloaded.  Plus, any settings that you set will stay in effect until either the batchfile is finished being processed, or if other options (iogsk or `-L).

3. Download a number of webpages from inside WingFlyer :

Create a command file with the identical format as described in 2 above.

Start up WingFlyer and click on the Auto Request button.  WingFlyer will prompt you with a file dialog box to pick the command file you created.

4.  Create, edit and save any changes to a command file from within WingFlyer :

Click on the Utilities Screen button, and then click on the Edit Command File option at the top.  This will bring a screen up for you to load, create, and save your command files.


What is a Webpage
 What makes a WebPage?

A Webpage  is what you see in your webbrowser.  If that webpage has pictures, background images or sounds, then it is made up of more than one file.  For instance, if you download a small webpage with a background image and one picture, you have actually downloaded a minimum of three different files.  One for the webpage text, and one each for the background image and picture.  What if the webpage loads background music when you are reading it?  Well, then that adds another file to the group.

When WingFlyer downloads a webpage it takes the one name you have given it and saves the main webpage to it.  The additional files (graphics, images, sounds, etc) are save as separate files.  WingFlyer tries to keep the name as close as possible to the original and saves it in the directory that is determined by the Where to save files option.


Licenses, Copyrights, and other Legal Stuff
 Licences, Copyrights and other Legal Stuff

WingFlyer ® Copyright © 1996-1997 by James David Borror.

All rights reserved.

License Agreement.  You should carefully read the following terms and conditions before using this software.  This license agreement and warranty applies to this and all previous versions of WingFlyer.  Future versions of WingFlyer can contain a license agreement and warranty that will supercede this one.

In addition there may be a special license agreement and warranty signed by me that may provide exception to this license for a limited specified group.

For information on distributing the shareware version of WingFlyer see the section titled Shareware License.

Registered Version.   A single registered copy of WingFlyer may either be used by a single person who uses the software personally on one or more computers, or installed on a single workstation used nonsimultaneously by multiple people, but not both.

Distribution of Registered Version.  Distribution, unless otherwise previously agreed upon, will be electronic only. The use of one or more of the following methods will be able : WebPage access, email or anonymous ftp.

Site license.  A registered Site Licence is limited to the number of individual copies that are determine by me and the party registering the software.  Each individual copy carries the same restrictions and privileges as a single registered copy does.

Governing Law.  This agreement shall be governed by the laws of the State of Maryland.

Disclaimer of Warranty.  This software and the accompanying files are sold "as is" and without warranties as to performance of merchantability or any other warranties whether expressed or implied. Because of the various hardware and software environments into which WingFlyer may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it.  The user must assume the entire risk of using the program.  ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.


 Shareware License and Registration

Evaluation and Registration.  WingFlyer is shareware.  Please feel free to try out the program to make sure it fits your needs and expectations.  The price for registration is minimal  and can be found on my webpage at :

http://www.hellodollies.com/wf.html

and is based on your satisfaction and honesty in using it.  Registered users will get some added benefits for registering including a registered copy with their name and user id embedded in it.  Additional benefits will probably be added.  To register, send payment, along with your valid email address,  to :

Jim Borror

6926 Birdwood Avenue

Baltimore, MD 21220

Credit card ordering and quantity discounts (are also available, as described in the section Order Form.  When payment is received you will be sent information on how to obtain a registered copy of WingFlyer.

Distribution.  Provided that you verify that you are distributing the Shareware Version you are hereby licensed to make as many copies of the Shareware version of this software and documentation as you wish; give exact copies of the original Shareware version to anyone; and distribute the Shareware version of the software and documentation in its unmodified form via electronic means.  There is no charge for any of the above.  This in no way grants you a Registered License, it is simply a means to allow free distribution of the Shareware program.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission, with one exception:  Disk Vendors approved by the Association of Shareware Professionals are permitted to redistribute WingFlyer, subject to the conditions in this license,  and provided I receive a copy of the distribution.


 Order Form

WingFlyer® 2.60m

All orders are subject to the WingFlyer License Agreement.

Ordering by check.  To order by check send this order form and a check to :

James Borror

6926 Birdwood Avenue

Baltimore, Md 21220

To print this order form, click on Print Topic in the File pull-down menu.  Payment should be in US dollars drawn on a US bank, or you can send international postal money orders in US dollars.

Credit card ordering.  MasterCard, Visa, or Discover only. No American Express!  You can do this by phone, FAX or postal mail.

Name (as to appear on Licensed copy) :

___________________________________________________________________

email address to mail registration information :

___________________________________________________________________

Address (Including Name):

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

Payment enclosed (check one) : [   ] Credit Card  [   ] Check   [   ] Money Order

Type of License (check one) :     [   ] Individual license(s)       [   ] Site License

# Individual Licenses or Number for Site License:	___________

Price (Can be found at Error! Reference source not found.) : ___________

Credit Card Info (If applicable) :

Number :  ____________________________________________________

Name as appears on the card : __________________________________

Expiration date :  ____________________

Signature : ___________________________________________________


 Support

Make sure you have the most recent version of WingFlyer.  To check, load the WingFlyer home page at

http://www.hellodollies.com/wf.shtml

Also check the sections titled Frequently Asked Questions, Known Problems, and Tips and Solutions for answers to some common questions.

Technical support is available at no charge as described below. You can send electronic mail to jborror@usa.net, or send postal mail to

Jim Borror,

6926 Birdwood Ave

Baltimore, MD, 21220 (USA).

When requesting support, please consider and include the following information :

1)  Is the problem always reproducible?  If so, what are the circumstances?  If not, how consistent does the problem occur?

2)  If the problem is that WingFlyer has stopped working, or a newer verison refuses to work, please include any changes in your system or network configuration.

3)  What version of Windows are you running?  For example, Windows 3.1, Windows for Workgroups, Windows NT 4.0, etc.

4)  If a dialog box with an error message was displayed, please include the full text of the dialog box, including the text in the title bar.

5)  Are there any special considerations for your network hookup?  For example : Are you running off a Novell network?  Are you connecting through a  national service provider like AOL, Compuserve or Netcom? Are you behind a firewall or using a proxy server?

6)  Please include any *.ini files found in your WingFlyer directory.

7)  Please avoid being argumentative in asking questions and providing suggestions.  Besides starting off on a bad foot, argumentative openings usually do not provide sufficient information to figure out what is the problem.  "I have a need to get WingFlyer to do  such_and_such"  is much more informative and pleasant than "Why did you ever set up the options that way for"?

Plus a hint : I tend to not answer email that is either belligerent or includes personal attacks - veiled or insinuated.  Just a nasty quirk of mine.

Note: You can press F1 at any time while WingFlyer is active for context sensitive help.

Related Topics:

Frequently asked questions

Known_problems

Tips and Solutions


Version
 Version History

Version	Released	Comments

2.60I-l	11/02/97	Fixed some more bugs including one dealing with saving the graphics file directory.

2.60c-h	07/14/97	Fixed several bugs. Redid some of the screen layouts.

Added Auto-rename feature for downlods.

Last Shareware version planned to be released.

2.59l-m	05/25/97	Added the Print All option button to the help menu to print all help pages.

2.59k	05/19.97	Added the option to turn off the resizing function in WingFlyer.  Some video configurations have trouble with this option turned on.

2.59d-j	05/12/97	Moved the Strip HTTP options off the front page.

Made some adjustments to the filtering options.

2.59c	05/04/97	Added additional filtering options based on embedded strings, or based on the URL tree.

Added enlarged view mode on the main screen.  Clicking on the maximize button will not only cause the form to enlarge, but will also enlarge the text.

Moved some miscellaneous resources from the main executable to an additional dll file.

Added tab-like dialogs to the configurations screens.

2.59b	04/24/97	Added filtering options for choosing which files to download or not to download.

2.59	04/12/97	When WingFlyer is minimized, the download status (number of files, graphics, levels, batch level, etc) will show in the icon.

Changed the background of the helpfile back to white to make it easier for users with monochrome screens to read.

2.58	04/05/97	Fixed Base URL reference found to be used on some webpages.

*Fixed* bug that should check for duplicate filenames and allow user to change the names.

2.57	03/17/97	If a directory name is given as the Download File option, WingFlyer automatically appends the name index.htm.

2.56a-d	02/25/97	Fixed routine that checks for bad download names.

 	Fixes a problem when wingflyer tries to make sure someone is not passing a directory name as a filename.

Also contains a patch to handle webpages with a lot of references that have very similar names.

Fixed problem where WF would go into loop if the user clicks on the exit button while WF is downloading.

Registered Users only - Added Auto Download button to automatically check for new versions of WingFlyer.

2.56	02/24/97	Added automatic update feature for registered users.

Fixed a number of webserver related problems including wrong case and saving graphics files with htm extensions.

Fixed and re-added Download Graphics Files which allows the user to choose whether or not to download the graphics files referenced by the webpage.

2.52	12/31/96	Removed the upper limit on the number of graphics pictures that can be downloaded from any one webpage.

Moved the number of levels box to the front page.

2.51	12/16/96	Released Bug Fix dealing with the way downloaded webpages were named.

2.50	12/14/96	Reworked configuration file to the standard windows ini format.

Fixed bug dealing with nonstandard port numbers run from the command line.

Added support for the <bgsound> HTML tag.

Added support for the <INPUT Type=Image…> HTML tag.

Fixed Bug handling filenames containing a single quote.

WF automatically restores last settings prior to starting a download.

Added the -L option to batch downloads that will allow the user to completely define any download options they want.

2.48	11/20/96	Saves files names that have an extension of jpeg as jpg to allow editing in paint programs.

Fixed some minor bugs that interfere with normal downloads.

Added a true helpfile to contain all information originally found in the accompanying text files.  Thus, no more readme.1st, feature.txt.

Special thanks to Bob Weil for his great artwork on the startup screen.

2.46	10/28/96	Improved minimize function to make it work better with pre Win95 machines.

Fixed command-line function so it is not case-dependent.

2.45	10/24/96	Added support for new <embed> HTML tag.

Fixed problem with password function.

2.4	10/12/96	Minor adjustments to the way downloads are logged.

Add a system "ping" when job is finished being downloaded.

2.3	09/16/96	Reorganized Configuration Screen for easier use.

Add switch to turn on/off multi-level downloads on the front page.

Add ability to set a network timeout value.

2.2	09/14/96	Enlarged the screen area

Added limited balloon help.

2.1a	08/25/96	First shareware release with German translation.

Added user ability to change what files are seen in the help screen.

2.1	08/14/96	First full shareware release.

Adds user option to configure specific sub-directories for webpage and graphics files.

Adjusts download routine to keep DNS and disconnect errors from stopping the program.

Adds download errors to the logfile : weblog.txt so user can keep trap of missing files.

1.20b3	07/21/96	Completely compatible with cfg files of version 1.20 or older from WebFetch or WingFlyer.

Edited Advanced Configuration to include additional options for multi-level downloads such as including other sites in downloads, and the Option to create subdirectories similar to WWW site.

Allow user to turn off "warning" messages such as "file not found on server" and prompt to create new subdirectory.

1.20b2	07/15/96	Completely compatible with cfg files of version 1.17 or older from WebFetch or WingFlyer.

Fixed incompatibility problem with some webpages.

1.20b1	07/09/96	Completely compatible with cfg files of version 1.17 or older from WebFetch or WingFlyer.

First beta version release of WingFlyer, initially to beta volunteers only.

1.0	06/25/96	Prior version lost when it accidentally opened a large gaping hole which caused many things (including this program) to be "slid" into a parallel universe.Only thing left was a cufflink with a monogram of "QM".


Advanced Options on the Configuration Screen
  Acknowledgements

•	New Startup Screen is courtesy of one of my registered users.  Special thanks and appreciation to Bob Weil, the artist of WingFlyers new Startup screen.

•	Also, thanks to the many people who have offered encouragement, suggestions, criticisms and bug reports.  Without whom, WingFlyer just would not be around today.

•	To my darling wife, Barb, for all her patience, encouragement and support.

•	To Microsoft, for making a great programming tool.

•	To DevSoft for making my internet programming life much easier.

•	And to the internet community as a whole, whose very existence creates an infrastructure that not only makes these projects possible, but more importantly, provides us the most important means of global communication today.


Advanced Options on the Configuration Screen
  Advanced Options on

the Configuration Screen

Almost all the advanced options can be divided into two groups : Connection Options (Advanced Communication Options), and Downloading Issues (Advanced Configuration Options).

Advanced Communication Options

Proxy Server Information :	To configure for a proxy server, open the configuration screen to the Advanced Communication Option.  Enter the proxy server name into the box labeled HTTP Proxy Server Name.  Enter the proxy server port number into the box labeled HTTP Proxy Port Number.  Make sure the box labeled Proxy Server Active is checked.  Click on the Save button to make these changes permanent.  To disable Proxy Server services, clear the Proxy Server Active box and click on the Save button.

Network Connections :	Open the configuration screen to the Advanced Communication Option.  Under Network Connections, enter a new value in seconds and click on the Save button to make it permanent.  This is how long WingFlyer will wait before timing out.

Password-Protection :	To configure a username password, open the configuration screen to the Advanced Communication Options. Fill in the User and Password boxes, click on the Enable Password and on the Save Authentication.  Click on the Authorize button to activate your username/password pair and then click on the Save button to make changes permanent.  To change just the username and password, enter the new values and click on the Authorize button.

WebBrowser Spoofing  :	To change which WebBrowser WingFlyer mimics, open the configuration screen to the Advanced Communication Option.  Under WebBrowser Spoofing, click on either Netscape or MSIE (Microsoft Internet Explorer.  To make permament, click on the Save Button

Advanced Configuration Options

File Logger Information :	You can choose whether or not to log downloads of both webpages and graphics by going to the Advanced Configuration Option in the configuration screen.  Under File Logger Information, check the box next to the items you want to save information on.  Click on Save to make changes permanent.

Download Options :	You can modify whether the webpages show full pathnames or relative pathnames for their links (the latter is recommended - since you can move a set of webpages without disturbing the links).

Extension Filter :	You can choose to either download only those files with certain extensions, or choose to keep those files from being downloaded.  Note that has no effect on embedded graphics, only on those picture files that have links to be downloaded.  Sound files (mid, wav, etc) can be filtered though.

If you choose Exclude Only, then WF will download everything but the files with the extensions in the list box next to the options.  If you choose Include Only, then WF will only download webpages and the files with extensions found in the listbox.

To add a new extension, click in the list box and type in a new extension and click on the Add button.  To delete an extension, click on the item in the listbox and click on the Del button.  Make sure you click on the save or set buttons to make changes stick.

Where to Save files :	Open the configuration screen to the Advanced Configuration Option.  Under the Where to Save Files, you can choose three ways for WingFlyer to save the downloads.  Save Like WWW directory tries to create a reasonably close directory structure that is similar to the webservers layout.  Keeping in mind inconsistencies in naming conventions may require some differences.  Save in user-defined directories gives the user the option to save webpages in one directory and graphics in another, by using the HTML and Graphics button to define the subdirectories.  Save in the same directory will save all files in the same directory.

Warning Messages :	When running unattended, you can stop any warning messages or pop-up windows from stopping WingFlyer`s actions by setting the Turn off Warning Messages.  To configure, open the configuration  and click on the Save button to make changes permanent.

Path Filter Options

Filter by String :	Allows the user to filter out (Exclude) or only include (Include) URLs that contain one or more strings defined by the user.  The user adds or deletes strings from the dropdown list, choosing the Include or Exclude Option.  Options are saved by clicking on the save button.  Options do not affect the graphics files to download, only the webpages.  So if a webpage is "filtered" out, then the graphics on that page are not downloaded, too. Excluding an URL has priority over Including an URL.  So if a URL contains both strings that are to be included, and to be excluded, the URL will be excluded from the download.

Filter by URL :	Allows the user to filter out (Exclude) or only include (Include)

URL's based on their relationship to the filer URL's.  As above, if a webpage is "excluded', then it will not be downloaded.

Additional Options

Copy and Pasting :	See the Quick Start Tutorial for an example of copying and pasting in WingFlyer.

Resizing the screen :	You can resize the main form by moving your mouse down to the lower right corner. When the cursor changes to a double-headed arrow, hold down the left mouse button and drag the mouse until WingFlyer is at the size and shape you want.

Configuration Files:	You can create additional copies of the configuration file by doing the following : Make all the changes in the Configuration Screens that you want and then hold down the shift key and click on the Save button.  A dialog box will pop up, allowing you to save the configurations to a separate file (this will not change the contents of your default configuration file. You can then use that file for your batch downloads.

Strip HTTP Comments	You almost always want this checked.  Downloaded files come with embedded information (HTTP Comments) about the request and the status of the file.  If this information was not stripped, all the picture and binary files would be corrupted and un-useable.   Turning this option is only useful when you are either investigating how webservers send files, or if you are trouble-shooting a problem.


Automatic Download Feature
 Auto-Download New Versions

Registered Users Only

This feature allows the user to set WingFlyer to periodically check for a new version of WingFlyer and(if you want), will download the zipfile to your machine.  In addition, you can also check for a new version at any time.  The advantage is that you do not need to know a URL, username or password - WingFlyer does it for you automatically.

Heres how it works.  When you start up the registered version the first time, WingFlyer will prompt you with the following notice :

This informs you of the new feature and will only appear only once.  You can just click the OK button to continue.

Instructions to setup WingFlyer to automatically check for a new version

Once WingFlyer is up and running, Click on the Info button and click on the Configure AutoDownload Button.  You will see a screen similar to the following :

WingFlyer Home Site. This box will probably never change.  It is here just in case my website changes between versions.  Unless noted by me elsewhere, just leave these it alone.

Where to Download New Version.  WingFlyer automatically selects the WingFlyer home directory to store a temporary file and where to download the zipfile containing the new version of WingFlyer (if it exists).  You can change this to any other directory if you so desire.

Next Check.  You have three choices - daily, weekly, or monthly. WingFlyer defaults to weekly.

Automatically check for new version.  This option must be checked if you want WingFlyer to automatically check for a new version.

Automatically download new versions.  This only works if you have the Automatically check for new version option checked.  If this option is not checked, then if WingFlyer finds a new version available, it will prompt you first before downloading the file(s).  If the option is checked, then WingFlyer will automatically download the new version if it finds it.

Save Changes.  Click on this button if you want to save any changes you made.

Instructions to check any time for a new version

On the main screen, move the mouse pointer to the lower left-hand corner of the WingFlyer screen. Click the right mouse button once.  A new button will appear labeled Auto:

If you click on the button normally (with the left mouse button), WingFlyer will use the settings found in the Auto-download area and go out and check for a new version of WingFlyer.  It will follow the same conditions as stated above with the auto-configuration settings.


 Frequently Asked Questions

How do I set and save my own settings?  Click on the Config. Screen. button.  You  have opened the configuration screen.  Clicking the options at the top : Main Screen Configuration, Advanced Communication and Advanced Configuration.  The Main Screen is the screen you open to, set the values to what you want to see as the defaults.  Click on the other options at the top and set those values they way you want.  When done, click on the Save button at the bottom of the screen.  The configuration screen will close and the values are set.

How do you download more than one level of webpages.   How do you download the webpages along with the graphics that are shown?  On the main screen, click on the multi-level option download option.  A # Levels box appears.  Try setting the value to 1 or 2 and then save the configuration.  If you need more levels, then increase the number in small increments between trials.

What do all those files that come with WingFlyer do?  Here is a list and short description of each of the file included with WingFlyer:

ipp20.vbx wingflyr.exe threed.vbx wingfly.hlp wfstuff.dll install.txt printall.dll reson.dat

wingflyr.exe - the main executable for WingFlyer.  This goes in the installation directory.

wfstuff.dll - file contains additional resources needed by WingFlyer to run.  Put this in the same directory as the wingflyr.exe file.

printall.dll - great dll that I use to add a capability to print out all the help documentation.

ipp20.vbx & threed.vbx - additional third party files needed by WingFlyer for network and 3d effects respectively.  You probably can place them in the same directory as the wingflyr.exe file.

wingfly.hlp - windows help file for WingFlyer.

install.txt - short text file for installing WingFlyer.

reson.dat - normally not required.  Under certain video or monitor drivers, all you see are gray screens with no  detail.  Renaming this file to resoff.dat and restarting WingFlyer should make this error go away.

ctl3dv2.dll - needed for WingFlyer to run and must be in the Windows or Windows/system directory.


Some Tips with WingFlyer
 Tips and Solutions

Where to Save Files.  If you are downloading more than a few webpages, dont use the Save in Same directory option.  The number of files can be enormous, as well as having a hugh number of index files - inde0001, inde0002,  inde0100.htm.

Timeout problems.  If your network connection is very slow and WingFlyer keep timing out, try setting the Network Connections timeout in the Advanced Communication Screen to a larger number.

Proxy Server.  If you are behind a firewall and use a proxy server, make that you use the name of your proxy server in the proxy server name.  In addition, make sure the Proxy Server Active option is checked and the configuration is saved.

"File Not Found on Server" error.  Make sure that you have the correct spelling and case in the URL Name box. There must be something in the URL NAME, so f the box is empty, enter a /.

Resume error.  If when you try to start WingFlyer and you get a small window that says Resume and the program quits, you are missing one or both of the following files : ctl3dv2.dll and ctl3d.dll.  You must obtain copies of these files either from the window installation disks or from www.microsoft.com and install them in your windows/system directory.


 Known Problems

Network Related Problems

To be able to use a winsock application, you need a TCP/IP stack. If you use Windows for Workgroups, you can use the free TCP/IP add-on available from ftp.microsoft.com. If you use Win 3.1, there is a number of commercially available TCP/IP stacks. You can also try the shareware Trumpet winsock. Windows95 usually comes bundled with a winsock compatible TCP/IP stack, as does current versions of MS Windows NT.

WingFlyer has problems with connections using the following software :

•	Twinsock as the dial-in connection - no good fix for it, yet.

•	Novells TCP/IP - It has been found that Novells winsock.dll needs the file NOVASYNC.EXE in order to work with any programs that use the asynchronous winsock API, which WingFlyer uses.

•	 Some Banyan networks using proxy servers software from IDT.

Downloading problems

There is a known problem with WingFlyer if you try to download a huge number of files into the same directory.  WingFlyer has trouble addressing this situation and I am currently working on a solution for it.  Meanwhile - if you use the mimic website option, this will avoid the immediate problem entirely.

Video display problems

I have found that if you do not define your monitor or video card with the correct driver, certain screens in WingFlyer will appear as blank or grayed out.  The one known solution is to install the proper drivers.  If this is not possible, or does not fix the problem, then rename the reson.dat file to resoff.dat.  This will fix the gray screen problem, but it will keep the main screen from being able to be resized.


 Glossary

Term	Definition

File Servers	A machine on the internet running software that allows the user to transfer information or files to and/or from it.  There are three common types are Web servers, FTP servers, and Gopher servers.
FTP Server	FTP stands for File Transfer Service.  Most commonly used to transfer binary files, such as zipfiles, executables and graphics.
Gopher Server	Like FTP servers, used to transfer files.  The big difference is the ability to separate files by categories - like Picture Viewers instead of the directory structure you see with FTP servers.
HTTP	Short for HyperText Transport Protocol.  The language, or protocol that WebBrowsers (and WingFlyer) use to download files from a Web Server.
http	Used at the beginning of a url, or webpage address, to designate that the file can be downloaded from a webserver.  Almost any webpage or file that has this type of address can be downloaded by WIngFlyer. Examples :http://www.hellodollies.com/wf.shtml
HTTP Comments	As in the Strip HTTP Comments option in WingFlyer and WebFetch.  Normally, before sending the file that is requested by a WebBrowser (or WingFlyer), the webserver sends information about the file - type, size, etc.  To see this information, turn off the Strip HTTP Comments option and download a file.  The HTTP Comments can be found at the beginning of the file.
URL	Stands for Universal Resource Locator. It is the specification on how to address an object (webpage, file, query) over the net. It tells the program not only what and where to download, but how (what protocol to use) to download it.  There are three main parts to the URL - the Prefix, Server Name, and URL Pathname:                   http  ://  www.charm.net  /~hdollies/wf.shtml                 Prefix   |   Server Name    |    URL PathName                          ftp  ://  ftp.charm.net     /pics/landscape.gifPrefix - how and what type of server. Server Name - where to get the object. URL Pathname - where to find the object on the server. See also http, ftp, gopher.
url	The actual address used to locate and download a file or files over the net.  See also http, ftp, gopher.Examples : http://www.homesite.com/girlsngirls.html ftp://ftp.berkeley.com/pub/dosgames/doomv12.zip gopher://gopher.apple.com/pub/system/upgrades
Web Server	This is where webpages are stored and is the only place you can get webpages from.


Price Notice

The registration price of $10 is guaranteed at least through June,1996.  After that, the price may go up.


Well actually, I don``t think the program is such a terrible thing - It`s just that my previous attempt at writing help-files was pretty lame.


Bob is a major contributor to a must-see sight - Dr Download (http://www.drdownload.com) and can be reached at bob@hypertising.com.


Even though a webpage appears as a single page in the browser, in reality, it consists of at least one file for the text and description, plus additional files for each picture and in the case of frames (where the screen is divided into different sections), additional webpages.  Important to remember when you decide on a name for your webpage - since it may end up being many individual files.


If you have different files, then either someone has made their own version of the wingflyer archive, or the files have gotten mixed up.  In either case, I recommend you get a clean copy of the archive - available at :

http://www.hellodollies.com/wf.shtml

These files may have been tampered with, so there is no reason to take any chances.  IF this is supposed to be a registered copy, then contact me at :

jborror@usa.net


Copy and Paste in Windows

To copy : Select (highlight) the text to be copied and hold the Ctrl key and press the Insert and then release both - or use the applications Copy menu item under the Edit menu option.

To paste : After copying, click in the area you want to paste to.  In WingFlyer`s case, you will most likely be clicking in the WebSite box to paste the URL you have copied.  Hold down the Shift key and press the Insert key and then release both.


Activity Lights-Red lit indicates a server connection, the yellow indicates data being downloaded.


WebSite Name - The actual name of the webserver.  In the example :

http://www.charm.net/~hdollies/

www.charm.net is the WebSite Name. created with Help to RTF file format converter

created with Help to RTF file format converter


URL Name The rest of the URL address that follows the WebSite Name.  In the example above, /~hdollies/ is the URL Name.


D/L Name Enter the full pathname of where you want to save the current webpage.


D/L Name File Dialog Button File Dialog to pick the Download filename.


D/L Referenced Files Option Download the images and webpages referenced by this webpage.


Strip HTTP Option Removes extra server information.


Overwrite Files Option Overwrite file if it already exists.


Skip Files Option Don`t save if file already exists.


Current Selection Only Option Only download current webpage and graphics.


Multi-Level Download Option Configure to download either the current webpage only or multiple levels.

created with Help to RTF file format converter

created with Help to RTF file format converter


Auto Request Button Load batch command file and start batch download.


Send Request Button Start downloading of current webpage.


Cancel All Files Button Cancel download completely.


Cancel File Button Skip the current file and go to next.


Download Status Area Information on current or last download.


Connection Status Status of last connection with webserver.


FileName Status Full URL of file currently being downloaded.


Download Status What is being downloaded currently.


Graphics Files Left Number lef t for current webpage.

created with Help to RTF file format converter

created with Help to RTF file format converter


Current WebPage Left Number of webpages at current level left.


WebPages for Next Level Number of webpages yet to be downloaded.


Number of Levels left to Download For current tree.


Number of files in Batch file left If using batch file, how many files left.


Configuration Screen Button Edit and save options.


Balloon Help Button  Nuff said.


Information Screen Button Additional information on network connection.


Exit Button Game over, man.


Page Options Choose from basic, communicaton, or downloading options.

created with Help to RTF file format converter

created with Help to RTF file format converter


Remote Port Local address on Webserver.  Normally the value is 80, and very seldom will ever be changed.


WebSite Name - The actual name of the webserver.  In the example :

http://www.charm.net/~hdollies/

www.charm.net is the WebSite Name.


URL Name The rest of the URL address that follows the WebSite Name.


D/L Name Enter the full pathname of where you want to save the current webpage.


D/L Name File Dialog Button File Dialog to pick the Download filename.


D/L Referenced Files Option Download the images and webpages referenced by this webpage.


Strip HTTP Option Removes extra server information.


Overwrite Files Option Overwrite file if it already exists.


Skip Files Option Don`t save if file already exists.

created with Help to RTF file format converter

created with Help to RTF file format converter


Current Selection Only Option Only download current webpage and graphics.


Multi-Level Download Option Configure to download single or multiple levels of webpages.


Cancel Button Close without saving.


Current Values Button Show values on Main screen.


Default Values Button Show default values on Main Screen.


Set Defaults Current session only.


Save Defaults Permanent change.


Proxy Server Information Used only if you have a proxy server.


Proxy Server Active Option Check to activate proxy services.

created with Help to RTF file format converter

created with Help to RTF file format converter


HTTP Proxy Port Value Local address on proxy server.


HTTP Proxy Server Name IP or netname of proxy server.


Network Connections  Configure connection type.


Timeout Box Number of seconds before a timeout.


Password Authorization Use only for pasword-protected pages.


Enable Password Option WF uses current username/password.


Save Authentication Option Username/password will be saved to the configuration file.


Username Entry Username.


Password Entry Password

created with Help to RTF file format converter

created with Help to RTF file format converter


Authorize Button Registers Username/password for use.


Web Browser Spoofing Fool the server.


Mimicing Netscape v2.0


Mimicing MSIE v2.0


Mimicing Generic WebBrowser If the others don`t work.


Edit Comand File Section Load, edit and save command files.


Command File Name Entry Name of command file.


Command File Dialog box Button Choose file from file dialog box.


WebSite Name - The actual name of the webserver.  In the example :

http://www.charm.net/~hdollies/ www.charm.net is the WebSite Name.

created with Help to RTF file format converter

created with Help to RTF file format converter


URL Name The rest of the URL address that follows the WebSite Name.


Remarks Line Add remarks on current line.


D/L Name Enter the full pathname of where you want to save the current webpage.


D/L Name File Dialog Button File Dialog to pick the Download filename.


D/L Referenced Files Option Download the images and webpages referenced by this webpage.


Strip HTTP Option Removes extra server information.


Overwrite Files Option Overwrite file if it already exists.


Skip Files Option Don`t save if file already exists.


Iconize while running. Minimize WingFlyer while downloading

created with Help to RTF file format converter

created with Help to RTF file format converter


File Logger Information Type of information logged.


Log Webpages Option Webpages and single binary files.


Log Graphics Option Any image, sound or video file.


Download Options General Options.


Pathnames Rarely useful.


Multi-Level Downloads How to download sites.


Number of Levels  Number of levels to choose.


Including other sites Links to other webpages on other sites.


Where to save webpages File management.

created with Help to RTF file format converter

created with Help to RTF file format converter


Similate the WWW directory Long names will be shortened.


User-defined directory Useful for keeping pictures together.


HTML Directory Button Webpage and other HREF references.


Graphics Directory Button Images, sounds, video, etc.


All-in-one directory No separation of files.


Turn off Warnings Get rid of warning boxes, recovers from any download errors.