2.0:     SHOPEDIT.EXE Information  {Revised 05/06/2006}
===================================================

IGM Utility:  Pawn Shop Player Database Editor (ShopEdit)

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

ShopEdit v1.00 -- Official release was done on 12/02/2006.
          ** Official distribution was done on 12/04/2006.

ShopEdit v1.10 -- Official release was done on 08/31/2008.
          ** Official distribution was done on 09/01/2008.

Compile Date:  August 31, 2008.

    ** Now uses 12/22/2007 Player Database structure.

------------------------------------------------------------
Actual release of SHOPEDIT v1.10 and Pawn Shop v4.00 archives
will be done sometime on Sept. 02, 2008.  I've added the
PAWNCONV.* files to Shoped11.zip as well.
===========================================================


Section 1:  SHOPEDIT Program Usage Notes:  {08/08/08 rewrite}
------------------------------------------------------------
  Note:  For access to revise the LORD Player Number field,
  use the command SHOPEDIT /DEBUG to run the Player Database
  Editor utility.  ** READ the Warning about using /DEBUG
  parameter before you use it. **
  ===========================================================

  ** Obtain copy of the SHOPED11.ZIP distribution archive,
     and/or the SHOPEDIT.ZIP work 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.  Periodically,
     I will also update the Fidotel BBS's FTP Server with the
     newest official release and beta archives of my programs.

     The most up-to-date files will always be on the Castle
     Camelot site at http://camelot.legendarydragons.com/.

     See SHOPEDIT.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) SHOPEDIT Config:

     During the PSETUP Config process, if the user Installs the
     IGM or does a re-install, PSETUP will now automatically
     create a SHOPEDIT.CFG file for the user, using the location
     that PSETUP.EXE is being executed from.

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

     If you're updating from one version of SHOPEDIT to a newer
     one, they all use the same SHOPEDIT.CFG file.  Its format
     will never change.  SHOPEDIT does not use PAWN-USE.TXT,
     PAWNSHOP.DAT, or PSLIMITS.CFG.  It also does not directly
     use the PAWNBACK.DAT Player Database Backup file.

     Notice: PAWNBACK.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.

  2) SHOPEDIT 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.

     (1) The Lord Player Number field is display-only.  That is
     because I don't see any valid reason to allow users to
     fiddle around with it.

     NOTES:   PAWNSHOP.EXE is the ONLY program that is normally
     allowed to alter a player record's Player Number field,
     in regards to the The Pawn Shop IGM.  Nothing in PSETUP.EXE
     is allowed to alter the Player Number field for any reason.

     --------------------------------------------------------
     Exception:  If the utility is run using the /DEBUG parameter,
     then the user is allowed to modify the value of the LORD
     Player Number.  Now and then, IGMs do screw up and use the
     wrong value.  Or LORD may have been reset, and players now
     have new Player Numbers assigned to them.

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

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

     Pawnshop.exe's IGM Entry sequence contains code that will
     handle changing an invalid PlayNum field, as long as the
     player is correctly identified using their LORD Real Name.

     Use SHOPEDIT to alter the LORD Player Number value used in
     a player's IGM Database record *ONLY* if you are ABSOLUTELY
     sure that you know what you are doing!!!
     ---------------------------------------------------------

  3) When you exit SHOPEDIT, it will resave the PAWNPLAY.DAT
     file so that any changes you made will be accessible to
     the IGM.

Note: Even if you just view records in SHOPEDIT, without changing
    a single value, the editor utility will still resave the
    PAWNPLAY.DAT file when you exit.  The program has no way
    to know if the user changed values in the records or not.

  ========================================================
  SHOPEDIT does not have a "Delete Record" option.  Only my
  IGMs Hiding In The Shadows, Kiteria's LORD Bank, LORD Skeleton,
  Outlands Tavern, Outlands Skeleton, and Realm of Lore which
  allow players to sleep in the IGM overnight, or which have
  IGM Banks, have this option in their Player Database Editors.

  Although Pawn Shop does allow the Shop Owner and Shop Owner's
  Spouse to sleep in the igm overnight, I did not consider it
  to need the "Delete Record" option.

End of Notes for SHOPEDIT usage.
-------------------------------------------

For further data regarding SHOPEDIT, see supplemental appendix
documentation file, PS40READ.TXT.
--------------------------------------------------------------


Section 3:  SHOPEDIT DEVELOPMENT NOTES:
------------------------------------------------------------
    -- Initial development started on July 14th, 2005.
    -- Initial Development cycle ended on Nov. 30, 2006. (v1.00)

    -- For usage only with the DOS LORD IGM.

    -- Shopedit Requires you to have a current PAWNPLAY.DAT file.
       The file *MUST* have been made by Pawnshop.exe v3.98+ Beta.

    -- You also need to be using v3.98+ of the IGM, or
       a PAWNSHOP.EXE file dated on/after Dec. 22, 2007.
    ----------------------------------------------------------

    -- Secondary development started on Oct. 15, 2007.
    -- Secondary development ended on Aug. 31th, 2008. (v1.10)
===============================================================


Section 3-B:  SHOPEDIT Versions Info:
==============================================================

  V1.00 official release done using SHOPED10.ZIP:  Dec. 02, 2006:
  --------------------------------------------------------------
  http://camelot.legendarydragons.com/LordApps/shoped10.zip
  http://www.filegate.net/camelot/lordfile/shoped10.zip
  --------------------------------------------------------------

  V1.10 official release done using SHOPED11.ZIP:  Aug. 31, 2008:
  --------------------------------------------------------------
  http://camelot.legendarydragons.com/LordApps/shoped11.zip
  http://www.filegate.net/camelot/lordfile/shoped11.zip
  ==============================================================


Section 3-C:  Dedication, Misc Info:
==============================================================
    Note 1: As of 09-28-2005, Shopedit's dedication
            is to the memory of John Wayne.

    Note 2: PawnConv files are no longer distributed with the
            Shopedit.zip or Pawnwork.zip archives.  If you want
            them, you can download the archvie from this URL:

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

    The PSCONV10.ZIP archive will not be updated with newer
    IGM files.  The pawnconv.txt file has periodically been
    revised during Pawn Shop v4.00's development period, and
    can be obtained inside the PAWNCONV.ZIP archive.

    Note 3: The up-to-date PAWNCONV.TXT file is included inside
    the SHOPED11.ZIP archive, as of 09/01/2008, for everyone's
    convenience.  The PAWNCONV.DIZ file is also updated.

    http://camelot.legendarydragons.com/LordApps/shoped11.zip
=================================================================


Section 4:  The Pawn Shop IGM Files Distribution:
------------------------------------------------------------

Official release program archives are posted here:

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

  Beta download links:
  ---------------------
  http://camelot.legendarydragons.com/IGM-Beta/shopedit.zip
  -- Contains the PAWNCONV.* and SHOPEDIT.* files.

  http://camelot.legendarydragons.com/IGM-Beta/pawnwork.zip
  -- Primary IGM distribution archive.
============================================================

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/shopedit.zip
      Primary distribution point.

2) The Nightfallgames.com web-site:  Hosted by Michael Everett.
   http://www.nightfallgames.com/files/Igms/shopedit.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/
===================================================================


Section 5:  The Pawn Shop Files Hyperlinks:
------------------------------------------------------------

  SHOPEDIT v1.00 download links:
  ** Officially released on December 02nd, 2006.
  -----------------------------------------------------
  (1)  http://camelot.legendarydragons.com/LordApps/shoped10.zip
       - Castle Camelot Lordapps sub-directory.

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

  (3) Also available from Mike Ehlert's BBS Archives server.

  ------------------------------------------------------------
  ** NOT compatible with Pawn Shop v3.95+ betas.   {10/15/07 note}
  Use only SHOPEDIT v1.02+ Betas with Pawn Shop v3.95+ betas.
  ===================================================================


  SHOPEDIT v1.10 download links:
  ** Officially released on August 31th, 2008.
  ** Online distribution done on Sept. 02nd, 2008.

  -----------------------------------------------------
  (1)  http://camelot.legendarydragons.com/LordApps/shoped11.zip
       - Castle Camelot Lordapps sub-directory.

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

  (3) Also available from Mike Ehlert's BBS Archives server.

  All SHOPEDIT files are included inside the pawn400.zip archive.
  The primary URL for it is:

    http://camelot.legendarydragons.com/LordApps/pawn400.zip
----------------------------------------------------------------

I will not post SHOPED11.ZIP to Fidonet until I am ready to
distribute PAWN400.ZIP also.  However, Shopedit v1.10 *IS*
now officially released as of Aug. 31th, 2008.  And as noted
already, I have added the PAWNCONV.* files to shoped11.zip.
09/01/2008 edit.
===============================================================


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 Pawn Shop programs, you may download the igm's
source code archive from the Castle Camelot web-site.

http://camelot.legendarydragons.com/IGM-Code/pawncode.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.
---------------------------------------------------------------

{08/08/2008:] Anyone who wishes to make a 32-bit IGM version
of The Pawn Shop can contact me via email to discuss it.  I
have no plans myself to ever make one since (a) no one ever
has asked for one, (b) no one bothers to help beta test my
current Free World II and Chasware Lpedit/32 LORD/32 programs,
and (c) I don't know if the PSETUP.EXE program could be
altered to work reliably under LORD/32 for Windows.
=============================================================

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
SHOPEDIT.  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.

I can not provide technical support to anyone who uses my igms
on Linux or OS/2 systems that are able to run DOS programs.
I have no Linux or OS/2 systems to test programs on, and have
no Linux or OS/2 programming experience.  I can ONLY support
usage of this IGM on MS-DOS and Windows computer systems,
excluding Windows Vista which won't run most DOS programs.
===============================================================


Section 7: The Pawn Shop Files Copyright Information:
----------------------------------------------------
Pawn Shop Files (PAWNSHOP.EXE, PSETUP.EXE):
    Copyright 1997-2006 by Chris MacPherson.
    Copyright 2002-2006 by Chris MacPherson and Donald Tidmore.
    Copyright 2002-2008 by Donald Tidmore.

SHOPEDIT Files:  Copyright 2005-2008 by Donald Tidmore.

PAWNCONV Files:  Copyright 2006-2008 by Donald Tidmore.

End of SHOPEDIT.EXE documentation.
----------------------------------------
           
This file, along with the rest of The Pawn Shop IGM files,
is Copyright 2005-2008 by Donald Tidmore.

All SHOPEDIT.* files are Copyright 2005-2008 by Donald Tidmore.
=============================================================

Shopedit.txt was completely rewritten on Dec. 18th, 2007.

Revised on:   September 01, 2008 at 09:30 pm.

