Arend Bayer wrote:
> Hi Paul,
>
> how about making the system requirements a little more explicit as
> below?
I applied it locally and will commit somewhere soon. However, I made a few
changes. Most importantly, I dropped information about `pkg-config' (GTK+
depends on it, so no need to mention it here) and `scrollkeeper' (I made it
optional on 29 November.) I also placed "System Requirements" section
first.
In the end, it looks like this:
2005-01-17 Arend Bayer <[EMAIL PROTECTED]>
* INSTALL: Make system requirements more explicit.
--- INSTALL 15 Aug 2004 01:47:18 +0300 1.4
+++ INSTALL 17 Jan 2005 01:30:25 +0200
@@ -1,3 +1,17 @@
+ SYSTEM REQUIREMENTS
+
+To compile Quarry you need the following libraries:
+
+* GTK+ 2.0 or later (http://gtk.org/download/)
+
+* librsvg 2.5 or later (http://ftp.gnome.org/pub/gnome/sources/librsvg/)
+
+Note that you need both the libraries, and the header include files,
+which often come in a separate development pacakge. You should first
+try to install these from your distribution; otherwise, download them
+from the locations indicated above.
+
+
QUARRY INSTALLATION INSTRUCTIONS
Untar the sources, `cd' to the directory where you unpacked Quarry and
@@ -5,25 +19,15 @@ invoke `configure' script:
./configure [OPTIONS]
-If your system is sane, the only reason for `configure' to complain is
-absence of either GTK+ 2.x or librsvg 2.5+. If this is the case,
-download them library from
-
- http://gtk.org/download/ [GTK+]
- http://ftp.gnome.org/pub/gnome/sources/librsvg/ [librsvg]
-
-Note that GTK+ 1.x won't work and will never be supported in Quarry.
-GTK+ 2.x is so much better that there is no reason to support older
-versions.
+If configure does not succeed, please check whether your system
+satisfies the requirements listed in the previous section.
Now invoke the `make' program:
make
If it succeeded then you are done. You should now have a binary named
-`quarry' residing in the `src' directory. You can find a bit
-information on what you can do with it in file README. No proper
-documentation is available yet, sorry.
+`quarry' residing in the `src' directory.
If something went wrong, please have a look at the next section.
@@ -44,9 +48,10 @@ installed binary, not the one in build d
INSTALLATION PROBLEMS
If Quarry won't configure or compile on your system and you are sure
-that you have GTK+ 2.x, I would certainly like to fix that. See file
-named README for details on how to report bugs. Remember that the
-more information you provide, the more likely I will fix the problem.
+that the system requirements are satisfied, I would certainly like to
+fix that. See file named README for details on how to report bugs.
+Remember that the more information you provide, the more likely I will
+fix the problem.
Before sending a bug report, please make sure that GTK+ 2.x is
installed: type