home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / infoguide / using-internet / searches / veronica / composing-veronica-queries < prev    next >
Encoding:
Text File  |  1997-12-01  |  11.4 KB  |  281 lines
  1.  
  2. HOW TO COMPOSE VERONICA QUERIES - June 23, 1994: Steven Foster 
  3. This document is an introduction to using veronica.  278 lines.
  4. gopher://veronica.scs.unr.edu:70/00/veronica/how-to-query-veronica
  5.  
  6. veronica:  very easy rodent-oriented net-wide index of computerized archives.
  7.  
  8. Contents:
  9.  
  10.     Introduction.
  11.     Types of Searches.
  12.     Multiple Servers.
  13.     Pre-defined Search Types.
  14.     Entering a Query.
  15.     Default Maximum Items.
  16.     Query Logic, Boolean Searching, and Wildcards.
  17.     Finding Resources of a Certain Gopher "Type".
  18.     Summary of Options.
  19.     Examples.
  20.  
  21. INTRODUCTION
  22.  Veronica is an index and retrieval system which can locate items on 
  23.  most of the gopher servers in the Internet.  The veronica index contains
  24.  about 10 million items from approximately 5500 gopher servers (June 1994).
  25.  
  26.  Veronica finds resources by searching for WORDS in TITLES.  It does not do a
  27.  full-text search of the contents of the resources; it finds resources 
  28.  whose titles contain your specified search word(s).  The "title" is the title
  29.  of the resource as it appears on the menu of its HOME gopher server.
  30.  
  31.  Veronica is used with a gopher client.  You will choose "veronica" from the
  32.  menu of some gopher server, and enter a set of query words or special 
  33.  directives.  When the search is finished, the results will be presented as 
  34.  a normal gopher menu.  You may browse the discovered resources in this menu, 
  35.  as you would use any other gopher menu.
  36.  
  37. TYPES OF SEARCHES 
  38.  Most veronica-access menus offer several types of searches.  In addition to
  39.  these pre-defined types, you can compose veronica queries using a number of
  40.  special options to focus your search more precisely.  You should use these 
  41.  options when appropriate, as they will make it much easier to locate resources.
  42.  (See sections below for PRE-DEFINED SEARCH TYPES and FINDING RESOURCES OF A
  43.  CERTAIN GOPHER TYPE )
  44.  
  45. MULTIPLE SERVERS
  46.  Many veronica-access menus offer a list of various veronica server sites; 
  47.  in this case you will have to choose a server site to use.  Ideally, it
  48.  does not matter which server you use, as all servers will give the same 
  49.  answers.  In practice, the servers do not all update the index at the same
  50.  time, so there will be some difference in the results.  Some servers will 
  51.  return an answer faster than others, depending on load and network traffic.
  52.  
  53.  Many other veronica-access menus offer a single entry rather than a list
  54.  of servers.  In this case, simply click on the search type desired, and 
  55.  submit your query in the dialog box.
  56.  
  57.  
  58. PRE-DEFINED SEARCH TYPES:
  59.   Most access menus offer two predefined search types:
  60.  
  61.  > Search GopherSpace by keywords in Titles
  62.  
  63.     This search will find ALL TYPES of resources whose titles contain your 
  64.     specified search words.  The resources may be of any Gopher data TYPE;
  65.     e.g. ascii documents, gopher directories, image files, binary files, etc.
  66.  
  67.  > Search Gopher DIRECTORIES ONLY for keywords in Titles.
  68.  
  69.     This search will find only Gopher DIRECTORIES whose titles contain the
  70.     specified words.  This search can be very useful to find only major 
  71.     holdings of information which relate to your query.  After veronica finds
  72.     the gopher directories, you can open any of them to see the contents in 
  73.     more detail.  This is especially useful to avoid being overwhelmed by 
  74.     too many results if you are searching with a common word such as
  75.     "women" or "internet"!
  76.  
  77.  You can define your own query, specifying only certain TYPES of gopher
  78.  resources, by using the -t option.  For instance, you could search for ONLY
  79.  image files by including the phrase "-tI" in your query.  See below
  80.  for more about the -t option.
  81.  
  82. ENTERING A QUERY
  83.  When you select a query type, your gopher client will present a dialog
  84.  box.  Enter your query words.  The search is NOT case-sensitive.  
  85.  
  86.  You may get better results by entering a multi-word query rather than a single
  87.  word.  Multiple word queries will find only those items whose titles contain 
  88.  ALL of the specified words.  For instance, "women" will find 5223 items;  but 
  89.  "league women voters" will find 126 items.  Be as specific as you can.
  90.  
  91.  It also helps to be imaginative. Think about how gophers are organized; 
  92.  the information you want may not be found under "league of women voters", 
  93.  but under the more general heading of "politics".
  94.  
  95.  A multiple-word query does not require that the words be adjacent in the
  96.  title, nor that they appear in any particular order.  So, "marx brothers" 
  97.  will locate the same items as "brothers marx".
  98.  
  99.  There is more information on composing queries below.
  100.  
  101. DEFAULT MAXIMUM ITEMS and the "-m" option.
  102.  By default, the veronica servers will deliver only the first 200 items which
  103.  match your query.  You can request any number of items by including the
  104.  "-mX" command phrase in your query.  X is the number of items you wish.
  105.  If X is omitted ( "-m" ), there is no limit to the number of items delivered.
  106.  For instance:
  107.  
  108.     "women"  will provide 200 items.
  109.     "women -m1000" will provide 1000 items.
  110.     "women -m" will provide all available matching items.
  111.  
  112.  You may find a message at the end of your veronica results menu, like
  113.  "*** There are  576 more items matching your query".  If you are not 
  114.  satisfied with the 200 items you got, you can resubmit the query, requesting 
  115.  more items with "-m".
  116.  
  117.  Note that some veronica servers will provide more than 200 items by default.
  118.  
  119.  
  120. QUERY LOGIC, BOOLEAN SEARCHING, and WILDCARDS.
  121.  The search understands the logical operators AND, NOT, OR, (, and ).
  122.  
  123.  If you use a simple multiple-word query, it is the same as using AND between
  124.  the words.  For instance "acid rain" is the same query as "rain and acid".
  125.  "League women voters" is the same as "league and women and voters".
  126.  
  127.  As noted above, we recommend using AND to create a tightly-focused query.
  128.  
  129.  We recommend that the word "OR" be used VERY RARELY.  Usually, OR will
  130.  just produce thousands of hit-or-miss results.  OR is best used in conjunction
  131.  with other operators, as "rice and (fried or curr*) ".
  132.   
  133.  An asterisk ("*") at the TRAILING END of a query word will match anything.
  134.  Use it as a limited form of wildcard search.  The asterisk character may
  135.  be used ONLY at the end of words; the search will fail if a "*" is placed
  136.  within a word or at the beginning of a word.
  137.  
  138.  Search words must be at least two characters long.  Shorter words will be
  139.  ignored.
  140.  
  141.  Interpretation of the query starts from the right-hand, interpreting operators
  142.  as encountered.  If in doubt about order of interpretation, USE PARENTHESES!
  143.  The veronica server at University of Koeln ( june94 ) interprets the query
  144.  logic from left-to-right.
  145.  
  146. FINDING RESOURCES OF A CERTAIN GOPHER "TYPE": the "-t" flag.
  147.  You can use veronica to find resources of (only) a specified gopher type.
  148.  You specify the type(s) of interest by adding the "-tX" option phrase to
  149.  your query.
  150.  
  151.  The -t flag may appear anywhere in the search specification.  For example:
  152.  
  153.     "women -t1" 
  154.     "-t1 women" 
  155.  Either of these search phrases will find resources with the word "women" in
  156.  the title.  All the resources will be gopher DIRECTORY items ( type 1 ).
  157.  
  158.  There must NOT be any spaces between the -t and the type specifier.
  159.  
  160.  You may specify MORE THAN ONE type in the query.  DO NOT use separate -t
  161.  options to do this; simply put all the types together (with no spaces) 
  162.  after the -t.  For example:
  163.  
  164.     "-tg1  mac"  returns a menu of GIF images or SOUNDS with the word
  165.                  "mac" in titles.
  166.  
  167.  Official gopher types, from the Gopher Protocol Document, are:
  168.  
  169.           0  -- Text File
  170.           1  -- Directory
  171.           2  -- CSO name server
  172.           4  -- Mac HQX file.
  173.           5  -- PC binary
  174.           7  -- Full Text Index (Gopher menu)
  175.           8  -- Telnet Session
  176.           9  -- Binary File
  177.           s  -- Sound
  178.           e  -- Event    (not in 2.06)
  179.           I  -- Image (other than GIF)
  180.           M  -- MIME multipart/mixed message
  181.           T  -- TN3270 Session
  182.           c  -- Calendar (not in 2.06)
  183.           g  -- GIF image
  184.           h  -- HTML, HyperText Markup Language
  185.  
  186. SUMMARY OF THE OPTIONS
  187.  
  188.     -t    limit the search to items of specified data type(s).
  189.     -m    specify maximum number of items to find.
  190.     -l   create a file of links for the discovered resources.  The file
  191.      will be displayed as the first item on the veronica results menu.
  192.      You can then retrieve that file and include the links in menus 
  193.      which you may be building.  Not all veronica servers support the
  194.      "-l" option.
  195.  
  196.  Just include the options in the search query.  They will work
  197.  with any gopher client.  You can put options before the query words,
  198.  after the query words, or even between query words.
  199.  
  200.  DO NOT cluster more than one option behind a single hyphen; instead,
  201.  use a separate hyphen for each separate option.  For example:  
  202.  
  203.          gopher -t1s  -m400
  204.  
  205.  This example requests 400 items containing the word "gopher", and
  206.  specifies that we want only items whose type is "directory" or
  207.  "sound".
  208.  
  209. EXAMPLES (from Fred Barrie):  
  210.  
  211.  Simple examples:
  212.  
  213.   >  Search on the word "internet".  This will return a menu list of
  214.      (at most) 200 records that have the word internet in the title field.  
  215.          Just type-
  216.                          internet
  217.  
  218.   >  Search on the word "internet", but specify 1000 items instead of
  219.      the default 200.
  220.          type-
  221.                          internet -m1000
  222.          or
  223.                          -m1000 internet
  224.  
  225.   >  Search on the words "chicken" and "wine".  This returns a menu 
  226.      list of (at most) 200 records that have _BOTH_ "chicken" and "wine".  
  227.          Type-
  228.                          chicken and wine
  229.  
  230.   >  Search for the keywords "chicken" or "wine", specifying directories only. 
  231.      This returns a menu list of resources that have _EITHER_ chicken or wine,
  232.      and which are GOPHER DIRECTORY entries.  Type-
  233.  
  234.                          chicken or wine -t1
  235.      or
  236.                          -t1 chicken or wine 
  237.  
  238.  
  239.   Examples for the operator "NOT":
  240.  
  241.   >  To use the operator "NOT" in a query:
  242.  
  243.              chicken not wine    (will search for all titles with the 
  244.                                   word chicken _BUT NOT_ the word
  245.                                   wine)
  246.  
  247.              chinese food not msg     (will search for our health nuts
  248.                                       all the titles with the words
  249.                                       chinese _AND_ food _BUT NOT_
  250.                                       msg.  Remember there is an
  251.                                       implied _AND_ between two words)
  252.  
  253.   Examples for parenthesis queries:
  254.  
  255.              chicken (wine or curry)  -m      (will list ALL titles with the
  256.                                                  words chicken _AND_ either
  257.                                                  wine _OR_ curry.  -m asks
  258.                                                  for ALL records.)
  259.  
  260.              (chicken or wine) not (msg or growing)
  261.                                      (will search for titles with the
  262.                                       words chicken _OR_ wine _BUT NOT_
  263.                                       msg _OR_ growing)
  264.  
  265.  Examples for word stemming:
  266.  
  267.      The metacharacter "*" matches anything at the TRAILING END of a 
  268.      search word.   
  269.  
  270.              chicken*            (will search for all titles with the
  271.                                   word chicken, chickens, ...)
  272.  
  273.              chicken* or wine*    (will search for all titles with the
  274.                                   word chicken, chickens, ... _OR_ 
  275.                                   wine, wines, wineries, ...)
  276.  
  277.  
  278.  
  279.  
  280.  
  281.