PURITY(6)							   Games Manual 							 PURITY(6)

NAME

       purity - a general purpose purity test

SYNOPSIS

       /usr/games/purity [ flags ] [ testname ]

DESCRIPTION

       Purity  is  an  interactive purity test program with a simple, user interface and datafile format.  For each test, questions are printed to
       the your terminal, and you are prompted for an answer to the current question.  At a prompt, these are your choices:

	      y      Answer "yes" to the question.

	      n      Answer "no" to the question.

	      b      Backup one question, if you answered it incorrectly, or someone is watching you take the test, and you don't (or do) want	to
		     admit a different answer.

	      r      Redraw the current question.

	      q      Quit the test, and print the current score.

	      ?      Print a help screen for the current prompt.

	      k      Kill a section of the test.  This skips all the questions of the test until the next subject heading.

	      a      Toggle  answer mode between real answers and obfuscated answers.  Real answers print "yes" and "no", while obfuscated answers
		     are "Maybe" and "maybe".  Obfuscated answers are preferred if you are shy, and don't want people to  be  able  to	read  your
		     answers over your shoulder as you take the test.

	      d      Toggle dERanGe output.

	      s      Print your current score on the test you are taking.

	      l      Toggle score logging.

       At the end of the test, your score is printed out.  For most purity tests, lower scores denote more "experience" of the test material.

FLAGS

       These are the command line flags for the test.

	      -a     Show real answers (i.e. "yes" and "no") instead of obfuscated ones (i.e. "Maybe" and "maybe") as you answer the questions.

	      -d     PrINt THe tESt in DerANgeD pRInT.

	      -f     Take  the	test  in  fast mode.  Only the questions are printed, and not any other text blocks, like the introdution, subject
		     headers, and the conclusion.

	      -l     Take the test without having your score logged.

	      -p     Print the test without prompting for answers.  This is useful for making hard copies of the tests without having to edit  out
		     the prompts by hand.

	      -r     Decrypt  the test using the Rot 13 algorithm.  This is done as a form of "protection", such that if you read a rot13 test and
		     it offends you, it's your own fault.

	      -z     zoom through more prompts in large text blocks.  The default is to prompt the user for more when a screenful of text has been
		     printed without any user input.

DATAFILE FORMAT

       The format of the datafiles is a very simple format, intended such that new tests can quickly and easily be converted to run with the test.

       There  are  four types of text in a purity test datafile.  Each type is contained in a bracket type of punctuation.  The definitions are as
       follows:

       the styles of text blocks are:

	      { plain text block }

	      [ subject header ]

	      ( test question )

	      and  < conclusion >

       Plain text blocks are printed out character for character.

       Subject headers are preceded by their subject numbers, starting at 1, and then printed as text blocks.

       Questions are preceded by their numbers, and then prompt the user to answer the question, keeping track of the user's current score.

       Conclusions first calculate and print the user's score for the test, then print out the conclusion as a text block.

       If you wish to include any of the various bracket punctuation in your text, the backslash ("") character will escape the next character.

       To print a question with parentheses, you would use the following format:

       (have you ever written a purity test (like this one)?)

       the output would be this:

	  1.  have you ever written a purity test (like this one)?

       and then it would have asked the user for her/his answer.

       For a generic datafile, use the "sample" datafile for the test.

FILES

       /var/games/purity.scores the score logfile
       /usr/share/games/purity/*	  test data files

AUTHOR

       Eric Lechner, lechner@ucscb.ucsc.edu

								 18 December 1989							 PURITY(6)