Adding a Frequently Asked Questions file

git-svn-id: svn+ssh://svn.code.sf.net/p/freeglut/code/trunk/freeglut/freeglut@714 7f0cb862-5218-0410-a997-914c9d46530a

diff --git a/FrequentlyAskedQuestions b/FrequentlyAskedQuestions
new file mode 100644 (file)
index 0000000..6261f1e
--- /dev/null
+++ b/FrequentlyAskedQuestions
@@ -0,0 +1,70 @@
+========== ===== ========= ===== ========\r
+FREQUENTLY ASKED QUESTIONS ABOUT freeglut\r
+========== ===== ========= ===== ========\r
+\r
+Last updated on November 28, 2006\r
+\r
+\r
+General Questions\r
+======= =========\r
+(1)  Will "freeglut" ever support (fill in the blank)?\r
+\r
+   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
+\r
+   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
+\r
+(#)  I have a question that is not answered here.  What do I do to get an answer?\r
+\r
+   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
+\r
+\r
+\r
+\r
+\r
+*nix Questions\r
+==== =========\r
+\r
+(1)  How I can build "freeglut" with debugging symbols and traces?\r
+\r
+   CFLAGS="-g $CFLAGS" LDFLAGS="-g $LDFLAGS" ./configure \\r
+           --enable-debug\r
+\r
+\r
+(2)  How can I have both a normal, and a debug-enabled version of "freeglut"?\r
+\r
+   cd ..\r
+   mkdir freeglut-normal\r
+   cd freeglut-normal\r
+   ../freeglut-2.x/configure\r
+   make\r
+   cd ..\r
+   mkdir freeglut-debug\r
+   CFLAGS="-g $CFLAGS" LDFLAGS="-g $LDFLAGS" \\r
+          ../freeglut-2.x/ configure --enable-debug [*]\r
+   make\r
+\r
+   [*] optionally use --program-suffix=dbg to have them coexist when installing\r
+\r
+\r
+(3)  My linking fails due to undefined symbols.  What libraries do I need to link?\r
+\r
+   Look at the generated libfreeglut.la or use libtool --link (see the libtool manual).\r
+\r
+\r
+\r
+\r
+\r
+Windows Questions\r
+======= =========\r
+\r
+(1)  My linking fails due to undefined symbols.  What libraries do I need to link?\r
+\r
+  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
+\r
+\r
+\r
+\r
+\r
+Other Operating System Questions\r
+===== ========= ====== =========\r
+\r