Provided by: conquest_8.3-2_i386 bug

NAME

       conqinit - a utility for the Conquest Init parser (CQI)

SYNOPSIS

       conqinit [OPTIONS]

DESCRIPTION

       conqinit  can  be  used  to test the parser, perform syntax checking on
       conqinitrc and texturesrc files, as well as to generate initdata.h  and
       sounddata.h header files containing compiled‐in defaults.

       CQI  is  a lex/yacc parser that is used by Conquest 8.1.2a or later for
       configuration of the planets and other general purpose  data,  and  for
       the  GL  client  conquestgl, for the specification of colors, textures,
       animation definitions, sound, and music.

       These pre‐generated  header  files  (initdata.h,  sounddata.h)  contain
       defaults compiled directly into conquest, in the event the relevant CQI
       config file could not be opened or successfully read on  startup.   End
       users  should  not  generate  these  files.  Validated header files are
       included with the src distribution.

       If you are modifying one of the CQI config files, (conquestrc, soundrc,
       etc),  you  should at least run conqinit on them to check for syntax or
       other validation errors.  If conquest (or conquestd) fails to  properly
       load and parse the file at runtime, the built in internal defaults will
       be used (when possible) and a warning message will be logged.

OPTIONS

       -f <file>
               Read data from file <file>.

       -v      Be verbose about everything.

       -d      Turns on alot of debugging.

       -s      Treat the input file as a file in soundrc format.  The  default
               is to treat the file as if it were in conqinitrc format.

       -t      Treat  the  input  file  as  a  file in texturesrc format.  The
               default is to treat the  file  as  if  it  were  in  conqinitrc
               format.

       -h      Dump  the  parsed  file out to stdout in initdata.h sounddata.h
               format (depending on the presence of the -s option).

       -D      Dump the current universe to stdout in conqinitrc format.

               This option is sort of a hack.  It loads the current state of
               the universe on the local machine and generates a conqinitrc
               format file on stdout.  This file can be saved and made the
               default conqinitrc for a system.

               If you do this, you will almost certainly want to edit the
               generated file and at least change the colors of the suns, and
               the sun’s
               randomized army counts.  Since this data is not currently
               stored in the common block, conqinit tries to choose
               reasonable defaults for them.  Make sure it actually did :)

               This capability is useful if you init the universe, then use
               conqoper to edit and or create new planets and arrange them
               just like you want them.  Then, using the above command, dump
               the universe to a conqinitrc file, edit it if neccessary (to
               clean up colors, etc).

               Then copy that file over the system’s conqinitrc file (or email
               it to your friends :).  From
               then on, whenever the planets are initialized (due to a
               successful conquer, or the actions of an oper in conqoper),
               your definitions will be used as the default planet
               configuration.

SEE ALSO

       conquestd(6), conqoper(6), conqdriv(6), conquestsh(6), conqmetad(6)

AUTHOR

       Jon Trulson <jon@radscan.com>

                                                                   conqinit(6)