summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOwen Taylor <owt1@cornell.edu>1998-04-04 00:12:58 +0000
committerOwen Taylor <otaylor@src.gnome.org>1998-04-04 00:12:58 +0000
commitb1446447fc2ea7edfb6e7415b0509d63a71233ba (patch)
treed267e13198662afb84b461d17ded3899fcc7288d /docs
parent308adaa6db894924e40246d83c7096493c73aa2c (diff)
downloadgtk+-b1446447fc2ea7edfb6e7415b0509d63a71233ba.tar.gz
Added flags --prefix[=dir] and --exec-prefix[=DIR] which allow querying
Fri Apr 3 18:33:47 1998 Owen Taylor <owt1@cornell.edu> * gtk-config.in: Added flags --prefix[=dir] and --exec-prefix[=DIR] which allow querying and overriding the configured-in prefix and exec-prefix. * gtk.m4: Added configure flags --with-gtk-prefix= and --with-gtk-exec-prefix= to set the --prefix and --exec-prefix argumetns to gtk.m4
Diffstat (limited to 'docs')
-rw-r--r--docs/gtk-config.txt49
1 files changed, 42 insertions, 7 deletions
diff --git a/docs/gtk-config.txt b/docs/gtk-config.txt
index 4934fbe5d9..68555fabfe 100644
--- a/docs/gtk-config.txt
+++ b/docs/gtk-config.txt
@@ -16,17 +16,27 @@ $exec_prefix/bin):
Invoking gtk-config
-------------------
-gtk-config can be invoked in one of three forms:
+gtk-config takes the following flags:
- gtk-config --version
+ --version
Prints out the version of GTK installed
- gtk-config --cflags
+ --cflags
Prints '-I' flags pointing to the installed header files.
- gtk-config --libs
+ --libs
Prints out the linker flags necessary to link a program against GTK
-
+
+ --prefix[=PREFIX]
+ If PREFIX is specified, overrides the configured value of $prefix.
+ (And of exec-prefix, unless --exec-prefix is also specified)
+ Otherwise, prints out the configured value of $prefix
+
+ --exec-prefix[=PREFIX]
+ If PREFIX is specified, overrides the configured value of $exec_prefix.
+ Otherwise, prints out the configured value of $exec_prefix
+
+
Example of using gtk-config
---------------------------
@@ -88,6 +98,24 @@ the configure script.
Notes:
+* The directory where the GTK libraries are installed needs
+ to be found by your system's dynamic linker.
+
+ This is generally done by
+
+ editing /etc/ld.so.conf and running ldconfig
+
+ Or by:
+
+ setting the environment variable LD_LIBRARY_PATH,
+
+ or, as a last resort,
+
+ Giving a -R or -rpath flag (depending on your linker) when
+ running configure, for instance:
+
+ LDFLAGS=-R/usr/home/owen/lib ./configure
+
* You can also specify a gtk-config not in your path by
setting the GTK_CONFIG environment variable to the
name of the executable
@@ -96,9 +124,16 @@ Notes:
you will need either need to modify gtk-config script
manually to point to the new location or rebuild GTK.
- [ As a future enhancement AM_PATH_GTK should support options
- to override the default locations found in gtk-config ]
+Advanced note:
+
+* configure flags
+
+ --with-gtk-prefix=PREFIX
+ --with-gtk-exec-prefix=PREFIX
+ are provided to override the prefix and exec-prefix that were stored
+ in the gtk-config shell script by GTK's configure. You are generally
+ better off configuring GTK with the right path to begin with.
Example of a package using AM_PATH_GTK
--------------------------------------