		    Release Notes
		       on the
		    Xgopher client

		     version 1.1a


These notes describe changes from Xgopher version 1.0 of March 1992.

History
-------

version 1.1a   03 June  1992	Fixes for release 1.1 -- details below
version 1.1    20 April 1992	Support for additional items:
                                CSO Name servers, text index, sound,
				also many enhancements.
version 1.0     5 March 1992	Original release


Bug fix release 1.1a
--------------------

The following problems are addressed in Xgopher 1.1a.  There are no
new features or function in Xgopher 1.1a over Xgopher 1.1.
Most of these fixes are for very minor problems.  The most serious
of them was the 100 character limit in the selector string.
This is the only one which would affect the usability of Xgopher.
(Another problem was reported by two hp720 users.  I cannot
otherwise reproduce it and believe it is a side-effect of this
selector string problem.)

The rest are changes and fixes inspired by feedback from other
people who have encountered any difficulty installing or using 
Xgopher.  I appreciate this feedback!  Thank you all.

. Do not fail when user string is > 100 characters (util.c)
. Some X11R4 clients don't clear text widget string - fixed (text.c)
. Added one more "malloc definition" test to (misc.c)
. Changed macro to avoid compiler warnings (conf.h)
. added port number to error messages when connection cannot be established
  (net.c, util.c).
. fixed error during starting up (e.g., connecting) failed (gui.c)
. small typographic fixes to man page.
. minor changes to README ond other text files for OpenWindows, AIX.

One outstanding problem is if your Athena widget library is compiled
with the international text feature enabled (usually it isn't in
English-speaking countries), you will experience problems compiling
Xgopher.  The text widget provided in Xgopher is a subclass of the
"original" Athena text widget.  The i18 support changes the definition
of the widget's class record, so the subclassing is done improperly.
I have not had the time to work on this.

At this release (1.1a) a new file has been added to the Xgopher
source directory: Version.  It simply contains the program name
and the version number.


Changes in 1.1
--------------

The following changes are listed in order of decreasing user-impact.
  
. 1. Support added for full text index searches.
     This includes a new text display which can highlight the
     selected keywords.  This is implemented as a subclass of the
     Athena AsciiSink widget.  Help is available for using indices.
     WAIS searches also work using this mechanism.

. 2. Support added for CSO name servers.
     All searches are supported, plus display of available fields.
     Help is available for CSO name servers.

. 3. Support added for telnet sessions.
  
. 4. Support added for sound files.  I still do not recommend
     listening across anything but a fast local network.  Someday
     this can be refined when I have better access to a workstation
     with sound.
  
. 5. Added actions.
     The action "up()" is defined for the main Xgopher panel.  The
     file Xgopher.ad defines the default translation <Key>u to implement
     the up() action when the cursor is positioned on any (sensitive)
     area of the main gopher panel.  The action is identical in function
     to the "Go up a level" button.  (The key that invokes this action
     can be changed or removed easily by the user.)

. 6. Easier installation with X11R4 libraries.
     Preprocessor symbol XGOPHER_X11R4 is used.  If this symbol
     is defined, there is better likelihood of success for R4
     libraries.
  
. 7. All known bugs fixed:
     . Empty directory bug - When trying to retrieve an empty directory,
       Xgopher 1.0 would get a segment fault on some systems (e.g., Sun).
       This has been fixed.
     . bad character in save'd file - an ascii \377 was added to the
       end of text files that were saved to a user-specified file.
     . Added missing close().
       A close() call after copying text files from the network was missing
       and has been added.
     . Previously stopped loading a directory when the first unprocessable
       file type was encountered.  Now, such files are simply bypassed.
     . Improved error reporting when the main top level directory is
       not accessible.

. 8. The default fonts in the application defaults are different.
     May people did not like the large sizes or proportionately spaced
     characters.  I have made all smaller and chosen a fixed spaced
     font for the defaults.  The old fonts are noted in the file
     in comments, and may still be preferable for demonstrations and
     public access X-terminals.

. 9. Positioning of some popups is slightly different.  The biggest
     difference is that error popups are placed with their lower
     left corner near the pointer (mouse location), so they can
     be acknowledged with minimum mouse movement.

.10. Improved documentation
     . New help file facility allows easy Xgopher help display of 
       and subject from an easy-to-edit file.
     . Significantly expanded man page.

.11. Added new resource (markRoot) which controls the automatic setting
     of a bookmark at the root directory.
  
.12. X Toolkit work procs are used to create secondary panels.  This
     provides significantly faster startup for the initial Xgopher display.

.13. Prefix code improved.
     The code for prepending a prefix string to a directory item was
     not exceptionally clean.  It has been improved.  There is no
     behavioral difference.
  
.14. Many minor typographic errors in comments and documentation have
     been fixed.
  
.15. Added conf.h parameter to define the maximum window size.
     Most servers seem to handle 65535, but reports are that HP
     only allows 16383.  This is used for the "stopwatch" overlay
     window.

.16. Some defaults in conf.h were changed.

.17. Xgopher has been tested both compiled and executed on additional
     platforms: convex, IBM RS/6000 (under AIX 3.2), and Gateway 2000
     486/33 running Unix - BSD/386 (Beta release 0.3) from BSDI.


Acknowledgements
----------------

Thanks to all people who took the time to send me their comments,
suggestions, and problems in the versions of Xgopher 1.0.  A special
thanks to John Franks for testing 1.1 during development.
All bug reports and most of the suggestions I received have been
addressed in Xgopher 1.1.  Some of the suggestions I have not had
time to implement and they will show up in a future release.


Problems
--------

Please report and problems, suggestions, or portability problems to
the author of xgopher.  e-mail contact is preferred:

	Allan Tuchman
	Computing and Communications Services Office (CCSO)
	University of Illinois at Urbana-Champaign
	1304 W. Springfield Ave.
	Urbana, Illinois   61801

	(217) 244-0048
	a-tuchman@uiuc.edu
