-If you want to hack on the Gtk+ project, it will make you life easier
-to have the following packages installed:
+If you want to hack on the GTK+ project, you'll need to have
+the following packages installed:
- - GNU autoconf 2.12
- - GNU automake 1.2d
- Available in ftp://ftp.cygnus.com/pub/tromey
- - GNU libtool 1.0h
- Available in ftp://alpha.gnu.org/gnu/
+ - GNU autoconf 2.54
+ - GNU automake 1.7
+ - GNU libtool 1.4
+ - indent (GNU indent 1.9.1 is known good)
+ - GNU gettext 10.40
-These should be available by ftp from prep.ai.mit.edu or any of the
+These should be available by ftp from ftp.gnu.org or any of the
fine GNU mirrors. Beta software can be found at alpha.gnu.org.
-If you are accessing gtk+ via CVS, then you will need to take several
-steps to get it to compile. These are:
+Up-to-date instructions about developing GNOME applications and libraries
+can be found here:
- cvsroot/gtk+# aclocal; automake; autoconf
- cvsroot/gtk+/glib# aclocal; automake; autoconf
+ http://developer.gnome.org
-The "configure" scripts will not exist until you take these steps.
-you only need to call "configure" i cvsroot/gtk+ as the one in
-glib will be invoked automatically.
+Information about using git with GNOME can be found here:
-Before running configure, make sure you have libtool in your path
+ http://live.gnome.org/Git
-Please submit patches to the gtk-list@redhat.com mailing list (you must
-subscribe before you post, e-mail gtk-list-request@redhat.com with a
-subject of "subscribe"). All kinds of contributions are accepted. If at
-all possible, please use CVS to get the latest development version of
-gtk+; the README file has the CVSROOT information.
+In order to get GIT gtk+ installed on your system, you need to have
+the most recent GIT versions of glib, pango, and atk installed as well.
+The installation process of these libraries is similar to that of gtk+, but
+needs to be fulfilled prior to installation of gtk+.
+If at all possible, please use GIT to get the latest development version of
+gtk+ and glib. You can do the following to get glib and gtk+ from GIT:
+
+ $ git clone git://git.gnome.org/glib
+ $ git clone git://git.gnome.org/pango
+ $ git clone git://git.gnome.org/atk
+ $ git clone git://git.gnome.org/gtk+
+
+Note: if you plan to push changes to back to the master repository and
+have a gnome account, you want to use the following instead:
+
+ $ git clone ssh://<username>@git.gnome.org/git/gtk+
+
+To compile the GIT version of gtk+ on your system, you will need to take
+several steps to setup the tree for compilation. You can do all these
+steps at once by running:
+
+ gtk+$ ./autogen.sh
+
+Basically this does the following for you:
+
+ gtk+$ aclocal; automake; autoconf
+
+The above commands create the `configure' script. Now you
+run the `configure' script in `gtk+/' to create all Makefiles.
+More information about that in `INSTALL'.
+
+Before running `autogen.sh' or `configure', make sure you have libtool
+in your path.
+
+Note that autogen.sh runs configure for you. If you wish to pass
+options like `--prefix=/usr' to `configure' you can give those options
+to `autogen.sh' and they will be passed on to `configure'.
+
+For information about submitting patches and pushing changes
+to GIT, see the `README' and `README.commits' files. In particular,
+don't, under any circumstances, push anything to GIT before
+reading and understanding `README.commmits'.