Introduction
~~~~~~~~~~~~
BetterString is a stringgadget replacement. It is created for MUI, so using it
should eliminate the problems with the original BOOPSI stringclass.
The class offers the user to do number arithmetic, like increase, decrease and
bin<->hex conversion. It has filename completion, ability to mark, cut, copy
and paste text - Both via mouse and keyboard. The length of the contents
buffer will dynamically be expanded to hold all of what the user type (unless
a maximum length is given)

It is used by a wide range of well-known MUI-based application like YAM
(Yet Another Mailer) or SimpleMail as the main textediting MUI gadget.

The gadget was originally written in 1997, and is Copyright (c) 1997-2000 by
Allan Odgaard. As of version 11.7, release in July 2005, the gadget is
maintained and Copyright (c) by the BetterString.mcc Open Source Team.

It was released under the GNU Lesser Public License in July 2005 and its
development is hosted at:

https://github.com/amiga-mui/betterstring

Please consult the included "COPYING" file for a more detailed information
on the licensing of the gadget and its source code.

Please refer to the included ChangeLog in the archive for a detailed information
on the changes since the last version release.

Enjoy this release and if you find any bugs or have suggestions please always
prefer to go to the project homepage https://github.com/amiga-mui/betterstring
and use the Bug/Feature Trackers there to report anything to the authors!

Have phun,

Your BetterString.mcc Open Source Team

Manual Installation
~~~~~~~~~~~~~~~~~~~
1) Extract the archive to a temporary directory.

   > cd RAM:
   > lha x MCC_BetterString.lha

2) Go to the "MCC_BetterString/Libs/MUI/<OS>" directory where <OS> is the
directory
   matching the operating system you want to install BetterString.mcc for:

   > cd MCC_BetterString/Libs/MUI/AmigaOS4

3) copy all #?.mcc and #?.mcp files found in that <OS> directory to the
   global "MUI:libs/mui/" directory on your system partition:

   > copy #?.mcc MUI:Libs/mui/
   > copy #?.mcp MUI:Libs/mui/

4) reboot and enjoy the new version ;)

History
~~~~~~~
The detailed change log can be found in the ChangeLog file.

         __
        / /
   __  / /   Only Amiga makes it possible...
   \ \/ /
    \__/

Amiga is a trademark of Amiga, Inc.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/
-rw-r--r--  1008/1011     8747   24351  35.9% -lh5- 64a8 Aug 31 18:06 MCC_BetterString/COPYING
-rwxr-xr-x  1008/1011     1433    2542  56.4% -lh5- 305e Aug 31 18:06 MCC_BetterString/COPYING.info
-rw-r--r--  1008/1011    15825   50770  31.2% -lh5- a855 Aug 31 18:06 MCC_BetterString/ChangeLog
-rwxr-xr-x  1008/1011     1430    2542  56.3% -lh5- 7e47 Aug 31 18:06 MCC_BetterString/ChangeLog.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/Autodocs/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/Autodocs/MCC/
-rw-r--r--  1008/1011     3740   12920  28.9% -lh5- ce9f Aug 31 18:06 MCC_BetterString/Developer/Autodocs/MCC/MCC_BetterString.doc
-rw-r--r--  1008/1011     1039    2630  39.5% -lh5- c234 Aug 31 18:06 MCC_BetterString/Developer/Autodocs/MCC/MCC_HotkeyString.doc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/C/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/C/include/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Developer/C/include/mui/
-rw-r--r--  1008/1011     1344    4495  29.9% -lh5- d22d Aug 31 18:06 MCC_BetterString/Developer/C/include/mui/BetterString_mcc.h
-rw-r--r--  1008/1011      682    1381  49.4% -lh5- 29bd Aug 31 18:06 MCC_BetterString/Developer/C/include/mui/HotkeyString_mcc.h
-rwxr-xr-x  1008/1011     3876   22896  16.9% -lh5- 830f Aug 31 18:06 MCC_BetterString/Install-MCC
-rwxr-xr-x  1008/1011     1509    1853  81.4% -lh5- 7d50 Aug 31 18:06 MCC_BetterString/Install-MCC.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-i386/
-rw-r--r--  1008/1011    21037   44492  47.3% -lh5- 4b29 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-i386/BetterString.mcc
-rw-r--r--  1008/1011     9113   25904  35.2% -lh5- b5bb Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-i386/BetterString.mcp
-rw-r--r--  1008/1011     4373    9232  47.4% -lh5- e70c Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-i386/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-ppc/
-rw-r--r--  1008/1011    27359   62256  43.9% -lh5- ee0f Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-ppc/BetterString.mcc
-rw-r--r--  1008/1011    13267   35600  37.3% -lh5- 64fc Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-ppc/BetterString.mcp
-rw-r--r--  1008/1011     7489   15784  47.4% -lh5- 9d1d Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-ppc/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-x86_64/
-rw-r--r--  1008/1011    27331   77640  35.2% -lh5- 38de Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-x86_64/BetterString.mcc
-rw-r--r--  1008/1011    11921   43016  27.7% -lh5- 1e22 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-x86_64/BetterString.mcp
-rw-r--r--  1008/1011     6537   19520  33.5% -lh5- 43c4 Aug 31 18:08 MCC_BetterString/Libs/MUI/AROS-x86_64/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS3/
-rw-r--r--  1008/1011    23482   43432  54.1% -lh5- 80bb Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS3/BetterString.mcc
-rw-r--r--  1008/1011     7542   18360  41.1% -lh5- 8b50 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS3/BetterString.mcp
-rw-r--r--  1008/1011     3435    6136  56.0% -lh5- e287 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS3/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS4/
-rwxr-xr-x  1008/1011    25997   56920  45.7% -lh5- e8ef Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS4/BetterString.mcc
-rwxr-xr-x  1008/1011    12282   31564  38.9% -lh5- 52c8 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS4/BetterString.mcp
-rwxr-xr-x  1008/1011     7771   18080  43.0% -lh5- b098 Aug 31 18:08 MCC_BetterString/Libs/MUI/AmigaOS4/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Libs/MUI/MorphOS/
-rwxr-xr-x  1008/1011    30802   67456  45.7% -lh5- b2a3 Aug 31 18:08 MCC_BetterString/Libs/MUI/MorphOS/BetterString.mcc
-rwxr-xr-x  1008/1011    11167   27232  41.0% -lh5- d6d0 Aug 31 18:08 MCC_BetterString/Libs/MUI/MorphOS/BetterString.mcp
-rwxr-xr-x  1008/1011     7537   15788  47.7% -lh5- d3e5 Aug 31 18:08 MCC_BetterString/Libs/MUI/MorphOS/HotkeyString.mcc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/
-rw-r--r--  1008/1011     1411    5305  26.6% -lh5- 0b43 Aug 31 18:06 MCC_BetterString/Locale/BetterString_mcp.pot
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/czech/
-rw-r--r--  1008/1011      843    1542  54.7% -lh5- 3feb Aug 31 18:08 MCC_BetterString/Locale/Catalogs/czech/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/danish/
-rw-r--r--  1008/1011      749    1464  51.2% -lh5- 56f5 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/danish/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/dutch/
-rw-r--r--  1008/1011      700    1330  52.6% -lh5- 9c30 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/dutch/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/finnish/
-rw-r--r--  1008/1011      160     202  79.2% -lh5- f7b8 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/finnish/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/french/
-rw-r--r--  1008/1011      830    1700  48.8% -lh5- 778c Aug 31 18:08 MCC_BetterString/Locale/Catalogs/french/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/german/
-rw-r--r--  1008/1011      781    1474  53.0% -lh5- ef82 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/german/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/greek/
-rw-r--r--  1008/1011      878    1602  54.8% -lh5- 21cd Aug 31 18:08 MCC_BetterString/Locale/Catalogs/greek/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/italian/
-rw-r--r--  1008/1011      782    1544  50.6% -lh5- 7618 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/italian/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/polish/
-rw-r--r--  1008/1011      846    1602  52.8% -lh5- ed3a Aug 31 18:08 MCC_BetterString/Locale/Catalogs/polish/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/russian/
-rw-r--r--  1008/1011      848    1462  58.0% -lh5- 54b1 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/russian/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/slovak/
-rw-r--r--  1008/1011      786    1420  55.4% -lh5- 5127 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/slovak/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/spanish/
-rw-r--r--  1008/1011      726    1392  52.2% -lh5- 87bb Aug 31 18:08 MCC_BetterString/Locale/Catalogs/spanish/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/swedish/
-rw-r--r--  1008/1011      712    1346  52.9% -lh5- af23 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/swedish/BetterString_mcp.catalog
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/turkish/
-rw-r--r--  1008/1011      827    1476  56.0% -lh5- d007 Aug 31 18:08 MCC_BetterString/Locale/Catalogs/turkish/BetterString_mcp.catalog
-rwxr-xr-x  1008/1011     1383    2745  50.4% -lh5- f37c Aug 31 18:06 MCC_BetterString/ReadMe
-rwxr-xr-x  1008/1011     1433    2542  56.4% -lh5- 995f Aug 31 18:06 MCC_BetterString/ReadMe.info
-rwxr-xr-x  1008/1011      535    1138  47.0% -lh5- 3ab8 Aug 31 18:06 MCC_BetterString/ReadMe.mui
-rwxr-xr-x  1008/1011     1458    2570  56.7% -lh5- 1de5 Aug 31 18:06 MCC_BetterString/ReadMe.mui.info
-rwxr-xr-x  1008/1011     1873    2361  79.3% -lh5- 06e5 Aug 31 18:06 MCC_BetterString.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        79 files  316628  781009  40.5%            Sep  1 01:06