         ChasWare LPEDIT Marriage/Divorces Docs File:
         Used by ChasWare LPEdit and ChasWare LPEdit/32.
         ===========================================

         Covers: ChasWare LORD Player Editor v1.00.
                 Chasware LPEdit v1.20, v1.30, and v1.40.

                 LPEdit/32 v0.85 Beta (for LORD/32 Beta)
         =====================================================

         *---* Castle Camelot LORD Apps *---*

         Copyright 2002-2010 by Donald Tidmore for LPEDIT.EXE.
         Copyright 2005-2010 by Donald Tidmore for LPEDIT32.EXE.
         =====================================================

         LPEDIT (and LPEDIT/32) Marriage Scenarios:
         =====================================================
         1) Single Player-Single Player.              WTF 1.
         2) Single Player-Married Player.             WTF 2.
         3) Married_ToViolet - Does divorce.          WTF 3.
         4) Married_ToSeth   - Does divorce.          WTF 4.
         5) Married Player -  Single Player.          WTF 5.
         6) Married Player -  Married Player.         WTF 6.
         7) Married Player -  Violet.                 WTF 7.
         8) Married Player -  Seth Able               WTF 8.
         9) Single - Violet.                          WTF 9.
         10) Single - Seth Able.                      WTF 10.
         ==================================================

         11) Married_ToViolet-Single                  WTF 11
            - Married Player wishes to divorce Violet,
              then marry a Single Player.
         12) Married_ToSeth-Single                    WTF 12
            - Married Player wishes to divorce Seth
              Able, and then marry a Single player.
         13) Married_ToViolet-Married Player          WTF 13
            - Married Player wishes to divorce Violet,
              and marry another Married Player.
         14) Married_ToSeth-Married Player            WTF 14
            - Married Player wishes to divorce Seth Able,
              and marry another Married Player.
         15) Married Player-Violet_IsMarried          WTF 15
            - Married Player wishes to marry Violet,
             who is already married to another player.
         16) Married Player-Seth_IsMarried            WTF 16
            - Married Player wishes to marry Seth Able,
            who is already married to another player.
         17) Married_ToViolet - Married_ToSeth        WTF 17
            Player married to Violet wants to marry the
            player who is currently married to Seth Able.
         18) Married_ToSeth - Married_ToViolet        WTF 18
            Player married to Seth Able wants to marry the
            player who is currently married to Violet.
         19) Single-Married_ToViolet                  WTF 19
            Single player wishes to marry player who is
            married to Violet.
         20) Single-Married_ToSeth                    WTF 20
            Single player wishes to marry player who is
            married to Seth Able.
         ==================================================

         21) MarriedPlayer-Married_ToViolet           WTF 21
            Married player wishes to marry player who
            is married to Violet.
         22) MarriedPlayer-Married_ToSeth             WTF 22
            Married player wishes to marry player who
            is married to Seth Able.
         23) Single-Violet_IsMarried                  WTF 23
            Single player wishes to marry Violet,
            who already is married.
         24) Single-Seth_IsMarried                    WTF 24
            Single player wishes to marry Seth Able,
            who already is married.
         =========================================

Notations for Sysop user:
    First off, DOS LORD and LORD for Windows both are applicable
    in this file whenever you see "LORD" referred to.  Both
    programs work identically in many ways, such as in their
    handling of Marriages between LORD Players and/or NPCs.
    ==========================================================

    The program will do forced player marriages and divorces.
    It is up to YOU whether you wish to do them.  In most cases,
    I do not personally advocate a third party being able to
    force another player to be divorced, then marry them.  But
    there may some IGMs already available from years ago, which
    do similar things, just not in one single step perhaps.

    At any rate, use the forced divorce/wedding feature wisely.
    And be prepared to justify your action to any BBS player who
    did not request the action.  Coding all of this was a challenge.
    So once done, I don't wish to undo all of it.  But I do have
    to make this warning - Usage of forced divorce is YOUR
    responsibility, not mine.

    Likewise, the program will allow player A (male) to marry
    player B (male) -- or two females relationships -- and will
    warn you of Same-Sex marriage situation.  It is up to the
    user to decide whether to continue with the marriage.  Or
    to first change the Sex field of one player to make situation
    a normal marriage.

    When someone requests marriage to an NPC, they are NOT allowed
    to do same-sex marriage.  If player is male, they WILL be
    matched with Violet.  If female, they get married to Seth Able.
    LORD itself won't allow same-sex marriage to an NPC, so neither
    will LPEdit.
    ==================================================


Warning:  In LPEDIT/32, once you start a Marriage or Divorce,
    there is no way to cancel it as there is in LPEDIT v1.40.
=============================================================


Wedding announcements:
    Each player being married by Sysop is notified via LORD Mail
    of their new wedding.  Each wedding is announced in LORD News.

Divorce announcements:
   Each player who is divorced loses 50% of their Charm automatically.
   Each divorced party is notified via LORD mail message, and there
   is one announcement made in LORD News for each divorce.

NPC Handling:
   When simple divorce features Violet, the marrage.dat file is deleted.
   Thereby making the married player Single.  If it is simple divorce
   with Seth Able, the marbard.dat is deleted.

   If divorce/marriage involves Violet, the original marrage.dat is
   deleted.  Then a new one is created, including the player number
   of the new player spouse for Violet.  Ditto with Seth Able, except
   that it involves marbard.dat file.

   If a complex marriage request involves both NPCs, both marrage.dat
   and marbard.dat are altered to match the circumstances.  One or
   both files will be recreated or deleted.

Marriage feature testing:
   Testing all 24 marriage situations will result in a LOT of entries
   in your Lognow.txt file, and a LOT of entries in the mail*.dat files
   for ALL involved players.

Documentation file was spell checked on March 20, 2004.
===========================================================


Notes:  LPEDIT/32 is ONLY supported directly for usage with
    the LORD for Windows (LORD/32) game, on a system that is
    running a 32-bit version of Microsoft Windows, ranging
    from Windows 95 through Windows XP.

    No support of any kind is offered for users of OS/2, Linux,
    or Microsoft Vista.  I have no knowledge of how either of
    the operating systems handle DOS programs such as LPEDIT
    v1.40, or whether they will run programs like LPEDIT/32.
    ==========================================================


                     Revison Notes - LPEDIT for DOS LORD:
=========================================================
-- LPEDIT v1.20 - No changes made to the Marriage/Divorce code.

-- LPEDIT v1.30 - No changes to Marriage/Divorce code.

-- LPEDIT v1.40 - No changes to Marriage/Divorce code.
##########################################################


Revision Notes - LPEDIT/32 for LORD/32:
=========================================================
-- LPEDIT/32 - Because Virtual Pascal could not the original
   utility's Gold Toolkit processes, the LORD/32 Version of
   LPEdit has to use traditional code for asking the user
   for input, processing that input, and then processing
   the results.  So it does not have any pretty (and VERY
   useful) dialog boxes, as a result.

   It also looks a lot different than its DOS "parent" does,
   including such changes as it having all of the Skill
   Points and Skill Use Points menu lines on the secondary
   menu screen.  Otherwise, LPEDIT/32 works just like LPEDIT
   always has worked.  You simply can't use LPEDIT v1.40
   with LORD/32 beta, or LPEDIT/32 Betas with DOS LORD.

   =========================   WARNING:  ======================
   DOS LORD v4.06+ versions and the 32-bit LORD versions both
   use PLAYER.DAT.  As long as user is using the current version
   of both games, it so far is possible to use the same PLAYER.DAT
   file with both of them.  At least in my personal experience.
   However, I do not recommend anyone else doing that, without
   making backups of their old play*.dat files, and then doing
   a LOT OF TESTING.

   Both DOS LORD and the 32-bit versions do however have some
   characteristics that are 100% compatible with each other.
   Both use LOGNOW.TXT, MARBARD.DAT and MARRAGE.DAT files.

   But they use completely different 3RDPARTY.DAT file formats.

   And DOS LORD and the 32-bit versions read/write data in
   MAIL files in the same way.
   ======================================================

ChasWare LPEDIT v1.40 was officially released on May 14th, 2007.
Online distribution was done on May 14th, 2007.

I have not decided yet when Chasware LPEDIT/32 will be ready
for official release, as of mid-May 2007.  However, the program
works properly in all of my tests, and can be considered by
the end-user as a finished program.

{END}   File revised on:   January 25, 2010 at 02:49 am.

