README for Xarchie - X11 browser interface to Archie BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA George Ferguson, ferguson@cs.rochester.edu Last Change: 4 Jan 1993 DISCLAIMER: This is release 2.0 of xarchie -- an X browser interface to the Archie Internet information system. This software is provided as is with no warranty expressed or implied. I hope you find it useful, but I won't be held responsible for any damage that may occur from reading, compiling, installing, using, or even thinking about it. You are free to use any parts of the code that I wrote for other purposes. It would be nice if you could keep my name on some part of whatever the final product is. Parts of the code that are derived from the Prospero archie client are subject to their own copyright, which is included in "query.c" and in files that were not written by me. See the file "copyright.h" for details. Examples of other things Prospero can do are in the file "README.PROSP" in this distribution. The file "inet_ntoa.c" is copyright (c) 1983 Regents of the University of California. The code for the MultiList and FileSelector widgets (in directory FWF) was written by Brian Totty (totty@flute.cs.uiuc.edu) and is distributed by the Free Widget Foundation (contact free-widgets-request@kazoo.cs.uiuc.edu). This code is copyright 1990,1991,1992 Brian Totty. See the file FWF/COPYRIGHT for more details. CREDITS: The original standalone archie client was written by Brendan Kehoe, (brendan@cygnus.com), based on the Prospero archie client by Clifford Neuman, (bcn@isi.edu). The file "README.FILES" attempts to make some sense of the lineages. The archie service was conceived of and implemented by Alan Emtage (bajan@bunyip.com), Peter Deutsch (peterd@bunyip.com), and Bill Heelan (wheelan@cs.mcgill.ca). For more information about the Archie service, see the manpage and then write to "info@bunyip.com". INSTALLATION: See the file INSTALL for installation instructions. PROBLEMS: See the file PROBLEMS for discussion of various often-reported problems. Please read this file *before* reporting a problem. REPORTING BUGS/KUDOS: When reporting bugs, problems, suggestions or contributions, please be sure to send them to the right place. I (George Ferguson) am really only interested in the working of the X interface. Brendan Kehoe is is charge of the archie clients and much the network stuff underlying xarchie, Cliff Neuman is in charge of Prospero, and Alan Emtage and the others are in charge of the Archie service itself. The Free Widget Foundation widgets are the responability of Brian Totty. Further details are given in the manpage. HISTORY: Version 2.0 - 4 Jan 1992 * Major improvements include: - Multiple selections allowed in browser for use with other new features (FWF MultiList widget). - Ability to expand directories in browser. - Real fully-integrated ftp implementation. - Ability to save and reload query results, as well as print them. - Ability to resort results, and sort results by user-definable pseudo-weights. - Online help browser. - Color resources, done so that they don't break mono displays. - FWF FileSelector widget for local file operations. - Makefile.dist's supplied for the imake-impaired. * Fixes and reconsiderations include: - Did away with EzMenus, which I didn't exploit fully anyway and which were causing portability problems. - Did away with user-definable widget hierarchies since I doubt that anyone used them and XtNameToWidget() was a problem for many people. I still use it in a few places, but not crucially. - A fix for the crashing Text widgets, I think, and fixed the query-while-querying crash bug. - Browser code rewritten to isolate display dependencies, which allowed the development of a Curses browser client, to be released soon. * Major contributors for this version include: - Alan Emtage (bajan@bunyip.com) Amos Shapira - Donated code that was warped into the ftp implementation. - Peter J Nilsson (pjn@ida.liu.se) - Suggested the "sort by weight" feature, and donated code. - Brian Totty (totty@cs.uiuc.edu) - Allowed use of the Free Widget Foundation MultiList and FileSelector widgets, in directory FWF. * Reports of problems/wishes with 1.3, some of which made it 2.0: Jonathan I. Kamens (jik@pit-manager.MIT.EDU) Lauren Weinstein (lauren@cv.vortex.com) Larry W. Virden, x2487 (lwv27@cas.org) Stephen Malowany (malowany@cenparmi.concordia.ca) Thomas A Peterson (tap@src.honeywell.com) Joachim Schrod (schrod@iti.informatik.th-darmstadt.de) Marshal Linfoot (marshal@nexus.yorku.ca) Paul Close (pdc@lunch.wpd.sgi.com) Bill Silvert (silvert@biome.bio.dfo.ca) Michael Wojcik (woj@ll.mit.edu) Anthony J. Persechini (ajp2o@crocus.medicine.rochester.edu) G|ran Uddeborg (uddeborg@sisug.sisu.se) Jim Watt (jimw@PE-Nelson.COM) Theo Vosse (VOSSE@rulfsw.LeidenUniv.nl) David N. Blank-Edelman (dnb@meshugge.media.mit.edu) Warren R Carithers (wrc@cs.rit.edu) Mike Szloh (szloh@jupiter.cse.UTOLEDO.edu) David Meleedy (dmm@worf.harvard.edu) Jonathan Stone (jonathan@isor.vuw.ac.nz) Marc E. Fiuczynski (mef@klinzhai.rutgers.edu) Peter K. Campbell (p.campbell@trl.oz.au) Christopher T Hubbard (chubbard@ecn.purdue.edu) John Keener (keener@astro.psu.edu) Dave Brennan (brennan@hal.com) William Stephen Kish (wk0x+@andrew.cmu.edu) Kevin O'Conner (kevin@ctp.com) Tim Auckland (tda10@cus.cam.ac.uk) dockhorn@gate.fzi.de Version 1.3 - 12 Nov 1991 - Separated EzMenu widget creation from others by adding .menus resource and slightly changing initWidgets() in xarchie.c. This hopefully prevents those annoying core dumps under old or otherwise strange version of X. Also renamed the "hostText" on the Settings form to "setHostText" again in hopes of avoiding the problem. - Added archie.sura.net to hostMenu and made it the default elsewhere. - "-debug" formerly didn't want an argument -- fixed. - Made dirsend() asynchronous by restructuring it, so xarchie will now refresh and can be interrupted during queries. Added "Abort" button to interrupt queries. - Removed comments about gcc from this file and the Imakefile since it's handled automatically in dirsend.c using SUN_GNU_FIX. - From the TODO file: Fixed default-settings() action so it uses as defaults the values of the application resources when xarchie starts up. - Added confirmation of quitting and -expert flag (and expert resource) to avoid it if desired. - Tweaked resources for better layout, better resizing, etc, etc. - From: bajan@cs.mcgill.ca - Updated man page and added Bill Heelan acknowledgement. - From: khushro@zip.eecs.umich.edu - Added "save-to-file()" action. - From: Dennis Shiao - ftp.c called alert0() rather than alert1(). - From: Lee M J McLoughlin - Added archie.doc.ic.ac.uk to hostMenu - From: Amos Shapira - Added cs.huji.ac.il to hostMenu. - From: brendan@cs.widener.edu (Brendan Kehoe) - Changes to many files from the "archie" distribution, including more portable #includes and Prospero warning message handling. Includes new file perrmesg.c. - Provide udp.c to test whether UDP traffic is enabled. - From bcn@isi.edu (Clifford Neuman) - Changed dirsend.c to compare connection id's rather than hostnames, based on an observation from Lee McLoughlin, among other Prospero stuff. Version 1.2 - 12 Sep 1991 - Changed LowerCase() in types.c (from Xt manual example) to XmuCopyISOLatin1Lowered() since the former was not always compiled into X. - Added resources "ftpDir" and "ftpType" and corresponding items on the Settings panel so the ftp service is a bit better. - From: beser@aplcomm.jhuapl.edu (Nick Beser) - Fixed regex support in Imakefile. Added regex.h which is included by support.c and actions.c. - From: Greg Lindahl ) - Changed strcasecmp() in types.c to XmuCompareISOLatin1() since some systems don't have the former. - Changed two leftover instances of isspace() to ISSPACE() in xarchie.c. - From: "(Simon Leinen)" and: Alan B Clegg - Changed some widget names in resource file since the Settings form wasn't being laid out correctly. Version 1.1 - 4 Sep 1991 Released to comp.sources.x.