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/kalyptus
Timothy Pearson 9778efc390
Rename a number of libraries and executables to avoid conflicts with KDE4
12 years ago
..
Ast.pm Initial import of libqt-perl (not yet TQt compatible) 13 years ago
ChangeLog Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
Iter.pm Initial import of libqt-perl (not yet TQt compatible) 13 years ago
Makefile.cvs Update embedded kalyptus installation 13 years ago
Makefile.in Update embedded kalyptus installation 13 years ago
README Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
TODO Initial import of libqt-perl (not yet TQt compatible) 13 years ago
Version Initial import of libqt-perl (not yet TQt compatible) 13 years ago
configure.in Update embedded kalyptus installation 13 years ago
dcopidlng Update embedded kalyptus installation 13 years ago
findperl Update embedded kalyptus installation 13 years ago
install-sh Update embedded kalyptus installation 13 years ago
kalyptus Fix FTBFS 12 years ago
kalyptus.spec.in Rename include subdirectory to tde 13 years ago
kalyptusCxxToCSharp.pm Update embedded kalyptus installation 13 years ago
kalyptusCxxToDcopIDL.pm Update embedded kalyptus installation 13 years ago
kalyptusCxxToECMA.pm Update embedded kalyptus installation 13 years ago
kalyptusCxxToJNI.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kalyptusCxxToJava.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kalyptusCxxToKimono.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kalyptusCxxToSmoke.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kalyptusCxxToSwig.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kalyptusDataDict.pm Rename a number of libraries and executables to avoid conflicts with KDE4 12 years ago
kdocAstUtil.pm Update embedded kalyptus installation 13 years ago
kdocLib.pm Rename KApplication to TDEApplication to avoid conflicts with KDE4 12 years ago
kdocParseDoc.pm Update embedded kalyptus installation 13 years ago
kdocUtil.pm Update embedded kalyptus installation 13 years ago
perlbin Update embedded kalyptus installation 13 years ago

README

KALYPTUS -- C, Objective-C and Java bindings generator

Version 0.9

KALYPTUS creates language bindings for Qt and KDE C++ libraries
directly from the headers. Documentation embedded in special doc
comments in the source is translated to an appropriate format for
the target language.

REQUIREMENTS

You need perl 5.005 or greater to run kalyptus.

HOWTO

If you are running this straight from CVS, you will need to run 

	make -f Makefile.cvs

before building.

This should install kalyptus:

./configure; make; make install

CREDITS
-------

Richard Dale - kdoc adaption, C/Objective-C/Java code generation.

Sirtaj Singh Kang for writing the original kdoc utility (kalyptus was
derived from kdoc).

Copyright(C) 2001, Lost Highway Ltd

------

Copyright(C) 1999, Sirtaj Singh Kang <taj@kde.org>
Distributed under the GPL.

NOTES ON USING THE CONVERTER
----------------------------

JAVA
----

Here are some of the shell commands that were used in the conversion process:

Remove any TQ_OVERRIDE macros from the Qt headers, and remove EXPORT_DOCKCLASS from the
KDE headers

# Generate Java and C++ sources. Copy all the target headers to directory 'test/tmp'
kalyptus -fjava test/tmp/*.h test/tmp/dom/*.h test/tmp/kio/*.h test/tmp/tdeprint/*.h \
   test/tmp/kjs/*.h test/tmp/tdeparts/*.h test/tmp/tdesu/*.h test/ktextedit/*.h test/tmp/libtdemid/*.h

# Shorten generated filenames
mv DOM__Node.cpp DOMNode.cpp
mv DOM__Node.java DOMNode.java
mv DOM__Document.cpp DOMDocument.cpp
mv DOM__Document.java DOMDocument.java
for FILE in *__* ; do
 NAME=`echo $FILE | sed -e 's/^.*__//'`;
 echo $NAME;
 mv $FILE $NAME;
done
mv SlaveInterface.cpp Slave.cpp
mv SlaveInterface.java Slave.java

# Edit and Compile the generated java
cd kdejava/koala/org/kde/koala
make

# Build C++ JNI .h header files
cd qtjava/javalib/org/kde/qt
for FILE in *.class ; do NAME=`echo $FILE | sed 's/.class//'`; echo $NAME; javah  -classpath '../../..' org.kde.qt.$NAME ; done
for FILE in org_kde* ; do NAME=`echo $FILE | sed -e 's/org_kde_qt_//'`; echo $NAME; mv $FILE $NAME; done

cd kdejava/koala/org/kde/koala
for FILE in *.class ; do NAME=`echo $FILE | sed 's/.class//'`; echo $NAME; javah  -classpath '../../..:../../../../../qtjava/javalib/qtjava.jar' org.kde.koala.$NAME ; done
for FILE in org_kde* ; do NAME=`echo $FILE | sed -e 's/org_kde_koala_//'`; echo $NAME; mv $FILE $NAME; done
# Copy headers to kdejava/koala/kdejava

# Check that  the JNI .h function names match the .cpp ones
cd kdejava/koala/org/kde/koala
grep ^Java_ *.cpp | sed -e 's/^[^:]*:\([^(]*\).*/\1/'  | grep -v '[/]' | sort | uniq > cpp.fns
grep Java_ *.h | awk '{ print $4 }' |  grep -v '[/]' | sort | uniq > h.fns
kompare h.fns cpp.fns
# Reconcile and fix any differences

# Edit and compile the generated .cpp and .h files with KDevelop