From 8aeed4867cb9a0f40a10c6af1ffdaee571aeb26b Mon Sep 17 00:00:00 2001 From: BST 2000 Tony Gale Date: Thu, 22 Jun 2000 16:46:25 +0000 Subject: Change filename. Add Section 3. Thu Jun 22 17:43:51 BST 2000 Tony Gale * docs/faq/gtk-faq.sgml: Change filename. Add Section 3. --- docs/faq/gtk-faq.sgm | 531 ------------------------------------ docs/faq/gtk-faq.sgml | 736 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 736 insertions(+), 531 deletions(-) delete mode 100644 docs/faq/gtk-faq.sgm create mode 100644 docs/faq/gtk-faq.sgml (limited to 'docs/faq') diff --git a/docs/faq/gtk-faq.sgm b/docs/faq/gtk-faq.sgm deleted file mode 100644 index 352cbc8647..0000000000 --- a/docs/faq/gtk-faq.sgm +++ /dev/null @@ -1,531 +0,0 @@ - - - - - June 21st 2000 - GTK+ FAQ - - - Tony - Gale - - - Shawn - Amundson - - - Emmanuel - Deloget - - - - This document is intended to answer questions that are - likely to be frequently asked by programmers using GTK+ or - people who are just looking at using GTK+. - - - - - - - - General Information - Here's a paragraph of text because it is stylistically poor - to start a section right after the chapter title. - - - - - - - Before anything else: the greetings - The FAQ authors want to thank: - - - Havoc Pennington - - - Erik Mouw - - - Owen Taylor - - - Tim Janik - - - Thomas Mailund Jensen - - - Joe Pfeiffer - - - Andy Kahn - - - Federico Mena Quntero - - - Damon Chaplin - - - and all the members of the GTK+ lists - - If we forgot you, please email us! Thanks again (I know, - it's really short :) - - - - - - Authors - The original authors of GTK+ were: - - - Peter Mattis - - - Spencer Kimball - - - Josh MacDonald - - - Since then, much has been added by others. Please see the - AUTHORS file in the distribution for the GTK+ Team. - - - - - - What is GTK+? - GTK+ is a small and efficient widget set designed with - the general look and feel of Motif. In reality, it looks much - better than Motif. It contains common widgets and some more - complex widgets such as a file selection, and color selection - widgets. - GTK+ provides some unique features. (At least, I know of - no other widget library which provides them). For example, a - button does not contain a label, it contains a child widget, - which in most instances will be a label. However, the child - widget can also be a pixmap, image or any combination possible - the programmer desires. This flexibility is adhered to - throughout the library. - - - - - - What is the + in GTK+? - Peter Mattis informed the gtk mailing list that: - I originally wrote gtk which included the three - libraries, libglib, libgdk and libgtk. It featured a flat - widget hierarchy. That is, you couldn't derive a new widget - from an existing one. And it contained a more standard - callback mechanism instead of the signal mechanism now present - in gtk+. The + was added to distinguish between the original - version of gtk and the new version. You can think of it as - being an enhancement to the original gtk that adds object - oriented features. - - - - - - Does the G in GTK+, GDK and GLib stand for? - GTK+ == Gimp Toolkit - GDK == GTK+ Drawing Kit - GLib == G Libray - - - - - - Where is the documentation for GTK+? - In the GTK+ distribution's doc/ directory you will find - the reference material for both GTK and GDK, this FAQ and the - GTK Tutorial. - In addition, you can find links to HTML versions of - these documents by going to - http://www.gtk.org/. A - packaged version of the GTK Tutorial, with SGML, HTML, - Postscript, DVI and text versions can be found in ftp://ftp.gtk.org/pub/gtk/tutorial - - There are now a couple of books available that deal with - programming GTK+, GDK and GNOME: - - Eric Harlows book entitled "Developing - Linux Applications with GTK+ and GDK". The ISBN is 0-7357-0021-4 - - The example code from Eric's book is - available on-line at - http://www.bcpl.net/~eharlow/book - - Havoc Pennington has released a book called - "GTK+/GNOME Application Development". The ISBN is 0-7357-0078-8 - The free version of the book lives here: http://developer.gnome.org/doc/GGAD/ - - And Havoc maintains information about it and - errata here: http://pobox.com/~hp/gnome-app-devel.html - - - - - - - - - Is there a mailing list (or mailing list archive) for - GTK+? - Information on mailing lists relating to GTK+ can be - found at: http://www.gtk.org/mailinglists.html - - - - - - - How to get help with GTK+ - First, make sure your question isn't answered in the - documentation, this FAQ or the tutorial. Done that? You're - sure you've done that, right? In that case, the best place to - post questions is to the GTK+ mailing list. - - - - - - How to report bugs in GTK+ - Bugs should be reported to the GNOME bug tracking system - (http://bugs.gnome.org). To - report a problem about GTK+, send mail to submit@bugs.gnome.org. - The subject of the mail should describe your problem. In - the body of the mail, you should first include a - "pseudo-header" that gives the package and version - number. This should be separated by a blank line from the - actual headers. - - Package: gtk+ - Version: 1.2.0 - - Substitute 1.2.0 with the version of GTK+ that you have installed. - Then describe the bug. Include: - - - Information about your system. For instance: - - What operating system and version - - What version of X - - For Linux, what version of the C library - - - And anything else you think is relevant. - - How to reproduce the bug. - If you can reproduce it with the testgtk program - that is built in the gtk/ subdirectory, that will be most - convenient. Otherwise, please include a short test program - that exhibits the behavior. As a last resort, you can also - provide a pointer to a larger piece of software that can - be downloaded. - (Bugs that can be reproduced within the GIMP are - almost as good as bugs that can be reproduced in - testgtk. If you are reporting a bug found with the GIMP, - please include the version number of the GIMP you are - using) - - If the bug was a crash, the exact text that was - printed out when the crash occured. - - Further information such as stack traces - may be useful, but are not necessary. If you do send a stack trace, - and the error is an X error, it will be more useful if the stacktrace is produced running - the test program with the --sync command line option. - - - - - - - - Is there a Windows version of GTK+? - There is an on going port of GTK+ to the Windows - platform which is making impressive progress. - See http://www.iki.fi/tml/gimp/win32 - for more information. - - - - - - What applications have been written with GTK+? - A list of some GTK+ based application can be found on - the GTK+ web server at http://www.gtk.org/apps/ - and contains more than 350 applications. - Failing that, look for a project to work on for the - GNOME project, http://www.gnome.org/ - Write a game. Write something that is useful. - Some of these are: - - - GIMP (http://www.gimp.org/), an - image manipulation program - - AbiWord (http://www.abisource.com/), - a professional word processor - - Gzilla (http://www.levien.com/gzilla/), - a web browser - - XQF (http://www.botik.ru/~roma/quake/), - a QuakeWorld/Quake2 server browser and launcher - - GDK Imlib (http://www.rasterman.com/imlib.html), - a fast image loading and manipulation library for GDK - - Glade (http://glade.pn.org/), a - GTK+ based RAD tool which produces GTK+ applications - - - - - - - - I'm looking for an application to write in GTK+. How - about an IRC client? - Ask on gtk-list for suggestions. There are at least - three IRC clients already under development (probably more in fact. The server at - - http://www.forcix.cx/irc-clients.html list a bunch of them). - - - X-Chat. - - girc. (Included with GNOME) - - gsirc. (In the gnome CVS tree) - - - - - - - - - How to find, configure, install, and troubleshoot GTK+ - - - - - - - What do I need to run GTK+? - To compile GTK+, all you need is a C compiler (gcc) and - the X Window System and associated libraries on your system. - - - - - - Where can I get GTK+? - The canonical site is ftp://ftp.gtk.org/pub/gtk. - This site tends to get busy around the time of a new - GTK+ release so try and use one of the mirror sites that are - listed in ftp://ftp.gtk.org/etc/mirrors - Here's a few mirror sites to get you started: - - - Africa - ftp://ftp.is.co.za/applications/gimp/ - - Australia - ftp://ftp.au.gimp.org/pub/gimp/ - - Finland - ftp://ftp.funet.fi/pub/sci/graphics/packages/gimp - - Germany - ftp://infosoc.uni-koeln.de/pub/ftp.gimp.org/ - - Japan - ftp://SunSITE.sut.ac.jp/pub/archives/packages/gimp/ - - UK - ftp://ftp.flirble.org/pub/X/gimp/ - - US - ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org/ - - - - - - - - How do I configure/compile GTK+? - Generally, all you will need to do is issue the commands: - - ./configure - make - - in the gtk+-version/ directory. - - - - - - When compiling GTK+ I get an error like: <literal>make: - file `Makefile' line 456: Syntax error</literal> - Make sure that you are using GNU make (use make - -v - to check). There are many weird and wonderful versions of make - out there, and not all of them handle the automatically - generated Makefiles. - - - - - - I've compiled and installed GTK+, but I can't get any - programs to link with it! - This problem is most often encountered when the GTK+ - libraries can't be found or are the wrong version. Generally, - the compiler will complain about an 'unresolved symbol'. - There are two things you need to check: - - - Make sure that the libraries can be - found. You want to edit /etc/ld.so.conf to - include the directories which contain the GTK libraries, - so it looks something like: - /usr/X11R6/lib - /usr/local/lib - - Then you need to run /sbin/ldconfig as root. You can - find what directory GTK is in using - - gtk-config --libs - - - If your system doesn't use ld.so to find libraries -(such as Solaris), then you will have to use the LD_LIBRARY_PATH -environment variable (or compile the path into your program, which I'm -not going to cover here). So, with a Bourne type shell you can do (if -your GTK libraries are in /usr/local/lib): - - export LD_LIBRARY_PATH=/usr/local/lib - - and in a csh, you can do: - - setenv LD_LIBRARY_PATH /usr/local/lib - - - Make sure the linker is finding the -correct set of libraries. If you have a Linux distribution that -installs GTK+ (e.g. RedHat 5.0) then this older version may be -used. Now (assuming you have a RedHat system), issue the -command - - rpm -e gtk gtk-devel - - You may also want to remove the packages that depend -on gtk (rpm will tell you which ones they are). If you don't have a RedHat Linux system, check to make sure -that neither /usr/lib or /usr/local/lib contain any of -the libraries libgtk, libgdk, libglib, or libgck. If they do exist, remove them -(and any gtk include files, such as /usr/include/gtk and /usr/include/gdk) -and reinstall gtk+. - - - - - - - - - When compiling programs with GTK+, I get compiler error - messages about not being able to find - <literal>glibconfig.h</literal>. - The header file "glibconfig.h" was moved to the - directory $exec_prefix/lib/glib/include/. $exec_prefix is the - directory that was specified by giving the --exec-prefix flags - to ./configure when compiling GTK+. It defaults to $prefix, - (specified with --prefix), which in turn defaults to /usr/local/. - - This was done because "glibconfig.h" includes - architecture dependent information, and the rest of the - include files are put in $prefix/include, which can be shared - between different architectures. - - GTK+ includes a shell script, /gtk-config/, that makes it - easy to find out the correct include paths. The GTK+ Tutorial - includes an example of using /gtk-config/ for simple - compilation from the command line. For information about more - complicated configuration, see the file docs/gtk-config.txt in - the GTK+ distribution. - - If you are trying to compile an old program, you may be - able to work around the problem by configuring it with a - command line like: - - setenv CPPFLAGS "-I/usr/local/include/glib/include" -./configure - - (Substitute the appropriate value of $exec_prefix for - /usr/local.) - - - - - - When installing a GTK+ application, configure reports - that it can't find GTK. - There are several common reasons for this: - - You have an old version of GTK installed - somewhere. RedHat 5.0, for example, installs an older copy of GTK that - may not work with the latest applications. You should remove this old - copy, but note that in the case of RedHat 5.0 this will - break the control-panel applications. - - gtk-config (or another - component of GTK) isn't in your path, or there is an old - version on your system. Type: - gtk-config --version - - to check for both of these. If it returns a value - different from what you expect, then you have an old - version of GTK on your system. - - The ./configure script can't find the GTK - libraries. As ./configure compiles various test programs, it needs to - be able to find the GTK libraries. See the question above - for help on this. - - - If none of the above help, then have a look in - config.log, which is generated by ./configure as it runs. At the - bottom will be the last action it took before failing. If it is a - section of source code, copy the source code to a file and compile it - with the line just above it in config.log. If the compilation is - successful, try executing it. - - - - - - - - diff --git a/docs/faq/gtk-faq.sgml b/docs/faq/gtk-faq.sgml new file mode 100644 index 0000000000..9495f7a629 --- /dev/null +++ b/docs/faq/gtk-faq.sgml @@ -0,0 +1,736 @@ + + + + + June 21st 2000 + GTK+ FAQ + + + Tony + Gale + + + Shawn + Amundson + + + Emmanuel + Deloget + + + + This document is intended to answer questions that are + likely to be frequently asked by programmers using GTK+ or + people who are just looking at using GTK+. + + + + + + + + General Information + Here's a paragraph of text because it is stylistically poor + to start a section right after the chapter title. + + + + + + + Before anything else: the greetings + The FAQ authors want to thank: + + + Havoc Pennington + + + Erik Mouw + + + Owen Taylor + + + Tim Janik + + + Thomas Mailund Jensen + + + Joe Pfeiffer + + + Andy Kahn + + + Federico Mena Quntero + + + Damon Chaplin + + + and all the members of the GTK+ lists + + If we forgot you, please email us! Thanks again (I know, + it's really short :) + + + + + + Authors + The original authors of GTK+ were: + + + Peter Mattis + + + Spencer Kimball + + + Josh MacDonald + + + Since then, much has been added by others. Please see the + AUTHORS file in the distribution for the GTK+ Team. + + + + + + What is GTK+? + GTK+ is a small and efficient widget set designed with + the general look and feel of Motif. In reality, it looks much + better than Motif. It contains common widgets and some more + complex widgets such as a file selection, and color selection + widgets. + GTK+ provides some unique features. (At least, I know of + no other widget library which provides them). For example, a + button does not contain a label, it contains a child widget, + which in most instances will be a label. However, the child + widget can also be a pixmap, image or any combination possible + the programmer desires. This flexibility is adhered to + throughout the library. + + + + + + What is the + in GTK+? + Peter Mattis informed the gtk mailing list that: + I originally wrote gtk which included the three + libraries, libglib, libgdk and libgtk. It featured a flat + widget hierarchy. That is, you couldn't derive a new widget + from an existing one. And it contained a more standard + callback mechanism instead of the signal mechanism now present + in gtk+. The + was added to distinguish between the original + version of gtk and the new version. You can think of it as + being an enhancement to the original gtk that adds object + oriented features. + + + + + + Does the G in GTK+, GDK and GLib stand for? + GTK+ == Gimp Toolkit + GDK == GTK+ Drawing Kit + GLib == G Libray + + + + + + Where is the documentation for GTK+? + In the GTK+ distribution's doc/ directory you will find + the reference material for both GTK and GDK, this FAQ and the + GTK Tutorial. + In addition, you can find links to HTML versions of + these documents by going to + http://www.gtk.org/. A + packaged version of the GTK Tutorial, with SGML, HTML, + Postscript, DVI and text versions can be found in ftp://ftp.gtk.org/pub/gtk/tutorial + + There are now a couple of books available that deal with + programming GTK+, GDK and GNOME: + + Eric Harlows book entitled "Developing + Linux Applications with GTK+ and GDK". The ISBN is 0-7357-0021-4 + + The example code from Eric's book is + available on-line at + http://www.bcpl.net/~eharlow/book + + Havoc Pennington has released a book called + "GTK+/GNOME Application Development". The ISBN is 0-7357-0078-8 + The free version of the book lives here: http://developer.gnome.org/doc/GGAD/ + + And Havoc maintains information about it and + errata here: http://pobox.com/~hp/gnome-app-devel.html + + + + + + + + + Is there a mailing list (or mailing list archive) for + GTK+? + Information on mailing lists relating to GTK+ can be + found at: http://www.gtk.org/mailinglists.html + + + + + + + How to get help with GTK+ + First, make sure your question isn't answered in the + documentation, this FAQ or the tutorial. Done that? You're + sure you've done that, right? In that case, the best place to + post questions is to the GTK+ mailing list. + + + + + + How to report bugs in GTK+ + Bugs should be reported to the GNOME bug tracking system + (http://bugs.gnome.org). To + report a problem about GTK+, send mail to submit@bugs.gnome.org. + The subject of the mail should describe your problem. In + the body of the mail, you should first include a + "pseudo-header" that gives the package and version + number. This should be separated by a blank line from the + actual headers. + + Package: gtk+ + Version: 1.2.0 + + Substitute 1.2.0 with the version of GTK+ that you have installed. + Then describe the bug. Include: + + + Information about your system. For instance: + + What operating system and version + + What version of X + + For Linux, what version of the C library + + + And anything else you think is relevant. + + How to reproduce the bug. + If you can reproduce it with the testgtk program + that is built in the gtk/ subdirectory, that will be most + convenient. Otherwise, please include a short test program + that exhibits the behavior. As a last resort, you can also + provide a pointer to a larger piece of software that can + be downloaded. + (Bugs that can be reproduced within the GIMP are + almost as good as bugs that can be reproduced in + testgtk. If you are reporting a bug found with the GIMP, + please include the version number of the GIMP you are + using) + + If the bug was a crash, the exact text that was + printed out when the crash occured. + + Further information such as stack traces + may be useful, but are not necessary. If you do send a stack trace, + and the error is an X error, it will be more useful if the stacktrace is produced running + the test program with the --sync command line option. + + + + + + + + Is there a Windows version of GTK+? + There is an on going port of GTK+ to the Windows + platform which is making impressive progress. + See http://www.iki.fi/tml/gimp/win32 + for more information. + + + + + + What applications have been written with GTK+? + A list of some GTK+ based application can be found on + the GTK+ web server at http://www.gtk.org/apps/ + and contains more than 350 applications. + Failing that, look for a project to work on for the + GNOME project, http://www.gnome.org/ + Write a game. Write something that is useful. + Some of these are: + + + GIMP (http://www.gimp.org/), an + image manipulation program + + AbiWord (http://www.abisource.com/), + a professional word processor + + Gzilla (http://www.levien.com/gzilla/), + a web browser + + XQF (http://www.botik.ru/~roma/quake/), + a QuakeWorld/Quake2 server browser and launcher + + GDK Imlib (http://www.rasterman.com/imlib.html), + a fast image loading and manipulation library for GDK + + Glade (http://glade.pn.org/), a + GTK+ based RAD tool which produces GTK+ applications + + + + + + + + I'm looking for an application to write in GTK+. How + about an IRC client? + Ask on gtk-list for suggestions. There are at least + three IRC clients already under development (probably more in fact. The server at + + http://www.forcix.cx/irc-clients.html list a bunch of them). + + + X-Chat. + + girc. (Included with GNOME) + + gsirc. (In the gnome CVS tree) + + + + + + + + + How to find, configure, install, and troubleshoot GTK+ + + + + + + + What do I need to run GTK+? + To compile GTK+, all you need is a C compiler (gcc) and + the X Window System and associated libraries on your system. + + + + + + Where can I get GTK+? + The canonical site is ftp://ftp.gtk.org/pub/gtk. + This site tends to get busy around the time of a new + GTK+ release so try and use one of the mirror sites that are + listed in ftp://ftp.gtk.org/etc/mirrors + Here's a few mirror sites to get you started: + + + Africa - ftp://ftp.is.co.za/applications/gimp/ + + Australia - ftp://ftp.au.gimp.org/pub/gimp/ + + Finland - ftp://ftp.funet.fi/pub/sci/graphics/packages/gimp + + Germany - ftp://infosoc.uni-koeln.de/pub/ftp.gimp.org/ + + Japan - ftp://SunSITE.sut.ac.jp/pub/archives/packages/gimp/ + + UK - ftp://ftp.flirble.org/pub/X/gimp/ + + US - ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org/ + + + + + + + + How do I configure/compile GTK+? + Generally, all you will need to do is issue the commands: + + ./configure + make + + in the gtk+-version/ directory. + + + + + + When compiling GTK+ I get an error like: <literal>make: + file `Makefile' line 456: Syntax error</literal> + Make sure that you are using GNU make (use make + -v + to check). There are many weird and wonderful versions of make + out there, and not all of them handle the automatically + generated Makefiles. + + + + + + I've compiled and installed GTK+, but I can't get any + programs to link with it! + This problem is most often encountered when the GTK+ + libraries can't be found or are the wrong version. Generally, + the compiler will complain about an 'unresolved symbol'. + There are two things you need to check: + + + Make sure that the libraries can be + found. You want to edit /etc/ld.so.conf to + include the directories which contain the GTK libraries, + so it looks something like: + /usr/X11R6/lib + /usr/local/lib + + Then you need to run /sbin/ldconfig as root. You can + find what directory GTK is in using + + gtk-config --libs + + + If your system doesn't use ld.so to find libraries +(such as Solaris), then you will have to use the LD_LIBRARY_PATH +environment variable (or compile the path into your program, which I'm +not going to cover here). So, with a Bourne type shell you can do (if +your GTK libraries are in /usr/local/lib): + + export LD_LIBRARY_PATH=/usr/local/lib + + and in a csh, you can do: + + setenv LD_LIBRARY_PATH /usr/local/lib + + + Make sure the linker is finding the +correct set of libraries. If you have a Linux distribution that +installs GTK+ (e.g. RedHat 5.0) then this older version may be +used. Now (assuming you have a RedHat system), issue the +command + + rpm -e gtk gtk-devel + + You may also want to remove the packages that depend +on gtk (rpm will tell you which ones they are). If you don't have a RedHat Linux system, check to make sure +that neither /usr/lib or /usr/local/lib contain any of +the libraries libgtk, libgdk, libglib, or libgck. If they do exist, remove them +(and any gtk include files, such as /usr/include/gtk and /usr/include/gdk) +and reinstall gtk+. + + + + + + + + + When compiling programs with GTK+, I get compiler error + messages about not being able to find + <literal>glibconfig.h</literal>. + The header file "glibconfig.h" was moved to the + directory $exec_prefix/lib/glib/include/. $exec_prefix is the + directory that was specified by giving the --exec-prefix flags + to ./configure when compiling GTK+. It defaults to $prefix, + (specified with --prefix), which in turn defaults to /usr/local/. + + This was done because "glibconfig.h" includes + architecture dependent information, and the rest of the + include files are put in $prefix/include, which can be shared + between different architectures. + + GTK+ includes a shell script, /gtk-config/, that makes it + easy to find out the correct include paths. The GTK+ Tutorial + includes an example of using /gtk-config/ for simple + compilation from the command line. For information about more + complicated configuration, see the file docs/gtk-config.txt in + the GTK+ distribution. + + If you are trying to compile an old program, you may be + able to work around the problem by configuring it with a + command line like: + + setenv CPPFLAGS "-I/usr/local/include/glib/include" +./configure + + (Substitute the appropriate value of $exec_prefix for + /usr/local.) + + + + + + When installing a GTK+ application, configure reports + that it can't find GTK. + There are several common reasons for this: + + You have an old version of GTK installed + somewhere. RedHat 5.0, for example, installs an older copy of GTK that + may not work with the latest applications. You should remove this old + copy, but note that in the case of RedHat 5.0 this will + break the control-panel applications. + + gtk-config (or another + component of GTK) isn't in your path, or there is an old + version on your system. Type: + gtk-config --version + + to check for both of these. If it returns a value + different from what you expect, then you have an old + version of GTK on your system. + + The ./configure script can't find the GTK + libraries. As ./configure compiles various test programs, it needs to + be able to find the GTK libraries. See the question above + for help on this. + + + If none of the above help, then have a look in + config.log, which is generated by ./configure as it runs. At the + bottom will be the last action it took before failing. If it is a + section of source code, copy the source code to a file and compile it + with the line just above it in config.log. If the compilation is + successful, try executing it. + + + + + + + + Development of GTK+ + + + + + + + Whats this CVS thing that everyone keeps talking about, + and how do I access it? + CVS is the Concurent Version System and is a very + popular means of version control for software projects. It is + designed to allow multiple authors to be able to + simultanously operate on the same source tree. This source + tree is centrally maintained, but each developer has a local + mirror of this repository that they make there changes to. + The GTK+ developers use a CVS repository to store the + master copy of the current development version of GTK+. As + such, people wishing to contribute patches to GTK+ should + generate them against the CVS version. Normal people should + use the packaged releases. + The CVS toolset is available as RPM packages from the + usual RedHat sites. The latest version is available at http://download.cyclic.com/pub/ + + Anyone can download the latest CVS version of GTK+ by + using anonymous access using the following steps: + + In a bourne shell descendant (e.g. bash) type: + CVSROOT=':pserver:anonymous@anoncvs.gnome.org:/cvs/gnome' +export CVSROOT + + Next, the first time the source tree is + checked out, a cvs login is needed. + cvs login + This will ask you for a password. There is no + password for cvs.gimp.org, so just enter a carriage return. + + To get the tree and place it in a subdir of your + current working directory, issue the command: + cvs -z3 get gtk+ + Note that with the GTK+ 1.1 tree, glib has been moved to + a separate CVS module, so if you don't have glib installed you will + need to get that as well: + cvs -z3 get glib + + + + + + + + How can I contribute to GTK+? + It's simple. If something doesn't work like you think it + should in a program, check the documentation to make sure + you're not missing something. If it is a true bug or missing + feature, track it down in the GTK+ source, change it, and + then generate a patch in the form of a 'context diff'. This + can be done using a command such as diff -ru + <oldfile> <newfile>. Then upload the patchfile to: + ftp://ftp.gtk.org/incoming + along with a README file. Make sure you follow the + naming conventions or your patch will just be deleted! The + filenames should be of this form: + gtk<username>-<date yymmdd-n>.patch.gz +gtk-<username>-<date yymmdd-n>.patch.README + The "n" in the date indicates a unique number (starting + from 0) of patches you uploaded that day. It should be 0, + unless you upload more than one patch in the same day. + + Example: + gtk-gale-982701-0.patch.gz +gtk-gale-982701-0.patch.README + Once you upload anything, send the README to ftp-admin@gtk.org + + + + + + How do I know if my patch got applied, and if not, why + not? + Uploaded patches will be moved to + ftp://ftp.gtk.org/pub/gtk/patches where one of the + GTK+ development team will pick them up. If applied, they will + be moved to /pub/gtk/patches/old. + Patches that aren't applied, for whatever reason, are + moved to /pub/gtk/patches/unapplied or + /pub/gtk/patches/outdated. At this point you can ask + on the gtk-list mailing list why your patch wasn't + applied. There are many possible reasons why patches may not + be applied, ranging from it doesn't apply cleanly, to it isn't + right. Don't be put off if your patch didn't make it first + time round. + + + + + + What is the policy on incorporating new widgets into + the library? + This is up to the authors, so you will have to ask them + once you are done with your widget. As a general guideline, + widgets that are generally useful, work, and are not a + disgrace to the widget set will gladly be included. + + + + + + Is anyone working on bindings for languages other than + C? + The GTK+ home page (http://www.gtk.org/) + presents a list of GTK+ bindings. + + There are several C++ wrappers for GTK+. + + the gtk-- package, which is a very small wrapper for GTK+. + You can find the home page at + http://www.cs.tut.fi/~p150650/gtk/gtk--.html. The FTP site is + + ftp://ftp.gtk.org/pub/gtk/gtk--. + + the VDK package, which was built as + the base package of a GTK+ application Borland-like + builder. The home page can be found at + http://www.guest.net/homepages/mmotta/VDKHome. + + + The wxWindows/Gtk package, a free C++ library for cross-platform + GUI development. The home page of this package is + + http://www.freiburg.linux.de/~wxxt/. + + + + There are three known Objective-c + bindings currently in development: + + The http://www.gnome.org/ + package of choice is objgtk. Objgtk is based on the Object class and is maintained by + Elliot Lee. Apparently, + objgtk is being accepted as the `standard' Objective-C binding for GTK+. + + + If you are more inclined towards the + GNUstep project, + you may want to check out GTKKit by + Helge Heß. + The intention is to setup a GTK+ binding using the FoundationKit. + GTKKit includes nicities like writing a XML-type template file to + construct a GTK+ interface. + + + The GToolKit package, which can be found at + + ftp://ftp.gtk.org/pub/gtk/objc-gtoolkit/. + + + + Perl bindings ftp://ftp.gtk.org/pub/gtk/perl + + Guile bindings. The home page is at + http://www.ping.de/sites/zagadka/guile-gtk. + By the way, Guile is the GNU Project's implemention of R4RS Scheme (the + standard). If you like Scheme, you may want to take a look at this. + + David Monniaux reports: + I've started a gtk-O'Caml binding system. + The basics of the system, including callbacks, work fine. + + The current development is in + http://www.ens-lyon.fr/~dmonniau/arcs + + + Several python bindings have been done: + + pygtk is at + http://www.daa.com.au/~james/pygtk and + ftp://ftp.gtk.org/pub/gtk/python + + + python-gtk is at + http://www.ucalgary.ca/~nascheme/python-gtk + + + + There's are a couple of OpenGL/Mesa + widgets available for GTK+. I suggest you start at + http://www.student.oulu.fi/~jlof/gtkglarea/index.html + + Last, there are a lot of other language + bindings for languages such as Eiffel, TOM, Pascal, Pike, etc. + + + + + + + + + + -- cgit v1.2.1