TMULTLANG PACKAGE FOR DELPHI v1.32
(C) 1995, 1996, 1997 by Lingscape
							     7 November 1997

INDEX
 1  Description
    1.1  Features
 2  Installation
    2.1  Dependencis
    2.2  Problems
    2.3  Un-Installing
 3  Trial
 4  Disclaimer
 5  Register
    5.1  Ordering
 6  History
 7  Contact us


1   DESCRIPTION
Forget Windows resource files (.RES, .RC ...) this component will make you
internationalized without writing any additional code. Just drop it on your
form and re-compile, finished. This component will translate properties in
Delphi, at both design and runtime. Targeting bi-lingual and multi language 
support, but it can be used for many other things. Support for switching 
language at run-time independant of the running Windows version. 
This component will alter almost all properties that the object inspector can 
edit. You can choose if you want your languages to be saved in the form or a 
file. You can use the same file for all your form languages within the same 
application. It works in a multiuser environment and it is aware of other 
forms. You can share languages between different forms and manipulate those 
even at runtime.
Come on and jump on the train to Rapid Application Development, it's lightening
fast. Why use expensive tools to maintain different languages when you have 
the MultLang package.

The MultLang package includes 12 components. With this package you will be able 
to to make professional bi- or Multi-lingual applications.

All components in our packages are pure Delphi components available in 16- and
32-bit. They are also cross-platform compatible 16<->32 bit and form file 
(*.dfm) compatible. You can safely depend on our components for Delphi in any
environment, full source is also available for all components.

1.x FEATURES
* Specialized for multi language support in Delphi 1, 2, 3 and C++Builder.
* Double byte languages support
* Switching language at run-time independant of the running Windows version
* Supports translation of Win 3.1 objects even when developing on Win 95
* Get multi lingual by just dropping this VCL on a form (No additional coding)
* Available as 16 and 32 bit with the fully source code in pure Delphi Pascal
* Change text of almost all Component and Control properties
* Support for translation of TStrings items and TFont objects
* Multi-user shared resource file(s) (when an external file is used)
* 16- and 32-bit Common dialogs support (without any DLL or RES files)
* Delphi standard Message dialogs support (ShowMessage, MessageDlg, Input ...)
* Write you own run-time property editor via INI files
* Date, Time, Currency and Number format translations
* Switch languages from selectable controls (Menus, DropDown, RadioGroup etc)
* Save language translation in forms (design time) or external files
* Even translates it self (Localized language names)
* Aware of other forms within the same application
* Objects and Properties browsable, just point and click
* Share languages/properties/values between several forms
* One run- and design-time editable resource file for one or more forms
* Extensive help integrated with Delphi
* Safe syncronisation when changing names, removing or inserting components
* Associate icons (stretchable) to each configuration.
* An easy property editor which is integrated in the Delphi environment.
* Filter to restrict language translations (usable in a multi user environm.)
* Supports translation of any language in Win 3.1, 95 and NT
* Right-To-Left script translations
* Add on's available for many different languages
* 32-bit huge strings, >255 bytes (32-bit version)
* Supports MDI, rebuilds windows lists, dynamic captions automatically.
***** MANY MORE FEATURES INCLUDED, PLEASE CHECK IT OUT YOURSELF ******


2   INSTALLATION
If you already have installed a previous version you will have to uninstall
that one first. Please advice the old readme.txt file in the previous version.
This installation also includes the MExtras package, so if you already have 
it installed, please remove that component in the 'Install Components dialog' 
prior to this installation.

NOTE This is the general installation procedures, for Delphi 3 and C++Builder
please advice the appropriate textfiles in the respective directory.

STEP 1. Run the installation program or unpack the package if it came as a
compressed archive (you have probably already done that by reading this).
This package have subdirectories included.

STEP 2. Move all *.HLP files to any directory in your search path, preferable
the \HELP or \BIN directory of your Delphi or C++Builder path.

STEP 3. Backup your VCL library, then install either of these files:
MULTREG.DCU   - Delphi 1.x
MULTREG2.DCU  - Delphi 2.x
MULTPKG.DPL   - Delphi 3
MULTREG2.OBJ  - C++ Builder 1

STEP 4. Install the MULTLANG.KWF and MEXTRAS.KWF files with the Helpfile
installer program (HELPINST.EXE) supplied by Delphi and C++Builder. This 
enables you to press F1 in the Object Inspector to invoke help on properties 
(not necessary if you just want to have a quick look at the component).


That's it !!!!

Look at the Lingscape component palette in Delphi. Why not start with the
Step-By-Step right away, the quick one takes only 5 min. Check the helpfile for
more details by a right click on the TMultLang component at design time.

For implementation details please advice the included technical papers named
TECH*.TXT. They descibe important implementation methods and is highly
recommended to read. 

Also please look at the sample project in the example subdirectory for advice
and to look at source examples.

2.1 DEPENDENCIES
The units below must be available in the library search path when rebuilding
the library. All used units are standard and is included in the Delphi package.
I have tried to keep the dependent units to a minimum so that the overall size
of your EXE will not be too big. You will probably need almost all units in
your own project so it does not matter that it is used by this component.
SysUtils, WinTypes, WinProcs, Messages, Classes, Graphics, Controls, Forms,
Dialogs, StdCtrls, Menus, FileCtrl, DsgnIntf, TypInfo, OutLine, Tabs, ShellAPI,
LibConst, LibHelp, ClipBrd, ExtCtrls, Buttons, Grids, TabNotBk, Mask, INIFiles;
The units not included in the Delphi package is:
AddProp, CopyFrom, LangEdit, MulAbout, RegForm;
You dont need to include any of these in the USES clause, the component is
already compiled. If you start with an empty project this component will add
about 200K because of the dependencies, however the larger your project grows
the less the component adds. If you have an EXE file for about 400K, by adding
this component it may only grow to 515K because of the re-use of classes in
Object pascal.

* For deployment in Delphi 3, please advice the Delphi3.TXT file.

2.2 PROBLEMS
If you are using Delphi 1, we recommend you to increase the stack size from 
the standard 16384 bytes to at least 32768 in your large projects.
If you plan to support editing of languages at run-time (Calling with the
MultLang1.Edit(nil);) you must increase the stack size! If you sometime
in your code get an application error '202', this is likely the problem.
The stacksize can be changed in the 'Options-Project' menu under the tab 
'Linker' and also by using compiler directive {$M 32786 8192} in your source. 

If you encounter "Outline Index Not Found" or "Invalid Index" while working in
the Language Editor, please update your Delphi 1 version. Apply latest free 
patches from Borland, the OUTLINE.DCU unit has several bugs that will be
corrected when patched. This problem occurs if you are running the very first
version of Delphi 1.

If you have added several languages but they are not visible in the drop down
list of the TMultLang component, please make the ItemHeight < Height and will
show up in the list as it should.


2.3 UN-INSTALL
STEP 1. First remove the component from the component palette in Delphi via
the 'Install Component' menu options in Delphi.

STEP 2. Re-generate the keyword index for helpfiles in the Helpfile installer
program (HELPINST.EXE) without the MULTLANG.KWF and MEXTRAS.KWF files.

STEP 3. If you installed the package using the installation program use the
'Add/Remove' program icon in your control panel. Otherwise, just delete all 
files in the MultLang package in the directory you choosed when it was 
installed and the helpfiles MULTLANG.HLP, MEXTRAS.HLP.


3   TRIAL
The trial version of the MultLang package allows you a 30 day trial period.
The trial period expires after 30 days from the installation time.
After that period you have to remove it and must not use it
anymore, or you can register it for continuing use. You are not allowed to 
make a new trial period by reinstalling the component again, unless it is a 
later version.


4   DISCLAIMER
Users of MultLang package must accept this disclaimer of warranty:
"The MultLang package is supplied as is.  The author disclaims all
warranties, expressed or implied, including, without limitation,
the warranties of merchantability and of fitness for any purpose.
The author assumes no liability for damages, direct or conse-
quential, which may result from the use of the MultLang package."

We dont take any responsibility of misuse or of any corrupt files caused by this 
component and especially not your form files (*.DFM). It is your responsibility
to always keep a backup copy of necessary files. For more info see page 139
'Creating a backup of an entire project' in the Delphi User's Guide.
You are not allowed to modify any files associated with this component. 

Any reproduction of material in this package is copyrighted by law.
The author reserves the right to change any text in this file, the 
helpfile and in the about dialog at anytime.

You are allowed to distribute the trial version with all its files anytime. 
There are no limited functions in the trial version.


5   REGISTER
By registering our MultLang package you will get a license to use our package
in your applications royalty free, besides that you will also get:
* 3 months free support from the date of the registration
* Free minor upgrades
* Upgrades to major new versions
* Related information about Multi Lingual programming (Delphi) sent via E-Mail

Support will be given on the address below. Support will also be given to 
unregistered users within the trial period of the Trial version.
If you have access to Internet, please take a look at URL site 
http://www.lingscape.com/delphi/ for late braking news and updates for the 
Multi Language Component.

You will also get rid of all the annoying messages.
The registration methods below entitles you to develop and distribute royalty
free programs which contains this component package.

Each registration allows one person to use the component at a time, 
specifically the Language Editor.
Site registrations with more than 1 user is available with discounts. Please
send us E-mail requesting a site licensing quote.

5.1 ORDERING
We prefer receiving orders from our secure Web site, once submitted you will
get what you order immediately (download). 
Please visit http://www.lingscape.com/shop/ for more information.

When you order a product you will be E-Mailed registration information with
instructions within 24 hours worldwide.

For your convenience we have contracted NorthStar Solutions in USA to process
any orders that you wish to place with your valid Visa or MasterCard.
They may be contacted FOR ORDERS ONLY via any of the following methods:

Voice:   1-800-699-6395 (10:00am - 10:00pm Eastern Standard Time US Only)
         1-803-699-6395 (10:00am - 10:00pm Eastern Standard Time)

Fax:     1-803-699-5465 (Available 24 hours. International)

E-Mail:  America Online: STARMAIL
         CompuServe:     71561,2751 
         Internet:       STARMAIL@AOL.COM

Regardless of how you register, please have the following information ready:
* The name of the package listed below you are registering
* Where the latest version should be mailed (E-Mail or Regular Post)
* Your VISA or MasterCard # and its expiration date

PLEASE NOTE: If you have any questions please send them to us at Lingscape
on the address given below. NorthStar Solutions can only process orders.

If you have a CompuServe account you can also register a package On-Line, but
we prefer receiving orders via NorthStar Solutions:
NOTE CompuServe orders will have a surcharge of 15% on prices listed below.
* Go to the SWREG forum and select Register Shareware.
  Search for TMultLang for the TMultLang package, or for MExtras for the
  TMExtras package, or for Collector for the TComponentCollector component,
  then select the version you would like to order.

The price table below is valid til 1997-10-31.
 NAME (Delphi Component packages)                             PRICE
 TComponentCollector                                          US$ 19
 Regular MultLang package 1.1x 16-bit                         US$ 149
 Regular MultLang package 1.1x 32-bit                         US$ 149
 Regular MultLang package 1.1x 16- and 32-bit                 US$ 175
 Source MultLang package 1.1x *                               US$ 425

 UPGRADES (Must provide previous license key)
 Regular MultLang package 1.1x -> 1.1x source. *, **          US$ 374
 Regular MultLang package 1.1x 16-bit <-> 32 bit version **   US$ 75

*  The source includes both the 16 and 32 bit version.
** Previous license key must be quoted upon registration.

We reserve the rights for price changes.


6   32-BIT VERSION
The 32 bit version is fully compatible with 1.xx 16 bit versions of the multi
language component. This means you can use the 16-bit component and later 
switch to the 32 bit component and then recompile, without any additional 
coding and re-translation. The 32-bit version adds on support for huge strings,
but besides that all features are the same. This means full Form (*.dfm) format
compability. You can for instance develop your application in a 32-bit
environment (with Delphi 2.x) and then load your project in Delphi 1.x to
just compile it for 16-bit without changing any code, all with the same
codebase.

6.1 HISTORY
1.32 Maintain release
     * Bug in importing from external files without LanguageFile assigned
     * Complete Delphi 3 installation files and instructions
     * Added feature to override inherited forms translations
     * The problem relating to store inherited props corrected causing ???
1.31 Better perfomance on external files and Bug fixes
     * Removing VCL's in the IDE on inherited forms crashed, corrected
     * Now load forms data into 1 buffer using 1 disk seek, more efficiently
     * Removing TCollectionItems in the IDE sometimes causeed GPF, fixed
     * Inheritance at the design time using TProxyForm in Delphi 1, fixed
     * Delphi 3 packaging changed, now possible to deploy MultPgkr.DPL
     * Unit name change, for Save and Load, now MultSave and MultLoad
     * C++ Makefile included for the example project
     * Documentation updates and various typos
     * Installation program included (Requires Windows 95 or NT)
1.3 Release Support for Delphi 3 and C++Builder
     * Now supports Delphi3 and C++Builder
     * Bug 'List index not found' in Language Editor corrected
     * Form Inheritance support added for string translations
     * Import/Export methods refined and corrected
1.21 Corrections
     * Unnecessary properties saved in form file corrected
     * Textfile export could switch languages or get 'Out of Index error'
     * AdoptOn TRadioGroup could cause GPF corrected
       NOTE TRadioGroup can now not be translated itself from its own selection
1.2 New Release, bug fixes and several additional enhancements
     * Corrected string length problem over 255 character under Delphi 2
     * New property added DisableBrowseAtRunTime, used with the Edit method
     * Char properties can now be translated without GPF's
     * Faster Export to textfiles
     * Scrambled Export files using 'Save To' fixed
     * Fixed small memory leaks
     * One textfile for all forms, sections like [TMainFormMultLang1.Swedish]
     * Corrected MButtons GPF if Translate=true when the form is destroyed
     * Overlapped Delphi bug, system menu disappearance for maximized MDIChild
     * Faster translations
     * Corrected bug that caused MultLang out of sync when removing comp.
     * Each translations now rebuilds the Main MDI Window menu
     * Editing sub properties of forms not containing cloud prev. caused GPF
     * New method GetPlainString(Ident:String):String wont expand sub strings
     * Changed TOwnAlign=(oaLeft, oaRight, oaCenter) now works with TAlign
     * MFontDialog now includes CaptionScript and CaptionComment
     * Corrected GPF's when working with the Language Editor with the FormList
     * Use the FormList in the Language Editor much quicker
     * DefaultLanguage was not shown correct in language list
     * Unecessary translates eliminated which caused degrade of perfomance
     * MDialogs now defaults to english terms if not changed
     * Calling Edit method could cause intermittent GPF's, now corrected
     * FAQ List updated, dokumentation updates
     * Limited free support to 3 months
1.162 New featers and bug fixes
     * RemoveForm button added (Erases the form from the .LAN file permanent)
     * LoadFrom & SaveTo now works for the selected Form in the Form List
     * About & Register forms removed, making MultLang pkg smaller in size
     * Trial copy have no register key option any longer
     * Unregistered reminder, protected to previous known hacks
     * %EXEPath% removed in the name field of file dialogs
     * Updated German translations
     * Documentation updates
     * GetString method improved, returns design string if language dont exist
     * Corrected GPF editing other forms containing sub props like TStrings
1.161 Bug fix
     * 'New String' method didn't work very well any longer, corrected
     * MDI Window List disappearence for dynamic forms corrected
     * User defined strings in the default language couldn't be removed
1.160 Updates
     * Corrected NT memory access vialoation in Delphi 2.0
     * Perfomance corrections (now using binary searching in sorted lists)
     * Corrected duplicate translations when more than one form was shown
     * DefaultLanguage didn't work if the design language wasn't English
     * Corrected GPF's when browsing properties of non-resource components
     * The Column titles of Delphi 2.0 controls can now be translated
     * Synchronized updates in the Language Editor of other loaded forms
1.152 New features and Updates
     * Removed the %s in the Caption of the Browse dialog
     * Frequently asked questions (FAQ.TXT) file included
     * Removed unregistered reminder at design time (32-bit version)
     * New String command previously erased choosen properties (Browse dialog)
     * Order form for regular, source and site included (helpfile ORDER.HLP)
     * Removed a nasty bug that sometimes caused intermittent GPF`s
     * The DropDown text will no longer overlap in Windows 3.1x and NT
     * Language Editor layout changed, better crossplatform view
     * NEW Translate other forms within the Language Editor (if ext. file used)
     * The included example project is now using an external translation file
     * Bug removed, for adopted menu items
     * LanguageFile property variable %EXEPath% added, because Delphi changes working dir
     * Removed Caption translation for TTabbedNotebook (see FAQ.TXT for more info)
     * MButtons Update (Changed the Translate property, now only available at run-time)
1.151 Updates
     * Fixed a problem with TEXT files under 32-bit
1.15 New features and updates
     * User defined properties in the Browse dialog
     * Last property setting in the Browse dialog saved
     * Documentation updates
     * Helpfile updates
     * Localized version of German added
     * Added support for 32-bit (Delphi 2.x)
     * Huge string translation (>255 bytes)
     * Fixed an intermittent bug dealing with the TabControl
1.141 Updates
     * Example project updates
     * TComponentCollector Updates
     * README.TXT file update
1.14 General updates
     * Setting Font property of MDialogs could give GPF, bad OOP. Now corrected
     * Protected Invalid VBX Exception values
     * TMultLang properties could display duplicates in the Browse dialog
     * Forms did not sometime syncronize at design time when adding languages
     * Added support for Switch-To (TaskList) and Next Window in System Menus
     * Removed a bad BUG in the MDialogs components, when dropped on forms
     * Double Click in the Browse dialog did not work on the last property
     * New languages added
     * Right-To-Left script editing (Hebrew etc) in the Language Editor
     * MButtons bug, did not work with MDIChild windows, Corrected
     * Changing language via the tabs component if Adopted now works well
     * MFontDialog Font property now returns the selected Font
     * Updates to helpfiles and its keyword files
     * Included TComponentCollector (Hides non-visual components)
     * Now includes a sample project, many advanced features with source
1.131 Fixes
     * Debugging message '.LAN' removed, accidently included in the Trial pkg
     * About box version incorrect
     * MButtons component could loose translated strings sometimes
1.13 New features and Bug fixes
     * Double click on properties to transfer them over in the 'Browse' dialog
     * Fixed 'Invalid gridindex value' in the langauge editor dialog
     * MButtons sometimes gives a GPF in the initialize process, it is fixed
     * The brown color around the glyphs of buttons is corrected
     * Expand/Collapse now keeps the outlines syncronised in 'Browse' dialog
     * NEW, have substrings in all strings Ex. 'I like my %ComputerName%'
     * MButtons gave a GPF when closing the dialog if Translate=True
     * Selectable helpfile when editing other languages
     * Corrected a problem: exchanging items in the Outlines in 'Browse'
     * Added support for Dutch and Indonesian languages
     * Dbl_Click in the grid values did not save the values, 'Language Editor'
     * Resized some controls for longer language translations in it self
     * Helpfile updates MULTLANG.HLP and MEXTRAS.HLP (MEXTRAS.HLP included)
     * Updates of problems when using external file and it had the ext. 'lan'
1.12 Many new features and bug fixes
     * Calling Edit method several times could sometime cause a GPF
     * When translating fails it could give a GPF when TranslateApp was true
     * Bug in ORDER.EXE file occuring on Windows 3.1 'File not found'
     * External file handling routine bug when less memory available
     * Setting LanguageFile property to a language file at run-time caused GPF
     * Added support for System menu translation
     * All 16-bit Common dialog support via MDialogs.DCU component
     * Added support for translation of Number, Date, Time and Currency format
     * Localized Design-time interface, add your favorite language CTRL-ALT-E
     * Standard Message dialog buttons support via MButtons.DCU component
     * Property Recovery, put object back on form to get back translations
     * Import/Export of textfiles. Creates/Edits values. INI-file format
     * Userdefined strings, GetString and SetString methods
     * Copy from made unneccesary duplicates of properties when TStrings
     * Several updates for the main component regarding memory allocation
     * Helpfile updates
1.11 Bug fixes and new features
     * Setting caFree on child windows did not have any effect due to a bug in
       the subclassing of the window. Removed the unneccesary subclassing.
     * Translate method did not effect other forms, added TranslateApp variable
     * Deleting translated components at design-time could sometime give a GPF
     * The 'Copy From' selected language did not work as it should
     * Added the GetTranslation method
     * Helpfile updates
     * Added support for self translations, Localized language names
     * Updated prices, README.TXT and ORDER.EXE
1.10 Added new features and corrected two bugs.
     * A new property AdoptOn
     * The help system is totaly revised
     * Two step by step tutorials
     * Added Key words for Delphi
     * Grid style of values in the Property Editor
     * Copy property values from other forms.
     * File system totally revised (Also fixed the bug with NTFS partitions)
     * Less resource intence by reuse of string values
     * Look up table for soundex search of other forms values
     * Fixed a bug when editing Font names in the Property Editor
     * New Installation and un-install instructions in Help file
     * Many new topics added to help file
     * Expand All buttons added
     * Added a new property (FLookupText) for remembering the last state
     * Added a new property (FLastValue) for remembering the last sel. language
     * Removed the MASTAPP example which did not really show how it works
     * Removed the Simple and Advanced feature in the Property editor
     * Changed the display from date to Nr of days left in About (Shareware)
     * New registration rules and guidelines
     * It is now possible to have many TMultLang components on the same form
1.01 Updated instructions, was never really released to the public.
1.00 Initial release.


7   CONTACT US
If you find any bug, please contact us and we will try to resolve it ASAP.
If you have any suggestions or if you think we have missed something, we will 
happily implement that as an additional feature in future versions.

We hope you will find the packages useful and easy to use. if you dont find it 
useful we still like to have your comments, bad or good.
It is difficult to develop components without any suggestions, directions and 
the most important, knowing what you developers need in your situations.

Lingscape
Langbrodalsvagen 3 c, II
S-125 34 ALVJSO
SWEDEN

Web: http://www.lingscape.com/
E-Mail: Support@lingscape.com
Tel +46 8 4496772
Fax +46 8 4496773
