OS/2 Shareware BBS: 35 Internet/35-Internet.zip/wwwos2.zip/webwilly.hlp

OS/2 Help File | 1998-07-31 | 73KB | 1,779 lines

ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ

WebWilly Watch has many features which allow parents to guard their children
against some of the practices that are rampant on the world wide web today. It
can prevent a child from entering private information such as their street
address, on web-based forms and in chat rooms. It can prevent a child from
viewing web pages whose URL (web page address) contains specified strings such
as xxx or hotbabes. It can prevent a child from viewing web pages whose content
includes particular words and phrases, or 1-900- phone numbers, and many other
possibilities. The documentation for these features can be viewed by pressing
the Help button in the Parent Watch Options notebook, which is found at the top
of the program's popup menu.

But besides all the parental guidance features, WebWilly is also a web browser
add-on program for everyone who surfs the web. It adds great functionality and
usability to your web browser, whether you run the Netscape Navigator for OS/2,
or IBM's WebExplorer, or both.

The persistent jump list and unlimited monthly archive logs record every URL
(web page address) you ever visit while WebWilly is running. Then you can
easily find or return to any such site at any time, whether five seconds later
or five years later. A powerful search function lets you find any string in a
URL title, address, or both, in all archive logs or just within a specific
range of months' worth of logs. The Significant Site List keeps track of which
domains or sites you've visited in the past three months, in order according to
how much you access them! This is like a jump list of your most favorite places.

You can store any URL from the web browser or from the jump list or an archive
log file or one you type yourself, as a bookmark, to any folder, creating and
organizing your bookmark folders and sub-folders in whatever way you like. Then
return to the web site at any time by simply doubleclicking on the bookmark
while connected to the internet. You can even give a URL a nickname, which lets
you go to a web site without typing its entire address, when you're in the mood
to visit a URL by typing it instead of by finding its bookmark entry.

With sticky notes for your bookmarks, you can remind yourself of what a web
page is about or what you found particularly interesting about it.

Web Page Info is a little window which you can keep beside or above your web
browser window, which shows you the age of the page that's currently in your
web browser. It can also show you all the other information that the server
provides about the page and about itself (for example, what kind of web server
software it's running).

WebWilly also has powerful local agents for downloading a series of web pages
while you're doing something else. For example, the CacheUp feature lets you
retrieve selected jump list entries, nickname entries, or even an entire folder
of bookmarked URLs to your hard drive, all at once, so they'll be ready for
faster viewing once you're ready to view them.

Page Mining Agents let you download not only single or multiple web pages, but
also a specified number of levels of the pages linked to them. Then you can
browse these "mined" pages at your leisure, and access the "mined" pages linked
to them. If you're still connected to the internet at the time you're doing
that, then you can even access the further levels of linked pages that weren't
"mined". And the Page Mining Results Tree window shows you all the links in the
"mined" pages, in a tree view format rather than the web page format.

Edit a URL's Source File downloads a page to a temp file, and edits it with
E.EXE (or you can edit the temp file using any program you want). If you modify
and save the file and wish WebWilly to do so (and know the site's password), it
uploads the new file to the web for you. The result is the same as if you were
editing the file on the host.

Built-in conversion routines allow you to convert the IBM WebExplorer quick
list and Netscape Navigator bookmarks to WebWilly bookmark format. Included
REXX utilities let you create bookmarks from the command line, from an ASCII
text file, from WebWilly for Windows bookmarks, and from OS/2 WorkPlace Shell
URL objects.

The first time you open WebWilly, you'll see a seven-button toolbar, with a
line of text below it which tells you the function of whichever button you put
your mouse pointer over. The first thing you should do is take a look at the
program's properties (also known as settings, in OS/2 versions before Warp 4).
To do that, click your mouse on the leftmost toolbar button (the dog) to bring
up the main WebWilly popup menu, and click on Properties. Alternatively, you
can just type Ctrl-P from the toolbar. (As in most applications, the keystroke
shortcuts WebWilly uses are listed on the menus next to the menu items they represent.)

WebWilly should work with any version of Netscape's Navigator, or any version
of IBM's WebExplorer. If it doesn't seem to work with yours, please try the
Alternate URL window location setting. Also, check the other settings on that
page of the properties notebook to make sure that what WebWilly is looking for
in the OS/2 window list is really what appears in the OS/2 window list when
your browser is running.

In order for WebWilly to work with the Netscape Navigator, the latter must be
configured (which it is, unless you've changed it yourself) to show the current
URL in an entry field near the top of its window. That is, its Options menu's
Show location option must be enabled. If you turn the option off, WebWilly will
turn it on again the next chance it gets.

WebWilly works with the WebExplorer when the latter's Show current URL option
(its equivalent of Navigator's Show location option) is disabled, but the
reason it works is that when WebWilly talks to WebExplorer by telling it what
string to put into the entry field, WebExplorer acts as if the field were
enabled, even though it's still invisible. Which means that whenever WebWilly
is running, the Home and End keys, and the left and right arrow keys, in
WebExplorer, act in the WebExplorer's URL entry field, just as they would if
the entry field were enabled. So even though you can't see the URL entry field,
you can't use those keys in WebExplorer to scroll the current page, as you can
when that entry field is disabled and WebWilly is not running.


ΓòÉΓòÉΓòÉ 2. Toolbar ΓòÉΓòÉΓòÉ

WebWilly's main application window is the toolbar, which consists of seven
buttons and the optional descriptive text below them. The seven buttons are as follows:

Popup      menu
           Lets you access all the features of WebWilly which aren't available
           from their own toolbar buttons (such as the Page Mining Agents and
           the properties notebook), as well as most of the ones which do have
           their own buttons.

Jump       list
           The list of URLs you've visited most recently. From here, you can
           view them, search them, copy them to bookmark folders, delete them,
           etc., and especially view the referenced web pages in your web browser.

List of bookmark folders
           This is where you create and access your folders of bookmarked URLs.

Add to a bookmark folder
           Lets you add the current URL in your web browser to a bookmark
           folder of your choice (or create a new folder and add it to that one).

Search URL logs
           Brings up a menu from which you can access your monthly archive log
           files, or have WebWilly search them for a particular string of text
           and show you a list of the URLs and/or web page titles which contain
           that string.

Load a new URL
           Lets you type a URL you'd like to visit, or type a WebWilly nickname
           you've created which stands for a certain URL; then directs your web
           browser to view that web page. Alternatively, lets you reload the
           current page in the web browser if there was an error during
           transmission the first time or if you think the page has changed
           since the first time.

Switch to [web browser]
           Brings your web browser to the foreground if it's running, or starts
           it if it's not; or (via the right mouse button) Browser-Toggles
           between the two web browsers.

When WebWilly is running, its toolbar is accessible via OS/2's Ctrl-Esc window
list, and also via the WebWilly toolbar option on the Window menu of many other
WebWilly windows.


ΓòÉΓòÉΓòÉ 3. Popup Menu ΓòÉΓòÉΓòÉ

The main WebWilly popup menu, accessible via the leftmost button (the dog) on
the toolbar, or your F5 key, gives you an alternate access method for most of
the functions on the toolbar buttons. It also gives you access to all of the
WebWilly functions that don't have toolbar buttons.

Parental   properties
           This selection opens the Parent Watch Options notebook, where you
           control the parental guidance features of WebWilly Watch. The
           notebook has a Help button, which displays the documentation for all
           of those features.

           Properties
           Opens the WebWilly properties notebook.

           Open
           This submenu gives you access to several features, many of which are
           also on toolbar buttons.

           Jump list

           Nickname list

           Web page info

           Archive list

                      Open month

                      Search

           Bookmark folder list

           Significant site list

Bookmark current document
           Same as the Add to a Bookmark Folder button on the toolbar.

Page mine the current page
           Creates a temporary or permanent Page Mining Agent, for the URL
           that's currently in your web browser, and invokes it.

Page mining agents
           Opens the List of Page Mining Agents window.

Record URLs in log
           This option lets you turn off (or turn back on, if you've already
           turned it off) the logging of the jump list entries and the monthly
           archive log file entries. If you want to turn off the latter without
           also turning off the former, there's a setting for that on the first
           page of the properties notebook. Both of these settings are disabled
           when the parental guidance feature is turned on, so that a child
           cannot change them without the parent's knowledge.

Flip       toolbar
           Turns the horizontal toolbar vertically, or turns the vertical
           toolbar horizontally.

Hide       toolbar
           Makes the toolbar window disappear. When you want it back, you will
           find it in OS/2's Ctrl-Esc window list. If you want WebWilly to
           start up with the toolbar already hidden, start the program with an
           /H (for Hide) parameter. If you're starting it via an OS/2 Desktop
           program object, then the way to add the /H parameter is to click on
           the object with your right mouse button, select Properties from the
           resulting popup menu, and type /H into the Parameters field of the
           resulting notebook dialog.

Convert

           IBM WebExplorer quick list
                      Reads your WebExplorer quick list entries into a folder
                      of WebWilly bookmarks.

           Netscape Navigator bookmarks
                      Reads a Navigator bookmark file into a folder of WebWilly bookmarks.

Advanced

           Edit a URL's source file

[Web       browser]
           Brings the WebExplorer or Navigator (whichever you have WebWilly
           configured for at the moment or, if you don't have that one running
           but you do have the other one running, then the other one) to the
           foreground, or starts the configured one if neither is running. Same
           as the Switch to [web browser] button on the toolbar.


ΓòÉΓòÉΓòÉ 4. Properties Notebook ΓòÉΓòÉΓòÉ

The WebWilly properties notebook is accessed via the option on the main
WebWilly popup menu. The following settings are available on the General page
of the WebWilly properties notebook:

The Web Browser radio buttons let you select whether you want WebWilly to treat
the Netscape Navigator or the IBM WebExplorer as your main browser. You don't
have to come into the properties notebook in order to change this setting,
though; you can also use the browser-toggle feature to do that. For functions
which involve WebWilly watching whatever the browser is doing, it will watch
both browsers, including multiple windows of each, all at the same time. But
for functions which involve WebWilly using only one particular browser, such as
when WebWilly needs to start a browser when there isn't one already running,
this setting is what tells WebWilly which browser to use for such purposes.

The Jump list settings let you determine how many of your most recently visited
URLs are saved in the jump list. When the maximum is reached, the list is
trimmed to contain only the minimum number. Then the list begins growing again
from there, until it once again reaches the maximum. The lower the minimum
setting, the fewer jump list entries you have from which to choose, after each
time the list is trimmed. But the higher the minimum you choose, the sooner
you'll reach the maximum, so the more often the program has to spend your
computer's time rewriting the entire file (which is the only way the program
can remove the older entries from it).

The Position after load radio buttons let you determine where, on your screen,
WebWilly will position its toolbar every time WebWilly sends itself to the
foreground after having given focus to the web browser. (This setting also
takes effect when you change it and close the properties notebook, and when you
use the Flip toolbar option, but not when you start the program. When you start
the program, the toolbar will come up in the position it was in at the time you
last closed the program.) The choices include each of the four corners of your
screen; and None which lets the toolbar remain wherever you put it, and also
prevents WebWilly from trying to keep itself in front of the browser window.

The Include toolbar descriptions checkbox lets you turn off the small line of
text below the toolbar (or to the right of it, if you have it flipped
vertically) which tells you the purpose of each of the toolbar buttons as your
mouse pointer passes over them.

The Record URL addresses in monthly log files checkbox lets you turn off the
WebWilly feature which saves the URL for each web page you visit in a monthly
archive log, besides just in the jump list. If you want to turn off both the
monthly log recording and the jump list as well, the Record URLs in log option
on the main WebWilly popup menu lets you do that. Both of these settings are
disabled when the parental guidance feature is turned on, so that a child
cannot change them without the parent's knowledge.

The following settings are available on the Navigator page and the WebExplorer
page of the WebWilly properties notebook. Fill in the appropriate page(s),
depending on whether you use the Netscape browser or the IBM one or both:

Path and filename is the executable file for your web browser. You can select
it, using the Find button, or just type the name yourself. You must include the
full pathname if it's not located in a directory that's on your PATH (in your
CONFIG.SYS file).

Start-up parameters is where you can specify any parameters you want WebWilly
to pass to your web browser program whenever WebWilly starts it. For example,
many people like to use the string -q -t 8 with the IBM WebExplorer.

Automatically open and close [web browser], when selected, means that WebWilly
will start up your web browser automatically every time you start WebWilly, and
then, when you close WebWilly, the web browser will also close.

Window list search string is the string WebWilly will look for in the OS/2
window list (Ctrl-Esc) in order to find and communicate with your web browser.
Title bar search string and Title delimiter are what WebWilly should see in the
web browser's title bar, other than the title of the web page you're visiting.
Accurate entries in these fields are what makes it possible for WebWilly to
interact with the browser. If WebWilly finds a window on your desktop which has
the right title, and contains a window with the same window handle as your
browser's URL entry field, WebWilly will think that window is your browser, and
try to send URLs to it and read URLs from it. If WebWilly can't find any such
window, then it won't have a window which it thinks is the browser, with which
it can interact. The title delimiter is what comes between the current web
page's title and the browser program's title, in the browser window's title
bar. It is usually a hyphen (-) character. The title bar search string is what
appears on the other side of the delimiter, from the current web page's title,
in the browser window's title bar. For example, a Netscape Navigator window
might say Welcome to AACME's Home Page - Netscape, in which case the title
delimiter is a hyphen and the title bar search string is Netscape. This means
that WebWilly will know that when it finds a window in the OS/2 window list,
named Netscape, that may be your browser window, and that window's title bar
contents other than the - Netscape part is the text which should be assumed to
be the current web page's title.

Alternate URL window location lets you tell WebWilly where to find your web
browser's URL entry field, within the browser's main window. The URL entry
field is the specific part of the web browser with which WebWilly interacts,
when it wants to know what web page you're viewing or when it wants to tell the
web browser to go to a page for you. If WebWilly isn't seeing what web page
your web browser is viewing, or if it isn't able to tell your already-running
web browser to go to a page and insists on starting a new copy of your web
browser instead, and you've already checked the settings in the above
paragraph, then this setting is likely to fix these problems. This setting was
already filled in once, when you first installed WebWilly, but if you change to
a new version of browser software, you will probably need to do it again. To
use this setting, press the Find button to the right. The Find an Alternate
Location for the URL Window message box will come up, and tell you to type
PLEASE FIND ME HERE into your web browser's URL entry field. Do not press the
OK button yet. When you've gone to your browser and typed that phrase, without
pressing Enter, then come back to the Find an Alternate Location for the URL
Window message box and press its OK button. WebWilly will search all the parts
of all the windows on your system until it finds PLEASE FIND ME HERE. When it
finds that string, it will find the window handle of the entry field which
contains that string, and enter that window handle into the Alternate URL
window location field in your properties notebook. From then on, as long as
you're using that particular version of your web browser, WebWilly should be
able to find the web browser's URL entry field by using that window handle.

The SigSites page of the properties notebook is for the Significant Site List feature.

The PageMining page of the properties notebook lets you specify any filename
extensions you may want to have treated as *.HTM files during Page Mining
operations (which includes the CacheUp feature). By default, WebWilly treats
*.HTM, *.HTML, and *.SHTML files, files without an extension, and the result
returned by any link which contains a question mark (?) as *.HTM files, but you
may also want some other extension to be treated that way. For example, if you
like to mine a site which contains a link to a *.CJM file which is a program
that produces an *.HTM file as its output. When WebWilly requests this *.CJM
file from the server, the result is an *.HTM file, but WebWilly doesn't know
that unless you tell it so, using this setting.

The other setting on this page lets you specify any filename extensions you may
want to have treated as *.ZIP files during Page Mining operations; that is,
that you want the program to refrain from retrieving. By default, WebWilly
treats *.ZIP and *.EXE files this way, but you may also want it to treat *.PDF
files or *.CMD files this way, for example.

The Proxies page of the properties notebook lets you configure WebWilly to use
a classical proxy for all of its HTTP work (Page Mining, CacheUp, Web Page
Info, the parent watch options, and the retrieval aspect of Edit a URL's Source
File) and/or its FTP work (the sending aspect of Edit a URL's Source File). A
classical proxy server is one which expects to receive HTTP requests in the
form GET http://www.innoval.com:82/index.htm HTTP/1.0 (as opposed to GET
/index.htm HTTP/1.0 which would be the method used if there were no proxy
server involved), and expects to receive FTP requests in the form USER
[e-mail] (as opposed to USER username which would be the logon
command used if there were no proxy server involved). You specify your proxy
server names and port numbers, and you may also specify any servers which are
inside your firewall such that you never want WebWilly to use proxy support
when dealing with them. There is also a checkbox which lets you temporarily
turn off WebWilly's proxy support without removing the server names from the
settings. This is useful, for example, on a laptop which is sometimes used
inside the firewall and sometimes taken outside.

The Navigator, WebExplorer, and Proxies pages of the properties notebook are
disabled whenever the parental guidance feature is turned on, so that a child
cannot configure them in such a way that the program can no longer do its job.


ΓòÉΓòÉΓòÉ 5. Jump List Window ΓòÉΓòÉΓòÉ

The jump list window is used for the jump list (which you access via the second
toolbar button) and for the monthly archive log display window and the Archive
Search Results window (both via the fifth toolbar button). All of these
functions can also be accessed via the Open submenu of the main WebWilly popup
menu. The jump list window can also be found via the option on the Window menu
of many other WebWilly windows. The other two can also be found via the archive
submenu options on many WebWilly windows' menus.

The jump list is the list of the most recent URLs you've visited with either
browser, not only during the current session, but also including previous
sessions of the web browser program and of WebWilly. It is one of the main
focal points of WebWilly. In fact, it's used so much that once you open it
during a session, WebWilly leaves it open for faster access the next time you
want it. So whenever you close the jump list window, it doesn't close at all;
it only hides (which is why you'll see it in the OS/2 window list when you
think it shouldn't be there).

The jump list window has five columns. The URL Number column numbers the URLs
in chronological order of your visits. The Title column and the URL column are
the name and address of each web page. Between those two columns is the
separator bar, which you can move to your desired position by moving your mouse
pointer over it until it turns into a double arrow and then dragging it with
the mouse. And the Date and Time columns tell when you first visited the page.
If you go to a page which is already listed in the jump list, it isn't added
again, so only the earlier occurrence will appear.

The options on the File menu are also available on the right mouse button popup
menu of each URL in the list.

Save       as
           Exports the current contents of the window, with the entries in the
           current sort order, to an ASCII text file. You can then print the
           file, or manipulate it in whatever way you like, using any program
           that reads ASCII text files.

Open URL in browser
           Passes the selected URL address to the web browser. The same effect
           can be achieved by doubleclicking on the URL entry in this window.
           You must be connected to the internet at the time you use this option.

Open       archive
           Same as the Search URL logs button on the toolbar. (This option is
           not present on the menu of the monthly archive log or Archive Search
           Results windows, which is the only difference between them and the
           jump list window.)

Bookmark   URL
           Same as the Add to a bookmark folder button on the toolbar, except
           that in this case the URL being bookmarked is the selected URL in
           this window rather than the current URL in the web browser.

Create a Page Mining agent
           Automatically creates a new entry in the List of Page Mining Agents
           window, using the title and URL of the selected entry, and the
           default Page Mining Agent settings.

Delete selected URLs
           Removes the selected URL(s) from the window. In the case of the jump
           list and monthly archive log windows, it also removes the URL(s)
           from the files which hold the data that's displayed in these
           windows. Therefore, use this function sparingly, since a main
           purpose of the jump list and archive logs is to be able to find
           absolutely any URL you've ever visited. They can only let you find
           entries which you haven't deleted from the lists.

CacheUp selected URLs
           Performs WebWilly's CacheUp function on the selected URLs.

Copy URL to clipboard
           Copies the selected URL to the OS/2 clipboard so you can paste it
           anywhere on your system.

Create a   nickname
           Automatically creates a new entry in the Nicknames window, using the
           title and URL of the selected entry, after prompting you for the
           nickname to use for it.

           Find
           Selects the first entry below the currently selected one which
           contains (in its title, URL address, date, or time) the text string
           you tell it to find.

The Sort menu lets you choose which column of this window determines the order
in which the URLs are listed in the display. It also lets you select whether
you want that sort order to be ascending or descending. When sorting by
date/time, only the hours and minutes are compared; the seconds have not been
tracked and cannot be used in the sorting. So if you visit two pages during the
same minute, those two will be listed in ascending chronological order even if
you have the sort set for descending order.

The View menu lets you choose whether you want the Date and Time columns to
come before or after the URL column of this window.


ΓòÉΓòÉΓòÉ 6. List of Bookmark Folders Window ΓòÉΓòÉΓòÉ

The WebWilly bookmark folder windows are accessible via the List of Bookmark
Folders window, which you find via the third toolbar button (the row of books)
or via the option on the Open submenu of the main WebWilly popup menu. It can
also be found via the option on the Window menu of many other WebWilly windows.

Whenever you find a web page you think you'll want to be able to find easily in
the future, you might make a bookmark for it. The Add to a bookmark folder
button on the WebWilly toolbar will make a bookmark for whatever page is
currently loaded in the web browser (if you have more than one browser window
open, the one WebWilly will see is the one for which WebWilly is currently
configured). The Bookmark URL option in the jump list window makes a bookmark
for whatever URL you have selected in the jump list or in a monthly archive log
window (which actually uses the same window that's used for the jump list).
Both of these options present you with a list of folders to which you can add
the new bookmark. From that folder selection dialog, you can also create a new
folder and select it, instead of selecting an existing one. Or you can make a
bookmark for a URL without visiting it first, via the Add a new URL option in
the folder to which you want to add the new bookmark. See also drag and drop.

To create, modify, manage, and view your bookmark folders, you use the List of
Bookmark Folders window. Folders on this window which have sub-folders have a
tiny plus sign to the left, and clicking on that plus sign with your mouse (or
hitting the + key on your keyboard) shows you the sub-folders for the selected
folder, and turns the plus sign into a minus sign. Clicking on the minus sign
or using the - key, with the folder still selected, collapses that part of the
tree again. Folders for which there is a whole-folder CacheUp result file have
(c) beside their names.

The items on the File menu of the List of Bookmark Folders window are also
available via the right mouse button popup menu of each folder in the list.

Create a new folder
           Opens the dialog box which lets you create a folder, optionally
           assign an icon (from any drive on your system) to it, and optionally
           tell WebWilly where to create that folder. If you don't tell
           WebWilly a location, the folder will be a subdirectory under
           WebWilly's BOOKS subdirectory, and will have the same name as the
           first eight characters of the folder title (with underscore [_]
           characters substituted for all illegal filename characters). If you
           do specify a location, the directory you specify will be created, if
           it doesn't exist; or linked to, if it does. Either way, a link will
           be created in the BOOKS subdirectory's FLDINDEX.NIX file to point to
           any folder that isn't a direct descendant of the BOOKS subdirectory.
           (Any subdirectory which exists or is created under the BOOKS
           subdirectory will automatically be treated as a folder by WebWilly,
           without any FLDINDEX.NIX links, regardless of whether it was created
           by WebWilly or by anything else; FLDINDEX.NIX entries are only
           needed or used for folders which exist outside the BOOKS
           subdirectory.) You can have WebWilly create a folder anywhere you
           want, or link to an existing bookmark folder in another installation
           of WebWilly, or link to a directory of your own *.HTM or *.GIF files
           for an easy way of viewing them, etc. An alternate method of
           assigning an icon to a folder, besides selecting it in this dialog,
           is by simply copying an icon file to the folder subdirectory, and
           renaming it to FOLDER.ICO.

Create a   sub-folder
           Opens the dialog box which lets you create a sub-folder under the
           selected folder, and optionally assign an icon to it. The folder
           will be created as a subdirectory of the directory which is
           represented by that selected folder.

View a     folder
           Opens a folder window in which you can view the contents of the
           selected folder. Same as doubleclicking on a folder in the list.

           Delete
           Deletes the selected folder, all of its bookmarks (and files, if
           you've put any there for any reason), all of its sub-folders, and
           all of their bookmarks and files. Of course, first it asks you
           whether you're sure you meant to do that.

           Remove
           Removes the link (in the FLDINDEX.NIX file) to the selected folder
           without touching the directory or its contents. The folder will no
           longer be accessible from this copy of WebWilly, but if it was also
           a folder in another WebWilly installation, the folder and its
           contents will remain intact and accessible from that one. This
           option can only be used for folders which are not directly below
           WebWilly's BOOKS subdirectory, since those are the only folders
           which have FLDINDEX.NIX entries; for folders under the BOOKS
           subdirectory, use the Delete option instead.

Change folder name & icon
           Lets you specify a new name and/or a new icon for the selected folder.

CacheUp selected folder
           Runs WebWilly's whole-folder CacheUp function on the selected folder.

View folder CacheUp URL
           Loads the results of the selected folder's most recent whole-folder
           CacheUp action into your web browser. This occurs automatically as
           soon as the CacheUp function has completed (unless it was activated
           via the /IC or /CI switch), but this menu option exists so that you
           can also view the results again later.

Count      URLs
           Recounts the number of URLs in a folder, in case you copy or delete
           some via the command line or some other program, while this window
           is open, and you want the list to reflect the folder's new contents.

Refresh    list
           Makes WebWilly reload the list of bookmark folders, in case you've
           created or removed a directory via the command line or a file
           manager since you last opened this list window.

The Icons menu lets you select among 10x10 bit icons, 20x20 bit icons, and
32x32 bit icons, for this window, which lets you fit more or fewer entries in
the same amount of window space. If you use FOLDER.ICO files in your folders,
you'll probably want to use the 32x32 selection here.

The View Menu

Expand     all
           Shows all sub-folders, as if you'd pressed all the + buttons at once.

Collapse   all
           Shows only the top-level folders, as if you'd pressed all the -
           buttons at once.


ΓòÉΓòÉΓòÉ 7. Bookmark Folder Windows ΓòÉΓòÉΓòÉ

Bookmark folder windows are accessed via the List of Bookmark Folders window.
The contents of each folder are displayed in its own folder window. This window
has columns for each bookmark's Title, URL, and the Date and Time of your visit
(or of creation of the bookmark).

Most of the options on the File and URL menus are also available on the right
mouse button popup menu of each bookmark entry.

The File Menu

Save       as
           Exports the contents of the window, with the entries in the current
           sort order, to an ASCII text file. You can then print the file, or
           manipulate it in whatever way you like, using any program that reads
           ASCII text files.

Create a new sub-folder
           Same as the option on the List of Bookmark Folders window.

CacheUp entire folder
           Same as the option on the List of Bookmark Folders window.

View folder CacheUp URL
           Same as the option on the List of Bookmark Folders window.

           Find
           Selects the first bookmark below the currently selected one which
           contains (in its title, URL address, date, or time) the string you
           want to find.

The Sort menu lets you decide which column of the bookmark list will control
the order in which the bookmarks are displayed in the list. It also lets you
select whether you want that sort order to be ascending or descending.

The URL Menu

Open URL in browser
           Views the selected URL in your web browser; same as doubleclicking
           on a bookmark entry. You must be connected to the internet at the time.

Move URL to a folder
           Lets you move the selected bookmark from this folder to any other
           (including one you create on the fly). See also drag and drop.

Copy URL to a folder
           Lets you copy the selected bookmark from this folder to any other
           (including one you create on the fly).

           Delete
           Deletes the selected bookmark entry. This option cannot be used to
           delete sub-folders; you can only delete those from the List of
           Bookmark Folders window.

Create a Page Mining agent
           Automatically creates a new entry in the List of Page Mining Agents
           window, using the title and URL of the selected bookmark entry and
           the default Page Mining Agent settings.

CacheUp selected URLs
           Runs the WebWilly CacheUp function on the selected URLs.

Create a   nickname
           Automatically creates a new entry in the Nicknames window, using the
           title and URL of the selected bookmark entry, after prompting you
           for the nickname to use.

Change the title or URL
           Lets you change the title of the selected URL as it shows in your
           bookmark folder window, or change the URL address itself, or add or
           change its userid and password.

Add a new  URL
           Lets you create a bookmark without visiting it via the web browser first.

Copy URL to clipboard
           Copies the selected URL to the OS/2 clipboard so you can paste it
           anywhere on your system.

Sticky     notes
           Lets you add, modify, or delete a sticky note for the selected
           bookmark entry.

The View menu lets you decide whether the Date and Time columns should be
displayed to the right or left of the URL column of the window.

Password-protected web sites

The userid and password are required in order to access password-protected web
sites. They're used by WebWilly only for the Page Mining and CacheUp features;
that is, only the features which involve WebWilly's interaction with the web
servers rather than with the web browser. When you use a bookmark to have
WebWilly tell the web browser to go to a web page, there is no way for the web
browser to accept the password information from WebWilly and pass it along to
the server. So when the web browser attempts to go to the URL and the server
replies that the site is restricted, the web browser will ask you for the
password just as it would if you weren't using WebWilly. Having the password
specified as part of the bookmark won't prevent that. The password setting in
the bookmark is only for use by the CacheUp feature.


ΓòÉΓòÉΓòÉ 8. Add to a Bookmark Folder Button ΓòÉΓòÉΓòÉ

The folder selection dialog comes up when you click on the Add to a Bookmark
Folder button on the toolbar or select Bookmark URL from the menu of the jump
list window or select Copy URL to a folder or Move URL to a folder from the
menu of any bookmark folder. The Add to a Bookmark Folder button makes a
bookmark entry for the URL that's currently being viewed in the web browser
(the one for which WebWilly is currently configured, if you have more than one
open at the moment; or the latest entry in the jump list, if there's no URL in
any open browser window). The other options mentioned act upon the URL that's
selected in the window from which the folder selection dialog was invoked. You
can also add a bookmark manually, via the URL menu of the folder to which you
want to add it.

The title bar of the folder selection dialog shows the name and address of the
URL it's going to bookmark or copy or move. The File menu of this window will
let you create a new folder, or a sub-folder of the selected folder, just as
the List of Bookmark Folders window does, if the folder in which you want to
store the bookmark doesn't already exist.

The File menu also has the Refresh list option, to cause the folder selection
dialog to show the results of any folder creation or deletion you've done
outside the folder selection window since it was opened.

The Icons menu lets you choose among 10x10 bit icons, 20x20 bit icons, and
32x32 bit icons, for the folders in this window, to increase or decrease the
number of entries that fit within the vertical space of the window.


ΓòÉΓòÉΓòÉ 9. Search URL Logs Button ΓòÉΓòÉΓòÉ

This toolbar button (the magnifying glass) and the archive options on various
windows' menus bring up a submenu which lets you do two things:

Open month lets you open any one of your existing monthly archive log files
(where the URL of every web page you've visited with WebWilly running has been
stored) in a window that's just like the jump list window, except that it has
no Open archive menu entry since you're already viewing an archive log file. A
monthly log file works exactly like the jump list except that it holds an
entire month's URLs, and WebWilly does not prevent duplicate entries there. If
you visit the same URL twice in one session, the entry will be added to the
jump list and to the log file only once; but if you visit the same URL twice in
the same month, with the second time being after the URL entry from the first
visit has already aged off the jump list, then the entry will be added to the
log file again, when it's added to the jump list, even though it's already in
the log file.

Search lets you search any range of monthly archive log files for a certain
string, case sensitive or not, as you choose. You can have WebWilly search for
the string in the URL title, or the URL address, or both; and search all the
monthly archive files you have, or you can specify a certain range of months to
search. (If you don't enter dates in both the From and To fields, then WebWilly
will search all of the log files.) The WebWilly Archive Search Results window
is just like the jump list window (without the search options), but contains a
list of only those URLs which were found during that search. So you can do,
from that window, anything (except search) that you can do from the jump list window.


ΓòÉΓòÉΓòÉ 10. Load a New URL Button ΓòÉΓòÉΓòÉ

This toolbar button (the down arrow) brings up a dialog box by the same name.
It shows your Current URL in browser, if any, and lets you Reload it if desired
(if there was an error during transmission the first time, or if you think the
page's contents might have changed since the first time). It lets you enter a
new URL to load (and it even fills in the initial string, http://www., with
which most URLs begin). Or you can type a WebWilly nickname. You don't have to
delete the http://www. in the entry field before you type the nickname, but
since that fact is not self-evident, there is the Enter a nickname checkbox.
When you select that checkbox, it makes that string disappear so that it no
longer looks like it's going to get in the way of WebWilly's ability to resolve
the nickname. When you deselect it, it makes that string come back.


ΓòÉΓòÉΓòÉ 11. Switch to [Web Browser] Button ΓòÉΓòÉΓòÉ

This rightmost toolbar button brings your web browser to the foreground, or
starts it up if it isn't running. Of course, it can only work if the properties
are properly configured for your setup so that WebWilly can issue a command
that will actually find your web browser. If you have a copy of the browser for
which WebWilly is currently configured, running at the moment, that's the one
it will bring to the foreground. If not, but you have the other browser
running, then it will bring that one to the foreground. If neither one is
running, WebWilly will start the one for which it is configured.

If you ever use both the IBM WebExplorer and the Netscape Navigator, and
especially if you like to compare what a page looks like in each of them, or
view a page in the other one when it's not being properly displayed in your
first one, then you'll love WebWilly's Browser-Toggle feature! Click your right
mouse button on this seventh toolbar button (or hit your F6 key) while the one
web browser is running, and WebWilly will start the other web browser, if
necessary (which of course works best when you do not have the web browser
configured to automatically load a web page at startup; see Frequently Asked
Questions), and automatically load into it the same page which is currently
loaded in the first web browser. At the same time, WebWilly changes the default
setting in the properties notebook, to the second browser for you. So if you
use the Browser-Toggle feature to switch from one to the other, don't forget to
switch back unless you want the second one to become your new default.


ΓòÉΓòÉΓòÉ 12. Page Mining Agents ΓòÉΓòÉΓòÉ

The List of Page Mining Agents window is found via the option on the main
WebWilly popup menu. A Page Mining Agent goes to the web and automatically
retrieves all the root pages (URLs) it's configured to get, as well as
(optionally) the graphics files that need to be displayed in those pages, and
optionally up to nine levels of the links referenced in them, and stores all of
those files on your hard drive. Then, when you're ready to view them with your
web browser, you can do so without waiting for them to be retrieved via your
modem, whether you're still connected to the internet by that time or not!

The options on the File menu of this window (except the last one) are also
available on the right mouse button popup menu of each agent in the window.
Doubleclicking on an agent is the same as selecting it and using its Change option.

           New
           Brings up the dialog box which lets you create a Page Mining Agent.
           See below; see also drag and drop.

           Change
           Brings up the URLs for: window which lets you change the URLs and/or
           settings for the selected Page Mining Agent. See below.

Change name, icon or wav file
           Brings up the dialog box which lets you change the selected Page
           Mining Agent's name or icon or the sound that's made when the Page
           Mining operation is complete.

           Delete
           Deletes the selected Page Mining Agent and everything in its
           directory, after prompting for confirmation.

View output URL
           Sends the top-level output page from the selected Page Mining
           Agent's most recent invocation to your web browser. This is the
           option you should select after the agent has been invoked and
           completed its work and you're ready to view the results.

Build a results tree
           After a Page Mining operation is complete, WebWilly can show you the
           results in a window, in the form of a tree, sort of like a directory
           tree in a file manager program. The tree shows you the title of each
           page, and its parent/child/sibling relationship to the other pages
           in the site. If you click on a title with your right mouse button,
           WebWilly will show you the name of the Page Mining result file, for
           that page, on your hard drive, if one exists; as well as that page's
           original URL on the web, and the text of the link which pointed to
           the page from its parent. If you doubleclick on a title with your
           left mouse button, WebWilly will show the page to you in your web
           browser. If it's a page that was retrieved during the Page Mining
           operation, it will be the copy of the page on your hard drive. If
           the page wasn't retrieved (because it was beyond your configured
           level of links, for example), WebWilly will show you the page from
           the web instead. Either way, it can be much easier to find a page
           this way by a string in its title, than to hunt for it by following
           confusing links from the site's top-level page. Because there is
           also a Find option on this window's View menu, which shows you the
           next occurrence of the string you tell it to find, below the entry
           which you currently have selected. The title bar of the Results Tree
           window shows you the date and time the Page Mining operation
           finished, so you can see how old the information is.

View failed URL addresses
           Shows you the URL addresses of the web pages and/or image files
           which could not be retrieved during the most recent invocation of
           the selected Page Mining Agent. This information was stored in a
           file named ERROR.LST in the Page Mining Agent's subdirectory (which
           is below WebWilly's LAGENT subdirectory).

           Invoke
           Makes the selected Page Mining Agent(s) go to the web and retrieve
           their specified pages. You need to be connected to the internet at
           the time you start this operation. See below.

           Stop
           Cancels the Page Mining operation in progress.

The View menu lets you view the agents in Column view, Flowed view, or Icon view.

Cross Section of a Page Mining Agent

When you create a new Page Mining Agent, the first thing you see is the Create
a New Page Mining Agent dialog box. You type the name you want to give to the
agent (perhaps Daily if it will contain all the web sites you like to visit
every day; or perhaps the name of the site it contains, if it will contain only
one root URL); select an icon for it from any disk drive on your system, if you
like (if you don't, it will use WebWilly's dog icon); and choose for it to
beep, be silent, or play a *.WAV file (if you have OS/2's MMOS2 multimedia
support installed) upon completion. If you want it to play a *.WAV file, you
may type that file's full path and filename or select it using the Find button.
Upon return from that selection box, the *.WAV file will be played right then,
so that you can tell whether you selected the one you meant to select or not.
If you don't need for your Page Mining Agents to be able to play *.WAV files,
you may delete the PLAYWAV.DLL file from your WebWilly directory if you like.

Upon leaving the Create a New Page Mining Agent dialog box, WebWilly asks you
whether you're ready to add a URL address to the Page Mining Agent you've just
created. If you say yes, the URLs for: window follows. The File menu of this
window, and the right mouse button popup menu of each item in it, let you add a
new URL to the agent, change the settings of the selected URL in the agent,
delete the selected URL(s) from the agent, or copy the selected URL to the OS/2
clipboard. You can also add a new URL to the agent by dragging it from the jump
list window or from a bookmark folder. The main container area of the URLs for:
window shows you all the settings for each of the URLs in the agent.
Doubleclicking on a URL here is the same as selecting its Change option; it
brings up the Edit a URL Record dialog, which is nearly identical to the Add a
New URL Record dialog. Both of these dialogs allow you to enter or alter all
the settings for each of the root URLs in a Page Mining Agent. The Add a New
URL Record dialog comes up automatically when you leave the Create a New Page
Mining Agent dialog (if you say yes to the aforementioned question), so that
you can enter the settings for the first (or only) root URL that's to be
retrieved by this new agent. The settings for each of the root URLs in a Page
Mining Agent are as follows:

           Title
           Whatever title you want to give to it.

URL        address
           The main or root web page to retrieve, such as www.tiac.net/innoval/
           or http://www.innoval.com.

           Domain
           Usually, a URL's domain is just the same as its host server; the
           part of the URL before the first slash character. However, sometimes
           you will want WebWilly to act as if the domain were more specific
           than that. For example, if you want to mine the www.tiac.net/innoval
           site, with Allow links outside the domain turned off, you'll still
           get pages on the www.tiac.net host that have nothing to do with the
           /innoval site if WebWilly considers the domain to be www.tiac.net! (
           Because the www.tiac.net/innoval site has links to www.tiac.net as a
           courtesy to the company that makes this InnoVal web site possible.
           Such links to unrelated parent sites for courtesy reasons, are quite
           common.) But if you specify the domain, here, as
           www.tiac.net/innoval instead, then WebWilly will consider any URL
           that doesn't start with www.tiac.net/innoval to be outside the
           domain, and will not retrieve it.

           Userid
           Required for password-protected web sites; serves no other purpose.

           Password
           Required for password-protected web sites; serves no other purpose.

Include image files
           The default is yes. Turn it off if you don't want the agent to waste
           time retrieving all the graphics that would be displayed on the web
           pages. In which case, your web browser will display big X marks (or
           whatever it displays to represent missing graphics) where the
           graphics would otherwise go.

Allow links outside the domain
           The default is yes. Turn it off if you only want to retrieve linked
           files that are on the same server as the root page. For example, if
           you know that a linked site is often out of order and you don't want
           the agent to waste time trying to connect to that site; or if a
           linked site has a lot of graphics you don't want, or has hundreds of
           links you don't want, or is of no interest to you and the only links
           you want are the ones that are on the same server with the root
           page. This can sometimes have unexpected results, though, since some
           web pages reference other pages on other servers that really are
           part of the same web site, even when you would think they'd be in
           the same directory instead of elsewhere.

Levels of links to pursue (Inside the domain)
           The default is one, and the maximum is nine. Zero would mean only
           the named web page and its graphics; that is, zero levels beyond the
           root page. One means the named web page and its graphics, and all
           the pages linked to it and the graphics for all those pages. Two
           means the named page, all the pages linked to the named page, and
           all the pages linked to the pages that were linked to the named
           page, and all the graphics for those three levels of pages.

Levels of links to pursue (Outside the domain)
           The default is one, and the maximum is nine. This setting applies
           only if Allow links outside the domain is turned on. It tells
           WebWilly how deeply to go into linked sites on other servers. For
           example, one means that only the first page pointed to by the link
           will be retrieved (along with its graphics, unless you've turned off
           the Include image files option). Two means that the page pointed to
           by the link will be retrieved, as well as all the pages pointed to
           by that page. Please understand that the number of pages you can end
           up trying to retrieve is astronomical, if you don't keep this number
           low. We allow you to set it as high as nine in case you need to, not
           because it's a good idea to do so, as a rule!

Limit of files to download
           The default is 500. This includes *.HTM files (web pages), as well
           as the *.JPG and *.GIF files (graphics) and whatever else may be
           connected to them. Once WebWilly has retrieved the number of files
           specified in this limit, it finishes all the image files on the page
           it's working on (so it's not at all unusual to end up with a few
           more files than the number specified here) and then stops, even if
           there were many more links to go before finishing the specified
           number of levels of links. If a Page Mining Agent stops because it
           has run into this limit, rather than because it has finished all the
           levels of links you told it to follow, then a message box tells you
           so, upon completion. In which case, if you need more of the pages,
           you should reduce your number of levels or raise this limit, and
           invoke the agent again.

URL is     active
           The default is yes. You can turn it off, to have the Page Mining
           Agent temporarily ignore this particular root URL while still
           retrieving the other configured root URLs in the agent.

When you invoke a Page Mining Agent (or group of them), you must be connected
to the internet. The agent(s) will begin downloading all the text and image
files used by the specified root URLs. Whenever there is only one root URL
being worked on, the current *.HTM filename and the number of files pulled so
far for that root URL will appear in the bottom status line. When there are
multiple root URLs being worked on (whether two URLs in one Page Mining Agent,
or one URL in each of two Page Mining Agents), the status line will not be able
to provide that information.

The line above the status line will show the activity of up to twelve TCP/IP
sockets. On the left are four Document sockets. If you are running more than
four root URLs at once, the fifth, sixth, etc. will wait until one of the first
four is finished. On the right are up to eight Art sockets for the *.GIF and
*.JPG files, and such. These are used by the Page Mining threads on a
first-come, first-served basis. The status of a socket at any time can be one
of the following:

           starting
           A thread has taken control of the socket and is about to try to
           connect to the host server.

           host
           The first attempt at connecting to the host.

           conn
           Connection has been made.

           error
           Connection failed, or failure during download.

           reconn
           Retry after failure to connect.

0% -       100%
           Status of the download.

0k -       #k
           Status of the download (in kilobytes retrieved) when the host did
           not report the size of the file before beginning, so that a
           percentage of the total cannot be calculated.

           retry
           Retry after error during download or after second failure to connect.

           idle
           Previous thread has finished, and no new thread has yet claimed
           control of the socket.

Each of these socket status spots uses a specific fraction of whatever the
current window width is, so you won't be able to read any of them if you make
the window too narrow.

While a Page Mining Agent is running, all the items in the window are disabled,
as are all the options on the File menu except Stop.

Any time after a Page Mining process has successfully completed (even weeks
later unless you've deleted the resulting files yourself), you can select the
agent in the window and then select View output URL from the File menu or from
the right mouse button popup menu. This will show you the results of the most
recent invocation of the selected agent. If a Page Mining Agent contains just
one root URL, that URL page will be loaded into your web browser directly. For
a Page Mining Agent which has multiple root URLs, the web browser will display
a starting page which WebWilly will have created, which lets you view each of
the root URLs the agent contains. At the top of this page is a graphic which is
taken from the MASTHEAD.GIF file in your WebWilly directory. You can replace
this file with another *.GIF file with the same name, as long as its size is
300x40. You can even delete this file if you like, but then those
WebWilly-created *.HTM files will have a big ugly X (or whatever your browser
uses to represent missing graphics) across the top when you view them.

When viewing a Page Mining Agent's output pages, as usual when your mouse
pointer is over a link, the web browser will show you where that link is
pointing, in its bottom status line. You'll be able to see which links point to
"mined" pages on your hard drive (below the LAGENT subdirectory of your
WebWilly directory), and which are still pointing to pages on the web (because
they didn't get "mined", perhaps being beyond your specified number of levels
of links, or being outside the domain, etc.).

If you're connected to the internet while looking at the "mined" pages,
clicking on a link which is still pointing to the web will retrieve the linked
page from the web. Then, clicking on any link on that page will retrieve that
next linked page from the web, even if it's a link which points back to a page
that's one of the ones already on your hard drive. Because of course the web,
and your web browser, know nothing about a Page Mining Agent or the work that
it has done.

Sometimes when you click on a link that's pointing to a file on your hard
drive, you might get a message like "the server cannot find the URL you
requested" from your web browser. This will happen on some few occasions when
the Page Mining Agent had not been able to retrieve a page. But usually when
such errors occur, the link will remain pointing to the page on the web so that
you can try again later to retrieve it. The addresses of URLs which led to such
errors are viewable via the View failed URL addresses menu option.

You can also download *.ZIP files and ftp:// references in your "mined" pages,
if you're connected to the web at the time you're viewing the agent's output URLs.

If you have WebWilly installed on an HPFS partition, you can even run a Java
program which was linked to a page that was retrieved, while you're not
connected to the web, if that Java program doesn't require any other files from
the server in order to run. The reason this requires HPFS, is that the *.CLASS
file will refuse to execute if its filename doesn't end in .CLASS, and the FAT
file system (the alternative to HPFS) supports only three characters in the
filename extension.

To make WebWilly run a Page Mining Agent, from the command line or from a batch
file or an alarm program, without any prompts, and then exit automatically when
it's done, use /IP or /PI (for Invoke Page mining agent) as a command line
parameter, followed by the title of the Page Mining Agent (in quotation marks
if it's more than one word long), or the full pathname specification of the
directory which represents it (as in C:\WEBWILLY\LAGENT\INNOVAL). After it's
finished, WebWilly will return with an ERRORLEVEL code which represents the
number of errors encountered in transmission. So if you're using a batch file
to "mine" pages for you in the middle of the night, you might have the batch
file start the whole procedure over again an hour later, if there are five or
more errors, or whatever you think is an unacceptable number that might mean
the server was down the first time.

You can also use the /BP or /PB (for Browse Page mining agent) parameter to
start WebWilly and have it push the most recent output URL of the specified
Page Mining Agent into your web browser (as if you'd used WebWilly's View
output URL option) and immediately exit. With this parameter, the Page Mining
Agent is specified in the same way as with the /IP and /PI switches.

A very simple form of Page Mining Agent is WebWilly's CacheUp feature, the
description of which contains a discussion of the differences between these two features.

The differences between the two, however, can become blurred when it comes to
the Page Mine the Current Page feature. It lets you have the results of a Page
Mining operation without taking the time to create a Page Mining Agent first.
Once you have the page you want loaded into your web browser, just select this
option from WebWilly's main popup menu. The List of Page Mining Agents window
will automatically open, followed by the Page Mine the Current Page dialog.
This dialog lets you set most of the same options as the Add a New URL Record
dialog does for regular Page Mining Agents.

It also lets you make one other choice. Under the Style radio button, you can
choose Create a new Page Mining Agent with these parameters or Store results
temporarily. If you make the former choice, a Page Mining Agent will be created
and invoked. When the process has completed, it will be just like any other
Page Mining Agent; you'll have to select the View output URL option in order to
see the results, etc. (Which can be a definite benefit, if you want to use your
browser for other things while the operation is taking place, without WebWilly
pushing the output URL into the browser when it's done, right on top of
whatever you're trying to do with the browser at the time.)

But the Store results temporarily choice gives you a hybrid between a Page
Mining Agent and a CacheUp. The operation takes place in a separate window, the
Page Mine the Current Page window. This window's File menu has a Stop option
which lets you cancel the Page Mining operation, if you need to. Otherwise, the
output URL page will automatically be loaded into your web browser as soon as
the operation is complete. As with a regular CacheUp, this will be your only
opportunity to view it, unless you find it yourself on your hard drive and load
it into the web browser manually. The files resulting from this operation are
in the CACHE subdirectory of your WebWilly directory. If you need to see the
ERROR.LST file, you'll find it there as well. And the other difference between
the Store results temporarily style and a normal Page Mining Agent is that you
don't have the opportunity to use the Build a results tree option with the
former's output.

See Frequently Asked Questions for more information about Page Mining.


ΓòÉΓòÉΓòÉ 13. CacheUp ΓòÉΓòÉΓòÉ

CacheUp is the term WebWilly uses for its function of retrieving a group of web
pages, and the graphics used in them, to your hard drive, in advance, so that
you can look at them all together, without waiting for each one to be retrieved
via the modem when you want to move from one to another. None of the linked
pages are retrieved. So you would have to remain online, and wait for the
retrieval, in order to view any of the pages linked to the cached pages. If you
want to retrieve web pages along with their links, then what you want is a Page
Mining Agent rather than a CacheUp.

You can CacheUp groups of selected URLs via the menu options on the jump list
window, the Nicknames window, the List of Bookmark Folders window (only for
whole-folder CacheUp, described below), or any folder window. You could also
CacheUp single URLs, not just groups of them; but there would only be one
purpose for doing that: Having the web browser retrieve a password-protected
web page causes it to ask you for your password, but WebWilly won't have to ask
you that question if you use the CacheUp feature instead of the browser, to
retrieve the page, if you've already entered your password into the settings of
the bookmark or nickname entry in question.

CacheUp is very much like a Page Mining Agent set to include image files and to
pursue zero levels of links. Following are the differences between such a Page
Mining Agent and a CacheUp operation:

o   CacheUp can be done on the fly, without creating a Page Mining Agent first
    and without loading the page into your web browser to use the Page Mine the
    Current Page feature.

o   With CacheUp, you have no choice as to the settings, such as whether or not
    to retrieve graphics and how many levels of links to pursue.

o   CacheUp result pages are loaded into the web browser for you automatically
    upon completion. This means you don't have to do anything extra in order to
    view the results. But it also means that if you're doing something else in
    your web browser at the time the CacheUp operation completes, you may be
    irritated at the interruption.

o   The only time you can view a CacheUp's results is immediately after the
    CacheUp function is performed (unless you go hunting in your WebWilly
    directory's CACHE subdirectory for the appropriate *.HTM files and load
    them into your web browser manually). The exception to this is a
    whole-folder CacheUp, which will be explained shortly.

o   CacheUp doesn't beep or play a *.WAV file when it's done, as Page Mining
    Agents can.

o   CacheUp result pages can't be browsed in a Results Tree format.

o   Instead of each agent's resulting files being stored in its own directory,
    all CacheUp files go in the CACHE subdirectory of your WebWilly directory.
    The contents of this directory are deleted every time you restart WebWilly!
    The exception to this is a whole-folder CacheUp, which will be explained shortly.

o   CacheUp doesn't show you the URL addresses which could not be retrieved,
    when there are failed ones. It just tells you how many failures there were,
    because you'll find out so easily which ones are the errors when you click
    on them without getting to see them. ( Though the ERROR.LST file will exist
    in the CACHE subdirectory, so you can view it yourself if you should want
    to. It contains all the failed URL addresses from all the non-whole-folder
    CacheUps you've performed since the last time you restarted WebWilly.)

A whole-folder CacheUp is performed via the CacheUp selected folder options on
the List of Bookmark Folders window's menus, and the CacheUp entire folder
option on the File menu of a folder window. The resulting files are stored in
the WebWilly FLDCACHE subdirectory and are never deleted until the next time
you CacheUp the same folder, or tell WebWilly to delete the folder. The name of
each folder's most recent CacheUp's main result page is stored in the folder
directory's extended attributes, so the program knows how to let you view the
whole-folder CacheUp's results at any time, just like a Page Mining Agent, via
the option on the File menus of the folder window and the List of Bookmark
Folders window. A folder which has whole-folder CacheUp results ready to be
viewed (unless you've deleted the files yourself) has a (c) beside its name in
the List of Bookmark Folders window.

To make WebWilly run a whole-folder CacheUp, from the command line or from a
batch file or an alarm program, without any prompts, and then exit
automatically when it's done (without sending the results to the web browser,
since it's assumed that if you're doing this via a batch method then you're
probably not sitting at the computer to view the results), use /IC or /CI (for
Invoke Cacheup) as a command line parameter, followed by the full pathname
specification of the directory which represents the folder (as in
C:\WEBWILLY\BOOKS\INNOVAL). When it's done, WebWilly will return with an
ERRORLEVEL code which represents the number of errors encountered in
transmission. So if you're using a batch file to do the CacheUp for you in the
middle of the night, you might have the batch file start the whole procedure
over again an hour later, if there are five or more errors, or whatever you
think is an unacceptable number that might mean the server was down the first time.

To stop a CacheUp operation in progress, select Stop from the CacheUp window's
File menu.

When you start a CacheUp operation, WebWilly starts your browser for you so
that it will hopefully be running by the time the CacheUp is complete, and you
won't have to wait for it to come up in order to see the CacheUp results. Then,
when the CacheUp operation is complete, WebWilly checks again to make sure the
browser is still running by that time. If WebWilly doesn't find that the
browser is running, it starts the browser again, and gives it the name of the
CacheUp result page that it should load. But once in a while, on very fast
CacheUp operations, if WebWilly started the browser at the beginning of the
CacheUp, the browser might not be finished coming up by the time WebWilly
checks again to make sure it's running. If it's happening at just the right
moment in time, WebWilly won't see that the browser is running, even though it
is, because its window just hasn't appeared in the OS/2 window list yet. So
WebWilly tries to start it again with the CacheUp result page as a parameter,
and that doesn't work when the browser is already running, so the browser just
loads its normal startup page (if it's configured to do so) and that's all. The
CacheUp result page will not be shown. This isn't as much of a problem as it
might seem, though. Because, remember, it can only happen on CacheUp operations
which take less time to complete than the amount of time it takes for the
browser to start up and open its window on the desktop. So if you just start
the CacheUp operation again, it will be only a moment before you have a new
copy of the results, and since the browser is already running this time, the
problem cannot occur again.


ΓòÉΓòÉΓòÉ 14. Significant Site List ΓòÉΓòÉΓòÉ

The Significant Site List window, available via the Open submenu of WebWilly's
main popup menu, shows you a list of the sites you've visited in the past three
to four months, sorted (unless you've changed the sort order) according to how
many times you've accessed them. The window has columns for the site's address,
the number of times you've accessed any page on that site, and the date and
time of your most recent access. The File menu of this window has the following options:

Open site in browser
           This passes the site's name to your web browser, as if you were
           doubleclicking on an entry in a bookmark folder window.
           Doubleclicking on the entry in this window also has the same effect
           as use of this menu item.

Copy site to clipboard
           This copies the site's address to the OS/2 clipboard so that you can
           paste it elsewhere.

Refresh    window
           New information about web pages you visit while this window is open
           do not get added to this window unless you close and reopen the
           window, or simply use this menu option. It takes the new
           SIGSITES.LOG entries and adds them to the SIGSITES.TOT file, deletes
           the SIGSITES.LOG file, and rebuilds the window's contents from the
           new SIGSITES.TOT file's contents.

The first two of those options are also on each entry's right mouse button
popup menu.

The fourth page of the properties notebook contains two settings related to
this feature. The Enable the tracking of significant sites checkbox lets you
turn it off entirely. The Style radio button lets you select whether you want
WebWilly to track sites by just their domain names (such as www.innoval.com),
or by their domain names plus the first directory name (such as
www.tiac.net/innoval). If you visit a lot of sites which are directories under
an unrelated domain (for example, personal user directories on an Internet
Service Provider's user server), or if you want more detailed tracking of
separate parts of domain sites, then choose the second option. But for most
users, the first option will be sufficient, since in a majority of cases, the
site is the domain and the domain is the site, so tracking of directory names
is not necessary and would be a waste of disk space and some processing power.

Every time the web browser changes web pages, WebWilly will add an entry to the
SIGSITES.LOG file in the LOG subdirectory of your WebWilly directory,
containing the date and time, and the name of the site (according to the choice
you've made with the Style radio button). Every time you start WebWilly, the
SIGSITES.LOG file's information is tallied and transferred into the
SIGSITES.TOT file and SIGSITES.LOG is deleted. And every time you ask WebWilly
to show you the Significant Site List information, the entries that have been
added to SIGSITES.LOG since you last started WebWilly are also added to
SIGSITES.TOT and SIGSITES.LOG gets deleted again.

The only entries kept in the SIGSITES.TOT file (and therefore the Significant
Site List) are ones for sites which you've visited in the past three to four
months. Ones which are older than that are obviously not very significant to
you, so they're removed each time the entries are tallied. Any site which
hasn't been visited since any date in January, for example, will be removed on
May 1. Sites you haven't gone to since some time in August will be deleted on
December 1.

The entries which are kept tell how many pages you've ever visited with
WebWilly running. Not just how many pages in the past three to four months.
Because the only date information WebWilly keeps is the date of the most recent
visit to each site. But you can edit the SIGSITES.TOT file with any ASCII text
editor (such as OS/2's E.EXE) if you need to. For example, let's say there's a
site which you used to visit often, so it has a very high quantity for accesses
in the SIGSITES.TOT file; but nowadays you rarely go there, so you don't want
it to be at the top of your Significant Site List anymore. All you have to do
is edit the file and give the entry a lower number, which more accurately
represents the frequency with which you've been visiting that site recently. Or
delete the line from the file entirely, if you like.


ΓòÉΓòÉΓòÉ 15. Web Page Info ΓòÉΓòÉΓòÉ

If you select this feature from the Open submenu of the main WebWilly popup
menu, the Current Web Page Information window will open. Its title bar doesn't
usually say Current Web Page Information, though; it instead contains the URL
for which the information is being displayed. This window will remain open
until you close it. If you close WebWilly with this window open, then this
window will also open automatically the next time you open WebWilly.

When this window opens, and each time your web browser arrives at a new URL,
WebWilly will retrieve information from the server about the current web page
in your web browser. If you have the Details checkbox turned on, this window
will display all the information the server provides about the page and about
itself. With that checkbox turned off, this window will be much smaller, and
will say only how old the current web page is. This is a very easy way of
knowing whether the information in the web pages you visit is recent or
outdated. This part will only work for web pages being displayed by web servers
which provide a Last-Modified: header line for each page they display; most web
servers do this. The Date: header of a web page does not mean the age of the
page. It means the current date of the system clock on the computer on which
the web server software is running. So don't be confused if Web Page Info says
Date Not Published for a page for which the Details part of the window clearly
shows a Date: header. The age of the page is known only if there's a
Last-Modified: header.


ΓòÉΓòÉΓòÉ 16. URL Nicknames ΓòÉΓòÉΓòÉ

The list of WebWilly URL nicknames is accessed via the Open submenu of the main
WebWilly popup menu. You can create a nickname for a URL if you want to be able
to access that URL via the Load a new URL dialog box without typing its full
address. For example, you could assign the nickname InnoVal to
www.tiac.net/innoval, and from then on, when you type innoval in the Load a new
URL dialog, WebWilly will send the string http://www.tiac.net/innoval to your
web browser.

The options on the File menu of the nickname window are also available via the
right mouse button popup menu of each nickname entry in the window:

           Add
           Opens the dialog box which lets you create a nickname entry. You can
           also create a nickname entry from a URL in a folder window or the
           jump list window, via menu options in those windows. See also drag
           and drop.

           Change
           Opens a dialog box to let you change the settings of the selected
           nickname entry.

           Delete
           Deletes the selected nickname entry(s).

Create a Page Mining agent
           Automatically creates a new entry in the List of Page Mining Agents
           window, using the title and URL of the selected nickname entry and
           the default Page Mining Agent settings.

CacheUp selected URLs
           Runs WebWilly's CacheUp function on the selected nicknamed URLs.

Copy URL to clipboard
           Copies the selected URL to the OS/2 clipboard so you can paste it
           anywhere on your system.

Open URL in browser
           Sends the selected URL to your web browser; same as doubleclicking
           on a nickname entry in this window.


ΓòÉΓòÉΓòÉ 17. Sticky Notes ΓòÉΓòÉΓòÉ

A bookmark's sticky note can be created, reviewed, changed, or deleted via the
right mouse button popup menu or the URL pulldown menu of any folder window. A
sticky note is used to leave yourself a note containing anything you want to
remind yourself about a bookmarked URL. A bookmark which has a sticky note has
a little red pushpin sticking out of its diamond icon in the folder window.

The sticky note window contains a multi-line text entry field, a Delete button,
and spin buttons for the date. When you create a sticky note, the current date
is in the spin buttons, but you can change it to any date you want, for any
reason you might want to do so.


ΓòÉΓòÉΓòÉ 18. Edit a URL's Source File ΓòÉΓòÉΓòÉ

This feature lets you retrieve a web page's source *.HTM file to your hard
drive, edit it, and then, if you wish, uploads the modified version back to the
host server (or wherever you specify).

When you select this option from the Advanced submenu of WebWilly's main popup
menu, the Edit the Source File dialog box follows. If there's a web page in
your web browser, this dialog will already contain that URL. If that's not the
one you wanted to retrieve, change it to whatever you do want. Then you can
enter the userid and password if the page is one which is password-protected.
Next, press the Download button. WebWilly will download the web page's source
file to a temporary file in the LOG subdirectory under your WebWilly directory,
and automatically push that file into OS/2's E.EXE editor. You'll see the temp
file's name in E.EXE's title bar, so you can find that temp file if you want to
use any other editor or program to access it.

After you close E.EXE, and return to the Edit the Source File dialog, you can
use the Edit button to open E.EXE again and make another change to the file. Or
if the file's time stamp has changed (meaning you've saved changes to that file
using E.EXE or anything else), the Send button will have become enabled so you
can return the file to the host.

When you press the Send button, the Send the URL Back to the Web dialog comes
up. Here, you must fill in the correct FTP server and address (directory and
filename) for the file you're uploading, as it should appear on the host. This
may be the same address from which you downloaded it, or it may not. If you
have the authority to modify files on the server, then you probably know what
information goes here. If you don't know it, you can find it out from the
service which is providing you with the web site. Also, note that the userid
and password which go here are for that FTP site, not the ones for the web page itself.

After the file has been sent, and the Edit the Source File dialog is in the
foreground again, you can edit the file again if you've thought of another
change you need to make to it. Or you can change the name of the file to be
downloaded, and download a second one. Don't do that until you're done with the
first one, because the first temp file will be deleted before the second one is
retrieved. Or you can Exit this dialog, which will also delete the temp file.

If you have no desire to ever use this feature, you may delete the URLEDIT.DLL
file from your WebWilly directory if you like.


ΓòÉΓòÉΓòÉ 19. Drag and Drop ΓòÉΓòÉΓòÉ

WebWilly does take advantage of OS/2's drag and drop capabilities. The easiest
way to create a Page Mining Agent, for example, is to drag a URL from the
nickname window, the jump list window, a monthly archive log window, or a
bookmark folder window, and drop it on the List of Page Mining Agents window.
This automatically creates an agent with the same name as the URL's title,
containing just that one URL, with all the default Page Mining Agent settings.
You can also drag a URL from any of those four locations and drop it on the
URLs for: window, to add a URL to an existing Page Mining Agent.

You can drag a URL from one bookmark folder to another, to move it; or from the
jump list window or a monthly archive log window to a folder window, to create
a bookmark; or from any of those locations to the nickname window, to create a
nickname entry.


ΓòÉΓòÉΓòÉ 20. Frequently Asked Questions ΓòÉΓòÉΓòÉ

Q. I have used a Page Mining Agent set for 2 levels of links and a limit of 200
files. There are only 53 files in the directory, so I didn't get near the
limit, yet I have a level 1 page which is pointing to all the links on the web
instead of to links on my hard drive. Why?

A. The same page is probably also pointed to by a link on an earlier level 1
page. That means it was a level 2 page the first time WebWilly saw it, so
WebWilly wasn't supposed to retrieve its links. Then, the second time WebWilly
saw that page, it knew that it already had that page, and therefore didn't
process it again.

Q. I'd like to have a Page Mining Agent that would retrieve only certain ones
of the links on the main page, instead of all of them. Is there anything I can
do to make WebWilly give me this result?

A. Create a bookmark folder containing bookmarks of just the main page and the
links you want, and do a whole-folder CacheUp of that folder whenever you'd
like to have those pages "mined".

Q. A Page Mining Agent which is set to "mine" (for example) www.innoval.com/
retrieves that page once, but then also retrieves it again later, in response
to a link which points to www.innoval.com/index.htm or just /index.htm. I
thought Page Mining Agents were not supposed to waste time retrieving the same
page twice.

A. That's usually correct, but in this case, WebWilly does not see the string
www.innoval.com/ as being identical to the string www.innoval.com/index.htm.
They're not the same at all. On a server which is set to see a directory's
default page as whichever one is named index.htm, the two URLs happen to
represent the same page; but since a directory's default page does not have to
be index.htm, WebWilly cannot make the assumption that host/index.htm is the
same as host/. But if you know that this assumption would be correct for a
particular case, then you can set the Page Mining Agent to "mine"
host/index.htm instead of just host/, and then any links in the pages which
point to /index.htm will be recognized as having been already retrieved, and
will not be retrieved again. However, then you can end up with the opposite
problem: If the webmaster of the site has inconsistently made some links point
to /index.htm and others just point to host/, then WebWilly will recognize the
former as matches, but not the latter, and will retrieve the page again in
response to links that point to the latter.

Another situation in which the same symptom can occur, is when the two links
are very far apart, in relation to the order in which WebWilly is retrieving
them. WebWilly holds a list, in memory, of the addresses of the URLs it has
already retrieved, and uses this list in order to decide whether or not to
retrieve each new page. In order to avoid using a ridiculous amount of memory
for this purpose, the list has a limit of about one hundred entries. Old
entries fall off the list as new ones are added. So a page that was retrieved
ninety-five URLs ago, will not be retrieved again; but a page that was
retrieved over a hundred URLs ago, will be, because the list does not show that
a URL that old was already retrieved, so WebWilly thinks it's retreiving the
page for the first time.

Q. When I use the Stop option, or close the List of Page Mining Agents window,
to break out of a Page Mining operation before it has completed, all the pages
that have been downloaded so far are worthless. Because WebWilly doesn't finish
processing the main page to change all the links from their original pointers
to point to the pages that have been "mined". If a Page Mining operation ends
up taking longer than I had intended, I have to either let it go to completion
anyway, or break out and lower the limits/levels and start over from the
beginning! Is that fair?

A. We'll admit that was not the best way it could have been designed, but we're
stuck with it now. However, there is another alternative: What you can do to
stop a Page Mining operating without breaking out of it, is hang up your modem!
After sixty seconds, the Page Mining Agent will time out on all the pages it's
currently waiting for. Then, it will quickly fail all further connection
attempts, and complete its processing gracefully.

Q. Why does the toolbar window move by dragging the left mouse button instead
of the right one like most OS/2 windows?

A. We couldn't get right mouse button clicking on the Switch to [web browser]
button, for the Browser-Toggle feature, to work until we took the
toolbar-moving ability away from the right mouse button. This left only the
left mouse button with that ability.

Q. How do I get my custom IBM WebExplorer animation to work with WebWilly?

A. When you have WebWilly start the WebExplorer by telling the former to send a
certain URL address to the latter, then when WebExplorer comes up, WebWilly
will attempt to prevent the WebExplorer from completing the loading of its
"home document", so that it can more quickly send the WebExplorer the desired
URL. This is normally a good thing, but when your "home document" exists for
the purpose of loading an animation, cutting it off before completion means it
doesn't get to do its job at all. So the WebExplorer animations, sadly, only
work if you start WebExplorer without having WebWilly tell it right away to go
to a specific URL. (That is, by having WebWilly start WebExplorer upon startup
of WebWilly (see properties); by using the seventh WebWilly toolbar button; or
by starting the WebExplorer manually from outside WebWilly.) Then the animation
will work fine, if you specify the animation's *.HTM file correctly. In either
WebWilly's WebExplorer startup parameters setting or in WebExplorer's
Configure/Servers/Home document URL setting (with Load at startup? enabled),
you specify the animation's *.HTM file as file:///d:\dirname\filename.htm. The
file:/// prefix is what will enable the WebExplorer to find the animation's
*.GIF files in the same directory in which you've told it to look for that
*.HTM file.

Q. When I visit two pages in a row which have identical titles, the second one
does not get entered into my jump list and monthly archive log files, nor does
the Web Page Info window get updated! What's going on?

A. If the contents of the browser's title bar don't change, then WebWilly has
no way of knowing that the browser's current URL has changed. Of all the
methods WebWilly could use to determine when your browser has reached a new
URL, the one we chose, watching the title bar, is by far the most reliable, but
it does have this one problem, and we could not find any way around it that
doesn't have an even worse drawback. Luckily, most webmasters give a different
title to each page on their site.

The same symptom can also happen if you're viewing different pages in one frame
of a page which uses frames. Because again, the web browser's title bar and URL
don't change in that situation, since the parent page, which contains the
frames, doesn't change. In order to make the page which is being viewed in a
frame within another page, become the main page being viewed by the Netscape
Navigator, all you have to do is drag the page from the frame, and drop it on
the big N icon, at the right end of Navigator's URL entry field. Then the web
browser's title bar and URL will change to that of the page which had been
within the other page's frame, which is now the only page visible in the web
browser, so that WebWilly will see it.

Q. Each time I start my browser manually and type a URL into it, I get a jump
list entry with the title Welcome to Netscape Netcenter (which happens to be
the title of the home page that comes up when I start Netscape's Navigator) and
the URL that I'm trying to visit; a second later, WebWilly makes a second jump
list entry for the same URL, with the correct title this time.

A. This is one of several inconveniences that will be suffered by the WebWilly
user who leaves his browser configured to start up with a home page. But you
can easily turn off that browser feature, and instead use WebWilly to make your
browser start with the desired URL. The option is found on the Options or
Preferences menu of most browser versions.


ΓòÉΓòÉΓòÉ 21. *.CMD REXX Utilities ΓòÉΓòÉΓòÉ

ASC2BKMK.CMD creates WebWilly bookmarks from an ASCII text file in the same
format as that created by BKMK2ASC.CMD: One web page on each line; first the
title, a Tab character, the URL address, a Tab character, and optionally the
date (as in 1997/09/23), a Tab, and the time (as in 01:23pm). If you omit the
date and time, the current readings of the computer's clock will be used. Blank
lines, and lines which start with /* (like a comment in a REXX program), are
ignored. The ASCII text file must be named BOOKMARK.ASC and it must be in the
current directory. ASC2BKMK.CMD will ask you whether you want to create
WebWilly for OS/2 bookmarks or WebWilly for Windows bookmarks, and it will ask
you where you want to create the resulting bookmark folders. The answer to the
latter question should probably be d:\WEBWILLY\BOOKS on the drive where you
have the target program installed. If it's a directory which already exists and
is a bookmark folder, the existing folder's title will be changed to the new
title you specify. If you don't want that to happen, then specify the title as
it already exists. If the directory you specify is not a subdirectory somewhere
under the program's BOOKS subdirectory, you will have to create an entry in the
FLDINDEX.NIX file so that the program will know that it's supposed to treat the
directory as a bookmark folder. The FLDINDEX.NIX entry can be created using any
text editor, or by the List of Bookmark Folders window's Create a new folder
option. The format of the BOOKMARK.ASC file is documented at the end of the
ASC2BKMK.CMD file.

BKMK2ASC.CMD exports the data in a folder of bookmarks, or all of your bookmark
folders at once, to an ASCII text file. Specify the full pathname to a single
bookmark folder (as in C:\WEBWILLY\BOOKS\INNOVAL) as a command line parameter.
Or, to do all your folders at once, you must execute the command from the BOOKS
subdirectory or your WebWilly directory, with no command line parameters.
Either way, the program will send all the information it produces, to a file
named BOOKMARK.ASC in the current directory. Each folder worth of bookmarks
will be preceded, in that file, by a header which tells the title and directory
of the folder whence the bookmarks came. This program can export both WebWilly
for OS/2 bookmarks and WebWilly for Windows ones. If the source directory name
contains the string \BOOKS, then BKMK2ASC.CMD will look in the parent of that
directory for certain files which will tell it whether the source is a WebWilly
for OS/2 installation or a WebWilly for Windows one. If the source directory
name does not contain that string or the parent directory doesn't contain the
files it's looking for, then BKMK2ASC.CMD will have to ask you which format it
should expect the bookmarks to be in.

BOOKMARK.CMD lets you create a WebWilly for OS/2 bookmark in the current
directory, from the command line. The parameters you must give it are the title
of the web page, in quotation marks; the URL address, in quotation marks,
without the http:// at the front; the date you want assigned to the bookmark,
ten characters long, as in 1997/09/23; and the time you want assigned to the
bookmark, seven characters long, as in 01:23pm. Or, if you omit the date and/or
time, the current readings of the computer's clock will be used.

COPYURL.CMD copies *.URL (bookmark) files from one folder to another, from the
command line. (It doesn't do anything that WebWilly doesn't do just as well or
better, but some people want to be able to do it from the command line instead
of from within the program.) Not only does it handle the problems which the
COPY and XCOPY commands can't (for example, COPY can't copy zero-byte files,
which all WebWilly *.URL files are; and XCOPY overwrites the target directory's
extended attributes with the source directory's, which gives the target folder
the source folder's title), but it also automatically renames files while
copying them, if necessary to avoid overwriting another *.URL file in the
target directory that has the same name as one of the files you're copying.

COPYURL.CMD takes three command line parameters. The first is required, and
it's the specification of the file(s) you want to copy. If the parameter you
type is a directory name, the program will automatically attach \*.URL to the
end of it. If not, then the program will attach .URL to the end, if it's not
already there. Which means that if you want to copy all the bookmarks you made
on December 29, 1996, from the current directory, you can type either 6CT*.URL
or just 6CT* for short.

The second parameter is the name of the directory to which you want the files
copied, specified in the same way you would specify it in a COPY command. If
you don't specify any target directory, the files will be copied to the current
directory. The target directory must be an existing WebWilly folder.

And the third parameter is the /M switch, to be used when you want the files to
be moved rather than just copied.

SHOWBKMK.CMD lets you see the contents of a *.URL (bookmark) file, from the
command line. Since the information in a bookmark file is in the file's
extended attributes, instead of in the file itself, something like OS/2's TYPE
command can't do it. This program takes one command line parameter, which is
the name of the *.URL file whose contents you want to know.

URLOBJCT.CMD creates WebWilly for OS/2 bookmarks from OS/2 WorkPlace Shell URL
objects. Those are the objects created when you drag from a blank spot of a web
page in the IBM WebExplorer and drop it onto your Desktop; or the hundreds of
Web Sites objects in your Connections folder if you've installed OS/2 Warp 4.

This program takes two parameters. The first is the complete pathname of the
directory which contains the URL objects you want bookmarked. The second is the
WebWilly folder into which you want the new bookmarks placed. If your current
directory is not WebWilly's BOOKS subdirectory, then this folder must be
specified as a pathname such as C:\WEBWILLY\BOOKS\INNOVAL, and that directory
must already exist and must be a WebWilly folder. If you execute this program
from the BOOKS subdirectory, on the other hand, then you can specify the
subdirectory name or even the folder title of an existing folder in that
subdirectory, or the name of a subdirectory in which to create a new WebWilly
folder (in which case the program will prompt you for a title to be given to
the new folder).


ΓòÉΓòÉΓòÉ 22. Product Support ΓòÉΓòÉΓòÉ

If you have any trouble with this product, please use one of the following
methods to contact us:

o   Send us an email, addressed to [e-mail]. Please include the
    product serial number, your phone number, your time zone and the best time
    to call you if we should need to, and a detailed description of the
    problem. Also, please provide information about your system's configuration.

o   Send us a fax at [phone]. You can eliminate the cover sheet. Please
    write WebWilly Service in large letters across the top, and provide the
    information requested in the prior paragraph.

Watch for announcements of updated versions on our web page. The URL is http://www.webwilly.com.

If you have any suggestions for improving the product, please let us know your
ideas. The best way to do that is to send us an email at [e-mail].


ΓòÉΓòÉΓòÉ 23. Acknowledgements ΓòÉΓòÉΓòÉ

IBM, OS/2, and WebExplorer are registered trademarks of the IBM Corporation.
Netscape and Navigator are registered trademarks of Netscape Communications
Corporation. WebWilly and NetExtra are trademarks of InnoVal Systems Solutions,
Inc. All other brands, both cited and not cited, are trademarks, registered
trademarks, or service marks of their respective