Back to the docs page Previous Next Building on Linux
TroubleshootingI get a compiler error in GImage.cpp about png.h not found.
You need to install the libpng3-dev package.
I get a compiler error about sdl-config not found, or SDL/SDL.h not found.
You need to install the libsdl1.2-dev package.
How do I build optimized binaries?
make opt
How do I build binaries with debug symbols?
make dbg
I'm trying to link GClasses.a with my app, and I get a linker error about png stuff not being found.
You need to add "-lpng" after "GClasses.a" to your linking command. Yes, order matters on this line.
I get build errors that look something like this: ../../obj/GClasses/dbg/GError.d:3: warning: overriding commands for target `GError.o' ../../obj/GClasses/opt/GError.d:3: warning: ignoring old commands for target `GError.o'
Try doing "make clean". That always fixes it for me. I cannot seem to figure out what causes this to happen. I think it has something to do with two concurrent processes writing to the ".d" file, but I don't know why that would happen. If you know a better solution, I'd love to hear about it.
How do I uninstall Waffles?
sudo make uninstall
Where can I get more specific help?
You can ask a question at our forum. If you
post a question and you do not get a speedy response, please email me. Sometimes the email that is supposed
to notify me that there is a new forum post is incorrectly classified as spam and discarded. (That's ironic,
since I'm trying to develop better ML algorithms, isn't it?) My email address is on the main page.
Why isn't Waffles in the apt-get/yum repositories?
There's a lot of red-tape involved in getting an
app into those repositories, and I'm too busy developing
Waffles to bother with it. If you would like to become
a package maintainer and do it, that would be a great
contribution, and I would really appreciate it.
How do I change the installation target directory?
Just change the "INSTALL_LOCATION_" variables at
the top of waffles/src/Makefile.
How do I build Waffles on a machine where I do not have sudo or root permissions?
Just do "make opt" instead of "sudo make install".
This will build everything, but will not install it.
You can run the binaries right out of the bin folder.
Alternatively, you could change the install location
as described in the previous question.
Why do you include the build dependencies for Windows, but not for Linux?
It is easy for Linux developers to get the
dependencies from package repositories. This method
is superior anyway because you get the latest versions.
Windows users often require a little extra hand-holding,
so I have made it extra convenient for them at the cost
of linking to outdated libraries, etc.
When I run some of the graphical apps, I get an error message about a "bad adaptive filter type" or "extra compressed data".
This appears to be caused by an old bug in the
libpng3-dev package. It does not repro with newer
versions. You should probably update your distro.
How do I debug a Waffles app with KDevelop?
If you use KDevelop3, go to "Project->Import Existing Project". After you run
through the wizard, go to "Project->Project
Options->Run Options" and fix the name of the executable binary. (The executable binary is in the bin folder, not the src folder. Use the binary that ends with "dbg". The one that doesn't end with dbg is the optimized one.) If you use KDevelop4, go to "Project->Open/Import Project". Choose the Makefile for the app you want to debug. Next, go to "Run->Configure Launches". Click on the name of the app. Click on the green plus sign. Specify the right executable binary. (The executable binary is in the bin folder, not the src folder. Use the binary that ends with "dbg". The one that doesn't end with dbg is the optimized one.) Previous Next Back to the docs page |