BSD 4 development
[unix-history] / usr / man / man6 / quiz.6
CommitLineData
60913c9a
BJ
1.TH QUIZ 6
2.SH NAME
3quiz \- test your knowledge
4.SH SYNOPSIS
5.B /usr/games/quiz
6[
7.B \-i
8file ]
9[
10.B \-t
11] [ category1 category2 ]
12.SH DESCRIPTION
13.I Quiz
14gives associative
15knowledge tests on various subjects.
16It asks items chosen from
17.I category1
18and expects answers from
19.IR category2 .
20If no categories are specified,
21.I quiz
22gives instructions
23and lists the available categories.
24.PP
25.I Quiz
26tells a correct answer whenever you type
27a bare newline.
28At the end of input, upon interrupt,
29or when questions run out,
30.I quiz
31reports a score and terminates.
32.PP
33The
34.B \-t
35flag specifies `tutorial' mode,
36where missed questions are repeated
37later, and material is gradually introduced as you learn.
38.PP
39The
40.B \-i
41flag causes the named file to be substituted for the
42default index file.
43The lines of these files have the syntax:
44.IP "" 4
45.nf
46.ta \w'alternate 'u
47line = category newline \(bv category `:' line
48category = alternate \(bv category `|' alternate
49alternate = empty \(bv alternate primary
50primary = character \(bv `[' category `]' \(bv option
51option = `{' category `}'
52.PP
53.fi
54The first category on each
55line of an index file names an information file.
56The remaining categories specify the order and contents of
57the data in each line of the
58information file.
59Information files have the same syntax.
60Backslash `\\' is used as with
61.IR sh (1)
62to quote syntactically
63significant characters or to insert transparent
64newlines into a line.
65When either a question or its answer is empty,
66.I quiz
67will refrain from asking it.
68.SH FILES
69/usr/games/quiz.k/*
70.SH BUGS
71The construct `a|ab' doesn't work in an information
72file.
73Use `a{b}'.