From d2c345480b590bbd2f95e8e92687bce18fd4c289 Mon Sep 17 00:00:00 2001 From: GMT 2001 Tony Gale Date: Thu, 11 Jan 2001 13:18:03 +0000 Subject: [PATCH] update to make web site updating easier Thu Jan 11 13:16:50 GMT 2001 Tony Gale * docs/faq/gtk-faq.sgml: update to make web site updating easier --- ChangeLog | 4 + ChangeLog.pre-2-0 | 4 + ChangeLog.pre-2-10 | 4 + ChangeLog.pre-2-2 | 4 + ChangeLog.pre-2-4 | 4 + ChangeLog.pre-2-6 | 4 + ChangeLog.pre-2-8 | 4 + docs/faq/gtk-faq.sgml | 353 +++++++++++++++++++++--------------------- 8 files changed, 201 insertions(+), 180 deletions(-) diff --git a/ChangeLog b/ChangeLog index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 8e480dd1dc..8dd60852ca 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +Thu Jan 11 13:16:50 GMT 2001 Tony Gale + + * docs/faq/gtk-faq.sgml: update to make web site updating easier + 2001-01-10 Havoc Pennington * gtk/gtktreestore.c (gtk_tree_store_insert_before): handle case diff --git a/docs/faq/gtk-faq.sgml b/docs/faq/gtk-faq.sgml index dd3fc8b89c..7a31bffa27 100644 --- a/docs/faq/gtk-faq.sgml +++ b/docs/faq/gtk-faq.sgml @@ -29,16 +29,11 @@ -GTK+ FAQ - - - - General Information - + Before anything else: the greetings The FAQ authors want to thank: @@ -74,11 +69,11 @@ If we forgot you, please email us! Thanks again (I know, it's really short :) - + - + Authors The original authors of GTK+ were: @@ -98,11 +93,11 @@ it's really short :) 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 @@ -119,11 +114,11 @@ 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: @@ -138,22 +133,22 @@ 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 @@ -197,11 +192,11 @@ http://pobox.com/~hp/gnome-app-devel.html - + - + Is there a mailing list (or mailing list archive) for GTK+? @@ -211,11 +206,11 @@ url="http://www.gtk.org/mailinglists.html"> http://www.gtk.org/mailinglists.html - + - + How to get help with GTK+ First, make sure your question isn't answered in the @@ -223,11 +218,11 @@ 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 @@ -288,11 +283,11 @@ command line option. - + - + Is there a Windows version of GTK+? There is an on going port of GTK+ to the Windows @@ -303,11 +298,11 @@ url="http://www.iki.fi/tml/gimp/win32"> 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 @@ -349,11 +344,11 @@ url="http://glade.pn.org/">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? @@ -372,27 +367,27 @@ them). - - + + - + 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.insync.net/pub/mirrors/ftp.gimp.org - + - + How do I configure/compile GTK+? Generally, all you will need to do is issue the commands: @@ -450,11 +445,11 @@ ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org make in the gtk+-version/ directory. - + - + When compiling GTK+ I get an error like: <literal>make: file `Makefile' line 456: Syntax error</literal> @@ -464,11 +459,11 @@ 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! @@ -530,11 +525,11 @@ they do exist, remove them (and any gtk include files, such as - + - + When compiling programs with GTK+, I get compiler error messages about not being able to find <literal>glibconfig.h</literal>. @@ -569,11 +564,11 @@ command line like: (Substitute the appropriate value of $exec_prefix for /usr/local.) - + - + When installing a GTK+ application, configure reports that it can't find GTK. @@ -613,17 +608,17 @@ 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? @@ -679,11 +674,11 @@ need to get that as well: - + - + How can I contribute to GTK+? It's simple. If something doesn't work like you think it @@ -722,11 +717,11 @@ unless you upload more than one patch in the same day. 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? @@ -744,11 +739,11 @@ 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? @@ -757,11 +752,11 @@ 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? @@ -877,17 +872,17 @@ bindings for languages such as Eiffel, TOM, Pascal, Pike, etc. - - + + - + Development with GTK+: the begining - + How do I get started? So, after you have installed GTK+ there are a couple of @@ -905,11 +900,11 @@ gtk/testgtk.c (and associated source files) within the GTK+ distribution. Looking at these examples will give you a good grounding on what the widgets can do. - + - + I tried to compile a small <command>Hello World</command> of mine, but it failed. Any clue? @@ -943,11 +938,11 @@ needed libraries. - + - + What about using the <command>make</command> utility? @@ -975,11 +970,11 @@ all : ${OBJS} For more information about the make utility, you 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. @@ -990,11 +985,11 @@ backquote syntax working again, you should use the GNU make utility (get it on the GNU ftp server at ftp://ftp.gnu.org/). - + - + I want to add some configure stuff, how could I do this? @@ -1073,11 +1068,11 @@ and the automake documentation (the shipped info files are really easy to understand, and there are plenty of web 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? @@ -1100,16 +1095,16 @@ port is also great for debugging X programs. Old vt100/vt220 terminals are dirt cheap but a bit hard to get (here in The Netherlands, YMMV). - + - + Development with GTK+: general questions - + What widgets are in GTK? The GTK+ Tutorial lists the following widgets: @@ -1197,11 +1192,11 @@ Netherlands, YMMV). +GtkHSeparator `GtkVSeparator - + - + Is GTK+ thread safe? How do I write multi-threaded GTK+ applications? @@ -1393,11 +1388,11 @@ int main(int argc, char *argv[]) return(0); } - + - + Why does this strange 'x io error' occur when I <literal>fork()</literal> in my GTK+ app? @@ -1587,11 +1582,11 @@ int main(int argc, char *argv[]) exit(0); } - + - + Why don't the contents of a button move when the button is pressed? Here's a patch to make it work that way... @@ -1613,11 +1608,11 @@ surface of the button. On a more practical note, I did implement this at one point and determined it didn't look good and removed it. - + - + How do I identifiy a widgets top level window or other ancestor? @@ -1648,11 +1643,11 @@ widget (entry, label, etc. To find the master hbox using the hbox = gtk_widget_get_ancestor(w, GTK_TYPE_HBOX); - + - + How do I get the Window ID of a GtkWindow? The actual Gdk/X window will be created when the widget @@ -1663,11 +1658,11 @@ gets realized. You can get the Window ID with: Window xwin = GDK_WINDOW_XWINDOW (GTK_WIDGET (my_window)->window); - + - + How do I catch a double click event (in a list widget, for example)? @@ -1720,11 +1715,11 @@ therefore also get a "clicked" signal for the button. (This is going to be true for any toolkit, since computers aren't good at reading one's mind.) - + - + By the way, what are the differences between signals and events? @@ -1759,11 +1754,11 @@ this that makes signals and events inherently related concepts, any more than emitting a signal when you click a button makes button clicking and signals related concepts. - + - + Data I pass to the <literal>delete_event</literal> (or other event) handler gets corrupted. @@ -1779,11 +1774,11 @@ gint delete_event_handler (GtkWidget *widget, gpointer data); - + - + I have my signal connected to the the (whatever) event, but it seems I don't catch it. What's wrong? @@ -1805,11 +1800,11 @@ mask. All the event masks are defined in the gdktypes.h file. - + - + I need to add a new signal to a GTK+ widget. Any idea? @@ -1854,11 +1849,11 @@ gtk_widget_user_action (GtkWidget *widget, classical gpointer parameter, you'll have to play with GTK+ marshallers. - + - + Is it possible to get some text displayed which is truncated to fit inside its allocation? @@ -1891,11 +1886,11 @@ gtk_widget_show (label); want to copy gtkviewport.c and strip out the adjustment and shadow functionality (perhaps you could call it GtkClipper). - + - + How do I make my window modal? / How do I make a single window active? @@ -1903,11 +1898,11 @@ window active? gtk_grab_add(my_window). And after closing the window do gtk_grab_remove(my_window). - + - + Why doesn't my widget (e.g. progressbar) update? @@ -1929,11 +1924,11 @@ while (g_main_iteration(FALSE)); and high priority idle functions, then return immediately (the drawing is done in a high priority idle function). - + - + How do I attach data to some GTK+ object/widget? First of all, the attached data is stored in the @@ -1974,11 +1969,11 @@ standard "user_data" key. Note that the use of these functions is deprecated in 1.2. They only provide a compatibility mode with some old gtk packages. - + - + How do I remove the data I have attached to an object? @@ -2003,11 +1998,11 @@ same key) - + - + How do I reparent a widget? The normal way to reparent (ie change the owner) of a @@ -2039,11 +2034,11 @@ snippet: gtk_widget_unref(widget); - + - + How could I get any widgets position? As Tim Janik pointed out, there are different cases, and @@ -2080,11 +2075,11 @@ when writing your application. This is dependant upon how the Window Managers manage the decorations that they add around windows. - + - + How do I set the size of a widget/window? How do I prevent the user resizing my window? @@ -2144,11 +2139,11 @@ uses to work fine both to grow or to shrink the window: x_size, y_size); - + - + How do I add a popup menu to my GTK+ application? The menu example in the examples/menu @@ -2173,11 +2168,11 @@ static gint button_press (GtkWidget *widget, GdkEvent *event) } - + - + How do I disable or enable a widget, such as a button? @@ -2186,11 +2181,11 @@ button? first parameter is you widget pointer. The second parameter is a boolean value: when this value is TRUE, the widget is enabled. - + - + Shouldn't the text argument in the gtk_clist_* functions be declared const? @@ -2211,11 +2206,11 @@ unspecified number of pointers to char) into "const gchar *[]" casting, but in the array case, it is not the array itself that needs the (const) qualified cast, but its members, thus changing the whole type. - + - + How do I render pixels (image data) to the screen? @@ -2240,11 +2235,11 @@ Simple DirectMedia Layer library (SDL). You do NOT want to use gdk_draw_point(), that will be extremely slow. - + - + How do I create a pixmap without having my window being realized/shown? @@ -2274,17 +2269,17 @@ used, as in: gdk_pixmap_unref (pixmap_mask); - - + + - + Development with GTK+: widget specific questions - + How do I find out about the selection of a GtkList? Get the selection something like this: @@ -2412,11 +2407,11 @@ this: } - + - + How do I stop the column headings of a GtkCList disappearing when the list is scrolled? @@ -2436,11 +2431,11 @@ function gtk_container_add, as in: gtk_container_add(GTK_CONTAINER(scrolled), clist); - + - + I don't want the user of my applications to enter text into a GtkCombo. Any idea? @@ -2463,11 +2458,11 @@ gtk_entry_set_editable() function: Set the editable parameter to FALSE to disable typing into the entry. - + - + How do I catch a combo box change? The entry which is associated to your GtkCombo send a @@ -2491,11 +2486,11 @@ signal handler with NULL); - + - + How can I define a separation line in a menu? See the - + - + How can I right justify a menu, such as Help? Depending on if you use the MenuFactory or not, there @@ -2533,11 +2528,11 @@ use: gtk_menu_item_right_justify(my_menu_item); - + - + How do I add some underlined accelerators to menu items? @@ -2578,11 +2573,11 @@ underlined, and the relevant accelerators are created. gtk_container_add (GTK_CONTAINER (file1_menu), new1); - + - + How can I retrieve the text from a GtkMenuItem? You can usually retrieve the label of a specific @@ -2631,11 +2626,11 @@ have to do: } - + - + How do I right (or otherwise) justify a GtkLabel? @@ -2672,11 +2667,11 @@ gtk_misc_set_alignment(GTK_MISK(label), 0.5f, 0.5f); gtk_misc_set_alignment(GTK_MISK(label), 1.0f, 1.0f); - + - + How do I set the background color of a GtkLabel widget? @@ -2689,11 +2684,11 @@ parents window. a GtkLabel widget, you need to change the background color of its parent, i.e. the object that you pack it into. - + - + How do I set the color and font of a GtkLabel using a Resource File? @@ -2729,11 +2724,11 @@ the Label widget, which can be done using: gtk_widget_show(label); - + - + How do I configure Tooltips in a Resource File? The tooltip's window is named "gtk-tooltips", @@ -2750,11 +2745,11 @@ style "postie" widget "gtk-tooltips*" style "postie" - + - + I can't add more than (something like) 2000 chars in a GtkEntry. What's wrong? @@ -2775,11 +2770,11 @@ following lines limit the number of chars in the entry to max_length = MIN (2047, entry->text_max_length); - + - + How do I make a GtkEntry widget activate on pressing the Return key? @@ -2795,11 +2790,11 @@ be: NULL); - + - + How do I validate/limit/filter the input to a GtkEntry? If you want to validate the text that a user enters into @@ -2872,11 +2867,11 @@ int main (int argc, } - + - + How do I use horizontal scrollbars with a GtkText widget? The short answer is that you can't. The current version @@ -2885,11 +2880,11 @@ scrolling. There is an intention to completely rewrite the GtkText widget, at which time this limitation will be removed. - + - + How do I change the font of a GtkText widget? There are a couple of ways of doing this. As GTK+ allows @@ -2913,11 +2908,11 @@ the text widget. You can load a font using, for example: font = gdk_font_load("-adobe-helvetica-medium-r-normal--*-140-*-*-*-*-*-*"); - + - + How do I set the cursor position in a GtkText object? @@ -2984,17 +2979,17 @@ you should use the gtk_editable_set_position() function. - - + + - + About GDK - + What is GDK? GDK is basically a wrapper around the standard Xlib @@ -3007,11 +3002,11 @@ portable and safer to use on multiple platforms. - + - + How do I use color allocation? One of the nice things about GDK is that it's based on @@ -3067,17 +3062,17 @@ like this: } - - + + - + About GLib - + What is GLib? GLib is a library of useful functions and definitions @@ -3107,11 +3102,11 @@ as malloc, which are buggy on some systems. - + - + How can I use the doubly linked lists? The GList object is defined as: @@ -3167,11 +3162,11 @@ a reference on the first node of the list. - + - + Memory does not seem to be released when I free the list nodes I've allocated @@ -3221,11 +3216,11 @@ g_list_pop_allocator (); g_allocator_free (allocator); - + - + Why use g_print, g_malloc, g_strdup and fellow glib functions? @@ -3256,11 +3251,11 @@ g_set_error_handler()) along the lines of gtk_print() (inside of gtkmain.c). - + - + What's a GScanner and how do I use one? A GScanner will tokenize your text, that is, it'll return @@ -3509,13 +3504,13 @@ would have accepted "dooh i am 42" and "bah i am 0.75" as well, but you would have not accepted "hi 7 am 17" or "hi i hi 17". - - + + - + GTK+ FAQ Contributions, Maintainers and Copyright If you would like to make a contribution to the FAQ, send either one @@ -3568,8 +3563,6 @@ purpose. This is simply provided as a free resource. As such, the authors and maintainers of the information provided within can not make any guarentee that the information is even accurate. - -