PerlTQt is distributed under the GPL. Development is coordinated on the kde-perl@mail.kde.org mailing-list. To subscribe, visit http://mail.kde.org/mailman/listinfo/kde-perl or send a subscribe message to kde-perl-request@mail.kde.org. Please send patches and bug reports to the mailing-list. This file contains instructions for downloading and building the SmokeTQt library and PerlTQt. PerlTQt is not a direct Perl interface to the TQt library, but is rather an interface to the SmokeTQt library generated by Kalyptus. The programs+version I use, but not necessarily required: Linux (oddly enough, most of the developers use Mandrake) Perl-5.6.0 or above (tested up to 5.8.0-RC1) TQt-3.0.1 or above (untested with 3.0.0, should work though) automake-1.5 (KDE requires recent automake) autoconf-2.53 (KDE requires recent autoconf) Make sure your $TQTDIR environment-variable is set. I'm sorry for all the requirements, but you *are* getting this from CVS. Release versions will be much easier and more independant. First, you need to download the development environment for smoketqt. Please use compression for cvs downloads ('cvs -z4' in .cvsrc). $ export CVSROOT=:pserver:anonymous@anoncvs.kde.org:/home/kde $ cvs login # no password $ cvs co -l tdebindings # downloads configure/makefile stubs $ cvs co tdebindings/kalyptus # for generating smoke files from scratch $ cvs co tdebindings/smoke # pre-generated smoke library $ cd tdebindings # tdebindings/ $ cvs co admin # get kde build tools At this point, you now have the full smoketqt environment. The pre-generated smoke library is based off KDE's copy of TQt-3.0.4. I have TQt-3.0.1, so I have to re-generate the files to match my installed version of TQt. Here's how to do it. $ cd smoke/tqt # tdebindings/smoke/tqt/ $ perl ./qtguess.pl # simple script to find disabled TQt features $ perl ./generate.pl # calls kalyptus which generates code Now you have the SmokeTQt source-code generated for your personal TQt configuration. Here's how to compile. $ cd ../.. # tdebindings/ $ make -f Makefile.cvs # create ./configure, will croak but succeed $ ./configure # use --prefix or whatever options you want $ cd smoke # tdebindings/smoke/ $ make # this should succeed $ make install # will install to --prefix from configure Okay, you now have libsmoketqt installed on your system. You can now compile PerlTQt. First, get the latest version of PerlTQt-3. $ export CVSROOT=:pserver:anonymous@cvs.perlqt.sf.net:/cvsroot/perlqt $ cvs login # no password $ cvs co PerlTQt-3 $ cd PerlTQt-3 # PerlTQt-3/ If you installed libsmoketqt in a non-standard library path, you will need to edit Makefile.PL and add -L/your/lib/path to the LIBS parameter. If any of the other options in Makefile.PL need changing for your system, you will need to change it now. $ perl Makefile.PL $ make Now PerlTQt is built on your system. To test it out: $ cd tutorials # PerlTQt-3/tutorials/ $ perl runall.pl All 14 tutorials should run in order. As you close one program out by clicking Quit or the window close button, the next should start. If all 14 tutorials run without error and work like the C++ version, PerlTQt is built correctly and you can make install if you wish. If an error occurs which you can't fix, contact the kde-perl mailing list and make a bug report. Good luck, Ashley Winters