diff --git a/ChangeLog b/ChangeLog index dd65319e3..d87c7e9fc 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Thu Nov 20 13:10:29 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Update Section 3 to 2.x + 2003-11-19 Federico Mena Quintero Fixes to problems reported by Iain Holmes: diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index dd65319e3..d87c7e9fc 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +Thu Nov 20 13:10:29 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Update Section 3 to 2.x + 2003-11-19 Federico Mena Quintero Fixes to problems reported by Iain Holmes: diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index dd65319e3..d87c7e9fc 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +Thu Nov 20 13:10:29 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Update Section 3 to 2.x + 2003-11-19 Federico Mena Quintero Fixes to problems reported by Iain Holmes: diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index dd65319e3..d87c7e9fc 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +Thu Nov 20 13:10:29 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Update Section 3 to 2.x + 2003-11-19 Federico Mena Quintero Fixes to problems reported by Iain Holmes: diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index dd65319e3..d87c7e9fc 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +Thu Nov 20 13:10:29 GMT 2003 Tony Gale + + * docs/faq/gtk-faq.sgml: Update Section 3 to 2.x + 2003-11-19 Federico Mena Quintero Fixes to problems reported by Iain Holmes: diff --git a/docs/faq/gtk-faq.sgml b/docs/faq/gtk-faq.sgml index eca9ffe92..40f800961 100644 --- a/docs/faq/gtk-faq.sgml +++ b/docs/faq/gtk-faq.sgml @@ -2,7 +2,7 @@ - November 13th 2003 + November 20th 2003 GTK+ FAQ @@ -268,7 +268,7 @@ in 21 Days" by Donna Martin - + Is there a mailing list (or mailing list archive) for GTK+? <emphasis>[GTK 2.x]</emphasis> @@ -671,14 +671,14 @@ successful, try executing it. Whats this CVS thing that everyone keeps talking about, -and how do I access it? +and how do I access it? [GTK 2.x] CVS is the Concurrent 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 their changes to. +designed to allow multiple authors 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 +their changes to. The GTK+ developers use a CVS repository to store the master copy of the current development version of GTK+. As @@ -725,12 +725,22 @@ need to get that as well: +The CVS archive stores both the current development version of +GTK+ (the CVS HEAD branch) and all current and past stable versions. +If you want to retrieve a specific version of GTK+ you have to specify +the CVS tag corresponding to the version you want to checkout. If you +want to checkout the current GTK+ 2.2 stable source code, you would need +to use the following command: + + +cvs -z3 get -r gtk-2-2 gtk+ + - -How can I contribute to GTK+? + +How can I contribute to GTK+? <emphasis>[GTK 2.x]</emphasis> It's simple. If something doesn't work like you think it should in a program, check the documentation to make sure @@ -738,35 +748,15 @@ 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: +<oldfile> <newfile>. - -ftp://ftp.gtk.org/incoming - +The patch should then be attached to a bug report in +the GNOME bug tracking system, which can also be used to store +general patches +(http://bugzilla.gnome.org). + -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 +This method ensures that the patch will not be lost. @@ -774,153 +764,51 @@ ftp-admin@gtk.org How do I know if my patch got applied, and if not, why -not? +not? [GTK 2.x] -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. +If you have used the GNOME bug tracking system (as stated +above) then the status +of your patch should be reflected in the bug report. +The GTK+ developers will generally add comments to the bug +report stating what needs to be done to get the patch applied, +or why the patch is not appropriate. What is the policy on incorporating new widgets into -the library? +the library? [GTK 2.x] 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 +widgets that are generally useful, work, and are not a disgrace to the widget set will gladly be included. +The new widgets that get added to GTK+ are generally either +replacements for existing widgets that are no longer +deemed to be adequate, or have been developed externally to GTK+ but +have been widely tested. One possible avenue for this is via +libegg. + +Before you spend months of your valuable time implementing your +revolutionary widget, it is highly recommended that you get some +feedback on your idea via the appropriate +mailing list. Is anyone working on bindings for languages other than -C? +C? [GTK 2.x] -The GTK+ home page (http://www.gtk.org/) -presents a list of GTK+ bindings. +There is a list of +language bindings on the GTK+ website. - -There are several C++ wrappers for GTK+. - - - the gtkmm package, which is a wrapper for - GTK+. You can find the home page at - http://www.gtkmm.org/. - - - 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://vdkbuilder.sourceforge.net/. - - - The wxWindows/Gtk package, a free C++ library for - cross-platform GUI development. The home page of this package is - - http://www.wxwindows.org/. - - - - - -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. - - - +The 'official' language bindings are C++, Ada and Python. +However, bindings for many other languages are available.