================================================================
Title                   : Quake Name Generator

Filename                : QNAME.ZIP
                          
Contents  		: QNAME.EXE (executable)
			  QNAME.C   (Source code)
			  QNAME.TXT (This file)

Author                  : Matt Spaulding - aka Salimoneus

Email Address           : mspauld@mindspring.com

Description  		: This little utility allows you to create those 'cool' quake names you may have
			  seen around.  It allows for plain, gold, or alternating color letters/numbers,
			  and also allows you to include your clan's initials in brackets [].  It's pretty
			  straight forward, and is very easy to use.  Just answer the questions, and it does the 
			  rest.  It is somewhat limited on what combinations you can use.  I have included
			  features that seem popular on the servers I usually frequent, so some configuration may
			  not be possible.  Originally I had only intended to brush up on my programming
			  skills, but figured why not be productive at the same time, so this is the result.  
			  This should save you some time as compared to looking up each characters 'value', then
			  entering each one individually, hoping you got the numbers right.  It also allows for 
			  quick 'on the fly' changes to your name while Quake is running.  I do NOT plan to make
			  further enhancements unless there is a major bug that I missed, or maybe a feature that
			  several people desire.  I welcome your comments or suggestions.  Hope you enjoy it!

Platforms		: This has been tested on DOS, Win95 and WinNT(DOS window).  For other OSs, as long as 
			  you have access to an ANSI-C compiler, you should have no problems getting it to run.

Coding			: As I said above, this originally was not intended to be a project, so the code
			  is not very pretty(globals, doh!).  Hence, don't bother looking for a Windows
			  version, there aint one.  I haven't seen a name builder for dos yet, so I have tried
			  to fill this void here.  I especially emphasized on 'pointer' use,  so much of that could
			  have been done with simple strcat()'s.  I was not sure how portable the extended characters
			  are, so I decided to just imbed them into char arrays.  I think that took more time than 
			  the actual coding.  I'm sure it would not have been too difficult to work a formula for 
			  converting everything.
			
Installation and Use    : Unzip the file QNAME.ZIP into your quake\id1 directory.  You can then run QNAME.EXE from
			  either DOS or a Command Window.  The output is appended to the file QNAME.SCR in the same 
			  directory that QNAME.EXE is in, so it's necessary to have QNAME.EXE in quake\id1.
			  You can then have Quake use the name by either typing 'exec qname.scr' at the Quake 
			  console,  or by entering the line 'exec qname.scr' in your AUTOEXEC.CFG file.  Keep in
			  mind that each time you create a new name, it is appended to QNAME.SCR, so when Quake
			  reads it in, the LAST name always gets used.  You can use a previous name simply by 
			  editing this file and doing a cut/paste to move the desired name to the end of the list.
			  I would imagine that if the list gets too long, it might cause a slight delay in the 
			  startup of Quake, but I doubt it.  Just delete QNAME.SCR every once in a while.
			  I thought about just appending the name to the AUTOEXEC.CFG file, but that's a bit
			  risky, and I do not want people writing and telling me that I deleted their cfg files.
			
================================================================

Additional Credits to  	: id software for this most excellent game
			  'Demonstar' for his efforts (Name Fun)

================================================================


* Legal information *

This utility and source code are provided free of charge, and may be copied freely
so long as I, the author Matt Spaulding retain credit and all the original files remain
included and unchanged. 

If you want to include this utility on CD, BBS, FTP, WWW site, etc that's fine
by me so long as you do not charge for this utility and the original files and
documentation remains unchanged.

* Where to get this utility *

FTP sites:
ftp.cdrom.com/pub/idgames2/utils/misc  (eventually)
http://www.geocities.com/Yosemite/Trails/4611/
