Provided by: gopher_3.0.13_i386 bug

NAME

       gopher - connect to gopher document server

SYNOPSIS

       gopher  [-sSbDr]  [-t  title]  [-p  path]  [-T  type]  [-i search term]
       [hostnameorurl] [port]

DESCRIPTION

       The gopher client is used to talk to gopher  servers.   Once  you  have
       started  the  gopher  client, help on using it is available by pressing
       the ?  key.

       The Internet Gopher is a distributed  document  delivery  service.   It
       allows  a  neophyte  user  to  access various types of data residing on
       multiple  hosts  in  a  seamless  fashion.   This  is  accomplished  by
       presenting  the  user  a  hierarchical  arrangement of documents and by
       using a client-server communications model.  The Internet Gopher Server
       accepts  simple queries, and responds by sending the client a document.

       The [hostname] of a gopher server  may  be  specified  at  startup;  if
       omitted,  the  default  server  for  your  site  is used.  You may also
       specify a URL (Uniform Resource Locator) for this argument.

       The  [Port_number] of the server host may be specified at  startup;  if
       omitted you will use the default port specified at your site.  The more
       or less standard and accepted Gopher port number on the Internet is 70.

OPTIONS

       -b     starts the client on the bookmark page.

       The next few options are for more advanced users who want to start at a
       location other than the default, or to set up special aliases or shell-
       scripts to point the gopher client to seperate places.

       -p path
              specify  a specific selector string to send to the gopher server
              on startup.

       -T type
              let the client know  what  type  of  object  the  -p  option  is
              pointing at.

       -i search term
              tell  the client what to search for in the object defined by the
              -p and -T 7 options.

       -t title
              set the title of the initial screen for the gopher client.

       The last few options aren’t really of interest to  regular  users,  but
       are  provided  for  system  administrators who waht to provide a secure
       client, or who need to debug a client.

       -s or -S
              "secure mode" which means that you can’t save or print the files
              that  you  browse.  -s is for users without an account, while -S
              assumes the user has an account on this machine.   One  security
              feature  is forced on, regardless of the state of these options,
              if the name of the user’s shell ends in rsh; the  ’O’  (options)
              command  is  disabled  so  the  user cannot select a shell as an
              application.

       -r     tells the client that its user is remote.

       -D     turns on the copius debugging output

In-Session Options

       Press return or the right arrow key  on  the  mini  keypad  to  view  a
       document or enter a directory.

       Press   Control/W,  Control/R, or Control/L to repaint your menu at any
       time.

       At  any  time,  you  may  press  ?  to  see  a  help file  of  commands
       available.

BOOKMARKS

       Bookmarks  allow  users  to  create  their own personallized menus from
       those available on the variety of Gopher servers  available  worldwide.
       The following list of keystrokes aids in developing and maintaining the
       bookmarks.

               a : Add current item to the bookmark list.
               A : Add current directory/search to bookmark list.
               v : View bookmark list.
               d : Delete a bookmark/directory entry.

MOVING AROUND

       Use the arrow keys to move around.

               Use the Arrow Keys to move around.

               Up, k ...............:  Move to previous line.
               Down, j .............:  Move to next line.
               Right, Return .......:  "Enter"/Display current item.
               Left, u  ............:  "Exit" current item/Go up a level.

               >, +, Pgdwn, space ..:  View next page.
               <, -, Pgup, b .......:  View previous page.

               0-9 .................:  Go to a specific line.
               m   .................:  Go back to the main menu.

OTHER COMMANDS

               s : Save current item to a file.
               S : Save current list of items to a file.
               D : Download a file.
               q : Quit with prompt.
               Q : Quit unconditionally (also Control/Z).
               r : goto root menu of current item.
               R : goto root menu of current menu.
               = : Display Technical information about current item.
               ^ : Display technical information about current directory.
               o : Open a new gopher server
               w : Open a new gopher server or item by URL
               O : Change options.
               f : Connect to an anonymous FTP host
               / : Search for an item in the menu.
               g : "Gripe" via email to administrator of current item.
               n : Find next search item.
               $, !   :  Spawn  to  subprocess  (use  "logout"  to  return  to
              session)
               Ctrl-T : Show host’s local date and time.

GOPHER OBJECTS

       Menu    entries   ending   with   "/"   are   directories;   additional
       characteristics for files (such as binary, sound,  image,  and  others)
       are identified within angle brackets.

               Item tag    Type      Description
               --------------------------------------------
               (none)        0       file
               /             1       directory
               <)            s       sound file
               <Picture>    I,g      image file
               <Movie>       ;       movie file
               <HQX>         4       BinHexed Macintosh file
               <Bin>         9       binary file
               <PC Bin>      5       DOS binary file
               <CSO>         2       CSO (ph/qi) phone-book server
               <TEL>         8       telnet connection
               <3270>        T       telnet connection (IBM 3270 emulation)
               <MIME>         M        Multi-purpose  Internet Mail Extensions
              file
               <HTML>        h       HyperText Markup Language file
               <?>           7       index-search item
               <??>        (none)    ASK form

EXAMPLES

       gopher gopher.tc.umn.edu
              Connect  to  the  gopher  server   running   on   the   computer
              gopher.tc.umn.edu

       gopher -p "1/Information About Gopher" gopher.tc.umn.edu 70
              Connect  to the gopher server running on port 70 of the computer
              gopher.tc.umn.edu and start  at  the  menu  retrieved  with  the
              selector string 1/Information About Gopher

       gopher     -p     7/indexes/Gopher-index/index     -T    7    -i    FAQ
       mudhoney.micro.umn.edu
              Connect   to   the   gopher   server  running  on  the  computer
              mudhoney.micro.umn.edu and start at the menu of  items  matching
              the  string  FAQ  in  the index specified by the selector string
              7/indexes/Gopher-index/index

CONFIGURATION FILE FORMAT

       The client gets configuration data from the system gopher.rc  file  and
       the  user’s  .gopherrc files.  The options in these files may be set by
       using the O key in the client.

       See the manual page for  gopherrc  for  more  information  about  these
       options.

ENVIRONMENT VARIABLES

       The  client also checks for environment variables for its configuration
       information.  The following variables can be used:

       GOPHER_TELNET:
              The program used to connect to telnet services

       GOPHER_TN3270:
              The program used to connect to TN3270 services

       GOPHER_HTML:
              The program used to read HyperText Markup Language documents.

       GOPHER_PRINTER:
              The program used to print from a pipe.

FILES

       $HOME/.gopherrc
              user bookmarks and configuration information

       /usr/local/lib/gopher.rc
              system default configuration information (default location - may
              be somewhere else on your system)

       /usr/local/lib/gopher.hlp
              client  help file displayed by the ’?’ command (default location
              - may be somewhere else on your system)

COPYRIGHT

       The Internet Gopher(tm) software and  documentation  is  copyright  (c)
       1991,  1992,  1993,  1994  by  the University of Minnesota.  Gopher has
       limitations on its use and comes without a warranty.  Please  refer  to
       the file ’Copyright’ included in the distribution.

                                                                     GOPHER(1)