AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-25 21:21:21 +00:00
Code Issues Projects Releases Wiki Activity

More changes from Tony Gale.

Browse Source
This commit is contained in:
Shawn Amundson 1998-01-27 20:51:36 +00:00
parent a9f866f4ca
commit d43c0de3f4
9 changed files with 374 additions and 152 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-0
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-10
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-2
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-4
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-6
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

4
ChangeLog.pre-2-8
View File

@ -1,3 +1,7 @@
Tue Jan 27 14:15:50 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: more additions/changes Tony Gale.
Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org> Mon Jan 26 17:12:12 CST 1998 Shawn T. Amundson <amundson@gimp.org>
* docs/gtkfaq.sgml: additions/changes from new FAQ maintainers * docs/gtkfaq.sgml: additions/changes from new FAQ maintainers

249
docs/faq/gtkfaq.sgml
View File

@ -5,10 +5,10 @@
<!-- Title information --> <!-- Title information -->
<title>GTK+ FAQ <title>GTK+ FAQ
<author>Shawn T. Amundson, <tt/amundson@gimp.org/ <author>Nathan Froyd, <tt/maestrox@geocities.com/&gt;,
<author>Nathan Froyd, <tt/maestrox@geocities.com/ Tony Gale, &lt;<tt/trogsta@geocities.com/&gt;,
<author>Tony Gale, <tt/gale@minotaur.dra.hmg.gb/ Shawn T. Amundson, <tt/amundson@gimp.org/
<date>July 31, 1997 <date>January 27th 1998
<abstract> <abstract>
This document is intended to answer questions that are likely to be This document is intended to answer questions that are likely to be
frequently asked by programmers using GTK+ or people who are just frequently asked by programmers using GTK+ or people who are just
@ -24,46 +24,33 @@ looking at using GTK+.
<sect>General Information <sect>General Information
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Authors and Copyright <sect1>Authors
<p> <p>
The authors of GTK+ are: The authors of GTK+ are:
<verb> <itemize>
Peter Mattis (petm@xcf.berkeley.edu) <item>Peter Mattis (petm@xcf.berkeley.edu)
Spencer Kimball (spencer@xcf.berkeley.edu) <item>Spencer Kimball (spencer@xcf.berkeley.edu)
Josh MacDonald (jmacd@xcf.berkeley.edu) <item>Josh MacDonald (jmacd@xcf.berkeley.edu)
</verb> </itemize>
GTK+ is distributed under the GNU Library General Public License
The copyright notice on the library files is the following:
<tscreen><verb>
/* GTK - The GIMP Toolkit
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
</verb></tscreen>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What is GTK? <sect1>What is GTK+?
<p> <p>
GTK is a small and efficient widget set designed with the general look 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 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 contains common widgets and some more complex widgets such as a file
selection, and color selection widgets. 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.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What is the + in GTK+? <sect1>What is the + in GTK+?
<P> <P>
@ -79,7 +66,7 @@ enhancement to the original gtk that adds object oriented features."
</quote> </quote>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Does the G in GTK stand for General, Gimp, or GNU? <sect1>Does the G in GTK+ stand for General, Gimp, or GNU?
<p> <p>
Peter Mattis informed the gtk mailing list that: Peter Mattis informed the gtk mailing list that:
<quote> <quote>
@ -88,6 +75,49 @@ GTK = Gimp ToolKit. But I don't know for sure. Its definately not
GNU, though." GNU, though."
</quote> </quote>
<!-- ----------------------------------------------------------------- -->
<sect1>Where is the documentation for GTK+?
<p>
In the GTK+ distribution's doc/ directory you will find the
reference material for both GTK and GDK, and this FAQ.
There is also a GTK+ Tutorial which can be found at
<htmlurl url="http://www.levien.com/~slow/gtk/"
name="http://www.levien.com/~slow/gtk/">
In addition, if you are
on the web, you can browse all of the above by going to
<htmlurl url="http://www.gimp.org/gtk/docs"
name="http://www.gimp.org/gtk/docs">, where they
are already converted to HTML format.
<!-- ----------------------------------------------------------------- -->
<sect1>Is there a mailing list (or mailing list archive) for GTK+?
<p>
A mailing list is located at gtk-list@redhat.com . To subscribe send an
email message to <htmlurl url="mailto:gtk-list-request@redhat.com"
name="gtk-list-request@redhat.com">
with <em>subscribe</em> in the <bf>subject</bf>.
A searchable archive of the mailing list can be found at <htmlurl url="http://www.redhat.com/linux-info/gtk/gtk-list/index.html" name="http://www.redhat.com/linux-info/gtk/gtk-list/index.html">
<!-- ----------------------------------------------------------------- -->
<sect1>The gtk-list hasn't had any traffic for days, is it dead?
<p>
No, everyone's just busy coding.
<!-- ----------------------------------------------------------------- -->
<sect1>How to get help with GTK+
<p>
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.
<!-- ----------------------------------------------------------------- -->
<sect1>How to report bugs in GTK+
<p>
Bug reports should be sent to the GTK+ mailing list.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What applications have been written with GTK+? <sect1>What applications have been written with GTK+?
<p> <p>
@ -105,29 +135,6 @@ Some applications which use GTK+ are:
a universal scanner interface a universal scanner interface
</itemize> </itemize>
<!-- ----------------------------------------------------------------- -->
<sect1>How to get help with GTK+/Is there a mailing list and archive?
<p>
The best place is either the docs that come with GTK+ or the mailing list,
&ltgtk-list@redhat.com&gt. If you need to check the archives, you can find them at:
<verb>
http://www.redhat.com/linux-info/gtk/gtk-list/index.html
</verb>
<!-- ----------------------------------------------------------------- -->
<sect1>The gtk-list hasn't had any traffic for days, is it dead?
<p>
No, everyone's just busy coding.
<!-- ----------------------------------------------------------------- -->
<sect1>Where is the documentation for GTK+?
<p>
Look in the GTK distribution's doc/ directory. If you have World Wide
Web access, you can view them at:
<verb>
http://www.gimp.org/gtk/
</verb>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>How to find, configure, install, and troubleshoot GTK+ <sect>How to find, configure, install, and troubleshoot GTK+
@ -157,15 +164,22 @@ in the gtk+-version/ directory.
<sect1>I've compiled and installed GTK+, but I can't get any programs to link <sect1>I've compiled and installed GTK+, but I can't get any programs to link
with it! with it!
<p> <p>
This problem is most often encountered when compiling something like the GIMP This problem is most often encountered when the GTK+ libraries can't be
on a RedHat Linux machine. Generally, the compiler will complain about an found or are the wrong version. Generally, the compiler will complain about an
'unresolved symbol'. You want to edit /etc/ld.so.conf to include /usr/local/lib, 'unresolved symbol'. There are two things you need to check:
so it looks something like: <itemize>
<item>Make sure that the libraries can be found. You want to edit
/etc/ld.so.conf to include /usr/local/lib (or whereever you installed GTK+),
so it looks something like:
<verb> <verb>
/usr/X11R6/lib /usr/X11R6/lib
/usr/local/lib /usr/local/lib
</verb> </verb>
Then you need to run /sbin/ldconfig as root. Now (assuming you have a RedHat Then you need to run /sbin/ldconfig as root.
<p>
<item>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 system), issue the command
<verb> <verb>
rpm -e gtk gtk-devel rpm -e gtk gtk-devel
@ -174,23 +188,80 @@ 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 which ones they are). If you don't have a RedHat Linux system, check to make sure
that neither <verb>/usr/lib</verb> or <verb>/usr/local/lib</verb> contain any of that neither <verb>/usr/lib</verb> or <verb>/usr/local/lib</verb> contain any of
the libraries libgtk, libgdk, libglib, or libgck. If they do exist, remove them 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+. and reinstall gtk+.
</itemize>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Development of GTK+ <sect>Development of GTK+
<!-- ***************************************************************** -->
<sect1>When will it reach version 1.0? <sect1>When will it reach version 1.0?
<p>
The file 'TODO' in the gtk+ distribution lists the things that need to be done
before version 1.0 is repleased. Not including bugs, this includes:
<itemize>
<item>New Features
<itemize>
<item>gdk_expose_compress: ala-Xt, this would really help for opaque moves and
such
</itemize>
<p>
<item>Widgets
<itemize>
<item>Column-list (Jay Painter)
<item>Text widget (needs to be finished)
<item>Entry should have a password mode (and it should show stars
for user feedback)
</itemize>
<p>
<item>Drag-and-Drop (DND)
<itemize>
<item> It seems to be having problems again. The way DND data types are set in
GtkWidget really needs to be fixed. This is pretty high on my priority
list, and I'll get to it as soon as the column list widget is done. The
correct way dnd data needs to be set is to have a additional keyed data
type with GtkWidget, which is applied to the widget's window upon realize.
There also needs to be a way to set dnd-data on widget windows which are
not the main window (for widgets that create more than one window).
-- Jay Painter
<item> DnD seems to work for me, but yes, there needs to be some sort of
gtk_widget layer that makes it easier... Also, adding support for drop
zones might be nice.
-- Elliot
</itemize>
</itemize>
<!-- ----------------------------------------------------------------- -->
<sect1>How can I contribute to GTK+? <sect1>How can I contribute to GTK+?
<p> <p>
It's simple. If something doesn't work like you think it should in a program, 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 check the documentation to make sure you're not missing something. If it is a true
bug, track it down in the GTK+ source, change it, and then upload the patchfile to: bug, track it down in the GTK+ source, change it, and then upload the patchfile to:
<verb> <verb>
ftp://ftp.gimp.org/pub/incoming ftp://ftp.gimp.org/incoming
</verb> </verb>
along with a README file. Make sure you follow the naming conventions! along with a README file. Make sure you follow the naming conventions or your
will just be deleted! The filenames should be of this form:
<verb>
gtk-<username>-<date yymmdd-n>.patch.gz
gtk-<username>-<date yymmdd-n>.patch.README
</verb>
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:
<verb>
gtk-gale-982701-0.patch.gz
gtk-gale-982701-0.patch.README
</verb>
Once you upload <em>anything</em>, send the README to ftp-admin@gimp.org
<!-- ----------------------------------------------------------------- -->
<sect1>What is the policy on incorporating new widgets into the library? <sect1>What is the policy on incorporating new widgets into the library?
<p> <p>
This is up to the authors, so you will have to ask them once you This is up to the authors, so you will have to ask them once you
@ -199,9 +270,11 @@ generally useful, work, and are not a disgrace to the widget set will
gladly be included. gladly be included.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Is anyone working on C++ bindings? <sect1>Is anyone working on bindings for languages other than C?
<p> <p>
Yes, there is a C++ wrapper for GTK+ called gtk--. You can find the home page at: Yes, there is
<itemize>
<item>a C++ wrapper for GTK+ called gtk--. You can find the home page at:
<verb> <verb>
http://www.cs.tut.fi/~p150650/gtk/gtk--.html http://www.cs.tut.fi/~p150650/gtk/gtk--.html
</verb> </verb>
@ -209,16 +282,24 @@ The FTP site is:
<verb> <verb>
ftp://ftp.gimp.org/pub/gtk/gtk--/ ftp://ftp.gimp.org/pub/gtk/gtk--/
</verb> </verb>
<sect1>Is anyone working on Guile bindings?
<p> <p>
Yes, the home page is at:
<item>Guile bindings. The home page is at:
<verb> <verb>
http://www.ping.de/sites/zagadka/guile-gtk/ http://www.ping.de/sites/zagadka/guile-gtk/
</verb> </verb>
By the way, Guile is the GNU Project's implemention of R4RS Scheme (the 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. standard). If you like Scheme, you may want to take a look at this.
<p>
<item>David Monniaux reports:
<quote>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/
</quote>
</itemize>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Widgets <sect>Widgets
@ -474,14 +555,29 @@ gtk_menu_append(GTK_MENU(menu), menuitem);
gtk_widget_show(menuitem); gtk_widget_show(menuitem);
</verb></tscreen> </verb></tscreen>
<!-- ----------------------------------------------------------------- -->
<sect>About glib <sect>About glib
<!-- ----------------------------------------------------------------- -->
<sect1>What is glib? <sect1>What is glib?
<p>
glib is a library of useful functions and definitions available for use
when creating GDK and GTK applications. It provides replacements for some
standard libc functions, such as malloc, which are buggy on some systems.
<p>
It also provides routines for handling:
<itemize>
<item>Doubly Linked Lists
<item>Singly Linked Lists
<item>Timers
<item>String Handling
<item>A Lexical Scanner
<item>Error Functions
</itemize>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Why use g_print, g_malloc, g_strdup and fellow glib functions ? <sect1>Why use g_print, g_malloc, g_strdup and fellow glib functions ?
<P> <p>
Thanks to Tim Janik who wrote to gtk-list: (slightly modified) Thanks to Tim Janik who wrote to gtk-list: (slightly modified)
<quote> <quote>
Regarding g_malloc(), g_free() and siblings, these functions are much safer Regarding g_malloc(), g_free() and siblings, these functions are much safer
@ -505,15 +601,16 @@ showing the messages inside of a gtk window with your own handler
</quote> </quote>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Contributions and Maintainer <sect>GTK+ FAQ Contributions and Maintainer
<p> <p>
If you would like to make a contribution to the FAQ, send either one of us If you would like to make a contribution to the FAQ, send either one of us
an e-mail message with the exact text you think should be included (question and an e-mail message with the exact text you think should be included (question and
answer). With your help, this document can grow and become more useful! answer). With your help, this document can grow and become more useful!
This document is maintained by Nathan Froyd &ltmaestrox@geocities.com&gt This document is maintained by Nathan Froyd <htmlurl url="mailto:maestrox@geocities.com"
and Tony Gale &ltgale@minotaur.dra.hmg.gb&gt. Previously, Shawn T. Amundson, name="&lt;maestrox@geocities.com&gt;">
&ltamundson@gimp.org&gt took care of it. and Tony Gale <htmlurl url="mailto:trogsta@geocities.com" name="&lt;trogsta@geocities.com&gt;">.
Previously, Shawn T. Amundson, took care of it.
There is no guarentee that this document lives up to its intended There is no guarentee that this document lives up to its intended
purpose. This is simply provided as a free resource. As such, purpose. This is simply provided as a free resource. As such,

249
docs/gtkfaq.sgml
View File

@ -5,10 +5,10 @@
<!-- Title information --> <!-- Title information -->
<title>GTK+ FAQ <title>GTK+ FAQ
<author>Shawn T. Amundson, <tt/amundson@gimp.org/ <author>Nathan Froyd, <tt/maestrox@geocities.com/&gt;,
<author>Nathan Froyd, <tt/maestrox@geocities.com/ Tony Gale, &lt;<tt/trogsta@geocities.com/&gt;,
<author>Tony Gale, <tt/gale@minotaur.dra.hmg.gb/ Shawn T. Amundson, <tt/amundson@gimp.org/
<date>July 31, 1997 <date>January 27th 1998
<abstract> <abstract>
This document is intended to answer questions that are likely to be This document is intended to answer questions that are likely to be
frequently asked by programmers using GTK+ or people who are just frequently asked by programmers using GTK+ or people who are just
@ -24,46 +24,33 @@ looking at using GTK+.
<sect>General Information <sect>General Information
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Authors and Copyright <sect1>Authors
<p> <p>
The authors of GTK+ are: The authors of GTK+ are:
<verb> <itemize>
Peter Mattis (petm@xcf.berkeley.edu) <item>Peter Mattis (petm@xcf.berkeley.edu)
Spencer Kimball (spencer@xcf.berkeley.edu) <item>Spencer Kimball (spencer@xcf.berkeley.edu)
Josh MacDonald (jmacd@xcf.berkeley.edu) <item>Josh MacDonald (jmacd@xcf.berkeley.edu)
</verb> </itemize>
GTK+ is distributed under the GNU Library General Public License
The copyright notice on the library files is the following:
<tscreen><verb>
/* GTK - The GIMP Toolkit
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
</verb></tscreen>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What is GTK? <sect1>What is GTK+?
<p> <p>
GTK is a small and efficient widget set designed with the general look 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 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 contains common widgets and some more complex widgets such as a file
selection, and color selection widgets. 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.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What is the + in GTK+? <sect1>What is the + in GTK+?
<P> <P>
@ -79,7 +66,7 @@ enhancement to the original gtk that adds object oriented features."
</quote> </quote>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Does the G in GTK stand for General, Gimp, or GNU? <sect1>Does the G in GTK+ stand for General, Gimp, or GNU?
<p> <p>
Peter Mattis informed the gtk mailing list that: Peter Mattis informed the gtk mailing list that:
<quote> <quote>
@ -88,6 +75,49 @@ GTK = Gimp ToolKit. But I don't know for sure. Its definately not
GNU, though." GNU, though."
</quote> </quote>
<!-- ----------------------------------------------------------------- -->
<sect1>Where is the documentation for GTK+?
<p>
In the GTK+ distribution's doc/ directory you will find the
reference material for both GTK and GDK, and this FAQ.
There is also a GTK+ Tutorial which can be found at
<htmlurl url="http://www.levien.com/~slow/gtk/"
name="http://www.levien.com/~slow/gtk/">
In addition, if you are
on the web, you can browse all of the above by going to
<htmlurl url="http://www.gimp.org/gtk/docs"
name="http://www.gimp.org/gtk/docs">, where they
are already converted to HTML format.
<!-- ----------------------------------------------------------------- -->
<sect1>Is there a mailing list (or mailing list archive) for GTK+?
<p>
A mailing list is located at gtk-list@redhat.com . To subscribe send an
email message to <htmlurl url="mailto:gtk-list-request@redhat.com"
name="gtk-list-request@redhat.com">
with <em>subscribe</em> in the <bf>subject</bf>.
A searchable archive of the mailing list can be found at <htmlurl url="http://www.redhat.com/linux-info/gtk/gtk-list/index.html" name="http://www.redhat.com/linux-info/gtk/gtk-list/index.html">
<!-- ----------------------------------------------------------------- -->
<sect1>The gtk-list hasn't had any traffic for days, is it dead?
<p>
No, everyone's just busy coding.
<!-- ----------------------------------------------------------------- -->
<sect1>How to get help with GTK+
<p>
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.
<!-- ----------------------------------------------------------------- -->
<sect1>How to report bugs in GTK+
<p>
Bug reports should be sent to the GTK+ mailing list.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>What applications have been written with GTK+? <sect1>What applications have been written with GTK+?
<p> <p>
@ -105,29 +135,6 @@ Some applications which use GTK+ are:
a universal scanner interface a universal scanner interface
</itemize> </itemize>
<!-- ----------------------------------------------------------------- -->
<sect1>How to get help with GTK+/Is there a mailing list and archive?
<p>
The best place is either the docs that come with GTK+ or the mailing list,
&ltgtk-list@redhat.com&gt. If you need to check the archives, you can find them at:
<verb>
http://www.redhat.com/linux-info/gtk/gtk-list/index.html
</verb>
<!-- ----------------------------------------------------------------- -->
<sect1>The gtk-list hasn't had any traffic for days, is it dead?
<p>
No, everyone's just busy coding.
<!-- ----------------------------------------------------------------- -->
<sect1>Where is the documentation for GTK+?
<p>
Look in the GTK distribution's doc/ directory. If you have World Wide
Web access, you can view them at:
<verb>
http://www.gimp.org/gtk/
</verb>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>How to find, configure, install, and troubleshoot GTK+ <sect>How to find, configure, install, and troubleshoot GTK+
@ -157,15 +164,22 @@ in the gtk+-version/ directory.
<sect1>I've compiled and installed GTK+, but I can't get any programs to link <sect1>I've compiled and installed GTK+, but I can't get any programs to link
with it! with it!
<p> <p>
This problem is most often encountered when compiling something like the GIMP This problem is most often encountered when the GTK+ libraries can't be
on a RedHat Linux machine. Generally, the compiler will complain about an found or are the wrong version. Generally, the compiler will complain about an
'unresolved symbol'. You want to edit /etc/ld.so.conf to include /usr/local/lib, 'unresolved symbol'. There are two things you need to check:
so it looks something like: <itemize>
<item>Make sure that the libraries can be found. You want to edit
/etc/ld.so.conf to include /usr/local/lib (or whereever you installed GTK+),
so it looks something like:
<verb> <verb>
/usr/X11R6/lib /usr/X11R6/lib
/usr/local/lib /usr/local/lib
</verb> </verb>
Then you need to run /sbin/ldconfig as root. Now (assuming you have a RedHat Then you need to run /sbin/ldconfig as root.
<p>
<item>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 system), issue the command
<verb> <verb>
rpm -e gtk gtk-devel rpm -e gtk gtk-devel
@ -174,23 +188,80 @@ 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 which ones they are). If you don't have a RedHat Linux system, check to make sure
that neither <verb>/usr/lib</verb> or <verb>/usr/local/lib</verb> contain any of that neither <verb>/usr/lib</verb> or <verb>/usr/local/lib</verb> contain any of
the libraries libgtk, libgdk, libglib, or libgck. If they do exist, remove them 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+. and reinstall gtk+.
</itemize>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Development of GTK+ <sect>Development of GTK+
<!-- ***************************************************************** -->
<sect1>When will it reach version 1.0? <sect1>When will it reach version 1.0?
<p>
The file 'TODO' in the gtk+ distribution lists the things that need to be done
before version 1.0 is repleased. Not including bugs, this includes:
<itemize>
<item>New Features
<itemize>
<item>gdk_expose_compress: ala-Xt, this would really help for opaque moves and
such
</itemize>
<p>
<item>Widgets
<itemize>
<item>Column-list (Jay Painter)
<item>Text widget (needs to be finished)
<item>Entry should have a password mode (and it should show stars
for user feedback)
</itemize>
<p>
<item>Drag-and-Drop (DND)
<itemize>
<item> It seems to be having problems again. The way DND data types are set in
GtkWidget really needs to be fixed. This is pretty high on my priority
list, and I'll get to it as soon as the column list widget is done. The
correct way dnd data needs to be set is to have a additional keyed data
type with GtkWidget, which is applied to the widget's window upon realize.
There also needs to be a way to set dnd-data on widget windows which are
not the main window (for widgets that create more than one window).
-- Jay Painter
<item> DnD seems to work for me, but yes, there needs to be some sort of
gtk_widget layer that makes it easier... Also, adding support for drop
zones might be nice.
-- Elliot
</itemize>
</itemize>
<!-- ----------------------------------------------------------------- -->
<sect1>How can I contribute to GTK+? <sect1>How can I contribute to GTK+?
<p> <p>
It's simple. If something doesn't work like you think it should in a program, 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 check the documentation to make sure you're not missing something. If it is a true
bug, track it down in the GTK+ source, change it, and then upload the patchfile to: bug, track it down in the GTK+ source, change it, and then upload the patchfile to:
<verb> <verb>
ftp://ftp.gimp.org/pub/incoming ftp://ftp.gimp.org/incoming
</verb> </verb>
along with a README file. Make sure you follow the naming conventions! along with a README file. Make sure you follow the naming conventions or your
will just be deleted! The filenames should be of this form:
<verb>
gtk-<username>-<date yymmdd-n>.patch.gz
gtk-<username>-<date yymmdd-n>.patch.README
</verb>
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:
<verb>
gtk-gale-982701-0.patch.gz
gtk-gale-982701-0.patch.README
</verb>
Once you upload <em>anything</em>, send the README to ftp-admin@gimp.org
<!-- ----------------------------------------------------------------- -->
<sect1>What is the policy on incorporating new widgets into the library? <sect1>What is the policy on incorporating new widgets into the library?
<p> <p>
This is up to the authors, so you will have to ask them once you This is up to the authors, so you will have to ask them once you
@ -199,9 +270,11 @@ generally useful, work, and are not a disgrace to the widget set will
gladly be included. gladly be included.
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Is anyone working on C++ bindings? <sect1>Is anyone working on bindings for languages other than C?
<p> <p>
Yes, there is a C++ wrapper for GTK+ called gtk--. You can find the home page at: Yes, there is
<itemize>
<item>a C++ wrapper for GTK+ called gtk--. You can find the home page at:
<verb> <verb>
http://www.cs.tut.fi/~p150650/gtk/gtk--.html http://www.cs.tut.fi/~p150650/gtk/gtk--.html
</verb> </verb>
@ -209,16 +282,24 @@ The FTP site is:
<verb> <verb>
ftp://ftp.gimp.org/pub/gtk/gtk--/ ftp://ftp.gimp.org/pub/gtk/gtk--/
</verb> </verb>
<sect1>Is anyone working on Guile bindings?
<p> <p>
Yes, the home page is at:
<item>Guile bindings. The home page is at:
<verb> <verb>
http://www.ping.de/sites/zagadka/guile-gtk/ http://www.ping.de/sites/zagadka/guile-gtk/
</verb> </verb>
By the way, Guile is the GNU Project's implemention of R4RS Scheme (the 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. standard). If you like Scheme, you may want to take a look at this.
<p>
<item>David Monniaux reports:
<quote>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/
</quote>
</itemize>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Widgets <sect>Widgets
@ -474,14 +555,29 @@ gtk_menu_append(GTK_MENU(menu), menuitem);
gtk_widget_show(menuitem); gtk_widget_show(menuitem);
</verb></tscreen> </verb></tscreen>
<!-- ----------------------------------------------------------------- -->
<sect>About glib <sect>About glib
<!-- ----------------------------------------------------------------- -->
<sect1>What is glib? <sect1>What is glib?
<p>
glib is a library of useful functions and definitions available for use
when creating GDK and GTK applications. It provides replacements for some
standard libc functions, such as malloc, which are buggy on some systems.
<p>
It also provides routines for handling:
<itemize>
<item>Doubly Linked Lists
<item>Singly Linked Lists
<item>Timers
<item>String Handling
<item>A Lexical Scanner
<item>Error Functions
</itemize>
<!-- ----------------------------------------------------------------- --> <!-- ----------------------------------------------------------------- -->
<sect1>Why use g_print, g_malloc, g_strdup and fellow glib functions ? <sect1>Why use g_print, g_malloc, g_strdup and fellow glib functions ?
<P> <p>
Thanks to Tim Janik who wrote to gtk-list: (slightly modified) Thanks to Tim Janik who wrote to gtk-list: (slightly modified)
<quote> <quote>
Regarding g_malloc(), g_free() and siblings, these functions are much safer Regarding g_malloc(), g_free() and siblings, these functions are much safer
@ -505,15 +601,16 @@ showing the messages inside of a gtk window with your own handler
</quote> </quote>
<!-- ***************************************************************** --> <!-- ***************************************************************** -->
<sect>Contributions and Maintainer <sect>GTK+ FAQ Contributions and Maintainer
<p> <p>
If you would like to make a contribution to the FAQ, send either one of us If you would like to make a contribution to the FAQ, send either one of us
an e-mail message with the exact text you think should be included (question and an e-mail message with the exact text you think should be included (question and
answer). With your help, this document can grow and become more useful! answer). With your help, this document can grow and become more useful!
This document is maintained by Nathan Froyd &ltmaestrox@geocities.com&gt This document is maintained by Nathan Froyd <htmlurl url="mailto:maestrox@geocities.com"
and Tony Gale &ltgale@minotaur.dra.hmg.gb&gt. Previously, Shawn T. Amundson, name="&lt;maestrox@geocities.com&gt;">
&ltamundson@gimp.org&gt took care of it. and Tony Gale <htmlurl url="mailto:trogsta@geocities.com" name="&lt;trogsta@geocities.com&gt;">.
Previously, Shawn T. Amundson, took care of it.
There is no guarentee that this document lives up to its intended There is no guarentee that this document lives up to its intended
purpose. This is simply provided as a free resource. As such, purpose. This is simply provided as a free resource. As such,