
Find your version in the headers below and *READ* what you need to do to
upgrade.  Also review the WHATSNEW.TXT for additional information.

**ALWAYS DO A BACKUP OF YOUR BBS BEFORE PERFORMING AN UPGRADE**

If you wish to go from 1.09 to 1.10 directly, please contact me at
mysticbbs@gmail.com.  Otherwise you must follow the ALPHA paths
listed below.  At this time there are NO known 1.09 SysOps so the
direct upgrade path has not been created.

UPGRADING FROM ALPHA 31 TO ALPHA 32
======================================
- Replace all binaries ONLY (not MYSTIC.DAT, etc) - (dont forget MPLC/MIDE!)
- Recompile all MPL programs (MPLC -all in SCRIPTS if using defaults)
- Add prompts #509-512 to all themes (aka default.txt, etc)
- Recompile all themes with MakeTheme - validate success!

UPGRADING FROM ALPHA 30 TO ALPHA 31
======================================
- Replace MYSTIC.EXE binary with new one
- Replace MUTIL.EXE binary with new one

UPGRADING FROM ALPHA 29 TO ALPHA 30
======================================
- Replace all binaries
- Recompile all MPL programs
- Note new executable FIDOPOLL.EXE if
  you want to use internal BINKP stuff
- Reconfigure BBS-events if you used them (sorry)
- Optionally delete event.dat from DATA it is no
  longer used.

UPGRADING FROM ALPHA 28 TO ALPHA 29
===================================
- Replace all binaries
- Update prompt #490
- Recompile themes with MakeTheme
- Recompile all MPL programs

UPGRADING FROM ALPHA 27 TO ALPHA 28
===================================
- Replace all binaries
- Replace prompt #490 with new one
- Add prompts #504 through #508
- Recompile themes with MakeTheme
- Recompile all MPL programs (mplc -all in scripts directory, etc)

UPGRADING FROM ALPHA 26 TO ALPHA 27
===================================
- Replace all binaries
- Copy your raw nodelist to nodelist.txt in the DATA directory (if you
  have one) for the new nodelist browser.
- Copy nodesearch.asc from the default install's TEXT directory into your
  text directory.
- Add new prompts #496 - #503 (see end of file)
- Recompile prompts using MakeTheme.  Verify that it was successful.

UPGRADING FROM ALPHA 25 TO ALPHA 26
===================================
- Replace all binaries
- For each theme replace prompts #66,67 with the prompts below.  If you
  are not sure, that means replacing them inside of default.txt.
- For each theme add new prompts #494,495 found below.
- Recompile all theme prompt files using MakeTheme.
- If you want to see demos of the LightBar/Prompt menus look for
  testlbprompt.mnu in the new default install menu directory.

UPGRADING FROM ALPHA 24 TO ALPHA 25
===================================
Replace all binaries

UPGRADING FROM ALPHA 23 TO ALPHA 24
===================================
Copy nodespy.ini into the directory where you have NodeSpy.

If you are still using A22 you can follow the instructions
below to upgrade directly from A22 to A24.

UPGRADING FROM ALPHA 22 to ALPHA 23
===================================
Install to a temp directory
Copy over all binaries (dont forget mide/mplc!)
Recompile all MPL programs
Copy ansiviewer.ans into your TEXT directories
Copy ansigalv.ans into your TEXT directories
Copy new blackjack.mps over your old one
*IMPORTANT* Execute "mbbsutil -fixindex" in your root mystic dir

UPGRADING FROM ALPHA 21 TO ALPHA 22
===================================
Copy over all binaries

UPGRADING FROM ALPHA 20 TO ALPHA 21
===================================
Copy over all binaries
Delete MYSTPACK
(mUTIL now can pack message bases)

UPGRADING FROM ALPHA 19 TO ALPHA 20
===================================
Copy over all binaries.
Recompile MPL programs
Review new MUTIL configuration additions

UPGRADING FROM ALPHA 18 TO ALPHA 19
===================================
Copy over all binaries.
Recompile MPL programs (you might need to fix includes see whatsnew)
Newer version of USAGE.MPS too

UPGRADING FROM ALPHA 17 TO ALPHA 18
===================================

Copy over all binaries
Recompile your MPL programs using MPLC -all or whatever

New program called NODESPY is now included
Updated some MPL (to-prompt, usage, etc)

UPGRADING FROM 1.10 ALPHA 15/16 to 1.10 ALPHA 17
=============================================

This should be a simply binary replacement.  Simply perform the
installation to a temporary directory and then copy over the
newer binaries (don't forget MPLC and MIDE in the scripts directory).

Also, MIDE now has a configuration file (mide.ini) that you may wish
to copy from the new install.

Recompile your MPL programs just to be safe.  I can't remember if
that needs to happen for this version or not.

Note that this version has internal Zmodem, but it still has some
problems with certain clients.  It may be best to stick with SEXYZ
or some other protocol driver for now.

If you are using something PRIOR to alpha 15, you need to find the
correct section to get to that level.


UPGRADING FROM 1.10 ALPHA 11 - 14 TO 1.10 ALPHA 17
==================================================

If you are upgrading from 1.10 ALPHA 11-14 then you need to replace
all of the binaries, recompile all MPL programs (mplc -all), and
add/recompile new prompts.

*IN ADDITION* THIS IS VERY IMPORTANT

You will need to copy CvtMenus to your menus directory and run it only once
so that your menu files are converted to the format used in ALPHA 15+.  Once
this is done you can delete this program.

Also, there are new versions of BlackJack.mpl and Usage.mpl and also TO-PRMPT
is now included in the Mystic distribution.


UPGRADING FROM 1.09 TO 1.10 ALPHA 17
====================================

The following instructions are for upgrading your current *1.09* release of
Mystic BBS.

!!! THIS IS A SIGNIFICANT UPGRADE YOU WILL NEED TO MAKE A FULL BACKUP OF YOUR
!!! CURRENT SYSTEM IN CASE THERE ARE PROBLEMS.

In addition, the MPL language has significantly changed in this release.  If
you are using a lot of MPL modules, they will need to be upgraded to new
versions.  The MPL syntax has been standardized to be consistant with Pascal
compilers, so the syntax will not be changing every couple of releases as it
has in the past.  It is a bunch of work now, but it means we won't be doing
this again in the future!

1. Install Mystic 1.10 into a temporary directory.

2. Copy the following files from the temporary install directory to your
   BBS directory (replacing old executables where needed):

      MYSTIC.EXE
      MAKETHEME.EXE
      MBBSUTIL.EXE
      MUTIL.EXE
      MUTIL.CFG
      109TO110.EXE
      MYSTPACK.EXE
      MIS.EXE

3. Copy the following files from your temporary install SCRIPTS directory
   into your BBS scripts directory (replacing old stuff).

      MPLC.EXE
      MIDE.EXE
      BBSLIST.MPS
      BULLETIN.MPS
      MPLDEMO.MPS
      MPLTEST.MPS
      BLACKJACK.MPS
      BLACKJACK.ANS
      RUMORS.MPS
      USAGE.MPS

4. Run MPLC -ALL in your BBS scripts directory to recompile all of your
   MPL programs.  If you use custom MPL programs some may not compile and
   will need to be upgraded.

5. Copy CFGROOT.ANS from your temporary install DATA directory into your
   BBS data directory.

6. For each "language" you have installed (usually just default.txt) you
   will need add new prompts listed at the end of this file.  default.txt
   is found in your root BBS directory.

7. For each "language" you have installed (usually just default) you will
   need to recompile the prompts using MAKETHEME.  Do *NOT* use the old
   MAKELANG as it no longer is used with Mystic BBS.

     MakeTheme compile default.txt

8. Copy ANSIGALH.ANS and ANSIGAL.ANS from the temporary install's TEXT
   directory into your BBS TEXT directory.

9. In your main BBS directory execute 109to110.EXE *MAKE SURE IF YOU ARE
   RUNNING AN OPERATING SYSTEM THAT USES FILE SECURITY THAT YOU HAVE FULL
   ACCESS TO ALL FILES IN YOUR BBS DIRECTORIES.  IF YOU DO NOT THE UPGRADE
   WILL FAIL AND YOU WILL HAVE TO RESTORE AND START OVER*

10. Delete 109to110.exe

11. Copy CvtMenus program into your menus directory and run it ONE TIME ONLY
    so that it will convert your menu files.

12. Delete CvtMenus.exe

13. Notes: The install program will attempt to delete the following unused
    programs and files: wfcscrn.* from DATA, makelang.exe, mcfg.exe,
    *.lng from DATA, node*.dat from DATA.  If these files still exists for
    some reason they should be deleted.  *MCFG AND MAKELANG ARE NO LONGER
    USED WITH MYSTIC*




VERSION PRIOR TO 1.09
=====================

If you are using 1.07 you must upgrade to 1.08, and then 1.09 using those
upgrade packages.  And then you can follow the instructions for 1.09 to
the latest alphas above.

IF you are using 1.08 ALPHAs you must FIRST upgrade to 1.08 full release,
and then to 1.09 before following the instructions above.




; ==== [ REPLACED PROMPTS 1.10 ] ==========================================

; Disconnect after download?
066 |CR|12Disconnect after file transfer? |11

; Disconneting in 10 seconds, press a key to abort
067 |CR|09Disconnecting in 10 seconds: Press a key to abort.



; ==== [ NEW PROMPTS 1.10 ] ===============================================

; ansi gallery: Ansi is required to use this prompt
466 |CRSorry, this gallery requires ANSI graphics|CR|CR|PA

; ansi gallery: Deselected file in list (bar OFF)
; &1=filename     &2=filesize  &3=filedate  &4=sauce author  &5=sauce title
; &6=sauce group  &7=filetime
467 |[X02|07|16 |$R49|&1 |$R12|&6 |$R12|&4 |XX

; ansi gallery: Selected file in list (bar ON)
; &1=filename     &2=filesize  &3=filedate  &4=sauce author  &5=sauce title
; &6=sauce group  &7=filetime
468 |[X02|15|17 |$R49|&1 |$R12|&6 |$R12|&4 |XX

; ansi gallery: Deselected DIRECTORY in list (bar OFF)
; &1=filename     &2=filesize  &3=filedate  &4=sauce author  &5=sauce title
; &6=sauce group  &7=filetime
469 |[X02|07|16 |$R49|&1 |12<DIRECTORY>|$D15 |XX

; ansi gallery: Selected DIRECTORY in list (bar ON)
; &1=filename     &2=filesize  &3=filedate  &4=sauce author  &5=sauce title
; &6=sauce group  &7=filetime
470 |[X02|15|17 |$R49|&1 |12<DIRECTORY>|$D15 |XX

; ansi gallery: Current path update prompt (when switching directories)
; set to blank to not display a path (automatically excludes the root)
; &1 = current path   &2 = # of files in path
471 |[X08|[Y05|15|16|$R70|&1

; ansi gallery: Percent bar update (when redrawing page)
; Set to blank to not display a bar.  Bar config is in MCFG lang settings
; &1 = Percentage bar   &2 = Percentage (0-100)
472 |[X52|[Y23|15|16|$L03|&2|07% |&1

; ansi gallery: Default sauce values for no sauce record.  3 words separated
; by semi-colons: Title;Author;Group  IE: Unknown;Unknown;Unknown
473 Unknown;Unknown;Unknown

; ansi gallery: Command prompt for ! (only download for now)
474 |CR|12Download |&1? |XX

; Password inquiry prompt
475 |CR|12Send a password inquiry message to the SysOp? |XX

; Displayed when account expired down to a security level > 0
476 |CR|14Your account has expired.  Downgrading security to |XS.

; Displayed when account expired down to level 0 (delete)
477 |CR|12Your account has expired and is now marked for deletion.

; User required password change
478 |CR|14This BBS requires a password change every |PW days.

; User2User chat page which node?
479 |CR|09Enter node to chat with |01[|10?|01/|10List|01]|09: |XX

; User2User node/user is unavailable
480 |CR|15That user is marked unavailable.|CR|CR|PA

; User2User force user into chat?
481 |CR|12Force user into chat? |XX

; User2User sending chat request &1=User &2=Node
482 |CR|15Sending chat request to |&1...|DE|DE|CR

; User2User chat mode starting
483 |CL|09|17  |15Chat mode engaged.|$X70 ESC/Quit |16|CR

; User2User chat mode ended
484 |CL|09|17  |15Chat mode end.|$X79 |16|DE|DE

; User2User accept chat page request? &1=user &2=Node
485 |CL|15|&1 is requesting private user chat.  Accept? |11

; MsgBase quickscan header prompt
486 |CR|12Starting Quick Scan|CR

; MsgBase quickscan Scanning prompt
; &1=basename  &2=current base#  &3=total bases#
487 Scanning |&1 [|&2 of |&3]...

; MsgBase quickscan base list prompt
; &4=msgs in base    &5=new messages  &6=your messages  &7=global total msg
; &8=global new msgs &9=global your msgs
488 |03Base: |14|$R40|&1 |03Total: |09|$L04|&4|03 New: |11|$L04|&5 |03Yours: |12|$L03|&6

; MsgBase quickscan footer prompt
; &7=global total msg   &8=global new msgs   &9=global your msgs
489 |CRQuick Scan complete. |CR|CR|PA

; Msg header flags text one word each separated by a space
; 1=Local 2=Echo 3=Private 4=Sent 5=Delete 6=Received
490 Local,Echo,Priv,Sent,Del,Rcvd

; File base filesize flags one word separated by a space
; 1=offline  2=failed  3=unvalidated  4=GB  5=MB  6=KB  7=B
491 OFFLINE FAILED UNVALID GB MB KB B

; Forward msg: which base
492 |CR|09Forward message to which base (?/List): |XX

; Sysop password prompt
493 |CR|09Sysop Password: |XX

; Normal msg reader: Remove from newscan? (after I command)
494 |CR|12Remove |15|MB |12from message newscan? |XX

; Lightbar msg reader: Remove from newscan (after I command)
495 |CR|12Remove |15|MB |12from message newscan? |XX

; Netmail send address prompt with active nodelist searching
496 |CR|09Enter netmail address or search criteria (|10?|09/|10Help|09): |11

; Nodelist browser prompt
497 |CR|09Enter nodelist search criteria (|10?|09/|10Help|09): |11

; Nodelist search results header
498 |CR|15Node         System Name                Location           SysOp               |CR|09============ ========================== ================== ====================

; Node list search results
; &1=addr  &2=bbsname  &3=location  &4=sysop  &5=phone  &6=internet
499 |10|$R12|&1 |15|$R26|&2 |11|$R18|&3 |09|$R20|&4

; Node list single result
500 |CR|03    Address: |14|&1|CR|03System Name: |11|&2|CR|03   Location: |11|&3|CR|03   Operator: |11|&4|CR|03      Phone: |11|&5|CR|03   Internet: |11|&6

; Node list search  "found X matches"  &1=# of matches
501 |CR|03Found |11|&1 |03matches.

; Netmail send confirmation
; &1=addr  &2=bbsname  &3=location  &4=sysop  &5=phone  &6=internet  &7=to
502 |CR|12Send netmail to |15|&7|07 at |15|&1|12? |11

; QWK .REP complete/results prompt
; &1=msgs imported  &2=msgs failed  &3=bases added to scan  &4=bases removed
503 |10SUCCESS|01.|CR|CR|11- |03Posted |11|&1 |03new messages (|11|&2 |03failed)|CR|11- |03Added |11|&3 |03bases to new scan (|11|&4 |03removed).|CR|CR|PA

; Standard message reader: Lastread pointer set &1 = msg number
504 |CR|11Last read pointer has been set to message number |&1.|CR|CR|PA

; Lightbar reader: Lastread pointer set &1 = msg number
505 |CR|11Last read pointer has been set to message number |&1.|CR|CR|PA

; QuickScan message list header    &2=basename
506 |15From            Base                 Subject|CR|09=============== ==================== ==========================================

; QuickScan message list middle
; &1=msg#  &2=basename  &3=from  &4=to  &5=subject  &6=date
507 |10|$R15|&3 |09|$R20|&2 |11|$R42|&5

; QuickScan message list footer
508 |09|$D79=|CR

; Message reply options (standard)
; &1=base name  &2=reply to name   &3=msg subject
509 |16|CL|09|17  |15Message Reply |$X79 |16|CR|CR|03    Area: |11|&1|CR      |03To: |11|&2|CR|03 Subject: |11|$R65|&3|CR|CR|09Reply area (|11ENTER|09) Current, |09(|11B|09)ase, |09(|11E|09)mail, |09(|11Q|09)uit? |14

; Message reply options (lightbar)
; &1=base name  &2=reply to name   &3=msg subject
510 |16|CL|09|17  |15Message Reply |$X79 |16|CR|CR|03    Area: |11|&1|CR      |03To: |11|&2|CR|03 Subject: |11|$R65|&3|CR|CR|09Reply area (|11ENTER|09) Current, |09(|11B|09)ase, |09(|11E|09)mail, |09(|11Q|09)uit? |14

; Message reply select base prompt
511 |CR|09Select message base for reply [|10?|09/|10List|09]: |11

; Message "replying to X base" prompt   &1=base name
512 |CR|03Posting reply message to base |11|&1|03.
