Move PerlQt

1 files changed, 82 insertions, 0 deletions

diff --git a/PerlTQt/INSTALL b/PerlTQt/INSTALL
new file mode 100644
index 0000000..bad4e4a
--- /dev/null
+++ b/PerlTQt/INSTALL
@@ -0,0 +1,82 @@
+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 smokeqt.
+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 kdebindings       # downloads configure/makefile stubs
+$ cvs co kdebindings/kalyptus # for generating smoke files from scratch
+$ cvs co kdebindings/smoke    # pre-generated smoke library
+$ cd kdebindings              # kdebindings/
+$ cvs co admin                # get kde build tools
+
+At this point, you now have the full smokeqt 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/qt                 # kdebindings/smoke/qt/
+$ 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 ../..                    # kdebindings/
+$ make -f Makefile.cvs        # create ./configure, will croak but succeed
+$ ./configure                 # use --prefix or whatever options you want
+$ cd smoke                    # kdebindings/smoke/
+$ make                        # this should succeed
+$ make install                # will install to --prefix from configure
+
+Okay, you now have libsmokeqt 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 libsmokeqt 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>