You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
libtqt-perl/PerlTQt/INSTALL

83 lines
3.6 KiB

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>