Installing Meat

Installation on Unix machines

First you have to download Meat (and possibly Tcl) if haven't done that already. The download page is here.

Installing Tcl/Tk

Installing the IBM classes for Unicode

In order to compile and run Meat, you need to set the environment variable LD_LIBRARY_PATH to include the directory where the icu libraries reside (usually /usr/local/icu/lib or something).

Note: The data files directory in this particular distribution seems to be broken. You have to manually copy the big endian files to their final destination:

cd icu/data
cp charBE.brk char.brk
cp line_thBE.brk line_th.brk
cp lineBE.brk line.brk
cp sentBE.brk sent.brk
cp word_thBE.brk word_th.brk
cp wordBE.brk word.brk

Installing the CRL Unicode library

Installing Meat

• We assume that you have downloaded the installation archive as /tmp/meat21.tgz
• Choose a directory where you want to install Meat. We assume this is /home/joe.
• Extract the archive using:
  cd /home/joe
gzip -cd /tmp/meat21.tgz | tar xfv -.
• Go to the toplevel directory of Meat:
  cd /home/joe/MEAT.
• Configure Meat by editing the file Makefile.cfg. These are the values to look for:
  • ENV: The environment you are compiling in. Valid values are solaris and linux.
  • MODE: The compilation mode. For development, this should be debug, for a runtime application, this should be final.
  • MUTT_ROOT: This should be /home/joe/meat2.1/UIO.
  • TCL_ROOT: Point this to the root of your Tcl/Tk installation.
• Check your implementation of the standard template library. The one that comes with gcc 2.95.1 (which is what we use) has a bug in the string implementation, that only shows up if you use basic strings with character elements other than char. As we use Unicode strings, you might have to edit the file /usr/local/include/g++/std/bastring.h. The diff is

  293,294c293
  <     { static const charT e=(charT)0;
  <       if (length () == 0) return &e; terminate (); return data (); }
  ---
  >     { if (length () == 0) return ""; terminate (); return data (); }
  

  Check carefully, as your implementation migth be different. The problem is in the method c_str(). Here, if the string is empty, the standard implementation returns "" which is fine for strings based on characters, but not for strings based on other elements.
• There is one more problem with the STL that showed up in the newest version and may lead to messages such as /usr/ccs/bin/as: "/tmp/cckrldWo.s", line 11755: error: can't compute value of an expression involving an external symbol. This only surfaces if compiling in final mode. In this case, recompile the affected files using debug mode, and everything should be fine...
• Create dependencies:
  make depend
• Compile Meat:
  gmake -k MODE=final if you want to compile in final mode, or
  gmake -k MODE=debug if you want to compile in debug mode.
  This should create a file Application/meat which is the Meat binary.
• install the binaries:
  make install
  This should leave meat and a tcl viewer in the bin directory.
• Make sure that the meat binary directory is in your path:
  setenv PATH ${PATH}:/home/joe/MEAT/bin.

Running Meat

To run sample translations in Turkish or Persian, follow these steps:

1. Go to the appropriate language directory: cd /home/joe/meat2.1/lang/tur or cd /home/joe/meat2.1/lang/per.
2. Start the user interface: Meat.tcl.
3. Select the language from the Language menu. Currently, we support Persian and Turkish in this package.
4. Press the button Recompile everything. This will take a while, depending on the language and your system.
5. Select a sentence directory by pressing Select. Select one example file and all the examples will be displayed in the list. The Turkish examples we provide are under
   .../lang/tur/corpus/txt
   All of the Turkish examples are text files (extension .txt). The Persian examples are under
   .../lang/per/corpus
   All of the Persian examples are in UTF8 encoding (extension .utf8)
   Note that the file selector box usually starts in language folder, so you should be able to get with a few clicks to the directory you want.
6. Select a specific sentence by double-clicking on one of the items in the list. The source language text will be displayed in the Source window (which is not quite readable for the UTF8 examples right now).
7. Translate the sentence by clicking on Translate. The result will be displayed in the Translation window.
8. If you are interested in how the sentence was analyzed, click on Viewer. This will open a chart window with several edges. This is usually only relevant for developers...
9. Quit using the File menu.

Uninstalling Meat

Installation on Windows

Download Meat (and Tcl) (the download page is here), and install them using the standard values. This will create a program group Meat.

Both systems are self-extracting archives. To install Meat you will need a lot of disk space (the package is approx. 85 MB).

Installing Tcl/Tk

• Assuming you downloaded the installation binary as c:\tmp\win76p2.exe, double-click on this file (e.g. in the Windows Explorer).
• The installation asks for an installation directory, c:\Program Files\TCL by default. No need to change that.
• Use the full installation
• If you want, you can add Wish to the start menu, but this is not essential.

Installing Meat

• We assume that the installation was downloaded as c:\tmp\Meat21.exe.
• Double-click that file (e.g. in the Explorer)
• Click Setup, then Next
• You can choose the installation directory. Again, we recommend leaving this in c:\Program Files\Meat
• Meat is automatically inserted in the Start Program list

To run properly, files with the extension .tcl need to be associated with the wish42.exe shell. If the installation doesn't do this automatically, you need to specify it. Open an explorer view of any directory, select View|Folder Options|File Types|New Type and select ``.tcl'' as associated extension. Choose New under the Actions window, specify ``open'' as action, and something like
"C:\Program Files\TCL\bin\wish42.exe" "%1"
in the Application field.

Running Meat

To run sample translations in Turkish or Persian, follow these steps:

1. Double-click on the item installed in the start menu. If there is no such item, the Meat user interface is under
   ...\bin\Meat.tcl
   (The ... symbolizes the installation directory)
2. Select a language from the Language menu. Currently, we support Persian and Turkish in this package.
3. Press the button Recompile everything. This will take a while, depending on the language and your system.
4. Select a sentence directory by pressing Select. Select one example file and all the examples will be displayed in the list. The Turkish examples we provide are under
   ...\lang\tur\corpus
   All of the Turkish examples are text files (extension .txt). The Persian examples are under
   ...\lang\per\corpus
   All of the Persian examples are in UTF8 encoding (extension .utf8)
   Note that the file selector box usually starts in the folder "My documents". To find documents for Meat, you need to click your way to the installation directory (normally "c:\Program Files\Meat" and start from there.
5. Select a specific sentence by double-clicking on one of the items in the list. The source language text will be displayed in the Source window (which is not quite readable for the UTF8 examples right now).
6. Translate the sentence by clicking on Translate. The result will be displayed in the Translation window.
7. If you are interested in how the sentence was analyzed, click on Viewer. This will open a chart window with several edges. This is usually only relevant for developers...
8. Quit using the File menu. (note: The Tcl/Tk file selector box seems to be broke under Windows 98. I get access violations...)

Uninstalling Meat