various fixes
[lqt.git] / BUILD
blobff38d17d3aadbe3958bd2d7e84c8717c5f3ea31d
1 lqt is still in early development the version here is not complete or
2 stable and depends on GCC-XML which is rather old software with some
3 serious bugs. If you want lqt to "just work" I recommend to wait for
4 the new version in development.
5  
6  If you want to use it _right_now_, you can still use the gcc-xml version:
7   - install gccxml in the path. (f you can't you are out of luck, this
8  is why I want to eliminate it)
9   - clone the repo
10   - execute "lua generate_function.lua"
11   - edit qt_generator.lua
12   - include in the string at the end all the (qt) classes you need
13   - execute it (lua qt_generator.lua)
14   - if it does not fail (it invokes gccxml, so it could) it should have
15  created the sources of the bindings in the src directory
16   - if it fails could be because gccxml has been given wrong paths
17  (qt_generator.lua at line 114)
19  Other steps depend on what you want to do with the bindings. If you
20  want to use it as a module in a stand-alone lua, you can just use
21  cmake with the provided CMakeLists.txt, place the shared object in the
22  lua cpath and require it.
24  if you want bindings in your application just link to them and call
25  the initialization function of each of them on each of the lua_States
26  you have.
28  each file is completely independent from others and binds one single
29  qt class. you can bind them indipendently even in the same inheritance
30  tree (you can bind QPushButton and not QWidget). everything works
31  anyway.
33  *common.* files are required for each of the bindings.
34  *utils.* are used to export some functionality to lua (such as
35  ownership of objects, which must be taken care manually)
36  *function.* is a dirty hack to make it possible to connect a signal to
37  a lua function.