|
|
|
|
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 <qaqortog@nwlink.com>
|
