COLOR 64 BBS v8.1a - UPGRADE NOTES
Mac OS LTK Build
11 February 2026

------------------------------------------------------------
IMPORTANT - READ BEFORE UPGRADING
------------------------------------------------------------

THIS BUILD INCLUDES UPDATED LTK DISK IMAGES.

If you are upgrading an EXISTING Color 64 BBS installation,
you SHOULD NOT blindly overwrite your existing LTK disk images.

Doing so WILL DESTROY existing BBS data, including messages,
user data, and configuration stored on those images.

------------------------------------------------------------
WHO THESE NOTES APPLY TO
------------------------------------------------------------

EXISTING BBS SYSOPS:
- Follow the PARTIAL UPDATE instructions below.
- Copy ONLY the specific updated files listed.
- Do NOT overwrite your entire LTK disk images.

NEW BBS INSTALLATIONS:
- You may install and run this build as documented.
- New users may use the provided LTK disk images without issue.

------------------------------------------------------------
WHAT CHANGED IN THIS BUILD
------------------------------------------------------------

See CHANGE_LOG.TXT

------------------------------------------------------------
LTK DISK IMAGE UPDATES (EXISTING BBS)
------------------------------------------------------------

For EXISTING BBS installations, ONLY the following files were
modified since the previous release:

- bbs.xfer
- bbs.msgs
- bbs.profile
- sys.edit
- bbs.ovl

These updated files are located in the directory:

  D64 Masters

To upgrade safely:
- Mount or open your EXISTING LTK disk images
- Copy ONLY the files listed above from D64 Masters
- Do NOT replace the entire LTK disk image files

If transitioning from LINUX or Windows to Mac OS:
- Perform install using vice build-macros-v2.sh
- Copy LTK images from existing BBS and overwrite the
  Supplied LTK images that came with the Mac package.
- Run!
------------------------------------------------------------
SHELL SCRIPT UPDATES (OPTIONAL)
------------------------------------------------------------

The following Mac OS shell scripts were updated in this release:

- vicebuild-macos-v2.sh
- mybbs-macos.sh
- mybbs-tcpser.sh
- mybbs-vice.sh

These scripts may be copied over an existing installation.
Replacing them is RECOMMENDED but OPTIONAL for existing sysops.

If upgrading scripts:
- Replace all updated scripts together
- Re-run vicebuild-macos-v2.sh if needed for your platform

------------------------------------------------------------
RECOMMENDED UPGRADE PROCEDURE (EXISTING BBS)
------------------------------------------------------------

1) Shut down the BBS and tcpser
2) Back up your existing LTK disk images
3) Copy ONLY the following files from D64 Masters into your
   existing LTK disk images:
     - bbs.xfer
     - bbs.msgs
     - bbs.profile
     - sys.edit
4) Replace updated shell scripts as desired
5) Restart tcpser and the BBS using mybbs-macos.sh

------------------------------------------------------------
NEW INSTALLATION NOTES
------------------------------------------------------------

For NEW BBS installations:
- Follow the installation instructions in README.TXT
- Run vicebuild-macos-v2.sh as instructed
- Use the provided LTK disk images as-is

------------------------------------------------------------
NOTES
------------------------------------------------------------

- User data, message bases, and configuration are preserved
  when following the PARTIAL UPDATE procedure.
- Always maintain backups before making changes.

------------------------------------------------------------
END OF UPGRADE NOTES
------------------------------------------------------------
