This file describes notable and important changes in certain versions to help
with the upgrade process if you are upgrading your message lister script from
an older version.

Upgrading to version 1.32 and newer
-----------------------------------
Starting with version 1.32, the message lister script now makes use of your
msghdr file in the sbbs/text/menu directory for displaying message headers when
reading messages.  This makes the message reading experience more consistent
with Synchronet's message read prompt by making use of your message header
customization.
The name of the message header file defaults to msghdr, but it can be
customized if you wish to use a different file specifically for the message
lister.  The option msgHdrTextFileName in DigitalDistortionMessageLister.cfg
specifies the name of the file, without the extension (.ans or .asc is chosen
automatically depending on whether the user's terminal supports ANSI and if the
.ans file or .asc file exists).

Also, starting in version 1.32, the message lister script now allows you to put
its configuration file (DigitalDistortionMessageLister.cfg) in the sbbs/ctrl
directory if desired.  This allows for an installation that is more consistent
with the way Synchronet does things, with the .js files in the sbbs/exec
directory and the configuration files in the sbbs/ctrl directory.  If you still
wish to put all of the .js files and the .cfg file together in the same
directory, you may still do so.

Upgrading to version 1.28 and newer
-----------------------------------
Starting with version 1.28, there are some new color settings that you can
customize.  Color settings include the colors used in the message list for
messages written to and from the user currently listing messages.  These colors
have defaults, but if you want to customize them, add the following lines to
your DigitalDistortionMessageLister.cfg file and customize the colors to your
liking:
; Message information for messages written to the user
toUserMsgNum=nhy
toUserFrom=hg
toUserTo=hg
toUserSubject=hg
toUserDate=hb
toUserTime=hb
; Message information for messages from the user
fromUserMsgNum=nhy
fromUserFrom=nc
fromUserTo=nc
fromUserSubject=nc
fromUserDate=hb
fromUserTime=hb

Also, there is a new configuration option: promptConfirmReadMessage
This option specifies whether or not to prompt the user to confirm whether to
read a message when one is selected.  Valid values for this setting are true
and false.