home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / vfaq.zip / VERONICA.TXT < prev   
Text File  |  1995-10-30  |  29KB  |  619 lines

  1. Common Questions and Answers about veronica, a title search and retrieval
  2. system for use with the Internet Gopher.
  3. Last-modified:  1995/01/13.
  4.  
  5. Mail comments and questions about the FAQ to: foster@scs.unr.edu
  6. Copyright (C) Steven Foster 1993,1994,1995.  This FAQ may be freely
  7. copied and redistributed provided it is copied entire and unmodified and
  8. this copyright statement remains intact.
  9.  
  10. The current version of this FAQ can be retrieved through gopher at
  11. gopher://veronica.scs.unr.edu/00/veronica/veronica-faq
  12. --------------------------------------------------------------------------
  13. Questions in the veronica FAQ:
  14.  
  15. Q1:  What is veronica?
  16. Q2:  How many information servers are included in the index?
  17. Q3:  How many information items are in the index?
  18. Q4:  Which types of information resources are included?
  19. Q5:  Which gopher servers are not included in veronica?
  20. Q6:  How can I connect to veronica?
  21. Q7:  How do I know where a particular information item is located?
  22. Q8:  How can I get my server into the veronica database?
  23. Q9:  How can I keep my server out of the veronica database?
  24. Q10: How can I tell veronica to index only PARTS of my gopher server?
  25. Q11: Does veronica work with Jughead?
  26. Q12: How often is the database updated?
  27. Q13: Where can I get the software to run veronica?
  28. Q14: Where can I get the veronica dataset?
  29. Q15: What does "veronica" mean?
  30. Q16: Why doesn't my server show up in veronica searches?
  31. Q17: Where are the veronica server sites?
  32. Q18: How do I contact the veronica operators?
  33. Q19: How do I compose veronica search queries and use the veronica options?
  34.  
  35. --------------------------------------------------------------------------
  36. Q1: What is veronica?
  37.  
  38. A1: veronica is a resource-discovery system providing access to information
  39.     resources held on most ( 99% + ) of the world's gopher servers.  
  40.     In addition to native gopher data, veronica includes references to many 
  41.     resources provided by other types of information servers, such as 
  42.     WWW servers, usenet archives, and telnet-accessible information services.  
  43.  
  44.     veronica queries are keyword-in-title searches.  A simple query can 
  45.     be quite powerful because a large number of information servers are 
  46.     included in the index.  
  47.  
  48.     veronica is accessed through gopher client software ( see Q6 ).  A 
  49.     veronica user submits a query (via a gopher client) which may contain 
  50.     boolean keyword expressions as well as special veronica directives.
  51.     The result of a veronica search is a gopher menu comprising information
  52.     items whose titles contain the specified keywords.  The results menu may
  53.     be browsed like any other gopher menu.
  54.  
  55. --------------------------------------------------------------------------
  56. Q2: How many information servers are included in the index?
  57.  
  58. A2: In January 1995, 5057 gopher servers were indexed.   The index also
  59.     includes items from approximately 5000 other servers, in cases where  
  60.     those servers are referenced on gopher menus.  These other servers 
  61.     include 3905 WWW servers and about 1000 telnet-type services .  
  62.  
  63.     The gophers are exhaustively indexed; almost every item offered by the
  64.     gopher servers is included in the index ( see Q4 for exceptions ).  The
  65.     contents of WWW servers are not exhaustively indexed:  veronica includes 
  66.     HTML items only when they are referenced on the menus of some gopher server.
  67.  
  68. ---------------------------------------------------------------------------
  69. Q3: How many information items are included in the index?
  70.  
  71. A3: Approximately 15 million items are indexed.  ( November 1994 ).
  72. ----------------------------------------------------------------------------
  73. Q4: Which types of information resources are included in the index?
  74.  
  75. A4: All resources directly served by gopher servers are included in the
  76.     index.  The following types were indexed in December 1994:
  77.  
  78.          0  -- Text File
  79.          1  -- Directory
  80.          2  -- CSO name server
  81.          4  -- Mac HQX file.
  82.          5  -- PC binary
  83.          7  -- Full Text Index (Gopher menu)
  84.          8  -- Telnet Session
  85.          9  -- Binary File
  86.          s  -- Sound
  87.          e  -- Event    (not in 2.06)
  88.          I  -- Image (other than GIF)
  89.          M  -- MIME multipart/mixed message
  90.          T  -- TN3270 Session
  91.          g  -- GIF image
  92.          h  -- HTML, HyperText Markup Language
  93.      :
  94.      ;
  95.      !
  96.  
  97.     Certain types of data NOT served directly by gopher servers are
  98.     also included in the index if the resources are referenced on menus
  99.     of indexed gopher servers.  These types are:  telnet sessions, 
  100.     CSO sessions, html files served by WWW servers, and type-7 searches.
  101.     These items are included in the index even though they reside on 
  102.     non-gopher servers.
  103.  
  104.     Resources provided by gateways to other types of servers are
  105.     given special handling, as follows:
  106.  
  107.     gopher-to-ftp gateway resources: ftp gateway resources are indexed 
  108.         if and only if they are defined as type-1 gopher items; in other
  109.         words, if they are links to DIRECTORIES in ftp servers.
  110.         Individual files  (gopher types 0, 9, 4, 5, 6, I, etc.) offered by 
  111.         ftp gateways are not included in the index.  File-type ftp items 
  112.         were discontinued in May, 1994; at that time the number of 
  113.         ftp-gatewayed files was greater than five million.
  114.  
  115.     go4gw gateway items:  gopher directory-type items represented by
  116.         gateway servers running at ports 4320-4324 are included at
  117.         the DIRECTORY level only ( type-1 resource ).  These gateways are
  118.         not "followed" by the indexing software.  The gateway's title appears
  119.         in the index; information items SERVED BY THE GATEWAY are not
  120.         included.  Go4gw gateways running at other ports may be followed
  121.         inadvertently by the veronica harvester, and thus some gatewayed 
  122.         data of other types may be included in the index.  
  123.  
  124.      NNTP and FINGER:  heuristics are used to avoid finger services
  125.         and nntp ( usenet news ) articles provided via go4gw and other 
  126.         gateways.  Usenet news articles held as files and offered directly
  127.         by gopher servers are however included in the index.
  128.  
  129. ----------------------------------------------------------------------------
  130. Q5: Which gopher servers are not included in the veronica index?
  131.  
  132. A5: A gopher may not be in the index for several reasons:
  133.  
  134.      1. The gopher administrator may have requested that the server
  135.         be excluded.  ( see Q9 below ).
  136.  
  137.      2. The gopher may be relatively new.  In this case the veronica index 
  138.         data may have been harvested before the gopher came on line.  If the
  139.         new gopher has been registered with Minnesota, it will be included in
  140.         the next index update, provided it is accessible to the veronica 
  141.         harvester.
  142.  
  143.      3. A gopher may not be included because it was not accessible to the
  144.         veronica data harvester.  This may occur because of transient network
  145.         outages, or because the server was not operational when the harvester
  146.         tried to contact it.  It may also be the case that a gopher server
  147.         restricts access to outside domains and thus is not indexable.
  148.  
  149.      4. A gopher server will not be indexed if it is running at an IP
  150.         port numbered below 1024, except of course for port 70.  This 
  151.         exclusion is necessary because the harvester needs to avoid all
  152.         sorts of peculiar information services which run at registered low
  153.         ports.
  154.  
  155. ----------------------------------------------------------------------------
  156. Q6: How can I connect to veronica?
  157.  
  158. A6: veronica is accessed through any gopher client.  The client
  159.     may be one of the gopher-specific clients (TurboGopher, 
  160.     Unix curses gopher, WSGopher, etc.) or a multiprotocol browser such 
  161.     as Mosaic, NetScape, Chameleon, etc.
  162.  
  163.     Use the client to find a veronica-access menu on a gopher server menu.
  164.     Most gopher servers will have a menu named something like "Search
  165.     GopherSpace using veronica".  The client may have a "starting points"
  166.     list including veronica.  If your local gopher server does not
  167.     have a veronica access menu, point your gopher client to the 
  168.     veronica HOME MENU at:
  169.  
  170.     gopher://veronica.scs.unr.edu:70/11/veronica
  171.  
  172.     An alternative veronica access menu is at the Mother Gopher:
  173.     gopher://gopher.tc.umn.edu:70/11/Other Gopher and Information Servers/Veronica
  174.  
  175.     The veronica home menu contains several types of items.  There
  176.     is this FAQ, and a short document "How to Compose veronica Queries".
  177.     There is a submenu containing advice for gopher server administrators,
  178.     statistics about gopherspace, access to veronica software, and
  179.     HTML versions of several documents.
  180.  
  181.     More importantly, a number of veronica servers will be listed.
  182.     This home menu is automatically reconfigured every ten minutes, so
  183.     only the currently-active veronica servers will be displayed.  You
  184.     may choose to submit a search to any of these publicly-accessible
  185.     servers, or you can submit your query to the "simplified veronica
  186.     search" option which also appears on the menu.  The "simplified"
  187.     search is a gateway which contacts all the veronica servers for you,
  188.     saving you the chore of trying servers until you find one which 
  189.     accepts your search.  Sometimes all the servers are busy; in that
  190.     case, resubmit your search in a minute or so.
  191.     
  192. --------------------------------------------------------------------------
  193. Q7: How do I know where an information resource is located?
  194.  
  195. A7: Most gopher clients offer a "get information" command or an
  196.     "item descriptor" menu choice.  For instance,  TurboGopher uses
  197.     "command i"; the unix curses client uses an equal sign "="; 
  198.     WSGopher has the "File/info on item" option, and Mosaic has the 
  199.     "Options/Show Current URL" option.
  200.  
  201.     Various degrees of information may be available.  For items served
  202.     by gopher-0 servers, you will be able to determine the domain name
  203.     and hostname of the server, which may be of some use.  Gopher+ servers
  204.     may offer Institution Name attributes, contact person names, or abstracts
  205.     with further meta-data about the resource.
  206.  
  207.     Advanced clients may automatically retrieve the Gopher+ item descriptor
  208.     meta-information, and display it for each item as the pointer is
  209.     moved across the veronica results menu.
  210.  
  211. --------------------------------------------------------------------------
  212. Q8: How can I get my server into the veronica database?
  213.  
  214. A8: The veronica harvester software will find your gopher server IF it is
  215.     registered with the Mother Gopher at Minnesota, OR IF it is 
  216.     referenced on the menu of another gopher server which is registered
  217.     at Minnesota.  Of course, the veronica harvester will not be able to 
  218.     access your server if you have restricted access to your local site.
  219.  
  220.     veronica does not currently have the ability to add new gophers to
  221.     the index immediately when they come online.   New servers will be
  222.     included only at the next general update.  
  223.  
  224.     If your server has been omitted, send mail to veronica@scs.unr.edu
  225.  
  226. -----------------------------------------------------------------------------
  227. Q9: How can I keep my server OUT of the veronica database?
  228.  
  229. A9: There are two ways:
  230.  
  231.     1. If you run the Unix gopher+ server from U. of Minnesota, you may 
  232.        include the line "veronicaindex: no"  in the gopherd.conf file.
  233.        The veronica harvester will completely exclude your server from
  234.        the index.
  235.  
  236.     2. You can use the special veronica control file protocol.   THIS IS
  237.        THE RECOMMENDED WAY TO CONTROL VERONICA'S BEHAVIOR WITH RESPECT
  238.        TO YOUR GOPHER SERVER.  The control files will
  239.        work with gopher-level-0 servers, and can be used with any kind of
  240.        gopher server on any operating system platform.  In brief, the 
  241.        control file lets you specify a number of options for the veronica
  242.        harvester.  You can completely exclude the server from the index,
  243.        or specify that only certain menus are to be indexed.  For more
  244.        information, see the home veronica menu (Q6) and look in the
  245.        "More veronica" submenu (gopher://veronica.scs.unr.edu/11/veronica/About)
  246.  
  247. -------------------------------------------------------------------------- 
  248. Q10: How can I tell veronica to index PART of my gopher server?
  249.  
  250. A10: Use the veronica-control-file protocol. THIS IS
  251.      THE RECOMMENDED WAY TO CONTROL VERONICA'S BEHAVIOR WITH RESPECT
  252.      TO YOUR GOPHER SERVER.  The control files will
  253.      work with gopher-level-0 servers, and can be used with any kind of
  254.      gopher server on any operating system platform.  In brief, the 
  255.      control file lets you specify a number of options for the veronica
  256.      harvester.  You can completely exclude the server from the index,
  257.      or specify that only certain menus are to be indexed.  For more
  258.      information, see the home veronica menu (Q6) and look in the
  259.      "More veronica" submenu (gopher://veronica.scs.unr.edu/11/veronica/About)
  260. ----------------------------------------------------------------------------
  261. Q11: Does veronica work with Jughead?
  262.  
  263. A11: Jughead can supply a prepared index file to the veronica harvester.
  264.      This involves setting up jughead with certain options, and configuring
  265.      a veronica control file ( see Q10 ) to tell the veronica harvester
  266.      how to obtain the data file from Jughead.  For more information,
  267.      see the Jughead distribution documents and the veronica control file
  268.      documents.
  269.  
  270. -----------------------------------------------------------------------------
  271. Q12: How often is the database updated?
  272.  
  273. A12: Approximately once per month.
  274. --------------------------------------------------------------------------
  275. Q13: Where can I get the software to run veronica?
  276.  
  277. A13: The veronica server software can be obtained
  278.     by anonymous ftp from futique.scs.unr.edu  or veronica.scs.unr.edu
  279.     The veronica server code is in the directory "veronica-code".
  280.  
  281.     The current version ( Dec 94 ) of the veronica server is 0.6.5f
  282.     It runs on most flavors of unix boxes, requires a perl interpreter
  283.     and ndbm, and about 2 GB for the dataset.  (data of Jan 18, 1995)
  284.  
  285. --------------------------------------------------------------------------
  286. Q14: Where can I get the veronica data set?
  287.  
  288. A14: You can anonymous-ftp the full veronica dataset from 
  289.     futique.scs.unr.edu, in the "veronica-data" subdirectory.
  290.  
  291.     This data has been processed to eliminate redundant references,
  292.     to avoid loops in the gopher network, and to remove most data
  293.     that is known to be highly transient.
  294.  
  295. ---------------------------------------------------------------------------
  296. Q15:    What does "veronica" mean?
  297.  
  298. A15:    very easy rodent-oriented net-wide index to computerized archives.
  299.  
  300. ---------------------------------------------------------------------------
  301. Q16:    Why doesn't my server show up in veronica searches?
  302.  
  303. A16:    See Q5.
  304.  
  305. ------------------------------------------------------------------------------
  306. Q17: Where are the veronica server sites?
  307.  
  308. A17: There are currently ( January 13, 1995 ) ten publicly-accessible 
  309.      veronica servers.  All of them can be accessed via the 
  310.      veronica Gopher menu at veronica.scs.unr.edu.  If that menu
  311.      is unavailable, consult the Mother Gopher for a veronica access
  312.      menu.  See Q6.
  313.     
  314.      The ten public veronica servers are provided by:
  315.             
  316.      Nevada System Computing Services
  317.      University of Pisa
  318.      University of Koeln
  319.      University of Bergen
  320.      University of Texas, Dallas
  321.      University of Manitoba
  322.      NYSERNET
  323.      PSI, Inc.
  324.      SUNET
  325.      Tachyon Communications
  326. ---------------------------------------------------------------------------
  327. Q18: How do I contact the veronica developers and providers?
  328.  
  329. A18: Send mail to "veronica@scs.unr.edu".
  330.  
  331. ---------------------------------------------------------------------------
  332. Q19: How do I compose veronica search queries, and use various options?
  333.  
  334. A19: The simplest veronica search is just a single word, followed by
  335.      a RETURN.  
  336.      
  337.      The following (better) answer is from the document "How to Compose
  338.      veronica Queries".
  339.  
  340.  
  341. HOW TO COMPOSE VERONICA QUERIES - June 23, 1994: Steven Foster 
  342. This document is an introduction to using veronica.  278 lines.
  343. gopher://veronica.scs.unr.edu:70/00/veronica/how-to-query-veronica
  344.  
  345. veronica:  very easy rodent-oriented net-wide index of computerized archives.
  346.  
  347. Contents:
  348.  
  349.     Introduction.
  350.     Types of Searches.
  351.     Multiple Servers.
  352.     Pre-defined Search Types.
  353.     Entering a Query.
  354.     Default Maximum Items.
  355.     Query Logic, Boolean Searching, and Wildcards.
  356.     Finding Resources of a Certain Gopher "Type".
  357.     Summary of Options.
  358.     Examples.
  359.  
  360. INTRODUCTION
  361.  veronica is an index and retrieval system which can locate items on 
  362.  most of the gopher servers in the Internet.  The veronica index contains
  363.  about 10 million items from approximately 5500 gopher servers (June 1994).
  364.  
  365.  veronica finds resources by searching for WORDS in TITLES.  It does not do a
  366.  full-text search of the contents of the resources; it finds resources 
  367.  whose titles contain your specified search word(s).  The "title" is the title
  368.  of the resource as it appears on the menu of its HOME gopher server.
  369.  
  370.  veronica is used with a gopher client.  You will choose "veronica" from the
  371.  menu of some gopher server, and enter a set of query words or special 
  372.  directives.  When the search is finished, the results will be presented as 
  373.  a normal gopher menu.  You may browse the discovered resources in this menu, 
  374.  as you would use any other gopher menu.
  375.  
  376. TYPES OF SEARCHES 
  377.  Most veronica-access menus offer several types of searches.  In addition to
  378.  these pre-defined types, you can compose veronica queries using a number of
  379.  special options to focus your search more precisely.  You should use these 
  380.  options when appropriate, as they will make it much easier to locate resources.
  381.  (See sections below for PRE-DEFINED SEARCH TYPES and FINDING RESOURCES OF A
  382.  CERTAIN GOPHER TYPE )
  383.  
  384. MULTIPLE SERVERS
  385.  Many veronica-access menus offer a list of various veronica server sites; 
  386.  in this case you will have to choose a server site to use.  Ideally, it
  387.  does not matter which server you use, as all servers will give the same 
  388.  answers.  In practice, the servers do not all update the index at the same
  389.  time, so there will be some difference in the results.  Some servers will 
  390.  return an answer faster than others, depending on load and network traffic.
  391.  
  392.  Many other veronica-access menus offer a single entry rather than a list
  393.  of servers.  In this case, simply click on the search type desired, and 
  394.  submit your query in the dialog box.
  395.  
  396.  
  397. PRE-DEFINED SEARCH TYPES:
  398.   Most access menus offer two predefined search types:
  399.  
  400.  > Search GopherSpace by keywords in Titles
  401.  
  402.     This search will find ALL TYPES of resources whose titles contain your 
  403.     specified search words.  The resources may be of any Gopher data TYPE;
  404.     e.g. ascii documents, gopher directories, image files, binary files, etc.
  405.  
  406.  > Search Gopher DIRECTORIES ONLY for keywords in Titles.
  407.  
  408.     This search will find only Gopher DIRECTORIES whose titles contain the
  409.     specified words.  This search can be very useful to find only major 
  410.     holdings of information which relate to your query.  After veronica finds
  411.     the gopher directories, you can open any of them to see the contents in 
  412.     more detail.  This is especially useful to avoid being overwhelmed by 
  413.     too many results if you are searching with a common word such as
  414.     "women" or "internet"!
  415.  
  416.  You can define your own query, specifying only certain TYPES of gopher
  417.  resources, by using the -t option.  For instance, you could search for ONLY
  418.  image files by including the phrase "-tI" in your query.  See below
  419.  for more about the -t option.
  420.  
  421. ENTERING A QUERY
  422.  When you select a query type, your gopher client will present a dialog
  423.  box.  Enter your query words.  The search is NOT case-sensitive.  
  424.  
  425.  You may get better results by entering a multi-word query rather than a single
  426.  word.  Multiple word queries will find only those items whose titles contain 
  427.  ALL of the specified words.  For instance, "women" will find 5223 items;  but 
  428.  "league women voters" will find 126 items.  Be as specific as you can.
  429.  
  430.  It also helps to be imaginative. Think about how gophers are organized; 
  431.  the information you want may not be found under "league of women voters", 
  432.  but under the more general heading of "politics".
  433.  
  434.  A multiple-word query does not require that the words be adjacent in the
  435.  title, nor that they appear in any particular order.  So, "marx brothers" 
  436.  will locate the same items as "brothers marx".
  437.  
  438.  There is more information on composing queries below.
  439.  
  440. DEFAULT MAXIMUM ITEMS and the "-m" option.
  441.  By default, the veronica servers will deliver only the first 200 items which
  442.  match your query.  You can request any number of items by including the
  443.  "-mX" command phrase in your query.  X is the number of items you wish.
  444.  If X is omitted ( "-m" ), there is no limit to the number of items delivered.
  445.  For instance:
  446.  
  447.     "women"  will provide 200 items.
  448.     "women -m1000" will provide 1000 items.
  449.     "women -m" will provide all available matching items.
  450.  
  451.  You may find a message at the end of your veronica results menu, like
  452.  "*** There are  576 more items matching your query".  If you are not 
  453.  satisfied with the 200 items you got, you can resubmit the query, requesting 
  454.  more items with "-m".
  455.  
  456.  Note that some veronica servers will provide more than 200 items by default.
  457.  
  458.  
  459. QUERY LOGIC, BOOLEAN SEARCHING, and WILDCARDS.
  460.  The search understands the logical operators AND, NOT, OR, (, and ).
  461.  
  462.  If you use a simple multiple-word query, it is the same as using AND between
  463.  the words.  For instance "acid rain" is the same query as "rain and acid".
  464.  "League women voters" is the same as "league and women and voters".
  465.  
  466.  As noted above, we recommend using AND to create a tightly-focused query.
  467.  
  468.  We recommend that the word "OR" be used VERY RARELY.  Usually, OR will
  469.  just produce thousands of hit-or-miss results.  OR is best used in conjunction
  470.  with other operators, as "rice and (fried or curr*) ".
  471.   
  472.  An asterisk ("*") at the TRAILING END of a query word will match anything.
  473.  Use it as a limited form of wildcard search.  The asterisk character may
  474.  be used ONLY at the end of words; the search will fail if a "*" is placed
  475.  within a word or at the beginning of a word.
  476.  
  477.  Search words must be at least two characters long.  Shorter words will be
  478.  ignored.
  479.  
  480.  Interpretation of the query starts from the right-hand, interpreting operators
  481.  as encountered.  If in doubt about order of interpretation, USE PARENTHESES!
  482.  The veronica server at University of Koeln ( june94 ) interprets the query
  483.  logic from left-to-right.
  484.  
  485. FINDING RESOURCES OF A CERTAIN GOPHER "TYPE": the "-t" flag.
  486.  You can use veronica to find resources of (only) a specified gopher type.
  487.  You specify the type(s) of interest by adding the "-tX" option phrase to
  488.  your query.
  489.  
  490.  The -t flag may appear anywhere in the search specification.  For example:
  491.  
  492.     "women -t1" 
  493.     "-t1 women" 
  494.  Either of these search phrases will find resources with the word "women" in
  495.  the title.  All the resources will be gopher DIRECTORY items ( type 1 ).
  496.  
  497.  There must NOT be any spaces between the -t and the type specifier.
  498.  
  499.  You may specify MORE THAN ONE type in the query.  DO NOT use separate -t
  500.  options to do this; simply put all the types together (with no spaces) 
  501.  after the -t.  For example:
  502.  
  503.     "-tgs  mac"  returns a menu of GIF images or SOUNDS with the word
  504.                  "mac" in titles.
  505.  
  506.  Official gopher types, from the Gopher Protocol Document, are:
  507.  
  508.           0  -- Text File
  509.           1  -- Directory
  510.           2  -- CSO name server
  511.           4  -- Mac HQX file.
  512.           5  -- PC binary
  513.           7  -- Full Text Index (Gopher menu)
  514.           8  -- Telnet Session
  515.           9  -- Binary File
  516.           s  -- Sound
  517.           e  -- Event    (not in 2.06)
  518.           I  -- Image (other than GIF)
  519.           M  -- MIME multipart/mixed message
  520.           T  -- TN3270 Session
  521.           c  -- Calendar (not in 2.06)
  522.           g  -- GIF image
  523.           h  -- HTML, HyperText Markup Language
  524.  
  525. SUMMARY OF THE OPTIONS
  526.  
  527.     -t    limit the search to items of specified data type(s).
  528.     -m    specify maximum number of items to find.
  529.     -l  create a file of links for the discovered resources.  The file
  530.      will be displayed as the first item on the veronica results menu.
  531.      You can then retrieve that file and include the links in menus 
  532.      which you may be building.  Not all veronica servers support the
  533.      "-l" option.
  534.  
  535.  Just include the options in the search query.  They will work
  536.  with any gopher client.  You can put options before the query words,
  537.  after the query words, or even between query words.
  538.  
  539.  DO NOT cluster more than one option behind a single hyphen; instead,
  540.  use a separate hyphen for each separate option.  For example:  
  541.  
  542.          gopher -t1s  -m400
  543.  
  544.  This example requests 400 items containing the word "gopher", and
  545.  specifies that we want only items whose type is "directory" or
  546.  "sound".
  547.  
  548. EXAMPLES (from Fred Barrie):  
  549.  
  550.  Simple examples:
  551.  
  552.   >  Search on the word "internet".  This will return a menu list of
  553.      (at most) 200 records that have the word internet in the title field.  
  554.          Just type-
  555.                          internet
  556.  
  557.   >  Search on the word "internet", but specify 1000 items instead of
  558.      the default 200.
  559.          type-
  560.                          internet -m1000
  561.          or
  562.                          -m1000 internet
  563.  
  564.   >  Search on the words "chicken" and "wine".  This returns a menu 
  565.      list of (at most) 200 records that have _BOTH_ "chicken" and "wine".  
  566.          Type-
  567.                          chicken and wine
  568.  
  569.   >  Search for the keywords "chicken" or "wine", specifying directories only. 
  570.      This returns a menu list of resources that have _EITHER_ chicken or wine,
  571.      and which are GOPHER DIRECTORY entries.  Type-
  572.  
  573.                          chicken or wine -t1
  574.      or
  575.                          -t1 chicken or wine 
  576.  
  577.  
  578.   Examples for the operator "NOT":
  579.  
  580.   >  To use the operator "NOT" in a query:
  581.  
  582.              chicken not wine    (will search for all titles with the 
  583.                                   word chicken _BUT NOT_ the word
  584.                                   wine)
  585.  
  586.              chinese food not msg     (will search for our health nuts
  587.                                       all the titles with the words
  588.                                       chinese _AND_ food _BUT NOT_
  589.                                       msg.  Remember there is an
  590.                                       implied _AND_ between two words)
  591.  
  592.   Examples for parenthesis queries:
  593.  
  594.              chicken (wine or curry)  -m      (will list ALL titles with the
  595.                                                  words chicken _AND_ either
  596.                                                  wine _OR_ curry.  -m asks
  597.                                                  for ALL records.)
  598.  
  599.              (chicken or wine) not (msg or growing)
  600.                                      (will search for titles with the
  601.                                       words chicken _OR_ wine _BUT NOT_
  602.                                       msg _OR_ growing)
  603.  
  604.  Examples for word stemming:
  605.  
  606.      The metacharacter "*" matches anything at the TRAILING END of a 
  607.      search word.   
  608.  
  609.              chicken*            (will search for all titles with the
  610.                                   word chicken, chickens, ...)
  611.  
  612.              chicken* or wine*    (will search for all titles with the
  613.                                   word chicken, chickens, ... _OR_ 
  614.                                   wine, wines, wineries, ...)
  615.  
  616.  
  617.  
  618. .
  619.