2. Installation and start up instructions

On all supported platforms TrEd requires Perl to be installed and Tk toolkit (a library of GUI functions). Installation of these tools is different on all supported platforms. Installation of TrEd itself is platform-independent.

To install Perl/Tk on your system follow instructions for your platform below:

2.1. Windows

  1. Start with installing Perl support to Windows from ActiveState. This is done by running the installation program APi522e.exe. You can find it in the Tools\Tree_Editors\Tred\PerlTk directory on the Prague Dependency Trebank CD-ROM or download it directly from ActiveState. Follow the instructions of the installation program. (When the installation is done, you may need to restart Windows, so that all the changes take effect.)

  2. In this step you add Tk library to Perl. If you have on-line connection to the Internet you may install the latest Tk toolkit from ActiveState's site in the following steps:

    1. Open a command prompt (MS-DOS prompt in Windows 9x/ME)

    2. Type ppm (press Enter)

    3. Type install Tk (press Enter)

    4. When the installation of Tk library is finished, type exit (press Enter)

    5. Close the command prompt

    If you do not have on-line connection to the Internet, please, follow these steps:

    1. Open a command prompt (MS-DOS prompt in Windows 9x/ME)

    2. Change directory to Tools\Tree_Editors\Tred\PerlTk on the Prague Dependency Treebank CD, i.e. if your CD-ROM drive is D:, type

      cd D:\Tools\Tree_Editors\Tred\PerlTk
      Under Windows 9x you may need to use command
      cd D:\Tools\Tree_~1\Tred\PerlTk

    3. Type ppm install Tk.ppd (press Enter)

    4. Close the command prompt when the installation of Tk library is finished.

  3. In this step you install TrEd itself. It is done by copying the whole Tred folder from the Prague Dependency Treebank CD (Tools\Tree_Editors\Tred\Tred) somewhere on your hard-disk, e.g. to folder C:\Program Files. To run TrEd double-click the tred.pl icon in the Tred folder on your hard-disk. (You may also want to create a shortcut on your desktop).

2.2. Linux

This instructions apply only to RedHat Linux 6.x or derived distributions. If you use other distribution, follow the general UNIX instructions below.

RedHat Linux 6.x contains Perl 5.005_03, RedHat Linux 7.x contains Perl 5.6 in default installation. Make sure, that you have correctly installed Perl RPM packages. If so, you may now install PerlTk toolkit and TrEd:

  1. To install PerlTk, as a root issue the following command from the Tools/Tree_Editors/Tred/PerlTk directory on the CD:

    root# rpm -i perl-Tk-800.018-1.i386.rpm
    in case you are using RedHat Linux 6.x distributions or
    root# rpm -i perl-Tk-800.022-11.i386.rpm
    in case of RedHat Linux 7.x.

  2. To install TrEd, the whole Tred folder from the CD (Tools/Tree_Editors/Tred/Tred) somewhere on your file-system, e.g. to your home directory or /opt directory.

    Note

    You may also wish to install the tred executable to some directory on your PATH. In that case you only have to provide a way for TrEd to find its library files. It can be achieved either by setting the TREDHOME variable to point to the location where you have made a copy of the Tred/Tredlib directory, or by copying the tred executable and the tredlib directory into the directories bin and lib respectively, on the same level of the directory structure.

  3. Run TrEd by issuing the command tred. (See Section 8..)

2.3. UNIX based systems

Almost every UNIX/Linux system contains Perl in default installation, so we may expect that you have already Perl installed on your box and you only need to install PerlTk toolkit and TrEd:

  1. To install PerlTk toolkit, untar the Tk800.022.tar.gz archive to some temporary directory, e.g. with the following command:


          $ gunzip -c Tk800.022.tar.gz | tar -x
        
    and issue the following commands (see file INSTALL in the Tk800.022 directory for details):
    bash$ cd Tk800.022
    bash$ perl Makefile.PL
    bash$ make
    bash$ make test1
    bash$ su2
    root# make install
        
    1

    this is only to test the compilation, you may skip it

    2

    gain root's privileges

  2. Installation of TrEd on a UNIX box is same as on Linux. To install TrEd, the whole Tred folder from the CD (Tools/Tree_Editors/Tred/Tred) somewhere on your file-system, e.g. to your home directory or /opt directory.

    Note

    You may also wish to install the tred executable to some directory in your PATH. In that case you have to provide a way for TrEd to find its library files. It can be achieved either by setting the TREDHOME variable to point to the location where you have made a copy of the Tred/Tredlib directory, or by copying the tred executable and the Tredlib directory into the directories bin and lib respectively, on the same level of directory structure. (The same holds for the btred executable.)

  3. TrEd is ran by executing the tred executable or typing perl tred (in the later case full-path to tred should be specified). See details in Section 8..

    Note

    If executing of the tred executable fails, try to change the first (#!/usr/bin/perl) line to point to your Perl executable. If you find TrEd halting immediately, complaining about Tk.pm module, check PerlTk installation path. You may need to setup PERLLIB variable to point to the site_perl directory on your system to which the Tk.pm module was installed.