com gtk/php-gtk: Added a basic INSTALL file and updated READMEs for the extensions.: INSTALL ext/mozembed/README ext/scintilla/README ext/sourceview/README

Commit:    172a2e9f7da086e36003ffdcf8d0206a1eb56938
Author:    Anant Narayanan <[email protected]>         Thu, 22 Jun 2006 03:11:13 +0000
Parents:   be8f4cff658ddb46a2e808732bd21d0e8030ae4a
Branches:  master

Link:       http://git.php.net/?p=gtk/php-gtk.git;a=commitdiff;h=172a2e9f7da086e36003ffdcf8d0206a1eb56938

Log:
Added a basic INSTALL file and updated READMEs for the extensions.

Changed paths:
  A  INSTALL
  M  ext/mozembed/README
  A  ext/scintilla/README
  M  ext/sourceview/README


Diff:
172a2e9f7da086e36003ffdcf8d0206a1eb56938
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..64000da
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,74 @@
+Basic Installation
+~~~~~~~~~~~~~~~~~~
+
+PHP-GTK 2 uses configure to ease installation. The majority of people
+will be able to install PHP-GTK by running:
+
+./buildconf
+./configure
+make
+make install
+
+after extracting the source tarball and cd'ing to that directory.
+Please note that you need root priveleges to execute the last step.
+The steps given above should work if you have PHP and Gtk+ installed
+in their standard directories. If your installation is non-standard,
+please read on.
+
+
+
+Specifying `phpize'
+~~~~~~~~~~~~~~~~~~~
+
+The standard location for the `phpize' file is /usr/bin/phpize and
+`buildconf' will look for it in the enviroment variable $PHPZE and then
+the PATH. If `buildconf' fails to find it, you may specify its
+location:
+
+./buildconf --with-phpize=/path/to/phpize
+
+
+
+Specifying the location of PHP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PHP-GTK 2 requires PHP CLI versions 5.1.1 upwards. Many systems have dual
+installations for versions 4 and 5. If the configure script is unable
+to find the correct version of PHP, and you recieve errors like:
+
+configure: error: PHP CLI version is required,  found <>
+(or)
+configure: error: Could not locate PHP 5.1.1 or higher version executable.
+
+then you may specify the location of the corresponding php-config:
+
+./configure --with-php-config=/path/to/php-config
+
+
+
+Other `configure' options
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`configure' offers a wide variety of options to customise your
+installation. You may type:
+
+./configure --help
+
+for a list of options and their short description. Options that are of
+special interest are the --enable-* options. These will build PHP-GTK
+2 with support for libraries that offer added functionality or
+new widgets, as extensions.
+
+The libglade extension is enabled by default, while the others have to
+enabled manually. As an example, if you wish to build PHP-GTK 2
+without support for libglade but wish to use the GtkSourceView
+extension, your configure statement will be:
+
+./configure --disable-libglade --enable-sourceview
+
+Please note that most extensions require some external library to be
+present for successful installation, and that all extensions are not
+available on all platforms. Details of the libraries required and
+platforms supported are present in the README files of the corresponding
+extension in the ext/ directory.
+
diff --git a/ext/mozembed/README b/ext/mozembed/README
index 5fb35a8..619b7b5 100644
--- a/ext/mozembed/README
+++ b/ext/mozembed/README
@@ -7,3 +7,5 @@ applications. Check the demos/ directory for sample script(s).
 
 You need to add the --enable-mozembed switch to your ./configure statement when
 you build PHP-GTK 2 in order to enable this extension.
+
+NOTE: This extension is currently supported only on the *nix platform.
diff --git a/ext/scintilla/README b/ext/scintilla/README
new file mode 100644
index 0000000..b0ad7e6
--- /dev/null
+++ b/ext/scintilla/README
@@ -0,0 +1 @@
+NOTE: This extension is currently supported only on the *nix platform.
diff --git a/ext/sourceview/README b/ext/sourceview/README
index fc08dd2..e92964e 100644
--- a/ext/sourceview/README
+++ b/ext/sourceview/README
@@ -9,3 +9,5 @@ directory for sample script(s).
 
 You must add the --enable-sourceview switch to your ./configure statement when
 you build PHP-GTK 2 in order to enable the extension.
+
+NOTE: This extension is currently supported only on the *nix platform.