home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / intrhelp.zip / GOPHER.DOC < prev   
Internet Message Format  |  1994-09-18  |  9KB
  1. Date: Saturday, 17-Sep-94 04:51 PM
  2.  
  3. From: Gopher                   \ Internet:    (gophermail@calvin.edu)
  4. To:   Gary Bradford            \ PRODIGY:     (ABMM81A)
  5.  
  6. Subject: GopherMail Help
  7.  
  8. WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING!
  9.  
  10.   GopherMail is an unofficial service, and may disappear at any time.
  11.  
  12. WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING!
  13.  
  14. About GopherMail
  15.  
  16. GopherMail is a gopher client that uses electronic mail to interact with the
  17. user.  Messages containing menus and gopher link information are mailed to
  18. users in response to their requests.  Users reply to these messages and
  19. indicate which menu items they want.  It lets people use Gopher without
  20. requiring them to have an account directly on the Internet, because it
  21. communicates through email messages instead of direct "live" network
  22. connections.
  23.  
  24. Until now, Gopher could only be used by people with Mac's, PC's, NeXTs and
  25. Suns, etc. which are "live" on the Internet, or through login accounts on
  26. Internet machines.  Gopher client programs would make a direct network
  27. connection to the Gopher server on the host with the desired information,
  28. anywhere on the Internet, anywhere in the world.
  29.  
  30. Thanks to the GopherMail program, most of the resources of Gopher are now
  31. available to everyone with email-only access to the Internet.  One estimate
  32. says that there are more than 10 million people who are off the Internet,
  33. but can reach it with email.  Wow.
  34.  
  35.  
  36. Getting Started
  37.  
  38. You can get started by sending mail to gopher@calvin.edu with any or no 
  39. subject and any or no message body. GopherMail will reply by sending you 
  40. it's main gopher menu. You then use your email program to reply to that 
  41. message, including it in the text of your reply. Mark which menu options 
  42. you want to follow-up by putting an "X" (or "x") anywhere near the 
  43. beginning of the line, before the menu numbers for those options. 
  44.  
  45. From there you can just keep repeating the process, sending replies back to
  46.  gopher with the desired items marked with an X. To make it more efficient,
  47.  you could edit your replies so they contain just the gopher link infor- 
  48. mation for the items that you want. You'll find all the link information 
  49. after the menu, at the bottom of the menu messages that GopherMail sends to
  50.  you. Some items on gopher menus are database searches and college phone 
  51. books. To search for a particular name or keyword(s), you simply send them 
  52. on the "Subject:" line of the message in which you've Xed the phonebook or 
  53. WAIS database menu option. 
  54.  
  55.  
  56. Options 
  57.  
  58. GopherMail's options include:
  59.   - Message splitting after a certain file size
  60.   - Menu splitting after a certain number of menu items
  61.   - Re-using links saved in a "Bookmarks" file
  62.   - Requesting the Gopher menu for a specific hostname
  63.   - Requesting this help file
  64.   - Selecting menu items using fewer keystrokes
  65.   - Requesting items from the Info-Mac Archive
  66.   - Requesting gopher items with their raw link information
  67.  
  68. Since many email gateways have size limits on email messages, it's possible
  69.  to split GopherMail output into several messages when it exceeds a certain
  70.  size. This can be done by specifying a maximum number of menu items to send
  71.  in one message, or by specifying a maximum size in bytes for text, HQX, 
  72. binary and sound files. There are a couple of ways to do this. The first 
  73. way is to put "Menu=50" and/or "Split=30000" (for example) in the 
  74. "Subject:" of your message when requesting gopher menus and/or files. This 
  75. would limit the output to 50 menu items per message, and would send files 
  76. in messages of approximately 30,000 bytes each, maximum. 
  77.  
  78. The other way is to include these same instructions in the body of the 
  79. message, on separate lines. For example:
  80.  
  81. Split=25K  You may have text after the "25K".  The "K" or "k" becomes "000".
  82. Menu=75    Yes, I know 1K = 1024, but it was easier to write this way.
  83.  
  84. Lines like these already appear in menu messages, you can find them after 
  85. the menu items and before the link information. They contain the default 
  86. values. You should edit these lines to contain the values that you want. 
  87. All subsequent menus will contain your preferred "Menu=" and "Split=" 
  88. values. Setting these values to 0 (zero) has the effect of not splitting 
  89. messages at all. The default is to split menus after 100 items, and files 
  90. after 27,000 bytes.  If "Split=" or "Menu=" appear in the Subject: of the
  91. message, these will override the values set in the message body.
  92.  
  93. You can specify a different host when requesting a top level gopher menu by
  94. placing a fully qualified domain name as the "Subject:" of your message
  95. (such as gopher.micro.umn.edu).  You can also specify a port other than the
  96. default of 70 by placing it after a fully qualified domain name in the
  97. subject (e.g. darth.sdsc.edu 800).
  98.  
  99. The most efficient way to use GopherMail is to mail just the link
  100. information for one or several gopher items.  You can build a type of
  101. "bookmarks" file by saving the links that you want to use again.  If you
  102. mail just the link information for a gopher connection, GopherMail will
  103. follow the link and mail you the output.  Here's what you need:
  104.  
  105. Name=About GopherMail   <- This is optional, it returns in the Subject:
  106. Type=0                  <- This is required, see below for a list of types.
  107. Port=70                 <- Port 70 is assumed, required only if different.
  108. Path=0/gophermail       <- This is usually required, depends on the link.
  109. Host=gopher.calvin.edu  <- Required.  This MUST be the last line of the
  110. link.
  111.  
  112. Supported Types are:
  113.  
  114.          0  -- Text File
  115.          1  -- Directory
  116.          2  -- CSO name server
  117.          4  -- Mac HQX file.
  118.          7  -- Full Text Index (these are often WAIS database searches)
  119.          9  -- Binary File
  120.          s  -- Sound
  121.          
  122. Binary and Sound Files are sent as uuencoded files.
  123.  
  124. If you send the word "help" as the subject (no quotes), GopherMail will send
  125. you this help file.
  126.  
  127. To save a few keystrokes, instead of putting X's in front of the menu lines,
  128. you could also just insert lines at the top of the reply which contain an
  129. "X" followed by the menu number that you want, such as: x3
  130. X15
  131.  
  132. Macintosh Programs and other files uploaded to the Info-Mac Archives on
  133. Sumex at Stanford can be easily requested through GopherMail.  Just send
  134. mail to gopher with the complete "Archived as" line for each file, such as:
  135. [Archived as /info-mac/dir/file-name.hqx; 400K] GopherMail will recognize
  136. these as Info-Mac requests, and retrieve them from the gopher server on
  137. sumex-aim.stanford.edu.  Since mail programs like Eudora can automatically
  138. de-binhex only complete HQX files, the default for Info-Mac files is not to
  139. split them into parts. This can easily be overridden by supplying a "Split="
  140. value on the Subject: line.
  141.  
  142. GopherMail also recognizes gopher link information in "raw" form, which
  143. means tab-delimited on one line.  A typical link might look like:
  144.  
  145. 0About GopherMail#0/gophermail#gopher.calvin.edu#70
  146.  
  147. The "#" marks represent tab characters.  This may not seem very useful, but
  148. it allows you to copy a link from a program like GopherApp and paste it into
  149. a message to gopher for processing by GopherMail.
  150.  
  151.  
  152. Why GopherMail?
  153.  
  154. I was afraid that after leaving my job at Calvin in 1993, I might not be
  155. able to get an account which has direct "live" access to the Internet, and
  156. therefore have no more cool gopher access.  I expect that no matter where I
  157. live, I'll manage to at least find a service (free, cheap, or commercial)
  158. that will let me send email to Internet addresses.  My GopherMail program
  159. lives on an Internet computer, such as this Sun at Calvin where it started,
  160. or the computers at U of Minn, or maybe someday on every gopher server on
  161. the net, and it accepts email requests from anyone, on or off the Internet.
  162.  It makes the gopher connections on the Internet, then it emails the results
  163. back to the person who requested them, to whatever their email address is.
  164.  
  165.  
  166. Credits
  167.  
  168. GopherMail was written in Perl by Fred Bremmer in September 1992. Nick
  169. Hengeveld helped with the TCP portion, and Matt Ranney provided the book on
  170. Perl and helped with some regular expressions.  Several friends helped to
  171. find bugs and suggest improvements.
  172.  
  173. For help, to report bugs, or for more information, send email to
  174. gophermail-admin@calvin.edu
  175.  
  176.  
  177.  
  178.