[unix-history] / usr / src / games / quiz / quiz.6

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