From 25d4a360f052c3dfe0b0de16ac31f60c2ec09fc1 Mon Sep 17 00:00:00 2001 From: Tony Gale Date: Wed, 5 Nov 2003 09:00:38 +0000 Subject: [PATCH] ed Nov 5 08:58:34 GMT 2003 Tony Gale * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: - Update info on compiling GTK+ - mirrors,compiling,g_main_context_iteration - fix pkg-config command error, update copyright. - More 2.x updates --- ChangeLog | 8 ++ ChangeLog.pre-2-10 | 8 ++ ChangeLog.pre-2-4 | 8 ++ ChangeLog.pre-2-6 | 8 ++ ChangeLog.pre-2-8 | 8 ++ docs/faq/gtk-faq.sgml | 265 +++++++++++++++++++++++++++++++----------- 6 files changed, 239 insertions(+), 66 deletions(-) diff --git a/ChangeLog b/ChangeLog index 8c8b5c3767..8ad8902532 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +Wed Nov 5 08:58:34 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: + - Update info on compiling GTK+ + - mirrors,compiling,g_main_context_iteration + - fix pkg-config command error, update copyright. + - More 2.x updates + Wed Oct 29 15:01:32 2003 Owen Taylor * gdk/x11/gdkimage-x11.c (_gdk_x11_copy_to_image): Move diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 8c8b5c3767..8ad8902532 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,11 @@ +Wed Nov 5 08:58:34 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: + - Update info on compiling GTK+ + - mirrors,compiling,g_main_context_iteration + - fix pkg-config command error, update copyright. + - More 2.x updates + Wed Oct 29 15:01:32 2003 Owen Taylor * gdk/x11/gdkimage-x11.c (_gdk_x11_copy_to_image): Move diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 8c8b5c3767..8ad8902532 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,11 @@ +Wed Nov 5 08:58:34 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: + - Update info on compiling GTK+ + - mirrors,compiling,g_main_context_iteration + - fix pkg-config command error, update copyright. + - More 2.x updates + Wed Oct 29 15:01:32 2003 Owen Taylor * gdk/x11/gdkimage-x11.c (_gdk_x11_copy_to_image): Move diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 8c8b5c3767..8ad8902532 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,11 @@ +Wed Nov 5 08:58:34 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: + - Update info on compiling GTK+ + - mirrors,compiling,g_main_context_iteration + - fix pkg-config command error, update copyright. + - More 2.x updates + Wed Oct 29 15:01:32 2003 Owen Taylor * gdk/x11/gdkimage-x11.c (_gdk_x11_copy_to_image): Move diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 8c8b5c3767..8ad8902532 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,11 @@ +Wed Nov 5 08:58:34 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Bring across changes from HEAD: + - Update info on compiling GTK+ + - mirrors,compiling,g_main_context_iteration + - fix pkg-config command error, update copyright. + - More 2.x updates + Wed Oct 29 15:01:32 2003 Owen Taylor * gdk/x11/gdkimage-x11.c (_gdk_x11_copy_to_image): Move diff --git a/docs/faq/gtk-faq.sgml b/docs/faq/gtk-faq.sgml index 5c84a6ffd8..ed919170d1 100644 --- a/docs/faq/gtk-faq.sgml +++ b/docs/faq/gtk-faq.sgml @@ -2,7 +2,7 @@ - September 3rd 2003 + November 5th 2003 GTK+ FAQ @@ -36,17 +36,19 @@ -Note: This FAQ mainly covers GTK+ 1.2 -This FAQ mainly covers GTK+ 1.2. +Note: This FAQ is undergoing conversion to GTK+ 2.x +This FAQ is undergoing conversion to GTK+ 2.x. Where the text covers GTK+ 2.x this will be indicated by prefixing the -text with: [GTK+ 2.x] +text with: [GTK+ 2.x]. Where this is not +indicated, the text has not yet been updated from GTK+ 1.2 and may +not be totally correct. -Before anything else: the greetings +Before anything else: the greetings <emphasis>[GTK 2.x]</emphasis> The FAQ authors want to thank: @@ -86,7 +88,7 @@ it's really short :) -Authors +Authors <emphasis>[GTK 2.x]</emphasis> The original authors of GTK+ were: @@ -103,35 +105,72 @@ it's really short :) Since then, much has been added by others. Please see the -AUTHORS file in the distribution for the GTK+ Team. +AUTHORS file in the distribution for the GTK+ Team. The people currently +contributing the most code to GTK+ are (in no particular order): + + + + +Owen Taylor + + +Matthias Clasen + + +Federico Mena Quintero + + +Soeren Sandmann + + +Padraig O'Briain + + +Manish Singh + + +Kristian Rietveld + + +Tor Lillqvist + + -What is GTK+? +What is GTK+? <emphasis>[GTK 2.x]</emphasis> -GTK+ is a small and efficient widget set designed with +GTK+ is a multi-platform toolkit for creating graphical user +interfaces, originally 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. +better than Motif. It contains common and complex widgets, such as +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. +GTK+ was initially developed as a widget set for the GIMP (GNU Image +Manipulation Program). It has grown extensively since then, and is today +used by a large number of applications, and is the toolkit used by the +GNOME desktop project. +GTK+ is free software and part of the GNU Project. However, the +licensing terms for GTK+, the GNU LGPL, allow it to be used by all developers, +including those developing proprietary software, without any license fees +or royalties. + +GTK+ has been designed from the ground up to support a range of + +language bindings, not only C/C++. Using GTK+ from languages +such as Perl and Python (especially in combination with the Glade GUI +builder) provides an effective method of rapid application +development.. -What is the + in GTK+? +What is the + in GTK+? <emphasis>[GTK 2.x]</emphasis> Peter Mattis informed the gtk mailing list that: @@ -145,14 +184,21 @@ 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. +Although much has changed with GTK+, and Peter, Spencer and Josh +don't have any direct involvement these days, the name is kept to keep +a link with the heritage of GTK+. + +GTK+ is now additionally based upon the Pango and ATK +libraries, that provide text layout and rendering and accessibility +interfaces. -Does the G in GTK+, GDK and GLib stand for? +Does the G in GTK+, GDK and GLib stand for? <emphasis>[GTK 2.x]</emphasis> -GTK+ == Gimp Toolkit +GTK+ == The GIMP Toolkit GDK == GTK+ Drawing Kit GLib == G Library @@ -161,14 +207,14 @@ oriented features. -Where is the documentation for GTK+? +Where is the documentation for GTK+? <emphasis>[GTK 2.x]</emphasis> In the GTK+ distribution's doc/ directory you will find -the reference material for both GTK and GDK, this FAQ and the +the API Reference 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 +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: +There are now a few books available that deal with +programming GTK+, GDK and GNOME. Unfortunately, they +currently are all based upon GTK+ 1.x: Eric Harlows book entitled "Developing @@ -202,6 +249,19 @@ url="http://pobox.com/~hp/gnome-app-devel.html"> http://pobox.com/~hp/gnome-app-devel.html +"GTK+ Programming in C" by +Syd Logan. ISBN: 0-1301-4264-6 + +"Linux GNOME/GTK+ Programming Bible" by +Arthur Griffith. ISBN: 0-7645-4640-6 + +"Beginning GTK+/GNOME Programming" by +Peter Wright. ISBN: 1-8610-0381-1 + +"Sams Teach Yourself GTK+ Programming +in 21 Days" by Donna Martin +. ISBN: 0-6723-1829-6 + @@ -210,7 +270,7 @@ http://pobox.com/~hp/gnome-app-devel.html Is there a mailing list (or mailing list archive) for -GTK+? +GTK+? [GTK 2.x] Information on mailing lists relating to GTK+ can be found at: -How to get help with GTK+ +How to get help with GTK+ <emphasis>[GTK 2.x]</emphasis> First, make sure your question isn't answered in the documentation, this FAQ or the tutorial. Done that? You're @@ -368,18 +428,84 @@ them). - -What do I need to run GTK+? + +What do I need to compile GTK+? <emphasis>[GTK 2.x]</emphasis> -To compile GTK+, all you need is a C compiler (gcc) and -the X Window System and associated libraries on your system. +GTK+ is a large package that is dependent on a number of other +tools and libraries. It is recommended that you use precompiled +binary packages for your system if possible + +To compile GTK+ from source you need a C compiler (gcc) and +the X Window System and associated development libraries and packages +on your system. + +You will also need to have installed the tools +and libraries that GTK+ depends upon. These are listed below in the order +in which they need to be installed: + + + pkg-config +( +pkg-config Site) + + + GNU make +( +GNU make Site) + + + JPEG, PNG and TIFF image libraries +( +GTK+ Site) + + + FreeType +( +FreeType Site) + + + fontconfig +( +fontconfig Site) + + + GNU libiconv library (if your system doesn't have iconv()) +( +GNU libiconv Site) + + + GNU gettext (if your system doesn't have gettext()) +( +GTK+ Site) + + + GLib +( +GTK+ Site) + + + Pango +( +GTK+ Site) + + + ATK +( +GTK+ Site) + + + GTK+ +( +GTK+ Site) + + -Where can I get GTK+? +Where can I get GTK+? <emphasis>[GTK 2.x]</emphasis> The canonical site is ftp://ftp.gtk.org/pub/gtk. @@ -397,30 +523,31 @@ url="ftp://ftp.gtk.org/etc/mirrors">ftp://ftp.gtk.org/etc/mirrors ftp://ftp.is.co.za/applications/gimp + Australia - -ftp://ftp.au.gimp.org/pub/gimp +url="ftp://ftp.planetmirror.com/pub/gimp/gtk"> +ftp://ftp.planetmirror.com/pub/gimp/gtk + Finland - - -ftp://ftp.funet.fi/pub/sci/graphics/packages/gimp + +ftp://ftp.funet.fi/pub/sci/graphics/packages/gimp/gtk + Germany - - -ftp://infosoc.uni-koeln.de/pub/ftp.gimp.org" + +ftp://ftp.gwdg.de/pub/misc/grafik/gimp/gtk + Japan - - -ftp://SunSITE.sut.ac.jp/pub/archives/packages/gimp + +ftp://sunsite.sut.ac.jp/pub/archives/packages/gimp/gtk + UK - - -ftp://ftp.flirble.org/pub/X/gimp - - US - - -ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org + +http://www.mirror.ac.uk/sites/ftp.gimp.org/pub/gtk/ @@ -428,21 +555,34 @@ ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org -How do I configure/compile GTK+? +How do I configure/compile GTK+? <emphasis>[GTK 2.x]</emphasis> -Generally, all you will need to do is issue the commands: +Generally, the minimum you need to do is issue the commands: ./configure -make +make +make install -in the gtk+-version/ directory. +in the GTK+ source directory. + +This generally also holds true for each of the packages that GTK+ +depends upon, listed above. + +There are various options that you can pass to the configure script +in order to change its default settings. The one that you are most likely +to want to use is the --prefix +argument, which defines where the package is to be install, e.g. + + +./configure --prefix=/usr + When compiling GTK+ I get an error like: <literal>make: -file `Makefile' line 456: Syntax error</literal> +file `Makefile' line 456: Syntax error [GTK 2.x] Make sure that you are using GNU make (use make -v @@ -514,7 +654,7 @@ component of GTK) isn't in your path, or there is an old version on your system. Type: -pkg-config gtk+-2.0 --version +pkg-config gtk+-2.0 --modversion to check for both of these. If it returns a value @@ -1960,7 +2100,7 @@ do gtk_grab_remove(my_window). Why doesn't my widget (e.g. progressbar) -update? +update? [GTK 2.x] You are probably doing all the changes within a function without returning control to gtk_main(). This may @@ -1971,7 +2111,7 @@ drawing queue to be processed using something like: -while (g_main_iteration(FALSE)); +while (g_main_context_iteration(NULL, FALSE)); inside you're function that changes the widget. @@ -3578,22 +3718,15 @@ and become more useful! Tony Gale <gale@gtk.org> -Nathan Froyd - -<maestrox@geocities.com>, -and -Emmanuel Deloget -<logout@free.fr>. - This FAQ was created by Shawn T. Amundson -<amundson@gimp.org> who continues to provide support. +<amundson@gimp.org>. Contributions should be sent to Tony Gale <gale@gtk.org> -The GTK+ FAQ is Copyright (C) 1997-2000 by Shawn T. Amundson, -Tony Gale, Emmanuel Deloget and Nathan Froyd. +The GTK+ FAQ is Copyright (C) 1997-2003 by Shawn T. Amundson, +Tony Gale. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are