New file DEPENDENCIES.

diff --git a/ChangeLog b/ChangeLog
index 2b100c4b3ddf14e5274f96dc51bbb4a785b22773..5f470b484dcec3e8b177defc7f29f5b5adff0db2 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-12-04  Bruno Haible  <bruno@clisp.org>
+
+       * DEPENDENCIES: New file.
+       * INSTALL, README: Refer to it.
+       * Makefile.am (EXTRA_DIST): Add it.
+
 2006-11-23  Bruno Haible  <bruno@clisp.org>
 
        * autogen.sh (GNULIB_MODULES_TOOLS_FOR_SRC,

diff --git a/DEPENDENCIES b/DEPENDENCIES
new file mode 100644 (file)
index 0000000..59dc96c
--- /dev/null
+++ b/DEPENDENCIES
@@ -0,0 +1,96 @@
+The following packages should be installed before GNU gettext is installed:
+
+* GNU libiconv
+  + Not needed on systems with
+      - glibc 2.2 or newer, or
+      - MacOS X 10.3 or newer, or
+      - NetBSD 3.0 or newer.
+    But highly recommended on all other systems.
+    Needed for character set conversion of PO files from/to Unicode.
+  + Homepage:
+    http://www.gnu.org/software/libiconv/
+  + Download:
+    http://ftp.gnu.org/gnu/libiconv/
+    ftp://ftp.gnu.org/gnu/libiconv/
+  + If it is installed in a nonstandard directory, pass the option
+    --with-libintl-prefix=DIR to 'configure'.
+
+* GNU ncurses (preferred) or libtermcap (discouraged).
+  + Required.
+    Needed for the --color option of the various programs.
+  + Homepage:
+    http://www.gnu.org/software/ncurses/
+  + Download:
+    http://ftp.gnu.org/gnu/ncurses/
+    ftp://ftp.gnu.org/gnu/ncurses/
+  + If it is installed in a nonstandard directory, pass the option
+    --with-ncurses-prefix=DIR or --with-libtermcap-prefix to 'configure'.
+
+* expat 1.95 or newer
+  + Recommended.
+    Needed for 'xgettext', so that it can parse Glade XML files.
+  + Homepage:
+    http://expat.sourceforge.net/
+  + Download:
+    http://sourceforge.net/project/showfiles.php?group_id=10127
+  + If it is installed in a nonstandard directory, pass the option
+    --with-libexpat-prefix to 'configure'.
+
+* A Java runtime and compiler (e.g. GNU gcj or kaffe).
+  + Recommended.
+    Needed for building libintl.jar.  Also needed for 'msgfmt' and
+    'msgunfmt', so that they can handle Java classes and properties files.
+  + Homepage:
+    http://gcc.gnu.org/java/
+    http://www.kaffe.org/
+  + Download:
+    http://ftp.gnu.org/gnu/gcc/
+    http://www.kaffe.org/ftp/pub/kaffe/v1.1.x-development/
+
+* A C# runtime and compiler (e.g. pnet or mono).
+  + Recommended
+    Needed for building GNU.Gettext.dll. Also needed for 'msgfmt' and
+    'msgunfmt', so that they can handle C# resources and assemblies.
+  + Homepage:
+    http://www.southern-storm.com.au/portable_net.html
+  + Download:
+    http://www.southern-storm.com.au/portable_net.html#download
+    http://www.mono-project.com/Downloads
+  + If more than one C# is installed, pass the option --enable-csharp=IMPL
+    to 'configure', to disambiguate.
+
+* libxml2
+  + Optional.
+    Needed for the --color option of the various programs.
+    If not present, a subset of libxml2 (included in this package) will be
+    compiled into libgettextlib.
+  + Homepage:
+    http://xmlsoft.org/
+  + Download:
+    ftp://xmlsoft.org/libxml2/
+  + If it is installed in a nonstandard directory, pass the option
+    --with-libxml2-prefix=DIR to 'configure'.
+
+* GNOME glib2
+  + Optional.
+    Needed for the --color option of the various programs.
+    If not present, a subset of libglib2 (included in this package) will be
+    compiled into libgettextlib.
+  + Homepage:
+    http://developer.gnome.org/arch/gtk/glib.html
+  + Download:
+    http://ftp.gnome.org/pub/GNOME/sources/glib/
+  + If it is installed in a nonstandard directory, pass the option
+    --with-libglib-2.0-prefix=DIR to 'configure'.
+
+* GNOME libcroco 0.6.1 or newer
+  + Optional.
+    Needed for the --color option of the various programs.
+    If not present, a copy of libcroco-0.6.1 (included in this package) will
+    be compiled into libgettextlib.
+  + Homepage:
+    http://www.freespiders.org/projects/libcroco/
+  + Download:
+    http://ftp.gnome.org/pub/GNOME/sources/libcroco/0.6/
+  + If it is installed in a nonstandard directory, pass the option
+    --with-libcroco-0.6-prefix=DIR to 'configure'.

diff --git a/INSTALL b/INSTALL
index e694669cb91c640b72522a026dcc0dde1ad7ce3f..277728ebf42d51d5105bd382e0c3ca773d1f9888 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,8 +1,15 @@
+These are generic installation instructions.
+
+Prerequisites
+=============
+
+   This package depends on a few other packages.  They are listed in
+the file `DEPENDENCIES'.  It is recommended to install the listed
+packages before installing this package.
+
 Basic Installation
 ==================
 
-   These are generic installation instructions.
-
    The `configure' shell script attempts to guess correct values for
 various system-dependent variables used during compilation.  It uses
 those values to create a `Makefile' in each directory of the package.

diff --git a/Makefile.am b/Makefile.am
index 40d6792b96de14c076b28326b61508992f336543..11f588dc15f594195939ac6a7e75a91518214244 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -23,7 +23,7 @@ ACLOCAL = build-aux/fixaclocal @ACLOCAL@
 SUBDIRS = gnulib-local gettext-runtime gettext-tools autoconf-lib-link
 
 EXTRA_DIST = \
-  version.sh PACKAGING ChangeLog.0 autogen.sh \
+  version.sh DEPENDENCIES PACKAGING ChangeLog.0 autogen.sh \
   build-aux/config.libpath build-aux/reloc-ldflags build-aux/install-reloc \
   build-aux/ac-help.sed \
   m4/fixautomake.m4 m4/woe32-dll.m4 \

diff --git a/README b/README
index cca9f162cc260b83b606513bd0ad11e8e3b8772e..9ab83925b9164097f101032b5f94f20a5bee5989 100644 (file)
--- a/README
+++ b/README
@@ -84,11 +84,12 @@ have all the features the included libintl has.
 
 Other files you might look into:
 
-`ABOUT-NLS' -  current state of the GNU internationalization effort
-`COPYING' -    copying conditions
-`INSTALL' -    general compilation and installation rules
-`NEWS' -       major changes in the current version
-`THANKS' -     list of contributors
+`ABOUT-NLS' -   current state of the GNU internationalization effort
+`COPYING' -     copying conditions
+`DEPENDENCIES' - list of prerequisite packages, to be installed before this one
+`INSTALL' -     general compilation and installation rules
+`NEWS' -        major changes in the current version
+`THANKS' -      list of contributors
 
 
 Some points you might be interested in before installing the package: