CHANEDIT.EXE Information:  (For The Changeling v2.40 IGM)
=========================================================

IGM Utility:  The Changeling Player Database Editor (CHANEDIT)

CHANEDIT v1.00:  Official release done on Apr. 30th, 2008.

CHANEDIT v1.10:  Official release - not done yet.

Compile Date:  December 24, 2010.  v1.10.

Docs Rewrite:  December 24, 2010.

Status: Official release processing.
----------------------------------------------------------

This utility program was created by Donald Tidmore.
CHANEDIT is based upon the Chasware LPEdit utility.
------------------------------------------------------------

Dedications:  Charlie Wardick, creator of The Changeling IGM,
and my friend for 5+ years;  and to Jason Brown, creator of
The Gateway, LORD Cavern, Outlands Tavern, LordStat, LordType,
and RHPTest LORD IGMs and Utilities.
===========================================================


Section 1:  CHANEDIT USAGE NOTES:
------------------------------------------------------------
  Note 1:  CHANEDIT.EXE can only be used with v2.40, or with
  the v2.01+ Betas, of The Changeling IGM.

  Note 2:  For access to revise the LORD Player Number field,
  use the command CHANEDIT /DEBUG to run the Player Database
  Editor utility.  ** READ the Warning about this event's
  usage before using it!!  **

  Note 3: The only thing NEW in CHANEDIT v1.02+ beta is that
  it recognizes that users may visit the igm up to 20 times
  per day, whereas v1.00 used a Max Visits/Day of 15. 08/17/08.

  Note 4: 01/17/2010. Added Delete Player Record option.  Will
  only work if CHANEDIT is run in Debug Mode.
  ==========================================================

  Everyone is to use CHANED11.ZIP or CHANG240.ZIP, as of 02/23/09.

  The files inside CHANEDIT.ZIP and CHG2WORK.ZIP can always be used
  as well. The online copies will sometimes have newer documentation
  files such as the CCL-PROJ.TXT and CCL-APPS.TXT files, which are
  updated several times a month.
  ----------------------------------------------------------

  ** Obtain copy of the CHANED11.ZIP archive. Primary
     distribution sources are my Castle Camelot and Camelot
     LordNews FDN web-sites.  Along with the BBS Archives
     web-site's FTP server, the Nightfallgames.com server,
     and the LegendaryDragons.com FTP server.  The most
     up-to-date files will always be on the Castle Camelot
     site at http://camelot.legendarydragons.com/.

     See CHANEDIT.ZIP for documentation files updates that I
     periodically post to the Castle Camelot web-site.

     While program is in beta development, contact me for
     the latest IGM archives via email.
     ======================================================

  1) Unzip all files from CHANED11.ZIP (or CHANG240.ZIP) into
     your IGM directory, using overwrite mode.

	  E.g.:  pkunzip -n CHANG240 CHANEDIT.*  CHANG*.* -n
	  Or     pkunzip -n CHANED11    (or pkunzip -n CHANEDIT)

  2) Change into The Changeling IGM directory.  Verify you have
     a current CHANPLAY.DAT file.  If you don't, then you can't
     use CHANEDIT.EXE.

     The player database only tracks ONE day of IGM use.

     CHANEDIT can NOT be used without a CHANPLAY.DAT file.

  3) Notes on Player Database Restoration File:  CHANEDIT is
     not meant for use with the CHANBACK.DAT file.  But the
     file, once renamed to CHANPLAY.DAT, can be used with it
     since the two files use the same player database structure.

     Notice: CHANBACK.DAT is INTENDED only for use by the
     IGM itself for one purpose only:  Restoring the Player
     Database file during IGM operations if it gets deleted
     by accident or on purpose while the IGM is in use.

  4) CHANEDIT Config:  Revised 06/24/2008

     During the CHANGLNG Install process, CHANGLNG will create
     a CHANEDIT.CFG file for the user automatically, using the
     location that CHANGLNG.EXE is being executed from.

     The first time CHANEDIT is executed, if CHANEDIT.CFG does
     not exist -- in the directory you are running it from --,
	  the utility will ask you for the path to the Changeling IGM
     directory.  Type it in, and press ENTER to exit the dialog
     box prompt.  The CHANEDIT.CFG file will be created in the
     directory that you specified.

  5) Run CHANEDIT.EXE.  If a config file is not in the directory
     you run it from, it will ask you to create one - as noted
     above.  If config file is found, it then checks for existence
     of CHANPLAY.DAT file.  If one is not found, program will
     give error message and quit working.

     CHANEDIT has only one screen of data.  It shows database
     fields in the order they are listed in the player database
     record structure (usually).  Each value, with one exception,
     may be set to any value that is valid for it.

     The Lord Player Number field is display-only.  That is because
     I don't see any valid reason to allow users to fiddle around
     the LORD Player Number field.

     NOTES:   CHANGLNG.EXE is the ONLY program that is normally
     allowed to alter a player record's Player Number field, in
     regards to The Changeling IGM.

     --------------------------------------------------------
     Exception:  If the utility is run using the /DEBUG parameter,
     then the user is allowed to modify the value of the LORD
     Player Number.

     The user *MUST* use extreme caution in doing *ANY* changes
     to this field while using the CHANEDIT.EXE utility.

     Do *NOT* mess with the LORD Player Number variable's value
     UNLESS YOU KNOW ABSOLUTELY that it is invalid.  Use either
     DOS LORD's LORDCFG.EXE Player Database Editor or my Chasware
     LPEdit v1.40 utility to obtain the correct values *BEFORE*
     you try to change this IGM database stat's value.

     The IGM uses very specific program code in its IGM
     Maintenance process for correcting an invalid LORD Player
     Number stat's value.  Use CHANEDIT to do so *ONLY* if you
     are ABSOLUTELY sure that you know what you are doing!!!
     ---------------------------------------------------------

  6) When you exit CHANEDIT, it will resave the CHANPLAY.DAT
     file so that any changes you made will be accessible to
     the IGM.  Note that CHANEDIT will never access, or make
     changes to the Player Database Backup file CHANBACK.DAT.

  ------------------------------------------------------------
  7) Deleting Database Records.       {Added 01/17/2010}

  Chris Gosse has reported that he has a player who is using
  Werewolf II to become immune from attack in LORD or other
  IGMs, possibly by disconnecting from the BBS while the
  player is inside an IGM.

  I have added a Delete Player Record option to CHANEDIT so
  that sysops who have a valid reason to delete a player's
  record can do so.  To prevent the feature from being used
  accidentally, it will ONLY work if CHANEDIt is being executed
  in Debug Mode.

  This IGM only writes records to the CHANPLAY.DAT file for
  players who actually have used the IGM during the current
  game day - or on the day that the IGM was used last.
  --------------------------------------------------------

  CHANEDIT uses the X menu key code for its Delete Player
  Record process.  Once a record has been deleted, it is
  not physically deleted from the player database file until
  the next day when the IGM runs its Used_Stuff IGM Maintenance
  process (for the first time that day).

  No records are retained from the previous day in this IGM
  since it does not have a Sleep in IGM feature, or a Bank
  feature.  When Used_Stuff is run for the first time, the igm
  automatically deletes the old CHANPLAY.DAT file.  Then it
  creates a new file that contains a record for the player who
  has entered the IGM.

  Once a record has been marked as "DELETED" in CHANEDIT, the
  user can always restore the old values by typing them back
  in.  There is no "UNDO" system.  Only three fields need to
  be changed if you wish to reverse the Deletion:  Real Name,
  LORD Name, and LORD Player Number.

  Records marked as "* DELETED *" will simply be ignored by the
  IGM while it is in use.

  You should jot down info on a record on paper before you
  try to delete any record, in case you need to restore it
  later to its original settings.

  The user/sysop *MUST* VERIFY that they wish to Delete the
  current player's record before CHANEDIT will finish the
  Delete Record process.  Users MUST use either the NO option or
  CANCEL option if they wish to cancel the deletion process.
-----------------------------------------------------------------

8) Special Note.  If CHANEDIT is run in Debug Mode, the editor
   now shows [Debug Mode] on the screen's "Input key to change,
   or Q to Quit and Save." command line.   {Added 01/17/2010}
-----------------------------------------------------------------

  Created CHANEDIT.TXT file on May 07th, 2007.

  End of Notes for CHANEDIT usage.
==============================================================


Section 2:  CHANEDIT VERSIONS HISTORY:
------------------------------------------------------------

  CHANEDIT v1.00 official release was done on:  Apr. 30, 2008:
  --------------------------------------------------------------
  http://camelot.legendarydragons.com/LordApps/chaned10.zip
  http://www.filegate.net/camelot/lordfile/chaned10.zip
  ==============================================================

  CHANEDIT v1.10 official release was done on:
  --------------------------------------------------------------
  http://camelot.legendarydragons.com/LordApps/chaned11.zip
  http://www.filegate.net/camelot/lordfile/chaned11.zip
  ==============================================================


Section 3:  CHANEDIT DEVELOPMENT NOTES:
------------------------------------------------------------
	 -- CHANEDIT development started on May 07th, 2007.
	 -- Primary development was ended on Apr. 30, 2008.  (v1.00)

	 -- Secondary development started on Aug. 10, 2008.
         -- Secondary development cycle ended on _______________.

	 -- For usage only with the DOS LORD IGM.
	 -- Requires you to have a current CHANPLAY.DAT file.

  Distributed inside the CHG2WORK.ZIP and CHANEDIT.ZIP beta
  archives when the IGM is in beta development.

  Dedicated CHANEDIT.EXE to Seth Robinson, the creator of LORD;
  and to Charlie Wardick, the creator of The Changeling IGM.
==============================================================


Section 4:  The Changeling IGM Files Distribution:
------------------------------------------------------------

Official release program archives are posted here:

	 http://camelot.legendarydragons.com/lordapps.htm
====================================================

The betas, not always up-to-date online, are located here:

1) The Castle Camelot web-site:  Hosted by Gary Hartzell.
	http://camelot.legendarydragons.com/IGM-Beta/lgc-edit.zip
		Primary distribution point.

2) The Nightfallgames.com web-site:  Hosted by Michael Everett.
   http://www.nightfallgames.com/files/Igms/lgc-edit.zip

3) The BBS Archives web-site.
   http://archives.thebbs.org/ra98a.htm
   -- Door Games: LORD IGMs  (web-page uses frames)

   http://archives.thebbs.org/ra99a.htm
   -- Door Games: LORD Utils</A> --  (web-page uses frames)

4) The LegendaryDragons.com FTP server.  Not always up-to-date
   ftp://legendarydragons.com/lord/

   Currently, as of 09/21/2008, I am unable to post any new
   files to the FTP:://legendarydragons.com/lord/ sub-directories,
   so none of its files are current beyond July 2007.  I'm
   waiting for this situation to be resolved.

5) Shannon Talley's Fidotel BBS server.  Kept up-to-date every
   few months by me.
===================================================================


Section 5:  The Changeling Files Hyperlinks:
------------------------------------------------------------

  CHANEDIT v1.00 download links:
  ** Officially released on April 30th, 2008.
  -----------------------------------------------------
  (1)  http://camelot.legendarydragons.com/LordApps/chaned10.zip
       - Castle Camelot Lordapps sub-directory.

  (2)  http://www.filegate.net/camelot/lordfile/chaned10.zip
       - Camelot LordNews FDN's LordFile sub-directory.

  (3) BBS Archives server, hosted by Mike Ehlert.

		See Lord_Utils directory for CHANED10.ZIP archive.
-------------------------------------------------------------

  CHANEDIT v1.10 download links:
  ** Officially released on ______________.
  -----------------------------------------------------
  (1)  http://camelot.legendarydragons.com/LordApps/chaned11.zip
		 - Castle Camelot Lordapps sub-directory.

  (2)  http://www.filegate.net/camelot/lordfile/chaned11.zip
		 - Camelot LordNews FDN's LordFile sub-directory.

  (3) BBS Archives server, hosted by Mike Ehlert.

		See Lord_Utils directory for CHANED11.ZIP archive.

-------------------------------------------------------------
To obtain CHANG240.ZIP, simply use chang240.zip instead of
chaned11.zip, in those hyperlink URLs.  It contains ALL of
the IGM's program/documentation files, whereas CHANED11.ZIP
only contains the files used by CHANEDIT.

-------------------------------------------------------------
CHANEDIT v1.02+ Betas are as usual accessed using this URL:

	http://camelot.legendarydragons.com/IGM-Beta/chanedit.zip
-------------------------------------------------------------

CHANEDIT Files:  Copyright 2007-2011 by Donald Tidmore.
=============================================================


Section 6:  Source Code Distribution Notes:  {12/19/07}
------------------------------------------------------------

If you wish to see all of the Pascal source code files used
by the The Changeling programs, you may download the igm's
source code archive from the Castle Camelot web-site.

http://camelot.legendarydragons.com/IGM-Code/chg2code.zip

You are granted viewing rights only to these Pascal source
code files.  No one is allowed to use the source code files
on their own without my explicit permission, with the exception
of their usage to make similar LORD programs of your very own.
---------------------------------------------------------------

Usage of Charlie Wardick's Chasware Library is freely granted
to anyone who wishes to use it.  However, remember it is his
copyrighted property, and you do NOT have rights without his
permission to alter its CHASWARE.PAS, CHASWIGM.PAS, and
CHASATTR.PAS files.
-------------------------------------------------------------

Note: The TechnoJock's Gold Toolkit, which is no longer
supported or available for purchase online, is used to make
CHANEDIT.  If you wish to use my set of TPU files for it, let
me know.  Just be aware that its authors are not available for
technical support or product purchase/registration.
===============================================================


Section 7: The Changeling Files Copyright Information:
----------------------------------------------------
CHANGLNG.EXE:  Copyright pre-2005 by Charlie Wardick.
               Copyright 2005-2011 by Donald Tidmore.

CHANEDIT.EXE:  Copyright 2007-2011 by Donald Tidmore.

End of CHANEDIT.EXE documentation.
----------------------------------------

This file, along with the rest of The Changeling IGM files,
is Copyright 2005-2011 by Donald Tidmore.

All CHANEDIT.* files are Copyright 2007-2011 by Donald Tidmore.
=============================================================

Created CHANEDIT.TXT on May 07th, 2007.

Chanedit.txt was completely rewritten on Apr. 30th, 2008.

Revised on:   December 24, 2010 at 03:00 am.

