1: .\"     $NetBSD: quiz.6,v 1.10 2003/08/07 09:37:34 agc Exp $
    2: .\"
    3: .\" Copyright (c) 1991, 1993
    4: .\"     The Regents of the University of California.  All rights reserved.
    5: .\"
    6: .\" This code is derived from software contributed to Berkeley by
    7: .\" Jim R. Oldroyd at The Instruction Set.
    8: .\"
    9: .\" Redistribution and use in source and binary forms, with or without
   10: .\" modification, are permitted provided that the following conditions
   11: .\" are met:
   12: .\" 1. Redistributions of source code must retain the above copyright
   13: .\"    notice, this list of conditions and the following disclaimer.
   14: .\" 2. Redistributions in binary form must reproduce the above copyright
   15: .\"    notice, this list of conditions and the following disclaimer in the
   16: .\"    documentation and/or other materials provided with the distribution.
   17: .\" 3. Neither the name of the University nor the names of its contributors
   18: .\"    may be used to endorse or promote products derived from this software
   19: .\"    without specific prior written permission.
   20: .\"
   21: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   22: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   23: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   24: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   25: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   26: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   27: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   28: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   29: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   30: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   31: .\" SUCH DAMAGE.
   32: .\"
   33: .\"     @(#)quiz.6  8.1 (Berkeley) 5/31/93
   34: .\"
   35: .Dd May 31, 1993
   36: .Dt QUIZ 6
   37: .Os
   38: .Sh NAME
   39: .Nm quiz
   40: .Nd random knowledge tests
   41: .Sh SYNOPSIS
   42: .Nm
   43: .Op Fl t
   44: .Op Fl i Ar file
   45: .Op Ar question answer
   46: .Sh DESCRIPTION
   47: The
   48: .Nm
   49: utility tests your knowledge of random facts.
   50: It has a database of subjects from which you can choose.
   51: With no arguments,
   52: .Nm
   53: displays the list of available subjects.
   54: .Pp
   55: The options are as follows:
   56: .Bl -tag -width indent
   57: .It Fl t
   58: Use tutorial mode, in which questions are repeated later if you didn't get
   59: them right the first time, and new questions are presented less frequently
   60: to help you learn the older ones.
   61: .It Fl i
   62: Specify an alternative index file.
   63: .El
   64: .Pp
   65: Subjects are divided into categories.
   66: You can pick any two categories from the same subject.
   67: .Nm
   68: will ask questions from the first category and it expects answers from
   69: the second category.
   70: For example, the command
   71: .Dq quiz victim killer
   72: asks questions which are the names of victims, and expects you to answer
   73: with the cause of their untimely demise, whereas the command
   74: .Dq quiz killer victim
   75: works the other way around.
   76: .Pp
   77: If you get the answer wrong,
   78: .Nm
   79: lets you try again.
   80: To see the right answer, enter a blank line.
   81: .Ss Index and Data File Syntax
   82: The index and data files have a similar syntax.
   83: Lines in them consist of several categories separated by colons.
   84: The categories are regular expressions formed using the following
   85: meta-characters:
   86: .sp
   87: .Bl -tag -width "pat|pat" -compact -offset indent
   88: .It pat|pat
   89: alternative patterns
   90: .It {pat}
   91: optional pattern
   92: .It [pat]
   93: delimiters, as in pat[pat|pat]pat
   94: .El
   95: .Pp
   96: In an index file, each line represents a subject.
   97: The first category in each subject is the pathname of the data file for
   98: the subject.
   99: The remaining categories are regular expressions for the titles of each
  100: category in the subject.
  101: .Pp
  102: In data files, each line represents a question/answer set.
  103: Each category is the information for the question/answer for that category.
  104: .Pp
  105: The backslash character (``\e'') is used to quote syntactically significant
  106: characters, or at the end of a line to signify that a continuation line
  107: follows.
  108: .Pp
  109: If either a question or its answer is empty,
  110: .Nm
  111: will refrain from asking it.
  112: .Sh FILES
  113: .Bl -tag -width @quiz_dir@ -compact
  114: .It Pa @quiz_dir@
  115: The default index and data files.
  116: .El
  117: .Sh BUGS
  118: .Nm
  119: is pretty cynical about certain subjects.