linequiz(1)                                                        linequiz(1)



NAME
       linequiz - command-line quiz-program


SYNTAX
       linequiz [options] [input file]
       linequiz [-h|--help|/?]


DESCRIPTION
       This  program isn't actually meant to be directly used on a normal com-
       puter-display, but as a backend program. You can use it for example  to
       write graphical interfaces in other programming languages, you can eas-
       ily combine it with text-to-speech software, or blind users can use  it
       with a braille-line.

       Each  action  is  introduced by a fixed english keyword in capital let-
       ters. These can be used as hooks in other programs.

       When you enter the input file on the command-line, you may  leave  away
       the  extension  ".akfquiz". If the filename is given without a path and
       the environment-variable QUIZPATH is set, then  the  file  is  searched
       there.

       The  prompt  "#>"  means,  that  it's a question with just one possible
       numeric answer, while the prompt "##>" indicates a question  with  more
       than one possible numeric answer. For text-string answers "$>" is used.


Options
       -h | --help | /?

              print a short help-message


       -s      no sound (no beep)


       -l      add more line-breaks (useful when used as backend)


       -w 75   set the width of the output


       -d <dir>

              path to the quizfiles.  This parameter overrides the environment
              variable QUIZPATH.


       -OEM    OEM charset (IBM850 or IBM 437) for output


       -latin1

              Latin 1 charset (ISO 8859-1), or a compatible one for output


ENVIRONMENT
       QUIZPATH

              searchpath  to  the  quiz-files.   It  may  have  more  than one
              directory, just like the variable PATH.

              If not set a reasonable default will be used. Check with --help.


       LANG     Language.   The  language-setting  in  the quiz-file overrides
              this.



       MM_CHARSET

              If set to IBM850, CP850,  IBM437  or  CP437  and  the  quiz-file
              doesn't specify an equivalent charset, then the Latin1->OEM con-
              verter is activated.

              This variable is just supported on multi-user systems.


LICENSE
       Copyright  2003-2006 Andreas K. Foerster
       <akfquiz@akfoerster.de>

       AKFQuiz is free software; you can  redistribute  it  and/or  modify  it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at  your
       option) any later version.

       AKFQuiz  is distributed in the hope that it will be useful, but WITHOUT
       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
       for more details.



INTERNET
       contact:
              mailto:akfquiz@akfoerster.de


       homepage:
              http://akfoerster.de/akfquiz/


       examples:
              http://akfoerster.de/akfquiz/quiz.html


       publish quiz:
              http://akfoerster.de/akfquiz/quizupload (no guaranty!)



SEE ALSO
       akfquiz(5)  scrquiz(1)  grquiz(1)   mkquiz(1)   diaquiz(1)   cgiquiz(8)
       gtkquizchooser(1)



AKFQuiz                              4.2.0                         linequiz(1)
