/* Synchronet BBS for Win32 v3.11 Revision A Beta Release */

(The Pearl Harbor release)

This is an UPGRADE ONLY
~~~~~~~~~~~~~~~~~~~~~~~
You must have Synchronet v3.1x (any revision) installed prior to upgrading to
v3.11 beta. This release includes all previous updates, patches, etc. as of 
December 7th, 2003.

This is a RELEASE CANDIDATE
~~~~~~~~~~~~~~~~~~~~~~~~~~~
If there are no show-stopper bugs, this release will become the final official
release of 3.11 (packaged as a full-install without the "beta" label
obviously), so if you find any new bugs or old bugs that were supposed to
have been fixed, please let us know as soon as possible.

INSTALLATION INSTRUCTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~
1. Shut-down Synchronet if its running.

2. Back-up all of your Synchronet files (this is a BETA release).

   This upgrade may overwrite files you've modified, so be sure to BACK-UP
   any files you've modified (and want to keep) from the CTRL and EXEC
   directories.

   NOTE:
   If you have modified any of the stock JavaScript (*.js) or Baja (*.src)
   files in your EXEC directory, you should move those files into a
   "mods" directory (protecting them from being over-written by future
   updates and upgrades, including this one) and specify the path to this
   directory in SCFG->System->Advanced Options->Mods Directory
   (Example: "../mods"). Synchronet will search this directory for any
   modules (*.js or *.bin) to be executed before searching the EXEC
   directory.

3. Unzip EXEC.ZIP into your EXEC directory, overwriting existing files.

   NOTE: You must use a 32-bit unzip utility (e.g. WinZip) to get the correct
         filenames!

   New/updated JavaScript and Baja modules you might be interested in:

   dyndns.js
     The yourbbs.synchro.net Dynamic DNS client, see http://www.synchro.net
     for details.

   typehtml.js
     Displays an HTML document (in monochrome or color) for Telnet/Rlogin
     clients (replaces typehtml.bin).

   ircd*.js
     Cyan's Synchronet IRC Daemon (uses irclib.js). See docs/ircd.txt for
     details.

   irc.js
     Deuce's IRC client (updated).

   newslink.js
     Updated NewsLink (NNTP gateway) module.

   mailproc_example.js
     Example external mail processor (uses mailproc_util.js) for Synchronet
     SMTP Mail Server. This could be the basis for a list server, mail
     responder, content filter, file requester, whatever you want.

   playtone.js
     New .ton file player for Synchronet written in 100% JavaScript
     (replaces tone.exe).

   mlistgate.js
     Mailing list gateway module (timed event). Sends any newly posted
     messages in a specific sub-board to a specified list server
     (written for Hausmaus).

   chat_sec.src/bin
     Updated chat section module, allows user to choose which IRC server
     to connect to (defaults to #synchronet at irc.synchro.net).

   New/Updated executables you might be interested in:

   sexyz.exe
     An early preview of a new 32-bit socket X/Y/Zmodem file transfer
     program (sorry, no docs - support downloads only currently).

   ans2asc.exe and asc2ans.exe
     32-bit utilities replacing ans2msg.exe nad msg2ans.exe (same
     functionality).

   sbbsNTsvcs.exe
     Synchronet NT services. See docs/sbbsNTsvcs.txt for details.

   JSexec.exe
     New program to execute Synchronet JavaScript modules externally from
     Synchronet. Can be used to execute Synchronet .js files as web server
     CGI scripts, external services/servers (e.g. ircd.js), and much more.

   fixsmb.exe
     v2.0 of this utility now retains message numbers while reconstructing
     message base files, making it much more useful for restoring corrupted
     sub-boards.

4. Unzip DOCS.ZIP into your DOCS directory, overwriting existing files.

   v311_new.html
     Detailed list of all the changes made since v3.10L (the last official
     Synchronet release).

   v311_jsnew.html
     List of JavaScript methods and properties added or modified in v3.11.
     For the complete object model documentation, see jsobjs.html.

   jsobjs.html
     Complete details on the JavaScript object model. Most new/updated
     methods or properties are designated as version "3.11".

   sbbsNTsvcs.txt
     Instructions on running Synchronet as a set of NT Services on Microsoft
     Windows NT based operating systems (i.e. Windows NT, 2000, XP, 2003).

   ircd.txt
     Instructions on the new Synchronet IRC Daemon (written in 100%
     JavaScript), the foundation of the new irc.synchro.net IRC network.

5. Unzip CTRL.ZIP into your CTRL directory, choosing which files to
   overwrite (if any).

   sbbs.ini
     If you've modified your ctrl/sbbs.ini file, you probably do not want
     to overwrite it. This updated default initialization file contains new
     options and is easier to read and modify.

   text.dat
     This file contains the majority of "built-in" text that is displayed
     to BBS users logged into the Telnet/RLogin server.
     As of v3.10 Revision E, there are REQUIRED ctrl/text.dat changes:
     Either copy the included text.dat to your ctrl directory or see
     text310g.dif for the required changes. If you see <UNUSED> anywhere
     while logged in, you're using the WRONG TEXT.DAT FILE!!!

   services.ini 
     This is the new format services configuration file, replacing or
     augmenting services.cfg. Synchronet will read both the old services.cfg
     and the new file and ignore any duplicate services (configured in both
     files). If you've made *no* modifications to your ctrl/service.cfg file,
     you can safely delete it as the stock services.ini file (included in this
     package) has all the same services configured, plus the new IRC Daemon
     service, and it's much easier to read and modify.

   mailproc.cfg
     The external mail process support in the Synchronet SMTP Mail Server
     is much more powerful now as it can run native JavaScript processors
     (see exec/mailproc_example.js for details). If you've made any 
     modifications to your mailproc.cfg file, then you probably do *not* want
     to overwrite it with the stock file included in this package. This
     updated file includes documentation about the newest features to support
     external mail processors (SPAM/content filters, mailing lists, etc).

   sockopts.cfg
     This updated default socket options configuration file now disables the
     TCP "nagle algorithm" since the Synchronet Telnet Server now controls its
     own packet buffering to optimize through-put to Telnet/RLogin users. This
     file now supports advanced options like "REUSEADDR 1" to allow address/port
     re-use when binding sockets.

   dns_blacklist.cfg
     The default DNS Blacklist configuration file in v3.00-v3.10 included
     relays.osirusoft.com (run by Joe Jared) which has since started erroneously
     reporting EVERY IP address as a blacklisted server, causing EVERY e-mail to
     be flagged as SPAM or rejected (depending on the configuration). This
     updated DNS Blacklist configuration file removes relays.osirusoft.org and
     adds several other (working) DNS blacklist servers.

   ircd.conf
     This is the Synchronet IRC Daemon (exec/ircd.js) configuratoin file. See
     docs/ircd.txt for details.     


Please report any bugs in one of the Synchronet-related discussion groups
(see http://synchro.net/docs/support.html for details), please include
detailed instructions on how to reproduce the bug and exactly what the error
messages or other symptoms are.

Thanks for the bug reports, keep 'em coming!

-Rob

P.S. Please DO NOT redistribute alpha or beta versions of Synchronet as they 
are very short-term releases and I don't want them to remain "in the wild" for
extended periods of time. - Thanks.

/* End of file */