Installing MtScript

Contents

• 1. Required environment
• 2. Package contents
• 3. Documentation
• 4. Installation steps
• 5. Running MtScript
• 6. Problems with installation?

1. Required environment

- SUN SPARC - Solaris 1.x and 2.x: gcc 2.7.0 / a.out binaries
or
- Linux (Intel): Linux 1.1.64 / gcc 2.6.2 / a.out binaries (run on elf)

and
- X11 fonts for the languages supported (you can download the fonts from our server).

2. Package contents

The MtScript package includes:

• mtscript (binary file): MtScript program
• ml (directory/text files): language writing rules (rules.*) and transliteration rules (keys.*).
• fonts.alias (file): aliases for font names.
• 00README (text file): to be read first
• 00ABOUT (Multilingual text file, 1-octet and 2-octet encoding): MtScript description - to be read with MtScript
• 00ABOUT@ (text file): style file corresponding to 00ABOUT
• 00INSTALL (text file): how to install MtScript.
• 00RULES (text file): information about writing and transliteration rules
• 00TODO (text file): features under development.
• 00MANIFEST (text file): contents of the package
• 00AGREMENT (text file): user agreement
• 00-tk-tcl-license.terms (text file): Tcl/Tk license terms
• www_doc (directory/files.html): MtScript documentation as HTML files (this document)

3. Documentation

• MtScript WWW pages:
  
  
  • at <MtScript/>
  • using the HTML files included in the MtScript package www_doc directory
    
    
• Through the HELP menu of MtScript
• 00ABOUT multilingual text file that you can edit by:
  
  
  • using MtScript multilingual editor
    
  • using your favorite Text Editor (textedit, ed, vi, emacs, ...).
    However, note that if you use a text editor, the 8-bit and 16-bit coded characters will not be displayed properly.
    
    

4. Installation steps

The following must be installed in order to use MtScript:

• the `mtscript' binary
• the language rules
• the fonts

4.1. Installing the `mtscript' binary

The `mtscript' binary file can be placed anywhere on your workstation, for example, on /usr/bin

4.2. Language rules

The language rules are included in the "ml" directory of the package:

• rules.* files: Writing Rules
  (example: rules.fr: French writing rules, ...)
  
  
• keys.* files: Transliteration Rules
  (example: keys.fr: French transliteration rules, ...)

You must copy all of the "rules.*" and "keys.*" files to one of the following directories (note: all "rules.*" and "keys.*" files must be in the same directory):

• /usr/local/lib/ml
• or ~/.ml (in your home directory)
• or in any other directory

If you copy the files to either of the first two directories, you will be able to run MtScript from within any directory on your system. If you choose any other directory, it is necessary to run MtScript from within the directory where the rules files are stored.

4.3. Installing the Fonts

You can download the fonts in PCF format from our server, but all fonts used by MtScript are free and exist on many servers. It is possible that some of them already exist on your system.

You or your system administrator can move these fonts to an appropriate font directory (for example /usr/openwin/lib/X11/fonts, but since this is an alpha version, it is probably a better idea to place the fonts in your user home directory rather than in the system font directory).

A set of commands similar or identical to the following should be sufficient for properly storing the fonts:

xset +fp to add the new font directories
mkfontdir to create the font catalogues
etc ...

Once the fonts are stored, you can verify that all fonts are properly installed on your system by executing the command:

xfontsel

If you are not familiar with font installation, you should consult the X11 documentation, for example

man xset
(see options xset [-+]fp and xset fp[-+])

and/or ask your system administrator.

A note about font aliases:

For future portability to other platforms (Windows, Macintosh, ...), MtScript does not uses font names such as:

-etl-fixed-medium-r-normal-*-16-*-*-*-*-*-iso8859-1

but instead uses font aliases such as

iso_8859_1

The font aliases are included as a fonts.alias file in the MtScript package. You must install the font aliases by copying the file fonts.alias into the corresponding font directory of your system.

5. Running MtScript

To run MtScript simply type

mtscript

See Using MtScript for more options.

6. Problems with installation?

If you have any problem with the installation of MtScript, please let us know by contacting malek.boualem@orange.com

We cannot make a committment to routinely provide maintenance, support, updates, enhancements, or modifications for MtScript (see User Agreement), but we will attempt to meet user needs to the extent possible.