Fixing the build after Diederick Niehorster's full screen fixes: they are only valid...
[freeglut] / FrequentlyAskedQuestions
1 ========== ===== ========= ===== ========\r
2 FREQUENTLY ASKED QUESTIONS ABOUT freeglut\r
3 ========== ===== ========= ===== ========\r
4 \r
5 Last updated on November 28, 2006\r
6 \r
7 \r
8 General Questions\r
9 ======= =========\r
10 (1)  Will "freeglut" ever support (fill in the blank)?\r
11 \r
12    If the GLUT library supports the feature, "freeglut" should support it.  If "freeglut" does not support it and there is a call for it, then we are certainly open to adding it.\r
13 \r
14    If the GLUT library does not support the feature, "freeglut" is probably not going to.  The "freeglut" library was designed to be a drop-in replacement for GLUT, a lightweight and simple windowing system for the OpenGL Red Book demonstration programs and no more.  If you want a more functional windowing system we suggest that you look elsewhere.\r
15 \r
16 (#)  I have a question that is not answered here.  What do I do to get an answer?\r
17 \r
18    Check the "README" files that came with the distribution.  If the question is not addressed there, please post it on the "freeglut-developer" mailing list on the Source Forge web site.\r
19 \r
20 \r
21 \r
22 \r
23 \r
24 *nix Questions\r
25 ==== =========\r
26 \r
27 (1)  How I can build "freeglut" with debugging symbols and traces?\r
28 \r
29    CFLAGS="-g $CFLAGS" LDFLAGS="-g $LDFLAGS" ./configure \\r
30            --enable-debug\r
31 \r
32 \r
33 (2)  How can I have both a normal, and a debug-enabled version of "freeglut"?\r
34 \r
35    cd ..\r
36    mkdir freeglut-normal\r
37    cd freeglut-normal\r
38    ../freeglut-2.x/configure\r
39    make\r
40    cd ..\r
41    mkdir freeglut-debug\r
42    CFLAGS="-g $CFLAGS" LDFLAGS="-g $LDFLAGS" \\r
43           ../freeglut-2.x/ configure --enable-debug [*]\r
44    make\r
45 \r
46    [*] optionally use --program-suffix=dbg to have them coexist when installing\r
47 \r
48 \r
49 (3)  My linking fails due to undefined symbols.  What libraries do I need to link?\r
50 \r
51    Look at the generated libfreeglut.la or use libtool --link (see the libtool manual).\r
52 \r
53 \r
54 \r
55 \r
56 \r
57 Windows Questions\r
58 ======= =========\r
59 \r
60 (1)  My linking fails due to undefined symbols.  What libraries do I need to link?\r
61 \r
62   All the required libraries (and a couple of unnecessary ones) should be automatically included thanks to the "#pragma comment (lib" statements in "freeglut_std.h".  If your linking fails due to undefined symbols, there is an excellent chance that "freeglut" is not the culprit.\r
63 \r
64 \r
65 \r
66 \r
67 \r
68 Other Operating System Questions\r
69 ===== ========= ====== =========\r
70 \r