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/02/2008.

Compile Date:  August 31, 2008.

Docs Revision:  September 03, 2008.

** SHOPEDIT.EXE uses a 12/22/2007 Player Database structure.

------------------------------------------------------------
Actual release of SHOPEDIT v1.10 online was done on Sept. 02nd,
2008 to the Nightfallgames.com server, BBS Archives server,
and Fidotel BBS server.  Final distribution will be done on/around
Sept. 04-05, 2008 to the Camelot LordNews FDN and Castle Camelot
web-site.   The PAWNCONV.* files were added to Shoped11.zip
on Sept. 01th, 2008.
===========================================================


Section 1:  SHOPEDIT Program Usage Notes:  {08/08/08 rewrite}
------------------------------------------------------------
  Note 1:  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. **

  Note 2: The Pawn Shop v4.00's official release was finished
  on Sept. 05th, 2008.  Use only the IGM files in the PAWN400.ZIP
  and SHOPED11.ZIP distribution archives.  09/05/2008.
  ===========================================================

  ** Obtain copy of the SHOPED11.ZIP distribution archive,
     and/or the SHOPEDIT.ZIP work archive.  SHOPEDIT.EXE v1.10
     prepared and released officially along with Pawn Shop v4.00
     using SHOPED11.ZIP archive on 09/05/2008.  Fidonet hatching
     and other online distribution of both archives will be done
     on 09/05/2008.

     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 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)
    -- Documentation edits finished for v1.10 on Sept. 03, 2008.
===============================================================


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:  Sept. 03, 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: 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.
    URL for up-to-date Pawnconv.* files:

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

      http://camelot.legendarydragons.com/LordApps/shoped11.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.
=================================================================


Section 4:  The Pawn Shop IGM Files Distribution:
Rewrote 09/05/2008.
------------------------------------------------------------

  Official distribution was done Sept. 05th, 2008 using
  SHOPED11.ZIP archive, for SHOPEDIT v1.10.

  v1.10 distribution notes:  Posted SHOPED11.ZIP on the
  Nightfallgames server on Sept. 02nd, 2008.  Posted archive
  on Castle Camelot web-site server on Sept. 02nd, 2008.  Posted
  archive on BBS Archives FTP server on Sept. 02nd, 2008.

  Upload of SHOPED11.ZIP to Camelot LordNews FDN server will
  be done on Sept. 06th, 2008.  That copy will be the final
  revision of SHOPEDIT v1.10.
  -----------------------------------------------------------

  http://www.filegate.net/camelot/lordfile/shoped11.zip
  http://camelot.legendarydragons.com/LordApps/shoped11.zip
  - Only contains PAWNCONV and SHOPEDIT files.

  http://www.filegate.net/camelot/lordfile/pawn400.zip
  http://camelot.legendarydragons.com/LordApps/pawn400.zip
  - Contains all of Pawn Shop program files, excluding Pawnconv.
------------------------------------------------------------

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/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/

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


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)  BBS Archives server, hosted by Mike Ehlert;  and the
       Fidotel BBS server, hosted by Shannon Talley.

  (4)  Nightfallgames.com server, hosted by Michael Everett.
       http://www.nightfallgames.com/files/Utils/shoped10.zip

  ------------------------------------------------------------
  ** 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. 05th, 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)  BBS Archives server, hosted by Mike Ehlert;  and the
       Fidotel BBS server, hosted by Shannon Talley.

  (4)  Nightfallgames.com server, hosted by Michael Everett.
       http://www.nightfallgames.com/files/Utils/shoped11.zip
  ------------------------------------------------------------

  Note: The Pawn Shop v4.00 is officially released,
  as of Sept. 05, 2008.  Primary distribution sources include
  these five sources:

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

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

  (3)  BBS Archives server, hosted by Mike Ehlert;  and the
       Fidotel BBS server, hosted by Shannon Talley.

  (4)  Nightfallgames.com server, hosted by Michael Everett.
       http://www.nightfallgames.com/files/Igms/pawn400.zip
  ----------------------------------------------------------

  PAWN400.ZIP contains the updated documentation and program
  files used by the SHOPEDIT.EXE v1.10 program, but not those
  for PAWNCONV.  Those are in the SHOPED11.ZIP archive.
===============================================================


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.

Spell checking done Sept. 05, 2008 at 10:29 pm.
=============================================================

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

Revised on:   September 05, 2008 at 10:29 pm.

