This announces the latest version of WSGopher, 1.0.  You'll find the
self extracting archive file 'wsg-10.exe' on the boombox.micro.umn.edu
and sunsite.unc.edu in the United States, it may wander farther than
that, I'm sure.

** Please note: WSGopher is copyrighted software.  You may freely use
the binary, and you may freely distribute the file wsg-10.exe.
However, you may not distribute for profit the WSGopher executable or
the file wsg-10.exe without permission for EG&G Idaho, Inc, my
employer.  If you wish to do this, or if you wish to obtain a
non-exclusive source license, please contact Steve Borror, email
swb@inel.gov, phone (208) 526-3883, or mail me at gopher@tis.inel.gov.

The file wsg-10.exe is a self extracting archive.  To deal with it,
first be sure to exit WSGopher if it is running on your system.  Bad
things happen when you overwrite a running program.  Then, go to some
directory on your system (perhaps your existing WSGopher directory) and
execute wsg-10 from the DOS command line.  You should definitely
replace the existing wsgopher.exe (if any).  Whether you replace the
rest is up to you, but I'd advise you to replace the *.txt files. 

If you try to run wsg-10 from the Program Manager, you will probably
get errors, and it certainly won't work.

-- Important additions since the last public release (0.9g):

*  WSGopher now supports Gopher+.  You will find the dialogs that
control the various Gopher+ resources, like views and viewers, under
the Configure/Extended Views menu.  You should find the default
settings convenient enough to use as is.

WSGopher will automatically pick a view for you according to it's rank,
or allow you to select; this is controlled in Configure/User Options. 

WSGopher will attempt to download all the relevant Gopher+ info for a
Gopher+ directory.  Also, if you select a Gopher+ bookmark, and the view
information has not yet been retrieved, WSGopher will automatically go
get it.

WSGopher also supports the interactive forms known as "Ask blocks".
The forms are created in a scrolling window.  All the Ask operations
are supported; if WSGopher detects spurious lines in the form
definition, it will show them to you before proceeding.  Some of the
Gopher servers I tested the forms against seemed content, and some
didn't; I'm hoping to find out soon what I may have done wrong, if
anything, and fix whatever needs fixing.

*  WSGopher supports print preview and printer fonts.  You can print or
preview from the directory, text and phone book windows.  You can
select whether to print using the font you see on the screen, or a
printer specific font.  All fonts are scaled to the printer.

You can also print a range of pages, or a single page; by default,
WSGopher will print all pages.

*  WSGopher supports text search within a directory, text or phone
window using the "standard" Windows 'Find' dialog.  You can search
backwards or forwards, and look for exact case or ignore case.
WSGopher 'marks' the spot where the text is found, so that the next
search knows where to start.  Text search and 'search again' are in the
Edit menu and on the Toolbar.

When you search in a directory, if the text is found then the directory
item is selected; you can then fetch this item if you wish.

*  Changes to the Bookmark Editor include:

   It is now non-modal, meaning you can interact with other windows
   while the editor is up.  (Some consider this to be a bug fix :-)
   And, thanks to some help from JT Anderson, you can minimize the
   bookmark editor (which beats scooting it out of the way)

   It supports multiple sets of bookmarks, called "categories".  You
   can create, delete and rename categories via the category dialog;
   look in the Bookmarks menu.  You can even do this when the Bookmark
   Editor is up; you won't be able to delete a category that the editor
   is using, but you can rename a category it is using.

   Since there are now more than one category, the format of how
   bookmarks are stored has changed.  The first time you run WSGopher
   with an old WSGOPHER.INI file, it translates all your old bookmarks
   into the new format and puts them in the Default list.  It also tells
   you about this, both before and after.

   A Move button has been added to facilitate transferring bookmarks
   from one category to another.  When you move, the category dialog is
   invoked, so that you can easily break up that long Default list
   creating new categories "on the fly".

   Bookmark Titles and paths are now stored with URL style encoding.
   This will mostly affect bookmarks with binary characters or trailing
   blanks in the path, or possibly special servers that let you hop over
   firewalls.  Also, titles with multiple languages are now more likely
   to be stored properly.

   You can select multiple items in the bookmark list.  This means that
   you can Move, Delete and copy to the clipboard more than one
   bookmark at a time.  You can still only fetch one bookmark at a
   time; don't be too surprised when that changes.

   The Modify and Add buttons have been removed from the Bookmark Editor.
   Now, when you change something in the editor, it is really changed,
   and you don't have to tell it explicitly.  Add was removed because
   there is already a mechanism for safely adding bookmarks, and no one
   seemed to use it.

   You can now type the first letter of a bookmark, then use page up,
   page down, and arrow keys as expected.

*  The Phone book window is now resizable and you can select a font for
it.  In addition, the list that contains the search results now supports
extended selection.  This means you can select more than one line; if
you do, then this selected set of lines will be the lines copied to the
Clipboard if you copy, or printed/previewd if you do that.  The lines do
not have to be next to each other. 

*  The "New Gopher" dialog now accepts Gopher URLs.  You can copy a URL
to the Windows clipboard, and when the dialog comes up, it will process
the URL just like it processes "standard" bookmark formats.  You can
also type or paste a URL into the dialog.

*  WSGopher will strip trailing dots from hostnames, for those users
having difficulty with their WinSock stack.  This is configurable.
Personally, I feel that stacks that do not support trailing dots do not
support the standards as they are often interpreted; however, several
users asked me to do this, and the point really is to support the
users, not a standard.

*  Both telnet and 3270 emulation is supported.  In addition, WSGopher
takes the experimental and radical step of supporting Gopher+
specification of terminal emulation.  This way, Gopher servers can
advertise new and exciting types of emulation without requiring that
new Gopher types be added to the core protocol.

WSGopher will search through the extended views and collect all the
terminal and telnet views in a droplist.  You can select emulation
programs ("viewers" as some call them) for the extended views, as well
as telnet and 3270.

WSGopher now supports host name and (optional) port numbers via command
line substitution; this means you can easily make a correct command line
for your favorite telnet program, and WSGopher will put in the host and
port values at the right time.  There are "Host" and "Port" buttons in
the telnet setup dialog to facilitate this. 

If you do not fix up your telnet command lines, WSGopher will use the
old style invocation of "telnet.exe host port".

*  The bitmaps and icons have been extensively revised, thanks to Ken
Blackney of Drexel University.  Also, thanks to the University of
Minnesota for their permission to use the "Happy Gopher" in the program
icon.

*  Saving individual bookmarks in directories is back!  Internet users
never saw this, unfortunately, as it disappeared in a change I made just
before the first 'outside' release.

*  You can get the 'root' of a bookmark now.  This should be
particularly useful in Veronica searches.  It works for any active
window, not just directory items.

*  The vast majority of times you need to enter a path name, you can
now use a browser button.

*  The File Transfer box now can optionally figure out the filename on
its own, without bugging the user; also, it can be set to automatically
"view when done".  Check out Configure/User Options.  Thanks to Paul
Jones, Jim Gogan and Scott Barker for making me "see the light"!

*  Cleaned up the appearance of the Information dialog; the text inside
is cleaner, and you can see Gopher+ information such as views,
administrative info, abstract, etc.  Just use the Escape key to remove
the dialog, as with most Windows dialogs.  You can also minimize this
window.

The dialog also shows the URL, and a line of text that says what the
item type is in English (for those of us who don't memorize obscure
codes :-).

Also added one cool feature: not only does the info window track
individual bookmarks in a directory, but any time a window is activated
via the keyboard or mouse, it's bookmark is shown in the info window
(if it is up).

*  Changed lookup of files from current/installed/windows to
current/windows/installed/path (that is, the path environment
variable).  This was suggested by a user who administers a Novell
network, and it made quite a bit of sense.  Thanks!

-- Bug fixes since 0.9g:

*  Directory parsing is improved to the point where WSGopher can now
detect and handle incomplete bookmarks; I found one Veronica server
which was sending back an incomplete bookmark when very busy.

*  Fixed bug in text window, where once you've scrolled to the bottom,
the window persistently tried to paint lines from the proper location
through the bottom.  This made for real slow updates.

Also fixed an annoying bug where text copied to disk had too many
carriage returns.  Thanks to the several individuals who pointed this
out, including Mark Edwards and Giorgio Bernardi.

*  Fixed a problem that the Trumpet monitor, TCPMan, turned up; I was
closing sockets incorrectly.  This may also cure a problem seen with
PC/TCP where you could run out of buffer space (according to the error
message, at any rate).  Thanks to Peter Tattam for his help in solving
this. 

*  The Home Gopher dialog now works correctly.  Host names that you
delete stay gone; also, host names are filtered as per RFC 810 rules,
except that I don't try to count the subparts or look for consecutive
periods.

*  Fixed a bug that sometimes causes a GPF when downloading Gopher+
binary files in 0.9g.  Also, the same bug caused binary files to be
corrupted.  This is only true of Gopher+ files.

*  Fixed a bug where WSGopher couldn't find its INI file if the file,
and the working directory, were at the root.  Thanks to Dr. Patrick
Pollet for reporting this.

*  The lines in the directory window are now the right height when you
change the font.  Thanks to Ken Blackney (again!).

*  Fixed the annoying tendency of File Download box to overwrite
existing files without warning.  Also no longer displays the "Read
only" button.

*  Removed scruffy stuff from bookmark information display.

*  The help file path could be lost when using a File dialog.  Thanks
to Chris Sacksteder for pointing this out.

-- Vendor Info

Known to work with:
*  SuperTCP (DLL and VxD beta)
*  Distinct (Lan and PPP).
*  PC/TCP; be sure to use version 1.10 of the DLL, NOT version 1.1
*  Trumpet

It's been reported to me that the following vendor stacks work:

*  Netmanage 3.12 and 4.0; some users have difficulty with 3.11 and previous
*  Windows for Workgroups (I'd love to hear how you set it up!)
*  I have one report that the new Microsoft VxD beta works with Windows
   for Workgroups
*  Lanera
*  Persoft
*  Wollongong, PATHWAY RUNTIME version 2.0
*  PC-NFS, IF you make sure you have the following patches:

    Go to ftp.york.ac.uk:/pub/pc/pc-nfs/Patches
    get     winsock.dll 24576 25/10/93
            wshelper.exe 51232 25/10/93
Thanks to Geoff Smethurst <cca12@cc.keele.ac.uk> for this information.

*  Novell Lan Workplace 4.1; the following is from Mark Shapiro of Novell:

    Things to check.  They should have downloaded LWP168.EXE from NetWire or
    ftp'd to sjf-lwp.novell.com for tcpip.exe, wlibsock.dll, winsock.dll and
    novasync.exe in the directory ftpguest/lwp4dos/WinSock.  These files 
    should be copied to the LAN WorkPlace bin directory, default is \net\bin.
    The lwpcon.* and snmp.exe files should also be copied there if they're
    running the LAN WorkPlace apps.  

The following stacks are believed NOT to work:

Windows NT (there is some problem with NT that may or may not be stack related)

-- Important notes:

*  Occasionally I hear from users who are trying to run WSGopher with
the WSGOPHER.INI file with the "read only" attribute, or perhaps in a
read-only directory.  This is absolutely impossible; it will not work.

*  The files "extviews.cnf" and "language.cnf" have been added to the
WSGopher distribution.  They need to be writable, and they should be
placed wherever you decide to put WSGOPHER.INI.  That can be in the
same directory you've installed WSGopher, in your Windows directory, in
the directory where you execute WSGopher (if differnt), or somewhere on
your DOS path.

-- Thanks

I'd like to give particular thanks to the beta testers, who looked at
several intervening versions.  In addition to the folks already
mentioned, thanks to Ashok Aiyar, Alex Reijnierse, Lois Schoen, Dale
Evans and Mary Schonsberg, for working with these versions, reporting
problems and making helpful suggestions.  Thanks also to many, many
others who have written with advice and encouragement, problem reports
and questions. 

-- If you have any questions, please email gopher@tis.inel.gov.

Thanks,
Dave Brooks
