home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / winsock / gophbk11 / manual.txt < prev    next >
Encoding:
Text File  |  1995-05-19  |  8.3 KB  |  254 lines
  1. Copyright (c) 1993 Kevin Gamiel,CNIDR, and UNC-Chapel Hill
  2.  
  3. Please send bugs and comments to Kevin.Gamiel@cnidr.org.
  4.  
  5. The Gopher Book 
  6. 1.1
  7. 5/23/93
  8.  
  9. Contents
  10. --------
  11. 1 Introduction
  12.     What is Gopher?
  13.     What is Winsock?
  14.     What is The Gopher Book?
  15.     What is CNIDR?
  16.     What about UNC-Chapel Hill?
  17.     What's This About Copyright?
  18.     Who's Responsible?
  19.     Thank You!
  20.  
  21. 2 Installation
  22.     Requirements
  23.     Installing The Gopher Book
  24.     Troubleshooting
  25.  
  26. 3 Application Layout and Operation
  27.     The Book
  28.     File Menu
  29.     Bookmark Menu
  30.     Options Menu
  31.     Help Menu
  32.  
  33. 1 Introduction
  34. --------------
  35. What is Gopher?
  36.  
  37.     Gopher is a client-server based Internet Information Retrieval
  38.     system developed by the University of Minnesota.  The system
  39.     provides clients with a heirachical view of the Internet and
  40.     allows file retrieval and access to other services including 
  41.     WAIS, Telnet, and others.
  42.  
  43. What is Winsock?
  44.  
  45.     Windows Sockets (Winsock) is an open specification for providing
  46.     a common network Application Programming Interface (API) for
  47.     Microsoft Windows.  Historically, writing network applications
  48.     for PCs with Windows has been a daunting task because of 
  49.     various vendor-specific protocol stacks.  Major players
  50.     from industry and the Internet community joined together to
  51.     standardize the API, based on the Berkely Sockets paradigm
  52.     used on UNIX systems.  Today, the major vendors are either
  53.     already shipping or will soon ship winsock.dll with their
  54.     protocol stacks.  With this file from your favorite vendor,
  55.     any "Winsock compliant"    network application will work!
  56.     We fully support and applaud the work of the Winsockers.
  57.  
  58. What is The Gopher Book?
  59.  
  60.     The simplicity of the Gopher protocol is the reason for its
  61.     popularity on the net.  In keeping with this simplicity, The
  62.     Gopher Book is an attempt to superimpose the book paradigm,
  63.     one we are all familiar with, onto the Gopher information system.
  64.     Menus fetched from Gopher servers are presented as pages in
  65.     the book.  Each page can contain references to other pages,
  66.     text files, image files, binary files, telnet sessions, and 
  67.     others.  The user selects items from the page by double-clicking
  68.     that item and the book either turns to a new page or retrieves
  69.     the item, starting a user-defined application to 'view' that
  70.     file or service.  Bookmarks are provided to allow quick access to 
  71.     useful pages. 
  72.     
  73.  
  74. What is CNIDR?
  75.  
  76.     CNIDR, the Clearinghouse for Networked Information Discovery
  77.     and Retrieval, is supported primarily by the National Science
  78.     Foundation and the MCNC Center for Communications to promote
  79.     the use and development of NIDR systems.  Initially focused
  80.     on Wide Area Information Servers (WAIS), CNIDR broadened its
  81.     scope to include NIDR systems in general.  Gopher, World Wide
  82.     Web, Z39.50, and Whois++ are examples of these systems.
  83.     
  84.     CNIDR
  85.     MCNC Center for Communications
  86.     Post Office Box 12889
  87.     3021 Cornwallis Road
  88.     Research Triangle Park
  89.     North Carolina 27709-2889
  90.     919-248-1499
  91.     fax 919-248-1405
  92.     e-mail info@cnidr.org
  93.  
  94. What about UNC-Chapel Hill?
  95.  
  96.     An early implementor of the WAIS protocol, UNC's Office of
  97.     Information Technology Development Group has actively supported
  98.     the use and growth of various Internet information services
  99.     including Gopher.  The group has now gained global popularity
  100.     though a cooperative project with Sun Microsystems called 
  101.     sunSITE.  SunSITE is an international information depository
  102.     currently consisting of software for all platforms, academic
  103.     journals, Smithsonian photo archives, and much more.  The site
  104.     was recently chosen as an official electronic information 
  105.     repository for the White House!  SunSITE superscedes 
  106.     traditional archives by providing WAIS and Gopher access, as
  107.     well as ftp.
  108.     Point your Gopher to sunsite.unc.edu, port 70 and have fun!
  109.  
  110. What's This About Copyright?
  111.  
  112.     This software can be used freely and redistributed in its 
  113.     entirety.  No portion of this software can, without the 
  114.     permission of the author, be sold for any reason.  This
  115.     software is provided as-is and the copyright owners bear
  116.     absolutely no responsibility as to the operation of this
  117.     software.
  118.  
  119. Who's Responsible?
  120.  
  121.     Kevin Gamiel
  122.     CNIDR 919-248-1499
  123.     UNC-Chapel Hill 919-962-9107
  124.     Kevin.Gamiel@cnidr.org
  125.  
  126. Thank You!
  127.  
  128.     This application wouldn't be possible without the contributions
  129.     of the following folks:
  130.     
  131.     University of Minnesota
  132.     Netmanage, Inc.
  133.     Lanera, Inc.
  134.     Microsoft, Inc.
  135.     The Winsock crew
  136.  
  137. 2 Installation
  138. --------------
  139. Requirements
  140.     
  141.     - Microsoft Windows 3.x
  142.  
  143.     - Wingding fonts!  If this font isn't installed in Windows,
  144.         the user will not see descriptive icons beside Gopher
  145.         page items, rather a senseless, but consistant,character.
  146.  
  147.     - Windows Sockets (Winsock) TCP/IP protocol stack 1.1 or later
  148.  
  149. Installing The Gopher Book
  150.  
  151.     1)  Copy GOPHBOOK.ZIP to an appropriate directory
  152.     2)  Execute PKUNZIP.EXE -d GOPHBOOK.ZIP.  A subdirectory named
  153.         GOPHBOOK will be created containing the files indicated
  154.         in GOPHBOOK.TXT
  155.     3)  From the Windows Program Manager, select 'File', 'New'.
  156.     4)  Select 'Group Item' and create a group named "Gopher Book 1.1"
  157.     5)  Again select 'File', 'New'.
  158.     6)  Select 'Program Item' and enter the following information:
  159.         Description:  The Gopher Book 1.0
  160.         Command Line: <path>\GOPHBOOK\TBOOK.EXE GOPHER11.TBK
  161.         Working Dir: <path>\GOPHBOOK
  162.         Shortcut: None
  163.     7)  Double click on the icon and start Gophering!
  164.  
  165. Troubleshooting
  166.     
  167.     Q)  I get the message "Failed to Initialize Winsock!" when I start?
  168.     A)  You don't have a Winsock compliant TCP/IP stack, the stack
  169.         is not installed properly, or is less than version 1.1.
  170.         This application is useless without Winsock installed 
  171.         and therefore it exits when not properly installed.
  172.  
  173.     Q)  When I retrieve a text or image file, I get a "no such file" error message?
  174.     A)  Enter the full file specifications for the text or image viewer
  175.         in the Options/Configure dialog box. For example, "c:\windows\notepad.exe".
  176.  
  177.     Q)  What is in the GOPHBOOK.INI file?
  178.     A)  This file contains configuration information for The Gopher
  179.         Book.  You can add your own by hand but BE CAREFUL!  
  180.         This should be done before starting the    application 
  181.         because this file is only read at that time.  The 
  182.         syntax is:
  183.  
  184.         <hostname>    
  185.         <port>        
  186.         <text editor>    
  187.         <image viewer>     
  188.         <telnet app>    
  189.  
  190.         For example:
  191.  
  192.         gopher.micro.umn.edu
  193.         70
  194.         c:\windows\notepad.exe
  195.         c:\bin\ps.exe
  196.         c:\netmanag\telnet.exe
  197.  
  198.     Q)  What is in the BOOKMARK.INI file?
  199.     A)  This file contains all pertinant information needed to maintain
  200.         Gopher objects, ie bookmarks.  You can add your own by hand
  201.         but BE CAREFUL!  This should be done before starting the
  202.         application because this file is only read at that time.
  203.         The syntax is:
  204.  
  205.         <type>,<name>,<selector>,<host>,<port>
  206.  
  207.         For example:
  208.         1,Sunsite.unc.edu,,sunsite.unc.edu,70
  209.  
  210. 3 Application Layout and Operation
  211. ----------------------------------
  212. The Book
  213.     When the book is closed, a double mouse click anywhere on the cover
  214.     begins the Gopher session.  At this point, the books attempts
  215.     to retrieve the Gopher menu from the server indicated in the
  216.     Options:Configure dialog box.  Assuming no errors, the book
  217.     then opens.  The right page of the book contains a text description
  218.     of the current Gopher page and a list box containing the items
  219.     on that page.  The left page contains only an icon of a book flipping
  220.     its pages.  By double-clicking anywhere on the left page the user can
  221.     traverse through previously visited pages.
  222.  
  223. File Menu
  224.     Exit
  225.     Restart Gopher
  226.         This menu item is useful if you change your default Gopher
  227.         server via the configuration menu or if you just want to
  228.         start over again in a familiar place.
  229.  
  230. Bookmark Menu
  231.     Go to
  232.         Displays a dialog box containing the current bookmarks.
  233.         The user then selects a bookmarked page to turn to.
  234.     Place
  235.         Choosing this menu will set a bookmark on the current
  236.         page.
  237.     Remove
  238.         Displays a dialog box containing the current bookmarks.
  239.         The user can then select 1 or more bookmarks to delete
  240.         from the list.
  241.  
  242. Options Menu
  243.     Configure
  244.         Dialog box indicating the root Gopher server and port as
  245.         well as user-defined viewers for the various file types.
  246.     View This Item
  247.         Displays the Gopherese for the selected item.
  248.  
  249. Help Menu
  250.     Index
  251.         Starts the default text editor with manual.txt
  252.     About
  253.         Who, what, when, where...
  254.