Synchronet for Windows v3.18b UPGRADE
=====================================
September 20, 2020

You must have Synchronet v3.16 or v3.17 already installed and working before
applying this upgrade. If you are running v3.15 or before you may have some
quirks if you don't upgrade to at least v3.16 first.

As always, you should *backup* your Synchronet directory tree before applying
any upgrade (including this one), just in case something goes wrong.


Instructions
------------
The directory where you extracted this readme.txt file should look like this:

 Directory of C:\sbup318b

09/20/2020  12:57 AM    <DIR>          .
09/19/2020  06:38 AM    <DIR>          ..
09/20/2020  12:57 AM    <DIR>          ctrl
09/20/2020  12:57 AM    <DIR>          docs
09/20/2020  12:57 AM    <DIR>          exec
09/20/2020  02:47 PM                49 FILE_ID.DIZ
09/20/2020  02:45 PM             3,070 readme.txt
09/20/2020  12:57 AM    <DIR>          text
09/20/2020  12:57 AM    <DIR>          web
09/20/2020  12:57 AM    <DIR>          webv4

If it does not, then you extracted the archive wrong. Try again.

Shutdown Synchronet (sbbs.exe, sbbsntsvcs.exe, and sbbsctrl.exe).

Copy the contents of the included "exec" directory to your Synchronet "exec"
directory, over-writing all files. If you have locally modified files, move
them to your "mods" directory first.

NOTE:
It is important that the files in the subdirectories (e.g. load, ircbots, 
etc.) are copied into the subdirectories of the target "exec" directory.
If you end up with files of the same name both in the "exec" directory
and the "exec/load" subdirectory, then something went wrong. You can try
and use the "jsexec update.js" command-line to remedy the situation, but
you may still have old files if your exec subdirectories which you
failed to update correctly.


Web Update Options
------------------
If you wish to update the contents of your "web" directory, you may do so
by copying (recursively) the contents of the includedd "web" folder. If you
have locally modified files in the "web" folder, you may want to merge or
replace those files (from your backup) after you've updated.

The included "web" folder includes the old Runemaster web interface
(web/root) with bug-fixes and the old ecwebv3 interface (web/root/ecwebv3).

Also included is the latest echicken web interface (webv4). You
can change between them by setting the "RootDirectory" key of the [Web]
section of your ctrl/sbbs.ini file to point to either of these directories:

	RootDirectory=../web/root
or
	RootDirectory=../webv4/root


Text/Menu Updates
-----------------
If you have any locally modified files from the text directory, take care
when extracting this archive and consider only extracting files that do
not already exist or overwrite only files you have not locally changed.
New menu options have been added (especially to the default/Classic
command shell) - so you may want to have the new menu files.


ctrl/text.dat Updates
---------------------
There have been many changes to the ctrl/text.dat file. If you have local
changes, you'll probably want to merge the files or overwrite your text.dat
with the version included in this archive and then reapply your changes
manually. The text.dat changes from v3.17b to v3.18b can be reviewed in
docs/text318b.dif


Finally
-------
After extracting (and optionally merging) the files, from a command prompt
and the current working directory set to your Synchronet "exec" directory,
run:
	jsexec update

/* End of file */