Text File

---- Cut Here and feed the following to sh ---- #!/bin/sh # This is a shell archive (shar 3.47) # made 03/26/1993 20:19 UTC by turtle@hercules # Source directory /usr/local/src/public_domain/tools/xvgopher # # existing files will NOT be overwritten unless -c is specified # # This shar contains: # length mode name # ------ ---------- ------------------------------------------ # 6152 -rw-rw-r-- README # 1084 -rw-rw-r-- COPYRIGHT # 199 -rw-rw-r-- BUGS # 169 -rw-rw-r-- TODO # 3684 -rw-r--r-- Makefile # 2170 -rw-rw-r-- xvgopher.man # 8558 -rw-r--r-- Connection.cc # 5530 -rw-rw-r-- GWAbout.cc # 498 -rw-r--r-- GWBinary.cc # 8907 -rw-rw-r-- GWBookmarks.cc # 9592 -rw-rw-r-- GWDirectory.cc # 7644 -rw-r--r-- GWDownload.cc # 5861 -rw-rw-r-- GWFile.cc # 2602 -rw-rw-r-- GWGopher.cc # 472 -rw-r--r-- GWImage.cc # 2924 -rw-r--r-- GWIndex.cc # 1679 -rw-r--r-- GWInfo.cc # 8870 -rw-rw-r-- GWList.cc # 4701 -rw-r--r-- GWPref.cc # 469 -rw-r--r-- GWSound.cc # 1331 -rw-r--r-- GWTelnet.cc # 7751 -rw-rw-r-- GWindow.cc # 8621 -rw-rw-r-- Gopher.cc # 1821 -rw-r--r-- List.cc # 5632 -rw-rw-r-- Preferences.cc # 2479 -rw-r--r-- Response.cc # 3627 -rw-r--r-- cursor.cc # 2754 -rw-rw-r-- icons.cc # 996 -rw-rw-r-- main.cc # 486 -rw-r--r-- Config.h # 1949 -rw-r--r-- Connection.h # 620 -rw-r--r-- GWAbout.h # 417 -rw-r--r-- GWBinary.h # 1124 -rw-r--r-- GWBookmarks.h # 1210 -rw-rw-r-- GWDirectory.h # 966 -rw-r--r-- GWDownload.h # 481 -rw-r--r-- GWFile.h # 646 -rw-rw-r-- GWGopher.h # 411 -rw-r--r-- GWImage.h # 503 -rw-r--r-- GWIndex.h # 569 -rw-r--r-- GWInfo.h # 1107 -rw-rw-r-- GWList.h # 860 -rw-r--r-- GWPref.h # 411 -rw-r--r-- GWSound.h # 458 -rw-r--r-- GWTelnet.h # 1931 -rw-rw-r-- GWindow.h # 1608 -rw-r--r-- Gopher.h # 771 -rw-r--r-- List.h # 1892 -rw-r--r-- Object.h # 1347 -rw-r--r-- Preferences.h # 2963 -rw-r--r-- Response.h # 1684 -rw-r--r-- String.h # 241 -rw-r--r-- cursor.h # 248 -rw-r--r-- icons.h # 2810 -rw-rw-r-- xvgopher.h # 222 -rw-r--r-- icons/bin # 222 -rw-r--r-- icons/cso # 222 -rw-r--r-- icons/dir # 222 -rw-r--r-- icons/doc # 222 -rw-r--r-- icons/dos # 222 -rw-r--r-- icons/error # 2190 -rw-r--r-- icons/gopher.icon # 2190 -rw-r--r-- icons/gopher.icon.mask # 2190 -rw-r--r-- icons/gopher1 # 2190 -rw-r--r-- icons/gopher1.mask # 2190 -rw-r--r-- icons/gopher2 # 2190 -rw-r--r-- icons/gopher2.mask # 222 -rw-r--r-- icons/idx # 222 -rw-r--r-- icons/image # 222 -rw-r--r-- icons/info # 222 -rw-r--r-- icons/info_dragging # 222 -rw-r--r-- icons/mac # 222 -rw-r--r-- icons/sound # 222 -rw-r--r-- icons/tel # 222 -rw-r--r-- icons/unknown # 222 -rw-r--r-- icons/uu # # ============= README ============== if test -f 'README' -a X"$1" != X"-c"; then echo 'x - skipping README (File already exists)' else echo 'x - extracting README (Text)' sed 's/^X//' << 'SHAR_EOF' > 'README' && README X This is a beta release of xvgopher -- an XView based gopher client. X Gopher is a distributed information browsing/retrieval system used at many universities and other institutions to make information and services available in a user friendly and consistent manner. X NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE This is a beta release! This means that I am still very actively working on xvgopher, but I got many requests to make it available ASAP. Please report any problems you find as soon as possible so that I can incorporate the fixes in the first major release. The latest release will always be available. There are two ways of accessing it: X X anonymous ftp to gopher.sdsu.edu in /pub/xvgopher X gopher to gopher.sdsu.edu: Software Distribution/UNIX/XvGopher X X HISTORY OF XVGOPHER We started out wanting something similar to TurboGopher (a Macintosh gopher client. Really nice!!) for MS-Windows. There are several good pc gopher clients available, but the ones I checked out either didn't run as a MS-Windows application, weren't public domain, or required some non- public domain networking software. (We are on an extreemly low budget...) So, we decided to write one... X Well, this would have been great, but I refused to write any MS-Windows applications on my 20 MHz 386! So, while waiting for a better PC, I decided I might as well write a prototype using XView. X I should point out that there is a pretty nice X11 gopher client available called xgopher. However, it boils down to a fancy window around something similar to the text based gopher client. (This is greatly exaggerated, of course!) We did use the gopher icon that xgopher uses. It is pretty cute (and none of us are good artists.) X The prototype I started writing turned out to be quite usable and we started using it instead of the text based client. It is not a prototype anymore; it is now a full gopher client. X I wrote all of xvgopher in C++ because that is the language I am most comfortable with. I used the Sniff C++ development system to write all the code and I used Sun's DevGuide to figure out sizes of windows and locations of buttons. I did not use DevGuide for the code generation for several reasons: 1) Not everyone has DevGuide which makes it hard to distribute the source code. 2) The C++ code generator that comes with DevGuide doesn't really do anything in an object oriented way. It would make the code horrible! (Actually, XView is not very easy to integrate in an object oriented program because of all the callbacks...) X X SYSTEM REQUIREMENTS xvgopher is written in C++. This may scare some people, but not to worry. If you do not have a C++ compiler, just get gcc 2.3.3 and libg++. xvgopher will compile with those just fine. So far it has been tested on various suns running SunOS 4.1.X and on an HP 750. The code does not use any C++ features not available in cfront 2.1. So if your C++ compiler does not support templates.... neither does ours!!! (We only just got SunPRO's C++ 3.0 compiler. Thanks for the great 15 minute license linger time, SunPRO!!!!! :-( Stuff like that doesn't work in a University environment! (ANDREW!!! GET OFF THAT SOAP BOX!!!)) xvgopher also requires that you have XView3 installed on your system. If you have Sun's Openwin 3.0, that's fine too, although you will have to have the 'Openwin Programmers' section installed. The only other requirement is that you have to have some network so you can talk to a gopher server. X X CONFIGURING Configuring xvgopher is pretty straight forward. Just edit 'xvgopher.h' and change the defines above the section that says to not edit anything below it. (Did I make you read that sentence twice?? :-)) Then edit the Makefile and change the macros to your liking. X X COMPILING & LINKING Type 'make depend' Type 'make' X X INSTALLING type 'make install' It will install the xvgopher executable and the man page. X X USER CONFIGURATION The first time xvgopher is run by a user, it creates ~/.xvgopher-defaults. This file contains all the currently configurable items. The easiest is to change those parameters using the Preferences popup, but they can also be edited by hand. Xvgopher uses the X11 resource database routines to read the items, so the format of the file should be familiar. When bookmarks are created, a file called ~/.xvgopher-bm will be created which contains a list of bookmarks. The bookmarks are stored in the same way they information was sent from a gopher server to xvgopher. If you are not familiar with the gopher protocol, don't worry about it. If you ARE familiar with the gopher protocol, don't worry about it too much. X CREDITS (These really should be slowly scrolling by while appropriate music is playing, but you have to wait for version 427 for that feature...) Thanks to all the people who have done testing and given me feedback on the design and implementation of xvgopher. Here are some names: X Mark Boyns (SDSU) -- testing & UI layout & icons John Denune (SDSU) -- testing Mike Halderman (NOSC) -- testing Paul Lindner (UMN) -- gopher icon X X BUGS, COMMENTS, GRIPES, MONEY, LOVE If you have any of the above directed at me, I'd like to hear about it! I would especially welcome any bug reports (and possible fixes) and also comments. I like getting email! Basically, if you like it, let me know why. If you dislike it, let me know why. If you had problems, let me know why. If you have not tried xvgopher but still have comments about it, let me know why. If you don't like me, let me know why. If you think this is getting silly, let me know why. If you are still reading this list of questions, you owe me beer!!! X X WHERE IS ANDREW?? Well, I am reachable by email at turtle@sciences.sdsu.edu X Happy gophering to y'all! C++'ya in gopherspace. X X --Andrew ____________________________________________________________________________ Andrew "Race Turtle" Scherpbier, SysMgr College of Sciences San Diego State University EMAIL: turtle@sciences.sdsu.edu VOICE: (619) 594-5026 FAX: (619) 594-6381 ____________________________________________________________________________ SHAR_EOF chmod 0664 README || echo 'restore of README failed' Wc_c="`wc -c < 'README'`" test 6152 -eq "" || echo 'README: original size 6152, current size' "" fi # ============= COPYRIGHT ============== if test -f 'COPYRIGHT' -a X"$1" != X"-c"; then echo 'x - skipping COPYRIGHT (File already exists)' else echo 'x - extracting COPYRIGHT (Text)' sed 's/^X//' << 'SHAR_EOF' > 'COPYRIGHT' && This software is Copyright 1993, San Diego State University -- College of Sciences X ------------------------------------------------------------------------ WARRANTY DISCLAIMER X This software was created by Andrew Scherpbier at San Diego State University and is distributed free of charge. It is placed in the public domain and permission is granted to anyone to use, duplicate, modify and redistribute it provided that this notice is attached and that the modified sources are sent back to San Diego State University. X San Diego State University and Andrew Scherpbier provide absolutely NO WARRANTY OF ANY KIND with respect to this software. The entire risk as to the quality and performance of this software is with the user. IN NO EVENT WILL SAN DIEGO STATE UNIVERSITY OR ANDREW SCHERPBIER BE LIABLE TO ANYONE FOR ANY DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, INCLUDING, WITHOUT LIMITATION, DAMAGES RESULTING FROM LOST DATA OR LOST PROFITS, OR FOR ANY SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES. ------------------------------------------------------------------------ SHAR_EOF chmod 0664 COPYRIGHT || echo 'restore of COPYRIGHT failed' Wc_c="`wc -c < 'COPYRIGHT'`" test 1084 -eq "" || echo 'COPYRIGHT: original size 1084, current size' "" fi # ============= BUGS ============== if test -f 'BUGS' -a X"$1" != X"-c"; then echo 'x - skipping BUGS (File already exists)' else echo 'x - extracting BUGS (Text)' sed 's/^X//' << 'SHAR_EOF' > 'BUGS' && Known bugs. X Version 1.0 (March, 1993) X 1 'Another gopher...' pops up two windows for some reason. 2 Sometimes, when double clicking on multiple items, some of the X windows will never become unbusy. SHAR_EOF chmod 0664 BUGS || echo 'restore of BUGS failed' Wc_c="`wc -c < 'BUGS'`" test 199 -eq "" || echo 'BUGS: original size 199, current size' "" fi # ============= TODO ============== if test -f 'TODO' -a X"$1" != X"-c"; then echo 'x - skipping TODO (File already exists)' else echo 'x - extracting TODO (Text)' sed 's/^X//' << 'SHAR_EOF' > 'TODO' && Things I still need to add to xvgopher. X + Timeouts for network activities X + Support for CSO phonebook searches X + More flexible configuration X + Hierarchal bookmarks X SHAR_EOF chmod 0664 TODO || echo 'restore of TODO failed' Wc_c="`wc -c < 'TODO'`" test 169 -eq "" || echo 'TODO: original size 169, current size' "" fi # ============= Makefile ============== if test -f 'Makefile' -a X"$1" != X"-c"; then echo 'x - skipping Makefile (File already exists)' else echo 'x - extracting Makefile (Text)' sed 's/^X//' << 'SHAR_EOF' > 'Makefile' && # # Makefile for xvgopher. # # (c) Copyright 1993, San Diego State University -- College of Sciences # (See the COPYRIGHT file for more Copyright information) # # This makefile will work on standard Sun4 systems running SunOS 4.1.X # and which have the Sun C++ compiler installed in /usr/lang # If your configuration differs, you will have to modify the rest of this # file. # # The directory the executable should be installed in BINDIR = /usr/local/bin X # # The directory where the man page should go MANDIR = /usr/local/man X # # The section to use for the man page. MANSECT = l X # # Compiler to use. It has been tested with Sun C++ 2.0, g++ 2.3.3, and # Sun C++ 3.0 #CCC = CC #CCC = g++ -fno-strict-prototypes -w CCC = /usr/local/lang/CC X # # Flags for the compiler. We use openwin for our X development, but # the standard x11r5/xview3 will work just fine. # CCFLAGS = -I/include -O X # # I specified the openwin libraries specifically to get around some # problems with people not mounting our x11r5 tree. Using this overrides # the LD_LIBRARY_PATH environment and makes the shared version work on # all machines with openwin3 # LDFLAGS = -g -L/usr/openwin/lib X # # The makedepend looks in the 'standard' places for system include files. # Well, Sun decided they weren't going to use the 'standard' places for # their compilers, so we have to specifiy the actual path... (Bogus!!!) # SYS_INCLUDES = -I/usr/lang/SC1.0/include/CC #SYS_INCLUDES = -I/usr/local/gnu/lib/g++-include -I/usr/local/gnu/lib/gcc-lib/sparc-sun-sunos4.1.2/2.3.3/include X # # Strangely enough xvgopher uses xview!!! # LIBS = -lxview -lolgx -lX11 X # # All the files which will end up with an object file. (Can't just say # all source files, because in C++ the headers can contain all kinds of # source as well...) # SRCS = \ X Connection.cc \ X GWAbout.cc \ X GWBinary.cc \ X GWBookmarks.cc \ X GWDirectory.cc \ X GWDownload.cc \ X GWFile.cc \ X GWGopher.cc \ X GWImage.cc \ X GWIndex.cc \ X GWInfo.cc \ X GWList.cc \ X GWPref.cc \ X GWSound.cc \ X GWTelnet.cc \ X GWindow.cc \ X Gopher.cc \ X List.cc \ X Preferences.cc \ X Response.cc \ X cursor.cc \ X icons.cc \ X main.cc X # # I am lazy. I hate typing in lists into makefiles! I think the word # replacement macro in makefiles is the best thing since sliced cheese! # OBJS = $(SRCS:%.cc=%.o) X # # The list of files to put in the shar archive # SHARFILES = \ X README \ X COPYRIGHT \ X BUGS \ X TODO \ X Makefile \ X xvgopher.man \ X \ X *.h \ X icons/* X TARGET = xvgopher X all: X : X -o X static: X -o .static -Bstatic X clean: X rm -f *.bak *.BAK X # # The installation of the program. # install: X install -s X install xvgopher.man /man/xvgopher. X # # I use makedepend. If you don't have it, get it! # depend: X makedepend -- -- X # # Create a shar file suitable for posting # shar: X shar -c -o xvgopher.shar -l55 X # # Create some tar files suitable for ftping. # tar: X gnutar czvf xvgopher.tar.z X gnutar cZvf xvgopher.tar.Z X zeus: X gnutar czvf /tmp/xvg.tar.Z *.cc *.h Makefile icons/* X rcp /tmp/xvg.tar.Z zeus: X rm /tmp/xvg.tar.Z X kiwi: X gnutar czvf /tmp/xvg.tar.Z *.cc *.h Makefile icons/* X rcp /tmp/xvg.tar.Z kiwi: X rm /tmp/xvg.tar.Z X rohan: X gnutar czvf /tmp/xvg.tar.Z *.cc *.h Makefile icons/* X rcp /tmp/xvg.tar.Z rohan: X rm /tmp/xvg.tar.Z X saturn: X gnutar czvf /tmp/xvg.tar.Z *.cc *.h Makefile icons/* X rcp /tmp/xvg.tar.Z saturn: X rm /tmp/xvg.tar.Z SHAR_EOF chmod 0644 Makefile || echo 'restore of Makefile failed' Wc_c="`wc -c < 'Makefile'`" test 3684 -eq "" || echo 'Makefile: original size 3684, current size' "" fi # ============= xvgopher.man ============== if test -f 'xvgopher.man' -a X"$1" != X"-c"; then echo 'x - skipping xvgopher.man (File already exists)' else echo 'x - extracting xvgopher.man (Text)' sed 's/^X//' << 'SHAR_EOF' > 'xvgopher.man' && .TH xvgopher l "25 March 1993" .SH NAME xvgopher \- XView gopher client program .SH SYNOPSIS xvgopher [ .I servername [ .I port# ] ] .SH DESCRIPTION .B Xvgopher is a user friendly gopher client. When started, .B xvgopher will show the root directory of the gopher server which was selected when it was compiled. The type of each item in the list is indicated my a small icon. The meaning of the icons should be pretty clear, but if you can draw better icons, send them to me!!! To activate an item, just double click on it. .LP The Gopher menu in the main window contains several useful items: .TP 8 \(bu Bookmarks... This will create a window showing your your bookmarks. .TP 8 \(bu Another Gopher... This will allow you to contact another gopher server. You can specify both the server name and the port number. .TP 8 \(bu Preferences... This will create a window which allows you to modify things like the commands to execute for certain things. .TP 8 \(bu About... This will create a window showing who created .B Xvgopher .SH OPTIONS By default, .B