From d0c95b51e435a042a9ea1db6f3cc69debde86630 Mon Sep 17 00:00:00 2001 From: GMT 2003 Tony Gale Date: Mon, 24 Nov 2003 13:49:16 +0000 Subject: [PATCH] start 2.x Section 4 updates Mon Nov 24 13:47:39 GMT 2003 Tony Gale * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates --- ChangeLog | 4 ++++ ChangeLog.pre-2-10 | 4 ++++ ChangeLog.pre-2-4 | 4 ++++ ChangeLog.pre-2-6 | 4 ++++ ChangeLog.pre-2-8 | 4 ++++ docs/faq/gtk-faq.sgml | 35 +++++++++++++++++++++-------------- 6 files changed, 41 insertions(+), 14 deletions(-) diff --git a/ChangeLog b/ChangeLog index efe8896b32..c4e57051f3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Mon Nov 24 13:47:39 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates + Mon Nov 24 04:05:15 2003 Soeren Sandmann * gtk/gtkradiotoolbutton.[ch] diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index efe8896b32..c4e57051f3 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +Mon Nov 24 13:47:39 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates + Mon Nov 24 04:05:15 2003 Soeren Sandmann * gtk/gtkradiotoolbutton.[ch] diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index efe8896b32..c4e57051f3 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +Mon Nov 24 13:47:39 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates + Mon Nov 24 04:05:15 2003 Soeren Sandmann * gtk/gtkradiotoolbutton.[ch] diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index efe8896b32..c4e57051f3 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +Mon Nov 24 13:47:39 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates + Mon Nov 24 04:05:15 2003 Soeren Sandmann * gtk/gtkradiotoolbutton.[ch] diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index efe8896b32..c4e57051f3 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +Mon Nov 24 13:47:39 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: start 2.x Section 4 updates + Mon Nov 24 04:05:15 2003 Soeren Sandmann * gtk/gtkradiotoolbutton.[ch] diff --git a/docs/faq/gtk-faq.sgml b/docs/faq/gtk-faq.sgml index 40f8009618..4ff7b9730d 100644 --- a/docs/faq/gtk-faq.sgml +++ b/docs/faq/gtk-faq.sgml @@ -2,7 +2,7 @@ - November 20th 2003 + November 24th 2003 GTK+ FAQ @@ -820,7 +820,7 @@ However, bindings for many other languages are available. -How do I get started? +How do I get started? <emphasis>[GTK 2.x]</emphasis> So, after you have installed GTK+ there are a couple of things that can ease you into developing applications with @@ -830,10 +830,10 @@ http://www.gtk.org/tutorial/, which is undergoing development. This will introduce you to writing applications using C. -The Tutorial doesn't (yet) contain information on all of +The GTK+ Tutorial doesn't contain information on all of the widgets that are in GTK+. For example code on how to use -the basics of all the GTK+ widgets you should look at the file -gtk/testgtk.c (and associated source files) within the GTK+ +the basics of all the GTK+ widgets you should look in the +directory 'tests' (and associated source files) within the GTK+ distribution. Looking at these examples will give you a good grounding on what the widgets can do. @@ -869,11 +869,18 @@ http://developer.gnome.org/doc/API/2.0/libglade/libglade-notes.html#libglade-bas How do I write security sensitive/SUID/SGID programs with GTK+? -Is GTK+ secure? What's this GTK_MODULES security hole I heard about? +Is GTK+ secure? What's this GTK_MODULES security hole I heard about? +[GTK 2.x] -The short answer to this question is: Don't write SUID/SGID +The short answer to this question is: you can't, so don't write SUID/SGID programs with GTK+ +GTK+ will refuse to run with elevated privileges, as it is not designed +to be used in this manner. The only correct way to write a setuid program with +a graphical user interface is to have a setuid backend that communicates with +the non-setuid graphical user interface via a mechanism such as a pipe and that +considers the input it receives to be untrusted. + For a more thorough explanation of the GTK+ Developers position on this issue see http://www.gtk.org/setuid.html. @@ -887,7 +894,7 @@ url="http://www.gtk.org/setuid.html">http://www.gtk.org/setuid.html.[GTK 2.x] Since you are good at coding, we will not deal with -compile time error here :) +compile time errors here :) The classic command line to compile a GTK+ based program is @@ -896,7 +903,7 @@ compile time error here :) You should notice the backquote character which is used in this command line. A common mistake when you start a GTK+ -based development is to use quote instead of backquotes. If +based development is to use quotes instead of backquotes. If you do so, the compiler will complain about an unknown file called pkg-config gtk+-2.0 --cflags --libs. The text in backquotes is an instruction to your shell to @@ -924,7 +931,7 @@ needed libraries. What about using the <command>make</command> utility? <emphasis>[GTK 2.x]</emphasis> -This is a sample makefile which compile a GTK+ based +This is a sample makefile which compiles a GTK+ based program: @@ -954,14 +961,14 @@ should read either the related man page or the relevant info file. I use the backquote stuff in my makefiles, but my make -process failed. +process failed. [GTK 2.x] The backquote construction seems to not be accepted by some old make utilities. If you use one of these, the make process will probably fail. In order to have the backquote syntax working again, you should use the GNU make utility (get it on the GNU ftp server at ftp://ftp.gnu.org/). +url="ftp://ftp.gnu.org/gnu/make/">ftp://ftp.gnu.org/gnu/make/). @@ -985,7 +992,7 @@ relevant packages. These are: -You'll find these packages on the GNU main ftp server +You'll find these packages on the main GNU ftp server (ftp://ftp.gnu.org/) or on any GNU mirror. @@ -1053,7 +1060,7 @@ resources that deal with autoconf and automake). I try to debug my GTK+ application with gdb, but it hangs my X server when I hit some breakpoint. Any -Idea? +Idea? [GTK 2.x] From Federico Mena Quintero: